grpc

name	grpc
description	Call gRPC methods on the Train Solver NetworkService (blockchain.proto). Use when the user wants to query or debug a network gRPC service — balances, health, fees, transactions, etc.

Network gRPC Client

Call any RPC method on the Train Solver NetworkService defined in protos/blockchain.proto.

Prerequisites

cd tools/swap-cli && npm install

Usage

cd tools/swap-cli && node grpc-call.mjs <endpoint> <method> [json-body]

• endpoint: gRPC host:port (e.g., localhost:60979)
• method: RPC method name, or list to show all methods
• json-body: JSON request body (default: {})

Arguments

$ARGUMENTS should contain:

• The gRPC endpoint URL/port
• The method to call
• Any request parameters

Parse naturally — the user might say "check health on localhost:60979" or "get balance for 0xABC on bsc-testnet via localhost:60979".

Common Methods

Health & Status:

node grpc-call.mjs localhost:60979 GetHealth '{}'

Balances:

node grpc-call.mjs localhost:60979 GetBalance '{"network_slug":"arb-sepolia","address":"0x...","token_contract":"0x000..."}'
node grpc-call.mjs localhost:60979 GetBatchBalances '{"network_slug":"bsc-testnet","address":"0x...","token_contracts":["0x000..."]}'

Fee Estimation:

node grpc-call.mjs localhost:60979 GetEstimatedFees '{"network_slug":"eth-sepolia"}'

Transaction Lifecycle:

node grpc-call.mjs localhost:60979 GetTransaction '{"network_slug":"arb-sepolia","transaction_hash":"0x..."}'
node grpc-call.mjs localhost:60979 GetTransactionLifecycle '{"network_slug":"arb-sepolia","correlation_id":"..."}'

TP Diagnostics:

node grpc-call.mjs localhost:60979 GetQueueStats '{"network_slug":"arb-sepolia"}'
node grpc-call.mjs localhost:60979 GetStuckTransactions '{"network_slug":"arb-sepolia"}'
node grpc-call.mjs localhost:60979 GetActiveReservations '{"network_slug":"arb-sepolia"}'

Build Transactions:

node grpc-call.mjs localhost:60979 BuildSolverLockTransaction '{"network_slug":"...","request":{...}}'
node grpc-call.mjs localhost:60979 BuildUserRedeemTransaction '{"network_slug":"...","request":{...}}'

Proto Field Convention

Use snake_case for field names in the JSON body (matching the proto definition), not camelCase.