This SDK offers binding to interact with the Aleph decentralized network.

Written in Typescript it is meant as a drop in replacement for the aleph-js library. It works both in the browser, on a server using Node.js, or an Aleph Virtual Machine without internet access (using socat).

npm install aleph-sdk-ts

• An API reference on the repository github pages
• For guides and use-cases check the Aleph TS SDK Gitbook
• Some examples are available in the /examples directory.

This is the list of currently supported Account types. For each of them you can:

• Retrieve an account from a private key or mnemonic (or generate one on the fly).
• Sign and send messages on the Aleph Network
• Some allow you to retrieve an account from a browser based wallet (ex: Metamask), or from a Ledger wallet.

Previous versions of the Typescript SDK allowed you to encrypt messages. This has been

If you wish to use feature which are not (yet) released, feel free to clone this repository on your local machine.

Make sure to install the dependencies first by running:

npm install

You can run the test suite, using:

npm run test

This SDK is tested and works, with the following Node.js versions:

* Due to changes in OpenSSL in Node v18, some chains helper may not work. If you encounter bugs using Node v18, you might want to consider using the --openssl-legacy-provider feature flag while running your project.

This SDK relies on several non-native browser modules (such as Streams and Buffer). While bundling your application, either using rollup (ex: Vite) or webpack (ex: create-react-app) you might have to rely on external polyfills for those features.

You can check the configuration files from the examples/toolshed directory to get started. Please note that we won't provide polyfills as part of this SDK.

Your contributions are always welcome, here's a guide to get started.

This software is released under The MIT License.