@cubee_ee/sdk 0.1.8 → 0.2.1

package/dist/parsers/poolAccount.d.ts

@@ -1,32 +1,63 @@
 import { PublicKey } from "@solana/web3.js";
 import BN from "bn.js";
 /**
- * Raw binary layout of CubicPool (see
- * `contracts/programs/cubic-pool/src/state/cubic_pool.rs`). Borsh-serialised.
+ * Raw binary layout of CubicPool **v4** (see
+ * `contracts/programs/cubic-pool/src/state/cubic_pool.rs`).
  *
- * We decode manually to avoid bundling an Anchor Program instance into the
- * SDK: the SDK is consumed by both frontend and backend, where dragging a
- * full Anchor runtime is heavy. The on-chain layout is stable (reserved[128]
- * at the tail).
+ * v4 reorganised per-token data from six parallel arrays into a single
+ * `tokens: [TokenSlot; 10]` array (each slot = `AssetConfig` +
+ * `AssetDynamics`). For backwards compatibility with downstream
+ * consumers (`CubicPoolClient.sync()` and similar), this decoder still
+ * exposes the parallel-array shape, plus the new max-selloff and admin
+ * fields.
+ *
+ * We decode manually to avoid bundling an Anchor `Program` instance into
+ * the SDK — both frontend and backend consume the SDK, and pulling the
+ * full Anchor runtime is heavy. The on-chain layout is stable (trailing
+ * `reserved[64]` blob keeps room for forward extensions).
  */
 export interface RawPoolAccount {
     config: PublicKey;
     bump: number;
     tokenCount: number;
     poolId: BN;
+    swapFeeRate: number;
+    protocolFeeRate: number;
+    createdAt: BN;
+    poolEnabled: boolean;
+    swapsEnabled: boolean;
+    poolAdmin: PublicKey;
+    pendingPoolAdmin: PublicKey;
+    rangeManager: PublicKey;
+    rangeManagerEnabled: boolean;
+    rangeManagerMaxVbChangeBps: number;
+    rangeManagerMaxWeightChangeBps: number;
+    rangeManagerMinUpdateIntervalSecs: number;
+    rangeManagerLastUpdated: BN;
     tokenMints: PublicKey[];
     tokenPrograms: PublicKey[];
     normalizedWeights: BN[];
+    maxSelloff: BN[];
+    maxSelloffPeriodLength: number[];
     virtualBalances: BN[];
     actualBalances: BN[];
-    swapFeeRate: number;
-    protocolFeeRate: number;
     protocolFeesOwed: BN[];
-    createdAt: BN;
-    poolEnabled: boolean;
-    swapsEnabled: boolean;
+    previousSelloff: BN[];
+    currentSelloff: BN[];
+    windowStartTimestamp: BN[];
+    /**
+     * Per-pool Address Lookup Table. `PublicKey.default` means the pool's
+     * ALT has not been provisioned yet (`initialize_pool_alt` not called).
+     * SDK uses this to choose between v0 (with ALT) and legacy tx-building
+     * paths.
+     */
+    lookupTable: PublicKey;
 }
 /** 8-byte anchor discriminator for CubicPool. */
 export declare const POOL_DISCRIMINATOR_LEN = 8;
+/** Total on-chain size of a v4 CubicPool (includes the 8-byte discriminator). */
+export declare const POOL_V4_LEN = 1683;
+/** Pre-v4 size — accounts at this size still need `migrate_pool_v4`. */
+export declare const POOL_V3_LEN = 1154;
 export declare function decodePoolAccount(data: Buffer): RawPoolAccount;
 //# sourceMappingURL=poolAccount.d.ts.map

