@yolo-solutions/sdk

v0.1.0

Published

3 months ago

Wire Yolo earning infrastructure into any AI agent. Automatic 97/1/2 split on every payment.

0High
0Medium
0Low

edward745786

ai agent yolo earn nft base usdc

@yolo-solutions/sdk — Yolo Agent SDK

Wire Yolo earning infrastructure into any AI agent in minutes.

The split happens automatically: 97% to the NFT owner, 1% to the agent self-wallet, 2% to Yolo treasury. No wallets, no chains, no USDC handling. You call earn(). We handle everything.

Install

npm install @yolo-solutions/sdk

Quick start

import { YoloClient } from '@yolo-solutions/sdk'

const yolo = new YoloClient({ apiKey: process.env.YOLO_API_KEY })

// Your agent just completed a job — route the payment
const result = await yolo.earn('yolo_abc123def456', 10)

// result.ownerCut  → 9.70  (97%)
// result.agentCut  → 0.10  (1%)
// result.yoloCut   → 0.20  (2%)

With run tracking

// Record every execution — success or failure
// This feeds the uptime score and the activity oracle (active owner tier)

async function runAgent(task: string) {
  try {
    const result = await yourAgentLogic(task)
    await yolo.earn('yolo_abc123def456', result.revenue)
    await yolo.recordRun('yolo_abc123def456', true)
  } catch (err) {
    await yolo.recordRun('yolo_abc123def456', false)
    throw err
  }
}

API reference

| Method | Parameters | Returns | Description | |--------|-----------|---------|-------------| | earn() | wallet, amount, source? | EarnResult | Route a payment. Splits automatically. | | earnBatch() | payments[] | BatchResult | Batch earn for multiple agents in one call. | | recordRun() | wallet, success | RunResult | Log a run outcome. Updates uptime + activity oracle. | | getAgent() | wallet | Agent | Fetch current stats — balance, total earned, run count. |

Common earn sources

// Label the source for your own analytics
await yolo.earn(wallet, 49,   'gumroad')
await yolo.earn(wallet, 120,  'stripe-subscription')
await yolo.earn(wallet, 500,  'client-retainer')
await yolo.earn(wallet, 8.50, 'affiliate-commission')

Error handling

All errors follow the same shape — success: false with an error string:

try {
  const result = await yolo.earn(wallet, amount)
  // result.success === true
} catch (err) {
  // err.message → the error string from the API
  // e.g. "Agent not found: yolo_abc123"
  //      "amount must be a positive number"
  //      "Invalid or missing API key"
}

The split

Every earn() call splits automatically and instantly on Base:

| Recipient | Rate | Notes | |-----------|------|-------| | NFT Owner | 97–98.5% | Tier-dependent (passive / active / staker) | | Agent Wallet | 1% | Accumulates with the NFT — transfers on sale | | Yolo Treasury | 0.5–2% | Gnosis Safe on Base |

Owner tiers: passive 97% (default) · active 98% (agent earns regularly) · staker 98.5% (NFT locked 90 days). Tier is determined by the nightly oracle automatically.

Get an API key

Free, instant, one per email: https://yolo.solutions/developers

License

MIT