PrimerPadDocs

Protocol

Primitive Registry

The registry maps a user-facing financial Primitive to the Solana mint that becomes the quote side of its markets, and records whether PrimerPad can and should launch against it.

Schema

Source of truth: src/primitives/schema.ts and src/primitives/seed.ts. The web app imports the same file, so UI, docs and engine never carry a second copy of a mint address.

FieldTypeMeaning
idstringStable registry id (e.g. mortgage, japan).
displayName / displaySubtitlestringConsumer-facing name, e.g. "U.S. Mortgage Credit", "Quoted in USDX".
shortDescriptionstringOne-line description for UI.
categorystringFinancial category (Mortgage Credit, Sovereign Duration, Credit...).
issuerstringIssuer of the quote asset (Stable, Ondo Global Markets).
quoteSymbolstringTicker of the quote mint (USDX, EWJon).
quoteMintstringThe actual Solana mint that becomes the DBC quote mint.
network'mainnet' | 'devnet' | ...Cluster the mint lives on.
decimalsnumberMint decimals, verified on-chain.
tokenProgram'spl-token' | 'token-2022'Owning token program.
extensionsstring[]Token-2022 extensions observed at registry time.
requiresDbcTokenBadge / dbcTokenBadgeboolean / stringWhether DBC needs a Meteora TokenBadge for this quote mint, and the badge PDA when one exists.
engineCompatibility'CERTIFIED' | 'FAILED'Can the engine run a full DBC to DAMM v2 lifecycle with this mint.
launchAvailability'LIVE' | 'LIMITED' | 'INTEGRATION' | 'PAUSED'Should launches be offered right now.
availabilityReasonstringWhy availability is not LIVE.
configKeystringKey of the Primer config in the Config Factory store (primer-standard-usdx).
curveCurveOverridesPer-quote USD market-cap targets and the max quote a graduation may absorb.
refPriceUsdnumberFallback price when no live price source is reachable.
routeMode'DIRECT_QUOTE' | 'AGGREGATED_INPUT'How buyers reach the market.
migrationMode'DAMM_V2_LOCKED'Graduation target and LP policy.
status / enabledlegacyCoarse status kept for existing consumers.
iconHint, notes, sourcesmiscUI hint, operational notes, verification sources.
Real entry (src/primitives/seed.ts, Mortgage)
{
  "id": "mortgage",
  "displayName": "U.S. Mortgage Credit",
  "displaySubtitle": "Quoted in USDX",
  "category": "Mortgage Credit",
  "issuer": "Stable",
  "quoteSymbol": "USDX",
  "quoteMint": "9Gst2E7KovZ9jwecyGqnnhpG1mhHKdyLpJQnZonkCFhA",
  "network": "mainnet",
  "decimals": 6,
  "tokenProgram": "spl-token",
  "extensions": [],
  "requiresDbcTokenBadge": false,
  "engineCompatibility": "CERTIFIED",
  "launchAvailability": "INTEGRATION",
  "configKey": "primer-standard-usdx",
  "curve": {
    "initialMarketCapUsd": 5000,
    "migrationMarketCapUsd": 60000,
    "maxMigrationQuoteUsd": 25000
  },
  "routeMode": "DIRECT_QUOTE",
  "migrationMode": "DAMM_V2_LOCKED"
}

Engine compatibility vs launch availability

Two separate questions, two separate fields. Supporting an asset technically does not mean every asset has the market depth for the standard launch profile.

StatusFieldMeaning
CERTIFIEDengineCompatibilityThe mint passes certification and the full lifecycle runs (config, launch, swaps, fee claims, migration, DAMM v2).
FAILEDengineCompatibilityA blocking incompatibility, for example a non-zero transfer fee or a missing TokenBadge.
LIVElaunchAvailabilityLaunches open.
LIMITEDlaunchAvailabilityTechnically supported; current inventory or depth constrains launch parameters (graduation profile scaled or production configs refused).
INTEGRATIONlaunchAvailabilityCertified; public-network rollout in progress (mainnet launch path proven by a smoke test, public launches not yet opened).
PAUSEDlaunchAvailabilityLaunches halted: issuer pause, extension change, incident.

Current entries

