Skip to content

Installation

Release artifacts

Tagged releases are produced by release-please from conventional-commit history. Each release attaches:

Asset Contents
cardano-ledger-reference-<tag>.wasm Extism plugin exposing tx_identify, tx_validate, and tx_evaluate_scripts. The conformance reference for alternative node implementations: load it with any Wasmtime-backed Extism host SDK. The Go SDK does not work yet because its bundled wazero predates wasm tail-call support.
wasm-tx-inspector-<tag>.wasm The same Conway ledger packaged as a WASI reactor (stdin/stdout JSON), for shell-driven debugging and the inspector UI.
ledger-functional-openapi-<tag>.tar.gz OpenAPI contract for the JSON envelope.
SHA256SUMS-<tag>.txt Checksums for the assets above.

Download from the releases page.

Build with Nix

All artifacts are flake outputs and can be built without a checkout:

nix build github:lambdasistemi/cardano-ledger-inspector#packages.x86_64-linux.wasm-tx-inspector
nix build github:lambdasistemi/cardano-ledger-inspector#packages.x86_64-linux.tx-inspector-ui
nix build github:lambdasistemi/cardano-ledger-inspector#packages.x86_64-linux.tx-deep-diagnosis

The native CLI also runs directly; its protocol registry is bundled into the binary, so no checkout is needed:

nix run github:lambdasistemi/cardano-ledger-inspector#tx-deep-diagnosis -- \
  --cbor my-tx.hex --format explain

Flake outputs are exposed for x86_64-linux and aarch64-darwin; CI exercises the Linux outputs.

CI artifacts (per-run, ephemeral)

Every CI workflow run uploads wasm-tx-inspector, tx-inspector-ui, and ledger-functional-openapi artifacts (each with SHA256SUMS) retained for 30 days. Use these for inspecting a specific PR; use a tagged release for anything you depend on. See CI workflow runs.

Browser workbench

The transaction inspector needs no installation; it runs in the browser at https://lambdasistemi.github.io/cardano-ledger-inspector/inspector/.

The browser package loads the large inspector and RDF shapes WebAssembly modules as separate hashed assets, so repeat visits can reuse the browser HTTP cache instead of downloading those bytes inside index.js. The Nix-built package also includes .gz and .br precompressed copies of HTML, JavaScript, CSS, and wasm files, including both hashed wasm assets.

GitHub Pages and the shared PR preview host may serve the uncompressed files and ordinary cache headers until their host configuration supports static brotli/gzip siblings and immutable cache policy for hashed assets. The repository package still contains the precompressed files, so hosts with brotli_static/gzip_static-style support can serve them without rebuilding the UI.