> For the complete documentation index, see [llms.txt](https://docs.primestaking.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.primestaking.xyz/products/xdc-staking-nfts.md). # XDC NFTs XDC Staking NFTs are gamified staking positions on the XDC Network. Each NFT holds **psXDC v3 vault shares** and earns two stacked yields: a **base \~5.5%** from the underlying share-price appreciation (always earned, no claim, no rarity dependency) and an additional **boost slice up to \~1.5%** from a Synthetix-style accumulator funded by the protocol's reward harvester, weighted by rarity, level, and lock status. {% hint style="info" %} The XDC NFT stack has been rebuilt around the psXDC v3 vault. New contract addresses: [`XdcStakedNFT`](/products/contract-addresses.md), [`XdcNftStakingVault`](/products/contract-addresses.md), [`XdcNftMigrator`](/products/contract-addresses.md), [`XdcNftBoostHarvester`](/products/contract-addresses.md), [`LegacyMigratorBypassFacet`](/products/contract-addresses.md). The legacy V2 collection at `0x9D45…76a0` remains operational for any holder who has not yet migrated; see [Migrate XDC NFTs to V3](/products/xdc-staking-nfts/migrate-nfts-v2-to-v3.md). {% endhint %} *** ## Key Facts | | | | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Collection size** | 5,557 NFTs (5,542 generative + 15 handcrafted), preserved across V2 → V3 | | **Token staked** | **psXDC v3 vault shares** (not raw XDC) | | **Max stake per NFT** | **100,000 psXDC** (share count). Stake more by holding more NFTs. See [Per-NFT stake cap](/products/xdc-staking-nfts/xdc-staking-nfts-mechanics.md#per-nft-stake-cap). | | **Base yield** | \~5.5%, from share-price appreciation of the underlying psXDC | | **Boost slice** | Up to \~1.5%: Synthetix accumulator, weighted by rarity / level / lock | | **Floor APY** | **\~5.5%** (the base NAV), automatic, always earned regardless of rarity / lock / boost cadence | | **Target APY band (with boost)** | \~5.75% (unlocked) → \~7% (locked) when boost stream is steady | | **Reward token (boost)** | XDC. `notifyBoost` mints shares, claim unwraps to native XDC | | **Locked yield** | Additive `lockBoost` term added to NFT weight when locked | | **Merge** | Two same-rarity NFTs → one higher-rarity NFT (originals burned) | | **Marketplace** | [PrimePort.xyz](https://primeport.xyz) | *** ## How It Works 1. **Get psXDC shares.** Stake XDC in [`PrimeStakedXDC_V3_2`](/products/xdc-liquid-staking.md) or buy psXDC on a DEX. (Already hold V2 psXDC? [Migrate to V3 first](/products/xdc-liquid-staking/staking-guide/migration.md).) 2. **Get an NFT.** Buy one on [PrimePort](https://primeport.xyz), or migrate a legacy V2 NFT through [`XdcNftMigratorV2`](/products/xdc-staking-nfts/migrate-nfts-v2-to-v3.md) (preserves your rarity and any active lock, and your `tokenId` for legacy ids below `10000`; ids ≥ `10000` are remapped). 3. **Stake psXDC shares into your NFT.** The vault records the shares against the NFT's `tokenId`. The NFT's **weight** in the boost accumulator becomes `stakedShares × (rarityMultiplier + level + lockBoost)`. Each NFT holds up to **100,000 psXDC**; to stake more, spread it across multiple NFTs. 4. **Earn two stacked yields**: * **Base NAV**: your staked shares keep appreciating; you receive them back at the higher value when you withdraw. * **Boost**: every `notifyBoost` push from the harvester increments `rewardPerWeightStored`; your earned slice grows in proportion to your weight. 5. **Claim boost** from the NFT detail page whenever you want. It is paid in XDC. Base NAV is automatic and needs no claim. 6. **Upgrade** by merging two same-rarity NFTs into a higher-tier one for a larger `rarityMultiplier`. 7. **Lock (optional)**: locking adds `lockBoost` to the weight calculation. Lock expiry is preserved across migration so users can't dodge the lock by routing through the migrator. 8. **`burnAndRedeem`** burns the NFT and returns the underlying psXDC shares (or, optionally, redeems them to XDC in one transaction). *** ## Rarity Tiers Each NFT has a rarity that determines its `rarityMultiplier`, which feeds into the weight formula: | Rarity | Base Multiplier | | --------- | --------------- | | Plentiful | 0.3 | | Common | 0.4 | | Uncommon | 0.5 | | Rare | 0.7 | | Epic | 0.9 | | Legendary | 1.2 | | Mythic | 1.5 | | Godly | 1.9 |
Higher rarity = higher `rarityMultiplier` = higher weight = larger slice of every `notifyBoost`. {% hint style="warning" %} `rarityMultiplier` values are **immutable** on the V3 vault. Changing them would invalidate `totalWeight` for every staked NFT, so the vault has no setter. A future change would require deploying a new vault and migrating. {% endhint %} *** ## Merge System Combine two NFTs of the **same rarity** to mint one NFT of the **next rarity tier**. * Both original NFTs are burned (their psXDC shares are released back to you so you can re-stake into the new NFT, depending on the merge mode). * A new, higher-rarity NFT is minted via `XdcStakedNFT.mintMerged` (token IDs ≥ `10000`). * **Godly** is the highest rarity achievable through merging. The merge system makes the collection **deflationary by design**: every merge permanently reduces the total supply. Over time, remaining NFTs become increasingly scarce and carry higher multipliers. *** ## Handcrafted NFTs The collection includes 15 exclusive, handcrafted NFTs by the Art Director. Owners receive three additional XDC Staking NFTs. These NFTs have the **highest `rarityMultiplier`** in the collection. *** ## V3 contract stack | Contract | Address | Role | | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | `XdcStakedNFT` | [`0xf3eB62F0Daf98ab65f0696630621A6ecECDB898E`](https://xdcscan.com/address/0xf3eB62F0Daf98ab65f0696630621A6ecECDB898E) | Fresh ERC-721 collection. Non-upgradeable. | | `XdcNftStakingVault` (proxy) | [`0x9f38dF64eeC71e2408B24217b8D621c6B07E4Da8`](https://xdcscan.com/address/0x9f38dF64eeC71e2408B24217b8D621c6B07E4Da8) | Staking engine that holds psXDC shares under each NFT and runs the accumulator. TransparentUpgradeableProxy, ERC-7201 namespaced storage. | | `XdcNftMigratorV2` | [`0x69DE30161ec0f2e0Dc0649190dB9b93F4c492ea8`](https://xdcscan.com/address/0x69DE30161ec0f2e0Dc0649190dB9b93F4c492ea8) | Live one-shot V2 → V3 migrator. Remaps legacy ids ≥ `10000` to `5558–9999`. Non-upgradeable. (Supersedes the paused `XdcNftMigrator` `0x45e2…7dFb`.) | | `XdcNftBoostHarvester` | [`0x6a319528111E5e50712Fd2D3d2db8323b119821D`](https://xdcscan.com/address/0x6a319528111E5e50712Fd2D3d2db8323b119821D) | Funds the boost accumulator via `notifyBoost`. Non-upgradeable. | | `LegacyMigratorBypassFacet` | [`0x2786D8Df1C38c9D4eD642B84c073349b0f0B5e13`](https://xdcscan.com/address/0x2786D8Df1C38c9D4eD642B84c073349b0f0B5e13) | Diamond facet on the legacy diamond enabling locked-NFT migration. Clears `tokenLocked`; the diamond pays the psXDC (no v2-staker call). | → [Staking Mechanics (V3)](/products/xdc-staking-nfts/xdc-staking-nfts-mechanics.md) → [Reward Model: Base NAV + Boost](/products/xdc-staking-nfts/xdc-nft-staking-reward-system.md) → [Migrate XDC NFTs to V3](/products/xdc-staking-nfts/migrate-nfts-v2-to-v3.md) → [Locked NFTs & Legacy Diamond Bypass](/products/xdc-staking-nfts/locked-nft-migration.md) → [Boost Harvester (technical)](/products/xdc-staking-nfts/boost-harvester.md) → [Smart Contract Reference (V3)](/products/xdc-staking-nfts/smart-contract-functions.md)