04 / DOCUMENTATION

The rulebook.

Technical notes on the contracts in this repository. These notes describe the latest Ethereum mainnet deployment recorded in this repository.

LIVE ON ETHEREUM MAINNET / CODE NOT AUDITED

00 / DEPLOYMENT

Ethereum mainnet

The website is pinned to the latest successful deployment broadcast in this repository. The deployment was completed at block 26,096,491. Check each address before signing a wallet transaction.

View pool initialization transaction ↗

01 / OVERVIEW

Contract map

UniKing connects a fixed-supply token, a Uniswap v4 Hook, a pool locker, an NFT account system, and a buyback reserve.

UniKingToken100B fixed-supply UNIK and account-backing transfer logic
UniKingHookPool rules, swap fees, account checks, and fee allocations
UniKingAccountsNFT ownership, Rainbow, positions, liquidations, and ETH claims
UniKingLiquidityLockerOne-sided pool initialization with no withdrawal path
UniKingRouterBundled exact-input buy and sell entry point
UniKingBuybackReserved ETH used for owner-executed buys and burns

02 / TRADING

The UNIK pool

The official ETH / UNIK pool is initialized by the liquidity locker. Its Hook permits swaps and restricts liquidity changes; the locker contains no liquidity withdrawal path.

  • UNIK has an initial fixed supply of 100 billion.
  • The bundled router handles exact-input buys and sells and realizes fees automatically.
  • Other routers can interact with the official pool, including exact-output swaps, but must call realizeFees() to settle recorded fees.
  • A qualifying buy can mint one NFT for each full 100 million UNIK delivered by a single pool-manager token withdrawal.

03 / FEES & REWARDS

ETH fee allocation

The Hook records a 1.5% ETH fee on supported swaps. On realization, the fee is split 90% to NFT rewards, 5% to a treasury claimable balance, and 5% to the buyback reserve.

NFT rewards use account reward weights. Accounts without positions accrue one Rainbow per block. Active accounts use their last processed equity, including position PnL, as cached weight. Each swap checks at most 20 active accounts in rotation, so weights are not an exact current-price snapshot of every account on every swap.

The buyback owner must execute a separate transaction to spend reserved ETH on UNIK and burn the purchased tokens.

04 / NFT ACCOUNTS

Ownership and identity

Each NFT account requires backing of 100 million UNIK. A single qualifying transfer of at least that amount may move supported NFTs to the recipient. Smaller transfers do not move an NFT, and excess unsupported NFTs can be burned.

Accounts can hold simulated leveraged positions in administrator-listed markets. A market uses a spot oracle and an administrator-set maximum leverage from 1 to 100. Equity checks may liquidate positions.

The NFT renderer generates each SVG and JSON metadata directly from Solidity. Twelve traits determine its pixel-art appearance and are fixed by token ID after minting. The metadata also reports live Rainbow and claimable ETH when the token URI is read.

05 / RISKS & LIMITS

Review before use

This code has not been audited. Direct pool spot prices can be manipulated. Simulated profit can increase a claim on real ETH fees. Large buys may exceed transaction gas limits because an NFT is minted for every qualifying 100 million UNIK. The contracts have no pause function.

This website points to live Ethereum mainnet contracts. An independent security and economic review remains necessary before using them with substantial funds.