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.

Example

Needs RPC · RPC required

1
SELECT client($transport) AS client;
Notebook ready in readonly mode.

API reference

Exact signatures with descriptions, requirements, inputs, returns, and examples.

client(TRANSPORT) # Live Client Constructor

Creates a live CLIENT using the transport's declared chain id without performing RPC.

Inputs

Name Type Use
transport TRANSPORT

TRANSPORT that supplies the live chain endpoint and request policy.

 required positional

Returns

Name Type
client CLIENT

Live CLIENT. Returns a live CLIENT whose state follows the transport's chain until it is pinned.

Guidance

CLIENT state modes

A CLIENT identifies the state that a read should use. Transport credentials and request policy are hydration authority, not part of durable state identity.

  • A live CLIENT follows the selected chain until it is pinned.
  • A pinned CLIENT identifies one exact block and can be rehydrated with attach_transport.
  • An execution CLIENT resolves retained simulation state and may hydrate missing chain state when a transport is attached.
  • Use client_context to inspect the current state identity and hydration status.

Chain validation

Use an expected_chain_id overload when a wrong-chain result would be unsafe or misleading.

  • The expected chain id is compared locally with trusted transport metadata or retained execution lineage.
  • Chain validation does not pin a moving live client; call pin separately for repeatable reads.

Additional overloads

client(TRANSPORT, UBIGINT) # Live Client Constructor

Creates a live CLIENT only when the transport's declared chain id matches the expected chain id.

Inputs

Name Type Use
transport TRANSPORT

TRANSPORT that supplies the live chain endpoint and request policy.

 required positional
expected_chain_id UBIGINT

Required EVM chain id; client creation fails locally when the transport declares another chain.

 required positional

Returns

Name Type
client CLIENT

Live CLIENT. Returns a live CLIENT whose state follows the transport's chain until it is pinned.

client(UUID) # Execution Client Constructor

Restores a CLIENT from retained execution state without attaching transport authority.

Inputs

Name Type Use
execution_id UUID

Durable UUID of retained execution state in Determica's local catalog.

 required positional

Returns

Name Type
client CLIENT

Execution CLIENT. Returns a CLIENT bound to retained execution state. Missing base-chain state requires attached transport authority.

client(UUID, UBIGINT) # Execution Client Constructor

Restores retained execution state only when its lineage matches the expected chain id.

Inputs

Name Type Use
execution_id UUID

Durable UUID of retained execution state in Determica's local catalog.

 required positional
expected_chain_id UBIGINT

Required EVM chain id; restoration fails when execution lineage belongs to another chain.

 required positional

Returns

Name Type
client CLIENT

Execution CLIENT. Returns a CLIENT bound to retained execution state. Missing base-chain state requires attached transport authority.

Category and tags

Tag
Client