For the complete documentation index, see llms.txt. This page is also available as Markdown.

Network Configuration

Network Configuration

Program IDs · RPC Endpoints · Oracle Accounts · Multi-Signature Addresses · Parameters

Authoritative reference for all deployed program addresses, infrastructure endpoints, oracle account addresses, multi-signature configurations, and production parameters across mainnet and devnet environments. This page is updated with every deployment.

The platform is operated by Groovy Company, Inc. The trading venue is CEDEX. The qualified-custody and onboarding anchor is Empire Stock Transfer. Production endpoints support all three production modules: Equities (Module 1), Real Estate (Module 2), and CORECM — Carbon Ore, Rare Earth, and Critical Minerals (Module 3).

Deployment status note: Mainnet program IDs and PDA addresses are populated at production deployment (Q3 2026). Placeholder values shown below. This page is updated with production addresses upon mainnet launch.


Table of Contents

  1. ​Program IDs​

  2. ​RPC Configuration​

  3. ​Oracle Accounts​

  4. ​Multi-Signature Wallets​

  5. ​Global Pool Accounts​

  6. ​Production Parameters​

  7. ​SDK Configuration​

  8. ​Environment Variables​

  9. ​Token-2022 Program Reference​

  10. ​Verification Commands


1. Program IDs

Mainnet-Beta

ProgramProgram IDUpgrade AuthorityStatus

Transfer Hook

<HOOK_PROGRAM_ID_TBD>

5-of-9 multi-signature plus 24h timelock

Pending mainnet deployment

AMM

<AMM_PROGRAM_ID_TBD>

5-of-9 multi-signature plus 24h timelock

Pending mainnet deployment

Liquidity Pool

<POOL_PROGRAM_ID_TBD>

None — immutable

Pending mainnet deployment

Governance

<GOV_PROGRAM_ID_TBD>

3-of-5 multi-signature

Pending mainnet deployment

Oracle Aggregator

<ORACLE_PROGRAM_ID_TBD>

5-of-9 multi-signature plus 24h timelock

Pending mainnet deployment

Devnet

ProgramProgram IDUpgrade AuthorityStatus

Transfer Hook

<HOOK_DEVNET_TBD>

Deployer keypair

Deployed

AMM

<AMM_DEVNET_TBD>

Deployer keypair

Deployed

Liquidity Pool

<POOL_DEVNET_TBD>

Deployer keypair

Deployed

Governance

<GOV_DEVNET_TBD>

Deployer keypair

Deployed

Oracle Aggregator

<ORACLE_DEVNET_TBD>

Deployer keypair

Deployed

External Programs

ProgramProgram IDNetworkPurpose

SPL Token-2022

TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb

All

Token standard with Transfer Hook

SPL Token (legacy)

TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA

All

SOL transfers, USDC and PYUSD

Associated Token

ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL

All

ATA derivation

Ed25519 Precompile

Ed25519SigVerify111111111111111111111111111

All

Custody attestation verification

System Program

11111111111111111111111111111111

All

Account creation, SOL transfers

Sysvar Clock

SysvarC1ock11111111111111111111111111111111

All

Timestamp, slot

Sysvar Rent

SysvarRent111111111111111111111111111111111

All

Rent exemption


2. RPC Configuration

Mainnet-Beta

ParameterValue

Primary RPC

https://mainnet.helius-rpc.com/?api-key=<HELIUS_KEY>

Fallback RPC

https://<TRITON_DEDICATED_HOST>.rpcpool.com

WebSocket

wss://mainnet.helius-rpc.com/?api-key=<HELIUS_KEY>

Provider

Helius (dedicated cluster)

Fallback provider

Triton (backup)

Commitment (reads)

confirmed

Commitment (settlement)

finalized

Preflight simulation

Enabled

Priority fee strategy

Dynamic — Jito tip based on congestion

Max retries

3 (exponential backoff: 1s, 2s, 4s)

Timeout

30 seconds

Devnet

ParameterValue

Primary RPC

https://devnet.helius-rpc.com/?api-key=<HELIUS_KEY>

Fallback RPC

https://api.devnet.solana.com

WebSocket

wss://devnet.helius-rpc.com/?api-key=<HELIUS_KEY>

Commitment

confirmed

Preflight

Enabled

Priority fee

None

Max retries

3

Localnet

ParameterValue

RPC

http://localhost:8899

WebSocket

ws://localhost:8900

Commitment

confirmed

Rate Limits

TierRequests/secsendTransaction/secProvider

Production

500+

100+

Helius dedicated

Devnet

100

25

Helius shared

Public fallback

Rate limited

Rate limited

Triton / Solana public

Failover Behavior


3. Oracle Accounts

Mainnet PDA Accounts

OraclePDA SeedsAddressCardinalityModule Scope

CustodyOracle

[b"custody-oracle", mint]

Per-mint derived

One per ST22 mint

All modules

OFACOracle

[b"ofac-oracle"]

<OFAC_ORACLE_PDA_TBD>

Global singleton

All modules

AMLOracle

[b"aml-oracle", wallet]

Per-wallet derived

One per wallet

