Node SDK

npm install @sly_ai/sdk
# or
pnpm add @sly_ai/sdk

import { Sly } from '@sly_ai/sdk';

// API key auth
const sly = new Sly({ apiKey: process.env.SLY_API_KEY });

// Agent auth (Ed25519)
const agent = new Sly({
  agentId: 'agt_...',
  privateKey: process.env.AGENT_PRIVATE_KEY!,
  autoReauth: true,   // re-runs handshake on 401
});

// Accounts
sly.accounts.create({ type: 'business', name: 'Acme' });
sly.accounts.list({ type: 'business' });
sly.accounts.get(id);
sly.accounts.update(id, { name: 'Acme Inc.' });

// Agents
sly.agents.create({ parentAccountId, name, kyaTier: 1, generateKeypair: true });
sly.agents.getLimits(id);
sly.agents.requestLimitIncrease(id, { to_tier: 2 });

// Wallets
sly.wallets.list();
sly.wallets.getBalance(walletId);
sly.wallets.freeze(walletId, { reason: '...' });

// Transfers
sly.transfers.create({ from_wallet_id, to_wallet_id, amount, currency });
sly.transfers.createBatch({ transfers: [...] });

// Streams
sly.streams.create({ from_wallet_id, to_wallet_id, flow_rate, initial_deposit });
sly.streams.withdraw(streamId, { amount });

sly.ucp.createToken({...});
sly.ucp.settle({...});

sly.acp.createCheckout({...});
sly.acp.completeCheckout(id, {...});

sly.ap2.createMandate({...});
sly.ap2.executeMandate(id, {...});

sly.x402.pay({...});
sly.x402.verify({...});
sly.x402.fetch(url, { walletId });  // auto 402-handling

sly.a2a.sendTask({...});
sly.a2a.listTasks();
sly.a2a.marketplaceSearch({ skill });

sly.mcp.listTools();
sly.mcp.invokeTool(name, args);

const sly = new Sly({
  apiKey,
  retries: 5,
  retryBackoff: 'linear',
  timeout: 30_000,
});

await sly.transfers.create({
  ...,
  idempotencyKey: `tx-${orderId}`,  // stable per attempt
});

import { SlyError, SlyInsufficientBalance, SlyPolicyViolation } from '@sly_ai/sdk';

try {
  await sly.transfers.create({...});
} catch (e) {
  if (e instanceof SlyInsufficientBalance) {
    // handle
  } else if (e instanceof SlyPolicyViolation) {
    // handle
  } else if (e instanceof SlyError) {
    console.error(e.code, e.message, e.details);
  }
}

const { data, pagination } = await sly.transfers.list({ limit: 100 });
if (pagination.totalPages > 1) {
  const page2 = await sly.transfers.list({ limit: 100, page: 2 });
}

for await (const transfer of sly.transfers.iterate({})) {
  console.log(transfer.id);
}

const agent = new Sly({ agentId, privateKey, autoReauth: true });

await agent.connect({
  onTask: async (task) => {...},
  onTransfer: async (tr) => {...},
  onApproval: async (ap) => {...},
});

import { LangChainTools } from '@sly_ai/sdk';
import { AgentExecutor } from 'langchain/agents';

const tools = new LangChainTools(sly).all();
const executor = await AgentExecutor.fromAgentAndTools({ agent, tools });

import { verifyWebhook } from '@sly_ai/sdk';

app.post('/webhooks/sly', (req, res) => {
  try {
    const event = verifyWebhook(req.body, req.headers['x-sly-signature'], process.env.WEBHOOK_SECRET);
    // event is typed
  } catch (e) {
    return res.status(400).end();
  }
});

import type {
  Account, Agent, Wallet, Transfer, Stream,
  CreateTransferInput, TransferStatus,
} from '@sly_ai/sdk';