Pull-mirror of github.com/Sulkta-Coop/pallas. Canonical lives on GitHub; this is a LAN-fast read-only cache.
Kayos
8091abd1b4
AUDIT-2026-05-06 M-4 fix from the aldabra Phase 3-6 audit. NonEmptyKeyValuePairs::decode in pallas-codec accepts `0xa0` (empty CBOR map) because the upstream empty-map check is commented out. That decoded value re-encodes correctly and passes through pallas-txbuilder, but the resulting Conway tx fails ledger validation at submit time with a non-obvious error. Add a debug_assert_ne! on the builder method input + clear doc note warning callers to omit the field instead of passing an empty map. Release builds pass through (no overhead); dev/test builds catch accidental empty-map calls with a clear panic message. The pre-existing aldabra build_signed_drep_vote_cast always constructs a non-empty map so it doesn't trip this; the guard is for future callers. |
||
|---|---|---|
| .chglog | ||
| .github | ||
| assets | ||
| examples | ||
| pallas | ||
| pallas-addresses | ||
| pallas-applying | ||
| pallas-bech32 | ||
| pallas-codec | ||
| pallas-configs | ||
| pallas-crypto | ||
| pallas-hardano | ||
| pallas-math | ||
| pallas-network | ||
| pallas-primitives | ||
| pallas-traverse | ||
| pallas-txbuilder | ||
| pallas-utxorpc | ||
| pallas-wallet | ||
| test_data | ||
| .gitignore | ||
| BRANCH-NOTES.md | ||
| Cargo.toml | ||
| CHANGELOG.md | ||
| LICENSE | ||
| README.md | ||
| rustfmt.toml | ||
| SECURITY.md | ||
Rust-native building blocks for the Cardano blockchain ecosystem
Introduction
Pallas is an expanding collection of modules that re-implements common Ouroboros / Cardano logic in native Rust. This crate doesn't provide any particular application, it is meant to be used as a base layer to facilitate the development of higher-level use-cases, such as explorers, wallets, etc (who knows, maybe even a full node in a far away future).
Unboxing
The repository is organized as a Cargo workspace. Each Pallas "building block" lives in its own crate. The root pallas crate serves as an all-in-one dependency that re-exports all of the other modules in an hierarchically organized fashion, using Cargo features to tailor the setup for each use-case.
Core
| Crates | Description |
|---|---|
| pallas-codec | Shared CBOR encoding / decoding using minicbor lib |
| pallas-crypto | Shared Cryptographic primitives |
| pallas-math | Shared mathematics functions |
Network
| Crates | Description |
|---|---|
| pallas-network | Network stack providing multiplexer and mini-protocol implementations |
Ledger
| Crates | Description |
|---|---|
| pallas-primitives | Ledger primitives and cbor codec for the different Cardano eras |
| pallas-traverse | Utilities to traverse over multi-era block data |
| pallas-addresses | Encode / decode Cardano addresses of any type |
Wallet
| Crates | Description |
|---|---|
| pallas-wallet | Wallet utilities for secure key management |
| pallas-txbuilder | Ergonomic transaction builder |
Interop
| Crates | Description |
|---|---|
| pallas-hardano | Interoperability with implementation-specific artifacts of the Haskell Cardano node |
| pallas-utxorpc | Interoperability with the UTxO RPC specification |
Etymology
Pallas: (Greek mythology) goddess of wisdom and useful arts and prudent warfare;