đ Get Blob ID from CID
When you upload a file to Lighthouse IPFS Walrus, you receive an IPFS CID the content address used for retrieval through IPFS gateways and Lighthouse tooling. Under the hood, the file is stored as a Walrus blob on Sui, which has its own blob ID.
Use this API to look up the Walrus blob ID for a given CID. This is useful when you need to interact with Walrus-native tooling, on-chain references, or Sui ecosystem integrations that work with blob IDs rather than CIDs.
CID vs Blob IDâ
| IPFS CID | Walrus Blob ID | |
|---|---|---|
| Purpose | Content addressing for IPFS retrieval | Identifier for the blob on the Walrus network |
| Format | Multibase-encoded string (e.g. bafkrei...) | Base64url-encoded string |
A single CID maps to one or more Walrus blob IDs in the blobIds array.
APIâ
curl 'https://api.lighthouse.storage/api/lighthouse/walrus_blobs?cid=bafkreiabc123examplecidvalue000000000000000000000000000000'
Query parameters:
| Parameter | Required | Description |
|---|---|---|
cid | Yes | The IPFS CID of the Walrus-backed file |
No authentication is required for this endpoint.
Sample response:
{
"blobIds": [
"xK9mP2vL8nQ4rT6wY1zA3bC5dE7fG0hJ2kM4nP6qR8sT0uV2wX4yZ6aB8cD0eF"
]
}
Response fields:
| Field | Type | Description |
|---|---|---|
blobIds | string[] | Walrus blob IDs associated with the given CID |
Replace the cid query parameter with the CID of the file you want to look up. You can find CIDs in your upload response, the List Files API, or the Walrus dashboard.
Note: If you need file metadata such as name, size, or MIME type, use the File Info API instead.