OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add convex-dev/convex --skill 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 convex-dev/convex --skill transact
Transactions modify global state atomically. They consume juice, paid in copper by the origin account, and must be signed.
Source: $ARGUMENTS
See the convex-lisp skill for CVM conventions and error codes.
A transaction requires a key. You have one only if the user has supplied it — a signing-service passphrase, or a raw seed. There is no ambient authority here, so:
signingTransact
tool with their address and passphrase.transact tool with address and seed.prepare to build the unsigned
transaction, or the CLI below, and hand it back for the user to sign.Do not treat case 3 as a blocker to work around. Preparing the transaction and returning it is the correct outcome.
Works from a built convex.jar and needs no MCP server:
-k / --key selects the key from the keystore and -p / --keypass is its
passphrase; --keystore and --storepass select the keystore itself. Add
--host / --port for a non-default network.
| Task | Source |
|---|---|
| Transfer coins | (transfer #DEST AMOUNT) |
| Define a value | (def my-var 42) |
| Call an actor | (call #ACTOR (function-name arg1 arg2)) |
| Call a library | (@convex.fungible/transfer #TOKEN #DEST AMOUNT) |
| Set controller | (set-controller #ADDR) |
Confirm source, destination and amount with the user before executing anything that moves value or changes account control. State what will happen in CVM units, not copper.