Skip to content
BLOBPEDIAby Unity Nodes
Documentation/rpc/JSON-RPC methodView on rpc
rpc/JSON-RPC method

state.BalanceForAddress

**BalanceForAddress retrieves the Celestia coin balance for the given address and verifies the returned balance against the corresponding block's AppHash.

NOTE: the balance returned is the balance reported by the block right before the node's current head (head-1). This is due to the fact that for block N, the block's AppHash is the result of applying the previous block's transaction list. **

Auth level: read

Params:

[{"name":"addr","description":"state.Address","summary":"","schema":{"examples":["celestia1377k5an3f94v6wyaceu0cf4nq6gk2jtpc46g7h"],"additionalProperties":false,"type":["object"]},"required":true,"deprecated":false}]

Result:

{"name":"*state.Balance","description":"*state.Balance","summary":"","schema":{"examples":[{"denom":"string value","amount":"42"}],"additionalProperties":false,"properties":{"amount":{"additionalProperties":false,"type":"object"},"denom":{"type":"string"}},"type":["object"]},"required":true,"deprecated":false}