@coffer_so/sdk 1.0.0

package/dist/clients/contract-instructions.d.ts

@@ -0,0 +1,24 @@
+import { AccountMeta, TransactionInstruction } from "@solana/web3.js";
+import { CofferConfig } from "../config";
+import { ContractInstructionMap, ContractProgram } from "../types/contracts";
+type InstructionName<P extends ContractProgram> = keyof ContractInstructionMap[P] & string;
+export type ContractInstructionArgs<P extends ContractProgram, I extends InstructionName<P>> = ContractInstructionMap[P][I] extends {
+    args: infer A;
+} ? A : never;
+export type ContractInstructionAccounts<P extends ContractProgram, I extends InstructionName<P>> = ContractInstructionMap[P][I] extends {
+    accounts: infer A;
+} ? A : never;
+/**
+ * Build any instruction exposed by the three deployed contracts. Argument and
+ * account names use the exact snake_case names from the shipped IDLs; all fixed
+ * accounts are explicit. Integer widths, argument fields, account order and
+ * signer/writable flags are checked or derived from those IDLs.
+ *
+ * This only builds an instruction. Required signatures, authority constraints,
+ * remaining-account layouts and transaction size still apply. A Treasury PDA
+ * can sign only during CPI: use the corresponding protocolAdmin wrapper for
+ * governance, rather than sending a cubicPool instruction with a PDA signer.
+ */
+export declare function buildContractInstruction<P extends ContractProgram, I extends InstructionName<P>>(config: CofferConfig, program: P, instruction: I, args: ContractInstructionArgs<P, I>, accounts: ContractInstructionAccounts<P, I>, remainingAccounts?: AccountMeta[]): TransactionInstruction;
+export {};
+//# sourceMappingURL=contract-instructions.d.ts.map

package/dist/clients/contract-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-instructions.d.ts","sourceRoot":"","sources":["../../src/clients/contract-instructions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAa,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE7E,KAAK,eAAe,CAAC,CAAC,SAAS,eAAe,IAAI,MAAM,sBAAsB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AAC3F,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,eAAe,EAAE,CAAC,SAAS,eAAe,CAAC,CAAC,CAAC,IACzF,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AACrE,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,eAAe,EAAE,CAAC,SAAS,eAAe,CAAC,CAAC,CAAC,IAC7F,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAIzE;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,eAAe,EAAE,CAAC,SAAS,eAAe,CAAC,CAAC,CAAC,EAC9F,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,CAAC,EACV,WAAW,EAAE,CAAC,EACd,IAAI,EAAE,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,EACnC,QAAQ,EAAE,2BAA2B,CAAC,CAAC,EAAE,CAAC,CAAC,EAC3C,iBAAiB,GAAE,WAAW,EAAO,GACpC,sBAAsB,CA4BxB"}

