transact

Execute a CVM transaction on the Convex network. Use when the user wants to modify on-chain state, call actor functions, or define values.

npx skills add https://github.com/convex-dev/convex --skill transact

Execute a Convex Transaction

Transactions modify global state atomically. They cost juice (gas) and require a funded, signed account.

Source: $ARGUMENTS

Workflow

  1. If the user has a signing key stored in the signing service, use mcp__convex-testnet__signingTransact with their address and passphrase.
  2. If the user has a raw seed, use mcp__convex-testnet__transact with address and seed.
  3. If neither is available, use mcp__convex-testnet__prepare to prepare the transaction, then guide the user through signing.

CVM Conventions

  • Amounts are in copper: 1 CVM = 1,000,000,000 copper
  • Never use import — it mutates the account environment and costs extra juice
  • For single calls: (@convex.fungible/transfer #128 #13 100)
  • For multiple calls to the same actor: (let [f @convex.fungible] (f/transfer ...) (f/balance ...))

Common Transaction Patterns

TaskSource
Transfer coins(transfer #DEST AMOUNT)
Define a value(def my-var 42)
Call an actor(call #ACTOR (function-name arg1 arg2))
Set controller(set-controller #ADDR)

Always confirm the transaction source and destination with the user before executing.