@cubee_ee/sdk 0.1.0

package/dist/utils/errors.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toSdkError = toSdkError;
+const CONTRACT_ERROR_MAP = {
+    // cubic-pool error codes (see programs/cubic-pool/src/errors.rs)
+    6000: { code: "invalid_input", message: "Invalid token count" },
+    6001: { code: "invalid_input", message: "Invalid token index" },
+    6002: { code: "invalid_input", message: "Invalid weights — must sum to 10000" },
+    6003: { code: "invalid_input", message: "Invalid virtual balances" },
+    6004: { code: "insufficient_funds", message: "Insufficient pool liquidity" },
+    6005: { code: "slippage_exceeded", message: "Slippage tolerance exceeded" },
+    6006: { code: "invalid_input", message: "Invalid token amounts" },
+    6007: { code: "slippage_exceeded", message: "BPT received is below the minimum requested" },
+    6009: { code: "invalid_input", message: "Swap fee rate exceeds the allowed maximum" },
+    6011: { code: "math_overflow", message: "Math overflow" },
+    6012: { code: "math_overflow", message: "Math underflow" },
+    6022: { code: "pool_disabled", message: "Pool is disabled" },
+    6023: { code: "swaps_disabled", message: "Swaps are disabled on this pool" },
+    6025: { code: "invalid_input", message: "Zero amount" },
+};
+/**
+ * Convert a raw error (possibly from Anchor, web3.js, or fetch) into a
+ * cleanly-typed SdkError. Used by safeCall wrappers so callers always
+ * get structured errors, never exceptions.
+ */
+function toSdkError(cause) {
+    // Anchor-encoded program errors
+    const msg = extractMessage(cause);
+    const code = extractErrorCode(msg);
+    if (code !== null && CONTRACT_ERROR_MAP[code]) {
+        return {
+            code: CONTRACT_ERROR_MAP[code].code,
+            humanMessage: CONTRACT_ERROR_MAP[code].message,
+            cause,
+        };
+    }
+    // Common network strings
+    if (/timed? ?out|ETIMEDOUT/i.test(msg)) {
+        return { code: "rpc_timeout", humanMessage: "RPC timed out", cause };
+    }
+    if (/429|rate limit/i.test(msg)) {
+        return { code: "rpc_rate_limited", humanMessage: "RPC rate-limited — slow down", cause };
+    }
+    if (/fetch failed|ECONNREFUSED|ENOTFOUND/i.test(msg)) {
+        return { code: "rpc_unavailable", humanMessage: "RPC endpoint unreachable", cause };
+    }
+    if (/Account does not exist|account not found/i.test(msg)) {
+        return { code: "account_not_found", humanMessage: "Account does not exist on-chain", cause };
+    }
+    if (/insufficient funds/i.test(msg)) {
+        return { code: "insufficient_funds", humanMessage: "Insufficient funds for this operation", cause };
+    }
+    return { code: "unknown", humanMessage: msg || "Unknown error", cause };
+}
+function extractMessage(e) {
+    if (!e)
+        return "";
+    if (typeof e === "string")
+        return e;
+    if (e instanceof Error)
+        return e.message;
+    if (typeof e === "object" && e !== null && "message" in e) {
+        return String(e.message ?? "");
+    }
+    try {
+        return JSON.stringify(e);
+    }
+    catch {
+        return String(e);
+    }
+}
+function extractErrorCode(msg) {
+    // Anchor error format: "custom program error: 0x1774"
+    const hex = msg.match(/custom program error: 0x([0-9a-fA-F]+)/);
+    if (hex)
+        return parseInt(hex[1], 16);
+    // Anchor SDK format: "Error Number: 6007"
+    const dec = msg.match(/Error Number:\s*(\d+)/);
+    if (dec)
+        return parseInt(dec[1], 10);
+    return null;
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./errors";
+export * from "./retry";
+export * from "./pda";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./errors"), exports);
+__exportStar(require("./retry"), exports);
+__exportStar(require("./pda"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0CAAwB;AACxB,wCAAsB"}

package/dist/utils/pda.d.ts

@@ -0,0 +1,8 @@
+import { PublicKey } from "@solana/web3.js";
+import BN from "bn.js";
+export declare function derivePoolPda(programId: PublicKey, config: PublicKey, poolId: BN): [PublicKey, number];
+export declare function deriveBptMint(cubicPoolProgramId: PublicKey, pool: PublicKey): [PublicKey, number];
+export declare function deriveHelperPda(stldProgramId: PublicKey, pool: PublicKey): [PublicKey, number];
+export declare function deriveTreasuryPda(protocolFeesProgramId: PublicKey): [PublicKey, number];
+export declare function deriveAta(owner: PublicKey, mint: PublicKey, tokenProgram: PublicKey): PublicKey;
+//# sourceMappingURL=pda.d.ts.map

package/dist/utils/pda.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda.d.ts","sourceRoot":"","sources":["../../src/utils/pda.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,OAAO,CAAC;AASvB,wBAAgB,aAAa,CAC3B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,EAAE,GACT,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED,wBAAgB,aAAa,CAC3B,kBAAkB,EAAE,SAAS,EAC7B,IAAI,EAAE,SAAS,GACd,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED,wBAAgB,eAAe,CAC7B,aAAa,EAAE,SAAS,EACxB,IAAI,EAAE,SAAS,GACd,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED,wBAAgB,iBAAiB,CAC/B,qBAAqB,EAAE,SAAS,GAC/B,CAAC,SAAS,EAAE,MAAM,CAAC,CAErB;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,SAAS,EACf,YAAY,EAAE,SAAS,GACtB,SAAS,CAMX"}

package/dist/utils/pda.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.derivePoolPda = derivePoolPda;
+exports.deriveBptMint = deriveBptMint;
+exports.deriveHelperPda = deriveHelperPda;
+exports.deriveTreasuryPda = deriveTreasuryPda;
+exports.deriveAta = deriveAta;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const config_1 = require("../config");
+function derivePoolPda(programId, config, poolId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([config_1.CUBIC_POOL_SEED, config.toBuffer(), poolId.toArrayLike(Buffer, "le", 8)], programId);
+}
+function deriveBptMint(cubicPoolProgramId, pool) {
+    return web3_js_1.PublicKey.findProgramAddressSync([config_1.BPT_MINT_SEED, pool.toBuffer()], cubicPoolProgramId);
+}
+function deriveHelperPda(stldProgramId, pool) {
+    return web3_js_1.PublicKey.findProgramAddressSync([config_1.STLD_HELPER_SEED, pool.toBuffer()], stldProgramId);
+}
+function deriveTreasuryPda(protocolFeesProgramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([config_1.TREASURY_SEED], protocolFeesProgramId);
+}
+function deriveAta(owner, mint, tokenProgram) {
+    const [ata] = web3_js_1.PublicKey.findProgramAddressSync([owner.toBuffer(), tokenProgram.toBuffer(), mint.toBuffer()], spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
+    return ata;
+}
+//# sourceMappingURL=pda.js.map

package/dist/utils/pda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda.js","sourceRoot":"","sources":["../../src/utils/pda.ts"],"names":[],"mappings":";;AAUA,sCASC;AAED,sCAQC;AAED,0CAQC;AAED,8CAIC;AAED,8BAUC;AAzDD,6CAA4C;AAE5C,iDAAgE;AAChE,sCAKmB;AAEnB,SAAgB,aAAa,CAC3B,SAAoB,EACpB,MAAiB,EACjB,MAAU;IAEV,OAAO,mBAAS,CAAC,sBAAsB,CACrC,CAAC,wBAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EACzE,SAAS,CACV,CAAC;AACJ,CAAC;AAED,SAAgB,aAAa,CAC3B,kBAA6B,EAC7B,IAAe;IAEf,OAAO,mBAAS,CAAC,sBAAsB,CACrC,CAAC,sBAAa,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EAChC,kBAAkB,CACnB,CAAC;AACJ,CAAC;AAED,SAAgB,eAAe,CAC7B,aAAwB,EACxB,IAAe;IAEf,OAAO,mBAAS,CAAC,sBAAsB,CACrC,CAAC,yBAAgB,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EACnC,aAAa,CACd,CAAC;AACJ,CAAC;AAED,SAAgB,iBAAiB,CAC/B,qBAAgC;IAEhC,OAAO,mBAAS,CAAC,sBAAsB,CAAC,CAAC,sBAAa,CAAC,EAAE,qBAAqB,CAAC,CAAC;AAClF,CAAC;AAED,SAAgB,SAAS,CACvB,KAAgB,EAChB,IAAe,EACf,YAAuB;IAEvB,MAAM,CAAC,GAAG,CAAC,GAAG,mBAAS,CAAC,sBAAsB,CAC5C,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EAC5D,uCAA2B,CAC5B,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,22 @@
+import { SdkResult } from "../types/result";
+export interface RetryOptions {
+    /** Number of attempts total (1 = no retry). */
+    attempts?: number;
+    /** Per-attempt timeout (ms). */
+    timeoutMs?: number;
+    /** Backoff schedule (ms) between attempts. */
+    backoffMs?: number[];
+    /** Additional predicate: return `false` to stop retrying early. */
+    shouldRetry?: (error: unknown) => boolean;
+}
+/**
+ * Retry-wrapped helper. Returns a SdkResult<T>. Never throws. Use for any
+ * I/O: RPC calls, backend fetches, CPI simulations.
+ *
+ * ```ts
+ * const res = await safeCall(() => connection.getAccountInfo(pk), { attempts: 3 });
+ * if (!res.ok) showToast(res.error.humanMessage);
+ * ```
+ */
+export declare function safeCall<T>(operation: () => Promise<T>, opts?: RetryOptions): Promise<SdkResult<T>>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAW,MAAM,iBAAiB,CAAC;AAGrD,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,mEAAmE;IACnE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC3C;AAID;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAyBvB"}

package/dist/utils/retry.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeCall = safeCall;
+const result_1 = require("../types/result");
+const errors_1 = require("./errors");
+const DEFAULT_BACKOFF_MS = [200, 500, 1500];
+/**
+ * Retry-wrapped helper. Returns a SdkResult<T>. Never throws. Use for any
+ * I/O: RPC calls, backend fetches, CPI simulations.
+ *
+ * ```ts
+ * const res = await safeCall(() => connection.getAccountInfo(pk), { attempts: 3 });
+ * if (!res.ok) showToast(res.error.humanMessage);
+ * ```
+ */
+async function safeCall(operation, opts = {}) {
+    const attempts = opts.attempts ?? 3;
+    const backoff = opts.backoffMs ?? DEFAULT_BACKOFF_MS;
+    const timeoutMs = opts.timeoutMs ?? 15000;
+    const shouldRetry = opts.shouldRetry ?? defaultShouldRetry;
+    let lastError;
+    for (let attempt = 0; attempt < attempts; attempt++) {
+        try {
+            const raced = await withTimeout(operation(), timeoutMs);
+            return (0, result_1.ok)(raced);
+        }
+        catch (e) {
+            lastError = e;
+            if (!shouldRetry(e))
+                break;
+            if (attempt < attempts - 1) {
+                const delayIdx = Math.min(attempt, backoff.length - 1);
+                await sleep(backoff[delayIdx]);
+            }
+        }
+    }
+    return (0, result_1.err)((0, errors_1.toSdkError)(lastError).code, (0, errors_1.toSdkError)(lastError).humanMessage, lastError);
+}
+function defaultShouldRetry(e) {
+    const err = (0, errors_1.toSdkError)(e);
+    // Retry on transient network / rate-limit errors, stop on structural ones.
+    return (err.code === "rpc_timeout" ||
+        err.code === "rpc_unavailable" ||
+        err.code === "rpc_rate_limited" ||
+        err.code === "backend_unavailable");
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function withTimeout(p, ms) {
+    return new Promise((resolve, reject) => {
+        const h = setTimeout(() => reject(new Error(`timed out after ${ms}ms`)), ms);
+        p.then((v) => {
+            clearTimeout(h);
+            resolve(v);
+        }, (e) => {
+            clearTimeout(h);
+            reject(e);
+        });
+    });
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":";;AAyBA,4BA4BC;AArDD,4CAAqD;AACrD,qCAAsC;AAatC,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AAE5C;;;;;;;;GAQG;AACI,KAAK,UAAU,QAAQ,CAC5B,SAA2B,EAC3B,OAAqB,EAAE;IAEvB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,kBAAkB,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAM,CAAC;IAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,kBAAkB,CAAC;IAE3D,IAAI,SAAkB,CAAC;IACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,EAAE,SAAS,CAAC,CAAC;YACxD,OAAO,IAAA,WAAE,EAAC,KAAK,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,SAAS,GAAG,CAAC,CAAC;YACd,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;gBAAE,MAAM;YAC3B,IAAI,OAAO,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACvD,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAA,YAAG,EACR,IAAA,mBAAU,EAAC,SAAS,CAAC,CAAC,IAAI,EAC1B,IAAA,mBAAU,EAAC,SAAS,CAAC,CAAC,YAAY,EAClC,SAAS,CACV,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,CAAU;IACpC,MAAM,GAAG,GAAG,IAAA,mBAAU,EAAC,CAAC,CAAC,CAAC;IAC1B,2EAA2E;IAC3E,OAAO,CACL,GAAG,CAAC,IAAI,KAAK,aAAa;QAC1B,GAAG,CAAC,IAAI,KAAK,iBAAiB;QAC9B,GAAG,CAAC,IAAI,KAAK,kBAAkB;QAC/B,GAAG,CAAC,IAAI,KAAK,qBAAqB,CACnC,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,WAAW,CAAI,CAAa,EAAE,EAAU;IAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7E,CAAC,CAAC,IAAI,CACJ,CAAC,CAAC,EAAE,EAAE;YACJ,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,EACD,CAAC,CAAC,EAAE,EAAE;YACJ,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,MAAM,CAAC,CAAC,CAAC,CAAC;QACZ,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@cubee_ee/sdk",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Cube DEX SDK — client library for interacting with the Cubic Pool AMM on Solana",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "env:mainnet": "cp .env.mainnet .env && echo 'Active env: MAINNET'",
+    "env:testnet": "cp .env.testnet .env && echo 'Active env: TESTNET'",
+    "env:show": "grep -E '^NETWORK=' .env || echo 'no .env'",
+    "build": "tsc --declaration",
+    "build:mainnet": "npm run env:mainnet && npm run build",
+    "build:testnet": "npm run env:testnet && npm run build",
+    "test": "jest",
+    "lint": "tsc --noEmit"
+  },
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "keywords": [
+    "solana",
+    "dex",
+    "amm",
+    "cube",
+    "sdk"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@solana/web3.js": "^1.95.0"
+  },
+  "dependencies": {
+    "@coral-xyz/anchor": "^0.32.1",
+    "@solana/spl-token": "^0.4.8",
+    "@solana/web3.js": "^1.95.0",
+    "bn.js": "^5.2.1"
+  },
+  "devDependencies": {
+    "@types/bn.js": "^5.1.5",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.10.4",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.4",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.3.3"
+  }
+}

package/src/clients/AdminClient.ts

@@ -0,0 +1,254 @@
+import * as anchor from "@coral-xyz/anchor";
+import { Program } from "@coral-xyz/anchor";
+import {
+  AccountMeta,
+  Connection,
+  PublicKey,
+  SystemProgram,
+} from "@solana/web3.js";
+import { TOKEN_PROGRAM_ID } from "@solana/spl-token";
+import BN from "bn.js";
+import { CubeConfig } from "../config";
+import { PROTOCOL_ADMIN_IDL } from "../idl";
+import { deriveTreasuryPda } from "../utils/pda";
+
+/**
+ * AdminClient — wraps `protocol_admin` with treasury-routed admin
+ * operations.
+ *
+ * The cubic_pool program enforces that every admin instruction must be
+ * signed by the Treasury PDA (`seeds = [b"treasury"]`, owned by
+ * protocol_admin). This client builds the canonical flow:
+ *
+ *     admin wallet
+ *       → protocol_admin.<wrapper>     (treasury.admin == signer)
+ *       → CPI cubic_pool.<admin_ix>             (signer == TREASURY_PDA)
+ *
+ * Direct calls into cubic_pool admin instructions will fail on-chain.
+ *
+ * Note: every method returns a `TransactionInstruction`. Compose into a tx
+ * with `@solana/web3.js` and sign with the admin wallet.
+ */
+export class AdminClient {
+  readonly program: Program;
+  readonly cubicPoolProgramId: PublicKey;
+  readonly treasuryPda: PublicKey;
+
+  constructor(opts: { config: CubeConfig; provider: anchor.AnchorProvider }) {
+    const { config, provider } = opts;
+    const idl = JSON.parse(JSON.stringify(PROTOCOL_ADMIN_IDL)) as any;
+    idl.address = config.programs.protocolAdmin.toString();
+    this.program = new Program(idl, provider) as any;
+    this.cubicPoolProgramId = config.programs.cubicPool;
+    [this.treasuryPda] = deriveTreasuryPda(config.programs.protocolAdmin);
+  }
+
+  /**
+   * Idempotent treasury init. Returns true if a new treasury was created.
+   * Caller becomes the initial `treasury.admin`.
+   */
+  async initializeTreasuryIfMissing(connection: Connection, admin: PublicKey): Promise<boolean> {
+    const info = await connection.getAccountInfo(this.treasuryPda);
+    if (info) return false;
+    await (this.program.methods as any)
+      .initialize(admin)
+      .accounts({
+        treasury: this.treasuryPda,
+        payer: admin,
+        systemProgram: SystemProgram.programId,
+      })
+      .rpc();
+    return true;
+  }
+
+  // ── Admin lifecycle ──────────────────────────────────────────────────────
+
+  initiateAdminTransferIx(admin: PublicKey, newAdmin: PublicKey) {
+    return (this.program.methods as any)
+      .initiateAdminTransfer(newAdmin)
+      .accounts({ treasury: this.treasuryPda, admin })
+      .instruction();
+  }
+
+  acceptAdminTransferIx(newAdmin: PublicKey) {
+    return (this.program.methods as any)
+      .acceptAdminTransfer()
+      .accounts({ treasury: this.treasuryPda, newAdmin })
+      .instruction();
+  }
+
+  cancelAdminTransferIx(admin: PublicKey) {
+    return (this.program.methods as any)
+      .cancelAdminTransfer()
+      .accounts({ treasury: this.treasuryPda, admin })
+      .instruction();
+  }
+
+  // ── Treasury vault management ────────────────────────────────────────────
+
+  registerTokenIx(admin: PublicKey, mint: PublicKey, tokenProgram = TOKEN_PROGRAM_ID) {
+    const [vault] = PublicKey.findProgramAddressSync(
+      [Buffer.from("vault"), mint.toBuffer()],
+      this.program.programId,
+    );
+    return (this.program.methods as any)
+      .registerToken()
+      .accounts({
+        treasury: this.treasuryPda,
+        mint,
+        vault,
+        admin,
+        tokenProgram,
+        systemProgram: SystemProgram.programId,
+      })
+      .instruction();
+  }
+
+  withdrawIx(
+    admin: PublicKey,
+    mint: PublicKey,
+    recipient: PublicKey,
+    amount: BN,
+    tokenProgram = TOKEN_PROGRAM_ID,
+  ) {
+    const [vault] = PublicKey.findProgramAddressSync(
+      [Buffer.from("vault"), mint.toBuffer()],
+      this.program.programId,
+    );
+    return (this.program.methods as any)
+      .withdraw(amount)
+      .accounts({
+        treasury: this.treasuryPda,
+        vault,
+        recipient,
+        admin,
+        tokenProgram,
+      })
+      .instruction();
+  }
+
+  // ── Pool config / pool admin (treasury-routed) ───────────────────────────
+
+  poolInitializeConfigIx(admin: PublicKey, config: PublicKey, defaultProtocolFeeRate: number) {
+    return (this.program.methods as any)
+      .poolInitializeConfig(defaultProtocolFeeRate)
+      .accounts({
+        treasury: this.treasuryPda,
+        admin,
+        config,
+        cubicPoolProgram: this.cubicPoolProgramId,
+        systemProgram: SystemProgram.programId,
+      })
+      .instruction();
+  }
+
+  // setSwapFeeRate has been removed from the protocol-admin wrapper —
+  // it's a level-1 (pool-admin) instruction, signed directly by the
+  // wallet stored in `pool.pool_admin`. Use `CubicPoolClient` for that
+  // call instead.
+
+  setProtocolFeeRateIx(admin: PublicKey, config: PublicKey, pool: PublicKey, protocolFeeRate: number) {
+    return (this.program.methods as any)
+      .poolSetProtocolFeeRate(protocolFeeRate)
+      .accounts({ ...this.poolAdminAccounts(admin, config, pool) })
+      .instruction();
+  }
+
+  setPoolEnabledIx(admin: PublicKey, config: PublicKey, pool: PublicKey, enabled: boolean) {
+    return (this.program.methods as any)
+      .poolSetPoolEnabled(enabled)
+      .accounts({ ...this.poolAdminAccounts(admin, config, pool) })
+      .instruction();
+  }
+
+  setSwapsEnabledIx(admin: PublicKey, config: PublicKey, pool: PublicKey, enabled: boolean) {
+    return (this.program.methods as any)
+      .poolSetSwapsEnabled(enabled)
+      .accounts({ ...this.poolAdminAccounts(admin, config, pool) })
+      .instruction();
+  }
+
+  setBannedExtensionsIx(admin: PublicKey, config: PublicKey, banned: BN) {
+    return (this.program.methods as any)
+      .poolSetBannedExtensions(banned)
+      .accounts({
+        treasury: this.treasuryPda,
+        admin,
+        config,
+        cubicPoolProgram: this.cubicPoolProgramId,
+      })
+      .instruction();
+  }
+
+  /**
+   * Collects protocol fees from a pool to the supplied recipient ATAs.
+   *
+   * `vaults` / `recipients` / `tokenPrograms` must be aligned with
+   * `pool.token_mints` (one entry per token in pool order).
+   */
+  collectProtocolFeesIx(
+    admin: PublicKey,
+    config: PublicKey,
+    pool: PublicKey,
+    vaults: PublicKey[],
+    recipients: PublicKey[],
+    tokenPrograms: PublicKey[] = vaults.map(() => TOKEN_PROGRAM_ID),
+  ) {
+    const remaining: AccountMeta[] = this.tripleRemaining(vaults, recipients, tokenPrograms);
+    return (this.program.methods as any)
+      .poolCollectProtocolFees()
+      .accounts({ ...this.poolAdminAccounts(admin, config, pool) })
+      .remainingAccounts(remaining)
+      .instruction();
+  }
+
+  /**
+   * Emergency drain. Pool must be paused first. `amounts.length` must equal
+   * the pool's token_count; pass 0 to skip a token.
+   */
+  debugWithdrawLiquidityIx(
+    admin: PublicKey,
+    config: PublicKey,
+    pool: PublicKey,
+    amounts: BN[],
+    vaults: PublicKey[],
+    recipients: PublicKey[],
+    tokenPrograms: PublicKey[] = vaults.map(() => TOKEN_PROGRAM_ID),
+  ) {
+    const remaining: AccountMeta[] = this.tripleRemaining(vaults, recipients, tokenPrograms);
+    return (this.program.methods as any)
+      .poolDebugWithdrawLiquidity(amounts)
+      .accounts({ ...this.poolAdminAccounts(admin, config, pool) })
+      .remainingAccounts(remaining)
+      .instruction();
+  }
+
+  // ── Internals ────────────────────────────────────────────────────────────
+
+  private poolAdminAccounts(admin: PublicKey, config: PublicKey, pool: PublicKey) {
+    return {
+      treasury: this.treasuryPda,
+      admin,
+      config,
+      pool,
+      cubicPoolProgram: this.cubicPoolProgramId,
+    };
+  }
+
+  private tripleRemaining(
+    vaults: PublicKey[],
+    recipients: PublicKey[],
+    tokenPrograms: PublicKey[],
+  ): AccountMeta[] {
+    if (vaults.length !== recipients.length || vaults.length !== tokenPrograms.length) {
+      throw new Error("AdminClient: vaults/recipients/tokenPrograms must be the same length");
+    }
+    const acc: AccountMeta[] = [];
+    for (let i = 0; i < vaults.length; i++) {
+      acc.push({ pubkey: vaults[i], isSigner: false, isWritable: true });
+      acc.push({ pubkey: recipients[i], isSigner: false, isWritable: true });
+      acc.push({ pubkey: tokenPrograms[i], isSigner: false, isWritable: false });
+    }
+    return acc;
+  }
+}