# Overview

{% hint style="info" %}
PrimeStaking has shipped its V3 upgrade. The new **`PrimeStakedXDC_V3`** vault is a fully non-custodial, ERC-4626 share-based design with self-service withdrawals. The XDC NFT stack has also been rebuilt around the V3 vault. V2 contracts remain live for users who have not migrated. See [Migrate V2 psXDC → V3](/products/xdc-liquid-staking/staking-guide/migration.md) and [Migrate XDC NFTs to V3](/products/xdc-staking-nfts/migrate-nfts-v2-to-v3.md).
{% endhint %}

## Overview

**PrimeStaking** is a non-custodial staking platform and infrastructure provider on the XDC Network, built in collaboration with **Nethermind** and the **XDC Core team**.

The platform is live at [primestaking.xyz](https://primestaking.xyz).

***

### Who Is This For?

| Audience                    | What You'll Find                                | Go To                                       |
| --------------------------- | ----------------------------------------------- | ------------------------------------------- |
| **Users**                   | Stake XDC, earn rewards, explore NFTs           | [For Users](#for-users)                     |
| **Partners & Institutions** | Integrate XDC liquid staking into your platform | [For Partners](#for-partners--institutions) |

***

***

## For Users

Earn rewards on XDC without giving up control of your assets.

### Products

| Product                | Token | Yield                                         | How It Works                                                                                          |
| ---------------------- | ----- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **XDC Liquid Staking** | XDC   | \~4.5% APY                                    | Stake XDC, receive psXDC vault shares. Share price grows as validator rewards accrue.                 |
| **XDC NFTs**           | psXDC | \~4.5% base + boost slice → up to \~6% locked | Deposit psXDC shares into NFTs. Earn the underlying NAV plus a rarity- and lock-weighted boost slice. |

#### XDC Liquid Staking

The simplest way to earn on your XDC. No NFT required. No minimum amount.

1. **Stake XDC** - Deposit any amount into the V3 vault.
2. **Receive psXDC shares** - You receive psXDC at the current vault exchange rate. There is no fixed 1:1 ratio; share price rises as rewards accrue.
3. **Earn rewards** - Rewards are embedded directly in the share price (\~4.5% APY). No claim button — your shares simply become worth more XDC over time.
4. **Stay liquid** - psXDC is a standard ERC-20 on the XDC Network. Hold it, transfer it, use it as DeFi collateral, or deposit it into XDC NFTs.
5. **Withdraw anytime** - Burn psXDC shares. If the vault has enough buffer liquidity, you receive XDC instantly in the same transaction. Otherwise your request enters an automatic FIFO queue and you claim once the masternode payouts return.

→ [Learn more about XDC Liquid Staking](/products/xdc-liquid-staking.md) → [V3 Architecture](/products/xdc-liquid-staking/v3-architecture.md)

#### XDC NFTs

A gamified staking layer on top of liquid staking. Deposit psXDC shares into collectible NFTs to earn two stacked yields.

* Each NFT has a **rarity** (Plentiful → Handcrafted) that determines its weight in the boost accumulator.
* **Base yield** comes from the underlying psXDC share price growing over time (\~4.5% APY).
* **Boost yield** comes from a Synthetix-style accumulator. The protocol's [`XdcNftBoostHarvester`](/products/xdc-staking-nfts/boost-harvester.md) calls `notifyBoost` and the resulting slice is distributed pro-rata to NFT weights.
* **Level up** by merging two same-rarity NFTs into a higher tier.
* **Lock** your NFT to add a lock bonus to its weight. Floor is the **\~4.5% base NAV** (always earned, no claim); when the boost stream is flowing, the combined APY ranges from **\~4.75% (unlocked)** up to **\~6% (locked)**.
* You only claim the **boost slice** from the app — base NAV is automatically inside the shares you get back on withdraw.

→ [Learn more about XDC NFTs](/products/xdc-staking-nfts.md) → [Migrate XDC NFTs to V3](/products/xdc-staking-nfts/migrate-nfts-v2-to-v3.md)

#### How Rewards Reach You

| Product                | What you earn                                | How you receive it                                                                             |
| ---------------------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **XDC Liquid Staking** | Higher psXDC share price                     | Automatic — your shares are worth more XDC over time. No claim button.                         |
| **XDC NFTs**           | Underlying NAV growth + boost slice (in XDC) | NAV is automatic; **claim boost** from the NFT detail page. Withdraw burns shares back to XDC. |

#### The psXDC Ecosystem

```
XDC  →  psXDC shares  →  NFT  →  Boost slice
```

| Step        | What Happens                                                                    |
| ----------- | ------------------------------------------------------------------------------- |
| **Stake**   | Deposit XDC into the V3 vault.                                                  |
| **Receive** | Get psXDC shares at the current exchange rate. NAV starts accruing immediately. |
| **Use**     | Hold psXDC, trade it on a DEX, or deposit it into an XDC NFT.                   |
| **Boost**   | NFT rarity, level, and lock add weight to your slice of the boost accumulator.  |

***

***

## For Partners & Institutions

PrimeStaking is **XDC liquid staking infrastructure** - built for exchanges, custodians, and institutional partners who want to offer XDC staking to their customers without building from scratch.

### Two Integration Models

| Model                | Description                                    | Best For                                 |
| -------------------- | ---------------------------------------------- | ---------------------------------------- |
| **White Label**      | Your brand, our infrastructure.                | Exchanges, large custodians              |
| **Powered by Prime** | Co-branded widget. Minimal integration effort. | Wallets, aggregators, regional platforms |

### Why Partners Choose PrimeStaking

* **No principal-stake slashing** - XDC's slashing mechanism penalizes downtime via temporary exclusion from block production (\~2h) and missed rewards; principal stake is never burned, unlike ETH-based protocols.
* **ERC-4626 vault** - psXDC v3 conforms to the same standard used by major DeFi protocols, making integration straightforward.
* **Non-custodial** - smart contract-based validator custody, no third-party key management, no admin mint or `ownerWithdraw`.
* **Audited infrastructure** - QuillAudits (98.8%) on the V1 liquid staking contracts; **Nethermind Security NM-0843** (published May 08, 2026) on the psXDC V3 vault and V3 Migration Bridge.
* **Nethermind Security** - trusted auditing partner for Lido, EtherFi, Optimism, and Worldcoin.
* **Battle-tested** - live since 2024 with $6M+ TVL.
* **Revenue sharing** - transparent, on-chain fee model.

### Partner Documentation

| Section                                                   | What It Covers                                             |
| --------------------------------------------------------- | ---------------------------------------------------------- |
| [Institutional Overview](/for-partners/institutional.md)  | What we offer, why PrimeStaking, why XDC Network           |
| [Architecture](/for-partners/architecture.md)             | System design, contract topology, validator infrastructure |
| [Custody Model](/for-partners/custody-model.md)           | Permissionless smart contract-based key management         |
| [Integration Models](/for-partners/integration-models.md) | White Label vs. Powered by Prime                           |
| [Revenue Model](/for-partners/revenue-model.md)           | Revenue generation, partner sharing, settlement            |
| [Reward Mechanics](/for-partners/reward-mechanics.md)     | How staking rewards are generated and distributed          |
| [Liquidity Model](/for-partners/liquidity-model.md)       | psXDC liquidity, share price, redemption mechanics         |
| [Governance](/for-partners/governance.md)                 | Role separation, delayed governance, what is upgradeable   |
| [Risk & Compliance](/for-partners/risk-and-compliance.md) | Risk framework, audit history, regulatory posture          |
| [SLA & Support](/for-partners/sla-and-support.md)         | Uptime commitments, incident response, partner support     |

**Contact:** <admin@primenumbers.xyz>

***

***

### Security

* `PrimeStakedXDC_V3` is **non-upgradeable** — deployed with a regular constructor, no proxy. The vault logic cannot be modified after deployment.
* The XDC NFT staking vault is a `TransparentUpgradeableProxy` controlled by the protocol multisig, with namespaced ERC-7201 storage. All other NFT-stack contracts (collection, migrator, harvester, bypass facet) are non-upgradeable.
* Validator custody is **smart contract-based** - permissionless and trustless, no third-party custodian.
* The protocol is **non-custodial** - users retain full ownership of their assets at all times.
* Infrastructure developed with **Nethermind** and the **XDC Core team**.

→ [Audits & Security](/security/audits-1.md) → [Custody & Key Management](/security/custody-and-key-management.md) → [Deployed Contracts & Addresses](/products/contract-addresses.md)

***

### Quick Links

| Resource                | Link                                                                                                   |
| ----------------------- | ------------------------------------------------------------------------------------------------------ |
| App                     | [primestaking.xyz](https://primestaking.xyz)                                                           |
| XDC Liquid Staking      | [primestaking.xyz/xdc-liquid-staking/overview](https://primestaking.xyz/xdc-liquid-staking/overview)   |
| XDC NFTs                | [primestaking.xyz/xdc-nfts/overview](https://primestaking.xyz/xdc-nfts/overview)                       |
| Migrate XDC NFTs        | [primestaking.xyz/xdc-nfts/migrate](https://primestaking.xyz/xdc-nfts/migrate)                         |
| Migrate psXDC V2 → V3   | [primestaking.xyz/xdc-liquid-staking/migration](https://primestaking.xyz/xdc-liquid-staking/migration) |
| Institutional Solutions | [Institutional & Exchange Solutions](/for-partners/institutional.md)                                   |
| psXDC V3 vault          | [XDCScan](https://xdcscan.com/address/0x98D916F5773Ac0482b49856f2659d6c32114C4Ba)                      |
| Deployed addresses      | [Contract Addresses](/products/contract-addresses.md)                                                  |
| Contact                 | <admin@primenumbers.xyz>                                                                               |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.primestaking.xyz/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
