Rust SDK

pub async fn transact(opts: TransactOptions) -> Result<TransactResult>;

​

What transact() does for you

• SOL and SPL deposits, transfers, and withdrawals
• Swaps via /transact_swap with status polling
• Risk-oracle Ed25519 sigverify prepended at tx index 0
• Ephemeral ALT auto-creation for oversized v0 transactions
• Viewing-key challenge/register flow with process-local caching
• Chain-note v2 envelope (HKDF-SHA256 + AES-256-GCM)
• Stale-root retry loop with blockhash + transport backoff

​

Runtime defaults

​

Install

[dependencies]
cloak-sdk = { git = "https://github.com/cloak-ag/rustsdk" }
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }

​

Minimal setup

use std::sync::Arc;

use cloak_sdk::{
    core::transact::{transact, TransactOptions},
    rpc::SolanaRpc,
};
use solana_keypair::Keypair;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let rpc = Arc::new(SolanaRpc::new("https://api.mainnet-beta.solana.com"));
    let payer = Arc::new(Keypair::new());

    let opts = TransactOptions {
        rpc: Some(rpc),
        payer: Some(payer),
        relay_url: Some("https://api.cloak.ag".into()),
        // ...inputs / outputs / external_amount filled in per flow
        ..Default::default()
    };

    let result = transact(opts).await?;
    println!("landed: {}", result.signature);
    Ok(())
}

​

Design at a glance

• Engine-first, no stateful façade. The TS SDK’s CloakSDK class is a wallet-aware façade over the same engine; the Rust crate exposes the engine directly. Build your own wallet, scanner, or compliance report on top — TransactResult gives you the commitments, indices, and post-tx tree to do it.
• TransactOptions as the one knob. Parameters (inputs, outputs, external_amount, recipient) and submission config (rpc, payer, relay_url, risk checks) live on one struct. ..Default::default() + struct-update syntax keeps call sites readable.
• RpcProvider is a trait. Production wraps solana-rpc-client::nonblocking::RpcClient via SolanaRpc; tests inject MockRpc. Same shape, no cfg-gated code paths.
• Focused Solana crates. Depends on solana-keypair, solana-pubkey, solana-transaction, solana-rpc-client, etc. — not the solana-sdk umbrella. Keeps the dep graph predictable and compile times reasonable.
• Typed retry classification. Error::RootNotFound / Error::StaleProofState / Error::BlockhashExpired are variants the retry loop matches on directly — no string-sniffing, no Box<dyn Error> hand-unwrapping.

​

Next steps