package/dist/clients/contract-instructions.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildContractInstruction = buildContractInstruction;
+const anchor_1 = require("@coral-xyz/anchor");
+const web3_js_1 = require("@solana/web3.js");
+const bn_js_1 = __importDefault(require("bn.js"));
+const idl_1 = require("../idl");
+const coders = new Map();
+/**
+ * Build any instruction exposed by the three deployed contracts. Argument and
+ * account names use the exact snake_case names from the shipped IDLs; all fixed
+ * accounts are explicit. Integer widths, argument fields, account order and
+ * signer/writable flags are checked or derived from those IDLs.
+ *
+ * This only builds an instruction. Required signatures, authority constraints,
+ * remaining-account layouts and transaction size still apply. A Treasury PDA
+ * can sign only during CPI: use the corresponding protocolAdmin wrapper for
+ * governance, rather than sending a cubicPool instruction with a PDA signer.
+ */
+function buildContractInstruction(config, program, instruction, args, accounts, remainingAccounts = []) {
+    const idl = idl_1.IDLS[program];
+    const schema = idl.instructions.find((ix) => ix.name === instruction);
+    if (!schema)
+        throw new Error(`Unknown ${program} instruction: ${instruction}`);
+    validateFields(args, schema.args, idl, `${program}.${instruction}`);
+    const supplied = accounts;
+    assertObjectFields(supplied, schema.accounts.map((a) => a.name), "accounts");
+    const keys = schema.accounts.map((a) => ({
+        pubkey: publicKey(supplied[a.name], `accounts.${a.name}`),
+        isSigner: a.signer === true,
+        isWritable: a.writable === true,
+    }));
+    for (const meta of remainingAccounts) {
+        if (typeof meta.isSigner !== "boolean" || typeof meta.isWritable !== "boolean") {
+            throw new Error("remainingAccounts must contain explicit signer and writable flags");
+        }
+        keys.push({ ...meta, pubkey: publicKey(meta.pubkey, "remainingAccounts.pubkey") });
+    }
+    let coder = coders.get(program);
+    if (!coder) {
+        coder = new anchor_1.BorshInstructionCoder(idl);
+        coders.set(program, coder);
+    }
+    return new web3_js_1.TransactionInstruction({
+        programId: config.programs[program],
+        keys,
+        data: coder.encode(instruction, args),
+    });
+}
+function publicKey(value, path) {
+    if (!value || typeof value.toBuffer !== "function")
+        throw new Error(`${path} must be a PublicKey`);
+    const bytes = value.toBuffer();
+    if (bytes.length !== 32)
+        throw new Error(`${path} must be a 32-byte PublicKey`);
+    return new web3_js_1.PublicKey(bytes);
+}
+function assertObjectFields(value, expected, path) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error(`${path} must be an object`);
+    const names = Object.keys(value);
+    for (const key of expected)
+        if (!Object.prototype.hasOwnProperty.call(value, key))
+            throw new Error(`${path}.${key} is required`);
+    for (const key of names)
+        if (!expected.includes(key))
+            throw new Error(`${path}.${key} is not in the contract ABI`);
+}
+function validateFields(value, fields, idl, path) {
+    assertObjectFields(value, fields.map((f) => f.name), path);
+    for (const field of fields)
+        validateType(value[field.name], field.type, idl, `${path}.${field.name}`);
+}
+function validateType(value, type, idl, path) {
+    if (typeof type === "string") {
+        if (type === "pubkey") {
+            publicKey(value, path);
+            return;
+        }
+        if (type === "bool") {
+            if (typeof value !== "boolean")
+                throw new Error(`${path} must be boolean`);
+            return;
+        }
+        if (type === "bytes") {
+            if (!Buffer.isBuffer(value))
+                throw new Error(`${path} must be a Buffer`);
+            return;
+        }
+        const integer = /^([ui])(\d+)$/.exec(type);
+        if (integer) {
+            const width = Number(integer[2]);
+            const signed = integer[1] === "i";
+            if (width > 32 ? !bn_js_1.default.isBN(value) : !Number.isSafeInteger(value))
+                throw new Error(`${path} must be ${width > 32 ? "BN" : "an integer"} (${type})`);
+            const n = bn_js_1.default.isBN(value) ? value : new bn_js_1.default(value);
+            const min = signed ? new bn_js_1.default(1).shln(width - 1).neg() : new bn_js_1.default(0);
+            const max = new bn_js_1.default(1).shln(signed ? width - 1 : width).subn(1);
+            if (n.lt(min) || n.gt(max))
+                throw new Error(`${path} is outside ${type}`);
+            return;
+        }
+        throw new Error(`Unsupported ABI primitive ${type}`);
+    }
+    if (type.option) {
+        if (value !== null)
+            validateType(value, type.option, idl, path);
+        return;
+    }
+    if (type.vec || type.array) {
+        if (!Array.isArray(value))
+            throw new Error(`${path} must be an array`);
+        if (type.array && value.length !== type.array[1])
+            throw new Error(`${path} must have ${type.array[1]} entries`);
+        value.forEach((v, i) => validateType(v, type.vec ?? type.array[0], idl, `${path}[${i}]`));
+        return;
+    }
+    if (type.defined) {
+        const definition = idl.types.find((t) => t.name === type.defined.name);
+        if (!definition || definition.type.kind !== "struct")
+            throw new Error(`Unsupported ABI type ${type.defined.name}`);
+        validateFields(value, definition.type.fields, idl, path);
+        return;
+    }
+    throw new Error(`Unsupported ABI type at ${path}`);
+}
+//# sourceMappingURL=contract-instructions.js.map

