Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 16 additions & 3 deletions docs/run-a-node/manage.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,16 +60,29 @@ After publishing a store with `digs commit`, seed your own node so it immediatel
{
"jsonrpc": "2.0",
"id": 1,
"result": { "balance": 12345, "pending": 6, "synced": true, "peak_height": 42 }
"result": {
"balance": 12345, "pending": 6,
"source": "db", "synced": true, "peak_height": 42
}
}
```

| Field | Type | Meaning |
|---|---|---|
| `balance` | number (u64) | Confirmed balance in mojos, as a JSON **number** (never a string). |
| `pending` | number (u64) | Unconfirmed/incoming balance in mojos, as a JSON **number**. |
| `synced` | boolean | Whether the read was answered from a fully synced source. |
| `peak_height` | number \| null | The chain height the balance reflects, or `null` when unknown. |
| `source` | string \| null | Which source answered: `"db"` (your node's own chain copy) or `"fallback"` (a public chain service). `null` from a node too old to say. |
| `synced` | boolean | Whether **this answer** came from a fully synced local copy. A `"fallback"` answer is always `false`. |
| `peak_height` | number \| null | The chain height **this answer** reflects, or `null` — including for every `"fallback"` answer. |

### Where the answer came from

`source` tells you which of two places produced the figure:

- **`"db"`** — your own node's copy of the chain. Nothing left your machine.
- **`"fallback"`** — a public chain service your node asked on your behalf, because it could not answer from its own copy. This works, but **the address you asked about was sent to that service**. If you are on a metered or private connection, this is the field to watch.

`synced` and `peak_height` always describe the source that actually answered, not your node in general. So a `"fallback"` answer reports `synced: false` and `peak_height: null` even when your node's own copy is fully caught up — because that copy is not what produced the number you are reading.

A synced address holding nothing is a **success** with `balance: 0` — a zero balance is a truthful answer, never an error. When the node cannot answer truthfully it returns a distinct error (below) rather than a fabricated `0`.

Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "docs-dig-net",
"version": "0.13.0",
"version": "0.14.0",
"private": true,
"scripts": {
"docusaurus": "docusaurus",
Expand Down
Loading