Integrate in 5 lines.

Install

pnpm add github:amalia020/onleash @solana/web3.js @solana/spl-token

Error handling

Every policy violation throws a typed error.

The chain reverts atomically — funds never move. Parse the error code from the transaction logs to give your users a clear message.

import { OnleashClient, OnleashError } from "@onleash/sdk";

try {
  await client.transfer({
    mint,
    source:      sourceATA,
    destination: someATA,
    owner:       payer,
    amount:      5n * 1_000_000n,
    decimals:    6,
  });
} catch (err: any) {
  const msg = err?.message ?? String(err);

  if (/6001|DestinationNotAllowed/.test(msg)) {
    // destination not in allowlist — check your allowlist or add the ATA
    console.error("Blocked: destination not approved");
  } else if (/6002|ExceedsPerTxMax/.test(msg)) {
    // single transfer too large — split into smaller amounts
    console.error("Blocked: amount exceeds per-tx cap");
  } else if (/6003|ExceedsDailyCap/.test(msg)) {
    // daily budget exhausted — wait for the 24h window to roll over
    console.error("Blocked: daily cap reached");
  } else if (/6007|PolicyPaused/.test(msg)) {
    // authority paused the policy — contact the mint authority
    console.error("Blocked: policy is paused");
  } else if (/6008|CooldownActive/.test(msg)) {
    // too soon after last transfer — respect the cooldown_secs interval
    console.error("Blocked: cooldown active, retry later");
  } else if (/6009|ExceedsTransferCount/.test(msg)) {
    // daily transfer count limit hit — wait for window to reset
    console.error("Blocked: daily transfer count exceeded");
  } else {
    throw err; // unexpected — rethrow
  }
}

AI agent actions

Drop into solana-agent-kit, Vercel AI, or LangChain.

createOnleashActions(client)returns four Zod-schema'd tool actions ready for any LLM framework.

import { createOnleashActions } from "@onleash/sdk";

// solana-agent-kit
const tools = createVercelAITools(agent, [...createOnleashActions(client)]);

// LangChain
const tools = createLangchainTools(agent, [...createOnleashActions(client)]);

Policy schema

PDA seeds: [b"policy", mint.key().as_ref()]

Spend-log webhook

Get notified on every policy violation.

client.watchViolations() subscribes to on-chain logs and POSTs a structured payload to any URL you configure — your Slack bot, PagerDuty, custom dashboard, or serverless function. No polling. Fires within one slot of the rejected transaction.

import { OnleashClient } from "@onleash/sdk";

const client = new OnleashClient(connection, wallet);

// Watch a specific mint — fires on every policy violation for that mint
const unsub = client.watchViolations({
  mint:       myMint,
  webhookUrl: "https://your-server.com/onleash-webhook",
  onViolation: (v) => console.log("blocked:", v.errorName, v.signature),
});

// Watch ALL onleash mints (omit mint param)
const unsubAll = client.watchViolations({
  webhookUrl: "https://your-server.com/onleash-webhook",
});

// Stop listening
unsub();

{
  "signature":    "5KtP...q8Wz",
  "errorCode":    6001,
  "errorName":    "DestinationNotAllowed",
  "errorMessage": "Destination not in allowlist",
  "slot":         312847291,
  "observedAt":   "2026-05-06T14:22:01.483Z"
}

// In your webhook receiver
app.post("/onleash-webhook", async (req, res) => {
  const v = req.body;
  await slack.chat.postMessage({
    channel: "#agent-alerts",
    text: `Onleash blocked ${v.errorName} (${v.errorCode})
` +
          `Tx: ${v.signature}`,
  });
  res.sendStatus(200);
});

// app/api/onleash-webhook/route.ts
export async function POST(req: Request) {
  const v = await req.json();
  // log to your DB, alert system, etc.
  console.log(`[${v.errorName}] ${v.signature}`);
  await db.violations.insert(v);
  return Response.json({ ok: true });
}