Availability reasons are recorded per entry in the registry and shown on the status page.
PrimitiveQuoteMintIssuerProgramBadgeEngineAvailability
U.S. Mortgage CreditUSDX9Gst2E…nkCFhAStablespl-tokennot requiredCERTIFIEDINTEGRATION
JapanEWJonC6c7Vc…wPondoOndo Global Marketstoken-20224JyDa3…JArU8WCERTIFIEDLIMITED
U.S. Housing MarketVNQonF3dMJ9…5UondoOndo Global Marketstoken-20229oiyex…2JjucUCERTIFIEDLIMITED
Long TreasuriesTLTonKaSLSW…Z9ondoOndo Global Marketstoken-2022A3NzDi…AEXYthCERTIFIEDINTEGRATION
High Yield CreditHYGonc5ug15…j7ondoOndo Global Marketstoken-2022BPXPqN…yr8gz6CERTIFIEDLIMITED
S&P 500SPYxXsoCS1…BbDF2WBacked Finance (xStocks)token-2022D2THze…PEpNeLCERTIFIEDINTEGRATION
Nasdaq-100QQQxXs8S1u…WAmWHZBacked Finance (xStocks)token-20226nenkW…CS5RoECERTIFIEDINTEGRATION
U.S. Total Stock MarketVTIxXsssYE…45cDr9Backed Finance (xStocks)token-2022742d2Z…nFWiV5CERTIFIEDINTEGRATION
U.S. Small CapsIWMxXsbELV…vFTFu3Backed Finance (xStocks)token-2022GFkoWe…4mYQNZCERTIFIEDINTEGRATION
South KoreaEWYxXswenH…DPS1YoBacked Finance (xStocks)token-2022BgZ1t3…c5v75VCERTIFIEDINTEGRATION
BrazilEWZonCBKcmE…9PondoOndo Global Marketstoken-2022EiSJrA…7iWLFvCERTIFIEDINTEGRATION
ChinaFXIonCeFbGY…5vondoOndo Global Marketstoken-2022CRJPM2…uSYrfsCERTIFIEDLIMITED
IndiaINDAonDBNwt3…FzondoOndo Global Marketstoken-202242C4sE…KT38dFCERTIFIEDLIMITED
GermanyEWGxXsM51P…R6WXi9Backed Finance (xStocks)token-2022Db44K5…3atV6WCERTIFIEDINTEGRATION
United KingdomEWUxXsbWCM…GWfDQ8Backed Finance (xStocks)token-20222126SM…7SPw4CCERTIFIEDINTEGRATION
FranceEWQxXs1neE…mVAQdeBacked Finance (xStocks)token-2022GuM9r2…NEVjZFCERTIFIEDINTEGRATION
EuropeVGKxXsosCA…HYzvbNBacked Finance (xStocks)token-2022BVh5PW…T8ADSoCERTIFIEDINTEGRATION
Emerging MarketsIEMGxXsFnZa…afpfHsBacked Finance (xStocks)token-202257Rbxq…r2dxzxCERTIFIEDINTEGRATION
Developed Markets ex-U.S.SCHFxXsWAnF…WddzhUBacked Finance (xStocks)token-20229P3PYo…TxGCmYCERTIFIEDINTEGRATION
U.S. Treasury BillsTBLLxXsqBC5…w7QEKpBacked Finance (xStocks)token-2022HjayWR…DRiJiLCERTIFIEDINTEGRATION
Intermediate TreasuriesIEIonwuzf2F…UyondoOndo Global Marketstoken-2022HPL7PC…Rr46ThCERTIFIEDINTEGRATION
U.S. Single-Family RentalsINVHxXsQFmC…MorJs7Backed Finance (xStocks)token-2022C4bquG…nWN6kcCERTIFIEDINTEGRATION
West Coast ApartmentsESSxXsZsYW…Agx47NBacked Finance (xStocks)token-2022FM1Qcx…zneWD6CERTIFIEDINTEGRATION
Sun Belt ApartmentsCPTxXsvoRX…zYw2BTBacked Finance (xStocks)token-2022GnJS3q…c2twfNCERTIFIEDINTEGRATION
Treasury Yield DollarUSDYA1KLoB…7sEto6Ondo Financespl-tokennot requiredCERTIFIEDINTEGRATION
Private CreditsyrupUSDCAvZZF1…eaZeUjMaple Financespl-tokennot requiredCERTIFIEDINTEGRATION

Mint verification

Mints were verified against issuer documentation (Stable official accounts, the Ondo address list, the Backed xStocks token registry, Maple's Solana announcement), Jupiter, and on-chain account reads. A known trap: the HYGWon mint (BuyWrite) is not HYGon.

How new Primitives get added

A new financial instrument does not require rebuilding the launchpad. The quote mint and the config are modular.

  1. 01Source the mintIssuer documentation, explorer, issuer address lists.
  2. 02Verify the issuerIssuer identity, eligibility rules, transfer restrictions.
  3. 03Run the certifierprimer certify <MINT> --network mainnet
  4. 04Check token program and extensionsSPL Token, or Token-2022 with its extension set.
  5. 05Check the TokenBadgeRequired for Token-2022 mints with extensions beyond metadata. Issued by Meteora.
  6. 06Test DBCLive-program createConfig simulation, then a full lifecycle on the mainnet fork.
  7. 07Test migrationGraduation into DAMM v2, pair check, LP lock check.
  8. 08Check supplyGraduation feasibility against circulating Solana inventory.
  9. 09Check routingJupiter route from SOL, for future AGGREGATED_INPUT.
  10. 10Create the Primer configConfig Factory, graduation-gated.
  11. 11Enable the registry entryengineCompatibility CERTIFIED, launchAvailability set from evidence.
  12. 12Live on PrimerPad
userPrimerPadMeteoraquote assetSolana

See also: Certification, Graduation feasibility, Status

Explore the registry geographically on the world globe.