Rust SDK Setup

Prerequisites

Before you begin:

Get your Privy app ID and app secret from the Privy Dashboard
Rust 1.88 or later
A tokio async runtime

Instantiating the `PrivyClient`

Import the PrivyClient struct and create an instance by passing your Privy app ID and app secret as parameters.

use privy_rs::PrivyClient;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = PrivyClient::new(
        "insert-your-app-id".to_string(),
        "insert-your-app-secret".to_string()
    )?;

    Ok(())
}

You can also store your credentials as environment variables for security:

let app_id = std::env::var("PRIVY_APP_ID")
    .expect("PRIVY_APP_ID environment variable not set");
let app_secret = std::env::var("PRIVY_APP_SECRET")
    .expect("PRIVY_APP_SECRET environment variable not set");

let client = PrivyClient::new_from_env()?;

This client PrivyClient is now your entry point to manage Privy from your server. With the PrivyClient you can interact with wallets with methods for creating wallets, signing and sending transactions. You can also manage users with methods for getting a user object, verifying an auth token, and importing new users.

Authorization

If a resource (i.e. wallet, policy, key quorum) has an owner, authorization signatures from the owner are required. Use the authorization context to specify authorization private keys and user JWTs of the wallet’s owners, and the Rust SDK will generate signatures and sign requests under the hood.

We strongly recommend reading this guide before using the Rust SDK for the best development experience.

use privy_rs::{AuthorizationContext, PrivateKey, JwtUser};

let client = PrivyClient::new(app_id, app_secret)?;

let ctx = AuthorizationContext::new()
    .push(JwtUser(client.clone(), "jwt1".to_string()))
    .push(JwtUser(client.clone(), "jwt2".to_string()))
    .push(PrivateKey("authorization-key".to_string()));

Rate limits

Privy rate limits REST API endpoints that you may call from your server.

Learn more about optimizing your setup and handling rate limits in our optimizing guide!

Installation Quickstart

⌘I

​Prerequisites

​Instantiating the PrivyClient

​Authorization

​Rate limits

Prerequisites

Instantiating the `PrivyClient`

Authorization

Rate limits