@coffer_so/sdk 1.0.0

package/dist/utils/extensions.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_BANNED_EXTENSIONS = exports.HARD_UNSUPPORTED_MINT_EXTENSIONS = exports.MAX_KNOWN_MINT_EXTENSION = exports.MintExtension = void 0;
+exports.mintExtensionName = mintExtensionName;
+exports.parseMintExtensions = parseMintExtensions;
+exports.unsupportedMintExtensions = unsupportedMintExtensions;
+exports.bannedMintExtensions = bannedMintExtensions;
+exports.describeUnsupportedToken = describeUnsupportedToken;
+exports.assertTokensSupported = assertTokensSupported;
+/**
+ * Token-2022 mint-extension policy.
+ *
+ * The cubic-pool program moves tokens with the plain SPL `Transfer`
+ * instruction (no `transfer_checked`, no fee accounting). Token-2022 refuses
+ * a plain `Transfer` for mints that carry a transfer fee, transfer hook or
+ * pausable extension,
+ * and a `NonTransferable` mint cannot move at all — so any pool operation
+ * that touches such a token reverts inside the token program
+ * (`MintRequiredForTransfer`, error 0x1f), after the user has already paid
+ * for the transaction.
+ *
+ * The SDK therefore inspects every pool token's mint on `sync()` and refuses
+ * to quote or build a transaction that would move a token with an
+ * unsupported extension. The refusal is a normal `SdkResult` error with code
+ * `unsupported_token_extension` (or a thrown `Error` from the low-level
+ * `build*Ix` helpers).
+ */
+/** Token-2022 `ExtensionType` discriminants (u16, little-endian on the wire). */
+var MintExtension;
+(function (MintExtension) {
+    MintExtension[MintExtension["Uninitialized"] = 0] = "Uninitialized";
+    MintExtension[MintExtension["TransferFeeConfig"] = 1] = "TransferFeeConfig";
+    MintExtension[MintExtension["TransferFeeAmount"] = 2] = "TransferFeeAmount";
+    MintExtension[MintExtension["MintCloseAuthority"] = 3] = "MintCloseAuthority";
+    MintExtension[MintExtension["ConfidentialTransferMint"] = 4] = "ConfidentialTransferMint";
+    MintExtension[MintExtension["ConfidentialTransferAccount"] = 5] = "ConfidentialTransferAccount";
+    MintExtension[MintExtension["DefaultAccountState"] = 6] = "DefaultAccountState";
+    MintExtension[MintExtension["ImmutableOwner"] = 7] = "ImmutableOwner";
+    MintExtension[MintExtension["MemoTransfer"] = 8] = "MemoTransfer";
+    MintExtension[MintExtension["NonTransferable"] = 9] = "NonTransferable";
+    MintExtension[MintExtension["InterestBearingConfig"] = 10] = "InterestBearingConfig";
+    MintExtension[MintExtension["CpiGuard"] = 11] = "CpiGuard";
+    MintExtension[MintExtension["PermanentDelegate"] = 12] = "PermanentDelegate";
+    MintExtension[MintExtension["NonTransferableAccount"] = 13] = "NonTransferableAccount";
+    MintExtension[MintExtension["TransferHook"] = 14] = "TransferHook";
+    MintExtension[MintExtension["TransferHookAccount"] = 15] = "TransferHookAccount";
+    MintExtension[MintExtension["ConfidentialTransferFeeConfig"] = 16] = "ConfidentialTransferFeeConfig";
+    MintExtension[MintExtension["ConfidentialTransferFeeAmount"] = 17] = "ConfidentialTransferFeeAmount";
+    MintExtension[MintExtension["MetadataPointer"] = 18] = "MetadataPointer";
+    MintExtension[MintExtension["TokenMetadata"] = 19] = "TokenMetadata";
+    MintExtension[MintExtension["GroupPointer"] = 20] = "GroupPointer";
+    MintExtension[MintExtension["TokenGroup"] = 21] = "TokenGroup";
+    MintExtension[MintExtension["GroupMemberPointer"] = 22] = "GroupMemberPointer";
+    MintExtension[MintExtension["TokenGroupMember"] = 23] = "TokenGroupMember";
+    MintExtension[MintExtension["ConfidentialMintBurn"] = 24] = "ConfidentialMintBurn";
+    MintExtension[MintExtension["ScaledUiAmountConfig"] = 25] = "ScaledUiAmountConfig";
+    MintExtension[MintExtension["PausableConfig"] = 26] = "PausableConfig";
+    MintExtension[MintExtension["PausableAccount"] = 27] = "PausableAccount";
+    MintExtension[MintExtension["PermissionedBurn"] = 28] = "PermissionedBurn";
+})(MintExtension || (exports.MintExtension = MintExtension = {}));
+/** Highest extension discriminant accepted by the deployed cubic-pool program. */
+exports.MAX_KNOWN_MINT_EXTENSION = MintExtension.PausableAccount;
+/**
+ * Extensions the AMM can never move, whatever the pool's `banned_extensions`
+ * policy says. This is a transfer-capability check, not the mint-creation
+ * policy: even an inert TransferHook needs a mint account for plain Transfer.
+ */
+exports.HARD_UNSUPPORTED_MINT_EXTENSIONS = [
+    MintExtension.TransferFeeConfig, // Token-2022 rejects plain Transfer (needs transfer_checked_with_fee)
+    MintExtension.TransferHook, // Token-2022 rejects plain Transfer (needs transfer_checked + hook accounts)
+    MintExtension.NonTransferable, // cannot move at all
+    MintExtension.ConfidentialTransferFeeConfig, // implies a transfer fee
+    MintExtension.PausableConfig, // Token-2022 needs the mint to check the pause state
+];
+/**
+ * `DEFAULT_BANNED_EXTENSIONS` from `cubic-pool/constants.rs`: the bitmap a
+ * fresh `CubicPoolConfig` starts with. Exposed so consumers can render the
+ * policy; the per-pool effective bitmap is `PoolInfo.bannedExtensions`.
+ */
+exports.DEFAULT_BANNED_EXTENSIONS = (1n << BigInt(MintExtension.TransferFeeConfig)) |
+    (1n << BigInt(MintExtension.MintCloseAuthority)) |
+    (1n << BigInt(MintExtension.InterestBearingConfig)) |
+    (1n << BigInt(MintExtension.PermanentDelegate)) |
+    (1n << BigInt(MintExtension.TransferHook)) |
+    (1n << BigInt(MintExtension.ScaledUiAmountConfig)) |
+    (1n << BigInt(MintExtension.PausableConfig));
+/** Human-readable name for an extension discriminant. */
+function mintExtensionName(type) {
+    return MintExtension[type] ?? `Unknown(${type})`;
+}
+const MINT_BASE_LEN = 82;
+const ACCOUNT_TYPE_OFFSET = 165; // base(82) + padding to token-account size(165)
+const ACCOUNT_TYPE_MINT = 1;
+/**
+ * Parse the TLV extension list of a Token-2022 mint. Returns `[]` for a
+ * classic SPL Token mint (82 bytes) or a Token-2022 mint with no
+ * extensions. Rejects uninitialized mints, invalid mint layouts and malformed
+ * TLV data. Pool policy and transfer capability are classified separately.
+ */
+function parseMintExtensions(data) {
+    const buf = Buffer.isBuffer(data) ? data : Buffer.from(data);
+    if (buf.length !== MINT_BASE_LEN && buf.length <= ACCOUNT_TYPE_OFFSET) {
+        throw new Error(`parseMintExtensions: invalid mint length ${buf.length}`);
+    }
+    if (buf[45] !== 1) {
+        throw new Error("parseMintExtensions: mint is not initialized");
+    }
+    if (buf.length === MINT_BASE_LEN)
+        return [];
+    if (buf[ACCOUNT_TYPE_OFFSET] !== ACCOUNT_TYPE_MINT) {
+        throw new Error(`parseMintExtensions: account type byte is ${buf[ACCOUNT_TYPE_OFFSET]}, expected ${ACCOUNT_TYPE_MINT} (Mint)`);
+    }
+    const out = [];
+    let off = ACCOUNT_TYPE_OFFSET + 1;
+    while (off + 4 <= buf.length) {
+        const type = buf.readUInt16LE(off);
+        const len = buf.readUInt16LE(off + 2);
+        if (type === MintExtension.Uninitialized) {
+            if (buf.subarray(off).some((byte) => byte !== 0)) {
+                throw new Error("parseMintExtensions: nonzero data in uninitialized TLV tail");
+            }
+            return out;
+        }
+        off += 4;
+        if (off + len > buf.length) {
+            throw new Error(`parseMintExtensions: extension ${type} claims ${len} bytes past end of account`);
+        }
+        if (out.includes(type)) {
+            throw new Error(`parseMintExtensions: duplicate extension ${type}`);
+        }
+        out.push(type);
+        off += len;
+    }
+    if (buf.subarray(off).some((byte) => byte !== 0)) {
+        throw new Error("parseMintExtensions: incomplete TLV header");
+    }
+    return out;
+}
+/**
+ * Which of `extensions` the AMM cannot transfer: everything in
+ * {@link HARD_UNSUPPORTED_MINT_EXTENSIONS}, anything the program does not
+ * know (> {@link MAX_KNOWN_MINT_EXTENSION}; the program rejects unknown
+ * types at creation and the SDK cannot assume their transfer semantics).
+ *
+ * `banned_extensions` is a snapshot of creation policy, not a runtime transfer
+ * restriction. The optional second argument is retained for compatibility
+ * but does not change this result. Use `bannedMintExtensions` for diagnostics.
+ */
+function unsupportedMintExtensions(extensions, _bannedExtensions) {
+    return extensions.filter((type) => exports.HARD_UNSUPPORTED_MINT_EXTENSIONS.includes(type) || type > exports.MAX_KNOWN_MINT_EXTENSION);
+}
+/** Extensions covered by a creation-policy bitmap; does not imply transfer failure. */
+function bannedMintExtensions(extensions, bannedExtensions) {
+    const banned = bannedExtensions === undefined
+        ? 0n
+        : typeof bannedExtensions === "bigint"
+            ? bannedExtensions
+            : BigInt(bannedExtensions.toString());
+    if (banned < 0n || banned > 0xffffffffffffffffn) {
+        throw new Error("bannedMintExtensions: bitmap must fit u64");
+    }
+    return extensions.filter((type) => type >= 0 && type < 64 && ((banned >> BigInt(type)) & 1n) === 1n);
+}
+/** One-line description of why a token is refused, for error messages. */
+function describeUnsupportedToken(t) {
+    const sym = t.metadata?.symbol ?? t.mint.toBase58();
+    return `token[${t.index}] ${sym} has unsupported Token-2022 extension(s): ${(t.unsupportedExtensions ?? [])
+        .map(mintExtensionName)
+        .join(", ")}`;
+}
+/**
+ * Throw if any of the given token indices (or every token when `indices` is
+ * `"all"`) carries an unsupported extension. Used by the low-level
+ * instruction builders so that direct `build*Ix` callers get the same
+ * protection as `CubicPoolClient` users.
+ */
+function assertTokensSupported(pool, indices, op) {
+    const idx = indices === "all" ? pool.tokens.map((t) => t.index) : indices;
+    const bad = idx
+        .map((i) => pool.tokens[i])
+        .filter((t) => !!t && (t.unsupportedExtensions?.length ?? 0) > 0);
+    if (bad.length === 0)
+        return;
+    throw new Error(`${op}: unsupported Token-2022 extension for this program's transfer instructions. ` +
+        bad.map(describeUnsupportedToken).join("; "));
+}
+//# sourceMappingURL=extensions.js.map

package/dist/utils/extensions.js.map

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

package/dist/utils/index.d.ts

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

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

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

package/dist/utils/index.js

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

package/dist/utils/index.js.map

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

package/dist/utils/pda.d.ts

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

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

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

package/dist/utils/pda.js

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

package/dist/utils/pda.js.map

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

package/dist/utils/retry.d.ts

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

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

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

package/dist/utils/retry.js

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

package/dist/utils/retry.js.map

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

package/package.json

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