@cubee_ee/sdk 0.1.0

package/dist/clients/PoolFactoryClient.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoolFactoryClient = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const result_1 = require("../types/result");
+const tx_builders_1 = require("./tx-builders");
+const pda_1 = require("../utils/pda");
+/**
+ * Builds transactions for protocol governance / pool deployment. Consumed
+ * by the deploy-pool UI flow and by the backend's admin tools.
+ */
+class PoolFactoryClient {
+    constructor(params) {
+        this.config = params.config;
+    }
+    /**
+     * 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) {
+        if (params.tokens.length < 2 || params.tokens.length > 10) {
+            return (0, result_1.err)("invalid_input", "tokens.length must be in [2, 10]");
+        }
+        if (params.tokens.length !== params.weightsBps.length) {
+            return (0, result_1.err)("invalid_input", "tokens/weightsBps length mismatch");
+        }
+        if (params.tokens.length !== params.virtualBalances.length) {
+            return (0, result_1.err)("invalid_input", "tokens/virtualBalances length mismatch");
+        }
+        const sum = params.weightsBps.reduce((a, b) => a + b, 0);
+        if (sum !== 10000)
+            return (0, result_1.err)("invalid_input", `weights must sum to 10000 (got ${sum})`);
+        for (const vb of params.virtualBalances) {
+            if (vb.isZero())
+                return (0, result_1.err)("invalid_input", "virtualBalances must all be > 0");
+        }
+        const [pool] = (0, pda_1.derivePoolPda)(this.config.programs.cubicPool, params.configKey, params.poolId);
+        const [bptMint] = web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("bpt_mint"), pool.toBuffer()], this.config.programs.cubicPool);
+        try {
+            const tx = (0, tx_builders_1.buildDeployPoolTx)(this.config, params);
+            return (0, result_1.ok)({ ...tx, pool, bptMint });
+        }
+        catch (e) {
+            return (0, result_1.err)("tx_build_failed", "Failed to build deploy-pool tx", e);
+        }
+    }
+    /**
+     * 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) {
+        try {
+            const configKeypair = web3_js_1.Keypair.generate();
+            const ix = (0, tx_builders_1.buildInitializeConfigIx)(this.config, {
+                config: configKeypair.publicKey,
+                payer: params.payer,
+                defaultProtocolFeeRate: params.defaultProtocolFeeRate,
+            });
+            return (0, result_1.ok)({
+                instructions: [web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: 200000 }), ix],
+                suggestedCuLimit: 200000,
+                configKeypair,
+            });
+        }
+        catch (e) {
+            return (0, result_1.err)("tx_build_failed", "Failed to build initialize_config tx", e);
+        }
+    }
+    /**
+     * 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) {
+        return (0, tx_builders_1.buildInitializeCubicPoolIx)(this.config, params);
+    }
+}
+exports.PoolFactoryClient = PoolFactoryClient;
+//# sourceMappingURL=PoolFactoryClient.js.map

package/dist/clients/PoolFactoryClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolFactoryClient.js","sourceRoot":"","sources":["../../src/clients/PoolFactoryClient.ts"],"names":[],"mappings":";;;AAAA,6CAAmG;AAGnG,4CAAqD;AAErD,+CAIuB;AACvB,sCAA6C;AAW7C;;;GAGG;AACH,MAAa,iBAAiB;IAG5B,YAAY,MAA+B;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED;;;;;;;OAOG;IACH,iBAAiB,CAAC,MAAwB;QACxC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC1D,OAAO,IAAA,YAAG,EAAC,eAAe,EAAE,kCAAkC,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YACtD,OAAO,IAAA,YAAG,EAAC,eAAe,EAAE,mCAAmC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;YAC3D,OAAO,IAAA,YAAG,EAAC,eAAe,EAAE,wCAAwC,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,IAAI,GAAG,KAAK,KAAM;YAAE,OAAO,IAAA,YAAG,EAAC,eAAe,EAAE,kCAAkC,GAAG,GAAG,CAAC,CAAC;QAC1F,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YACxC,IAAI,EAAE,CAAC,MAAM,EAAE;gBAAE,OAAO,IAAA,YAAG,EAAC,eAAe,EAAE,iCAAiC,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,GAAG,IAAA,mBAAa,EAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9F,MAAM,CAAC,OAAO,CAAC,GAAG,mBAAS,CAAC,sBAAsB,CAChD,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAC/B,CAAC;QACF,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,IAAA,+BAAiB,EAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAClD,OAAO,IAAA,WAAE,EAAC,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,IAAA,YAAG,EAAC,iBAAiB,EAAE,gCAAgC,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,uBAAuB,CAAC,MAA8B;QAGpD,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,iBAAO,CAAC,QAAQ,EAAE,CAAC;YACzC,MAAM,EAAE,GAAG,IAAA,qCAAuB,EAAC,IAAI,CAAC,MAAM,EAAE;gBAC9C,MAAM,EAAE,aAAa,CAAC,SAAS;gBAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;aACtD,CAAC,CAAC;YACH,OAAO,IAAA,WAAE,EAAC;gBACR,YAAY,EAAE,CAAC,8BAAoB,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,MAAO,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChF,gBAAgB,EAAE,MAAO;gBACzB,aAAa;aACd,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,IAAA,YAAG,EAAC,iBAAiB,EAAE,sCAAsC,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,qBAAqB,CAAC,MAAwB;QAC5C,OAAO,IAAA,wCAA0B,EAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;CACF;AA5ED,8CA4EC"}

package/dist/clients/RpcClient.d.ts

@@ -0,0 +1,28 @@
+import { Commitment, Connection, PublicKey } from "@solana/web3.js";
+import { SdkResult } from "../types/result";
+import { RetryOptions } from "../utils/retry";
+export interface RpcClientParams {
+    endpoint: string;
+    apiKey?: string;
+    commitment?: Commitment;
+    /** Optional headers (e.g. for Helius/Triton auth). */
+    headers?: Record<string, string>;
+}
+/**
+ * Thin wrapper around `@solana/web3.js` Connection with built-in retry +
+ * human-readable error mapping. Every public method returns a SdkResult<T>.
+ */
+export declare class RpcClient {
+    readonly connection: Connection;
+    private readonly defaultCommitment;
+    constructor(params: RpcClientParams);
+    call<T>(fn: (conn: Connection) => Promise<T>, retry?: RetryOptions): Promise<SdkResult<T>>;
+    getAccountInfo(pk: PublicKey, retry?: RetryOptions): Promise<SdkResult<{
+        data: Buffer;
+        owner: PublicKey;
+        lamports: number;
+    } | null>>;
+    getMultipleAccountsInfo(pks: PublicKey[], retry?: RetryOptions): Promise<SdkResult<(Buffer | null)[]>>;
+    getSlot(retry?: RetryOptions): Promise<SdkResult<number>>;
+}
+//# sourceMappingURL=RpcClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RpcClient.d.ts","sourceRoot":"","sources":["../../src/clients/RpcClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAY,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAa;gBAEnC,MAAM,EAAE,eAAe;IAWnC,IAAI,CAAC,CAAC,EACJ,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,EACpC,KAAK,GAAE,YAAiB,GACvB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAIxB,cAAc,CACZ,EAAE,EAAE,SAAS,EACb,KAAK,GAAE,YAAiB,GACvB,OAAO,CAAC,SAAS,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAYlF,uBAAuB,CACrB,GAAG,EAAE,SAAS,EAAE,EAChB,KAAK,GAAE,YAAiB,GACvB,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAOxC,OAAO,CAAC,KAAK,GAAE,YAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;CAG9D"}

