Storage SDK

Provide your own IPFS gateway URLs to use to retrieve files from IPFS.

When calling download or downloadJSON, the SDK will try to download the file from the first gateway URL in the list. If that fails, it will try the next URL in the list, and so on.

const storage = new ThirdwebStorage({
  gatewayUrls: ["my-own-gateway.com", "some-other-gateway.com"],
});

The default value provides three gateways for IPFS:

{
  "ipfs://": [
    "https://gateway.ipfscdn.io/ipfs/",
    "https://cloudflare-ipfs.com/ipfs/",
    "https://ipfs.io/ipfs/",
  ],
}

Provide your own implementation of how to handle downloading from all schemes specified in the gatewayUrls configuration.

// Can instantiate the downloader with the default gateway URLs
const downloader = new StorageDownloader();
const storage = new ThirdwebStorage({ downloader });

Specify the default upload behavior.

// Instantiate the uploader with default configuration
const uploader = new StorageUploader();
const storage = new ThirdwebStorage({ uploader });

Optionally, provide configuration:

const options = {
  // Upload objects with resolvable URLs
  uploadWithGatewayUrl: true,
};
 
const uploader = new StorageUploader(options);
const storage = new ThirdwebStorage({ uploader });