crates.io v2.0.1

Rust SDK

Official Rust SDK for Traffic Orchestrator. Validate licenses, manage keys, and integrate license management into your application in minutes.

cargo add traffic-orchestrator

Quick Start

Initialize the client and start validating licenses.

rust
use traffic_orchestrator::Client;

let client = Client::builder()
    .base_url("https://api.trafficorchestrator.com/api/v1")
    .build()?;

License Validation

Validate a license key against a domain with a single call.

rust
// Validate a license key
let result = client.validate_license(
    "TO-XXXX-XXXX-XXXX",
    "example.com",
).await?;

if result.valid {
    println!("License active!");
}

Offline Verification

Verify licenses offline using Ed25519 cryptographic signatures — no network required.

rust
// Verify offline with Ed25519 signature
let is_valid = client.verify_offline(
    "TO-XXXX-XXXX-XXXX",
    &signature,
    &public_key,
)?;

Management API

Create licenses, list existing keys, and monitor usage with authenticated API calls.

rust
// Authenticated client for management
let admin = Client::builder()
    .base_url("https://api.trafficorchestrator.com/api/v1")
    .api_key("your-api-key")
    .build()?;

let licenses = admin.list_licenses().await?;
let new_license = admin.create_license("my-app", "pro").await?;
let usage = admin.get_usage().await?;
let health = admin.health_check().await?;

Available Methods

validateLicense()
Validate a license key against a domain
verifyOffline()
Cryptographic offline verification (Ed25519)
listLicenses()
List all licenses (requires API key)
createLicense()
Create a new license key (requires API key)
getUsage()
Retrieve usage statistics (requires API key)
healthCheck()
Check API health and connectivity
gracePeriod
Cache validation results for resilience during API outages (v2.1.0+)
clearCache()
Clear cached validation results immediately