package/dist/clients/RpcClient.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcClient = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const retry_1 = require("../utils/retry");
+/**
+ * Thin wrapper around `@solana/web3.js` Connection with built-in retry +
+ * human-readable error mapping. Every public method returns a SdkResult<T>.
+ */
+class RpcClient {
+    constructor(params) {
+        const endpoint = params.apiKey
+            ? appendApiKey(params.endpoint, params.apiKey)
+            : params.endpoint;
+        this.defaultCommitment = params.commitment ?? "confirmed";
+        this.connection = new web3_js_1.Connection(endpoint, {
+            commitment: this.defaultCommitment,
+            httpHeaders: params.headers,
+        });
+    }
+    call(fn, retry = {}) {
+        return (0, retry_1.safeCall)(() => fn(this.connection), retry);
+    }
+    getAccountInfo(pk, retry = {}) {
+        return (0, retry_1.safeCall)(async () => {
+            const info = await this.connection.getAccountInfo(pk, this.defaultCommitment);
+            if (!info)
+                return null;
+            return {
+                data: info.data,
+                owner: info.owner,
+                lamports: info.lamports,
+            };
+        }, retry);
+    }
+    getMultipleAccountsInfo(pks, retry = {}) {
+        return (0, retry_1.safeCall)(async () => {
+            const infos = await this.connection.getMultipleAccountsInfo(pks, this.defaultCommitment);
+            return infos.map((i) => (i ? i.data : null));
+        }, retry);
+    }
+    getSlot(retry = {}) {
+        return (0, retry_1.safeCall)(() => this.connection.getSlot(this.defaultCommitment), retry);
+    }
+}
+exports.RpcClient = RpcClient;
+function appendApiKey(endpoint, apiKey) {
+    try {
+        const u = new URL(endpoint);
+        u.searchParams.set("api-key", apiKey);
+        return u.toString();
+    }
+    catch {
+        const sep = endpoint.includes("?") ? "&" : "?";
+        return `${endpoint}${sep}api-key=${encodeURIComponent(apiKey)}`;
+    }
+}
+//# sourceMappingURL=RpcClient.js.map

