@moon-cx/sdk 0.0.0-stage → 2.0.1

package/dist/core/errors.js

@@ -0,0 +1,114 @@
+/**
+ * Base class for every SDK error. Subclasses carry the numbers involved as
+ * fields, so callers can react without parsing the message.
+ */
+export class MoonError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+/** The built transaction would be rejected or would lose funds. Nothing was sent. */
+export class BuildError extends MoonError {
+}
+/** The requested pool does not exist, or its address could not be derived. */
+export class PoolNotFoundError extends MoonError {
+    assets;
+    constructor(assetA, assetB) {
+        super(`no pool for ${assetA} / ${assetB}`);
+        this.assets = [assetA, assetB];
+    }
+}
+/** The pool exists but cannot trade yet — usually no liquidity, or wallets not resolved. */
+export class PoolNotReadyError extends MoonError {
+    address;
+    reason;
+    constructor(address, reason) {
+        super(`pool ${address.toString()} is not ready: ${reason}`);
+        this.address = address;
+        this.reason = reason;
+    }
+}
+/**
+ * The attached TON would not clear an on-chain gas gate. Thrown before
+ * building: on a jetton leg the receiving pool or range throws after the
+ * jettons are credited.
+ */
+export class InsufficientGasError extends BuildError {
+    need;
+    have;
+    gate;
+    constructor(need, have, gate) {
+        super(`this operation needs at least ${need} nanotons attached, got ${have} ` +
+            `(on-chain check: ${gate})`);
+        this.need = need;
+        this.have = have;
+        this.gate = gate;
+    }
+}
+/** The amount is below a minimum enforced on chain. */
+export class AmountTooSmallError extends BuildError {
+    minimum;
+    got;
+    constructor(what, minimum, got, gate) {
+        super(`${what} must be at least ${minimum}, got ${got} (on-chain check: ${gate})`);
+        this.minimum = minimum;
+        this.got = got;
+    }
+}
+/** An on-chain limit would be exceeded: bins per position, bins per swap, range window. */
+export class LimitExceededError extends BuildError {
+    limit;
+    got;
+    constructor(what, limit, got, hint) {
+        super(`${what}: the limit is ${limit}, this request needs ${got}${hint ? `. ${hint}` : ''}`);
+        this.limit = limit;
+        this.got = got;
+    }
+}
+/** The quote moved further than the tolerance allows. */
+export class SlippageError extends MoonError {
+    expected;
+    got;
+    constructor(expected, got) {
+        super(`price moved: expected at least ${expected}, would get ${got}`);
+        this.expected = expected;
+        this.got = got;
+    }
+}
+/** On-chain state could not be read or did not parse as the expected pool, range, position or wallet. */
+export class StateError extends MoonError {
+    address;
+    constructor(address, message) {
+        super(`${address.toString()}: ${message}`);
+        this.address = address;
+    }
+}
+/** A sent message was rejected on chain. */
+export class ContractRejectedError extends MoonError {
+    exitCode;
+    queryId;
+    constructor(exitCode, description, queryId) {
+        super(`the message was rejected on chain with exit code ${exitCode}: ${description}`);
+        this.exitCode = exitCode;
+        this.queryId = queryId;
+    }
+}
+/**
+ * Plain-language descriptions of the protocol's exit codes (identical in CPMM
+ * and CLMM; pinned by the protocol drift test).
+ */
+export const EXIT_CODES = {
+    299: 'the pool or position is in a state that does not allow this — a locked position, a frozen one, or a pool with no liquidity',
+    300: 'the sender is not allowed to do this; positions only accept messages from their owner',
+    490: 'ran out of gas while executing',
+    500: 'not enough TON attached to cover the operation',
+    510: 'the amount is below the minimum the receiver accepts',
+    511: 'the swap would return nothing at this size',
+    700: 'the message body did not match what the receiver expected',
+};
+/** Turns an exit code into a sentence, falling back to the bare number. */
+export function describeExitCode(exitCode) {
+    return EXIT_CODES[exitCode] ?? `unrecognised exit code ${exitCode}`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

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

package/dist/core/fee.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Pool fee tiers in basis points, shared by the CPMM factory and mempad.
+ *
+ * The CPMM factory and mempad each enforce the list on their own; it is shared
+ * here because a launch's `feeBps` becomes the fee of the CPMM pool it
+ * graduates into.
+ *
+ * Members are named by value so a new tier never renames or reorders others.
+ * A const object, not an `enum`, because the package builds with
+ * `erasableSyntaxOnly`.
+ */
+/** The six tiers. The digits are the value: `Bps30` is `30`. */
+export declare const FeeTier: {
+    /** 0.10% — lowest fee. */
+    readonly Bps10: 10;
+    /** 0.20% — correlated pairs. */
+    readonly Bps20: 20;
+    /** 0.30% — standard, the usual choice. */
+    readonly Bps30: 30;
+    /** 0.50% — volatile pairs. */
+    readonly Bps50: 50;
+    /** 1.00% — exotic pairs. */
+    readonly Bps100: 100;
+    /** 2.00% — ultra-exotic pairs. */
+    readonly Bps200: 200;
+};
+/** Every accepted tier, in the order the factories list them. */
+export declare const FEE_BPS: readonly [10, 20, 30, 50, 100, 200];
+/**
+ * A fee tier both factories accept; anything else is `INVALID_PAYLOAD` (700).
+ * `feeBps: 30` and `FeeTier.Bps30` are the same value.
+ */
+export type FeeBps = (typeof FEE_BPS)[number];
+/** Narrows an arbitrary number to a tier, for values arriving from outside. */
+export declare function isFeeBps(value: number): value is FeeBps;
+//# sourceMappingURL=fee.d.ts.map

package/dist/core/fee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee.d.ts","sourceRoot":"","sources":["../../src/core/fee.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,gEAAgE;AAChE,eAAO,MAAM,OAAO;IAClB,0BAA0B;;IAE1B,gCAAgC;;IAEhC,0CAA0C;;IAE1C,8BAA8B;;IAE9B,4BAA4B;;IAE5B,kCAAkC;;CAE1B,CAAA;AAEV,iEAAiE;AACjE,eAAO,MAAM,OAAO,qCAOV,CAAA;AAEV;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7C,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,MAAM,CAEvD"}

package/dist/core/fee.js

@@ -0,0 +1,40 @@
+/**
+ * Pool fee tiers in basis points, shared by the CPMM factory and mempad.
+ *
+ * The CPMM factory and mempad each enforce the list on their own; it is shared
+ * here because a launch's `feeBps` becomes the fee of the CPMM pool it
+ * graduates into.
+ *
+ * Members are named by value so a new tier never renames or reorders others.
+ * A const object, not an `enum`, because the package builds with
+ * `erasableSyntaxOnly`.
+ */
+/** The six tiers. The digits are the value: `Bps30` is `30`. */
+export const FeeTier = {
+    /** 0.10% — lowest fee. */
+    Bps10: 10,
+    /** 0.20% — correlated pairs. */
+    Bps20: 20,
+    /** 0.30% — standard, the usual choice. */
+    Bps30: 30,
+    /** 0.50% — volatile pairs. */
+    Bps50: 50,
+    /** 1.00% — exotic pairs. */
+    Bps100: 100,
+    /** 2.00% — ultra-exotic pairs. */
+    Bps200: 200,
+};
+/** Every accepted tier, in the order the factories list them. */
+export const FEE_BPS = [
+    FeeTier.Bps10,
+    FeeTier.Bps20,
+    FeeTier.Bps30,
+    FeeTier.Bps50,
+    FeeTier.Bps100,
+    FeeTier.Bps200,
+];
+/** Narrows an arbitrary number to a tier, for values arriving from outside. */
+export function isFeeBps(value) {
+    return FEE_BPS.includes(value);
+}
+//# sourceMappingURL=fee.js.map

package/dist/core/fee.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee.js","sourceRoot":"","sources":["../../src/core/fee.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,0BAA0B;IAC1B,KAAK,EAAE,EAAE;IACT,gCAAgC;IAChC,KAAK,EAAE,EAAE;IACT,0CAA0C;IAC1C,KAAK,EAAE,EAAE;IACT,8BAA8B;IAC9B,KAAK,EAAE,EAAE;IACT,4BAA4B;IAC5B,MAAM,EAAE,GAAG;IACX,kCAAkC;IAClC,MAAM,EAAE,GAAG;CACH,CAAA;AAEV,iEAAiE;AACjE,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;CACN,CAAA;AAQV,+EAA+E;AAC/E,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAQ,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACvD,CAAC"}

package/dist/core/gas.d.ts

@@ -0,0 +1,112 @@
+/**
+ * TON each operation must attach, in nanotons.
+ *
+ * Too little gas on a jetton leg is not a bounce: the pool throws after the
+ * jettons are credited, and they are lost.
+ */
+/**
+ * Gas pricing from config parameter 21.
+ *
+ * `gasPrice` is nanotons per 65536 gas units, not per unit. The first
+ * `flatGasLimit` units cost a flat `flatGasPrice`; units above it cost
+ * `gasPrice / 65536` each, rounded up in total.
+ */
+export type GasPrices = {
+    /** Raw config value: nanotons per 65536 gas units. */
+    gasPrice: bigint;
+    flatGasLimit: bigint;
+    flatGasPrice: bigint;
+};
+/**
+ * Snapshot of mainnet basechain config 21 (66.667 nanotons per gas unit). The SDK
+ * does not read config 21 at runtime: if the network price changes, pass `prices`.
+ */
+export declare const MAINNET_GAS_PRICES: GasPrices;
+/** Previous mainnet basechain config 21 (400 nanotons per gas unit). */
+export declare const LEGACY_GAS_PRICES: GasPrices;
+export declare const DEFAULT_GAS_PRICES: GasPrices;
+/**
+ * TON cost of a gas budget, exactly as the node computes it:
+ * `flat_gas_price + ceil(gas_price × (used − flat_limit) / 65536)`.
+ */
+export declare function gasFee(gasUnits: bigint, prices?: GasPrices): bigint;
+/** A gas requirement and the on-chain check it mirrors. */
+export type GasRequirement = {
+    /** Minimum the receiver accepts. */
+    minimum: bigint;
+    /** What the SDK attaches: usually the minimum plus headroom. */
+    attach: bigint;
+    /** The check, in words and amounts. */
+    gate: string;
+};
+/**
+ * 0.02 TON added on top of most gates, so a message built on a threshold still
+ * clears it after storage fees or gas prices drift.
+ */
+export declare const GAS_HEADROOM = 20000000n;
+/**
+ * Native CPMM swap. What is left after gas must be at least 0.05 TON and at
+ * least the swap amount, so the floor is the larger of the two, not their sum.
+ */
+export declare function cpmmSwapTonGas(swapAmount: bigint): GasRequirement;
+/**
+ * Jetton CPMM swap: the forwarded TON amount, not the transfer's own value.
+ * Must clear both the gas gate and the 0.06 TON notification gate.
+ */
+export declare function cpmmSwapJettonForward(): GasRequirement;
+/** Minimum native deposit the pool accepts, before gas. */
+export declare const CPMM_MIN_TON_DEPOSIT = 1000000000n;
+/**
+ * Native CPMM deposit: the deposit itself plus gas on top.
+ *
+ * Exact, with no headroom: the pool deposits everything above the gas but mints
+ * LP for the smaller side, so a surplus enters the reserves without LP. Attaching
+ * less shrinks the deposit, and at the 1 TON minimum fails with LOW_AMOUNT (510).
+ */
+export declare function cpmmDepositTonGas(depositAmount: bigint): GasRequirement;
+/**
+ * CPMM jetton deposit leg: what the notification must carry. Falling short does
+ * not throw; the pool refunds the jettons minus gas.
+ */
+export declare function cpmmDepositJettonForward(): GasRequirement;
+export declare function cpmmWithdrawGas(): GasRequirement;
+/** CPMM fee collection: 0.01 TON above the withdrawal gate. */
+export declare function cpmmCollectFeesGas(): GasRequirement;
+export declare function cpmmLockGas(): GasRequirement;
+/** CLMM swap: a full gas budget plus one jetton transfer. */
+export declare function clmmSwapGas(prices?: GasPrices): GasRequirement;
+/**
+ * Native CLMM swap. What is left after gas must cover the swap and be at least
+ * 0.05 TON; otherwise the range takes the reject branch without an error.
+ */
+export declare function clmmSwapTonGas(swapAmount: bigint, prices?: GasPrices): GasRequirement;
+export declare function clmmDepositGas(prices?: GasPrices): GasRequirement;
+/** Native CLMM deposit carries the deposited TON on top of the gas. */
+export declare function clmmDepositTonGas(depositAmount: bigint, prices?: GasPrices): GasRequirement;
+/**
+ * CLMM withdrawal and fee collection: two gas budgets plus four jetton
+ * transfers.
+ */
+export declare function clmmWithdrawGas(prices?: GasPrices): GasRequirement;
+export declare const clmmCollectFeesGas: typeof clmmWithdrawGas;
+/** CLMM position lock. The handler has no gas check; the SDK still attaches enough to execute. */
+export declare function clmmLockGas(): GasRequirement;
+/**
+ * Gas for a curve buy. `minimum` is the gate; `overhead` is what the curve
+ * removes from the message before any curve arithmetic runs.
+ */
+export type MempadBuyGas = GasRequirement & {
+    /** What the curve subtracts first: `gross = msgValue − overhead`. */
+    overhead: bigint;
+};
+/**
+ * What a curve buy costs on top of the purchase. The curve computes
+ * `overhead = gasFee(buy gas) + jetton transfer reserve` at the live gas price,
+ * requires `msgValue >= overhead + minimum buy`, and spends `msgValue − overhead`.
+ * No headroom: everything attached above the overhead buys tokens, so `attach`
+ * equals `minimum`.
+ */
+export declare function mempadBuyGas(prices?: GasPrices): MempadBuyGas;
+/** Refuses to proceed when the attached value would not clear a gate. */
+export declare function assertEnoughGas(requirement: GasRequirement, attached: bigint): void;
+//# sourceMappingURL=gas.d.ts.map

package/dist/core/gas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas.d.ts","sourceRoot":"","sources":["../../src/core/gas.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAIhC,CAAA;AAED,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,EAAE,SAI/B,CAAA;AAED,eAAO,MAAM,kBAAkB,WAAqB,CAAA;AAEpD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,SAA8B,GAAG,MAAM,CAMvF;AAED,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG;IAC3B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAA;IACd,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,YAAc,CAAA;AAmCvC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAWjE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,CAYtD;AAED,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,cAAiB,CAAA;AAWlD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAQvE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,cAAc,CAOzD;AASD,wBAAgB,eAAe,IAAI,cAAc,CAOhD;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,IAAI,cAAc,CAOnD;AAED,wBAAgB,WAAW,IAAI,cAAc,CAO5C;AAoBD,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,MAAM,GAAE,SAA8B,GAAG,cAAc,CAOlF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,SAA8B,GACrC,cAAc,CAYhB;AAED,wBAAgB,cAAc,CAAC,MAAM,GAAE,SAA8B,GAAG,cAAc,CAOrF;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,SAA8B,GACrC,cAAc,CAQhB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,SAA8B,GAAG,cAAc,CAOtF;AAED,eAAO,MAAM,kBAAkB,wBAAkB,CAAA;AAEjD,kGAAkG;AAClG,wBAAgB,WAAW,IAAI,cAAc,CAG5C;AAMD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG;IAC1C,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,SAA8B,GAAG,YAAY,CAWjF;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAInF"}

package/dist/core/gas.js

@@ -0,0 +1,265 @@
+import { constantOf } from "../protocol/index.js";
+import { InsufficientGasError } from "./errors.js";
+/**
+ * Snapshot of mainnet basechain config 21 (66.667 nanotons per gas unit). The SDK
+ * does not read config 21 at runtime: if the network price changes, pass `prices`.
+ */
+export const MAINNET_GAS_PRICES = {
+    gasPrice: 4369067n,
+    flatGasLimit: 100n,
+    flatGasPrice: 6667n,
+};
+/** Previous mainnet basechain config 21 (400 nanotons per gas unit). */
+export const LEGACY_GAS_PRICES = {
+    gasPrice: 26214400n,
+    flatGasLimit: 100n,
+    flatGasPrice: 40000n,
+};
+export const DEFAULT_GAS_PRICES = MAINNET_GAS_PRICES;
+/**
+ * TON cost of a gas budget, exactly as the node computes it:
+ * `flat_gas_price + ceil(gas_price × (used − flat_limit) / 65536)`.
+ */
+export function gasFee(gasUnits, prices = DEFAULT_GAS_PRICES) {
+    if (gasUnits <= prices.flatGasLimit)
+        return prices.flatGasPrice;
+    const scaled = prices.gasPrice * (gasUnits - prices.flatGasLimit);
+    const shifted = scaled >> 16n;
+    const rounded = (scaled & 0xffffn) === 0n ? shifted : shifted + 1n;
+    return prices.flatGasPrice + rounded;
+}
+/**
+ * 0.02 TON added on top of most gates, so a message built on a threshold still
+ * clears it after storage fees or gas prices drift.
+ */
+export const GAS_HEADROOM = 20000000n;
+function withHeadroom(minimum) {
+    return minimum + GAS_HEADROOM;
+}
+// Gas UNITS, not nanotons: convert with `gasFee`. Both are bigint, so adding
+// them to nanotons type-checks and silently underfunds the jetton notification.
+const CPMM_SWAP_UNITS = constantOf('cpmm', 'GAS_TON_SWAP');
+const CPMM_JETTON_SWAP_UNITS = constantOf('cpmm', 'GAS_JETTON_SWAP');
+const CPMM_TON_DEPOSIT_UNITS = constantOf('cpmm', 'GAS_TON_DEPOSIT');
+const CPMM_JETTON_DEPOSIT_UNITS = constantOf('cpmm', 'GAS_JETTON_DEPOSIT');
+const CPMM_WITHDRAW_LIQUIDITY_UNITS = constantOf('cpmm', 'GAS_WITHDRAW_LIQUIDITY');
+const CPMM_WITHDRAW_FEES_UNITS = constantOf('cpmm', 'GAS_WITHDRAW_FEES');
+/** Reserve for one outgoing jetton transfer. */
+const CPMM_JETTON_TRANSFER = constantOf('cpmm', 'VALUE_JETTON_TRANSFER');
+/** Reserve for deploying one LP position. */
+const CPMM_DEPLOY_POSITION = constantOf('cpmm', 'VALUE_DEPLOY_POSITION');
+/** The pool charges each declared gas constant twice over. */
+const CPMM_UNITS_MULTIPLIER = 2n;
+/** CPMM gate: `gasFee(units × 2) + jetton transfer reserve × transfers + extra`. */
+function cpmmGate(units, transfers, extra = 0n) {
+    return gasFee(units * CPMM_UNITS_MULTIPLIER) + CPMM_JETTON_TRANSFER * transfers + extra;
+}
+/**
+ * The pool also requires what is left after gas to be at least 0.05 TON, or it
+ * quietly takes the reject branch instead of swapping.
+ */
+const CPMM_SWAP_REMAINDER = 50000000n;
+/**
+ * Native CPMM swap. What is left after gas must be at least 0.05 TON and at
+ * least the swap amount, so the floor is the larger of the two, not their sum.
+ */
+export function cpmmSwapTonGas(swapAmount) {
+    const required = cpmmGate(CPMM_SWAP_UNITS, 1n);
+    const remainder = swapAmount > CPMM_SWAP_REMAINDER ? swapAmount : CPMM_SWAP_REMAINDER;
+    const minimum = required + remainder;
+    return {
+        minimum,
+        attach: withHeadroom(minimum),
+        gate: `value >= ${required} (swap gas and one jetton transfer), and what remains ` +
+            `after gas must be >= max(swapAmount, ${CPMM_SWAP_REMAINDER})`,
+    };
+}
+/**
+ * Jetton CPMM swap: the forwarded TON amount, not the transfer's own value.
+ * Must clear both the gas gate and the 0.06 TON notification gate.
+ */
+export function cpmmSwapJettonForward() {
+    const required = cpmmGate(CPMM_JETTON_SWAP_UNITS, 1n);
+    const notification = 60000000n + 1n; // +1n: older pool code checks strictly greater
+    // Keep the max: which gate binds depends on gas prices.
+    const minimum = required > notification ? required : notification;
+    return {
+        minimum,
+        attach: withHeadroom(minimum),
+        gate: `forward >= ${required} (swap gas and one jetton transfer) and forward > 60000000 ` +
+            `(notification minimum)`,
+    };
+}
+/** Minimum native deposit the pool accepts, before gas. */
+export const CPMM_MIN_TON_DEPOSIT = 1000000000n;
+/**
+ * What the pool withholds from either deposit leg: deposit gas, two position
+ * deployments and 0.01 TON. Two positions, because a `split` deposit deploys one
+ * per recipient.
+ */
+function cpmmDepositRequired(units) {
+    return gasFee(units * CPMM_UNITS_MULTIPLIER) + CPMM_DEPLOY_POSITION * 2n + 10000000n;
+}
+/**
+ * Native CPMM deposit: the deposit itself plus gas on top.
+ *
+ * Exact, with no headroom: the pool deposits everything above the gas but mints
+ * LP for the smaller side, so a surplus enters the reserves without LP. Attaching
+ * less shrinks the deposit, and at the 1 TON minimum fails with LOW_AMOUNT (510).
+ */
+export function cpmmDepositTonGas(depositAmount) {
+    const required = cpmmDepositRequired(CPMM_TON_DEPOSIT_UNITS);
+    const minimum = depositAmount + required;
+    return {
+        minimum,
+        attach: minimum,
+        gate: `deposit = value − ${required} (deposit gas and position deployment) must be >= 1000000000`,
+    };
+}
+/**
+ * CPMM jetton deposit leg: what the notification must carry. Falling short does
+ * not throw; the pool refunds the jettons minus gas.
+ */
+export function cpmmDepositJettonForward() {
+    const required = cpmmDepositRequired(CPMM_JETTON_DEPOSIT_UNITS);
+    return {
+        minimum: required,
+        attach: withHeadroom(required),
+        gate: `forward >= ${required} (deposit gas and position deployment)`,
+    };
+}
+/**
+ * Attached to CPMM withdrawals and fee collection. The gates (~0.104 and
+ * ~0.114 TON) are only entry checks; onward messages and up to two jetton
+ * transfers are paid from what is attached.
+ */
+const CPMM_POSITION_ATTACH = 300000000n;
+export function cpmmWithdrawGas() {
+    const required = cpmmGate(CPMM_WITHDRAW_LIQUIDITY_UNITS, 2n);
+    return {
+        minimum: required,
+        attach: CPMM_POSITION_ATTACH,
+        gate: `value >= ${required} (withdrawal gas and two jetton transfers)`,
+    };
+}
+/** CPMM fee collection: 0.01 TON above the withdrawal gate. */
+export function cpmmCollectFeesGas() {
+    const required = cpmmGate(CPMM_WITHDRAW_FEES_UNITS, 2n, 10000000n);
+    return {
+        minimum: required,
+        attach: CPMM_POSITION_ATTACH,
+        gate: `value >= ${required} (fee collection gas, two jetton transfers and 0.01 TON)`,
+    };
+}
+export function cpmmLockGas() {
+    const minimum = 100000000n;
+    return {
+        minimum,
+        attach: withHeadroom(minimum),
+        gate: 'value >= 0.1 TON',
+    };
+}
+const CLMM_JETTON_TRANSFER = constantOf('clmm', 'VALUE_JETTON_TRANSFER');
+const CLMM_GAS_LIMIT = constantOf('clmm', 'GAS_LIMIT');
+/**
+ * Round figures attached to CLMM operations, above gates of about 0.1167,
+ * 0.2167 and 0.3333 TON at current gas prices. Unspent TON returns as excesses.
+ * The gas tests assert each figure still clears its gate.
+ */
+const CLMM_SWAP_ATTACH = 150000000n;
+const CLMM_DEPOSIT_ATTACH = 250000000n;
+const CLMM_POSITION_ATTACH = 350000000n;
+/**
+ * What must be left after gas on a native CLMM swap, beyond the swap itself.
+ * Less than 0.05 TON takes the reject branch.
+ */
+const CLMM_SWAP_REMAINDER = 50000000n;
+/** CLMM swap: a full gas budget plus one jetton transfer. */
+export function clmmSwapGas(prices = DEFAULT_GAS_PRICES) {
+    const minimum = gasFee(CLMM_GAS_LIMIT, prices) + CLMM_JETTON_TRANSFER;
+    return {
+        minimum,
+        attach: minimum > CLMM_SWAP_ATTACH ? withHeadroom(minimum) : CLMM_SWAP_ATTACH,
+        gate: `value >= ${minimum} (swap gas budget and one jetton transfer)`,
+    };
+}
+/**
+ * Native CLMM swap. What is left after gas must cover the swap and be at least
+ * 0.05 TON; otherwise the range takes the reject branch without an error.
+ */
+export function clmmSwapTonGas(swapAmount, prices = DEFAULT_GAS_PRICES) {
+    const base = clmmSwapGas(prices);
+    const remainder = swapAmount > CLMM_SWAP_REMAINDER ? swapAmount : CLMM_SWAP_REMAINDER;
+    const minimum = base.minimum + remainder;
+    return {
+        minimum,
+        // Only the gas part is rounded; the swap amount is added as is.
+        attach: base.attach + remainder,
+        gate: `value >= ${base.minimum} (swap gas budget and one jetton transfer), and what ` +
+            `remains must be >= max(swapAmount, ${CLMM_SWAP_REMAINDER})`,
+    };
+}
+export function clmmDepositGas(prices = DEFAULT_GAS_PRICES) {
+    const minimum = gasFee(CLMM_GAS_LIMIT, prices) + CLMM_JETTON_TRANSFER * 3n;
+    return {
+        minimum,
+        attach: minimum > CLMM_DEPOSIT_ATTACH ? withHeadroom(minimum) : CLMM_DEPOSIT_ATTACH,
+        gate: `value >= ${minimum} (deposit gas budget and three jetton transfers)`,
+    };
+}
+/** Native CLMM deposit carries the deposited TON on top of the gas. */
+export function clmmDepositTonGas(depositAmount, prices = DEFAULT_GAS_PRICES) {
+    const base = clmmDepositGas(prices);
+    return {
+        minimum: base.minimum + depositAmount,
+        // Only the gas part is rounded; the deposit is added as is.
+        attach: base.attach + depositAmount,
+        gate: base.gate,
+    };
+}
+/**
+ * CLMM withdrawal and fee collection: two gas budgets plus four jetton
+ * transfers.
+ */
+export function clmmWithdrawGas(prices = DEFAULT_GAS_PRICES) {
+    const minimum = gasFee(CLMM_GAS_LIMIT * 2n, prices) + CLMM_JETTON_TRANSFER * 4n;
+    return {
+        minimum,
+        attach: minimum > CLMM_POSITION_ATTACH ? withHeadroom(minimum) : CLMM_POSITION_ATTACH,
+        gate: `value >= ${minimum} (two gas budgets and four jetton transfers)`,
+    };
+}
+export const clmmCollectFeesGas = clmmWithdrawGas;
+/** CLMM position lock. The handler has no gas check; the SDK still attaches enough to execute. */
+export function clmmLockGas() {
+    const minimum = 100000000n;
+    return { minimum, attach: minimum, gate: 'no gate — the handler does not check gas' };
+}
+const MEMPAD_BUY_UNITS = constantOf('mempad', 'GAS_BUY');
+const MEMPAD_JETTON_TRANSFER = constantOf('mempad', 'VALUE_JETTON_TRANSFER');
+const MEMPAD_MIN_BUY = constantOf('mempad', 'VALUE_MIN_BUY');
+/**
+ * What a curve buy costs on top of the purchase. The curve computes
+ * `overhead = gasFee(buy gas) + jetton transfer reserve` at the live gas price,
+ * requires `msgValue >= overhead + minimum buy`, and spends `msgValue − overhead`.
+ * No headroom: everything attached above the overhead buys tokens, so `attach`
+ * equals `minimum`.
+ */
+export function mempadBuyGas(prices = DEFAULT_GAS_PRICES) {
+    const overhead = gasFee(MEMPAD_BUY_UNITS, prices) + MEMPAD_JETTON_TRANSFER;
+    const minimum = overhead + MEMPAD_MIN_BUY;
+    return {
+        overhead,
+        minimum,
+        attach: minimum,
+        gate: `value >= ${overhead} (buy gas and one jetton transfer) + ${MEMPAD_MIN_BUY} ` +
+            `(minimum buy), i.e. >= ${minimum}`,
+    };
+}
+/** Refuses to proceed when the attached value would not clear a gate. */
+export function assertEnoughGas(requirement, attached) {
+    if (attached < requirement.minimum) {
+        throw new InsufficientGasError(requirement.minimum, attached, requirement.gate);
+    }
+}
+//# sourceMappingURL=gas.js.map

package/dist/core/gas.js.map

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

package/dist/core/percent.d.ts

@@ -0,0 +1,27 @@
+/** A slippage tolerance or fee share, held as whole basis points (never a float). */
+export declare class Percent {
+    /** Basis points. 1 bps = 0.01%. 10000 bps = 100%. */
+    readonly bps: number;
+    constructor(bps: number);
+    /** `Percent.bps(50)` — half a percent. */
+    static bps(value: number): Percent;
+    /** `Percent.percent(0.5)` — the same half a percent, written the other way. */
+    static percent(value: number): Percent;
+    /**
+     * Parses a written percentage: `'0.5%'`, `'0.5'` or `'50bps'`.
+     *
+     * Refuses bare numbers, since `50` could mean bps or percent; use
+     * {@link Percent.bps} or {@link Percent.percent} instead.
+     */
+    static of(value: string | Percent): Percent;
+    static zero(): Percent;
+    isZero(): boolean;
+    /** Lower bound: what you must still accept. Rounds down, in your favour. */
+    applyDown(value: bigint): bigint;
+    /** Upper bound: the most you are willing to give. Rounds up. */
+    applyUp(value: bigint): bigint;
+    /** The share itself, rounded down: a fee of `bps` taken from `value`. */
+    of(value: bigint): bigint;
+    toString(): string;
+}
+//# sourceMappingURL=percent.d.ts.map

package/dist/core/percent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"percent.d.ts","sourceRoot":"","sources":["../../src/core/percent.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,qBAAa,OAAO;IAClB,qDAAqD;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;gBAER,GAAG,EAAE,MAAM;IAUvB,0CAA0C;IAC1C,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIlC,+EAA+E;IAC/E,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAQtC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO;IAmB3C,MAAM,CAAC,IAAI,IAAI,OAAO;IAItB,MAAM,IAAI,OAAO;IAIjB,4EAA4E;IAC5E,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhC,gEAAgE;IAChE,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAK9B,yEAAyE;IACzE,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIzB,QAAQ,IAAI,MAAM;CAGnB"}