Nano Node RPC icon

Nano Node RPC

Interact with Nano cryptocurrency network

Actions111

Wallet → Get Wallet Receivable

AI-generated

Summary

Retrieve a list of receivable blocks for a specified Nano wallet that meet optional criteria such as minimum balance and confirmation status.

Inputs

  • Wallet ID (Manual) — Manually specify the Nano wallet ID to query; if omitted, uses the wallet set in credentials.
  • Balance Threshold — Specify a minimum balance threshold in raw units to filter receivable blocks (optional).
  • Count — Set the maximum number of receivable blocks to return. Defaults to 10.
  • Include Source — Determine whether to include the source account information for receivable blocks. Defaults to true.
  • Include Active — Choose to include active blocks without finished confirmations (requires Nano node v15.0+). Defaults to false.
  • Include Only Confirmed — Restrict results to only confirmed receivable blocks (requires Nano node v19.0+, defaults to true from v22.0+). Defaults to true.
  • Options (Timeout and Max Retries) — Configure the request timeout in milliseconds (default 15000) and the number of retry attempts for transient RPC failures (default 2).

Output shape

A list of receivable blocks matching the specified wallet and filters, each including block details and optionally source account information.

The operation requires that the Nano node configuration has 'enable_control = true' to allow the RPC call; otherwise, the request will be rejected. Returned blocks can be filtered by balance threshold, confirmation status, and inclusion of active blocks. The number of blocks returned is limited by the 'Count' parameter.

Links

Discussion