account

Convex 계정을 생성하거나 조회합니다. 사용자가 새 계정을 설정하거나, 계정 세부 정보를 확인하거나, 키를 관리하려 할 때 사용하세요.

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

Convex Account Management

Accounts are self-sovereign: an address like #1337 controlled by a key pair. See the convex-lisp skill for CVM conventions.

Via the CLI

Always available from a built convex.jar:

java -jar convex.jar account create        # create an account
java -jar convex.jar account info #13      # full account record
java -jar convex.jar account balance #13   # coin balance
java -jar convex.jar account fund #13      # fund from the faucet, where available

java -jar convex.jar key generate          # new key pair in the keystore
java -jar convex.jar key list              # keys in the keystore
java -jar convex.jar key import|export|delete|sign

--keystore and --storepass select the keystore; -k/--key and -p/--keypass select a key within it. Add --host/--port to target a specific network.

Via a Convex MCP Server

If one is configured (tool names look like mcp__<server>__…) — it is set up per user, not by this repository, so check before relying on it:

Create in one step: signingCreateAccount — key pair plus on-chain account, optionally funded from the faucet
From a raw key: keyGen, then createAccount with the public key
Inspect: describeAccount (full record), getBalance (balance only)
Keys: signingListKeys, signingListAccounts, signingCreateKey

Via Query

(account #ADDR) returns the full account record; (balance #ADDR) the coin balance. Both are free — see the query skill.

Handling Keys

Save the seed when an account is created — it cannot be recovered. Tell the user explicitly at the moment of creation, not afterwards.

Never write a seed or passphrase into a file in the repository, a commit message, or any output that will be shared onward. If the user pastes one, use it for the operation at hand and do not repeat it back.