query

作成者： 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 query

ZIPダウンロード GitHub

Query 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").

convex-devのその他のスキル

Convexアカウントを作成または確認します。ユーザーが新しいアカウントを設定したい場合、アカウントの詳細を確認したい場合、またはキーを管理したい場合に使用します。

Convexプロジェクトをソースからビルドします。コントリビューターがConvexをコンパイル、テスト、またはパッケージ化したい場合に使用します。

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.

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,…

アクター（スマートコントラクト）をConvexネットワークにデプロイします。ユーザーがエクスポートされた関数を持つ新しいオンチェーンアクターを作成したい場合に使用します。

Create and manage fungible tokens on Convex. Use when the user wants to create a new token, check token balances, or manage token supply.

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

Convexアカウント間でCVMコインまたは代替可能トークンを転送します。ユーザーが別のアカウントにコインやトークンを送信したい場合に使用します。