Documentation

Types

ERC-5D assigns every minted NFT to one of four types: Type I, Type II, Type III, and Type IV. The types are equal art variants, not a ranked hierarchy. The type determines the reward weight applied during any given epoch through the rotation schedule. Because the weights rotate on a four-epoch cycle, no type has a long-term advantage. All types accumulate identical total weights over any complete cycle.

Type assignment

Types are assigned via a global round-robin counter maintained on-chain in the PawnToken contract. When a Pawn is minted (either because a holder's balance crosses a whole-token threshold upward, or because a holder re-enrolls after opting back in), the counter advances and the next type slot is assigned to that Pawn.

The assignment is purely sequential: NFT #1 receives Type I, NFT #2 receives Type II, NFT #3 receives Type III, NFT #4 receives Type IV, NFT #5 receives Type I again, and so on. There is no randomness, no purchase price, and no holder input. The type is a property of when in the global sequence the NFT was minted, not of who minted it.

Once assigned, the type is immutable for the life of that specific NFT. If the NFT is burned (through a sell or opt-out) and later re-minted, the new NFT receives the next slot in the counter, which may be a different type than the burned one.

The four types

T1

Type I

Type I. The first of four equal art variants. Assigned to every fourth NFT starting at mint index 1. Carries no permanent reward advantage. Across any complete four-epoch cycle, Type I receives each weight in the rotation (0, 1, 2, 3) exactly once, for the same total weight as every other type.

T2

Type II

Type II. The second of four equal art variants. Assigned in the second slot of the round-robin counter. Its reward weight cycles through the full weight vector identically to every other type across the four-epoch rotation. No type is better or worse.

T3

Type III

Type III. The third of four equal art variants. Assigned in the third slot of the round-robin counter. Like all types, its long-run reward accrual equals that of every other type. The art differs; the economics are identical.

T4

Type IV

Type IV. The fourth of four equal art variants. Assigned in the fourth slot of the round-robin counter. Despite being last in the sequence, Type IV has no long-run reward advantage or disadvantage. Over any full four-epoch cycle, all four types accrue identical total rewards.

Type distribution in practice

Since assignment is round-robin, the distribution across all four types is approximately equal at any given time, provided minting has been sufficiently active. With 2000 total supply and one NFT per whole PAWN token, the maximum NFT count across the entire collection is 2000, meaning approximately 500 NFTs per type at full deployment.

In practice, the active NFT count at any given time depends on the number of holders and their balances. Sells burn NFTs and remove them from the active count; buys mint new ones. The type counter continues incrementing with each mint, so the type labels on active NFTs at any given moment reflect the current state of the counter modulo 4.

Type data on-chain

The type of any NFT is readable on-chain through the tokenTier(uint256 tokenId) view function on the PawnToken contract. The type is stored as a uint8 value (1 through 4), corresponding to Type I, Type II, Type III, and Type IV respectively. This data is also indexed by the off-chain indexer and surfaced in the dashboard for connected wallets.