- Update dbis_core, cross-chain-pmm-lps, explorer-monorepo, metamask-integration, pr-workspace/chains - Omit embedded publish git dirs and empty placeholders from index Made-with: Cursor
1.6 KiB
1.6 KiB
GRU V2 IPFS Metadata Runbook
Purpose: Keep GRU v2 presentation metadata decentralized while storing only URIs on-chain.
Architecture
CompliantFiatTokenV2.tokenURI()
-> ipfs://<cid>/cusdt-v2/metadata.json
-> metadata.json
-> logo/image ipfs://<logo-cid>
Each GRU v2 token also carries:
regulatoryDisclosureURIreportingURI
Those URIs can point at separate IPFS JSON documents so governance and reporting can evolve without storing large blobs on-chain.
Repo source of truth
Metadata bundle source files live under:
config/gru-v2-metadata/chain138/cusdt-v2/config/gru-v2-metadata/chain138/cusdc-v2/
Publish to IPFS
bash scripts/deployment/publish-gru-v2-chain138-metadata-to-ipfs.sh
Default IPFS API:
http://192.168.11.35:5001
The script:
- uploads the metadata/disclosure/reporting bundle
- writes
config/gru-v2-metadata/chain138/ipfs-manifest.latest.json - prints exportable env vars for deployment
Deploy with metadata
eval "$(
bash scripts/deployment/publish-gru-v2-chain138-metadata-to-ipfs.sh \
| awk '/^export / { print }'
)"
bash scripts/deployment/deploy-gru-v2-chain138.sh
The deploy path consumes:
CUSDT_V2_TOKEN_URICUSDT_V2_REGULATORY_DISCLOSURE_URICUSDT_V2_REPORTING_URICUSDC_V2_TOKEN_URICUSDC_V2_REGULATORY_DISCLOSURE_URICUSDC_V2_REPORTING_URI
Operational note
Wallets and explorers may cache logos and metadata. Updating the IPFS content will not refresh every client immediately, so treat metadata changes as gradual propagation events.