package/dist/clients/contract-instructions.js.map

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

package/dist/clients/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./RpcClient";
+export * from "./CofferBackendClient";
+export * from "./CubicPoolClient";
+export * from "./tx-builders";
+export * from "./versioned";
+export * from "./SingleTokenDepositClient";
+export * from "./PoolFactoryClient";
+export * from "./AdminClient";
+export * from "./contract-instructions";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC"}

package/dist/clients/index.js

@@ -0,0 +1,26 @@
+"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("./RpcClient"), exports);
+__exportStar(require("./CofferBackendClient"), exports);
+__exportStar(require("./CubicPoolClient"), exports);
+__exportStar(require("./tx-builders"), exports);
+__exportStar(require("./versioned"), exports);
+__exportStar(require("./SingleTokenDepositClient"), exports);
+__exportStar(require("./PoolFactoryClient"), exports);
+__exportStar(require("./AdminClient"), exports);
+__exportStar(require("./contract-instructions"), exports);
+//# sourceMappingURL=index.js.map

package/dist/clients/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,wDAAsC;AACtC,oDAAkC;AAClC,gDAA8B;AAC9B,8CAA4B;AAC5B,6DAA2C;AAC3C,sDAAoC;AACpC,gDAA8B;AAC9B,0DAAwC"}

package/dist/clients/quote-math.d.ts

@@ -0,0 +1,15 @@
+import { PoolInfo } from "../types/pool";
+export declare function u64(value: bigint, label: string): bigint;
+/** Compute one deployed-contract swap against a snapshot, optionally advance a private zap copy. */
+export declare function simulatePoolSwap(pool: PoolInfo, tokenInIndex: number, tokenOutIndex: number, amountIn: bigint, now: bigint, mutate?: boolean): {
+    amountOut: bigint;
+    grossAmountOut: bigint;
+    feeAmount: bigint;
+    protocolFeeAmount: bigint;
+    surgeFeeAmount: bigint;
+    spotOut: bigint;
+    window: import("../math/maxSelloff").SelloffResult | null;
+};
+/** Clock from sync; callers may supply the transaction's expected Unix timestamp explicitly. */
+export declare function quoteTimestamp(pool: PoolInfo, nowSeconds?: number): bigint;
+//# sourceMappingURL=quote-math.d.ts.map

package/dist/clients/quote-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-math.d.ts","sourceRoot":"","sources":["../../src/clients/quote-math.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAiB,MAAM,eAAe,CAAC;AAOxD,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGxD;AAGD,oGAAoG;AACpG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,UAAQ;;;;;;;;EAsD1I;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ1E"}

