tari_ootle_wallet_sdk

An opinionated, batteries-included wallet SDK for the Tari Ootle network. Provides account management, key derivation, transaction building/submission, stealth transfers, and confidential transactions.

This crate is intended for building full-featured wallet applications (like tari_walletd). If you are building a lighter-weight project or want more control over the components you use, consider ootle-rs instead.

Architecture

The SDK is generic over WalletSdkSpec, which defines pluggable backends for storage, key management, and network access:

use tari_ootle_wallet_sdk::{WalletSdk, WalletSdkSpec};

// WalletSdkSpec requires:
//   Store: WalletStore              — persistent storage backend
//   KeyStore: WalletKeyStore        — cryptographic key management
//   NetworkInterface: WalletNetworkInterface — network communication (indexer)

Once initialized, domain-specific APIs are accessed via accessor methods on WalletSdk:

Usage

use tari_ootle_wallet_sdk::WalletSdk;

// Initialize the SDK (typically done once at startup)
let sdk = WalletSdk::initialize(config, store, key_store, network_interface)?;

// Derive a new account address and create an account
let address = sdk.key_manager_api().next_account_address()?;
let account = sdk.accounts_api().create_account(
    Some("my-account"),
    true, // set as default
    address,
)?;

// List accounts
let accounts = sdk.accounts_api().get_many(0, 10)?;
let total = sdk.accounts_api().count()?;

// Get account by name
let account = sdk.accounts_api().get_account_by_name("my-account")?;

// Query vault balances for an account
let vaults = sdk.accounts_api().get_vaults_by_account(account.component_address())?;

// Query unspent stealth outputs
let stealth = sdk.stealth_outputs_api()
    .get_unspent_outputs_by_account(account.component_address(), false)?;

// Submit a transaction
let tx_id = sdk.transaction_api().insert_new_transaction(transaction, None, false)?;
sdk.transaction_api().submit_transaction(tx_id).await?;
let result = sdk.transaction_api().wait_for_transaction_finalization(tx_id)?;

Features

• ts — Generate TypeScript type bindings via ts-rs

License

BSD-3-Clause