Skip to main content

Getting Started with Node.js

Safe Password Storage

In a production setup, do not store passwords in the host's environment variables or in the source code. See our backup and security recommendations for production setups.


  • One of the following Node.js versions: '16.x', '18.x';

Install the IOTA SDK

Install Using a Package Manager

To start using the IOTA SDK in your Node.js project, you can install the IOTA SDK from your package manager of choice:

npm i @iota/sdk

Build the Binding from Source


If you want to build the IOTA SDK from source, please ensure you have the installed the following:


On Windows, you will also need LLVM. Our workflow uses You may also need to set an environment variable RUSTFLAGS to -C target-feature=+crt-static.

Install LLVM with Chocolatey

If you use Chocolatey you can install LLVM by executing choco install llvm


You can build the IOTA SDK from source by doing the following:

  1. Download the repository to any directory you choose:
git clone
  1. Move to the Node.js binding directory:
cd iota-sdk/bindings/nodejs
  1. Install the necessary dependencies with either of the following commands:
npm install
  1. Build the SDK:
npm run build

This command uses the cargo-cp-artifact utility to run the Rust build and copy the built library into ./build/Release/index.node. Prebuild requires that the binary is in build/Release as though it was built with node-gyp.



After you installed the library, you can create a Client instance and interface with it.



After you installed the library, you can create a Wallet instance and interact with it.


What's next?

How-To Guides

Once you have installed the IOTA SDK, you can start building your application. You can find usage examples in this Wiki's how-to guides.

More Examples

You can use the provided code examples to get acquainted with the IOTA SDK. You can use the following commands to run any example:

cd examples
yarn run-example ./[example folder]/[example file]
  • Where [example file] is the file name from the example folder. For example:
yarn run-example  examples/client/00_get_info.ts