All modules

SecurityConfig

[b"security-config", mint]

Per-mint derived

One per ST22 mint

All modules

HoldingPeriodAccount

[b"holding-period", mint, beneficiary]

Per-pair derived

One per investor × mint

All modules

NAVOracle

[b"nav-oracle", mint]

Per-mint derived

One per Module 2 mint

Module 2 (Real Estate)

ClassificationOracle

[b"classification-oracle", mint]

Per-mint derived

One per Module 3 mint

Module 3 (CORECM)

ExtraAccountMetaList

Token-2022 standard

Per-mint derived

One per ST22 mint

All modules

PDA Derivation Code

Oracle Relay Service Endpoints

ServiceInternal EndpointHealth CheckModule Scope

Custody Relay

custody-relay:3001

GET /health

All modules

OFAC Indexer

ofac-indexer:3002

GET /health

All modules

AML Bridge

aml-bridge:3003

GET /health

All modules

TWAP Consumer

twap-consumer:3004

GET /health

All modules

EDGAR Pipeline

edgar-pipeline:3005

GET /health

Module 1 (Equities)

NAV Relay

nav-relay:3006

GET /health

Module 2 (Real Estate)

Classification Relay

classification-relay:3007

GET /health

Module 3 (CORECM)

Oracle External Data Sources

OracleExternal APIAuthenticationRate Limit

Empire Custody

https://api.empirestocktransfer.com/v1/custody

API key plus IP whitelist

Per-block (~400ms)

OFAC / SDN

https://api.treasury.gov/ofac/sdn

None (public)

Hourly refresh

Chainalysis KYT

https://api.chainalysis.com/v2/kyt

API key

Per-transfer

TRM Labs

https://api.trmlabs.com/v1/risk

API key

Per-transfer

Pyth Network

On-chain (Solana native)

None

Sub-second

SEC EDGAR RSS

https://www.sec.gov/cgi-bin/browse-edgar?RSS

None (public)

60-second polling

SEC EDGAR EFTS

https://efts.sec.gov/LATEST/search-index

None (public)

Daily batch

NAV Appraiser API (Module 2)

Per-property licensed appraiser endpoints

API key plus mTLS

Reappraisal-cycle cadence

USGS Critical Minerals (Module 3)

https://mrdata.usgs.gov/critical-minerals

None (public)

Daily plus emergency on EO update

DOE Critical Materials (Module 3)

https://www.energy.gov/eere/critical-materials

None (public)

Daily plus emergency on policy update


4. Multi-Signature Wallets

Mainnet Multi-Signature Addresses

Multi-SignatureAddressThresholdSignersPurpose

Upgrade Authority (5-of-9)

<UPGRADE_MULTISIG_TBD>

5 of 9

Geographically distributed

Transfer Hook, AMM, Oracle program upgrades

Parameter Authority (3-of-5)

<PARAM_MULTISIG_TBD>

3 of 5

Fee, threshold, cooldown adjustments

Emergency Authority (3-of-5 plus Legal)

<EMERGENCY_MULTISIG_TBD>

3 of 5 plus Legal Counsel

Control 42 regulatory freeze

Timelock Configuration

AuthorityTimelockCancellation

5-of-9 (upgrade)

24 hours

2-of-5 during window

3-of-5 (parameter)

48 hours

2-of-5 during window

Emergency (Control 42)

None — immediate

N/A

Signer Distribution

SignerJurisdictionKey StorageBackup

1

US East

Ledger Enterprise HSM

Encrypted cold backup

2

US West

Ledger Enterprise HSM

Encrypted cold backup

3

EU

Ledger Enterprise HSM

Encrypted cold backup

4

APAC

Ledger Enterprise HSM

Encrypted cold backup

5

US Central

Ledger Enterprise HSM

Encrypted cold backup

6–9

Distributed

Ledger Enterprise HSM

Encrypted cold backup

No signer holds more than one signing position in any quorum. Key rotation follows the same multi-signature threshold as the actions the keys authorize.


5. Global Pool Accounts

Mainnet

AccountAddressPurpose

GlobalPool PDA

Derived: [b"global-pool"]

Pool state account

SOL Vault

<GLOBAL_POOL_SOL_VAULT_TBD>

SOL reserve (permanently locked)

LP Mint

<GLOBAL_POOL_LP_MINT_TBD>

LP mint (supply = 0, burned)

Pool Properties

PropertyValueVerifiable?

LP supply

0 (burned at initialization)

solana account <LP_MINT> --output json | jq '.data.parsed.info.supply'

LP mint authority

None

solana account <LP_MINT> --output json | jq '.data.parsed.info.mintAuthority'

Pool program upgrade authority

None (immutable)

solana program show <POOL_PROGRAM_ID> | grep Authority

Withdrawal function

Does not exist in bytecode

Certora invariant E.3


6. Production Parameters

Transfer Hook Parameters

ParameterValueGovernance RangeImmutable?

max_wallet_percent

499 (4.99%)

100–999 (1%–9.99%)

No

circuit_breaker_threshold

3000 (30%)

1000–5000 (10%–50%)

No

