Skip to main content

Get Started with 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 you 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#

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 can be re-used for other tasks such as automatically generating a Rust library for Cardano metadata specifications!

It is also very easy to create scripts in Rust or WASM to share with stake pools, or even 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!)

Documentation#

This library generates both Typescript and Flow type definitions, so it’s often easiest to see what is possible by just looking at the types! You can find the Flow types here.

You can also look in the example folder to see how to use this library from Typescript or just experiment with the library.

What about other versions of Cardano?#

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

Original binary specifications#

Here are the location of the original CDDL specifications:

Building#

If you need to install Rust, do the following:

curl https://sh.rustup.rs -sSf | sh -s -- -yecho 'export PATH=$HOME/.cargo/bin/:$PATH' >> $BASH_ENVrustup install stablerustup target add wasm32-unknown-unknown --toolchain stablecurl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh

To build this repository, do the following:

git submodule update --init --recursivenvm usenpm installnpm run rust:build-nodejs

Testing#

npm run rust:test

Publishing#

To publish a new version to crates.io

npm run rust:publish

To publish new versions to NPM (only needed if you are an admin of this project)

npm run js:publish-nodejsnpm run js:publish-browsernpm run js:publish-asm