Kayos
93f11ecef0
README + supporting docs were written for ourselves (deployment paths,
internal product comparisons, internal task lists, build pipeline
artifacts) instead of for users of the software. This pass refocuses
them on what the software is, how to install, configure, and use it.
- README.md: full rewrite. New shape — What it does / Architecture /
Build / Run / Configuration / MCP tools / Security model / Status /
License / Dependencies. Drops the internal "why we built it"
narrative, drops phase-status claims that drifted stale, drops
internal deployment paths.
- ROADMAP.md: deleted. Was an internal task-list with [x]/[ ] items
showing incremental private development. The README's Status
section now communicates what's actually shipped.
- docs/architecture.md: scrub cross-project comparisons referencing
unrelated internal Sulkta codebases.
- aiken-escrow/README.md: drop reference to a non-existent spec file;
rewrite the Status checklist to reflect what's actually done
rather than what was open at the time of writing.
- audits/2026-05-09-escrow-e2e.md: scrub internal image names +
container paths; the audit findings (chain hashes, validator hash,
what each tx proved) are the public-useful part and stay.
- audits/2026-05-09-escrow-internal-audit.md: drop references to
feature-flag-gated branches that no longer exist.
- Dockerfile: drop the dead `escrow_wip surface` phrase from comments.
- Cargo.toml: drop the cross-project comparison comment that named
an unrelated internal service.
- crates/aldabra-{core,dao}: scrub internal preprod-test naming from
source comments — same technical content, generic phrasing.
109 lines
4.5 KiB
TOML
109 lines
4.5 KiB
TOML
# Cargo workspace root for aldabra.
|
|
#
|
|
# Four crates:
|
|
# aldabra-core — key derivation, signing, types, mnemonic handling
|
|
# aldabra-chain — pluggable chain backends (Koios, Ogmios). Trait-first.
|
|
# aldabra-dao — Agora-on-Cardano DAO interaction; multi-DAO from day 1.
|
|
# aldabra-mcp — binary; the MCP server, glues core+chain+dao together.
|
|
#
|
|
# Named for the Aldabra giant tortoise (Aldabrachelys gigantea) — endemic
|
|
# to the Aldabra atoll in the Seychelles, up to 250 kg, 150-year lifespan.
|
|
# Long-lived, defended, slow but unstoppable. Fitting metaphor for a
|
|
# wallet that holds your money.
|
|
#
|
|
# Workspace deps are pinned here so all crates use the same versions.
|
|
# Add a dep here, then reference it in each crate's Cargo.toml as
|
|
# foo = { workspace = true }
|
|
[workspace]
|
|
resolver = "2"
|
|
members = [
|
|
"crates/aldabra-core",
|
|
"crates/aldabra-chain",
|
|
"crates/aldabra-dao",
|
|
"crates/aldabra-mcp",
|
|
]
|
|
|
|
[workspace.package]
|
|
version = "0.0.1"
|
|
edition = "2021"
|
|
license-file = "LICENSE"
|
|
repository = "https://github.com/Sulkta-Coop/aldabra"
|
|
authors = ["Cobb <cobb@sulkta.com>", "Kayos <kayos@sulkta.com>"]
|
|
|
|
[workspace.dependencies]
|
|
# Async runtime — almost everything we do is I/O bound (chain queries, MCP stdio)
|
|
tokio = { version = "1", features = ["full"] }
|
|
|
|
# Cardano stack — pallas is the rust-native primitives library by txpipe.
|
|
# We pull individual crates rather than the meta-crate so we control feature flags.
|
|
pallas-primitives = "0.32"
|
|
pallas-codec = "0.32"
|
|
pallas-crypto = "0.32"
|
|
pallas-addresses = "0.32"
|
|
pallas-txbuilder = "0.32"
|
|
pallas-wallet = "0.32"
|
|
pallas-traverse = "0.32"
|
|
pallas-network = "0.32"
|
|
|
|
# Mnemonic + key derivation.
|
|
# bip39 — 24-word wordlist parsing + BIP-39 entropy extraction.
|
|
# ed25519-bip32 — Cardano's variant of BIP-32-Ed25519 HD derivation
|
|
# (XPrv + DerivationScheme::V2 hard/soft children).
|
|
# pallas-crypto only ships raw ed25519, not HD derivation.
|
|
# cryptoxide — PBKDF2-HMAC-SHA512 for Icarus master-key generation
|
|
# (CIP-3). Already pulled in transitively by
|
|
# ed25519-bip32; declared here so we can use pbkdf2 + Sha512
|
|
# directly in aldabra-core.
|
|
# `rand` feature pulls in OsRng-backed Mnemonic::generate_in for new-wallet flows.
|
|
bip39 = { version = "2", features = ["rand"] }
|
|
ed25519-bip32 = "0.4"
|
|
cryptoxide = "0.4"
|
|
|
|
# At-rest encryption for the mnemonic + derived keys on disk. Modern,
|
|
# audited, FOSS, and the secret never has to round-trip through a
|
|
# daemon password prompt.
|
|
age = "0.10"
|
|
|
|
# Memory hygiene — wipe key material from RAM when keys go out of scope.
|
|
zeroize = { version = "1", features = ["derive"] }
|
|
|
|
# Errors — anyhow at the boundaries (binary), thiserror for crate-internal types
|
|
anyhow = "1"
|
|
thiserror = "1"
|
|
|
|
# Serde for everything JSON
|
|
serde = { version = "1", features = ["derive"] }
|
|
serde_json = "1"
|
|
|
|
# HTTP client for Koios + future Ogmios HTTP endpoints
|
|
reqwest = { version = "0.12", default-features = false, features = ["json", "rustls-tls"] }
|
|
|
|
# MCP SDK for Rust. Note: the official Rust SDK has been moving fast
|
|
# (modelcontextprotocol/rust-sdk on github). Pin a version once we
|
|
# verify the API shape we actually use.
|
|
rmcp = { version = "0.1", features = ["server", "transport-io"] }
|
|
|
|
# Logging
|
|
tracing = "0.1"
|
|
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
|
|
|
|
# Config file parsing — TOML at $ALDABRA_DATA/config.toml.
|
|
toml = "0.9"
|
|
|
|
# Hidden-input passphrase prompts for the mnemonic bootstrap CLI.
|
|
# rpassword is the standard "tty echo off" prompt crate.
|
|
rpassword = "7"
|
|
|
|
# Vendored fork of txpipe/pallas with auxiliary_data + voting_procedures
|
|
# support added to pallas-txbuilder (upstream had TODO markers we filled
|
|
# in). Patches all pallas-* crates so the version graph resolves
|
|
# consistently against the same commit. PR upstream pending; switch back
|
|
# to crates.io once merged.
|
|
[patch.crates-io]
|
|
pallas-codec = { git = "https://github.com/Sulkta-Coop/pallas.git", branch = "feat-aux-data" }
|
|
pallas-crypto = { git = "https://github.com/Sulkta-Coop/pallas.git", branch = "feat-aux-data" }
|
|
pallas-primitives = { git = "https://github.com/Sulkta-Coop/pallas.git", branch = "feat-aux-data" }
|
|
pallas-traverse = { git = "https://github.com/Sulkta-Coop/pallas.git", branch = "feat-aux-data" }
|
|
pallas-addresses = { git = "https://github.com/Sulkta-Coop/pallas.git", branch = "feat-aux-data" }
|
|
pallas-wallet = { git = "https://github.com/Sulkta-Coop/pallas.git", branch = "feat-aux-data" }
|
|
pallas-txbuilder = { git = "https://github.com/Sulkta-Coop/pallas.git", branch = "feat-aux-data" }
|