@cubee_ee/sdk 0.1.0

package/dist/clients/CubicPoolClient.d.ts

@@ -0,0 +1,73 @@
+import { PublicKey, Commitment } from "@solana/web3.js";
+import BN from "bn.js";
+import { CubeConfig } from "../config";
+import { PoolInfo } from "../types/pool";
+import { SdkResult } from "../types/result";
+import { SwapQuote, SingleTokenDepositQuote } from "../types/tx";
+import { CubicPoolEvent } from "../types/events";
+import { RpcClient } from "./RpcClient";
+import { AddLiquidityParams, BuiltTx, RemoveLiquidityParams, SingleTokenDepositParams, SwapParams } from "../types/tx";
+import { SingleTokenDepositClient } from "./SingleTokenDepositClient";
+export interface CubicPoolClientParams {
+    config: CubeConfig;
+    poolAddress: PublicKey;
+    rpc: RpcClient | {
+        endpoint: string;
+        apiKey?: string;
+        commitment?: Commitment;
+    };
+}
+/**
+ * Per-pool client. Fetch the state with `sync()`, then call any of the
+ * quote / buildTx methods off the cached snapshot.
+ */
+export declare class CubicPoolClient {
+    readonly config: CubeConfig;
+    readonly poolAddress: PublicKey;
+    readonly rpc: RpcClient;
+    private cache;
+    constructor(params: CubicPoolClientParams);
+    /** Last-fetched pool state. `undefined` before first `sync()`. */
+    getCached(): PoolInfo | undefined;
+    /**
+     * Fetch and decode the pool account + BPT mint + per-token mint decimals.
+     * Safe to call repeatedly; subsequent calls replace the cache.
+     */
+    sync(): Promise<SdkResult<PoolInfo>>;
+    /** Derived helper PDA for this pool (used by single-token-deposit). */
+    helperPda(): PublicKey;
+    /**
+     * Quote a swap. Requires the cache to be populated (call `sync()` first).
+     * Returns exact on-chain math result + spot bound + price impact +
+     * slippage-derived minAmountOut.
+     */
+    quoteSwap(tokenInIndex: number, tokenOutIndex: number, amountIn: BN, slippageHundredthsBps?: number): SdkResult<SwapQuote>;
+    /**
+     * Quote a single-token deposit: split amountIn by W-based shares, quote
+     * each swap leg, estimate resulting BPT.
+     */
+    quoteSingleTokenDeposit(tokenInIndex: number, amountIn: BN, slippageHundredthsBps?: number): SdkResult<SingleTokenDepositQuote>;
+    /** Proportional-withdraw quote for a given BPT amount. */
+    quoteRemove(bptIn: BN): SdkResult<{
+        tokenOuts: BN[];
+    }>;
+    /** Build a swap transaction. Requires `sync()` first. */
+    buildSwapTx(params: SwapParams): SdkResult<BuiltTx>;
+    /** Build a proportional add-liquidity transaction. Requires `sync()` first. */
+    buildAddLiquidityTx(params: AddLiquidityParams): SdkResult<BuiltTx>;
+    /** Build a proportional remove-liquidity transaction. Requires `sync()` first. */
+    buildRemoveLiquidityTx(params: RemoveLiquidityParams): SdkResult<BuiltTx>;
+    /**
+     * Build a single-token deposit transaction (swaps + add_liquidity via the
+     * helper program + BPT forward to user). Requires `sync()` first.
+     */
+    buildSingleTokenDepositTx(params: SingleTokenDepositParams): SdkResult<BuiltTx>;
+    /** Proxy into the dedicated SingleTokenDepositClient for consumers who
+     *  want the quote/build methods exposed on a focused object. */
+    get singleTokenDeposit(): SingleTokenDepositClient;
+    private _std?;
+    /** Parse logs from a confirmed transaction into typed events. */
+    parseEventsFromLogs(logs: string[]): CubicPoolEvent[];
+    private requireCache;
+}
+//# sourceMappingURL=CubicPoolClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubicPoolClient.d.ts","sourceRoot":"","sources":["../../src/clients/CubicPoolClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAiB,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,SAAS,EAAW,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoBxC,OAAO,EACL,kBAAkB,EAClB,OAAO,EACP,qBAAqB,EACrB,wBAAwB,EACxB,UAAU,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,SAAS,CAAC;IACvB,GAAG,EACC,SAAS,GACT;QACE,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,UAAU,CAAC;KACzB,CAAC;CACP;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IAExB,OAAO,CAAC,KAAK,CAAuB;gBAExB,MAAM,EAAE,qBAAqB;IAazC,kEAAkE;IAClE,SAAS,IAAI,QAAQ,GAAG,SAAS;IAIjC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAiF1C,uEAAuE;IACvE,SAAS,IAAI,SAAS;IAMtB;;;;OAIG;IACH,SAAS,CACP,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,EAAE,EACZ,qBAAqB,CAAC,EAAE,MAAM,GAC7B,SAAS,CAAC,SAAS,CAAC;IAoEvB;;;OAGG;IACH,uBAAuB,CACrB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,EAAE,EACZ,qBAAqB,CAAC,EAAE,MAAM,GAC7B,SAAS,CAAC,uBAAuB,CAAC;IAiHrC,0DAA0D;IAC1D,WAAW,CAAC,KAAK,EAAE,EAAE,GAAG,SAAS,CAAC;QAAE,SAAS,EAAE,EAAE,EAAE,CAAA;KAAE,CAAC;IA4BtD,yDAAyD;IACzD,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC;IAkBnD,+EAA+E;IAC/E,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC,OAAO,CAAC;IAanE,kFAAkF;IAClF,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,CAAC,OAAO,CAAC;IAgBzE;;;OAGG;IACH,yBAAyB,CAAC,MAAM,EAAE,wBAAwB,GAAG,SAAS,CAAC,OAAO,CAAC;IAW/E;oEACgE;IAChE,IAAI,kBAAkB,IAAI,wBAAwB,CASjD;IACD,OAAO,CAAC,IAAI,CAAC,CAA2B;IAIxC,iEAAiE;IACjE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE;IAMrD,OAAO,CAAC,YAAY;CAMrB"}

