Wallet gRPC API

Overview

The Wallet service holds custody logic: HD wallets, addresses, balances, and sweep. Clients (Gateway, Watchers) call it via gRPC for balance queries and address management.

Internal address: wallet:7080 (HTTP) / gRPC port as configured in swarm.

Responsibilities

Create/list wallets and addresses per user and chain.
Return balances (crypto and fiat/IRT from ledger).
Support withdrawal and sweep flows (balance checks, address resolution).

Key Flows

Balance resolution

flowchart LR
  A[Gateway] -->|GetBalance| B[Wallet]
  B --> C[Ledger / DB]
  B --> D[RPC for chain balance]
  C --> B
  D --> B
  B --> A

Wallet creation (per user/chain)

Gateway or Account requests a wallet for telegram_id + chain.
Wallet creates or returns existing HD-derived address and stores it.

API Surface (conceptual)

GetBalance — balance for user/asset (crypto + IRT from ledger).
ListAssets — supported assets and balances.
GetOrCreateWallet — ensure default wallet for network.
GetAddress — deposit address for user/chain/token.

Exact proto and method names are defined in the wallet service codebase. For REST exposure, see Gateway REST.