Docs / CLI

One CLI for the protocol.

Use ACKRATE CLI for configuration, reference agents, and settlement recovery. Quick starters are SDK scripts and do not need a separate CLI.

Install and inspect

npm install -g @ackrate/cli@0.2.1
ackrate --help
ackrate demo

With no target, ackrate demo lists the available reference flow without submitting a payment.

Configure Mainnet

ackrate init --network mainnet --user-signer USER_IDENTITY --agent-signer AGENT_IDENTITY --merchant G_ADDRESS --budget 3 --price 1
ackrate setup

Replace the identity and address placeholders. setup performs read-only readiness checks on Mainnet. The user and agent need funded Stellar identities; the user also needs Circle USDC.

Authorize and pay

ackrate mandate create --budget 3 --expiry 3600 --confirm-real-usdc
ackrate pay 1 --confirm-real-usdc

These commands authorize and spend real USDC. Review the recipient and amounts before running them. The confirmation flag records explicit consent.

Recover an interrupted payment

ackrate settlement reconcile

Reconcile before another payment. Acknowledge a recorded successful settlement only with its exact transaction hash. Never delete pending state to force a retry.

Advanced options

--manifest validates an override against the official deployment. --agent-secret-env names a secret-manager variable for bound request proofs. --resume-setup-registration resumes an exact unused registration.

ops create / verify / combine coordinates native 2-of-3 signing. These commands preserve independently verifiable transaction requests.

setup --force regenerates Testnet burner keys. It is not a Mainnet key-management command.

Full CLI reference → · Browser reference-agent runner →

The funded browser CLI runner requires the persistent runtime. It is unavailable on Vercel; local CLI commands remain the supported developer path.