Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Introduction

Whisky is an open-source Cardano Rust SDK built by SIDAN Lab. It provides a comprehensive set of tools for building Cardano DApps in Rust, with a chainable builder API inspired by MeshJS.

Modules

Whisky is organized as a Rust workspace with the following crates:

CrateDescription
whiskyThe main crate — re-exports everything you need for DApp development
whisky-commonShared types, interfaces, and utilities used across all crates
whisky-pallasTransaction serializer built on TxPipe’s Pallas (recommended)
whisky-cslLegacy serializer built on cardano-serialization-lib
whisky-providerProvider integrations for Blockfrost and Maestro
whisky-walletWallet signing and key management utilities
whisky-macrosProcedural macros for Plutus data encoding
whisky-jsWASM bindings for JavaScript/TypeScript usage

What You Can Do

With whisky, you can:

  • Build transactions with a chainable, cardano-cli-like API supporting complex DApp backends
  • Parse and edit transactions from raw CBOR hex
  • Sign transactions with key-based signing in Rust
  • Interact with the blockchain via Maestro and Blockfrost providers
  • Evaluate scripts off-chain using TxPipe’s uplc for execution unit estimation
  • Swap serializer backends between Pallas and CSL via dependency injection

Guide Overview

This guide walks you through:

  1. Installation — Adding whisky to your project
  2. Quick Start — Building your first transaction
  3. Transaction Builder — Simple sends, Plutus scripts, minting, staking
  4. Transaction Parser — Parsing and editing existing transactions
  5. Dependency Injection — Pluggable serializers and providers
  6. Migration: CSL to Pallas — Upgrading from the legacy backend

For full API reference, see the generated Rust docs.