package/dist/clients/RpcClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RpcClient.js","sourceRoot":"","sources":["../../src/clients/RpcClient.ts"],"names":[],"mappings":";;;AAAA,6CAAoE;AAEpE,0CAAwD;AAUxD;;;GAGG;AACH,MAAa,SAAS;IAIpB,YAAY,MAAuB;QACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM;YAC5B,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YAC9C,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACpB,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,UAAU,IAAI,WAAW,CAAC;QAC1D,IAAI,CAAC,UAAU,GAAG,IAAI,oBAAU,CAAC,QAAQ,EAAE;YACzC,UAAU,EAAE,IAAI,CAAC,iBAAiB;YAClC,WAAW,EAAE,MAAM,CAAC,OAAO;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CACF,EAAoC,EACpC,QAAsB,EAAE;QAExB,OAAO,IAAA,gBAAQ,EAAC,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,cAAc,CACZ,EAAa,EACb,QAAsB,EAAE;QAExB,OAAO,IAAA,gBAAQ,EAAC,KAAK,IAAI,EAAE;YACzB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC9E,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YACvB,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC;QACJ,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;IAED,uBAAuB,CACrB,GAAgB,EAChB,QAAsB,EAAE;QAExB,OAAO,IAAA,gBAAQ,EAAC,KAAK,IAAI,EAAE;YACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACzF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/C,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;IAED,OAAO,CAAC,QAAsB,EAAE;QAC9B,OAAO,IAAA,gBAAQ,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,CAAC;IAChF,CAAC;CACF;AAlDD,8BAkDC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,MAAc;IACpD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/C,OAAO,GAAG,QAAQ,GAAG,GAAG,WAAW,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/clients/SingleTokenDepositClient.d.ts

