@emurgo/cardano-serialization-lib-nodejs

Cardano Serialization Lib

This is a library for serialization & deserialization of data structures used in Cardano's Haskell implementation of Shelley along with useful utility functions.

How can I use this library

Rust is wonderfully portable! You can easily bind to the native Rust library from any common programming language (even C and WebAssembly)!

NPM packages

• NodeJS WASM package
• Browser (chrome/firefox) WASM package

Mobile bindings

• React-Native mobile bindings

Benefits of using this library

Serialization/deserialization code is automatically generated from Cardano's official specification, which guarantees it can easily stay up to date! We do this using an EMURGO-written tool called cddl-codegen which be re-use to automatically generate a Rust library for Cardano metadata specifications!

It is also very easy to create scripts in Rust or WASM to share with stake pools of embed inside an online tool. No more crazy cardano-cli bash scripts!

Powerful and flexible enough to be used to power wallets and exchanges! (Yes, it's used in production!)

What about other versions of Cardano?

If you are looking for legacy bindings, you can find them at the following:

• Byron WASM bindings
• Jormungandr WASM bindings

Original binary specifications

Here are the location of the original CDDL specifications:

• Byron: link
• Shelley: link

Building

If you need to install Rust, do the following:

curl https://sh.rustup.rs -sSf | sh -s -- -y
echo 'export PATH=$HOME/.cargo/bin/:$PATH' >> $BASH_ENV
rustup install stable
rustup target add wasm32-unknown-unknown --toolchain stable

To build this repository, do the following:

git submodule update --init --recursive
nvm install && nvm use
npm run rust:build-nodejs
npm install

Testing

npm run rust:test
npm run js:test

Publishing

npm run js:publish-nodejs
npm run js:publish-browser