Skip to main content
A runner is a machine that does off-chain work for actors. cowboy runner reads the runners on a network and lets an operator register and update one.

cowboy runner get

Get runner information by address

cowboy runner list

List all active runners

cowboy runner register

Register a new runner

cowboy runner update-capabilities

Complete replacement of this runner’s on-chain capabilities; fields are not merged. Waits for committed execution. Takes effect at the next block’s selection; in-flight assignments are unaffected
Example:
The capabilities document must explicitly include every RunnerCapabilities field, including false, empty arrays and null to clear settings. Identity keys come only from the local grant identity file.

cowboy runner update-rate-card

Update this runner’s LLM token prices, preserving other rates. Waits for committed execution; the rate-card cooldown applies

cowboy runner update-endpoint

Update this runner’s advertised CIP-15 route-serving endpoint in place and wait for committed execution. No deregister/re-register. Omit --route-serving-endpoint to CLEAR it

cowboy runner deregister

Deregister this runner and refund its stake (CIP-9 §5.1.1). Rejected while the runner has assigned jobs, active delegated stake, or is inside the post-settlement dispute window

cowboy runner submit-tee-attestation

Submit a job-scoped TEE attestation record