RWA Issuance

Enterprise issuance flow, compliant transfers and production boundaries
Writing date: 2026-05-05

Current implementation

CapabilityCodeStatus
Persistent RWA statepkg/rwa/state_manager.go, pkg/rwa/state_snapshot.go, pkg/rwa/leveldb_store.goImplemented and tested
Enterprise RPCpkg/rpc/rwa_rpc.go, pkg/rpc/rwa_enterprise_rpc_test.goFull flow tested
Standard contract templatecontracts/zorai-token-templates/ZORAIRWAToken.solTemplate implemented
Contract testscontracts/hardhat/test/ZORAIRWAToken.test.tsERC20 logs and controls covered
ERC3643 precompilepkg/evm/erc3643_precompiled.goSigned low-level support
RWA compliance precompilepkg/evm/rwa_precompiled.goSigned admin support, not enough alone for production assets
Institutional modulespkg/rwa/compliance.go, pkg/rwa/state_enterprise.goDynamic compliance, funds and RegTech tested

Recommended enterprise flow

  1. Issuer onboarding and multisig binding.
  2. Asset registration with jurisdiction, document hash/URI and securities metadata.
  3. Verifier and valuer registration.
  4. Document vault records for legal files, audits, custody proofs and disclosures using hash/URI/version/revocation metadata.
  5. Investor KYC state recording without storing raw private files on-chain.
  6. Primary issuance through standard ERC3643/ERC20 contract assets.
  7. Secondary compliant transfer with KYC, freeze, blacklist, jurisdiction and limit checks.
  8. Dividend snapshots, payment proof records, redemption burn records and external settlement proof.
  9. Pre-trade compliance for DEX/OTC venues using rwa_preTradeCheck.
  10. Fund/SPV/tranche/NAV records and withholding-tax cashflow policy.
  11. External attestation and regulatory report export with data hash.

Verified test commands

go test ./cmd/xihud ./pkg/rpc ./pkg/rwa ./pkg/evm
go test -tags explorer ./cmd/explorer
cd contracts/hardhat && npm run compile && npm test -- --grep ZORAIRWAToken

Production RWA assets must be standard EVM contract assets that emit standard ERC20/ERC3643 events. RPC or precompile-local state alone is not enough for wallet, DEX and explorer compatibility. External legal review, custody, payment rails, KYC provider integration and independent security audits are still required before mainnet issuance.