package/dist/parsers/poolAccount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"poolAccount.d.ts","sourceRoot":"","sources":["../../src/parsers/poolAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvB;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,EAAE,CAAC;IACX,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,iBAAiB,EAAE,EAAE,EAAE,CAAC;IACxB,eAAe,EAAE,EAAE,EAAE,CAAC;IACtB,cAAc,EAAE,EAAE,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,EAAE,EAAE,CAAC;IACvB,SAAS,EAAE,EAAE,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,iDAAiD;AACjD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAGxC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CA0E9D"}
+{"version":3,"file":"poolAccount.d.ts","sourceRoot":"","sources":["../../src/parsers/poolAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,EAAE,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,EAAE,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,SAAS,CAAC;IACrB,gBAAgB,EAAE,SAAS,CAAC;IAE5B,YAAY,EAAE,SAAS,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,0BAA0B,EAAE,MAAM,CAAC;IACnC,8BAA8B,EAAE,MAAM,CAAC;IACvC,iCAAiC,EAAE,MAAM,CAAC;IAC1C,uBAAuB,EAAE,EAAE,CAAC;IAG5B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,iBAAiB,EAAE,EAAE,EAAE,CAAC;IACxB,UAAU,EAAE,EAAE,EAAE,CAAC;IACjB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IAEjC,eAAe,EAAE,EAAE,EAAE,CAAC;IACtB,cAAc,EAAE,EAAE,EAAE,CAAC;IACrB,gBAAgB,EAAE,EAAE,EAAE,CAAC;IACvB,eAAe,EAAE,EAAE,EAAE,CAAC;IACtB,cAAc,EAAE,EAAE,EAAE,CAAC;IACrB,oBAAoB,EAAE,EAAE,EAAE,CAAC;IAE3B;;;;;OAKG;IACH,WAAW,EAAE,SAAS,CAAC;CACxB;AAED,iDAAiD;AACjD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,iFAAiF;AACjF,eAAO,MAAM,WAAW,OAAO,CAAC;AAChC,wEAAwE;AACxE,eAAO,MAAM,WAAW,OAAO,CAAC;AAEhC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAmI9D"}

package/dist/parsers/poolAccount.js

@@ -3,19 +3,28 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.POOL_DISCRIMINATOR_LEN = void 0;
+exports.POOL_V3_LEN = exports.POOL_V4_LEN = exports.POOL_DISCRIMINATOR_LEN = void 0;
 exports.decodePoolAccount = decodePoolAccount;
 const web3_js_1 = require("@solana/web3.js");
 const bn_js_1 = __importDefault(require("bn.js"));
 /** 8-byte anchor discriminator for CubicPool. */
 exports.POOL_DISCRIMINATOR_LEN = 8;
 const MAX_TOKENS = 10;
+/** Total on-chain size of a v4 CubicPool (includes the 8-byte discriminator). */
+exports.POOL_V4_LEN = 1683;
+/** Pre-v4 size — accounts at this size still need `migrate_pool_v4`. */
+exports.POOL_V3_LEN = 1154;
 function decodePoolAccount(data) {
-    if (data.length < exports.POOL_DISCRIMINATOR_LEN + 1000) {
-        throw new Error(`decodePoolAccount: data too short (${data.length} bytes)`);
+    if (data.length === exports.POOL_V3_LEN) {
+        throw new Error(`decodePoolAccount: account is at v3 size (${exports.POOL_V3_LEN}). ` +
+            `Run migrate_pool_v4 against it before calling this decoder.`);
+    }
+    if (data.length !== exports.POOL_V4_LEN) {
+        throw new Error(`decodePoolAccount: unexpected data length ${data.length} ` +
+            `(expected ${exports.POOL_V4_LEN} for v4).`);
     }
     let off = exports.POOL_DISCRIMINATOR_LEN;
-    const config = new web3_js_1.PublicKey(data.slice(off, off + 32));
+    const config = readPubkey(data, off);
     off += 32;
     const bump = data.readUInt8(off);
     off += 1;
@@ -23,66 +32,116 @@ function decodePoolAccount(data) {
     off += 1;
     const poolId = readU64LE(data, off);
     off += 8;
+    const swapFeeRate = data.readUInt32LE(off);
+    off += 4;
+    const protocolFeeRate = data.readUInt16LE(off);
+    off += 2;
+    const createdAt = readI64LE(data, off);
+    off += 8;
+    const poolEnabled = data.readUInt8(off) !== 0;
+    off += 1;
+    const swapsEnabled = data.readUInt8(off) !== 0;
+    off += 1;
+    const poolAdmin = readPubkey(data, off);
+    off += 32;
+    const pendingPoolAdmin = readPubkey(data, off);
+    off += 32;
+    const rangeManager = readPubkey(data, off);
+    off += 32;
+    const rangeManagerEnabled = data.readUInt8(off) !== 0;
+    off += 1;
+    const rangeManagerMaxVbChangeBps = data.readUInt16LE(off);
+    off += 2;
+    const rangeManagerMaxWeightChangeBps = data.readUInt16LE(off);
+    off += 2;
+    const rangeManagerMinUpdateIntervalSecs = data.readUInt32LE(off);
+    off += 4;
+    const rangeManagerLastUpdated = readI64LE(data, off);
+    off += 8;
+    // Per-token AoS — 10 slots, each 144 bytes.
     const tokenMints = [];
-    for (let i = 0; i < MAX_TOKENS; i++) {
-        tokenMints.push(new web3_js_1.PublicKey(data.slice(off, off + 32)));
-        off += 32;
-    }
     const tokenPrograms = [];
-    for (let i = 0; i < MAX_TOKENS; i++) {
-        tokenPrograms.push(new web3_js_1.PublicKey(data.slice(off, off + 32)));
-        off += 32;
-    }
     const normalizedWeights = [];
+    const maxSelloff = [];
+    const maxSelloffPeriodLength = [];
+    const virtualBalances = [];
+    const actualBalances = [];
+    const protocolFeesOwed = [];
+    const previousSelloff = [];
+    const currentSelloff = [];
+    const windowStartTimestamp = [];
     for (let i = 0; i < MAX_TOKENS; i++) {
+        // AssetConfig — 88 bytes
+        tokenMints.push(readPubkey(data, off));
+        off += 32;
+        tokenPrograms.push(readPubkey(data, off));
+        off += 32;
         normalizedWeights.push(readU64LE(data, off));
         off += 8;
-    }
-    const virtualBalances = [];
-    for (let i = 0; i < MAX_TOKENS; i++) {
+        maxSelloff.push(readU64LE(data, off));
+        off += 8;
+        maxSelloffPeriodLength.push(data.readUInt32LE(off));
+        off += 4;
+        off += 4; // AssetConfig.reserved
+        // AssetDynamics — 56 bytes
         virtualBalances.push(readU64LE(data, off));
         off += 8;
-    }
-    const actualBalances = [];
-    for (let i = 0; i < MAX_TOKENS; i++) {
         actualBalances.push(readU64LE(data, off));
         off += 8;
-    }
-    const swapFeeRate = data.readUInt32LE(off);
-    off += 4;
-    const protocolFeeRate = data.readUInt16LE(off);
-    off += 2;
-    const protocolFeesOwed = [];
-    for (let i = 0; i < MAX_TOKENS; i++) {
         protocolFeesOwed.push(readU64LE(data, off));
         off += 8;
+        previousSelloff.push(readU64LE(data, off));
+        off += 8;
+        currentSelloff.push(readU64LE(data, off));
+        off += 8;
+        windowStartTimestamp.push(readI64LE(data, off));
+        off += 8;
+        off += 8; // AssetDynamics.reserved
     }
-    const createdAt = readU64LE(data, off); // i64 — but Solana ts ≥ 0
-    off += 8;
-    const poolEnabled = data.readUInt8(off) !== 0;
-    off += 1;
-    const swapsEnabled = data.readUInt8(off) !== 0;
-    off += 1;
-    // reserved[128] trails — ignored.
+    const lookupTable = readPubkey(data, off);
+    off += 32;
+    // Trailing `reserved[32]` ignored.
     return {
         config,
         bump,
         tokenCount,
         poolId,
+        swapFeeRate,
+        protocolFeeRate,
+        createdAt,
+        poolEnabled,
+        swapsEnabled,
+        poolAdmin,
+        pendingPoolAdmin,
+        rangeManager,
+        rangeManagerEnabled,
+        rangeManagerMaxVbChangeBps,
+        rangeManagerMaxWeightChangeBps,
+        rangeManagerMinUpdateIntervalSecs,
+        rangeManagerLastUpdated,
         tokenMints,
         tokenPrograms,
         normalizedWeights,
+        maxSelloff,
+        maxSelloffPeriodLength,
         virtualBalances,
         actualBalances,
-        swapFeeRate,
-        protocolFeeRate,
         protocolFeesOwed,
-        createdAt,
-        poolEnabled,
-        swapsEnabled,
+        previousSelloff,
+        currentSelloff,
+        windowStartTimestamp,
+        lookupTable,
     };
 }
+function readPubkey(data, off) {
+    return new web3_js_1.PublicKey(data.slice(off, off + 32));
+}
 function readU64LE(data, off) {
     return new bn_js_1.default(data.slice(off, off + 8), "le");
 }
+function readI64LE(data, off) {
+    // i64 LE — for our timestamps (always ≥ 0 in practice) BN+LE matches.
+    // Returning BN keeps callers free to interpret signedness if needed.
+    return new bn_js_1.default(data.slice(off, off + 8), "le");
+}
 //# sourceMappingURL=poolAccount.js.map

package/dist/parsers/poolAccount.js.map

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

package/dist/types/pool.d.ts

@@ -48,6 +48,12 @@ export interface PoolInfo {
     poolEnabled: boolean;
     swapsEnabled: boolean;
     createdAt: number;
+    /**
+     * Per-pool Address Lookup Table. `PublicKey.default` ⇒ no ALT provisioned
+     * yet (call `initialize_pool_alt` to bootstrap). When set and non-default,
+     * v0-tx builders compress per-token accounts via this ALT.
+     */
+    lookupTable: PublicKey;
     /** Unix timestamp (ms) when sync() ran. Useful for staleness checks. */
     syncedAt: number;
 }

package/dist/types/pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/types/pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,SAAS,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,cAAc,EAAE,EAAE,CAAC;IACnB,aAAa,EAAE,EAAE,CAAC;IAClB,gBAAgB,EAAE,EAAE,CAAC;IACrB,0CAA0C;IAC1C,KAAK,EAAE,SAAS,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,OAAO,EAAE,SAAS,CAAC;IACnB,kDAAkD;IAClD,MAAM,EAAE,SAAS,CAAC;IAClB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,MAAM,EAAE,EAAE,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,OAAO,EAAE,SAAS,CAAC;IACnB,mDAAmD;IACnD,cAAc,EAAE,EAAE,CAAC;IACnB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE"}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/types/pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,SAAS,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,cAAc,EAAE,EAAE,CAAC;IACnB,aAAa,EAAE,EAAE,CAAC;IAClB,gBAAgB,EAAE,EAAE,CAAC;IACrB,0CAA0C;IAC1C,KAAK,EAAE,SAAS,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,OAAO,EAAE,SAAS,CAAC;IACnB,kDAAkD;IAClD,MAAM,EAAE,SAAS,CAAC;IAClB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,MAAM,EAAE,EAAE,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,OAAO,EAAE,SAAS,CAAC;IACnB,mDAAmD;IACnD,cAAc,EAAE,EAAE,CAAC;IACnB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,WAAW,EAAE,SAAS,CAAC;IACvB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE"}

package/dist/types/result.d.ts

@@ -17,7 +17,7 @@ export interface SdkError {
     /** Original error for debugging; never render this to end users. */
     cause?: unknown;
 }
-export type SdkErrorCode = "rpc_unavailable" | "rpc_timeout" | "rpc_rate_limited" | "account_not_found" | "invalid_input" | "math_overflow" | "parse_failure" | "backend_unavailable" | "backend_invalid_response" | "insufficient_funds" | "pool_disabled" | "swaps_disabled" | "unsupported_pool_state" | "slippage_exceeded" | "simulation_failed" | "tx_build_failed" | "unknown";
+export type SdkErrorCode = "rpc_unavailable" | "rpc_timeout" | "rpc_rate_limited" | "account_not_found" | "invalid_input" | "math_overflow" | "parse_failure" | "backend_unavailable" | "backend_invalid_response" | "insufficient_funds" | "pool_disabled" | "swaps_disabled" | "unsupported_pool_state" | "slippage_exceeded" | "simulation_failed" | "tx_build_failed" | "alt_fetch_failed" | "unknown";
 export declare const ok: <T>(data: T) => SdkResult<T>;
 export declare const err: (code: SdkErrorCode, humanMessage: string, cause?: unknown) => SdkResult<never>;
 //# sourceMappingURL=result.d.ts.map

package/dist/types/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEnC,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,IAAI,EAAE,YAAY,CAAC;IACnB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GACpB,iBAAiB,GACjB,aAAa,GACb,kBAAkB,GAClB,mBAAmB,GACnB,eAAe,GACf,eAAe,GACf,eAAe,GACf,qBAAqB,GACrB,0BAA0B,GAC1B,oBAAoB,GACpB,eAAe,GACf,gBAAgB,GAChB,wBAAwB,GACxB,mBAAmB,GACnB,mBAAmB,GACnB,iBAAiB,GACjB,SAAS,CAAC;AAEd,eAAO,MAAM,EAAE,GAAI,CAAC,EAAE,MAAM,CAAC,KAAG,SAAS,CAAC,CAAC,CAAyB,CAAC;AACrE,eAAO,MAAM,GAAG,GACd,MAAM,YAAY,EAClB,cAAc,MAAM,EACpB,QAAQ,OAAO,KACd,SAAS,CAAC,KAAK,CAGhB,CAAC"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEnC,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,IAAI,EAAE,YAAY,CAAC;IACnB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GACpB,iBAAiB,GACjB,aAAa,GACb,kBAAkB,GAClB,mBAAmB,GACnB,eAAe,GACf,eAAe,GACf,eAAe,GACf,qBAAqB,GACrB,0BAA0B,GAC1B,oBAAoB,GACpB,eAAe,GACf,gBAAgB,GAChB,wBAAwB,GACxB,mBAAmB,GACnB,mBAAmB,GACnB,iBAAiB,GACjB,kBAAkB,GAClB,SAAS,CAAC;AAEd,eAAO,MAAM,EAAE,GAAI,CAAC,EAAE,MAAM,CAAC,KAAG,SAAS,CAAC,CAAC,CAAyB,CAAC;AACrE,eAAO,MAAM,GAAG,GACd,MAAM,YAAY,EAClB,cAAc,MAAM,EACpB,QAAQ,OAAO,KACd,SAAS,CAAC,KAAK,CAGhB,CAAC"}

package/dist/types/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":";;;AAoCO,MAAM,EAAE,GAAG,CAAI,IAAO,EAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AAAxD,QAAA,EAAE,MAAsD;AAC9D,MAAM,GAAG,GAAG,CACjB,IAAkB,EAClB,YAAoB,EACpB,KAAe,EACG,EAAE,CAAC,CAAC;IACtB,EAAE,EAAE,KAAK;IACT,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE;CACrC,CAAC,CAAC;AAPU,QAAA,GAAG,OAOb"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":";;;AAqCO,MAAM,EAAE,GAAG,CAAI,IAAO,EAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AAAxD,QAAA,EAAE,MAAsD;AAC9D,MAAM,GAAG,GAAG,CACjB,IAAkB,EAClB,YAAoB,EACpB,KAAe,EACG,EAAE,CAAC,CAAC;IACtB,EAAE,EAAE,KAAK;IACT,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE;CACrC,CAAC,CAAC;AAPU,QAAA,GAAG,OAOb"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cubee_ee/sdk",
-  "version": "0.1.8",
+  "version": "0.2.1",
   "publishConfig": {
     "access": "public"
   },

package/src/clients/CubicPoolClient.ts

@@ -160,6 +160,7 @@ export class CubicPoolClient {
       poolEnabled: raw.poolEnabled,
       swapsEnabled: raw.swapsEnabled,
       createdAt: raw.createdAt.toNumber(),
+      lookupTable: raw.lookupTable,
       syncedAt: Date.now(),
     };
     this.cache = info;

package/src/clients/index.ts

@@ -2,6 +2,7 @@ export * from "./RpcClient";
 export * from "./CubeBackendClient";
 export * from "./CubicPoolClient";
 export * from "./tx-builders";
+export * from "./versioned";
 export * from "./SingleTokenDepositClient";
 export * from "./PoolFactoryClient";
 export * from "./AdminClient";

package/src/clients/tx-builders.ts

@@ -1,5 +1,6 @@
 import {
   AccountMeta,
+  AddressLookupTableProgram,
   ComputeBudgetProgram,
   PublicKey,
   SystemProgram,
@@ -34,6 +35,7 @@ const CUBIC_POOL_DISC = {
   addLiquidity: computeDiscriminator("add_liquidity"),
   removeLiquidity: computeDiscriminator("remove_liquidity"),
   initializeCubicPool: computeDiscriminator("initialize_cubic_pool"),
+  initializePoolAlt: computeDiscriminator("initialize_pool_alt"),
 };
 
 const STLD_DISC = {
@@ -62,6 +64,7 @@ function computeDiscriminator(ixName: string): Buffer {
     add_liquidity: "b59d59438fb63448",
     remove_liquidity: "5055d14818ceb16c",
     initialize_cubic_pool: "d79474cf79686f83",
+    initialize_pool_alt: "fb874202f4490c90",
     deposit_single_token: "a688a62fc7c056a9",
     initialize_config: "d07f1501c2bec446",
   };
@@ -504,6 +507,103 @@ export function buildDeployPoolTx(cfg: CubeConfig, params: DeployPoolParams): Bu
   };
 }
 
+// ============================================================
+// initialize_pool_alt — per-pool Address Lookup Table
+// ============================================================
+
+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 function deriveAltAddress(authority: PublicKey, recentSlot: BN): PublicKey {
+  const slotBuf = recentSlot.toArrayLike(Buffer, "le", 8);
+  const [addr] = PublicKey.findProgramAddressSync(
+    [authority.toBuffer(), slotBuf],
+    AddressLookupTableProgram.programId,
+  );
+  return addr;
+}
+
+/**
+ * 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 function buildInitializePoolAltIx(
+  cfg: CubeConfig,
+  params: InitializePoolAltParams,
+): TransactionInstruction {
+  const altAddr = deriveAltAddress(params.authority, params.recentSlot);
+
+  const data = Buffer.concat([
+    CUBIC_POOL_DISC.initializePoolAlt,
+    encodeU64(params.recentSlot),
+  ]);
+
+  // Account order MUST match cubic-pool's InitializePoolAlt context:
+  //   pool, config, authority, payer, lookup_table, system_program, alt_program.
+  const keys: AccountMeta[] = [
+    { pubkey: params.pool, isSigner: false, isWritable: true },
+    { pubkey: params.config, isSigner: false, isWritable: false },
+    { pubkey: params.authority, isSigner: true, isWritable: false },
+    { pubkey: params.payer, isSigner: true, isWritable: true },
+    { pubkey: altAddr, isSigner: false, isWritable: true },
+    { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
+    { pubkey: AddressLookupTableProgram.programId, isSigner: false, isWritable: false },
+  ];
+
+  return new TransactionInstruction({
+    programId: cfg.programs.cubicPool,
+    keys,
+    data,
+  });
+}
+
+export function buildInitializePoolAltTx(
+  cfg: CubeConfig,
+  params: InitializePoolAltParams,
+): BuiltTx & { lookupTable: PublicKey } {
+  return {
+    instructions: [
+      ComputeBudgetProgram.setComputeUnitLimit({ units: 200_000 }),
+      buildInitializePoolAltIx(cfg, params),
+    ],
+    suggestedCuLimit: 200_000,
+    lookupTable: deriveAltAddress(params.authority, params.recentSlot),
+  };
+}
+
 // ============================================================
 // Borsh encoding helpers (subset used above)
 // ============================================================

package/src/clients/versioned.ts

@@ -0,0 +1,80 @@
+import {
+  AddressLookupTableAccount,
+  Connection,
+  PublicKey,
+  TransactionInstruction,
+  TransactionMessage,
+  VersionedTransaction,
+} from "@solana/web3.js";
+import { PoolInfo } from "../types/pool";
+import { BuiltTx } from "../types/tx";
+import { SdkResult, err, ok } from "../types/result";
+
+/**
+ * Compile a set of instructions into a `VersionedTransaction` (v0),
+ * optionally using a per-pool Address Lookup Table to shrink the wire
+ * size below the 1232-byte legacy ceiling.
+ *
+ * ALT inclusion rules:
+ *   - If `lookupTable` is `PublicKey.default` (or undefined) → no ALT
+ *     is referenced; the tx is v0 but uses only static account keys.
+ *   - Otherwise → fetch the ALT via `connection.getAddressLookupTable`
+ *     and include it. If the fetch fails, the function returns an
+ *     `alt_fetch_failed` error rather than silently falling back.
+ *
+ * Wallets supporting the standard `signTransaction(Transaction |
+ * VersionedTransaction)` overload (Phantom, Solflare, Backpack, Glow,
+ * the wallet-adapter set since 2023) sign these without changes.
+ */
+export async function buildVersionedTx(
+  conn: Connection,
+  payer: PublicKey,
+  instructions: TransactionInstruction[],
+  lookupTable: PublicKey | undefined,
+): Promise<SdkResult<{ tx: VersionedTransaction; alts: AddressLookupTableAccount[] }>> {
+  const alts: AddressLookupTableAccount[] = [];
+
+  if (lookupTable && !lookupTable.equals(PublicKey.default)) {
+    try {
+      const res = await conn.getAddressLookupTable(lookupTable);
+      if (!res.value) {
+        return err(
+          "alt_fetch_failed",
+          `Lookup table ${lookupTable.toBase58()} not found on-chain. ` +
+            "The pool advertises an ALT but the account is missing — " +
+            "the ALT may have been closed or the RPC is stale.",
+        );
+      }
+      alts.push(res.value);
+    } catch (e) {
+      return err(
+        "alt_fetch_failed",
+        `Failed to fetch lookup table ${lookupTable.toBase58()}`,
+        e,
+      );
+    }
+  }
+
+  const { blockhash } = await conn.getLatestBlockhash("confirmed");
+  const msg = new TransactionMessage({
+    payerKey: payer,
+    recentBlockhash: blockhash,
+    instructions,
+  }).compileToV0Message(alts);
+
+  return ok({ tx: new VersionedTransaction(msg), alts });
+}
+
+/**
+ * Convenience: take a SDK-built `BuiltTx` and a pool snapshot, produce
+ * a signed-ready `VersionedTransaction`. Picks up `pool.lookupTable`
+ * automatically.
+ */
+export async function compileBuiltTx(
+  conn: Connection,
+  payer: PublicKey,
+  built: BuiltTx,
+  pool: Pick<PoolInfo, "lookupTable">,
+): Promise<SdkResult<{ tx: VersionedTransaction; alts: AddressLookupTableAccount[] }>> {
+  return buildVersionedTx(conn, payer, built.instructions, pool.lookupTable);
+}