Status
Status returns a wallet-level readiness summary: daemon readiness, wallet-unlocked state, balance summary, pending-entry count. Kept in the proto for programmatic callers; not surfaced as a CLI verb (the `getinfo` CLI verb covers the human-facing readiness view).
Endpoints
rpc Status(StatusRequest) returns (StatusResponse)POST/v1/wallet/statusExamples
conn, err := grpc.NewClient("localhost:10029",
grpc.WithTransportCredentials(insecure.NewCredentials()))
if err != nil {
log.Fatal(err)
}
defer conn.Close()
client := wavewalletrpc.NewWalletServiceClient(conn)
ctx := context.Background()
req := &wavewalletrpc.StatusRequest{}
resp, err := client.Status(ctx, req)
if err != nil {
log.Fatal(err)
}
fmt.Println(resp)conn, err := grpc.NewClient("localhost:10029",
grpc.WithTransportCredentials(insecure.NewCredentials()))
if err != nil {
log.Fatal(err)
}
defer conn.Close()
client := wavewalletrpc.NewWalletServiceClient(conn)
ctx := context.Background()
req := &wavewalletrpc.StatusRequest{}
resp, err := client.Status(ctx, req)
if err != nil {
log.Fatal(err)
}
fmt.Println(resp)import grpc
import wallet_pb2
import wallet_pb2_grpc
channel = grpc.insecure_channel('localhost:10029')
stub = wallet_pb2_grpc.WalletServiceStub(channel)
request = wallet_pb2.StatusRequest()
response = stub.Status(request)
print(response)const grpc = require('@grpc/grpc-js');
const protoLoader = require('@grpc/proto-loader');
const packageDefinition = protoLoader.loadSync('wallet.proto');
const { wavewalletrpc } = grpc.loadPackageDefinition(packageDefinition);
const client = new wavewalletrpc.WalletService(
'localhost:10029',
grpc.credentials.createInsecure(),
);
const request = {};
// Calls wavewalletrpc.WalletService.Status.
client.status(request, (err, response) => {
if (err) throw err;
console.log(response);
});curl -X POST http://localhost:10031/v1/wallet/status \
-H 'Content-Type: application/json' \
-d '{}'const res = await fetch('http://localhost:10031/v1/wallet/status', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({}),
});
const statusResponse = await res.json();RequestStatusRequest
StatusRequest is the empty request for WalletService.Status.
This message has no fields.
ResponseStatusResponse
StatusResponse is the wallet-level readiness summary returned by WalletService.Status.
| Field | Type | Description |
|---|---|---|
ready | bool | ready is true when the daemon and its dependencies are up. |
unlocked | bool | unlocked is a legacy wallet-exists signal: true once a wallet seed exists on disk or is loaded in memory. Use ready to check whether wallet RPCs are currently usable. |
network | string | network is the bitcoin network the daemon is configured for, for example "mainnet", "testnet", "testnet4", "signet", or "regtest". |
balance | BalanceResponse | balance is the unified balance summary at the time of the call. |
pending_count | uint32 | pending_count is the number of WalletEntry rows in PENDING status. |
BalanceResponsemessage
BalanceResponse is the unified balance summary returned by WalletService.Balance across confirmed, in-flight, and credit amounts.
| Field | Type | Description |
|---|---|---|
confirmed_sat | int64 | confirmed_sat is the total spendable VTXO amount in satoshis. |
pending_in_sat | int64 | pending_in_sat is the total in-flight inbound amount (boarding plus receive operations). |
pending_out_sat | int64 | pending_out_sat is the total in-flight outbound amount (send plus exit operations). |
credit_available_sat | uint64 | credit_available_sat is the server-authoritative available credit balance for the wallet identity. |
credit_reserved_sat | uint64 | credit_reserved_sat is the server-authoritative in-flight credit reservation amount. |