package/dist/clients/quote-math.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.u64 = u64;
+exports.simulatePoolSwap = simulatePoolSwap;
+exports.quoteTimestamp = quoteTimestamp;
+const bn_js_1 = __importDefault(require("bn.js"));
+const cubicMath_1 = require("../math/cubicMath");
+const slippage_1 = require("../math/slippage");
+const maxSelloff_1 = require("../math/maxSelloff");
+const surgeFee_1 = require("../math/surgeFee");
+const U64_MAX = (1n << 64n) - 1n;
+function u64(value, label) {
+    if (value < 0n || value > U64_MAX)
+        throw new Error(`${label} must fit u64`);
+    return value;
+}
+const bi = (value) => BigInt(value?.toString() ?? "0");
+/** Compute one deployed-contract swap against a snapshot, optionally advance a private zap copy. */
+function simulatePoolSwap(pool, tokenInIndex, tokenOutIndex, amountIn, now, mutate = false) {
+    if (!Number.isInteger(tokenInIndex) || !Number.isInteger(tokenOutIndex) || tokenInIndex === tokenOutIndex ||
+        tokenInIndex < 0 || tokenOutIndex < 0 || tokenInIndex >= pool.tokenCount || tokenOutIndex >= pool.tokenCount) {
+        throw new Error("InvalidTokenIndex");
+    }
+    if (!pool.poolEnabled)
+        throw new Error("PoolDisabled");
+    if (!pool.swapsEnabled)
+        throw new Error("SwapsDisabled");
+    u64(amountIn, "amountIn");
+    if (amountIn === 0n)
+        throw new Error("ZeroAmount");
+    const input = pool.tokens[tokenInIndex], output = pool.tokens[tokenOutIndex];
+    if (!input.isActive)
+        throw new Error("TokenInactive");
+    const virtualBalanceIn = bi(input.virtualBalance), virtualBalanceOut = bi(output.virtualBalance);
+    const actualBalanceOut = bi(output.actualBalance);
+    if (input.maxSelloffPct > 0 && [input.maxSelloffPeriodLength, input.previousSelloff, input.currentSelloff,
+        input.windowStartTimestamp, input.selloffVbSnapshot].some(v => v === undefined)) {
+        throw new Error("Selloff state missing: sync the pool before quoting");
+    }
+    const window = (0, maxSelloff_1.checkAndAdvanceSelloff)({
+        state: { previousSelloff: bi(input.previousSelloff), currentSelloff: bi(input.currentSelloff),
+            windowStartTimestamp: bi(input.windowStartTimestamp), selloffVbSnapshot: bi(input.selloffVbSnapshot) },
+        maxSelloffPct: input.maxSelloffPct, period: input.maxSelloffPeriodLength ?? 0,
+        amountIn, virtualBalance: virtualBalanceIn, now,
+    });
+    const feeAmount = (0, slippage_1.calculateSwapFee)(amountIn, pool.swapFeeRate);
+    const protocolFeeAmount = (0, slippage_1.calculateProtocolFee)(feeAmount, pool.protocolFeeRate);
+    const amountInAfterFee = amountIn - feeAmount;
+    const weightInBps = BigInt(input.weightBps), weightOutBps = BigInt(output.weightBps);
+    const grossAmountOut = (0, cubicMath_1.calcOutGivenIn)({ virtualBalanceIn, virtualBalanceOut, weightInBps, weightOutBps, amountIn: amountInAfterFee, actualBalanceOut });
+    const surgeFeeAmount = (0, surgeFee_1.calcSurgeFeeAmount)({ window,
+        thresholdPct: input.variableFeeThresholdPct ?? 0, slopeLowPct: input.variableFeeSlopeLowPct ?? 0,
+        slopeMidPct: input.variableFeeSlopeMidPct ?? 0, slopeHighPct: input.variableFeeSlopeHighPct ?? 0,
+        kinkPct: input.variableFeeKinkPct ?? 0, amountInAfterFee, amountOut: grossAmountOut,
+        virtualBalanceIn, virtualBalanceOut, weightInBps, weightOutBps, actualBalanceOut });
+    const amountOut = grossAmountOut - surgeFeeAmount;
+    const netInput = amountIn - protocolFeeAmount;
+    const actualInAfter = u64(bi(input.actualBalance) + netInput, "input actual balance");
+    const virtualInAfter = u64(virtualBalanceIn + netInput, "input virtual balance");
+    const actualOutAfter = u64(actualBalanceOut - grossAmountOut, "output actual balance");
+    const virtualOutAfter = u64(virtualBalanceOut - grossAmountOut, "output virtual balance");
+    const inputFees = u64(bi(input.protocolFeesOwed) + protocolFeeAmount, "input fees");
+    const outputFees = u64(bi(output.protocolFeesOwed) + surgeFeeAmount, "output fees");
+    if (mutate) {
+        input.actualBalance = new bn_js_1.default(actualInAfter.toString());
+        input.virtualBalance = new bn_js_1.default(virtualInAfter.toString());
+        output.actualBalance = new bn_js_1.default(actualOutAfter.toString());
+        output.virtualBalance = new bn_js_1.default(virtualOutAfter.toString());
+        input.protocolFeesOwed = new bn_js_1.default(inputFees.toString());
+        output.protocolFeesOwed = new bn_js_1.default(outputFees.toString());
+        if (window) {
+            input.previousSelloff = new bn_js_1.default(window.previousSelloff.toString());
+            input.currentSelloff = new bn_js_1.default(window.currentSelloff.toString());
+            input.windowStartTimestamp = new bn_js_1.default(window.windowStartTimestamp.toString());
+            input.selloffVbSnapshot = new bn_js_1.default(window.vbSnapshot.toString());
+        }
+    }
+    const spotOut = (0, cubicMath_1.calcSpotOut)({ virtualBalanceIn, virtualBalanceOut, weightInBps, weightOutBps, amountIn: amountInAfterFee });
+    // `window` is exposed for display math (post-trade fill %, span-average
+    // surge pct) — null when the input token has no sell-off cap configured.
+    return { amountOut, grossAmountOut, feeAmount, protocolFeeAmount, surgeFeeAmount, spotOut, window };
+}
+/** Clock from sync; callers may supply the transaction's expected Unix timestamp explicitly. */
+function quoteTimestamp(pool, nowSeconds) {
+    const now = nowSeconds ?? pool.chainTimestamp;
+    if (now === undefined) {
+        if (pool.tokens.some(t => t.maxSelloffPct > 0))
+            throw new Error("Chain timestamp missing: sync or supply nowSeconds");
+        return 0n;
+    }
+    if (!Number.isSafeInteger(now) || now < 0)
+        throw new Error("Invalid quote timestamp");
+    return BigInt(now);
+}
+//# sourceMappingURL=quote-math.js.map

