VM06 // TRANSACTION GAS PREFLIGHT

MACHINE 006

Transaction Gas Preflight

Live 0.005 USDC

Give the machine one analysis chain and one destination address, optionally a sender, calldata, and value. After payment it returns point-in-time eth_estimateGas units and a fixed recent eth_feeHistory sample. It does not sign, submit, recommend a max fee, or guarantee the final cost.

PURPOSE

Plain-English job

Agents often need gas units and recent execution-fee context before they sign or submit an Ethereum or Base transaction. This machine estimates the supplied unsigned facts and reports a bounded fee-history sample. Analysis chain does not change the payment chain: payment remains Base USDC via x402.

WHEN TO CALL

Job-shaped selection

Call when you need point-in-time gas units and recent execution-fee context before signing or submitting an Ethereum or Base transaction. Not transaction execution, signing, wallet/custody, trading, approval, simulation-as-guarantee, or financial advice. Sibling first-party machines are listed on GET /v1/catalog.

INPUT

Exact JSON object

Required chain (eip155:1 or eip155:8453) and to (0x-prefixed 20-byte address). Optional from, data (0x even-length hex, default 0x, max 8192 bytes), and value_wei (unsigned base-10 integer string, default 0). Request body max 20480 bytes. Nonce, gas controls, access lists, state overrides, keys, signatures, and arbitrary RPC URLs are rejected before payment.

{
  "chain": "eip155:8453",
  "to": "0x0000000000000000000000000000000000000001",
  "data": "0x",
  "value_wei": "0"
}
OUTPUT

Factual structured JSON

Status is OK, PARTIAL when gas units are observed but fee history is unavailable, UNESTIMABLE when the transaction cannot be estimated under current state, or HOLD for infrastructure failure. Illustrative execution-fee figures are observations, not a recommended max fee. Base arithmetic covers L2 execution only and is not a total transaction cost.

HOW DATA IS PROCESSED

Terms-relevant facts

LIMITATIONS

Known bounds

CONTRACT

Intended routes

Public API origin:

POST https://api.agentmercantile.com/v1/transaction-gas-preflight

GET https://api.agentmercantile.com/openapi.json

This page does not start a payment. Public contact: contact@agentmercantile.com.