casualsecurityinc/check-balance

Check XNO Balance (RPC)

When a user asks "did you receive it?" / "check the balance", you need an on-chain data source. This skill queries a Nano node RPC (user-provided) for balance and pending (both in raw).

Important nuance: pending vs received

Nano can show funds as pending until the receiving wallet publishes the receive/open block. Many wallet apps do this automatically; raw keys alone do not.

If you see pending funds, you must call wallet_receive to pocket them.

Well-known Public RPC Nodes

If the user doesn't have an RPC URL, suggest these public nodes:

• https://rpc.nano.org (Nano Foundation)
• https://app.natrium.io/api/rpc (Natrium)
• https://nanonode.cc/api (NanoNode.cc)
• https://node.somenano.site/api (SomeNano)

CLI usage (xno-skills)

Set an RPC URL (recommended):

export NANO_RPC_URL="https://rpc.nano.org"

Then:

npx -y xno-skills rpc account-balance <address> --json --xno

Or pass the URL explicitly:

npx -y xno-skills rpc account-balance <address> --url "https://rpc.nano.org" --json --xno

MCP usage (xno-mcp)

If the agent has access to the xno-mcp tools:

First, set defaults (recommended):

config_set: { "rpcUrl": "https://rpc.nano.org" }

Then check balance:

• rpc_account_balance with { "address": "...", "rpcUrl": "..." }
• wallet_balance with { "name": "my-wallet", "index": 0 }

If you see pending funds, receive them:

• wallet_receive with { "name": "my-wallet", "index": 0 }

Fallback (no RPC available)

If the user can't provide an RPC URL (or the environment has no network access), ask them to check the address in a block explorer or in their wallet app and report back:

• confirmed on-chain balance
• pending/receivable amount (if shown)