package/dist/clients/CubicPoolClient.js

@@ -0,0 +1,425 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CubicPoolClient = void 0;
+const bn_js_1 = __importDefault(require("bn.js"));
+const result_1 = require("../types/result");
+const RpcClient_1 = require("./RpcClient");
+const poolAccount_1 = require("../parsers/poolAccount");
+const mintAccount_1 = require("../parsers/mintAccount");
+const events_1 = require("../parsers/events");
+const pda_1 = require("../utils/pda");
+const tokens_1 = require("../config/tokens");
+const cubicMath_1 = require("../math/cubicMath");
+const slippage_1 = require("../math/slippage");
+const singleToken_1 = require("../math/singleToken");
+const tx_builders_1 = require("./tx-builders");
+const SingleTokenDepositClient_1 = require("./SingleTokenDepositClient");
+/**
+ * Per-pool client. Fetch the state with `sync()`, then call any of the
+ * quote / buildTx methods off the cached snapshot.
+ */
+class CubicPoolClient {
+    constructor(params) {
+        this.config = params.config;
+        this.poolAddress = params.poolAddress;
+        this.rpc =
+            params.rpc instanceof RpcClient_1.RpcClient
+                ? params.rpc
+                : new RpcClient_1.RpcClient({
+                    endpoint: params.rpc.endpoint,
+                    apiKey: params.rpc.apiKey,
+                    commitment: params.rpc.commitment ?? params.config.defaults.rpcCommitment,
+                });
+    }
+    /** Last-fetched pool state. `undefined` before first `sync()`. */
+    getCached() {
+        return this.cache;
+    }
+    /**
+     * Fetch and decode the pool account + BPT mint + per-token mint decimals.
+     * Safe to call repeatedly; subsequent calls replace the cache.
+     */
+    async sync() {
+        const poolInfo = await this.rpc.getAccountInfo(this.poolAddress);
+        if (!poolInfo.ok)
+            return poolInfo;
+        if (poolInfo.data === null) {
+            return (0, result_1.err)("account_not_found", `Pool ${this.poolAddress.toBase58()} does not exist on-chain`);
+        }
+        let raw;
+        try {
+            raw = (0, poolAccount_1.decodePoolAccount)(poolInfo.data.data);
+        }
+        catch (e) {
+            return (0, result_1.err)("parse_failure", "Could not decode pool account", e);
+        }
+        const n = raw.tokenCount;
+        const mintAddrs = raw.tokenMints.slice(0, n);
+        const [bptMint, _bptBump] = (0, pda_1.deriveBptMint)(this.config.programs.cubicPool, this.poolAddress);
+        const mintInfos = await this.rpc.getMultipleAccountsInfo([bptMint, ...mintAddrs]);
+        if (!mintInfos.ok)
+            return mintInfos;
+        const [bptMintData, ...tokenMintDatas] = mintInfos.data;
+        if (!bptMintData) {
+            return (0, result_1.err)("account_not_found", "BPT mint account missing");
+        }
+        let bptMintAcc;
+        try {
+            bptMintAcc = (0, mintAccount_1.decodeMintAccount)(bptMintData);
+        }
+        catch (e) {
+            return (0, result_1.err)("parse_failure", "Could not decode BPT mint", e);
+        }
+        const tokens = [];
+        for (let i = 0; i < n; i++) {
+            const mintRaw = tokenMintDatas[i];
+            if (!mintRaw) {
+                return (0, result_1.err)("account_not_found", `Mint account missing for token index ${i}`);
+            }
+            let mintAcc;
+            try {
+                mintAcc = (0, mintAccount_1.decodeMintAccount)(mintRaw);
+            }
+            catch (e) {
+                return (0, result_1.err)("parse_failure", `Could not decode mint ${mintAddrs[i].toBase58()}`, e);
+            }
+            const actualBalance = raw.actualBalances[i];
+            const virtualBalance = raw.virtualBalances[i];
+            const concentration = virtualBalance.isZero() ? 0 : actualBalance.mul(new bn_js_1.default(1000000)).div(virtualBalance).toNumber() / 1000000;
+            tokens.push({
+                index: i,
+                mint: raw.tokenMints[i],
+                tokenProgram: raw.tokenPrograms[i],
+                decimals: mintAcc.decimals,
+                weightBps: raw.normalizedWeights[i].toNumber(),
+                virtualBalance,
+                actualBalance,
+                protocolFeesOwed: raw.protocolFeesOwed[i],
+                vault: (0, pda_1.deriveAta)(this.poolAddress, raw.tokenMints[i], raw.tokenPrograms[i]),
+                metadata: this.config.tokens?.[raw.tokenMints[i].toBase58()] ??
+                    (0, tokens_1.resolveKnownToken)(raw.tokenMints[i].toBase58()),
+                concentration,
+            });
+        }
+        const info = {
+            address: this.poolAddress,
+            config: raw.config,
+            bump: raw.bump,
+            poolId: raw.poolId,
+            tokenCount: n,
+            tokens,
+            bptMint,
+            bptTotalSupply: bptMintAcc.supply,
+            swapFeeRate: raw.swapFeeRate,
+            protocolFeeRate: raw.protocolFeeRate,
+            poolEnabled: raw.poolEnabled,
+            swapsEnabled: raw.swapsEnabled,
+            createdAt: raw.createdAt.toNumber(),
+            syncedAt: Date.now(),
+        };
+        this.cache = info;
+        return (0, result_1.ok)(info);
+    }
+    /** Derived helper PDA for this pool (used by single-token-deposit). */
+    helperPda() {
+        return (0, pda_1.deriveHelperPda)(this.config.programs.singleTokenLiquidity, this.poolAddress)[0];
+    }
+    // ---------- Quote helpers (pure, require sync()) ----------
+    /**
+     * Quote a swap. Requires the cache to be populated (call `sync()` first).
+     * Returns exact on-chain math result + spot bound + price impact +
+     * slippage-derived minAmountOut.
+     */
+    quoteSwap(tokenInIndex, tokenOutIndex, amountIn, slippageHundredthsBps) {
+        const pool = this.requireCache();
+        if (!pool.ok)
+            return pool;
+        const { tokens, swapFeeRate, protocolFeeRate } = pool.data;
+        if (tokenInIndex < 0 ||
+            tokenInIndex >= tokens.length ||
+            tokenOutIndex < 0 ||
+            tokenOutIndex >= tokens.length ||
+            tokenInIndex === tokenOutIndex) {
+            return (0, result_1.err)("invalid_input", "Invalid tokenInIndex / tokenOutIndex");
+        }
+        const inTok = tokens[tokenInIndex];
+        const outTok = tokens[tokenOutIndex];
+        const slip = slippageHundredthsBps ?? this.config.defaults.slippageHundredthsBps;
+        try {
+            const amountBI = BigInt(amountIn.toString());
+            const amountAfterFee = (0, slippage_1.applySwapFee)(amountBI, swapFeeRate);
+            const feeAmount = amountBI - amountAfterFee;
+            const protocolFeeAmount = (feeAmount * BigInt(protocolFeeRate)) / BigInt(10000);
+            // Mirror cubic-pool's swap.rs: raw virtual balances drive the math,
+            // lp_actual_out caps the output amount. Using lp_virtual here would
+            // diverge from the on-chain quote on pools with pending protocol fees.
+            const virtIn = BigInt(inTok.virtualBalance.toString());
+            const virtOut = BigInt(outTok.virtualBalance.toString());
+            const actualOut = BigInt(outTok.actualBalance.toString());
+            const pfoOut = BigInt(outTok.protocolFeesOwed.toString());
+            const lpActualOut = actualOut > pfoOut ? actualOut - pfoOut : 0n;
+            const amountOut = (0, cubicMath_1.calcOutGivenIn)({
+                virtualBalanceIn: virtIn,
+                weightInBps: BigInt(inTok.weightBps),
+                virtualBalanceOut: virtOut,
+                weightOutBps: BigInt(outTok.weightBps),
+                amountIn: amountAfterFee,
+                actualBalanceOut: lpActualOut,
+            });
+            const spotOut = (0, cubicMath_1.calcSpotOut)({
+                virtualBalanceIn: virtIn,
+                weightInBps: BigInt(inTok.weightBps),
+                virtualBalanceOut: virtOut,
+                weightOutBps: BigInt(outTok.weightBps),
+                amountIn: amountAfterFee,
+            });
+            const minAmountOut = (0, slippage_1.applySlippage)(amountOut, slip);
+            const impact = (0, slippage_1.priceImpactHbps)(spotOut, amountOut);
+            return (0, result_1.ok)({
+                tokenInIndex,
+                tokenOutIndex,
+                amountIn,
+                amountOut: new bn_js_1.default(amountOut.toString()),
+                spotOut: new bn_js_1.default(spotOut.toString()),
+                priceImpactHbps: impact,
+                feeAmount: new bn_js_1.default(feeAmount.toString()),
+                protocolFeeAmount: new bn_js_1.default(protocolFeeAmount.toString()),
+                minAmountOut: new bn_js_1.default(minAmountOut.toString()),
+            });
+        }
+        catch (e) {
+            return (0, result_1.err)("math_overflow", "Swap quote math overflow", e);
+        }
+    }
+    /**
+     * Quote a single-token deposit: split amountIn by W-based shares, quote
+     * each swap leg, estimate resulting BPT.
+     */
+    quoteSingleTokenDeposit(tokenInIndex, amountIn, slippageHundredthsBps) {
+        const poolRes = this.requireCache();
+        if (!poolRes.ok)
+            return poolRes;
+        const pool = poolRes.data;
+        if (tokenInIndex < 0 || tokenInIndex >= pool.tokens.length) {
+            return (0, result_1.err)("invalid_input", "Invalid tokenInIndex");
+        }
+        const inTok = pool.tokens[tokenInIndex];
+        if (inTok.actualBalance.isZero()) {
+            return (0, result_1.err)("invalid_input", "Input token is sidelined (actualBalance=0); pick a live token");
+        }
+        const slip = slippageHundredthsBps ?? this.config.defaults.slippageHundredthsBps;
+        try {
+            const actualBalances = pool.tokens.map((t) => BigInt(t.actualBalance.toString()));
+            const virtualBalances = pool.tokens.map((t) => BigInt(t.virtualBalance.toString()));
+            const protocolFeesOwed = pool.tokens.map((t) => BigInt(t.protocolFeesOwed.toString()));
+            const weightsBps = pool.tokens.map((t) => t.weightBps);
+            const amountInBI = BigInt(amountIn.toString());
+            // Mirror the helper contract: weight by LP-accessible balances
+            // (actual - protocolFeesOwed). This avoids the heavy 2-token optimizer
+            // which used to live here but exceeded the program's BPF CU budget.
+            const lpAccessibleBalances = actualBalances.map((actual, i) => actual > protocolFeesOwed[i] ? actual - protocolFeesOwed[i] : 0n);
+            const alloc = (0, singleToken_1.computeAllocations)({
+                actualBalances: lpAccessibleBalances,
+                virtualBalances,
+                weightsBps,
+                amountIn: amountInBI,
+                tokenInIndex,
+            });
+            const expectedOuts = [];
+            const minOuts = [];
+            const sidelined = [];
+            const simActual = [...actualBalances];
+            const simVirtual = [...virtualBalances];
+            const simProtocolFees = [...protocolFeesOwed];
+            const depositAmounts = pool.tokens.map(() => 0n);
+            let remainingInput = amountInBI;
+            for (let i = 0; i < pool.tokens.length; i++) {
+                if (actualBalances[i] === 0n) {
+                    sidelined.push(i);
+                    expectedOuts.push(new bn_js_1.default(0));
+                    minOuts.push(new bn_js_1.default(0));
+                    continue;
+                }
+                if (i === tokenInIndex || alloc.allocations[i] === 0n) {
+                    expectedOuts.push(new bn_js_1.default(0));
+                    minOuts.push(new bn_js_1.default(0));
+                    continue;
+                }
+                const swapAmount = alloc.allocations[i];
+                remainingInput -= swapAmount;
+                const amountAfterFee = (0, slippage_1.applySwapFee)(swapAmount, pool.swapFeeRate);
+                const feeAmount = swapAmount - amountAfterFee;
+                const protocolFeeAmount = (feeAmount * BigInt(pool.protocolFeeRate)) / 10000n;
+                // Match cubic-pool/swap.rs exactly: it uses RAW virtual balances and
+                // takes lp_actual_out only as the output cap. Earlier the SDK used
+                // LP-virtuals here (and the helper did too), causing slippage drift
+                // on pools with pending protocol fees.
+                const lpActualOut = simActual[i] > simProtocolFees[i] ? simActual[i] - simProtocolFees[i] : 0n;
+                const out = (0, cubicMath_1.calcOutGivenIn)({
+                    virtualBalanceIn: simVirtual[tokenInIndex],
+                    weightInBps: BigInt(weightsBps[tokenInIndex]),
+                    virtualBalanceOut: simVirtual[i],
+                    weightOutBps: BigInt(weightsBps[i]),
+                    amountIn: amountAfterFee,
+                    actualBalanceOut: lpActualOut,
+                });
+                const min = (0, slippage_1.applySlippage)(out > 0n ? out - 1n : 0n, slip);
+                expectedOuts.push(new bn_js_1.default(out.toString()));
+                minOuts.push(new bn_js_1.default(min.toString()));
+                simActual[tokenInIndex] += swapAmount;
+                simVirtual[tokenInIndex] += amountAfterFee;
+                simProtocolFees[tokenInIndex] += protocolFeeAmount;
+                simActual[i] -= out;
+                simVirtual[i] -= out;
+                depositAmounts[i] = out;
+            }
+            depositAmounts[tokenInIndex] = remainingInput;
+            const capped = (0, singleToken_1.capDepositAmountsToLpRatio)({
+                helperBalances: depositAmounts,
+                actualBalances: simActual,
+                protocolFeesOwed: simProtocolFees,
+            });
+            const estBpt = (0, cubicMath_1.calcBptOutGivenExactTokensIn)(capped.lpBalancesForAdd, capped.depositAmounts, BigInt(pool.bptTotalSupply.toString()));
+            return (0, result_1.ok)({
+                tokenInIndex,
+                amountIn,
+                allocations: alloc.allocations.map((b) => new bn_js_1.default(b.toString())),
+                expectedOuts,
+                minOuts,
+                depositedAmounts: capped.depositAmounts.map((b) => new bn_js_1.default(b.toString())),
+                refundAmounts: capped.refundAmounts.map((b) => new bn_js_1.default(b.toString())),
+                estimatedBpt: new bn_js_1.default(estBpt.toString()),
+                sidelinedTokenIndices: sidelined,
+            });
+        }
+        catch (e) {
+            return (0, result_1.err)("math_overflow", "Single-token deposit quote failed", e);
+        }
+    }
+    /** Proportional-withdraw quote for a given BPT amount. */
+    quoteRemove(bptIn) {
+        const poolRes = this.requireCache();
+        if (!poolRes.ok)
+            return poolRes;
+        const pool = poolRes.data;
+        if (pool.bptTotalSupply.isZero()) {
+            return (0, result_1.err)("invalid_input", "Pool has zero BPT supply");
+        }
+        try {
+            // Match cubic-pool/remove_liquidity.rs exactly: it computes
+            // token_amounts as `actual_balances[i] * bpt_amount / bpt_supply`
+            // against the raw stored actual (no protocol-fee subtraction). Use
+            // the same input here so the SDK quote equals what the contract
+            // actually transfers.
+            const bals = pool.tokens.map((t) => BigInt(t.actualBalance.toString()));
+            const outs = (0, cubicMath_1.calcTokensOutGivenBptIn)(bals, BigInt(bptIn.toString()), BigInt(pool.bptTotalSupply.toString()));
+            return (0, result_1.ok)({ tokenOuts: outs.map((o) => new bn_js_1.default(o.toString())) });
+        }
+        catch (e) {
+            return (0, result_1.err)("math_overflow", "Remove quote failed", e);
+        }
+    }
+    // ---------- Transaction builders ----------
+    //
+    // For external SDK users, deposit/swap/remove are one-call operations via
+    // the CubicPoolClient. The `singleTokenDeposit` field is a proxy into the
+    // dedicated SingleTokenDepositClient as the user expects: importing this
+    // class is enough, no need to know the helper program exists.
+    /** Build a swap transaction. Requires `sync()` first. */
+    buildSwapTx(params) {
+        const poolRes = this.requireCache();
+        if (!poolRes.ok)
+            return poolRes;
+        const slip = params.slippageHundredthsBps ?? this.config.defaults.slippageHundredthsBps;
+        const minOut = params.minAmountOut
+            ? params.minAmountOut
+            : (() => {
+                const q = this.quoteSwap(params.tokenInIndex, params.tokenOutIndex, params.amountIn, slip);
+                return q.ok ? q.data.minAmountOut : new bn_js_1.default(0);
+            })();
+        try {
+            const tx = (0, tx_builders_1.buildSwapTx)(this.config, poolRes.data, { ...params, minAmountOut: minOut });
+            return (0, result_1.ok)(tx);
+        }
+        catch (e) {
+            return (0, result_1.err)("tx_build_failed", "Failed to build swap tx", e);
+        }
+    }
+    /** Build a proportional add-liquidity transaction. Requires `sync()` first. */
+    buildAddLiquidityTx(params) {
+        const poolRes = this.requireCache();
+        if (!poolRes.ok)
+            return poolRes;
+        if (params.tokenAmounts.length !== poolRes.data.tokenCount) {
+            return (0, result_1.err)("invalid_input", "tokenAmounts length must equal pool.tokenCount");
+        }
+        try {
+            return (0, result_1.ok)((0, tx_builders_1.buildAddLiquidityTx)(this.config, poolRes.data, params));
+        }
+        catch (e) {
+            return (0, result_1.err)("tx_build_failed", "Failed to build add_liquidity tx", e);
+        }
+    }
+    /** Build a proportional remove-liquidity transaction. Requires `sync()` first. */
+    buildRemoveLiquidityTx(params) {
+        const poolRes = this.requireCache();
+        if (!poolRes.ok)
+            return poolRes;
+        if (params.minimumTokenAmounts &&
+            params.minimumTokenAmounts.length !== poolRes.data.tokenCount) {
+            return (0, result_1.err)("invalid_input", "minimumTokenAmounts length must equal pool.tokenCount");
+        }
+        try {
+            return (0, result_1.ok)((0, tx_builders_1.buildRemoveLiquidityTx)(this.config, poolRes.data, params));
+        }
+        catch (e) {
+            return (0, result_1.err)("tx_build_failed", "Failed to build remove_liquidity tx", e);
+        }
+    }
+    /**
+     * Build a single-token deposit transaction (swaps + add_liquidity via the
+     * helper program + BPT forward to user). Requires `sync()` first.
+     */
+    buildSingleTokenDepositTx(params) {
+        const poolRes = this.requireCache();
+        if (!poolRes.ok)
+            return poolRes;
+        if (params.amountIn.lten(0))
+            return (0, result_1.err)("invalid_input", "amountIn must be > 0");
+        try {
+            return (0, result_1.ok)((0, tx_builders_1.buildSingleTokenDepositTx)(this.config, poolRes.data, params));
+        }
+        catch (e) {
+            return (0, result_1.err)("tx_build_failed", "Failed to build single-token deposit tx", e);
+        }
+    }
+    /** Proxy into the dedicated SingleTokenDepositClient for consumers who
+     *  want the quote/build methods exposed on a focused object. */
+    get singleTokenDeposit() {
+        if (!this._std) {
+            this._std = new SingleTokenDepositClient_1.SingleTokenDepositClient({
+                config: this.config,
+                poolAddress: this.poolAddress,
+                poolClient: this,
+            });
+        }
+        return this._std;
+    }
+    // ---------- Event helpers ----------
+    /** Parse logs from a confirmed transaction into typed events. */
+    parseEventsFromLogs(logs) {
+        return (0, events_1.parseCubicPoolEvents)(logs);
+    }
+    // ---------- Internals ----------
+    requireCache() {
+        if (!this.cache) {
+            return (0, result_1.err)("invalid_input", "Call `sync()` first to populate pool state");
+        }
+        return (0, result_1.ok)(this.cache);
+    }
+}
+exports.CubicPoolClient = CubicPoolClient;
+//# sourceMappingURL=CubicPoolClient.js.map

