XFuel

Check the connected XFuel API's health and configuration (fee config, supported chains, message types, demo limits). Useful for discovery/diagnostics. Args: none. Returns JSON: the /health payload (status, server, version, fee_config, chains, message_types, …).

Fetch the SP1 ZK settlement proof for a settled task. Args: - task_id (string): the id returned by submit_inference Returns JSON: { task_id, status, proof_outcome, payment_binding, sp1_proof: { proof, publicInputs, nullifier, provingTimeMs }, fee }. The proof attests settlement metadata + a commitment to the output hash (NOT inference correctness). To validate it, use verify_proof(task_id). Fails if the task has not settled yet — poll get_task_status until proof_outcome is 'valid'.

Get the current status of an XFuel task, including proof outcome and fee breakdown. Args: - task_id (string): the id returned by submit_inference Returns JSON: { task_id, status, proof_outcome, message_type, chain_id, gross_amount, fee_amount, net_amount, fee_bps, payment_rail, payment_ref, result, sp1_proof, created_at, updated_at }. 'status' reaches a terminal value ('completed' | 'fee_collected' | 'failed'); 'proof_outcome' is one of 'pending' | 'valid' | 'regenerable' | 'invalid'.

List the models XFuel can route inference to (OpenAI-compatible GET /v1/models). Call this first to discover valid model ids, then pass one as 'model' to submit_inference or pay_with_usdc. No side effects. Args: none. Returns JSON: { object: 'list', data: [{ id, object: 'model', created, owned_by }] }.

Submit an AI inference task and settle it with USDC via x402 (the default XFuel rail). The server signs an EIP-3009 USDC authorization on Base with its configured payer wallet, so the agent doesn't manage the handshake. If the server has x402 disabled it transparently falls back to the TFUEL rail (no payment is made). Requires the server to be started with XFUEL_PAYER_PRIVATE_KEY. If it is not set, this tool returns a clear "not configured" message — use submit_inference (TFUEL) instead, or the xfuel-sdk with your own payer. The USDC network is chosen by the server's x402 challenge (the payer signs for whatever network the challenge specifies, e.g. Base or Base Sepolia). Args: - model (string): model id, e.g. "llama-3-70b" - amount (string): gross task value in the smallest unit (wei); minimum 10000 - sender (string, optional): the 0x address that owns the task (default: the payer wallet address) - chain_id ('theta'|'bittensor'|'akash'|'osmosis'|'persistence'): settlement network (default 'theta') - input_hash (string, optional): keccak256 of your input (recommended for inference) - memo (string, optional): free-form note echoed on the task - max_gpu_hours (string, optional): compute budget hint - subnet_id (number, optional): Bittensor subnet id when chain_id='bittensor' - callback_url (string, optional): webhook that receives a signed TaskSettled event Returns JSON: { task_id, status, payment_rail, fee_bps, gross_amount, fee_amount, net_amount, links }. 'payment_rail' is 'usdc' when the x402 handshake ran, or 'tfuel' if the server fell back.

Preview per-rail pricing for a task WITHOUT creating it (no side effects). Use this before submit_inference to show the user cost across payment rails. Args: - model_id (string, optional): model id to price (some models have overrides) - amount (string, optional): TFUEL task value in wei (echoed back in the tfuel rail) Returns JSON: { recommended, default_rail, rails: { usdc: { enabled, asset, network, decimals, amount, pay_to }, tfuel: { amount } } }.

Submit an AI inference task to the XFuel Protocol. XFuel routes it to a GPU provider (Theta EdgeCloud → DePIN fallbacks), and settles with a ZK proof. Args: - model (string): model id, e.g. "llama-3-70b" - sender (string): the 0x address that owns/pays for the task - amount (string): gross task value in the smallest unit (wei); minimum 10000 - chain_id ('theta'|'bittensor'|'akash'|'osmosis'|'persistence'): settlement network (default 'theta') - input_hash (string, optional): keccak256 of your input (recommended for inference) - memo (string, optional): free-form note echoed on the task - max_gpu_hours (string, optional): compute budget hint - subnet_id (number, optional): Bittensor subnet id when chain_id='bittensor' - callback_url (string, optional): webhook that receives a signed TaskSettled event Returns JSON: { task_id, status, payment_rail, fee_bps, gross_amount, fee_amount, net_amount, links }. Poll progress with get_task_status(task_id); fetch settlement with get_proof(task_id). Note: this submits with the server's default (unpaid/TFUEL) rail. For USDC/x402 settlement (which needs an agent-side signer) use the xfuel-sdk directly.

Independently verify a settled task's proof client-side (the "prove it" flow in one call): 1. a proof is present and proof_outcome === 'valid'; 2. the x402 payment binding (if present) re-derives to the committed value; 3. (optional) the on-chain nullifier's spent state, when check_nullifier=true AND the server was started with XFUEL_RPC_URL + ZK_VERIFIER_ADDRESS. Args: - task_id (string): the id returned by submit_inference - check_nullifier (boolean, optional): also read the on-chain nullifier state (default false) Returns JSON: { ok, checks: { hasProof, proofOutcomeValid, paymentBinding, nullifier }, reasons }. 'ok' is true when the proof is present + valid and any present payment binding is consistent. The nullifier read is informational and does not gate 'ok'.