Wallet status
Agent Pay status: Approve does not execute. Execution: not enabled. ACH settlement: not enabled. prepare_payment never moves money. Machine-readable: /docs/agents/status.json.
An agent can read the status of its Crossmint staging wallet. This is status only: POINTS makes no custody, balance, or money-movement claims for this wallet. Read the Crossmint wallet disclosure before connecting one.
get_wallet_status
- Scope:
module-status:read. No arguments. - Reads the stored status for the AI Agent on the connected account (the earliest one, if there are several). It does not fetch anything live.
- Never returns balances, raw wallet addresses, or wallet identifiers.
{
"connectionStatus": "connected",
"provider": "crossmint",
"environment": "staging",
"blockchain": "solana",
"walletType": "smart_wallet",
"verificationStatus": "verified",
"unavailableReason": null
}
environment is always staging.
Wallet states
connectionStatus | Meaning |
|---|---|
not_connected | No wallet is connected for this AI Agent |
pending | Setup started and is not verified yet |
connected | A staging wallet is connected and verified |
unavailable | Status can't be read right now; unavailableReason says why |
error | The last status check failed; unavailableReason says why |
verificationStatus is one of not_verified, pending, verified, or failed.
action_required
get_account_status reports each account module, including wallet. A wallet module in action_required means the account owner needs to act in POINTS, for example to re-authorize the wallet. The agent can't fix it, so tell the user to open POINTS.
All values are generated from code in Statuses.