Skip to main content
The Gateway Rust SDK provides native Rust bindings for interacting with Gateway’s encrypted storage and data sharing protocol. This SDK allows Rust developers to seamlessly integrate privacy-preserving data sharing capabilities into their applications.

​
Installation

Add the SDK to your Cargo.toml: 
[dependencies]
gtw-rs-sdk = "0.1.0"
tokio = { version = "1.0", features = ["full"] }

​
Basic Setup

use gtw_rs_sdk::GtwSDK;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut gtw_sdk = GtwSDK::new().build().await?;
    Ok(())
}

​
Authentication Methods

The SDK supports two authentication methods:
  • Wallet-based authentication using a private key
  • JWT-based authentication
Choose the method that best suits your application’s needs:

​
Wallet-Based Authentication

use gtw_rs_sdk::{GtwSDK, WalletType};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut gtw_sdk = GtwSDK::new().build().await?;

    // Authenticate with a Sui wallet
    gtw_sdk.with_wallet(
        WalletType::Sui,
        "your-private-key"
    )?;

    // Verify authentication
    match gtw_sdk.account.get_me().await {
        Ok(account_info) => {
            println!("Authenticated as: {}", account_info.username);
            println!("DID: {}", account_info.did);
        }
        Err(e) => eprintln!("Authentication failed: {}", e),
    }

    Ok(())
}

​
JWT Authentication

use gtw_rs_sdk::GtwSDK;
use std::env;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut gtw_sdk = GtwSDK::new().build().await?;

    // Load JWT from environment
    let token = env::var("BEARER_TOKEN")
        .expect("BEARER_TOKEN not set");

    gtw_sdk.with_bearer_token(&token)?;

    Ok(())
}

​
Account Management

​
Profile Information

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut gtw_sdk = GtwSDK::new().build().await?;

    match gtw_sdk.account.get_me().await {
        Ok(account_info) => {
            println!("Account Information:");
            println!("  Username: {}", account_info.username);
            println!("  DID: {}", account_info.did);
            println!("  Storage Size: {}", account_info.storage_size);

            if let Some(pic) = account_info.profile_picture {
                println!("  Profile Picture: {}", pic);
            }

            println!("\nConnected Wallets:");
            for wallet in account_info.wallet_addresses {
                println!("  {} Wallet: {}",
                    wallet.chain,
                    wallet.address
                );
            }
        }
        Err(e) => eprintln!("Error: {}", e),
    }

    Ok(())
}

​
Wallet Management

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut gtw_sdk = GtwSDK::new().build().await?;

    // Add a new wallet
    match gtw_sdk
        .account
        .wallet
        .add("0xa43B0b6dEB096f4dF07a0a122F3Ab824e9118D9D")
        .await
    {
        Ok(response) => {
            println!("Wallet added successfully");
            println!("Chain: {}", response.chain);
            println!("Address: {}", response.address);
        }
        Err(e) => eprintln!("Failed to add wallet: {}", e),
    }

    Ok(())
}

​
Next Steps