Struct ApexSDK 

pub struct ApexSDK { /* private fields */ }

Main Apex SDK struct providing unified interface to blockchain operations.

The ApexSDK is the primary entry point for interacting with multiple blockchain networks. It manages connections to both Substrate-based and EVM-compatible chains through adapter interfaces.

Examples

Basic Usage

use apex_sdk::prelude::*;

let sdk = ApexSDK::builder()
    .with_evm_endpoint("https://mainnet.infura.io/v3/YOUR_KEY")
    .build()
    .await?;

Implementations

impl ApexSDK

pub fn builder() -> ApexSDKBuilder

Create a new builder for configuring the SDK.

This is the recommended way to create an ApexSDK instance. Use the builder pattern to configure which blockchain adapters you need before initialization.

Examples

use apex_sdk::prelude::*;

let sdk = ApexSDK::builder()
    .with_substrate_endpoint("wss://polkadot.api.onfinality.io/public-ws")
    .with_evm_endpoint("https://mainnet.infura.io/v3/YOUR_KEY")
    .build()
    .await?;

pub async fn new() -> Result<Self>

Create a new SDK instance with default configuration.

Note

This method will always return an error. Use ApexSDK::builder() instead to properly configure the SDK.

Errors

Always returns a configuration error directing you to use the builder.

pub fn substrate(&self) -> Result<&SubstrateAdapter>

Get a reference to the Substrate adapter.

Errors

Returns an error if the Substrate adapter was not configured during SDK initialization.

Examples

use apex_sdk::prelude::*;

let sdk = ApexSDK::builder()
    .with_substrate_endpoint("wss://polkadot.api.onfinality.io/public-ws")
    .build()
    .await?;

let substrate = sdk.substrate()?;
// Use the Substrate adapter...

pub fn evm(&self) -> Result<&EvmAdapter>

Get a reference to the EVM adapter.

Errors

Returns an error if the EVM adapter was not configured during SDK initialization.

Examples

use apex_sdk::prelude::*;

let sdk = ApexSDK::builder()
    .with_evm_endpoint("https://mainnet.infura.io/v3/YOUR_KEY")
    .build()
    .await?;

let evm = sdk.evm()?;
// Use the EVM adapter...

pub fn is_chain_supported(&self, chain: &Chain) -> bool

Check if a specific blockchain is supported by the current SDK configuration.

Returns true if the chain is supported, false otherwise. Support depends on which adapters were configured during SDK initialization.

Arguments

• chain - The blockchain to check for support

Examples

use apex_sdk::prelude::*;

let sdk = ApexSDK::builder()
    .with_evm_endpoint("https://mainnet.infura.io/v3/YOUR_KEY")
    .build()
    .await?;

if sdk.is_chain_supported(&Chain::Ethereum) {
    println!("Ethereum is supported!");
}

if !sdk.is_chain_supported(&Chain::Polkadot) {
    println!("Polkadot is not supported (no Substrate adapter)");
}

pub async fn get_transaction_status( &self, chain: &Chain, tx_hash: &str, ) -> Result<TransactionStatus>

Get the status of a transaction

pub fn transaction(&self) -> TransactionBuilder

Create a new transaction builder

pub async fn execute( &self, transaction: Transaction, ) -> Result<TransactionResult>

Prepare and validate a transaction

This method validates that the required adapters are configured and prepares the transaction for execution. Returns a transaction result with status set to Pending, indicating the transaction is ready to be signed and broadcast.

Note: Actual transaction signing and broadcasting requires a signer. Use the substrate or EVM adapter directly with a wallet for full transaction execution.