kyc_proof
Hand here the signature of kyc_proof_challenge with its nonce and message, unchanged. The challenge is consumed once and it returns { walletProof (vkp_..., 30 minutes, secret), wallet, expiresAt }. Pass walletProof to invoice_create or payout_batch when they ask for "crystal" (API: header X-Wallet-Proof). It proves possession only: without an approved KYC on that wallet the call still answers kyc_required (403). A challenge of another kind is refused with kyc_proof_challenge_invalid.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"wallet": "<wallet>",
"nonce": "<nonce>",
"message": "<message>"
},
"name": "kyc_proof"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nonce | Yes | ||
| wallet | Yes | The wallet proved. | |
| message | Yes | From kyc_proof_challenge, unchanged. | |
| signature | No | EVM: the EIP-191 or EIP-712 signature. Solana: the ed25519 signature in base58. | |
| transaction | No | Solana: the signed proofTransaction (base64), never sent. |