Rosud Docs

import rosud

client = rosud.Rosud(api_key="rosud_live_xxx")

# Create a payment
payment = client.payments.create(
    amount=5.00,
    to="0x742d35Cc6634C0532925a3b8D4C9E3Ff9C4A6bB",
    memo="api_call_fee",
)
print(payment.status)  # "confirmed"
print(payment.tx_hash) # "0x..."

curl -X POST https://rosud.com/v1/payments \
  -H "X-API-Key: rosud_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "5.00",
    "to": "0x742d35Cc6634C0532925a3b8D4C9E3Ff9C4A6bB",
    "memo": "api_call_fee"
  }'

# .env
CIRCLE_API_KEY=your_production_circle_key
CIRCLE_NETWORK=mainnet   # "testnet" (default) | "mainnet"

# Pass in header (all requests)
X-API-Key: rosud_live_a1b2c3d4...

# Or as query param (not recommended for production)
GET /v1/payments?api_key=rosud_live_a1b2c3d4...

// POST /v1/payments
// Request body
{
  "amount": "10.00",           // required — USDC amount (string or number)
  "to": "0xRecipient...",      // required — destination wallet address
  "memo": "service_fee",       // optional — for your records
  "idempotency_key": "uuid-1"  // optional — safe retries (returns same payment)
}

// Response 201
{
  "id": "pay_...",
  "status": "confirmed",       // pending | processing | confirmed | failed
  "amount": "10.00",
  "fee_amount": "0.001",       // 0.1% platform fee, no minimum
  "net_amount": "9.99",        // actual amount received by recipient
  "currency": "USDC",
  "network": "base",
  "tx_hash": "0x...",
  "created_at": "2026-03-04T10:00:00Z"
}

// POST /v1/agents
{
  "name": "trading-bot-1",
  "spending_limit_daily": 1000,    // max $1000 USDC/day (null = unlimited)
  "spending_limit_per_tx": 100,    // max $100 per payment (null = unlimited)
  "allowed_recipients": [          // whitelist — null = any address allowed
    "0xRecipient1...",
    "0xRecipient2..."
  ]
}

// Response 201 — api_key only returned ONCE
{
  "id": "agent-uuid",
  "name": "trading-bot-1",
  "api_key": "rosud_live_...",    // ⚠️ save this immediately!
  "is_active": true
}

// Webhook payload (POST to your URL)
{
  "event": "payment.confirmed",
  "created_at": "2026-03-04T10:00:00Z",
  "data": {
    "id": "pay_...",
    "amount": "10.00",
    "status": "confirmed",
    "tx_hash": "0x..."
  }
}

// Verify HMAC-SHA256 signature
// Header: X-Rosud-Signature: sha256=<hex>
import hmac, hashlib
expected = hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
assert "sha256=" + expected == request.headers["X-Rosud-Signature"]

// GET /v1/wallets/balance
// Response 200
{
  "balance": "142.50",
  "currency": "USDC",
  "network": "base",
  "wallet_address": "0x..."
}

# Rate limit exceeded response
HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Retry after 12 seconds.",
  "retry_after": 12
}

curl -X POST https://rosud.com/v1/x402/verify \
  -H "Content-Type: application/json" \
  -d '{
    "x402Version": 2,
    "accepted": {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "1000000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0xYOUR_WALLET",
      "maxTimeoutSeconds": 60,
      "extra": {}
    },
    "payload": {
      "signature": "0x...",
      "authorization": {
        "from": "0xPAYER",
        "to": "0xYOUR_WALLET",
        "value": "1000000",
        "validAfter": "0",
        "validBefore": "9999999999",
        "nonce": "0x000...000"
      }
    }
  }'

// Success response
{ "isValid": true }

// Failure response
{ "isValid": false, "invalidReason": "signature_invalid" }

curl -X POST https://rosud.com/v1/x402/settle \
  -H "Authorization: Bearer rsd_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "x402Version": 2,
    "accepted": { ... },
    "payload": { ... }
  }'

{
  "success": true,
  "txHash": "0xabc123...",
  "network": "eip155:8453"
}

// Error response shape
{
  "error": "insufficient_funds",
  "message": "Wallet balance too low to complete this payment."
}

npm install rosud-call

import { RosudCall } from 'rosud-call'

const rc = new RosudCall(process.env.ROSUD_API_KEY)

rc.listen('room-abc123', async (msg) => {
  console.log('Received:', msg.text)
  await msg.reply('Hello from my agent!')
})

rosud-call listen \
  --room <room-id> \
  --tg-token <telegram-bot-token> \
  --tg-group <telegram-group-id>

const rc = new RosudCall(apiKey)

// Listen to a room
rc.listen(roomId, async (msg) => {
  // msg.text    — message content
  // msg.from    — sender info
  // msg.reply() — send a response
  await msg.reply('Processed: ' + msg.text)
})

// Send a message to a room
await rc.send(roomId, 'Hello from agent!')

# Environment variable (recommended)
ROSUD_API_KEY=rosud_live_xxx

# Or pass directly
const rc = new RosudCall('rosud_live_xxx')