| Crates.io | clubs-cli |
| lib.rs | clubs-cli |
| version | 0.1.0 |
| created_at | 2025-10-01 09:28:02.659863+00 |
| updated_at | 2025-10-01 09:28:02.659863+00 |
| description | Command-line interface for composing and inspecting Gordian Club editions. |
| homepage | |
| repository | https://github.com/BlockchainCommons/clubs-cli-rust |
| max_upload_size | |
| id | 1862309 |
| size | 176,734 |
clubs-cli (clubs)clubs-cli is a command-line interface for working with Blockchain Commons' Gordian Clubs. It orchestrates the underlying clubs crate to compose editions, attach permits, verify signatures, check provenance continuity, and demonstrate decryption paths.ubs-cli (clubs`)
clubs-cli is a command-line interface for working with Blockchain Commons’ Gordian Clubs. It orchestrates the underlying clubs crate to compose editions, attach permits, verify signatures, check provenance continuity, and demonstrate decryption paths.
Status: the tool is not published on crates.io. Build it from the git workspace. The crate expects the
clubslibrary source to be available via a sibling path because Cargo manifests currently reference../clubsdirectly.
The CLI currently focuses on single-publisher workflows and provides the following subcommands:
clubs init – convenience wrapper for producing the first edition of a club.clubs edition compose – general-purpose edition composer for subsequent releases.clubs edition verify – signature and provenance checks for a single edition.clubs edition permits – extract sealed member permits from an edition.clubs edition sequence – prove that a set of editions belong to the same club and form a contiguous provenance chain.clubs content decrypt – recover plaintext content using a permit, SSKR shards, or symmetric key.Run clubs --help or clubs <command> --help for full flag listings.
Install via cargo:
cargo install clubs-cli
The installed binary is named clubs.
Run clubs --help to see available commands. Start by examining the demo-log.md file in the source repository, which is produced by the demo script and illustrates a complete end-to-end scenario.
The clubs-cli/clubs-demo.py script drives the installed CLI together with the other Gordian tools (notably envelope and provenance). It produces a Markdown transcript (demo-log.md) that documents a reproducible end-to-end scenario:
clubs edition sequence.Running the script requires the provenance and envelope tools to be on PATH:
cd clubs-cli
./clubs-demo.py > demo-log.md