Skip to main content

Quickstart

Get your first Orb execution and OPAL Trust Receipt in under 15 minutes.

Prerequisites​

TypeScript / JavaScript (~9 minutes)​

1. Install the SDK​

npm install @rodiun/sdk

2. Configure your API key​

export RODIUN_API_KEY=rdn_live_xxxxxxxxxxxx

3. Run your first Orb​

import { RodiuClient } from "@rodiun/sdk";

const client = new RodiuClient({
  apiKey: process.env.RODIUN_API_KEY!,
  baseUrl: "https://api.rodiun.io",
});

const result = await client.run("rodiun.notification-email@1.0.0", {
  to: "you@example.com",
  from_address: "noreply@yourapp.com",
  subject: "Hello from Rodiun!",
  body: "Your first Orb executed successfully.",
});

console.log("Run ID:", result.run_id);
console.log("Status:", result.status);
console.log("Receipt:", result.receipt?.receipt_id);

4. Verify the receipt​

const receipt = await client.getReceipt(result.receipt!.receipt_id);
console.log("Trust score:", receipt.trust_score);
console.log("Risk level:", receipt.risk_level);
console.log("Signature valid:", receipt.signature_valid);

Python (~10 minutes)​

1. Install the SDK​

pip install rodiun

2. Configure your API key​

export RODIUN_API_KEY=rdn_live_xxxxxxxxxxxx

3. Run your first Orb​

from rodiun import RodiuClient

client = RodiuClient.from_config()  # reads RODIUN_API_KEY from env

result = client.run("rodiun.notification-email@1.0.0", inputs={
    "to": "you@example.com",
    "from_address": "noreply@yourapp.com",
    "subject": "Hello from Rodiun!",
    "body": "Your first Orb executed successfully.",
})

print(f"Run ID: {result['run_id']}")
print(f"Status: {result['status']}")
print(f"Receipt: {result.get('receipt', {}).get('receipt_id')}")

4. Verify the receipt​

receipt_id = result["receipt"]["receipt_id"]
receipt = client.get_receipt(receipt_id)
print(f"Trust score: {receipt['trust_score']}")
print(f"Risk level: {receipt['risk_level']}")

CLI​

# Install
pip install rodiun

# Configure (interactive)
rodiun init

# Run an Orb
rodiun run rodiun.notification-email@1.0.0 \
  --inputs '{"to":"you@example.com","from_address":"noreply@yourapp.com","subject":"Hello","body":"Hello from CLI!"}'

# Check status
rodiun status

What's next?​