Skip to content

aleph-im/aleph-sdk-ts

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

198ccc9 · Feb 23, 2024
Feb 6, 2024
Feb 23, 2024
Feb 23, 2024
Feb 22, 2024
Feb 22, 2024
Feb 5, 2024
Feb 5, 2024
Feb 5, 2024
Sep 11, 2021
Nov 23, 2022
Sep 29, 2022
Sep 29, 2022
Feb 5, 2024
Feb 5, 2024
Feb 23, 2024
Feb 23, 2024
Feb 19, 2024
Feb 23, 2024

Repository files navigation

aleph-sdk-ts

Description

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).

Quick Start

npm install aleph-sdk-ts

Supported chains

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

On top of that some accounts allow you to encrypt messages, retrieve an account from a browser based wallet (ex: Metamask), or from a Ledger wallet.

Chain Encryption Wallet Ledger
Avalanche ✔️ ✔️
Cosmos
Ethereum ✔️ ✔️ ✔️
NULS2 ✔️
Solana ✔️
Substrate ✔️
Tezos ✔️

Running from source

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

Environments

Supported Node.js versions

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

Version Supported
v14.x ✔️ Full working support
v16.x ✔️ Full working support
v18.x (LTS) ✖️ Some feature may not work (see notes)

* 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.

Running code inside the browser

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.

Contribution

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

License

This software is released under The MIT License.