whisky

This is a library for building off-chain code on Cardano. It is a cardano-cli-like wrapper on cardano-serialization-lib (equivalent to MeshJS’s lower-level APIs), supporting serious DApps’ backend on the Rust codebase. It has an active F11 proposal to support the development.

whisky is composed of 2 layers - the root layer sidan-csl-rs and the user-facing layer whisky. sidan-csl-rs composed of the core serialization logic with JSON-to-transaction pattern, compilable to wasm. whisky is the user-facing package that Rust Cardano developers can import directly for use.

Features

• Same API patterns with MeshJS - lower learning curve for developers.
• Integrated with TxPipe's uplc for off-node auto redeemer exUnits updates.
• Full inline documentation hosted at github

Installation

Rust Library

1cargo add whisky

JS / TS WASM Lib

1# For nodejs package
2yarn add @sidan-lab/sidan-csl-rs-nodejs
3# For browser package
4yarn add @sidan-lab/sidan-csl-rs-browser

Getting Started

1use whisky::{
2    builder::TxBuilder,
3    model::{Asset, UTxO},
4};
5
6async fn my_first_whisky_tx(
7    recipient_address: &str,
8    my_address: &str,
9    inputs: Vec<UTxO>,
10) -> String {
11    let mut tx_builder = TxBuilder::new_core();
12    tx_builder.tx_out(
13        &recipient_address,
14        vec![Asset::new_from_str("lovelace", "1000000")],
15    )
16    .change_address(my_address)
17    .select_utxos_from(inputs.clone(), 5000000)
18    .complete(None)
19    .await;
20
21    tx_builder.tx_hex()
22}

APIs

Please refer to the hosted documentation for the list of endpoints.