package/dist/clients/CubicPoolClient.js.map

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

package/dist/clients/PoolFactoryClient.d.ts

@@ -0,0 +1,45 @@
+import { Keypair, PublicKey, TransactionInstruction } from "@solana/web3.js";
+import { CubeConfig } from "../config";
+import { SdkResult } from "../types/result";
+import { BuiltTx, DeployPoolParams } from "../types/tx";
+export interface PoolFactoryClientParams {
+    config: CubeConfig;
+}
+export interface InitializeConfigParams {
+    payer: PublicKey;
+    defaultProtocolFeeRate: number;
+}
+/**
+ * Builds transactions for protocol governance / pool deployment. Consumed
+ * by the deploy-pool UI flow and by the backend's admin tools.
+ */
+export declare class PoolFactoryClient {
+    readonly config: CubeConfig;
+    constructor(params: PoolFactoryClientParams);
+    /**
+     * Deploy a new pool atop an existing `CubicPoolConfig`. Caller is
+     * responsible for funding `params.payer` with enough SOL to cover rent
+     * for the pool account and the BPT mint PDA.
+     *
+     * Returns the `pool` and `bptMint` pubkeys it WILL create (derived PDAs)
+     * plus the signable tx.
+     */
+    buildDeployPoolTx(params: DeployPoolParams): SdkResult<BuiltTx & {
+        pool: PublicKey;
+        bptMint: PublicKey;
+    }>;
+    /**
+     * Initialize a new CubicPoolConfig. The `config` signer must be freshly
+     * generated and paired with its keypair when signing the outer tx.
+     * Returns the tx + the config keypair the caller should sign with.
+     */
+    buildInitializeConfigTx(params: InitializeConfigParams): SdkResult<BuiltTx & {
+        configKeypair: Keypair;
+    }>;
+    /**
+     * Low-level: return the raw `initialize_cubic_pool` ix without a CU
+     * budget or wrapping. Useful for combining with other ixs in the same tx.
+     */
+    initializeCubicPoolIx(params: DeployPoolParams): TransactionInstruction;
+}
+//# sourceMappingURL=PoolFactoryClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PoolFactoryClient.d.ts","sourceRoot":"","sources":["../../src/clients/PoolFactoryClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEnG,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAW,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQxD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,SAAS,CAAC;IACjB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;gBAEhB,MAAM,EAAE,uBAAuB;IAI3C;;;;;;;OAOG;IACH,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC,OAAO,GAAG;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,SAAS,CAAA;KAAE,CAAC;IA6BzG;;;;OAIG;IACH,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,GAAG,SAAS,CAChE,OAAO,GAAG;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,CACrC;IAkBD;;;OAGG;IACH,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,sBAAsB;CAGxE"}