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.

The XDC NFT stack has been rebuilt around the psXDC v3 vault. New contract addresses: XdcStakedNFT, XdcNftStakingVault, XdcNftMigrator, XdcNftBoostHarvester, LegacyMigratorBypassFacet. The legacy V2 collection at 0x9D45…76a0 remains operational for any holder who has not yet migrated; see Migrate XDC NFTs to V3.

---

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.
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

---

How It Works

1. Get psXDC shares. Stake XDC in PrimeStakedXDC_V3_2 or buy psXDC on a DEX. (Already hold V2 psXDC? Migrate to V3 first.)

2. Get an NFT. Buy one on PrimePort, or migrate a legacy V2 NFT through XdcNftMigratorV2 (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.

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.

---

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	Fresh ERC-721 collection. Non-upgradeable.
XdcNftStakingVault (proxy)	0x9f38dF64eeC71e2408B24217b8D621c6B07E4Da8	Staking engine that holds psXDC shares under each NFT and runs the accumulator. TransparentUpgradeableProxy, ERC-7201 namespaced storage.
XdcNftMigratorV2	0x69DE30161ec0f2e0Dc0649190dB9b93F4c492ea8	Live one-shot V2 → V3 migrator. Remaps legacy ids ≥ 10000 to 5558–9999. Non-upgradeable. (Supersedes the paused XdcNftMigrator 0x45e2…7dFb.)
XdcNftBoostHarvester	0x6a319528111E5e50712Fd2D3d2db8323b119821D	Funds the boost accumulator via notifyBoost. Non-upgradeable.
LegacyMigratorBypassFacet	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) → Reward Model: Base NAV + Boost → Migrate XDC NFTs to V3 → Locked NFTs & Legacy Diamond Bypass → Boost Harvester (technical) → Smart Contract Reference (V3)