Struct Network 

pub struct Network { /* private fields */ }

A cheap, cloneable handle onto the target network.

Chain verbs return TestkitError::Offline when the scenario has no live target. Network::client exposes the underlying typed JSON-RPC client as an escape hatch for methods this handle does not wrap.

Implementations

impl Network

pub fn rpc_url(&self) -> Option<&str>

The public JSON-RPC URL, when the target has one.

pub fn client(&self) -> Option<&NativeClient<HttpClient>>

The underlying typed JSON-RPC client, for methods this handle does not wrap.

pub async fn chain_tip(&self) -> Result<ChainTip>

Current chain tip.

pub async fn submit_raw(&self, tx_hex: String) -> Result<TxHash>

Submit a pre-signed transaction once, verifying the returned identity.

pub async fn receipt( &self, tx_hash: TxHash, ) -> Result<Option<TransactionReceipt>>

Fetch a transaction receipt if it is already available.

pub async fn await_receipt(&self, tx_hash: TxHash) -> Result<TransactionReceipt>

Read-only receipt wait. Errors retain commitment and advisory status evidence; no status authorizes resubmission or proves that execution cannot occur.

pub async fn transaction_status( &self, tx_hash: TxHash, ) -> Result<TransactionStatus>

Fetch a transaction’s advisory status.

pub async fn await_pending(&self, tx_hash: TxHash) -> Result<()>

Wait until the scheduler reports a submitted transaction as pending.

A successful submit RPC confirms admission, not nomination. Manual block tests should await this barrier before requesting nomination. If the transaction commits before Pending is observed, this returns TestkitError::TransactionNotPending because the requested nomination boundary has already passed.

pub async fn produce_block(&self) -> Result<ProducedBlock>

Produce one block through a harness-owned local node in manual mode.

pub async fn get_storage_at( &self, address: ContractAddress, key: &[u8], ) -> Result<StorageResult>

Read one latest-committed storage item at address/key.

pub async fn view_call( &self, contract: ContractAddress, entrypoint: ContractEntrypointID, calldata: &[u8], caller: Option<ContractAddress>, ) -> Result<SimulationResult>

Simulate a contract call through simulateInvocation.

caller sets the simulated msg.sender; pass an agent’s own address to read state keyed by that caller.

pub async fn get_events(&self, query: EventQuery) -> Result<EventPage>

Query events using native opaque pagination cursors.

Trait Implementations

impl Clone for Network

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Network

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.