Expand description
Aspens crosschain trading SDK.
This crate provides the core building blocks for interacting with the
Aspens Market Stack: a chain-agnostic Wallet abstraction, a
ChainClient RPC dispatcher (EVM via Alloy, Solana via
solana-client), the AspensClient gRPC entry point, and the
signing helpers in evm, solana, and orders that produce
the exact bytes the arborter validates.
§Feature flags
evm(default) — stateless EVM signing helpers inevmand the EIP-712 bindings underevm. Pulls Alloy primitives only.solana(default) — stateless Solana helpers insolana(PDA derivations, instruction builders, borsh payload encoder). Pullssolana-sdk,bs58,ed25519-dalek, andborsh.client(default) — full gRPC + RPC runtime:AspensClient, thecommandsmodules,chain_client, theexecutorabstraction, and Solana RPC submission. Pullstonic,prost,tokio,solana-client, and the proto-generated bindings.
Lean signing consumers (browser, embedded, etc.) can build with
--no-default-features --features evm,solana to skip all of tonic /
prost / tokio / solana-client.
Re-exports§
pub use chain_client::ChainClient;clientpub use client::AspensClient;clientpub use client::AspensClientBuilder;clientpub use client::JwtToken;clientpub use executor::AsyncExecutor;clientpub use executor::BlockingExecutor;clientpub use executor::DirectExecutor;clientpub use wallet::load_admin_wallet;pub use wallet::load_trader_wallet;pub use wallet::CurveType;pub use wallet::Wallet;pub use wallet::chain_curve;clientpub use wallet::load_trader_wallet_for_chain;clientpub use wallet::load_trader_wallet_for_network;client
Modules§
- attestation
client - Generated protobuf bindings for the attestation service.
- chain_
client client - Chain-aware RPC client that dispatches between Alloy (EVM) and
solana-client (Solana) based on the chain’s
architecturefield. - client
client - gRPC client and builder for the Aspens Market Stack.
- commands
client - gRPC command implementations (config, trading, admin, auth). gRPC command implementations.
- decimals
- Decimal-string ↔ base-units conversion shared by all amount-parsing call sites (CLI, REPL, library). Decimal-string ↔ base-units conversion shared by the order, deposit, and withdraw paths.
- evm
evm - EVM client-side helpers for the Midrib V2 cross-chain order flow.
- executor
client - Async/sync execution strategies used by binaries to drive the client.
Synchronous adapters for driving async work from blocking entry
points. The CLI uses
DirectExecutor(re-uses the ambient tokio runtime); the REPL owns its own runtime viaBlockingExecutor. - health
client - gRPC health-check helpers used to probe stack readiness.
- orders
- Chain-agnostic order primitives.
- proto
client - Generated protobuf bindings for the arborter config and auth services.
- solana
solana - Solana on-chain program (Midrib) client-side helpers.
- wallet
- Curve-agnostic wallet abstraction for signing.