Observe contract state
fresh402_contract_watchReads blockchain state; the observation does not execute transactions or modify the target wallet/contract. An authorized USDC service payment is separate. Execution can charge USDC or prepaid credits, consume trial quota and update Fresh402 records. A new charge requires prior spending authorization. Without billing/trial credentials, a valid call returns an unpaid quote without executing the observation. Observe code, standard proxy slots, common getters, explicitly selected storage/ABI and bounded selected events at one finalized Base address; optionally compare an owned prior snapshot. Selected single-provider evidence only; unknown controls remain unknown. $0.010000 native USDC/call on Base (eip155:8453); compatible x402 or enabled native MPP client required, no Fresh402 token for first purchase. Save proof/input and private recovery token BEFORE paying for full-response-loss protection: REST X-Fresh402-Recovery-Token; MCP params._meta['fresh402/recovery-token']. Recover originals without new RPC/debit; foreign snapshot/cursor forbidden. Provider failure/partial scan is not paid success. observation_saved=false/persistence_error: recover only, never use unsaved IDs. Prepaid needs eligible finalized all-service credits or an original explicit service-specific tariff4 grant; inspect /v3/prepaid/quote/contract_watch and /v3/prepaid/all-services. Historical Web rights unchanged; paying agents do not need their own RPC credentials. Observations30days, private financial recovery7days. Not full history, financial advice or security audit. Clients: https://fresh402.com/docs#payments. Free signed trial: /v3/agent-trial requires an unfunded EOA ownership signature; human Web trial: /v2/trial. Eligibility/capacity may return429. Use only X-Fresh402-Trial-Key plus persisted Idempotency-Key; replay exact tool/input/key. Exhaustion never authorizes a charge. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.
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": {
"chain_id": "<chain_id>",
"address": "<address>"
},
"name": "fresh402_contract_watch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| block | No | Finalized only. Every state read pins the selected block hash with requireCanonical:true; no latest/number fallback. | finalized |
| reads | No | At most one unverified zero-argument view/pure ABI read with one supported static output. | |
| slots | No | At most one exact bytes32 storage slot; no inferred layout. | |
| address | Yes | 20-byte Ethereum address; lowercase/uppercase accepted, mixed case must have a valid EIP-55 checksum. Normalized to checksummed form. | |
| chain_id | Yes | Base mainnet only; returned provider chain must match. | |
| event_topics | No | At most one exact topic0 at this contract, bounded to the existing lookback/call limit. Dense or excessive work fails the whole paid operation; no partial success. | |
| events_from_block | No | Optional first event block; otherwise previous snapshot block+1, or current block initially. Older than 32 blocks returns lookback_gap, without skipping to recent history. | |
| previous_snapshot | No | Optional owned snapshot_id from a successful saved contract_watch result, retained for30days. Same payer or prepaid account, chain, address and provider required. Foreign/missing IDs return404; expired IDs return410 without silently starting a new baseline. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||