Documentation
FAQ
Answers to the most common questions about PAWN and ERC-5D. For deeper coverage of any topic, use the sidebar to navigate to the relevant section.
What is ERC-5D?
ERC-5D is the conceptual label for the token standard implemented in PAWN. It describes a token that operates across four simultaneous dimensions: Hybrid (ERC-20 fused with an ERC-404 NFT layer), Rewards (rotating epoch reward streams), Access (on-chain credential), and Open (extensible architecture). See the ERC-5D Standard page for the full breakdown.
What is PAWN?
PAWN is the token implementing ERC-5D on Base. It is a fixed-supply semi-fungible token with 2000 total units, hard capped with no mint function. Each whole PAWN corresponds to an embedded ERC-721 Pawn NFT that participates in a rotating epoch reward system.
Is the supply fixed?
Yes. PAWN has a total supply of exactly 2000 tokens, permanently. There is no mint function anywhere in the contract. No new PAWN can be created by any means. The totalSupply() function on PawnToken always returns 2000 x 10^18 and this value never changes.
How do I get an NFT?
You do not need to do anything special to get an NFT. When you hold at least 1 whole PAWN in a non-exempt, non-opted-out wallet, you automatically hold one embedded ERC-721 Pawn NFT. For every additional whole PAWN, you hold one additional Pawn. The Pawns are minted automatically when your balance crosses upward whole-token thresholds. No separate minting transaction is required.
What determines my Pawn tier?
Tier assignment is determined by a global round-robin counter in the PawnToken contract. The counter increments with every new NFT minted across all holders. Your tier is simply the next slot in the cycle modulo 4: Type I, Type II, Type III, Type IV, then Type I again. There is no randomness, no payment, and no holder choice involved in tier assignment.
Does tier matter for long-term rewards?
No. Across any complete four-epoch cycle, every tier receives every weight (0, 1, 2, 3) exactly once. The long-run total is identical for all tiers. Tier only determines your reward weight in any single epoch, not your cumulative reward over time. No tier is better than any other.
How often are rewards distributed?
Rewards are distributed at the end of each four-hour epoch. Each epoch, the accumulated ETH from trading and the configured PAWN emission from the Phalanx reserve are split across all qualifying NFT holders based on their weighted NFT counts. Distribution requires a trigger: either the owner calls distributeEpoch() manually, or autoDistribute mode fires it automatically on each sell-triggered tax swap.
Do rewards pay automatically?
No. Rewards accumulate in on-chain accumulators. Holders must call claim() on PawnTreasury to receive them. There is no automatic push payment. After each epoch is distributed, you have a 24-hour window to call claim() and collect your share.
How long do I have to claim?
After an epoch is distributed, you have 24 hours to claim your share from that epoch. The window opens at the moment of distribution (epochDistributedAt) and closes exactly 24 hours later. You can claim across multiple in-window epochs in a single transaction.
What happens if I miss the claim window?
Rewards from epochs whose 24-hour window has closed are forfeited for that holder. The claim() function silently advances your cursor past expired epochs; those rewards become permanently uncollectable by you. This applies to ordinary epoch rewards. Rewards settled via skipPawn opt-out (stored in pendingClaim balances) have no expiry.
What rewards do I receive?
Two simultaneous streams: ETH from the trading tax on the liquidity pool, and PAWN tokens from the Phalanx reserve. Both are weighted by your tier's rotation weight for the current epoch. Both are paid in a single claim() transaction.
What is the trading tax?
PAWN has a 10% tax on buys and sells for the first 15 buys after launch, then drops permanently to 3%. Wallet-to-wallet transfers between non-pool addresses pay no tax. The tax is converted to ETH and routed to the Treasury for distribution to NFT holders.
What is the Phalanx?
The Phalanx is the on-chain PAWN reserve held inside PawnTreasury (phalanxReserve). It is seeded by the owner calling feedPhalanx(). Each epoch, it distributes a flat amount of PAWN set by the owner via setPhalanxEmission(). The rate does not decay automatically. When the reserve reaches zero, PAWN emissions stop until the owner tops it up again. The remaining balance is readable on-chain at any time.
What is SkipPawn?
SkipPawn is the holder-controlled NFT opt-out mechanism. By calling skipPawn(true) on the PawnToken contract, a holder opts out of the NFT layer. The contract first settles all accrued rewards into the holder's pendingClaim balances (no expiry), then burns the NFTs. While opted out, balance changes do not trigger NFT minting or burning, and the holder does not receive epoch reward distributions. The opt-out is reversible at any time via skipPawn(false). See the SkipPawn documentation for full details.
Is there a cost to use SkipPawn?
Only standard gas. The skipPawn function is not payable and charges no protocol fee. The gas cost is that of a simple non-payable function call.
Where is PAWN traded?
PAWN is traded on Uniswap V4 on Base. The liquidity pool is seeded at launch and the pair address is publicly visible on-chain. Standard ERC-20 approvals and Uniswap V4 / Universal Router calls are used for all trades. No custom router or special interface is needed.
Is there any off-chain infrastructure?
The core protocol has no mandatory off-chain dependencies for claims or NFT mechanics. There are no keepers, no randomness oracles, and no off-chain schedulers required. Epoch distribution does require a trigger transaction: either the owner calls distributeEpoch(), or autoDistribute mode fires it automatically on sell-triggered tax swaps. All reward accounting, NFT minting and burning, and claiming are driven by on-chain state. The dashboard and API that display data are informational only; they do not drive any on-chain state.
How do I claim my rewards?
Connect your wallet at /app. If you have pending rewards within open claim windows, the Claim Rewards button will be active. Clicking it sends a claim() transaction to PawnTreasury, which settles all in-window epochs in one call. You can also call claim() directly on the contract through BaseScan or any Base interface.
Still have questions? Reach out through the community channels.