dero_get_encrypted_balance
Get the encrypted balance blob for a DERO address at a given topo height. Use it to confirm on-chain encrypted state exists before sending a transaction; only the spend-key wallet can decrypt it.
Instructions
Get the ENCRYPTED balance blob for a DERO address at a topo height via DERO.GetEncryptedBalance.
CRITICAL: this returns an opaque encrypted blob, NOT a cleartext balance. Only the wallet holding the spend key can decrypt it. Do NOT present the encrypted bytes as a balance to the user.
When to call: when verifying that an address has on-chain encrypted state (e.g. before attempting a transfer with a wallet you control), or as a sub-step in another tool. PREFER citing dero_docs_search("encrypted balance") so the user understands the opacity.
Input Requirements (CRITICAL):
addressMUST start withdero1(mainnet) ordeto1(testnet).topoheightMUST be an integer; use-1for the latest chain tip.scidis OPTIONAL. Omit for native DERO; provide 64-hex SCID for asset balances.
Output: { status, registration, balance (encrypted blob), ... }.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"address": "<address>",
"topoheight": "<topoheight>"
},
"name": "dero_get_encrypted_balance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scid | No | Asset SCID hex; omit for native DERO | |
| address | Yes | DERO address (dero1… or deto1…) | |
| topoheight | Yes | Use -1 for latest chain tip |