@moon-cx/sdk 0.0.0-stage → 2.0.1

package/dist/api/index.js

@@ -0,0 +1,364 @@
+import { Address } from '@ton/core';
+import { Asset } from "../core/asset.js";
+import { MoonError } from "../core/errors.js";
+import { listedAsset } from "../pool/assets.js";
+export class MoonApiError extends MoonError {
+    status;
+    /** The response's `Retry-After`, in milliseconds; `null` when it sent none. */
+    retryAfterMs;
+    /** The response body as text, cut to 2000 characters. */
+    body;
+    /**
+     * `true` for a 503 or 429: the same request is expected to succeed later. Check this
+     * (or `instanceof PoolIndexWarmingError`) rather than a particular status.
+     */
+    retryable;
+    constructor(path, status, body, retryAfterMs = null) {
+        super(`GET ${path} failed with ${status}: ${body.slice(0, 200)}`);
+        this.status = status;
+        this.retryAfterMs = retryAfterMs;
+        this.body = body.slice(0, 2000);
+        this.retryable = status === 503 || status === 429;
+    }
+}
+/**
+ * The backend has not finished listing pools of a protocol you asked for. Retryable:
+ * wait `retryAfterMs` (5 s when the backend does not say) and call again.
+ *
+ * Thrown instead of returning a shorter list, which would look like "no pool for this
+ * pair". Covers both a 503 from a per-protocol route and `incompleteTypes` in a 200 from
+ * `GET /v1/pools`; `status` is 503 in both cases (the 200 is visible in `body`).
+ * `load('cpmm')` still works while only CLMM is being listed.
+ */
+export class PoolIndexWarmingError extends MoonApiError {
+    /** Always `true`: this condition clears by itself; retry after `retryAfterMs`. */
+    retryable = true;
+    /** The protocols that are not listed yet — the ones you asked for. */
+    incomplete;
+    constructor(path, body, incomplete, retryAfterMs) {
+        // At least 1 s, so `Retry-After: 0` does not make a retry loop spin.
+        super(path, 503, body, Math.max(POOL_INDEX_MIN_RETRY_MS, retryAfterMs ?? POOL_INDEX_RETRY_MS));
+        this.incomplete = incomplete;
+        this.message =
+            `GET ${path}: the pool index is still listing ${incomplete.join(' and ') || 'pools'} ` +
+                `— a partial list would hide existing pools; retry in ${Math.ceil(this.retryAfterMs / 1000)} s`;
+    }
+}
+/** How long to wait when the backend warms up without saying: its own Retry-After is 5 s. */
+const POOL_INDEX_RETRY_MS = 5_000;
+/** The shortest wait a warm-up error suggests, whatever the backend said. */
+const POOL_INDEX_MIN_RETRY_MS = 1_000;
+/** A 503 from the pool index warming up, as opposed to "service busy" or a proxy page. */
+function isPoolIndexWarming(error) {
+    return error.status === 503 && /pool index is warming up/i.test(error.body);
+}
+/** `Retry-After` → milliseconds: delta-seconds or an HTTP date; anything else is `null`. */
+function retryAfterMsOf(value) {
+    if (value === null || value.trim() === '')
+        return null;
+    const seconds = Number(value);
+    if (Number.isFinite(seconds))
+        return seconds >= 0 ? seconds * 1000 : null;
+    const at = Date.parse(value);
+    return Number.isFinite(at) ? Math.max(0, at - Date.now()) : null;
+}
+const NATIVE_ADDRESSES = new Set(['TON', 'GRAM', 'native', '']);
+function toAddress(value) {
+    if (typeof value !== 'string' || NATIVE_ADDRESSES.has(value))
+        return null;
+    try {
+        return Address.parse(value);
+    }
+    catch {
+        return null;
+    }
+}
+function toToken(raw) {
+    return {
+        symbol: String(raw['symbol'] ?? ''),
+        name: String(raw['name'] ?? raw['symbol'] ?? ''),
+        address: toAddress(raw['address']),
+        decimals: Number(raw['decimals'] ?? 9),
+    };
+}
+function toNumberOrNull(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+export class MoonApi {
+    baseUrl;
+    doFetch;
+    timeoutMs;
+    constructor(options = {}) {
+        // The public gateway; api.moon.cx is a different service and answers 404 on these routes.
+        this.baseUrl = (options.baseUrl ?? 'https://gw.moon.cx').replace(/\/+$/, '');
+        this.doFetch = options.fetch ?? globalThis.fetch;
+        this.timeoutMs = options.timeoutMs ?? 15_000;
+    }
+    async get(path) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await this.doFetch(`${this.baseUrl}${path}`, {
+                signal: controller.signal,
+                headers: { accept: 'application/json' },
+            });
+            if (!response.ok) {
+                throw new MoonApiError(path, response.status, await response.text(), 
+                // `?.`: a custom `fetch` stub may return a response without `headers`.
+                retryAfterMsOf(response.headers?.get?.('retry-after') ?? null));
+            }
+            return await response.json();
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * Fetches the pool listing once and returns it indexed for in-memory lookups.
+     * Call {@link PoolList.refresh} for fresh numbers.
+     *
+     * The list is always complete for the protocols asked for; while the backend is
+     * still listing one of them this throws {@link PoolIndexWarmingError} (retryable).
+     */
+    async load(protocol) {
+        return new PoolList(this, protocol, await this.fetchPools(protocol));
+    }
+    /**
+     * One raw fetch of the listing as a plain array. Prefer {@link load} rather than
+     * calling this per lookup.
+     */
+    async fetchPools(protocol) {
+        const path = protocol === 'cpmm' ? '/v1/pools/cpmm' : protocol === 'clmm' ? '/v1/pools/clmm' : '/v1/pools';
+        const asked = protocol === undefined ? ['cpmm', 'clmm'] : [protocol];
+        let payload;
+        try {
+            payload = (await this.get(path));
+        }
+        catch (error) {
+            // Other 503s stay a plain MoonApiError (still retryable).
+            if (error instanceof MoonApiError && isPoolIndexWarming(error)) {
+                throw new PoolIndexWarmingError(path, error.body, asked, error.retryAfterMs);
+            }
+            throw error;
+        }
+        // Only incomplete protocols that were asked for count; unknown names are ignored.
+        const incomplete = Array.isArray(payload.incompleteTypes)
+            ? asked.filter((kind) => payload.incompleteTypes.some((t) => String(t).toLowerCase() === kind))
+            : [];
+        if (incomplete.length > 0) {
+            throw new PoolIndexWarmingError(path, `incompleteTypes: ${JSON.stringify(payload.incompleteTypes)}`, incomplete, null);
+        }
+        const result = [];
+        for (const group of payload.groups ?? []) {
+            const g = group;
+            for (const pool of g['pools'] ?? []) {
+                const p = pool;
+                const address = toAddress(p['id']);
+                if (address === null)
+                    continue;
+                const kind = String(p['type'] ?? g['type'] ?? '').toLowerCase();
+                if (kind !== 'cpmm' && kind !== 'clmm')
+                    continue;
+                result.push({
+                    address,
+                    protocol: kind,
+                    tokens: {
+                        x: toToken((p['token0'] ?? g['token0'] ?? {})),
+                        y: toToken((p['token1'] ?? g['token1'] ?? {})),
+                    },
+                    feeBps: Number(p['feeBps'] ?? 0),
+                    protocolFeeBps: toNumberOrNull(p['protocolFeeBps']),
+                    totalFeeBps: toNumberOrNull(p['totalFeeBps']),
+                    binStep: p['binStep'] === null || p['binStep'] === undefined ? null : Number(p['binStep']),
+                    tvlUsd: toNumberOrNull(p['tvlUsd']),
+                    volume24hUsd: toNumberOrNull(p['volume24hUsd']),
+                    aprPct: toNumberOrNull(p['aprPct']),
+                    price: toNumberOrNull(p['price']),
+                });
+            }
+        }
+        return result;
+    }
+    /**
+     * The deployment's network and DEX factory addresses (GET /v1/config). `Moon` asks
+     * once, when a create* call needs a factory and none was given.
+     */
+    async config() {
+        const raw = (await this.get('/v1/config'));
+        return {
+            network: typeof raw['network'] === 'string' ? raw['network'] : null,
+            cpmmFactory: toAddress(raw['cpmmFactory']),
+            clmmFactory: toAddress(raw['clmmFactory']),
+            jackpot: toAddress(raw['jackpotAddress']),
+        };
+    }
+    /** The launch factory (GET /v1/mempad/launches/config); a separate service from {@link config}. */
+    async mempadConfig() {
+        const raw = (await this.get('/v1/mempad/launches/config'));
+        return {
+            network: typeof raw['network'] === 'string' ? raw['network'] : null,
+            factory: toAddress(raw['factoryAddress']),
+        };
+    }
+    /**
+     * A wallet's positions in one request. The records are pointers: open them with
+     * `range.positionAt()` and read the real numbers on chain.
+     */
+    async positionsOf(wallet, options) {
+        const owner = typeof wallet === 'string' ? wallet : wallet.toString();
+        const query = options?.pool === undefined
+            ? ''
+            : `?pool_id=${encodeURIComponent(typeof options.pool === 'string' ? options.pool : options.pool.toString())}`;
+        const payload = (await this.get(`/v1/wallets/${encodeURIComponent(owner)}/positions${query}`));
+        const result = [];
+        for (const entry of payload.positions ?? []) {
+            const p = entry;
+            const address = toAddress(p['id']);
+            const pool = toAddress(p['poolId']);
+            if (address === null || pool === null)
+                continue;
+            const kind = String(p['type'] ?? '').toLowerCase();
+            if (kind !== 'cpmm' && kind !== 'clmm')
+                continue;
+            const binLow = toNumberOrNull(p['binIdLow']);
+            const binHigh = toNumberOrNull(p['binIdHigh']);
+            const priceLow = toNumberOrNull(p['priceLow']);
+            const priceHigh = toNumberOrNull(p['priceHigh']);
+            result.push({
+                address,
+                nftIndex: p['nftIndex'] === null || p['nftIndex'] === undefined
+                    ? null
+                    : BigInt(String(p['nftIndex'])),
+                pool,
+                protocol: kind,
+                status: String(p['status'] ?? 'unknown'),
+                bins: binLow !== null && binHigh !== null ? { low: binLow, high: binHigh } : null,
+                prices: priceLow !== null && priceHigh !== null ? { low: priceLow, high: priceHigh } : null,
+                liquidityUsd: toNumberOrNull(p['liquidityUsd']),
+                feesUsd: toNumberOrNull(p['feesUsd']),
+                aprPct: toNumberOrNull(p['aprPct']),
+            });
+        }
+        return new WalletPositions(result);
+    }
+}
+/**
+ * A wallet's positions, split by protocol: a CPMM position is one per pool, while a
+ * wallet can hold many CLMM positions per range.
+ */
+export class WalletPositions {
+    /** Every position, in the order the backend returned them. */
+    all;
+    cpmm;
+    clmm;
+    constructor(positions) {
+        this.all = positions;
+        this.cpmm = positions.filter((position) => position.protocol === 'cpmm');
+        this.clmm = positions.filter((position) => position.protocol === 'clmm');
+    }
+    get size() {
+        return this.all.length;
+    }
+    /** Positions in one pool. */
+    inPool(pool) {
+        const address = typeof pool === 'string' ? Address.parse(pool) : pool;
+        return this.all.filter((position) => position.pool.equals(address));
+    }
+    /** Positions the backend still considers open. */
+    active() {
+        // `active` is accepted from older or custom backends.
+        return this.all.filter((position) => position.status === 'in-range' || position.status === 'out-range' || position.status === 'active');
+    }
+}
+/** Identity of an asset as a listing key. */
+function assetKey(asset) {
+    return asset.isNative() ? 'native' : asset.master.toRawString();
+}
+function tokenKey(token) {
+    return token.address === null ? 'native' : token.address.toRawString();
+}
+/** Unordered pair key, so TON/USDT and USDT/TON land in the same bucket. */
+function pairKey(one, two) {
+    return one < two ? `${one}|${two}` : `${two}|${one}`;
+}
+/** The pool listing, fetched once and queried in memory; only {@link refresh} hits the network. */
+export class PoolList {
+    /** Every pool in the listing, in the order the backend returned them. */
+    pools;
+    /** Unix milliseconds when this listing was fetched. */
+    fetchedAt;
+    #api;
+    #protocol;
+    #byAddress = new Map();
+    #byPair = new Map();
+    constructor(api, protocol, pools) {
+        this.#api = api;
+        this.#protocol = protocol;
+        this.pools = pools;
+        this.fetchedAt = Date.now();
+        for (const pool of pools) {
+            this.#byAddress.set(pool.address.toRawString(), pool);
+            const key = pairKey(tokenKey(pool.tokens.x), tokenKey(pool.tokens.y));
+            const bucket = this.#byPair.get(key);
+            if (bucket)
+                bucket.push(pool);
+            else
+                this.#byPair.set(key, [pool]);
+        }
+        for (const bucket of this.#byPair.values()) {
+            bucket.sort((one, two) => (two.tvlUsd ?? 0) - (one.tvlUsd ?? 0));
+        }
+    }
+    get size() {
+        return this.pools.length;
+    }
+    /** How long ago this listing was fetched, in milliseconds. */
+    get ageMs() {
+        return Date.now() - this.fetchedAt;
+    }
+    /** Every pool, optionally narrowed to one protocol. */
+    all(protocol) {
+        return protocol === undefined
+            ? [...this.pools]
+            : this.pools.filter((pool) => pool.protocol === protocol);
+    }
+    byAddress(address) {
+        const key = typeof address === 'string' ? Address.parse(address) : address;
+        return this.#byAddress.get(key.toRawString()) ?? null;
+    }
+    /** Pools holding both assets, deepest first. Pure lookup, no request. */
+    find(a, b, protocol) {
+        const bucket = this.#byPair.get(pairKey(assetKey(a), assetKey(b))) ?? [];
+        return protocol === undefined ? [...bucket] : bucket.filter((p) => p.protocol === protocol);
+    }
+    /** The deepest pool for a pair, or `null`. */
+    best(a, b, protocol) {
+        return this.find(a, b, protocol)[0] ?? null;
+    }
+    /** Every asset that appears in the listing, as {@link Asset} objects. */
+    assets() {
+        const seen = new Map();
+        for (const pool of this.pools) {
+            const { x, y } = assetsOf(pool);
+            seen.set(assetKey(x), x);
+            seen.set(assetKey(y), y);
+        }
+        return [...seen.values()];
+    }
+    /** Fetches the listing again and returns a new list. This one is unchanged. */
+    async refresh() {
+        return this.#api.load(this.#protocol);
+    }
+}
+/**
+ * Turns a listing entry into SDK assets with the listing's decimals. A pool opened with
+ * them, on a client that cannot read jetton metadata, reports `'listed'` in
+ * `pool.decimalsSource` and takes amounts on that side only as raw `bigint`.
+ */
+export function assetsOf(pool) {
+    const build = (token) => token.address === null
+        ? Asset.native()
+        : listedAsset(Asset.jetton(token.address, { decimals: token.decimals, symbol: token.symbol }));
+    return { x: build(pool.tokens.x), y: build(pool.tokens.y) };
+}
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

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

package/dist/codec/bins.d.ts

@@ -0,0 +1,26 @@
+import { Dictionary, type Cell } from '@ton/core';
+/**
+ * One bin's share of a CLMM deposit: how much of each side goes into it.
+ * `DepositBin { x: coins, y: coins }` in the protocol.
+ */
+export type DepositBin = {
+    /** Bin index. Signed — a live pool sits at a negative index as often as not. */
+    binId: number;
+    x: bigint;
+    y: bigint;
+};
+/** Builds the deposit dictionary. Duplicate bins are a mistake, not a merge. */
+export declare function depositBinsToDict(bins: readonly DepositBin[]): Dictionary<bigint, {
+    x: bigint;
+    y: bigint;
+}>;
+/** Builds the withdraw dictionary: which bins to take liquidity out of. */
+export declare function binFlagsToDict(binIds: readonly number[]): Dictionary<bigint, boolean>;
+export declare function parseDepositBins(cell: Cell | null): DepositBin[];
+export declare function parseBinFlags(cell: Cell | null): number[];
+/** Totals per side, used to fill `depositAmount` and to pick the leg. */
+export declare function sumBins(bins: readonly DepositBin[]): {
+    x: bigint;
+    y: bigint;
+};
+//# sourceMappingURL=bins.d.ts.map

package/dist/codec/bins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bins.d.ts","sourceRoot":"","sources":["../../src/codec/bins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAkD,KAAK,IAAI,EAAE,MAAM,WAAW,CAAA;AAEjG;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAA;IACb,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV,CAAA;AAwBD,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAa3G;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAUrF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,UAAU,EAAE,CAIhE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EAAE,CAGzD;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK7E"}

package/dist/codec/bins.js

@@ -0,0 +1,67 @@
+import { Dictionary } from '@ton/core';
+/** Bin indices are signed 64-bit keys: pools priced below 1 sit at negative bins. */
+const KEY = Dictionary.Keys.BigInt(64);
+const DEPOSIT_BIN = {
+    serialize: (src, builder) => {
+        builder.storeCoins(src.x);
+        builder.storeCoins(src.y);
+    },
+    parse: (slice) => ({ x: slice.loadCoins(), y: slice.loadCoins() }),
+};
+/**
+ * A `map<int64, bool>` leaf is a single bit. The receiver reads only the keys,
+ * but the bit still has to be there for the cell to parse.
+ */
+const BIN_FLAG = {
+    serialize: (src, builder) => {
+        builder.storeBit(src);
+    },
+    parse: (slice) => slice.loadBit(),
+};
+/** Builds the deposit dictionary. Duplicate bins are a mistake, not a merge. */
+export function depositBinsToDict(bins) {
+    const dict = Dictionary.empty(KEY, DEPOSIT_BIN);
+    const seen = new Set();
+    for (const bin of bins) {
+        if (!Number.isInteger(bin.binId)) {
+            throw new TypeError(`bin index must be a whole number, got ${bin.binId}`);
+        }
+        if (seen.has(bin.binId))
+            throw new TypeError(`bin ${bin.binId} appears twice`);
+        if (bin.x < 0n || bin.y < 0n)
+            throw new TypeError(`bin ${bin.binId} has a negative amount`);
+        seen.add(bin.binId);
+        dict.set(BigInt(bin.binId), { x: bin.x, y: bin.y });
+    }
+    return dict;
+}
+/** Builds the withdraw dictionary: which bins to take liquidity out of. */
+export function binFlagsToDict(binIds) {
+    const dict = Dictionary.empty(KEY, BIN_FLAG);
+    const seen = new Set();
+    for (const binId of binIds) {
+        if (!Number.isInteger(binId))
+            throw new TypeError(`bin index must be a whole number, got ${binId}`);
+        if (seen.has(binId))
+            throw new TypeError(`bin ${binId} appears twice`);
+        seen.add(binId);
+        dict.set(BigInt(binId), true);
+    }
+    return dict;
+}
+export function parseDepositBins(cell) {
+    if (cell === null)
+        return [];
+    const dict = Dictionary.loadDirect(KEY, DEPOSIT_BIN, cell);
+    return [...dict].map(([binId, value]) => ({ binId: Number(binId), x: value.x, y: value.y }));
+}
+export function parseBinFlags(cell) {
+    if (cell === null)
+        return [];
+    return [...Dictionary.loadDirect(KEY, BIN_FLAG, cell).keys()].map(Number);
+}
+/** Totals per side, used to fill `depositAmount` and to pick the leg. */
+export function sumBins(bins) {
+    return bins.reduce((total, bin) => ({ x: total.x + bin.x, y: total.y + bin.y }), { x: 0n, y: 0n });
+}
+//# sourceMappingURL=bins.js.map

package/dist/codec/bins.js.map

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

package/dist/codec/clmm.d.ts

@@ -0,0 +1,87 @@
+import { Address, type Cell } from '@ton/core';
+import { type DepositBin } from './bins.ts';
+/** Field order this codec writes. Checked against the protocol by the drift test. */
+export declare const CLMM_LAYOUTS: {
+    readonly MsgCreatePool: readonly ["queryId", "xMaster", "yMaster", "binStep", "initBin"];
+    readonly MsgSwap: readonly ["queryId", "swapParams"];
+    readonly TonSwapParams: readonly ["swapAmount", "excess", "sqrtPriceLimit", "nextFulfill", "nextReject"];
+    readonly JettonSwapPayload: readonly ["swapParams"];
+    readonly JettonSwapParams: readonly ["excess", "sqrtPriceLimit", "nextFulfill", "nextReject"];
+    readonly MsgDepositLiquidity: readonly ["queryId", "depositAmount", "isSingle", "depositBins"];
+    readonly JettonDepositLiquidityPayload: readonly ["isSingle", "depositBins"];
+    readonly MsgWithdrawLiqudity: readonly ["queryId", "withdrawBins"];
+    readonly MsgWithdrawFees: readonly ["queryId"];
+    readonly MsgLockLiquidity: readonly ["queryId"];
+};
+export type ClmmSwapParams = {
+    swapAmount: bigint;
+    /** Where leftover TON goes. Sits before the price limit — omitting it shifts every later byte. */
+    excess: Address;
+    /**
+     * Price bound as a Q128 square root: CLMM bounds a swap by price, not by
+     * output. Zero means no bound, which is rarely what you want on a live pool.
+     */
+    sqrtPriceLimit: bigint;
+    nextFulfill?: Cell | null;
+    nextReject?: Cell | null;
+};
+/** `MsgSwap` — native TON leg. Sent to the range, not to the pool. */
+export declare function encodeSwap(args: {
+    queryId: bigint;
+} & ClmmSwapParams): Cell;
+/** `JettonSwapPayload` — jetton leg. No query id, no amount: both come from the transfer. */
+export declare function encodeJettonSwapPayload(args: Omit<ClmmSwapParams, 'swapAmount'>): Cell;
+/**
+ * `MsgCreatePool`.
+ *
+ * `initBin` is signed: a pool priced below 1 starts at a negative index.
+ * `binStep` is in basis points and the factory only accepts 25, 50, 100 or 200.
+ */
+export declare function encodeCreatePool(args: {
+    queryId: bigint;
+    xMaster: Address | null;
+    yMaster: Address | null;
+    binStep: number;
+    initBin: number;
+}): Cell;
+export type ClmmDepositArgs = {
+    queryId: bigint;
+    bins: readonly DepositBin[];
+    /**
+     * True when only one side is provided and no matching leg will follow. If
+     * false and no second leg arrives, the deposit waits in the LP account.
+     */
+    isSingle: boolean;
+    /** Which side this leg carries. Decides which column of the bins is summed. */
+    side: 'x' | 'y';
+};
+/** `MsgDepositLiquidity` — native TON leg. Native TON is always the X side. */
+export declare function encodeDepositLiquidity(args: ClmmDepositArgs): Cell;
+/** `JettonDepositLiquidityPayload` — jetton leg. Amount comes from the transfer. */
+export declare function encodeJettonDepositPayload(args: {
+    bins: readonly DepositBin[];
+    isSingle: boolean;
+}): Cell;
+/**
+ * `MsgWithdrawLiqudity` — sent to the LP position.
+ *
+ * The misspelling is the protocol's own message name, kept so the two match.
+ * The body carries which bins to empty; there is no partial amount.
+ */
+export declare function encodeWithdrawLiquidity(args: {
+    queryId: bigint;
+    binIds: readonly number[];
+}): Cell;
+/** `MsgWithdrawFees` — collects accrued fees, leaving liquidity in place. */
+export declare function encodeWithdrawFees(args: {
+    queryId: bigint;
+}): Cell;
+/** `MsgLockLiquidity` — locks the position permanently. */
+export declare function encodeLockLiquidity(args: {
+    queryId: bigint;
+}): Cell;
+/** Parses a `MsgSwap` body. For tests and debugging. */
+export declare function decodeSwap(cell: Cell): {
+    queryId: bigint;
+} & ClmmSwapParams;
+//# sourceMappingURL=clmm.d.ts.map

package/dist/codec/clmm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clmm.d.ts","sourceRoot":"","sources":["../../src/codec/clmm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzD,OAAO,EAA8C,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAEvF,qFAAqF;AACrF,eAAO,MAAM,YAAY;;;;;;;;;;;CAWf,CAAA;AASV,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,kGAAkG;IAClG,MAAM,EAAE,OAAO,CAAA;IACf;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACzB,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CACzB,CAAA;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,GAAG,IAAI,CAU3E;AAED,6FAA6F;AAC7F,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG,IAAI,CAQtF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB,GAAG,IAAI,CASP;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,SAAS,UAAU,EAAE,CAAA;IAC3B;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB,+EAA+E;IAC/E,IAAI,EAAE,GAAG,GAAG,GAAG,CAAA;CAChB,CAAA;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAUlE;AAED,oFAAoF;AACpF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,IAAI,EAAE,SAAS,UAAU,EAAE,CAAA;IAC3B,QAAQ,EAAE,OAAO,CAAA;CAClB,GAAG,IAAI,CAMP;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1B,GAAG,IAAI,CAOP;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAElE;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAEnE;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAW3E"}