🛰️Startrail IPFS CDN gateway
Startrail runs a managed IPFS gateway on top of a CDN at:
https://cdn.startrail.io/ipfs/<cid>This is the recommended gateway for resolving any IPFS CID surfaced by the Startrail platform — including:
SRR metadata JSON (
metadataDigest/metadataCIDreturned by the subgraph, the Get SRR endpoints, and the Issue & Transfer endpoint)Image URLs inside SRR metadata (
thumbnailURL,image,external_urlwhen they reference anipfs://or CID URL)Attachment files (
attachmentFiles[*]) and digital components (digitalComponents[*]) referenced by their CID/hash
It returns the same content as any other public IPFS gateway, but with lower latency, better availability for Startrail-pinned content, and consistent CORS / cache behavior.
Usage
Given a CID such as bafkreiabepvyxyetkcb3xbjo3ocuyfo6psv3rc3yj34hequwcsilyvjima, fetch it as:
https://cdn.startrail.io/ipfs/bafkreiabepvyxyetkcb3xbjo3ocuyfo6psv3rc3yj34hequwcsilyvjimaFor metadata returned by the Issue & Transfer endpoint, the response already includes a ready-to-use URL:
{
"results": [{
"srr": {
"tokenId": "227890056407",
"metadataCID": "bafkrei...",
"metadataURL": "https://cdn.startrail.io/ipfs/bafkrei..."
}
}]
}When the CID starts with 0x
For SRRs issued before 2023, the metadataDigest may be a 32-byte hex string starting with 0x rather than a CID. In that case the metadata is not available on IPFS; fetch it from the Startrail API instead via Get Metadata by Token ID.
Other gateways
If for any reason you need an alternative, the same CID can be served by any public IPFS gateway (e.g. Cloudflare, Storacha, etc.). See How to retrieve SRR metadata for examples. We still recommend the Startrail gateway for production traffic.
Last updated
Was this helpful?