Skip to content

Vérification de preuve de travail ​

L'endpoint /pow vérifie un défi de preuve de travail résolu : renvoyez le jeton émis avec le défi, accompagné du nonce trouvé.

Paramètres ​

Le corps de la requête doit être en JSON :

ParamètreRequisDescription
tokenOuiJeton émis par le défi
nonceOuiNonce trouvé par le client

Champs de réponse ​

ChampTypeDescription
validbooleantrue si la preuve est acceptée
reasonstringMotif du rejet — absent lorsque valid vaut true

Motifs de rejet ​

MotifSignification
wrongLe nonce ne produit pas une empreinte avec assez de zéros initiaux
expiredLe jeton a plus de 5 minutes
usedLe jeton a déjà été consommé — chacun ne sert qu'une seule fois
invalidLe jeton est malformé ou n'est pas un jeton de preuve de travail

Exemples de code ​

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "token": "eyJ...",
    "nonce": "48123"
  }' \
  "https://api.sylvain.sh/v6/pow"

Essayer ​

Gestion des erreurs ​

Si les paramètres sont manquants ou invalides, l'API retournera une erreur :

Message d'erreurDescription
Please provide a token (?token={token})Le token est manquant
Please provide a nonce (&nonce={nonce})Le nonce est manquant

Endpoints associés ​

  • GET /v6/pow - Demander un défi à résoudre