cowboy proxy

​

Synopsis

cowboy proxy [--rpc-url <url>] [--private-key <path>] <subcommand>

cowboy proxy register --pubkey <hex> --hpke-pubkey <hex> --dkg-pubkey <hex> --tls-spki <hex> --network-addr <addr> --stake <n> [--statusz-url <url>]
cowboy proxy deregister --proxy-id <hex>
cowboy proxy slash --proxy-id <hex> --fault-class <class> (--evidence-hex <hex> | --evidence-file <path>) [--yes]
cowboy proxy list [--json]

​

Subcommands

​

cowboy proxy register

1. Parse the key material; --hpke-pubkey and --dkg-pubkey must be exactly 32 bytes.
2. Build RegisterCbssProxy with the stake widened to the chain’s 256-bit amount type.
3. Size the limits from the node’s estimate, sign and submit; print the transaction hash and the node response.

$ cowboy proxy register --pubkey 0x02ab... --hpke-pubkey 0x11.. --dkg-pubkey 0x22.. \
    --tls-spki 0x3082... --network-addr proxy-01.example.com:8443 --stake 1000000000000
Transaction hash: 0xabc123...
CBSS proxy command submitted: <node response>

​

cowboy proxy deregister

​

cowboy proxy slash

1. Unless --yes is passed, print a warning that evidence is consumed on success and cannot be reused, and that an invalid claim still spends gas; require the operator to type yes. If stdin is not a terminal or non-interactive mode is on and --yes is absent, the command refuses with input_required (exit 3).
2. Read the evidence from exactly one of --evidence-hex or --evidence-file.
3. Sign and submit SlashCbssProxy.

​

cowboy proxy list

1. Fetch /cbss/proxies from the RPC URL (10-second timeout).
2. With --json, print one versioned JSON result (proxy.list) wrapping the payload.
3. Otherwise print one block per proxy: proxy_id, operator, network_addr, dkg_pubkey, registration and eligibility heights, health in basis points (with SUSPENDED when applicable), and unbond_at if set. With no proxies, print a notice explaining the list populates once a RegisterCbssProxy transaction lands.

$ cowboy proxy list
CBSS proxies on chain (1):

  [1] proxy_id      = 0x0000...0001
       operator      = 0x7a3B...F92E
       network_addr  = proxy-01.example.com:8443
       dkg_pubkey    = 0x22..
       registered    = block 120, eligible after block 220
       health        = 10000 bps (10000 = full health)

​

Edge Cases

• --stake is parsed as u64, so stakes above 2^64 - 1 base units cannot be submitted through this CLI even though the chain accepts larger values.
• slash requires exactly one evidence source; neither or both is an error.
• slash refuses to run without --yes when stdin is not a terminal or non-interactive mode is on.
• list errors are typed: a 404 is not_found, an unreachable node is retryable, and a non-JSON or oversized body is invalid_response.
• Write commands sign with limits from the node’s estimate; if the estimate fails, nothing is submitted.