arweave-multihost

JavaScript/TypeScript Arweave SDK with multiple host support

Showing:

Popularity

Downloads/wk

232

GitHub Stars

7

Maintenance

Last Commit

2mos ago

Contributors

4

Package

Dependencies

2

License

MIT

Type Definitions

Built-In

Tree-Shakeable

No?

Categories

Readme

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

// Using Node.js `require()`
const ArweaveMultihost = require("arweave-multihost");

// Using ES6 imports
import ArweaveMultihost from "arweave-multihost";

2. Initialisation

Init with custom hosts

const arweave = ArweaveMultihost.init(
  // Hosts
  [
    {
      host: "arweave.net", // Hostname or IP address for a Arweave host
      protocol: "https",   // Port
      port: 443,           // Network protocol http or https
    },
    {
      host: "gateway.amplify.host",
      protocol: "https",
      port: 443,
    },
    {
      host: "arweave.dev",
      protocol: "https",
      port: 443,
    },
  ], {
    timeout: 10000,         // Network request timeouts in milliseconds
    logging: true,          // Enable network request logging
    logger: console.log,    // Logger function
    onError: console.error, // On request error callback
  });

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,         // Network request timeouts in milliseconds
  logging: true,          // Enable network request logging
  logger: console.log,    // Logger function
  onError: console.error, // On request error callback
});

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

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100