@@ -0,0 +1,45 @@
+import { Commitment, PublicKey } from "@solana/web3.js";
+import BN from "bn.js";
+import { CubeConfig } from "../config";
+import { PoolInfo } from "../types/pool";
+import { SdkResult } from "../types/result";
+import { BuiltTx, SingleTokenDepositParams, SingleTokenDepositQuote } from "../types/tx";
+import { RpcClient } from "./RpcClient";
+import { CubicPoolClient } from "./CubicPoolClient";
+export interface SingleTokenDepositClientParams {
+    config: CubeConfig;
+    poolAddress: PublicKey;
+    /** Optional — reuses an existing one if provided. */
+    rpc?: RpcClient | {
+        endpoint: string;
+        apiKey?: string;
+        commitment?: Commitment;
+    };
+    /**
+     * Optional parent pool client — lets the deposit client reuse an already
+     * synced PoolInfo instead of making a fresh RPC round-trip.
+     */
+    poolClient?: CubicPoolClient;
+}
+/**
+ * Convenience class that wraps the single-token deposit flow end-to-end:
+ * quoting, transaction building, and helper-PDA derivation.
+ *
+ * Most consumers don't need to instantiate this directly — they can call
+ * `CubicPoolClient.singleTokenDeposit.*` which proxies here.
+ */
+export declare class SingleTokenDepositClient {
+    readonly config: CubeConfig;
+    readonly poolAddress: PublicKey;
+    private readonly poolClient;
+    constructor(params: SingleTokenDepositClientParams);
+    /** Derived helper PDA for this pool. */
+    helperPda(): PublicKey;
+    /** Ensure pool state is loaded; populates the underlying CubicPoolClient cache. */
+    sync(): Promise<SdkResult<PoolInfo>>;
+    /** Off-chain estimate of the deposit outcome. */
+    quote(tokenInIndex: number, amountIn: BN, slippageHundredthsBps?: number): SdkResult<SingleTokenDepositQuote>;
+    /** Build a ready-to-sign transaction. Includes idempotent helper-ATA creates. */
+    buildTx(params: SingleTokenDepositParams): SdkResult<BuiltTx>;
+}
+//# sourceMappingURL=SingleTokenDepositClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SingleTokenDepositClient.d.ts","sourceRoot":"","sources":["../../src/clients/SingleTokenDepositClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAW,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,OAAO,EACP,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,SAAS,CAAC;IACvB,qDAAqD;IACrD,GAAG,CAAC,EAAE,SAAS,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,UAAU,CAAA;KAAE,CAAC;IACjF;;;OAGG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,qBAAa,wBAAwB;IACnC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;gBAEjC,MAAM,EAAE,8BAA8B;IAiBlD,wCAAwC;IACxC,SAAS,IAAI,SAAS;IAItB,mFAAmF;IAC7E,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAI1C,iDAAiD;IACjD,KAAK,CACH,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,EAAE,EACZ,qBAAqB,CAAC,EAAE,MAAM,GAC7B,SAAS,CAAC,uBAAuB,CAAC;IAIrC,iFAAiF;IACjF,OAAO,CAAC,MAAM,EAAE,wBAAwB,GAAG,SAAS,CAAC,OAAO,CAAC;CAc9D"}

