Fetch UGF's live payment token registry. Returns the list of supported payment coins (e.g. USDC, $U, ETH) and the chains each can be paid on, including token + vault contract addresses. Use this to discover viable routes without doing a quote.

Read on-chain balance for a wallet on a supported EVM chain. Pass token_address='native' for the chain's native token, or an ERC-20 contract address. Returns the raw balance in atoms (smallest unit) as a decimal string. Stateless RPC read — no keys required.

Fetch the UGF login nonce for a wallet address. Agent signs this nonce externally then calls ugf_authenticate.

Complete UGF login. Agent signs the nonce from ugf_get_nonce with its private key and passes the signature here. Returns JWT for agent to cache.

Restore a cached UGF JWT on the MCP client. Use this on subsequent sessions to skip re-signing the nonce.

Get a UGF quote for a specific payment coin and chain. Checks wallet balance against quote amount and returns whether the agent can proceed.

Auto-discover the best payment route. Fetches all wallet balances in parallel, gets quotes for every viable option, and returns ranked choices cheapest first. Agent just provides calldata and destination.

Poll UGF route until completed/failed/expired. Use after payment to confirm execution.

Poll UGF route status by digest. Returns current status and completion state.

Build ERC-3009 x402 typed-data payload for local signing. Returns {domain, types, message, nonce, valid_after, valid_before}. Agent signs with signTypedData, then calls ugf_x402_submit_signed.

Submit a locally-signed x402 payload to UGF. Pair with ugf_x402_build_typed_data.

Build unsigned EIP-1559 vault payment tx for local signing + broadcast. Returns {to, data, value, chainId, gasLimit, nonce, type, maxFeePerGas, maxPriorityFeePerGas} — all BigInts as strings. Agent signs + broadcasts, then calls ugf_vault_submit_signed.

Submit proof of a locally-broadcast vault payment tx. Pair with ugf_vault_build_tx.

Wait until UGF sponsorship side is ready for a destination EVM tx. Agent then sends destination tx itself.

Confirm a user-broadcast destination EVM tx hash back to UGF.

Wait for the Solana user-sig message UGF prepared. Returns {serialized_message: base64}. Agent signs locally with its keypair via nacl.sign.detached, then calls ugf_sol_submit_user_sig.

Submit a locally-produced Solana user signature to UGF. Pair with ugf_sol_wait_user_sig_message.

Wait for UGF to prepare Sui sponsor tx_bytes + sponsor_sig (base64). Agent signs tx_bytes locally with its Sui Ed25519 keypair, then calls ugf_sui_execute_signed_block.

Broadcast a dual-signed (user + sponsor) Sui transaction block via Sui RPC. Returns {tx_digest}.