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.
readyboolready is true when the daemon and its dependencies are up.
unlockedboolunlocked 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.
networkstringnetwork is the bitcoin network the daemon is configured for, for example "mainnet", "testnet", "testnet4", "signet", or "regtest".
balanceBalanceResponsebalance is the unified balance summary at the time of the call.
pending_countuint32pending_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.
confirmed_satint64confirmed_sat is the total spendable VTXO amount in satoshis.
pending_in_satint64pending_in_sat is the total in-flight inbound amount (boarding plus receive operations).
pending_out_satint64pending_out_sat is the total in-flight outbound amount (send plus exit operations).
credit_available_satuint64credit_available_sat is the server-authoritative available credit balance for the wallet identity.
credit_reserved_satuint64credit_reserved_sat is the server-authoritative in-flight credit reservation amount.