1ly SDK

npm install @1ly/agent

import { OnelyClient } from "@1ly/agent";
import { Keypair } from "@solana/web3.js";
 
// Initialize with your agent's wallet
const wallet = Keypair.fromSecretKey(yourSecretKey);
const client = new OnelyClient({ wallet });
 
// Discover APIs
const apis = await client.discover("weather data");
console.log(apis);
 
// Call an API (payment handled automatically)
const weather = await client.call("joe/weather", { 
  lat: 40.7, 
  lng: -74.0 
});
console.log(weather);
 
// Leave a review
await client.review(weather.purchaseId, { 
  positive: true,
  comment: "Accurate and fast"
});

new OnelyClient(options: {
  wallet: Keypair;              // Solana wallet
  network?: "mainnet" | "devnet";
  maxPerCall?: number;          // Max spend per call
  dailyBudget?: number;         // Daily spending limit
})

const results = await client.discover("sentiment analysis");
// Returns: Array<{ seller, title, price, rating, url }>

const response = await client.call("joe/weather", { city: "NYC" });
// Returns: { data: {...}, _1ly: { purchaseId, ... } }

await client.review("purchase-id", {
  positive: true,
  comment: "Great API!"
});

const balance = await client.getBalance();
// Returns: { usdc: 50.00, sol: 0.1 }

import { InsufficientFundsError, APIError } from "@1ly/agent";
 
try {
  await client.call("joe/weather");
} catch (e) {
  if (e instanceof InsufficientFundsError) {
    console.log("Need to top up wallet");
  } else if (e instanceof APIError) {
    console.log("API returned error:", e.message);
  }
}

const client = new OnelyClient({
  wallet,
  maxPerCall: 0.10,    // Never pay more than $0.10 per call
  dailyBudget: 10.00,  // Stop after $10/day
});