Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cowboy.inc/llms.txt

Use this file to discover all available pages before exploring further.

​
Synopsis

cowboy entitlement grant --grantee <address> --scope-actor <address> --action <name>
                         [--max-total-amount <cby>]
                         [--max-amount-per-use <cby>]
                         [flags]

​
Subcommands

​
cowboy entitlement grant

Grant an entitlement — a bounded, revocable permission for one address to use resources controlled by another. Behavior:
  1. Load the private key using key auto-discovery.
  2. Build an EntitlementGrant transaction with the supplied scope and limits.
  3. Submit it and print the transaction hash.
The granter is the transaction sender. After the grant is finalised, the grantee can perform --action against the --scope-actor within the declared limits until the entitlement is explicitly revoked or exhausted. Flags:
FlagDefaultDescription
--granteeRequiredAddress that receives the permission
--scope-actorRequiredActor whose resources are entitled
--actionRequiredAction name. Currently supported: use-owner-balance
--max-total-amountUnboundedTotal budget for this entitlement, in CBY
--max-amount-per-useUnboundedPer-use cap, in CBY
--private-keyAuto-discoveredGranter’s private key
--rpc-urlAuto-discoveredRPC endpoint
Example: 
$ cowboy entitlement grant \
    --grantee 0x7a3B...F92E \
    --scope-actor 0xdef456... \
    --action use-owner-balance \
    --max-total-amount 100 \
    --max-amount-per-use 10
Transaction: 0xabc123...
  Entitlement granted: 0x7a3B...F92E may spend up to 100 CBY (10 CBY/use)
  from 0xdef456... via 'use-owner-balance'.

​
Edge Cases

  • Only the use-owner-balance action is currently defined. Other action names are rejected at submission time.
  • Grants are revocable with a future cowboy entitlement revoke (tracked separately).
  • Limits are tracked on-chain as part of actor state; once exhausted, subsequent uses revert.