cowboy actor works with actors that are already deployed. Where a command takes a target or an address, give it a 20-byte address, or an actor’s name from this project, which resolves to its latest deployment on the selected network. Inside a project with one actor you can leave it out.
cowboy actor interface
Discover the embedded native interface of a deployed code version (no gas)cowboy actor update-offchain
Update a project’s off-chain image; preserve actor code, address and state. Refreshes the registered runtime base unless--keep-base is selected
Examples:
Update the project’s only actor
cowboy actor call
Call a handler on a deployed actor (writes on chain, sender pays gas)
Also takes the gas options.
Examples:
Call a handler that ignores its payload
cowboy actor inspect
Show an actor’s on-chain record (reads the node, no gas)cowboy actor state
Show an actor’s decoded storage preview (reports truncation; no gas)cowboy actor pins
Show the CIP-26 libraries an actor is pinned to, with each pinned code blob fetched and checked against its hash (reads the node, no gas)cowboy actor code
Show an actor’s deployed Python source (reads the node, no gas)cowboy actor logs
Show an actor’s event log (reads the node, no gas)cowboy actor messages
Show an actor’s pending mailbox messages (reads the node, no gas)cowboy actor timers
Show an actor’s scheduled timers (reads the node, no gas)cowboy actor jobs
Show the jobs an actor submitted (reads the node, no gas)cowboy actor upgrade
Replace a deployed actor’s code (system deployers only; writes on chain, costs gas) SubmitsUpgradeActor, which the chain accepts only from an address in genesis system_deployers (CIP-15 §6.9); any other sender, including the actor’s owner, is refused with E1303. An actor declaring sys.upgrade can instead replace its own code with runtime.upgrade_self.
Also takes the gas options.
cowboy actor fund
Fund an actor’s balance for its own work (top-level callers pay their gas) Waits for the transaction to commit before returning successcowboy actor publish-site
Publish the actor’s website (its installed route table) to everyone, or return it to owner-only. Signed by the actor’s protocol owner; a later route change returns the site to owner-only until republishedcowboy actor owner-funding
Show or set whether an actor’s deferred work may fall back to your balance when its own runs short. Deploys turn this on, uncapped
Examples:
Show it
cowboy actor auto-topup
Show or set how the rent sweep refills an actor from your wallet: once per rent epoch, up to a target balance, within a lifetime capcowboy actor auto-topup show
Show the actor’s auto top-up: owner, target and any remaining cap
Examples:
Show it
cowboy actor auto-topup set
Set the actor’s auto top-up. You must be its owner. A new setting replaces the old one; caps do not add up
Examples:
The chain default (0.1 CBY target, no cap)
cowboy actor transfer-owner
Transfer an actor’s ownership to another account, signed by its current owner and co-signed by the new owner. Resets the actor’s website access to owner-only; only the new owner can transfer it again. Waits for the transfer to commit
Examples:
Transfer, confirming at the prompt
cowboy actor address
Derive an actor address offline (reads local project files, no gas). Off-chain targets require a currentcowboy build
cowboy actor manifest-encode
Encode an ActorManifest JSON file to its commonware-codec bytes and print the 0x hex. Validates against the selected RPC chain before encoding. Lets an external signer (e.g. a web wallet) include entitlements in a DeployActor it builds + signs itself, without reimplementing the manifest codec. Reads--manifest-json <path> or stdin.