#frame #ethereum #wallet #networking #omnichain

frame_rs

A Frame wallet client written in rust to programmatically change the provider network for Frame's Omnichain setup

3 releases

0.1.2 Mar 11, 2024
0.1.1 Feb 22, 2024
0.1.0 Feb 21, 2024

#2739 in Magic Beans

Download history 28/week @ 2024-03-28 30/week @ 2024-04-04

175 downloads per month

MIT license

15KB
76 lines

Frame-rs

frame-rs is a Rust library designed to facilitate interaction with the Frame Ethereum wallet. It provides a straightforward, asynchronous API for switching Ethereum networks via Frame's JSON-RPC interface and performing Ethereum blockchain operations, leveraging the security and user-friendliness of Frame for managing accounts and signing transactions.

Features

  • Network Switching: Programmatically switch the connected Ethereum network in Frame.
  • Ethereum Operations: Simplified interface for common Ethereum operations, such as sending transactions and interacting with smart contracts, using accounts managed by Frame.
  • Async/Await Support: Built with asynchronous Rust features for non-blocking I/O operations.

Requirements

  • Rust 1.39 or later.
  • Access to Frame's JSON-RPC interface (typically via localhost).

Installation

Add frame-rs to your Cargo.toml:

[dependencies]
frame-rs = "0.1.2"

Quick Start

Here's a quick example to get you started with frame-rs:

use frame_rs::client::FrameClient;
use ethers::types::U256;
use anyhow::Result;

#[tokio::main]
async fn main() -> Result<()> {
    // Initialize the Frame client
    let client = FrameClient::new(U256::from(1), None).await?; // Ethereum Mainnet

    // Switch to Arbitrum One
    let arbitrum_chain_id = U256::from(42161);
    client.switch_network(arbitrum_chain_id).await?;

    println!("Successfully switched to Arbitrum One.");
    Ok(())
}

Usage

Creating a Client

To start interacting with Frame, create a FrameClient instance:

    use frame_rs::client::FrameClient;
    use ethers::types::U256;

    #[tokio::main]
    async fn main() {
      let chain_id = U256::from(1); // Example for Ethereum Mainnet
      let client = FrameClient::new(chain_id, None).await.expect("Failed to create FrameClient");
    }

Switching Networks

To switch the connected network:

    use frame_rs::client::FrameClient;
    use ethers::types::U256;

    #[tokio::main]
    async fn main() {
      let new_chain_id = U256::from(42161); // Example for Arbitrum One
      let client = FrameClient::new(U256::from(1), None).await.expect("Failed to create FrameClient");
      client.switch_network(new_chain_id).await.expect("Failed to switch network");
    }

More Operations

frame-rs aims to support additional Ethereum wallet operations. Stay tuned for more features!

License

frame-rs is licensed under the MIT License - see the LICENSE file for details.

Dependencies

~27–42MB
~796K SLoC