Paid ($0.03 via x402 in USDC on Base, Solana, Monad, Polygon, Arbitrum, Avalanche, Algorand or Stellar, in RLUSD on the XRP Ledger or in USD₮0 on X Layer): the same verdict and reason codes as presign_check, plus a 3 to 5 sentence plain-language explanation a person can read before approving (lang en or nl). Same as POST /v1/check/explain. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.
View input schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"approval",
"transaction",
"signature",
"authorization",
"message",
"solana",
"xrpl",
"algorand",
"stellar",
"near"
],
"description": "What the agent is about to sign; near = a NEAR transaction in transaction (base64 borsh) or tx (signerId, receiverId, actions), or a NEAR Intents message in nep413; authorization = an EIP-7702 authorization delegating the wallet to the contract in address; message = a plain personal_sign / eth_sign message in message; solana = a Solana transaction in transaction; xrpl = an unsigned XRP Ledger transaction in tx; algorand = an Algorand transaction in transaction, or a group in transactions; stellar = a Stellar transaction envelope in transaction"
},
"transaction": {
"description": "solana: the base64 wire transaction about to be signed; decoded and simulated (red SOLANA_TOKEN_ACCOUNT_TAKEOVER, SOLANA_ACCOUNT_ASSIGN; orange SOLANA_UNLIMITED_DELEGATE, SOLANA_DURABLE_NONCE, HIDDEN_APPROVAL, SIMULATION_FAILS). algorand: one base64 msgpack transaction (unsigned or signed); red ALGORAND_REKEY, ALGORAND_CLOSE_ACCOUNT, ALGORAND_ASSET_CLOSE, ALGORAND_FAKE_STABLECOIN; simulated. near: a base64 borsh NEAR transaction (unsigned or signed); red NEAR_FULL_ACCESS_KEY_ADDED, NEAR_ACCOUNT_DELETED, NEAR_CONTRACT_DEPLOYED_ON_WALLET, NEAR_LAST_FULL_ACCESS_KEY_DELETED, NEAR_INTENTS_KEY_ADDED, NEAR_FAKE_TOKEN, NEAR_LOOKALIKE_ACCOUNT; orange NEAR_KEY_UNLIMITED_ALLOWANCE, NEAR_NFT_APPROVAL, NEAR_INTENTS_DEPOSIT_FOR_OTHER. stellar: a base64 XDR transaction envelope (unsigned, signed or a fee bump, as an x402 payment on Stellar); red STELLAR_ACCOUNT_MERGE, STELLAR_SIGNER_ADDED, STELLAR_MASTER_KEY_DISABLED, STELLAR_FAKE_STABLECOIN, ADDRESS_POISONING; orange STELLAR_TOKEN_APPROVE, STELLAR_HIDDEN_APPROVE, STELLAR_MEMO_REQUIRED; Soroban calls simulated.",
"type": "string",
"maxLength": 12000
},
"transactions": {
"description": "algorand: an atomic group, each a base64 msgpack transaction; send the whole group so every transaction is checked. near: several transactions (base64 borsh or { signerId, receiverId, actions }), as signAndSendTransactions",
"maxItems": 16,
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 12000
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
]
}
},
"chainId": {
"description": "EVM chain id, required for approval, transaction, signature and authorization: 1, 10, 56, 137, 143, 196, 8453, 42161, 4663, 43114 (8453 = Base); optional for message",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"address": {
"description": "authorization: the contract the EIP-7702 authorization delegates the wallet to (0x0…0 clears a delegation). Any delegation hands the contract the whole wallet: orange EIP7702_AUTHORIZATION unless the contract is on GoPlus's trust list; red AUTHORIZATION_TO_NO_CONTRACT, AUTHORIZATION_TO_UNVERIFIED_CONTRACT, AUTHORIZATION_TO_FLAGGED_CONTRACT, SANCTIONED_ADDRESS",
"type": "string"
},
"authorizationChainId": {
"description": "authorization, optional: the chain id inside the authorization, chainId (default) or 0 = valid on every chain (orange AUTHORIZATION_ALL_CHAINS)",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"nonce": {
"description": "authorization, optional: the authorization nonce",
"type": "string"
},
"method": {
"description": "message: how it is signed (default personal_sign); eth_sign is always red",
"type": "string",
"enum": [
"personal_sign",
"eth_sign"
]
},
"message": {
"description": "message: the text or 0x-hex about to be signed; a Sign-In with Ethereum message for another site than origin is red, unreadable bytes are orange",
"type": "string",
"maxLength": 16384
},
"network": {
"description": "xrpl: xrpl:0 (mainnet, default) or xrpl:1 (testnet); stellar: stellar:pubnet (default) or stellar:testnet; near: near:mainnet (default) or near:testnet",
"type": "string",
"enum": [
"xrpl:0",
"xrpl:1",
"stellar:pubnet",
"stellar:testnet",
"near:mainnet",
"near:testnet"
]
},
"tx": {
"description": "near: { signerId, receiverId, actions } as wallet-selector builds it (actions like { type: \"FunctionCall\", params: { methodName, args, gas, deposit } }). xrpl: the unsigned transaction JSON (TransactionType, Account, Destination, Amount, …), including CredentialCreate, CredentialAccept, DelegateSet, Batch (every inner transaction is judged), vault deposits and withdrawals (VaultDeposit, VaultWithdraw) and loans (LoanSet, LoanPay)",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"nep413": {
"description": "near: a NEAR Intents message about to be signed, as passed to signMessage: { message, recipient: \"intents.near\", nonce } (message = the JSON { signer_id, verifying_contract, deadline, nonce, intents }), or the signed { standard: \"nep413\", payload }. Red NEAR_INTENTS_GIVES_FOR_NOTHING (a token_diff that only gives), NEAR_INTENTS_KEY_ADDED, NEAR_FAKE_TOKEN received, NEAR_LOOKALIKE_ACCOUNT; orange NEAR_INTENTS_UNKNOWN_VERIFIER, NEAR_INTENTS_LONG_DEADLINE",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"token": {
"description": "approval: the token contract",
"type": "string"
},
"spender": {
"description": "approval: who gets the allowance",
"type": "string"
},
"amount": {
"description": "approval: amount in base units (0 = revoke)",
"type": "string"
},
"to": {
"description": "transaction: the target contract",
"type": "string"
},
"data": {
"description": "transaction: 0x-prefixed calldata",
"type": "string"
},
"value": {
"description": "transaction: native value in wei",
"type": "string"
},
"from": {
"description": "transaction, message or authorization, optional: your wallet address (authorization: its current delegation is shown); the transaction is then simulated (what really leaves and arrives; orange HIDDEN_APPROVAL, SIMULATION_NFT_OUT, SIMULATION_FAILS) and its recipients are compared with who this wallet paid before (red ADDRESS_POISONING for a look-alike)",
"type": "string"
},
"typedData": {
"description": "signature: the exact eth_signTypedData_v4 payload (Permit, Permit2, EIP-3009 x402 payment, Seaport)",
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "string"
}
]
},
"origin": {
"description": "optional: the site asking for the signature or transaction (URL or hostname); a domain under 30 days old is orange",
"type": "string"
},
"intent": {
"description": "optional: what you are trying to do, in one sentence (e.g. \"swap 10 USDC for ETH on Uniswap\"); orange INTENT_MISMATCH when signing would do more or something else",
"type": "string",
"maxLength": 500
},
"x402": {
"description": "optional, EIP-3009 payments only: the x402 payment requirements you are paying ({ accepted: { scheme, network, amount, asset, payTo, maxTimeoutSeconds, extra } }, one entry of the 402's accepts); red when the signature pays more, someone else, another token or chain",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"lang": {
"description": "Language of the explanation (default en)",
"type": "string",
"enum": [
"en",
"nl"
]
}
},
"required": [
"type"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}