package/dist/clients/quote-math.js.map

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

package/dist/clients/tx-builders.d.ts

@@ -0,0 +1,231 @@
+import { PublicKey, TransactionInstruction } from "@solana/web3.js";
+import BN from "bn.js";
+import { CofferConfig } from "../config";
+import { PoolInfo } from "../types/pool";
+import { AddLiquidityParams, BuiltTx, DeployPoolParams, RangeManagerUpdateParams, RemoveLiquidityParams, SetRangeManagerConfigParams, SetRangeManagerParams, SingleTokenDepositParams, SwapParams, SelloffParams } from "../types/tx";
+export declare function buildSwapIx(cfg: CofferConfig, pool: PoolInfo, params: SwapParams & {
+    minAmountOut: BN;
+}): TransactionInstruction;
+export declare function buildSwapTx(cfg: CofferConfig, pool: PoolInfo, params: SwapParams & {
+    minAmountOut: BN;
+}): BuiltTx;
+/**
+ * `add_liquidity` — proportional join.
+ *
+ * ⚠ **`params.tokenAmounts` is a CEILING, not an exact amount** (v5.1,
+ * audit M-4 / I-1). The program takes the largest strictly-proportional
+ * basket that fits inside the vector you pass and leaves the remainder in
+ * the wallet; it does NOT pull the full amounts. Any UI copy of the form
+ * "you will deposit exactly X" is wrong — quote the proportional basket
+ * instead (see `CubicPoolClient.quoteAddLiquidity`).
+ *
+ * The wire format is unchanged, so this is a behaviour note, not an
+ * encoding change: the same bytes now mean "at most this much".
+ */
+export declare function buildAddLiquidityIx(cfg: CofferConfig, pool: PoolInfo, params: AddLiquidityParams): TransactionInstruction;
+export declare function buildAddLiquidityTx(cfg: CofferConfig, pool: PoolInfo, params: AddLiquidityParams): BuiltTx;
+export declare function buildRemoveLiquidityIx(cfg: CofferConfig, pool: PoolInfo, params: RemoveLiquidityParams): TransactionInstruction;
+export declare function buildRemoveLiquidityTx(cfg: CofferConfig, pool: PoolInfo, params: RemoveLiquidityParams): BuiltTx;
+/**
+ * Largest pool the zap will accept, mirroring `STLD_MAX_TOKENS` in
+ * `single-token-liquidity/src/constants.rs` (which is defined as
+ * cubic-pool's `MAX_TOKENS`).
+ *
+ * Raised from 5 to 10 in v5.1 (audit SF-3): the old ceiling existed because
+ * the per-leg allocations exhausted the 32 KiB bump heap. Above this the
+ * program rejects with `PoolTooLargeForZap` (stld 6032).
+ */
+export declare const STLD_MAX_TOKENS = 10;
+/**
+ * Compute units to request for the zap.
+ *
+ * Measured on the v5.1 build at the worst case N=10: 1,073,206 CU for
+ * classic SPL and 913,986 CU for Token-2022. 1.4M is the per-transaction
+ * maximum and leaves headroom for the surge-fee path.
+ */
+export declare const STLD_DEPOSIT_CU_LIMIT = 1400000;
+export declare function buildSingleTokenDepositIx(cfg: CofferConfig, pool: PoolInfo, params: SingleTokenDepositParams): TransactionInstruction;
+/**
+ * The idempotent ATA creates a zap depends on: the user's and the helper's
+ * ATA for every pool token, plus both BPT ATAs. `2N + 2` instructions.
+ *
+ * The helper validates every user ATA up front because it may refund dust
+ * in any pool token, so these cannot be trimmed to just the input token.
+ */
+export declare function buildSingleTokenDepositAtaIxs(cfg: CofferConfig, pool: PoolInfo, user: PublicKey): TransactionInstruction[];
+/**
+ * Full single-token deposit in ONE transaction: idempotent ATA setup
+ * followed by the deposit itself.
+ *
+ * ⚠ **This only fits for small pools.** Two independent runtime ceilings
+ * bite as `N` grows, and neither is a byte-size problem an ALT can fix:
+ *
+ *  - `MAX_INSTRUCTION_TRACE_LENGTH = 64` counts CPI frames across the whole
+ *    transaction. One idempotent ATA create costs 5, and the v5.1 zap alone
+ *    uses 52/64 at N=10. The `2N + 2` setup instructions cost `10N + 10`
+ *    frames, so the combined transaction blows the limit well before N=10.
+ *  - Raw size at N=10 is 1796 bytes (437 with the pool's ALT), over the
+ *    1232-byte legacy ceiling.
+ *
+ * For anything but a small pool use {@link buildSingleTokenDepositTxs},
+ * which splits setup and deposit into two transactions, and compile the
+ * deposit leg through the pool's ALT via `compileBuiltTx`.
+ */
+export declare function buildSingleTokenDepositTx(cfg: CofferConfig, pool: PoolInfo, params: SingleTokenDepositParams): BuiltTx;
+/**
+ * Single-token deposit split into the two transactions large pools need.
+ *
+ * Send `setup` first and let it confirm, then send `deposit`. They are
+ * separated because the ATA creates and the zap compete for the same
+ * 64-frame instruction-trace budget (see {@link buildSingleTokenDepositTx}).
+ *
+ * `setup` is `null` when there is nothing to create — the caller can check
+ * ATA existence itself and skip the leg. Otherwise it is always safe to
+ * send: every instruction in it is idempotent.
+ *
+ * The `deposit` leg should be compiled as a v0 transaction against the
+ * pool's Address Lookup Table (`compileBuiltTx(conn, user, deposit, pool)`).
+ * At N=10 it is 1796 bytes raw and 437 with the ALT — the ALT is mandatory,
+ * not an optimisation. Note that an ALT cannot be referenced in the same
+ * slot it was extended, so a freshly-created table needs a slot to settle.
+ */
+export declare function buildSingleTokenDepositTxs(cfg: CofferConfig, pool: PoolInfo, params: SingleTokenDepositParams): {
+    setup: BuiltTx | null;
+    deposit: BuiltTx;
+};
+/**
+ * Raw `cubic_pool::initialize_config`.
+ *
+ * ⚠ **This instruction is no longer directly callable from a wallet.** In
+ * v5.1 (audit H-2) the `protocol_admin: Pubkey` ARGUMENT was removed and
+ * the Treasury PDA account became a `Signer`. The config's admin is now
+ * whoever signs, which by construction can only be protocol-admin's
+ * Treasury PDA via `invoke_signed` — no keypair exists for it.
+ *
+ * Sending this instruction from a wallet fails signature verification. The
+ * only working path is `AdminClient.poolInitializeConfigIx()`, which calls
+ * `protocol_admin::pool_initialize_config` and CPIs in here. This builder
+ * is kept so the wire format stays documented and testable, and so the
+ * treasury meta carries `isSigner: true` — Anchor derives CPI account
+ * metas from the field type, and emitting it as a non-signer would strand
+ * the outer `invoke_signed` signature.
+ */
+export declare function buildInitializeConfigIx(cfg: CofferConfig, params: {
+    config: PublicKey;
+    payer: PublicKey;
+    defaultProtocolFeeRate: number;
+}): TransactionInstruction;
+/**
+ * `protocol_admin::pool_initialize_config` — the ONLY way to create a
+ * `CubicPoolConfig` that a wallet can actually sign.
+ *
+ * `cubic_pool::initialize_config` takes the Treasury PDA as a `Signer`
+ * (audit H-01: an unauthenticated config let anyone open a pool that charged
+ * a swap fee and paid the protocol nothing). A PDA cannot sign a transaction
+ * — only the program that owns its seeds can, via `invoke_signed`. So the
+ * direct instruction is unreachable from a wallet by design, and every caller
+ * has to come through this wrapper, where the Treasury `admin` is the human
+ * signer and protocol-admin performs the CPI.
+ *
+ * Signers: `admin` (must equal `Treasury.admin`) and `config` (a freshly
+ * generated keypair — the account is `init`, not a PDA).
+ */
+export declare function buildPoolInitializeConfigIx(cfg: CofferConfig, params: {
+    config: PublicKey;
+    admin: PublicKey;
+    defaultProtocolFeeRate: number;
+}): TransactionInstruction;
+export declare function buildInitializeCubicPoolIx(cfg: CofferConfig, params: DeployPoolParams): TransactionInstruction;
+export declare function buildDeployPoolTx(cfg: CofferConfig, params: DeployPoolParams): BuiltTx;
+export interface InitializePoolAltParams {
+    /** Pool PDA. */
+    pool: PublicKey;
+    /** `CubicPoolConfig` account this pool is pinned to. Read by the
+     *  program to gate the alternative-authority path (`config.protocol_admin`). */
+    config: PublicKey;
+    /** Authority. Must equal either `pool.pool_admin` (per-pool owner
+     *  path) or `config.protocol_admin` (Treasury PDA via the
+     *  protocol-admin CPI wrapper). The ALT address is derived from
+     *  `[authority, recent_slot]`. */
+    authority: PublicKey;
+    /** Rent payer. Decoupled from `authority` so the wrapper path can
+     *  pay from a regular wallet while Treasury PDA acts as authority.
+     *  In the pool-admin path pass the same key for both. */
+    payer: PublicKey;
+    /**
+     * Recent slot. Used by the upstream ALT program to derive the table
+     * address as `[authority, recent_slot]`. Must be a slot the runtime
+     * still has in slot-hashes — caller should pass
+     * `await connection.getSlot('finalized')`.
+     */
+    recentSlot: BN;
+}
+/**
+ * Re-derives the Address Lookup Table address from `(authority, recent_slot)`
+ * the same way the upstream ALT program does.
+ *
+ * `@solana/web3.js` v1 doesn't expose `deriveLookupTableAddress` as a static,
+ * so we inline the seed derivation.
+ */
+export declare function deriveAltAddress(authority: PublicKey, recentSlot: BN): PublicKey;
+/**
+ * Build the on-chain `initialize_pool_alt` instruction. Performs three
+ * upstream CPIs inside the program: create + extend + freeze. After
+ * this ix lands, the ALT is immutable and the pool's `lookup_table`
+ * field points at it.
+ *
+ * Caller must NOT use the ALT in the same slot (warmup) — wait at
+ * least one slot before sending any v0 tx that references it.
+ */
+export declare function buildInitializePoolAltIx(cfg: CofferConfig, params: InitializePoolAltParams): TransactionInstruction;
+export declare function buildInitializePoolAltTx(cfg: CofferConfig, params: InitializePoolAltParams): BuiltTx & {
+    lookupTable: PublicKey;
+};
+/**
+ * `set_range_manager` — appoint or disable a pool's range manager.
+ *
+ * ⚠ v5.1 (audit L-1) PREPENDED a `config` account before `pool`. The
+ * account list is `[config, pool, authority]`. A client still sending
+ * `[pool, authority]` has the program read the pool account as the config
+ * and fail on the discriminator, or worse pass a lookalike.
+ *
+ * Pool admin can appoint or change the manager. The contract also accepts a
+ * config protocol-admin signer for disable-only updates that retain the current
+ * manager key; the deployed protocol-admin program has no CPI wrapper for it. Combine
+ * `newManager = PublicKey.default` with `enabled = false` for the fully
+ * disabled state.
+ */
+export declare function buildSetRangeManagerIx(cfg: CofferConfig, pool: PublicKey, params: SetRangeManagerParams): TransactionInstruction;
+/**
+ * `set_range_manager_config` — the range manager's movement envelope.
+ *
+ * v5.1 appended `max_leverage_bps` and `min_leverage_bps` to the argument
+ * list. Both are required; pass `0` to leave a bound disabled.
+ */
+export declare function buildSetRangeManagerConfigIx(cfg: CofferConfig, pool: PublicKey, params: SetRangeManagerConfigParams): TransactionInstruction;
+/**
+ * `range_manager_update` — sparse compare-and-swap over virtual balances
+ * and/or weights.
+ *
+ * Every {@link TokenChange} carries an `expectedCurrent` guard (v5.1, audit
+ * M-6). The program reverts the whole instruction with
+ * `RangeManagerStaleValue` (6061) if any entry no longer matches the stored
+ * value, so a bot MUST derive `expectedCurrent` and `newValue` from the
+ * same pool read and retry from a fresh read on failure — never re-send the
+ * same payload.
+ *
+ * The instruction also honours the pool kill switch now: it reverts while
+ * `pool_enabled` is false.
+ */
+export declare function buildRangeManagerUpdateIx(cfg: CofferConfig, pool: PublicKey, params: RangeManagerUpdateParams): TransactionInstruction;
+/** Set the pool-local swap fee (hundredths of a basis point). */
+export declare function buildSetSwapFeeRateIx(cfg: CofferConfig, pool: PublicKey, authority: PublicKey, swapFeeRate: number): TransactionInstruction;
+/** Replace every token's sell-off policy, including both kink parameters. */
+export declare function buildSetMaxSelloffIx(cfg: CofferConfig, pool: PublicKey, authority: PublicKey, params: SelloffParams[]): TransactionInstruction;
+export declare function buildInitiatePoolAdminTransferIx(cfg: CofferConfig, pool: PublicKey, authority: PublicKey, newAdmin: PublicKey): TransactionInstruction;
+export declare function buildAcceptPoolAdminTransferIx(cfg: CofferConfig, pool: PublicKey, newAdmin: PublicKey): TransactionInstruction;
+export declare function buildCancelPoolAdminTransferIx(cfg: CofferConfig, pool: PublicKey, authority: PublicKey): TransactionInstruction;
+/** Permanently renounce the pool-local admin role. */
+export declare function buildDisablePoolAdminIx(cfg: CofferConfig, pool: PublicKey, authority: PublicKey): TransactionInstruction;
+export declare function buildGetPoolInfoIx(cfg: CofferConfig, pool: PublicKey): TransactionInstruction;
+//# sourceMappingURL=tx-builders.d.ts.map

package/dist/clients/tx-builders.d.ts.map

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