circuit_breaker_cooldown

86,400 sec (24h)

3,600–259,200 (1h–72h)

No

price_impact_max_bps

200 (2%)

100–500 (1%–5%)

No

twap_window_secs

1,800 (30 min)

900–3,600 (15min–1h)

No

twap_min_observations

60

Yes

outlier_rejection_sigma

3

Yes

holding_period_rule_144

15,778,800 sec (6 months)

Yes

holding_period_reg_s

31,536,000 sec (12 months)

Yes

Module 2 NAV Parameters (Real Estate)

ParameterValueGovernance RangeImmutable?

nav_deviation_max_bps

Per-property

200–2000 (2%–20%)

No

nav_reappraisal_max_age_secs

Per-property

Per offering documentation

No

nav_circuit_breaker_enabled

True

Yes

Module 3 CORECM Parameters

ParameterValueGovernance RangeImmutable?

classification_max_age_secs

86,400 (24h)

21,600–172,800 (6h–48h)

No

federal_action_freeze_enabled

True

Yes

Fee Configuration

ParameterValue (BPS)Percentage

total_fee

500

5.00%

pool_fee

44

0.44%

issuer_fee

200

2.00%

staking_fee

150

1.50%

protocol_fee

106

1.06%

Invariant: pool_fee + issuer_fee + staking_fee + protocol_fee == total_fee

Oracle Staleness Thresholds

OracleCache ValidWarningHalt

Custody

1 slot (~400ms)

>3 slots

>1 slot (Error 6002)

OFAC

24 hours

>12 hours

>48 hours (Error 6005)

AML

6 hours

>3 hours

No score available (Error 6006)

TWAP

5 minutes

>2 minutes

>5 minutes (breaker disabled)

EDGAR

36 hours

>24 hours

No halt (continue with last batch)

NAV (Module 2)

Per-property

Half of nav_reappraisal_max_age_secs

Beyond nav_reappraisal_max_age_secs (mint paused)

Classification (Module 3)

24 hours

>12 hours

>48 hours (enhanced review on transfers)

Circuit Breaker Parameters

BreakerTriggerResponseCooldown

Price halt

>10% move in 5 minutes

15-minute trading halt

Automatic on TWAP normalization

Price impact

>2% single-trade impact vs TWAP

Block trade (Error 6021)

Immediate (per-trade)

Volume halt

>30% daily sell by single wallet

24-hour wallet halt

24 hours

Oracle failure (custody)

Custody stale >1 slot

Halt ALL transfers

Until oracle restored

NAV deviation (Module 2)

On-chain price outside nav_deviation_max_bps of NAV

Halt affected mint

Until next reappraisal cycle

AML Risk Thresholds

Score RangeDispositionAction

0–30

Approve

Transfer proceeds

31–70

Enhanced review

Transfer proceeds, flagged for 24h compliance review

71–100

Reject

Transfer rejected (Error 6006)


7. SDK Configuration

Mainnet

Devnet

Localnet


8. Environment Variables

Production (.env.mainnet)

Development (.env.devnet)

Local (.env.local)


9. Token-2022 Program Reference

Key Addresses

ComponentAddress

Token-2022 Program

TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb

Associated Token Program

ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL

ST22 Mint Extensions

Every ST22 mint — across all three modules — is created with these Token-2022 extensions:

ExtensionPurposePermanent?

Transfer Hook

Points to the platform's Transfer Hook program — 42 controls on every transfer

Yes — cannot be removed

Metadata

On-chain: issuer or property or basin name, symbol, classification (CUSIP for Module 1; property identifier for Module 2; USGS classification for Module 3)

Yes

Transfer Fee

5% protocol fee enforced at token program level

Yes

Permanent Delegate

Empire Stock Transfer — emergency freeze capability

Yes

Verifying a Mint's Extensions

Settlement Tokens

StablecoinMint Address (Mainnet)ProgramDecimals

USDC (Circle)

EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

SPL Token

6

PYUSD (PayPal/Paxos)

2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo

SPL Token

6

All ST22 settlement across Modules 1, 2, and 3 occurs in USDC or PYUSD pursuant to the GENIUS Act framework.


10. Verification Commands

Verify Program Deployment

Verify Upgrade Authorities

Verify Transfer Hook on Mint

Verify Oracle Health

Verify Global Pool

Verify SecurityConfig Parameters

Quick Health Check Script


  • Solana Blockchain Foundation — Why Solana, Token-2022, Transfer Hook, module-specific foundations

  • Architecture Decisions — ADR-001 through ADR-012 with full alternatives analysis

  • Security Model — Threat model, key management, formal verification, module-specific threat surfaces

  • Infrastructure Overview — Cloud architecture, environment separation, blockchain infrastructure, module-specific considerations

  • Deployment Guide — How to deploy and initialize all programs

  • Oracle Integration Guide — Oracle relay service configuration, fail-safe cascade, module-specific oracles

  • SDK Reference — SDK initialization using these endpoints

  • Smart Contract Reference — Program instruction specifications


RWA Tokens · Network Configuration · Groovy Company, Inc.

Last updated

Was this helpful?