/api/qmail/raida/locker-pool/replenish

GET POST

Replenish the locker pool (used for upload tokens and inbox-fee tokens) by uploading coins to RAIDA, then return the updated pool counts.

GET http://localhost:8081/api/qmail/raida/locker-pool/replenish?wallet_path=Default

Description

The replenish operation contacts RAIDA to top up the locker pool. After it completes (whether or not it added coins), the response carries the same fields as local/locker-pool/status. Pure status (no replenish) is available at the local-bucket version of this endpoint.

When to call

Call this when low_balance is true on the status endpoint, or before a large send batch.

Parameters

ParamTypeRequiredDescription
wallet_pathstringYesWallet whose pool is being replenished.

Response

{
  "command": "locker-pool",
  "success": true,
  "upload_available": 24,
  "inbox_fee_available": 50,
  "wallet_balance": 110.0,
  "low_balance": false
}

Errors

HTTPMessage
400Invalid wallet_path
404Wallet not found
500Replenish failed
500Failed to get pool status

Example

# GET — easy browser/devtool testing
curl "http://localhost:8081/api/qmail/raida/locker-pool/replenish?wallet_path=Default"

# Canonical POST
curl -X POST "http://localhost:8081/api/qmail/raida/locker-pool/replenish?wallet_path=Default"

Related