query
bởi convex-dev
Execute a read-only CVM query on the Convex network. Use when reading on-chain state, checking balances, looking up accounts, or evaluating Convex Lisp…
npx skills add https://github.com/convex-dev/convex --skill queryQuery Convex State
Execute a read-only query on the Convex network. Queries are free, instant, and never modify state.
Expression: $0
Address (optional): $1 — the account context for the query (e.g. #13)
Use the mcp__convex-testnet__query tool.
CVM Conventions
- Amounts are in copper: 1 CVM = 1,000,000,000 copper (10^9). Always convert to CVM for display.
- Account addresses use
#prefix:#13,#42 - CNS paths use
@prefix for actor lookup:@convex.fungible - Never use
import— use CNS-resolved paths like(@convex.fungible/balance #128 #13)
Common Queries
| Task | Expression |
|---|---|
| Coin balance | (balance #13) |
| Own balance | *balance* |
| Account info | (account #13) |
| Token balance | (@convex.fungible/balance #TOKEN #USER) |
| Lookup symbol | (lookup #ADDR 'symbol) |
| Full state | *state* (large!) |
Present balances in human-readable CVM units (e.g. "1.5 CVM" not "1500000000 copper").
Thêm skills từ convex-dev
account
convex-dev
Create or inspect Convex accounts. Use when the user wants to set up a new account, check account details, or manage keys.
official
build-convex
convex-dev
Build the Convex project from source. Use when a contributor wants to compile, test, or package Convex.
official
cns
convex-dev
Resolve or register Convex Name System (CNS) names. Use when the user wants to look up a CNS name, register a new name, or update a name's target.
official
convex-db
convex-dev
Use Convex DB — a lattice-backed SQL database. Use when helping users write queries, connect via JDBC or PostgreSQL clients, create tables, insert/query data,…
official
deploy
convex-dev
Deploy an actor (smart contract) to the Convex network. Use when the user wants to create a new on-chain actor with exported functions.
official
token
convex-dev
Create and manage fungible tokens on Convex. Use when the user wants to create a new token, check token balances, or manage token supply.
official
transact
convex-dev
Execute a CVM transaction on the Convex network. Use when the user wants to modify on-chain state, call actor functions, or define values.
official
transfer
convex-dev
Transfer CVM coins or fungible tokens between Convex accounts. Use when the user wants to send coins or tokens to another account.
official