check_charge
Builds the USDC transfer of the Check price for the networks and paid tools chosen (networks from check_info checkNetworks, tools from check_info toolOffer: the sum of each tool at its own price, never above its maximum) from payer to the analysis fee wallet on chainId (any network of check_info networks), for the payer to sign. The credit is bound to those networks. Needs buyProof, the purchase proof of THIS payer from check_buy_proof (the payer signed and passed the free screening); without it, or with another wallet's, check_buy_proof_required (401). The server also measures the sender on-chain. Returns { check { id, status awaiting_payment, amount, amountRaw, token, feeWallet, tools (exactly what this Check reads) }, skippedChecks? (tools asked for that are switched off or not on sale, left out and not charged), transaction, plan (buildId check-, steps on EVM or transaction on Solana), report }. check.id (CHK-...) is the capability of this Check: whoever holds it reports the payment, analyses and reads the result, so keep it private and keep it to come back to the result. Each call makes a NEW Check, good for 30 minutes (expiresAt): a transaction mined after that is credited by the price of now on the networks it covers (check_report_payment). Pass checkId of one still awaiting payment and in its time to rebuild its transfer (the Solana one expires in about a minute). Sign the transaction exactly as returned: it carries the mark of THIS Check (16 bytes after the transfer arguments on EVM, a memo on Solana). A transfer you build yourself is refused with analysis_payment_rejected reason charge_not_tied after the money left: do not pay again, prove the wallet with destination_challenge (receiver = details.feeWallet, chargeId = the check id, chargeTxHash = that hash) and destination_authorize, then report the same hash again. Refusals: analysis_tool_unavailable (503, a tool is down: nothing is built), check_credit_limit (409), payer_blocked (403), check_network_unsupported (400), check_networks_required (400), check_already_paid (409, checkId of a paid Check), check_charge_expired (409), kyc_required (403, tools with crystal and no approved KYC), invalid_check (400, tools empty, repeated or unknown), check_unavailable (503, no tool chosen is on sale).
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": {
"chainId": "<chainId>",
"payer": "<payer>",
"networks": "<networks>",
"buyProof": "<buyProof>"
},
"name": "check_charge"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| payer | Yes | The paying wallet, the one that signs the transfer (0x on EVM, base58 on Solana). | |
| tools | No | The paid tools to buy, at least one, each once (owner, 18/11/2026: one mark per paid tool): any of "scorechain" (once per wallet), "merkle-science" and "crystal" (once per network), from check_info toolOffer. The Check reads and shows ONLY these, plus the free OFAC and issuer freeze screening. crystal only for a payer whose identity check (KYC) is approved: otherwise kyc_required (403) and nothing is built. Left out, the pair scorechain and merkle-science (older clients). Here ["crystal"] means Crystal ALONE (CLI 0.3.15 and older, on the /v1, still get the pair plus Crystal for it). | |
| chainId | Yes | EVM: integer from GET /v1/chains (1, 10, 56, 100, 137, 8453, 42161, 43114, 130). Solana: string from GET /v1/svm/chains ("solana-mainnet"). | |
| checkId | No | Optional: a Check still awaiting payment, to rebuild its transfer instead of making a new Check. | |
| buyProof | Yes | The purchase proof of this payer from check_buy_proof (vcb_..., 10 minutes). Secret. | |
| networks | Yes | The networks to analyse, from check_info checkNetworks (e.g. ["1","8453","solana-mainnet"]). The price is perNetwork times these, never above maximum. |