sigil_getBalance
Fetch account balance and nonce for a DID.
Method
sigil_getBalance is registered in the canonical JSON-RPC catalog. Use POST /rpc, Content-Type: application/json, JSON-RPC 2.0 and a caller-controlled request id. Node RPC profile, build feature and runtime activation checks still apply.
Fetch account balance and nonce for a DID.
Request binding
Source handler: rpc_server::handle_get_balance in sigil/node/sigil-node/src/rpc_server.rs, line 1880.
The handler directly reads these named fields: did. Additional typed parsing, aliases and nested validation are defined by its request types. Field presence alone does not establish optionality.
Parsing excerpt
These source excerpts show binding and validation; they are not runnable client code.
let did = match req.params.get("did").and_then(|v| v.as_str()) {
Some(d) => d,
None => return RpcResponse::error(req.id.clone(), -32602, "missing 'did' parameter"),
};Read example
did: account DID string. Returns balance and nonce; preserve integer precision.
{
"jsonrpc": "2.0",
"id": 1,
"method": "sigil_getBalance",
"params": {
"did": "YOUR_ACCOUNT_DID"
}
}Named YOUR_* values must be replaced with identifiers from the selected chain.
Responses and failures
Check HTTP status, parse the JSON-RPC envelope, reject error, and require result on success. Preserve large base-unit integers without floating-point rounding. A catalog method does not bypass authentication, capability, policy or activation requirements.