Struct MorphoClient 

pub struct MorphoClient { /* private fields */ }

Unified Morpho client combining API queries and on-chain transactions.

This client provides a namespace-style API for interacting with Morpho vaults:

• client.api() - Access to GraphQL API queries
• client.vault_v1() - V1 vault transaction operations
• client.vault_v2() - V2 vault transaction operations

Example

use morpho_rs_api::{MorphoClient, MorphoClientConfig, Chain};
use alloy::primitives::{Address, U256};

#[tokio::main]
async fn main() -> Result<(), morpho_rs_api::ApiError> {
    // API-only client
    let client = MorphoClient::new();
    let vaults = client.get_vaults_by_chain(Chain::EthMainnet).await?;

    // Full client with transaction support
    let config = MorphoClientConfig::new()
        .with_rpc_url("https://eth.llamarpc.com")
        .with_private_key("0x...");
    let client = MorphoClient::with_config(config)?;

    // V1 vault operations
    let vault: Address = "0x...".parse().unwrap();
    let balance = client.vault_v1()?.balance(vault).await?;

    Ok(())
}

Implementations

impl MorphoClient

pub fn new() -> Self

Create a new MorphoClient with default API configuration (no transaction support).

pub fn with_config(config: MorphoClientConfig) -> Result<Self>

Create a MorphoClient with custom configuration.

If both rpc_url and private_key are provided, transaction support is enabled.

pub fn vault_v1(&self) -> Result<VaultV1Operations<'_>>

Get V1 vault operations.

Returns an error if transaction support is not configured.

pub fn vault_v2(&self) -> Result<VaultV2Operations<'_>>

Get V2 vault operations.

Returns an error if transaction support is not configured.

pub fn api(&self) -> &MorphoApiClient

Get the API client for GraphQL queries.

pub async fn get_vaults_by_chain(&self, chain: Chain) -> Result<Vec<Vault>>

Get vaults (V1 and V2) on a specific chain as unified Vault type.

pub async fn get_whitelisted_vaults( &self, chain: Option<Chain>, ) -> Result<Vec<Vault>>

Get whitelisted vaults (V1 and V2) as unified Vault type.

pub async fn get_user_vault_positions( &self, address: &str, chain: Option<Chain>, ) -> Result<UserVaultPositions>

Get all vault positions (V1 and V2) for a user.

pub async fn get_user_account_overview( &self, address: &str, chain: Chain, ) -> Result<UserAccountOverview>

Get complete account overview for a user on a specific chain.

pub fn has_transaction_support(&self) -> bool

Check if transaction support is configured.

pub fn signer_address(&self) -> Option<Address>

Get the signer’s address if transaction support is configured.

Trait Implementations

impl Default for MorphoClient

fn default() -> Self

Returns the “default value” for a type.