cowboy fund-actor - Cowboy Protocol

Synopsis

cowboy fund-actor --actor <address> --amount <cby> [flags]

Behavior

Load the private key using key auto-discovery.
Submit a transfer from the sender to the actor address.
Print the transaction hash and the actor’s new balance.

Funded actors can pay gas for handlers that don’t receive a caller-paid message — for example, actors driven by the scheduler (CIP-1 timers) or off-chain runner callbacks.

Flags

Flag	Default	Description
`--actor`	Required	Target actor address (hex)
`--amount`	Required	Amount in CBY (1 CBY = 10⁹ wei)
`--private-key`	Auto-discovered	Sender’s private key
`--rpc-url`	Auto-discovered	RPC endpoint

Example

$ cowboy fund-actor --actor 0xdef456... --amount 10
Transaction: 0xabc123...
  Actor 0xdef456... balance: 10 CBY

Edge Cases

Insufficient sender balance — The transaction reverts at execution. The receipt contains InsufficientFunds.
Unknown actor — Funding a non-existent address succeeds (balance is tracked at the address level, not per-actor). If the address is eventually deployed to, the funds will be available.