View this page as Markdown

CLIENT

Identifies live chain state, one pinned block, or a retained execution checkpoint without storing credentials.

Family
Logical
Physical
JSON
Used by
22 functions
Examples
0 samples

Used by functions

Derived from generated function parameters and return types.

Input and output

  • attach_transport

    Attaches transport authority to a pinned or execution CLIENT so missing state can be fetched without changing the CLIENT's durable state identity.

    scalar function Live RPC RPC 1 overload
  • pin

    Resolves a live CLIENT to one exact block and returns a pinned CLIENT for repeatable state reads. Pin by tag, number, hash, or a matching number/hash pair, with optional canonicality enforcement. Identical normalized requests using the same constructed live-CLIENT wrapper share one resolution within a SQL statement; separate client(transport) constructions resolve independently, and a later statement resolves the selector again.

    scalar function Live RPC RPC 12 overloads

Accepted as input

  • block_at

    Resolves a timestamp to a block boundary through an attached live client. at_or_before selects the highest block number whose timestamp is no later than the target; at_or_after selects the lowest block number whose timestamp is no earlier; closest selects the nearer timestamp.

    scalar function Live RPC RPC 4 overloads
  • block_range

    Resolves the start and end independently with at_or_after and returns [from_block, to_block). A DATE supplies UTC midnight at the start of that day and UTC midnight at the start of the next day.

    scalar function Live RPC RPC 3 overloads
  • client_context

    Returns the state identity and hydration status carried by a CLIENT, including its kind, chain, block, chain profile, and identity hash.

    scalar function Offline 1 overload
  • code_at

    Reads an account's runtime bytecode from live RPC state, the exact state identified by a pinned CLIENT, or retained execution state. Without a CLIENT, it builds a reusable READ and does not access state.

    scalar function Live RPC RPC 2 overloads
  • create_access_list

    Builds an EIP-2930 access list for a transaction request. Each result row identifies an accessed account or storage slot and includes request status.

    table function Live RPC RPC 3 overloads
  • get_block

    Fetches a block by decimal height, supported block tag, or block hash. The block defaults to latest and include_transactions defaults to false.

    table function Live RPC RPC 5 overloads
  • get_gas_price

    Returns the RPC provider's current legacy gas-price estimate as an exact UINT256 value in Wei.

    scalar function Live RPC RPC 1 overload
  • get_logs

    Reads logs matching emitter, inclusive block bounds, and topic filters. Live clients use eth_getLogs; retained execution clients read stored execution logs.

    table function Live RPC RPC 12 overloads
  • get_transaction

    Fetches a transaction by hash, then makes a separate receipt request for receipt metadata.

    table function Live RPC RPC 2 overloads
  • get_transaction_logs

    Returns logs from a transaction receipt, optionally filtered by emitter or indexed topics. Supply an event signature or JSON ABI to append typed decoded fields.

    table function Live RPC RPC 6 overloads
  • latest_block

    Returns the latest block number reported by the RPC provider. Because the chain head moves, persist the result before using it as a reproducible boundary.

    scalar function Live RPC RPC 1 overload
  • native_balance

    Returns an address's native-token balance as exact Wei in live, pinned, or retained execution state. Without a CLIENT, it builds a reusable READ and does not access state.

    scalar function Live RPC RPC 2 overloads
  • nonce

    Returns an address's transaction count in live, pinned, or retained execution state. Without a CLIENT, it builds a reusable READ and does not access state.

    scalar function Live RPC RPC 2 overloads
  • raw_call

    Executes an isolated EVM call and returns the raw response bytes. Without a CLIENT, it builds a reusable READ and does not execute the call.

    scalar function Live RPC RPC 2 overloads
  • read_contract

    Calls a contract function against live, pinned, or retained execution state and returns a typed SQL value. Without a CLIENT, it builds a reusable READ and does not execute the call.

    scalar function Live RPC RPC 3 overloads
  • read_contract_at

    Calls a contract function at an explicit block number and returns ABI-decoded SQL values.

    scalar function Live RPC RPC 1 overload
  • rpc_call

    Sends a low-level JSON-RPC request and returns the response's result value as JSON. Provider errors and transport failures are raised as SQL errors.

    scalar function Live RPC RPC 1 overload
  • run

    Executes candidate EVM programs sequentially against exact CLIENT state, then atomically publishes compact receipts and auditable local evidence. It never submits transactions or mutates the connected chain.

    table function Existing simulation RPC Existing simulation Mutates simulation 1 overload
  • storage_at

    Returns one raw 32-byte storage word for a contract and BYTES32 slot in live, pinned, or retained execution state. Without a CLIENT, it builds a reusable READ and does not access state.

    scalar function Live RPC RPC 2 overloads

Returned as output

  • client

    Creates a live CLIENT from a TRANSPORT or restores retained execution state by execution ID. An optional expected chain ID rejects state from another chain.

    scalar function Live RPC RPC 4 overloads