🚀 Getting Started with WalCDN
WalCDN is a blazing fast content delivery network layer on top of the Walrus Network, designed to speed up and simplify data retrieval from decentralized nodes. It allows users to fetch blobs from the network quickly and reliably—just like a traditional CDN, but powered by decentralized storage.
⚠️ WalCDN is currently in early development. At this stage, there is no integration with smart contracts, meaning:
- Users can retrieve content for free.
- Uploader does not pay for the retrievals served by the CDN or nodes.
- Nodes serving retrievals are not yet compensated.
Payment mechanisms and incentive distribution will be added in a future update once smart contract integration is live.
🔗 How Retrieval Works
To retrieve content using WalCDN, simply send an HTTP GET request to the following URL format:
https://<uploader-wallet-base36>.walcdn.io/<blob-id><uploader-wallet-base36>: This is the base36-encoded version of the uploader’s wallet address.<blob-id>: The identifier of the blob you're trying to retrieve.
WalCDN uses a base36-encoded version of the uploader's wallet address in the retrieval URL. This is because Sui wallet addresses in hexadecimal format are quite long, and base36 provides a shorter, URL-safe encoding that still uniquely identifies the uploader. To convert your hex address to base36, you can use an online converter like this one. Make sure to remove the 0x prefix from your address before converting it.
Example
If a user with hex encoded wallet address 0x9716a65b4ed415a043... (converted to base36: 3rkdb89wnwzj3f2i7hnvuyna…) uploaded a blob with ID 2AMj7WDWe04aSPTVmFqx_axyTcOvDVvdOyg3TDsZ_Uc, the retrieval URL would be:
https://3rkdb89wnwzj3f2i7hnvuyna5vn7glk9vf3igtht9x6ejmboly.walcdn.io/qXcMXQlBNBzTmmCRJiM0p9tA97A7Pum7zoNoP3fICfM