package/dist/clients/SingleTokenDepositClient.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SingleTokenDepositClient = void 0;
+const result_1 = require("../types/result");
+const pda_1 = require("../utils/pda");
+const tx_builders_1 = require("./tx-builders");
+const CubicPoolClient_1 = require("./CubicPoolClient");
+/**
+ * Convenience class that wraps the single-token deposit flow end-to-end:
+ * quoting, transaction building, and helper-PDA derivation.
+ *
+ * Most consumers don't need to instantiate this directly — they can call
+ * `CubicPoolClient.singleTokenDeposit.*` which proxies here.
+ */
+class SingleTokenDepositClient {
+    constructor(params) {
+        this.config = params.config;
+        this.poolAddress = params.poolAddress;
+        this.poolClient =
+            params.poolClient ??
+                new CubicPoolClient_1.CubicPoolClient({
+                    config: params.config,
+                    poolAddress: params.poolAddress,
+                    rpc: params.rpc ??
+                        {
+                            endpoint: params.config.defaults.rpcEndpoint,
+                            commitment: params.config.defaults.rpcCommitment,
+                        },
+                });
+    }
+    /** Derived helper PDA for this pool. */
+    helperPda() {
+        return (0, pda_1.deriveHelperPda)(this.config.programs.singleTokenLiquidity, this.poolAddress)[0];
+    }
+    /** Ensure pool state is loaded; populates the underlying CubicPoolClient cache. */
+    async sync() {
+        return this.poolClient.sync();
+    }
+    /** Off-chain estimate of the deposit outcome. */
+    quote(tokenInIndex, amountIn, slippageHundredthsBps) {
+        return this.poolClient.quoteSingleTokenDeposit(tokenInIndex, amountIn, slippageHundredthsBps);
+    }
+    /** Build a ready-to-sign transaction. Includes idempotent helper-ATA creates. */
+    buildTx(params) {
+        const pool = this.poolClient.getCached();
+        if (!pool)
+            return (0, result_1.err)("invalid_input", "Call sync() first to populate pool state");
+        if (params.tokenInIndex < 0 || params.tokenInIndex >= pool.tokenCount) {
+            return (0, result_1.err)("invalid_input", "Invalid tokenInIndex");
+        }
+        if (params.amountIn.lten(0))
+            return (0, result_1.err)("invalid_input", "amountIn must be > 0");
+        try {
+            const tx = (0, tx_builders_1.buildSingleTokenDepositTx)(this.config, pool, params);
+            return (0, result_1.ok)(tx);
+        }
+        catch (e) {
+            return (0, result_1.err)("tx_build_failed", "Failed to build single-token deposit tx", e);
+        }
+    }
+}
+exports.SingleTokenDepositClient = SingleTokenDepositClient;
+//# sourceMappingURL=SingleTokenDepositClient.js.map

package/dist/clients/SingleTokenDepositClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SingleTokenDepositClient.js","sourceRoot":"","sources":["../../src/clients/SingleTokenDepositClient.ts"],"names":[],"mappings":";;;AAIA,4CAAqD;AAMrD,sCAA+C;AAC/C,+CAA0D;AAE1D,uDAAoD;AAcpD;;;;;;GAMG;AACH,MAAa,wBAAwB;IAKnC,YAAY,MAAsC;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,UAAU;YACb,MAAM,CAAC,UAAU;gBACjB,IAAI,iCAAe,CAAC;oBAClB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,GAAG,EACD,MAAM,CAAC,GAAG;wBACV;4BACE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW;4BAC5C,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa;yBACjD;iBACJ,CAAC,CAAC;IACP,CAAC;IAED,wCAAwC;IACxC,SAAS;QACP,OAAO,IAAA,qBAAe,EAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACzF,CAAC;IAED,mFAAmF;IACnF,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;IAED,iDAAiD;IACjD,KAAK,CACH,YAAoB,EACpB,QAAY,EACZ,qBAA8B;QAE9B,OAAO,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,YAAY,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IAChG,CAAC;IAED,iFAAiF;IACjF,OAAO,CAAC,MAAgC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAA,YAAG,EAAC,eAAe,EAAE,0CAA0C,CAAC,CAAC;QACnF,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,IAAI,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACtE,OAAO,IAAA,YAAG,EAAC,eAAe,EAAE,sBAAsB,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,IAAA,YAAG,EAAC,eAAe,EAAE,sBAAsB,CAAC,CAAC;QACjF,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,IAAA,uCAAyB,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAChE,OAAO,IAAA,WAAE,EAAC,EAAE,CAAC,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,IAAA,YAAG,EAAC,iBAAiB,EAAE,yCAAyC,EAAE,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;CACF;AAxDD,4DAwDC"}

package/dist/clients/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./RpcClient";
+export * from "./CubeBackendClient";
+export * from "./CubicPoolClient";
+export * from "./tx-builders";
+export * from "./SingleTokenDepositClient";
+export * from "./PoolFactoryClient";
+export * from "./AdminClient";
+//# 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,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC"}

package/dist/clients/index.js

