/api/raida/identity/status

GET

Reports which coin the core treats as this machine’s identity: the highest-denomination coin in the Mail wallet (Bank before Fracked, then lowest serial), provided it is the 100,000 CC note a RAIDA needs. The denomination is read from the coin record, never from the file name. With check=1 the core also runs a live detect of that coin against all 25 RAIDAs so an operator can see whether the identity authenticates fleet-wide. This is the endpoint raidax uses instead of ever opening wallet folders itself.

http://localhost:8080/api/raida/identity/status

Parameters

NameTypeRequiredDescription
checkintegerNo1 to run a live detect of the identity coin on all 25 RAIDAs (a network round trip); default 0 reports the local wallet state only.

Responses

Success Response (200)

{
    "command": "raida-identity-status",
    "success": true,
    "wallet": "Mail",
    "wallet_path": "/opt/raidax/Client_Data/Wallets/Mail",
    "identity_present": true,
    "denomination": 5,
    "value_cc": 100000,
    "serial_number": 1523,
    "folder": "Bank",
    "address": "5.243@epic",
    "check": "done",
    "pass_count": 25,
    "fail_count": 0,
    "error_count": 0,
    "authentic_on_majority": true,
    "raida_status": [241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241, 241]
}
FieldTypeDescription
identity_presentbooleanfalse when the Mail wallet holds no 100,000 CC coin; the fields below are then omitted. Run /api/raida/keys/provision.
denomination, value_ccinteger, numberAlways 5 / 100000 for a valid RAIDA identity.
serial_numberintegerSerial of the identity coin. With the denomination this is the server’s key in the DRD.
folderstringBank or Fracked. A Fracked identity still works on the RAIDAs where its AN is right; the health fix repairs the rest.
addressstringQMail-style address of the coin (<sn>@epic).
checkstringOnly with check=1: done, unreadable, no_encryption_key, or the transport error (for example Bad encryption key when the Default wallet has no coin that can encrypt to the fleet).
pass_count, fail_count, error_countintegerPer-RAIDA detect outcome counts.
authentic_on_majoritybooleanpass_count ≥ 13.
raida_statusarray25 raw RAIDA status codes (241 = pass, 242 = fail, 0 = no answer).

Error Responses

None specific; a missing Mail wallet simply reports identity_present: false.

Examples

cURL Example

curl -X GET "http://localhost:8080/api/raida/identity/status?check=1"

JavaScript Example

fetch(`http://localhost:8080/api/raida/identity/status`)
    .then(r => r.json())
    .then(d => console.log(d.identity_present ? `identity DN${d.denomination}.${d.serial_number} (${d.folder})` : 'no identity coin'));

Python Example

import requests
d = requests.get('http://localhost:8080/api/raida/identity/status', params={'check': 1}).json()
print(d['identity_present'], d.get('pass_count'), d.get('authentic_on_majority'))

Notes

  • Raidax calls this (without check) at boot and every six hours; the detect variant is for operators and the daily health sweep.
  • A legacy wallet named server-id is still honoured by the DRD server-post endpoint if Mail holds no identity, but this endpoint reports the Mail wallet only.