BlindRail SDK reference

npm install blindrail-sdk

import { TreasuryClient, Connection, Keypair, PublicKey, BN } from "blindrail-sdk";

// Backend
const connection = new Connection("https://your-rpc-endpoint", "confirmed");
const client = TreasuryClient.fromKeypair(connection, keypair);

// Browser (wallet adapter)
import { AnchorProvider } from "@coral-xyz/anchor";
const provider = new AnchorProvider(connection, wallet, { commitment: "confirmed" });
const client = new TreasuryClient(provider);

• SOL payout fee — basis points taken from each SOL payout; deducted from the amount (recipient gets amount − fee). Read via fetchProtocol().feeBps.
• Creation fee — flat SOL charged when opening a treasury (read via fetchCreationFee()).
• Token-vault fees — adding a mint to a treasury costs a flat SOL fee, and each token payout costs a flat SOL fee; the recipient always receives the full token amount. Read both via fetchTokenFees().
• Airdrop fee — a flat 0.001 SOL per recipient, paid straight from the sender (no treasury needed).
• Staking discount — staking the protocol token (DRAIL) reduces the SOL payout & token-payout fees by 25–100%. The SDK applies it automatically when you have an active stake; see stake.
• Rent reserve — the vault must stay rent-exempt (~0.00089 SOL), so the max single payout is vaultBalance − 0.00089 SOL. Use closeTreasury to recover 100%.

# Claude Code / Claude Agent SDK (native skill → .claude/skills/blindrail/)
npx blindrail-sdk add-skill

# pick a tool, or install for all of them at once
npx blindrail-sdk add-skill cursor     # → .cursor/rules/blindrail.md
npx blindrail-sdk add-skill windsurf   # → .windsurf/rules/blindrail.md
npx blindrail-sdk add-skill copilot    # → .github/copilot-instructions.md
npx blindrail-sdk add-skill codex      # → AGENTS.md (Codex & AGENTS.md-aware agents)
npx blindrail-sdk add-skill all

• Claude Code / Claude Agent SDK — installed as a native skill at .claude/skills/blindrail/.
• Cursor — project rule at .cursor/rules/blindrail.md.
• Windsurf — rule at .windsurf/rules/blindrail.md.
• GitHub Copilot — repo instructions at .github/copilot-instructions.md.
• OpenAI Codex & other AGENTS.md-aware agents — AGENTS.md at the repo root.

const { signature, treasury, id } = await client.createTreasury("Season Rewards");

await client.deposit(treasury, 1_000_000_000); // 1 SOL

await client.closeTreasury(treasury);

const t = await client.fetchTreasury(treasury);
console.log(t.name, t.totalDeposited.toString());

const { receipt } = await client.pay(treasury, 50_000_000, 100423);

await client.payout(treasury, recipient, 50_000_000); // 0.05 SOL gross

// single batch (≤ 10)
await client.batchPayout(treasury, [
  { recipient: addrA, amount: 50_000_000 },
  { recipient: addrB, amount: 30_000_000 },
]);

// larger list — chunk into groups of 10
const all = [/* { recipient, amount } … hundreds */];
for (let i = 0; i < all.length; i += 10) {
  await client.batchPayout(treasury, all.slice(i, i + 10));
}

const info = await client.fetchMintInfo(mint);
const { vault } = await client.createTokenVault(treasury, mint, info.tokenProgram);

await client.payoutToken(treasury, mint, recipient, 250_000_000n); // 250 tokens (9 dp)

await client.closeTokenVault(treasury, mint, adminAta);

const f = await client.fetchTokenFees();
console.log(f?.addMintFee.toString(), f?.payoutFee.toString());

const info = await client.fetchMintInfo(mint);

await client.airdropSol([
  { recipient: addrA, amount: 10_000_000 },
  { recipient: addrB, amount: 10_000_000 },
]);

await client.airdropToken(mint, [
  { recipient: addrA, amount: 100_000_000n },
  { recipient: addrB, amount: 100_000_000n },
]);

await client.stake(drailMint, 500_000_000_000n); // 500k DRAIL (9 dp)

await client.unstake(drailMint, 500_000_000_000n);

const s = await client.fetchStake();
if (s) console.log(s.amount.toString(), new Date(s.unlockAt.toNumber() * 1000));

const cfg = await client.fetchStakingConfig();

await client.addOperator(treasury, operatorPublicKey);

await client.removeOperator(treasury, operatorPublicKey);

await client.setPaused(treasury, true);

await client.nominateAdmin(treasury, newAdminPubkey);

// signed by the nominated wallet's client
await newAdminClient.acceptAdmin(treasury);

const p = await client.fetchProtocol();
console.log(p.feeBps); // e.g. 100 = 1%

const fee = await client.fetchCreationFee();