MAINNET CLI

Run the Mainnet CLI.

@ackrate/cli runs the consumer and fulfillment agents against the official Stellar Mainnet contract and Circle USDC. Connect Freighter, approve test funding, then start your own Mainnet run. Follow each step and inspect your own results and receipts.

package

@ackrate/cli

command

ackrate

network

Mainnet · USDC

enforcement

MandateRegistry

npm package

The paid test and command inspection use CLI 0.2.1; both executables match the published npm release byte for byte. Funding transfers real assets to three dedicated server-managed accounts. The test then makes three 0.01 USDC purchases and checks the contract's budget limit.

Use a browser with the Freighter extension installed and unlocked. Start with Connect and verify Freighter in the test panel.

The allowance is approved for the contract, never the agent.

Every spend routes through MandateRegistry.execute_payment.

The demo intentionally spends until the contract blocks the next purchase.

Test the CLI with Freighter

Fund three dedicated test accounts, then run the research agent on Stellar Mainnet. The CLI buys three sources for 0.01 USDC each and checks that the next purchase is rejected by the budget limit.

Mainnet · real funds

Test runner: CLI 0.2.1. Byte-verified against published npm version 0.2.1.

1. Connect FreighterSign a fee-free ownership check. Nothing is broadcast.
2. Approve fundingReview and sign a transfer of 6 XLM + 0.03 USDC, plus the funding fee.
3. Run the CLI testAuthorize the three purchases and follow the results and budget check.

You approve ownership and funding in Freighter. After you press Run, the CLI signs the mandate and allowance using the funded test payer, then the consumer agent makes the payments. Your funding-account key stays in Freighter.

Loading test status…

Connect your Mainnet account and sign an ownership check in Freighter. That check is never broadcast and has no network fee. Funding is a separate approval after you review the amounts and addresses.

CLI command inspection · published 0.2.1 · version and help

These commands inspect the published executable. They do not fund accounts or start the Freighter test.

@ackrate/cli 0.2.1 · loading

Payment success requires confirmed receipts and delivered results.Contract CCLZEB...4HWR

Published install commands

npx @ackrate/cli@0.2.1 demo research-agent --network mainnet

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

Commands

ackrate init

Configures the official Mainnet contract with your signing identities, merchant, price and budget.

ackrate setup

Checks the configured Mainnet accounts, USDC and fee balances. It does not create or fund accounts.

ackrate mandate create

Registers a scoped mandate and approves the allowance to the contract.

ackrate pay

Makes an agent-signed payment through MandateRegistry.execute_payment.

ackrate settlement reconcile

Checks the exact prepared transaction hash before another payment is allowed.

ackrate settlement acknowledge <tx-hash>

Explicitly accepts one exact durable success before another payment is allowed.

ackrate demo research-agent

Runs the consumer and fulfillment agents: three paid sources, then a contract budget rejection. Requires funded accounts and explicit signing approval.