Pawn

Documentation

SkipPawn

SkipPawn is the holder-controlled mechanism that allows any wallet to opt out of the NFT layer entirely. When opted out, a holder holds PAWN as a pure ERC-20 token with no embedded NFT behavior and no participation in epoch reward distributions.

What SkipPawn does

In the default state (not opted out), balance changes that cross whole-token thresholds trigger NFT minting or burning automatically. Buying enough PAWN to reach the next whole token mints a new NFT to your wallet. Selling enough to drop below a whole token burns the most recently minted NFT.

When a holder calls skipPawn(true), this automatic behavior is suspended for their address. Subsequent balance changes (buys, sells, or transfers) no longer trigger any NFT activity. The holder continues to hold PAWN tokens normally, but the embedded NFT mechanic is inert for their address until they opt back in.

While opted out, the holder does not receive epoch reward distributions. They are not included in the weighted NFT count at distribution time and receive no ETH or PAWN from the reward streams for epochs during which they are opted out. This suspension applies only to future distributions. Any unclaimed rewards from before the opt-out are still claimable within their respective windows.

Who SkipPawn is for

SkipPawn is primarily useful for:

  • Liquidity providers and large traders

    Wallets that move large amounts of PAWN frequently, for example to provide or adjust liquidity in the pool, may prefer to avoid the gas overhead of repeated NFT minting and burning with each transaction. SkipPawn disables this overhead entirely.

  • Protocol-exempt addresses

    Addresses that are exempt from fees (such as the liquidity pool contract or the Treasury itself) are also exempt from NFT behavior. This exemption is set at the contract level and is separate from the holder-controlled SkipPawn mechanism.

  • Holders preferring simplicity

    Any holder who prefers to hold PAWN as a straightforward ERC-20 asset without managing NFTs or monitoring claim windows can opt out and treat PAWN like any other token.

How to use SkipPawn

SkipPawn is toggled through the dashboard at /app. Connect your wallet and locate the Skip NFT Layer toggle in the account panel. Clicking it initiates a skipPawn(true) or skipPawn(false) transaction on the PawnToken contract, depending on your current state. The dashboard reflects your current opt-out status in real time.

Advanced users can call skipPawn(bool) directly on the PawnToken contract. The function is not payable and requires no arguments beyond the boolean indicating whether to skip (true) or re-enroll (false).

The opt-out status for any address is readable on-chain through the nftExempt(address) view function on PawnToken, which returns true if the address is currently opted out.

There is no timelock, waiting period, or fee for opting in or out. The change takes effect immediately in the same block as the transaction.

Behavior of existing NFTs on opt-out

When a holder calls skipPawn(true), the contract first settles all accrued epoch rewards into the holder's pendingClaim balances. These settled balances have no expiry and remain claimable at any time via claim(). After settlement, all existing NFTs are burned. The holder is then exempt from NFT minting and burning on subsequent balance changes.

When the holder later calls skipPawn(false) to re-enroll, NFTs are minted based on the current token balance (floor(balance / 1e18)). Each new NFT initializes its reward debt to the current accumulator state, so the holder does not retroactively earn rewards from before re-enrollment. After re-enrollment, the holder participates in all subsequent epoch distributions normally.