Skip to main content

Registry Partner Guide

Registry partners are organisations that submit verified real-world asset certificates to the NCRB platform. Once a certificate passes quality assessment and governance approval, RWA tokens are minted and distributed to the designated recipients.

Examples of registry partners: Verra, Gold Standard, American Carbon Registry, Plastic Bank, Plan Vivo.


Prerequisites

Before you can submit certificates you need:

  1. A registered account — your wallet address must be added to the AccountManager contract with ACTIVE status. Contact NCRB to initiate onboarding.
  2. The REGISTRY_ROLE — granted to your wallet by an NCRB admin after your partnership agreement is signed.
  3. MetaMask installed and connected to the correct network — see the Quickstart guides if you have not set this up.
  4. A small amount of native gas token (AVAX, ETH, or XRP) in your wallet to pay transaction fees.

The Certificate Lifecycle

Registry submits certificate


Oracle API computes quality score (0–100)


Certificate enters Governance queue

┌──┴──────────────────┐
│ 3-of-5 governance │
│ members vote │
└──┬──────────────────┘

┌────┴────┐
Approved Rejected / Expired


Tokens minted and distributed


Certificate available on marketplace

Submitting a Certificate

1 — Connect Your Wallet

  1. Go to the Registry Portal in the NCRB dApp
  2. Click Connect Wallet and select MetaMask
  3. Approve the connection in MetaMask
  4. Confirm the network matches the chain you intend to submit on (Fuji, Sepolia, or XRPL testnet)

2 — Select Asset Type

Choose one of the 10 supported asset classes:

#Asset TypeUnit
0Carbon CredittCO₂e
1Plastic Credittonne
2Nitrogen Creditkg N
3Phosphorus Creditkg P
4Agricultural Landhectares
5Mining Rightshectares
6Water Rights
7Renewable Energy CreditMWh
8Forestry Rightshectares
9Biodiversity Credithectares

3 — Enter Certificate Details

Fill in the certificate metadata:

FieldDescription
Serial NumberYour registry's unique certificate identifier (e.g. VCS-2024-001-001)
Project NameName of the underlying project or asset
DescriptionBrief description of the project and environmental impact
Vintage / YearYear the environmental benefit was generated
MethodologyRegistry methodology code (e.g. VM0015 for Verra)
CountryCountry where the project is located
QuantityVolume of the asset (in the unit for your asset type)

4 — Upload Certificate Document

Upload your verification document to IPFS:

  1. Click Upload Certificate
  2. Select the PDF or JSON file from your local machine
  3. The portal uploads it to IPFS via Filebase — you will receive a CID (content identifier)
  4. This CID is stored on-chain as the authoritative reference to your certificate document

5 — Configure Quality Parameters

Enter the quality inputs that will be scored by the Oracle API. The fields vary by asset type. For carbon credits:

FieldExample
Sylvera / BeZero RatingA
Additionality TypeFinancial additionality
Permanence MechanismBuffer pool
Certification LevelCCP-Approved
Co-benefitsCCB Gold, SDG 13, SDG 15
Indigenous Community EngagementYes / No

The portal will show a live quality score preview as you fill in the fields.

6 — Set Token Distribution

Specify how token sale proceeds are distributed. The default split is:

RecipientDefault Share
Asset Owner70%
NCRB Platform10%
Registry Partner10%
Third Party (aggregator)10%

You can adjust these percentages — they must sum to 100%.

7 — Select SDG Goals

Select the UN Sustainable Development Goals your project contributes to. These are indexed on-chain and used by buyers to filter by impact alignment.

8 — Submit

  1. Review all details on the confirmation screen
  2. Click Submit Certificate
  3. MetaMask will prompt you to sign two transactions:
    • Transaction 1: Upload metadata to IPFS and call AssetRegistry.submitCertificate()
    • Transaction 2: Record quality assessment via QualityAssessment.recordAssessment()
  4. Confirm both in MetaMask and wait for on-chain confirmation

Your certificate will now appear in the Governance queue.


After Submission

Tracking Your Submission

  • Go to the Registry Portal and view the My Certificates tab
  • Status will show: PendingApprovedTokens Minted (or Rejected)
  • You can also track the proposal in the ExplorerStandards / Compliance tab

What Happens if Rejected?

A governance member will record a rejection reason on-chain. Review the reason, correct the certificate details if possible, and resubmit as a new certificate.

Token Distribution

When governance approves your certificate:

  • Tokens are minted atomically to all distribution recipients in a single transaction
  • You can view the minting event in the My Certificates tab
  • Token balances appear immediately in each recipient's MyNCRB Dashboard

Quality Score Requirements

BandScoreResult
AAA85–100Eligible — premium pricing
AA75–84Eligible
A65–74Eligible
BBB50–64Eligible — minimum threshold
Not Eligible< 50Submission rejected before governance queue

Certificates scoring below 50 are rejected at the quality assessment stage and do not enter the governance queue.


Multi-Chain Submissions

You can submit the same underlying certificate to multiple chains to reach different liquidity pools. Each submission is tracked separately by the CAD Registry (Cross-chain Anti-Duplication) to prevent the same real-world asset from backing tokens on two chains simultaneously.


Need Help?

See the FAQ or visit Support for assistance with your submission.