Command-line clients

This checkout contains two command-line clients:

dclutchdclutch-terminal
LanguageRustTypeScript
Sourcetools/dclutch-clipackages/dclutch-cli
Main usesInspect accounts, sign offers and build unsigned operation plansMarket workflows using the SDK and native operator tools
RPC environment variableDCLUTCH_RPC_URLDCLUTCH_RPC
Signing key option--keypair-env VAR--keypair <path> or DCLUTCH_KEYPAIR

Run the selected executable with --help to see its commands. Some commands inspect or prepare an operation; others submit it. Each command’s help names its required inputs.

Build and use dclutch

The Rust client reads market and capability accounts, signs portable Direct tickets and builds unsigned General and Fractional retirement plans.

dclutch market show <ADDRESS>        # a Market Core account, every field
dclutch market decode --file <PATH>  # the same rendering, no network
dclutch capability show <ADDRESS>    # can this market actually execute a trade
dclutch ticket author --keypair-env VAR ...
dclutch ticket verify <PATH>
dclutch ticket post --board URL <PATH>
dclutch general plan --route ABSOLUTE.json --output ABSENT-ABSOLUTE.json
dclutch fractional-retirement-next --route ABSOLUTE.json --output ABSENT-ABSOLUTE.json

See the client README for packaged installation. To build from this checkout, run these commands at the repository root:

cargo build --release -p dclutch-cli
./target/release/dclutch --help

dclutch-terminal — the flow driver, built from this checkout

The terminal client uses the SDK and the native operator binary for market workflows.

npm install --prefix packages/dclutch-cli
npm run build --prefix packages/dclutch-cli
node packages/dclutch-cli/bin/dclutch-terminal.mjs --help

The launcher is bin/dclutch-terminal.mjs; npm link puts it on your PATH under that name. Its commands:

dclutch-terminal markets ls
dclutch-terminal markets show <address>
dclutch-terminal portfolio
dclutch-terminal spine --market <address>
dclutch-terminal offer sell
dclutch-terminal intent buy
dclutch-terminal route direct
dclutch-terminal product inspect
dclutch-terminal refusal <code>

found, join and redeem provide market workflows. walk --dry-run previews a failure-walk transaction. offer and intent write signed portable tickets for another participant to use.

The terminal’s buy and sell submission commands are currently unavailable. Use a compatible market’s browser page to take a Direct offer. The terminal README lists operation inputs and examples.