Crate thruput_client 

Contract invocation without CLI configuration, terminal output, or runtime ownership.

Callers resolve addresses, wallet entrypoints, and calldata, verify network identity, then prepare, inspect, sign, submit, and wait as separate operations. Calls go through prepare_call; native deployments through prepare_deploy.

Re-exports

pub use jsonrpsee;

pub use thruput_contract_spec as spec;

pub use thruput_json_rpc_client as rpc;

pub use thruput_json_rpc_types as types;

pub use thruput_signing as signing;

pub use thruput_xdr as xdr;

Modules

codec

Call argument and return-value codecs for contract specs and local source metadata.

strkey

Shared Z/G/S text encodings; independent of either CLI. Text encodings shared by native clients. StrKeys encode type and checksum, not network. Contract addresses, public keys and private seeds are deliberately separate operations.

Structs

CallRequest

A single child call through an explicitly selected wallet adapter.

DeployRequest

A native deployment from account’s DefaultWallet, with optional funding and initialization in the same transaction.

NativeClient

A native adapter around a caller-owned JSON-RPC transport. Calls submit exactly once. Unknown result variants retain their complete raw result.

ReceiptPollConfig

Receipt wait timing. The timeout includes requests, backoff and sleeps.

ReceiptPollError

Waiting stopped; the evidence never grants permission to submit again.

SignedCall

A signed invocation with its canonical hash available before any network request.

SignedDeploy

A signed deployment with its canonical hash and predicted address available before any network request.

SubmittedCall

A transaction hash that can be observed without resubmitting its envelope.

SubmittedDeploy

An admitted deployment, whose hash and predicted address can be saved and checked again without resubmission.

UnsignedCall

An inspectable unsigned wallet invocation, bound to the intended network.

UnsignedDeploy

An inspectable unsigned deployment, bound to the intended network.

Enums

DeploymentVerificationError

A receipt that does not confirm the predicted deployment.

NativeRpcError

A native read or endpoint preparation failure. Original application errors and unfamiliar results remain available to the embedding application.

SubmitCallError

Native submission failure retaining the canonical identity prepared locally. Neither an RPC failure nor an unfamiliar acknowledgement proves non-admission.

Wallet

Explicit wallet identity and invocation format. Legacy addresses are never reinterpreted as native accounts based on their owner key.

Functions

check_endpoint

Require native wire major 14 and every caller-selected method before use. Discovery is queried once; there is no legacy-name fallback. Missing or malformed discovery fields are incompatible discovery errors retaining the original cause; transport outages remain ordinary call failures.

contract_hash

Hash identifying a contract binary on the network.

deployment_nonce

Deployment salt derived from a transaction nonce: SHA-256 of its little-endian bytes.

first_submission_not_admitted

Whether the first dispatch received authoritative proof of non-admission. This says nothing about earlier submissions of the same transaction and never grants permission to retry. Missing admission, unfamiliar data or a conflicting supplied hash is false; request-scoped refusal may omit the optional hash.

prepare_call

Prepare a single native or legacy child call without submitting it.

prepare_deploy

Prepare a native deployment without submitting it, deriving the new contract’s address.

resolve_block_expiry_height

Add a positive expiry offset to a committed tip, rejecting overflow rather than silently changing the caller’s requested validity window.

submit_signed_transaction

Submit retained signed bytes once and verify the acknowledgement’s transaction hash.

validate_network

Verify signing identity against an independently configured network hash. A matching network hash does not distinguish resets of the same chain.