morpho-rs-contracts

Contract bindings and transaction clients for Morpho V1 (MetaMorpho) and V2 vaults.

Installation

cargo add morpho-rs-contracts

Features

• VaultV1TransactionClient - Execute transactions against MetaMorpho (V1) vaults
• VaultV2TransactionClient - Execute transactions against V2 vaults
• ERC20/ERC4626 bindings - Solidity interface bindings via alloy::sol!
• HttpProvider - Type alias for RPC connections using alloy

Usage

Creating a Transaction Client

use morpho_rs_contracts::{VaultV1TransactionClient, VaultV2TransactionClient};

// V1 (MetaMorpho) vaults
let v1_client = VaultV1TransactionClient::new(
    "https://eth.llamarpc.com",
    "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80"
)?;

// V2 vaults
let v2_client = VaultV2TransactionClient::new(
    "https://eth.llamarpc.com",
    "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80"
)?;

Querying Balance and Allowance

use alloy_primitives::{Address, U256};

let vault: Address = "0x...".parse()?;
let token: Address = "0x...".parse()?;
let owner = client.signer_address();

// Get underlying asset address
let asset = client.get_asset(vault).await?;

// Get token balance
let balance = client.get_balance(token, owner).await?;

// Get approval allowance
let allowance = client.get_allowance(token, owner, vault).await?;

// Get token decimals
let decimals = client.get_decimals(token).await?;

Executing Deposit and Withdraw

use alloy_primitives::{Address, U256};

let vault: Address = "0x...".parse()?;
let amount = U256::from(1000000); // Amount in smallest units
let receiver = client.signer_address();

// Approve the vault to spend tokens (if needed)
let approval_receipt = client.approve_if_needed(asset, vault, amount).await?;

// Deposit assets into the vault
let deposit_receipt = client.deposit(vault, amount, receiver).await?;
println!("Deposit tx: {:?}", deposit_receipt.transaction_hash);

// Withdraw assets from the vault
let withdraw_receipt = client.withdraw(vault, amount, receiver, receiver).await?;
println!("Withdraw tx: {:?}", withdraw_receipt.transaction_hash);

Public API

Types

• VaultV1TransactionClient - Transaction client for V1 vaults
• VaultV2TransactionClient - Transaction client for V2 vaults
• HttpProvider - HTTP provider type alias
• ContractError - Error type for contract operations
• Result<T> - Result type alias

VaultV1TransactionClient / VaultV2TransactionClient Methods

Error Types

pub enum ContractError {
    RpcConnection(String),
    TransactionFailed(String),
    InsufficientBalance { have: U256, need: U256 },
    InvalidPrivateKey,
}

License

MIT