/api/qmail/raida/locker/import-credentials

GET POST

Download coins from a named locker and save them into the wallet's Mail folder. Designed for importing an identity coin from another machine — distinct from payments/claim, which puts coins into Grade.

GET http://localhost:8081/api/qmail/raida/locker/import-credentials?locker_key={locker_key}&wallet_path=Default

Description

The user typically obtains the locker_key from the device they originally created the identity on. This endpoint contacts at least 13 of 25 RAIDA servers, downloads the locker contents, and writes the resulting .bin files directly into <wallet>/Mail with all pown bytes set to 0x0A (the "untried" marker). The Mail folder is created if it does not exist.

Parameters

ParamTypeRequiredDescription
locker_keystringYesThe locker code that names this user's credentials on the RAIDA network.
wallet_pathstringYesWallet to import into.

Response

{
  "command": "import-credentials",
  "success": true,
  "operation": "import_credentials",
  "coins_found": 1,
  "coins_saved": 1,
  "total_value": 1,
  "wallet_path": "E:\\Client_Data\\Wallets\\Default",
  "destination_folder": "Mail",
  "raida_success": 22
}

Errors

HTTPMessage
400Missing required parameter: locker_key / Invalid wallet path
404Wallet not found
500Transport not initialized
500Failed to download credentials from locker (extra fields: raida_success, detail, optional raida_status_code + raida_error)

Example

# GET — easy browser/devtool testing
curl "http://localhost:8081/api/qmail/raida/locker/import-credentials?locker_key=ABCD-EFGH-IJKL-MNOP&wallet_path=Default"

# Canonical POST
curl -X POST "http://localhost:8081/api/qmail/raida/locker/import-credentials" \
  -d "locker_key=ABCD-EFGH-IJKL-MNOP" \
  -d "wallet_path=Default"

Related