/api/qmail/raida/identity/heal

GET POST

Heal the identity coin in the Mail wallet by re-fetching its fracked RAIDA shares from the network. Persists changes to disk and re-grades on success.

GET http://localhost:8081/api/qmail/raida/identity/heal

Description

An identity coin is "fracked" when one or more of its 25 RAIDA AN shares have drifted (e.g. after a partial outage). This endpoint runs the standard heal flow against just the Mail wallet's identity coin: it re-fetches the lost shares, re-derives ANs, persists, and grades the result.

Prerequisite

The Mail wallet must contain a coin to heal. The endpoint returns 400 if not.

Parameters

None — wallet is fixed to the Mail wallet.

Response

{
  "command": "heal-identity",
  "success": true,
  "identity_health": "healthy",
  "coins_processed": 1,
  "coins_healed": 1,
  "coins_still_fracked": 0,
  "coins_counterfeit": 0,
  "graded_to_bank": 1,
  "graded_to_fracked": 0
}
FieldDescription
identity_healthAggregate verdict: healthy, still_fracked, or counterfeit.
coins_*Per-bucket counts of the heal pass.
graded_to_bank / graded_to_frackedWhere the post-heal grade ended up putting the coin.

Errors

HTTPMessage
400No identity coin found. Place an ID coin in the Mail wallet.
500Cannot resolve wallet path / Transport not available
500No encryption keys available (no coins in wallet)
500Heal operation failed

Example

# GET — easy browser/devtool testing
curl "http://localhost:8081/api/qmail/raida/identity/heal"

# Canonical POST
curl -X POST "http://localhost:8081/api/qmail/raida/identity/heal"

Related