Arweave Multihost JS SDK
JavaScript/TypeScript Arweave SDK with multiple host support. It is a wrapper for the official Arweave JS SDK, which allows to configure multiple hosts.
By default it uses the first host from the host list, but if it fails to execute any request (like sending a transaction or getting the network info) it will automatically switch the host to the next one from the list and make it the new default. If all the hosts fail to execute the request, error will be thrown.
🚀 Demo
Try it directly in CodeSandbox: demo link
📦 Installation
Using npm
npm install arweave-multihost
Using yarn
yarn add arweave-multihost
💡 Usage
1. Importing
const ArweaveMultihost = require("arweave-multihost");
import ArweaveMultihost from "arweave-multihost";
2. Initialisation
Init with custom hosts
const arweave = ArweaveMultihost.init(
[
{
host: "arweave.net",
protocol: "https",
port: 443,
},
{
host: "gateway.amplify.host",
protocol: "https",
port: 443,
},
{
host: "arweave.dev",
protocol: "https",
port: 443,
},
], {
timeout: 10000,
logging: true,
logger: console.log,
onError: console.error,
});
Init with the default hosts
You can also use arweave.initWithDefaultHosts(config)
method to initialise Arweave instance with the default hosts array (aweave.net, gateway.amplify.host, arweave.dev)
const arweave = ArweaveMultihost.initWithDefaultHosts({
timeout: 10000,
logging: true,
logger: console.log,
onError: console.error,
});
3. Usage
Then you can use the arweave instance in the same way as you would use it with the standard Arweave JS SDK. See more examples from the official Arweave JS SDK.
🤖 Examples
📜 License
This software is licensed under the MIT © Redstone