@@ -0,0 +1,24 @@
+"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("./CubeBackendClient"), exports);
+__exportStar(require("./CubicPoolClient"), exports);
+__exportStar(require("./tx-builders"), exports);
+__exportStar(require("./SingleTokenDepositClient"), exports);
+__exportStar(require("./PoolFactoryClient"), exports);
+__exportStar(require("./AdminClient"), 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,sDAAoC;AACpC,oDAAkC;AAClC,gDAA8B;AAC9B,6DAA2C;AAC3C,sDAAoC;AACpC,gDAA8B"}

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

@@ -0,0 +1,32 @@
+import { PublicKey, TransactionInstruction } from "@solana/web3.js";
+import BN from "bn.js";
+import { CubeConfig } from "../config";
+import { PoolInfo } from "../types/pool";
+import { AddLiquidityParams, BuiltTx, DeployPoolParams, RemoveLiquidityParams, SingleTokenDepositParams, SwapParams } from "../types/tx";
+export declare function buildSwapIx(cfg: CubeConfig, pool: PoolInfo, params: SwapParams & {
+    minAmountOut: BN;
+}): TransactionInstruction;
+export declare function buildSwapTx(cfg: CubeConfig, pool: PoolInfo, params: SwapParams & {
+    minAmountOut: BN;
+}): BuiltTx;
+export declare function buildAddLiquidityIx(cfg: CubeConfig, pool: PoolInfo, params: AddLiquidityParams): TransactionInstruction;
+export declare function buildAddLiquidityTx(cfg: CubeConfig, pool: PoolInfo, params: AddLiquidityParams): BuiltTx;
+export declare function buildRemoveLiquidityIx(cfg: CubeConfig, pool: PoolInfo, params: RemoveLiquidityParams): TransactionInstruction;
+export declare function buildRemoveLiquidityTx(cfg: CubeConfig, pool: PoolInfo, params: RemoveLiquidityParams): BuiltTx;
+export declare function buildSingleTokenDepositIx(cfg: CubeConfig, pool: PoolInfo, params: SingleTokenDepositParams): TransactionInstruction;
+/**
+ * Full single-token deposit tx: makes sure helper ATAs and the user's
+ * per-token ATAs exist (idempotent create instructions), creates the user's
+ * BPT ATA if absent, then the deposit ix itself. The helper program validates
+ * all user ATAs up front because it may refund dust for any pool token.
+ * CU limit set to 1.4M (mainnet/devnet max).
+ */
+export declare function buildSingleTokenDepositTx(cfg: CubeConfig, pool: PoolInfo, params: SingleTokenDepositParams): BuiltTx;
+export declare function buildInitializeConfigIx(cfg: CubeConfig, params: {
+    config: PublicKey;
+    payer: PublicKey;
+    defaultProtocolFeeRate: number;
+}): TransactionInstruction;
+export declare function buildInitializeCubicPoolIx(cfg: CubeConfig, params: DeployPoolParams): TransactionInstruction;
+export declare function buildDeployPoolTx(cfg: CubeConfig, params: DeployPoolParams): BuiltTx;
+//# 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":"AAAA,OAAO,EAGL,SAAS,EAET,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,kBAAkB,EAClB,OAAO,EACP,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,UAAU,EACX,MAAM,aAAa,CAAC;AA6DrB,wBAAgB,WAAW,CACzB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,UAAU,GAAG;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,GACxC,sBAAsB,CAiCxB;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,UAAU,GAAG;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,GACxC,OAAO,CAQT;AAMD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,kBAAkB,GACzB,sBAAsB,CAwCxB;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAgBT;AAMD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,qBAAqB,GAC5B,sBAAsB,CAwCxB;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CA2BT;AAMD,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,wBAAwB,GAC/B,sBAAsB,CA6CxB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAwDT;AAMD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,sBAAsB,EAAE,MAAM,CAAA;CAAE,GAC9E,sBAAsB,CA4BxB;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,gBAAgB,GACvB,sBAAsB,CAuCxB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAQpF"}