@moon-cx/sdk 0.0.0-stage → 2.0.1

package/dist/math/integer.js

@@ -0,0 +1,44 @@
+/** Integer arithmetic matching the on-chain math bit for bit. */
+/** On-chain `mulDivFloor`: full-precision multiply, then floor division. */
+export function mulDivFloor(a, b, denominator) {
+    if (denominator === 0n)
+        throw new RangeError('division by zero');
+    return (a * b) / denominator;
+}
+/** Like {@link mulDivFloor}, but rounds up. */
+export function mulDivCeil(a, b, denominator) {
+    if (denominator === 0n)
+        throw new RangeError('division by zero');
+    const product = a * b;
+    return product / denominator + (product % denominator === 0n ? 0n : 1n);
+}
+/** Integer square root: the largest `r` such that `r² ≤ value`. */
+export function isqrt(value) {
+    if (value < 0n)
+        throw new RangeError('square root of a negative number');
+    if (value < 2n)
+        return value;
+    // Start at or above the root: 2^ceil(bits/2) ≥ sqrt(value).
+    let guess = 1n << (BigInt(value.toString(2).length) / 2n + 1n);
+    let previous = 0n;
+    // Newton decreases monotonically from above; stop once it stops decreasing.
+    while (guess !== previous) {
+        previous = guess;
+        guess = (guess + value / guess) / 2n;
+        if (guess >= previous)
+            break;
+    }
+    let result = previous < guess ? previous : guess;
+    while (result * result > value)
+        result -= 1n;
+    while ((result + 1n) * (result + 1n) <= value)
+        result += 1n;
+    return result;
+}
+export function min(a, b) {
+    return a < b ? a : b;
+}
+export function max(a, b) {
+    return a > b ? a : b;
+}
+//# sourceMappingURL=integer.js.map

package/dist/math/integer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integer.js","sourceRoot":"","sources":["../../src/math/integer.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS,EAAE,WAAmB;IACnE,IAAI,WAAW,KAAK,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAChE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAA;AAC9B,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS,EAAE,WAAmB;IAClE,IAAI,WAAW,KAAK,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAChE,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAA;IACrB,OAAO,OAAO,GAAG,WAAW,GAAG,CAAC,OAAO,GAAG,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AACzE,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,IAAI,KAAK,GAAG,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAAA;IACxE,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,KAAK,CAAA;IAE5B,4DAA4D;IAC5D,IAAI,KAAK,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAA;IAC9D,IAAI,QAAQ,GAAG,EAAE,CAAA;IAEjB,4EAA4E;IAC5E,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC1B,QAAQ,GAAG,KAAK,CAAA;QAChB,KAAK,GAAG,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,CAAA;QACpC,IAAI,KAAK,IAAI,QAAQ;YAAE,MAAK;IAC9B,CAAC;IAED,IAAI,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAA;IAChD,OAAO,MAAM,GAAG,MAAM,GAAG,KAAK;QAAE,MAAM,IAAI,EAAE,CAAA;IAC5C,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,IAAI,KAAK;QAAE,MAAM,IAAI,EAAE,CAAA;IAC3D,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,CAAS;IACtC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,CAAS;IACtC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACtB,CAAC"}

package/dist/math/q128.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Q128 fixed-point arithmetic, matching the TVM instructions used on chain.
+ *
+ * CLMM stores prices as 128-bit fixed-point square roots, and the rounding
+ * mode of every operation is part of the protocol: the range uses `MULRSHIFTR#`
+ * (nearest) in one place and `MULRSHIFT#` (floor) in another, and swapping them
+ * moves bin boundaries. Each function below states which instruction it mirrors.
+ */
+export declare const SCALE_BITS = 128n;
+/** 2^128 — one, in Q128. */
+export declare const SCALE: bigint;
+/** Division that rounds toward negative infinity, as TVM's `DIV` does. */
+export declare function floorDiv(a: bigint, b: bigint): bigint;
+/** On-chain `mulDivFloor`. */
+export declare function mulDivFloor(a: bigint, b: bigint, d: bigint): bigint;
+/** On-chain `mulDivCeil`. */
+export declare function mulDivCeil(a: bigint, b: bigint, d: bigint): bigint;
+/** `q128Mul` — `128 MULRSHIFTR#`, rounds to nearest. */
+export declare function q128Mul(a: bigint, b: bigint): bigint;
+/** `q128MulFloor` — `128 MULRSHIFT#`. */
+export declare function q128MulFloor(a: bigint, b: bigint): bigint;
+/** `q128MulCeil`. */
+export declare function q128MulCeil(a: bigint, b: bigint): bigint;
+/** `q128Div` — `128 LSHIFT#DIVR`, rounds to nearest. */
+export declare function q128Div(a: bigint, b: bigint): bigint;
+/** `q128DivFloor` — `128 LSHIFT#DIV`. */
+export declare function q128DivFloor(a: bigint, b: bigint): bigint;
+/** `q128DivCeil` — `128 LSHIFT#DIVC`. */
+export declare function q128DivCeil(a: bigint, b: bigint): bigint;
+/**
+ * `q128Pow` — binary exponentiation in Q128, negative exponents inverted.
+ *
+ * Rounding accumulates across the squarings exactly as on chain; this is
+ * deliberate, matching the range matters more than matching the real value.
+ */
+export declare function q128Pow(base: bigint, exponent: bigint): bigint;
+/**
+ * `q128Sqrt` — square root in Q128.
+ *
+ * Mirrors the on-chain routine literally, including the fixed count of six
+ * Newton steps. The loop does not run to convergence, so replacing it with a
+ * converging one would give a different answer from the range on some inputs.
+ */
+export declare function q128Sqrt(raw: bigint): bigint;
+//# sourceMappingURL=q128.d.ts.map

package/dist/math/q128.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"q128.d.ts","sourceRoot":"","sources":["../../src/math/q128.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,UAAU,OAAO,CAAA;AAC9B,4BAA4B;AAC5B,eAAO,MAAM,KAAK,QAAmB,CAAA;AAErC,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIrD;AAaD,8BAA8B;AAC9B,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,6BAA6B;AAC7B,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wDAAwD;AACxD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,qBAAqB;AACrB,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wDAAwD;AACxD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD;AAQD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY9D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAa5C"}

package/dist/math/q128.js

@@ -0,0 +1,108 @@
+/**
+ * Q128 fixed-point arithmetic, matching the TVM instructions used on chain.
+ *
+ * CLMM stores prices as 128-bit fixed-point square roots, and the rounding
+ * mode of every operation is part of the protocol: the range uses `MULRSHIFTR#`
+ * (nearest) in one place and `MULRSHIFT#` (floor) in another, and swapping them
+ * moves bin boundaries. Each function below states which instruction it mirrors.
+ */
+export const SCALE_BITS = 128n;
+/** 2^128 — one, in Q128. */
+export const SCALE = 1n << SCALE_BITS;
+/** Division that rounds toward negative infinity, as TVM's `DIV` does. */
+export function floorDiv(a, b) {
+    if (b === 0n)
+        throw new RangeError('division by zero');
+    const quotient = a / b;
+    return (a % b !== 0n) && (a < 0n) !== (b < 0n) ? quotient - 1n : quotient;
+}
+/** Rounds to nearest, halves away from negative infinity — TVM's `R` modes. */
+function divRound(a, b) {
+    if (b === 0n)
+        throw new RangeError('division by zero');
+    return floorDiv(2n * a + b, 2n * b);
+}
+function divCeil(a, b) {
+    if (b === 0n)
+        throw new RangeError('division by zero');
+    return -floorDiv(-a, b);
+}
+/** On-chain `mulDivFloor`. */
+export function mulDivFloor(a, b, d) {
+    return floorDiv(a * b, d);
+}
+/** On-chain `mulDivCeil`. */
+export function mulDivCeil(a, b, d) {
+    return divCeil(a * b, d);
+}
+/** `q128Mul` — `128 MULRSHIFTR#`, rounds to nearest. */
+export function q128Mul(a, b) {
+    return divRound(a * b, SCALE);
+}
+/** `q128MulFloor` — `128 MULRSHIFT#`. */
+export function q128MulFloor(a, b) {
+    return floorDiv(a * b, SCALE);
+}
+/** `q128MulCeil`. */
+export function q128MulCeil(a, b) {
+    return mulDivCeil(a, b, SCALE);
+}
+/** `q128Div` — `128 LSHIFT#DIVR`, rounds to nearest. */
+export function q128Div(a, b) {
+    return divRound(a << SCALE_BITS, b);
+}
+/** `q128DivFloor` — `128 LSHIFT#DIV`. */
+export function q128DivFloor(a, b) {
+    return floorDiv(a << SCALE_BITS, b);
+}
+/** `q128DivCeil` — `128 LSHIFT#DIVC`. */
+export function q128DivCeil(a, b) {
+    return divCeil(a << SCALE_BITS, b);
+}
+/** Bit length, as TVM's `UBITSIZE`. */
+function bitLength(value) {
+    if (value < 0n)
+        throw new RangeError('bit length of a negative number');
+    return BigInt(value.toString(2).length);
+}
+/**
+ * `q128Pow` — binary exponentiation in Q128, negative exponents inverted.
+ *
+ * Rounding accumulates across the squarings exactly as on chain; this is
+ * deliberate, matching the range matters more than matching the real value.
+ */
+export function q128Pow(base, exponent) {
+    if (exponent < 0n)
+        return q128Div(SCALE, q128Pow(base, -exponent));
+    let exp = exponent;
+    let acc = base;
+    let result = SCALE;
+    while (exp > 0n) {
+        if ((exp & 1n) !== 0n)
+            result = q128Mul(result, acc);
+        acc = q128Mul(acc, acc);
+        exp >>= 1n;
+    }
+    return result;
+}
+/**
+ * `q128Sqrt` — square root in Q128.
+ *
+ * Mirrors the on-chain routine literally, including the fixed count of six
+ * Newton steps. The loop does not run to convergence, so replacing it with a
+ * converging one would give a different answer from the range on some inputs.
+ */
+export function q128Sqrt(raw) {
+    if (raw === 0n)
+        return 0n;
+    if (raw < 0n)
+        throw new RangeError('square root of a negative number');
+    const s = bitLength(raw);
+    const t = SCALE_BITS + 1n;
+    let x = s === t ? floorDiv(raw - SCALE, 2n) + SCALE : 1n << ((s + t) / 2n);
+    for (let i = 0; i < 6; i++) {
+        x += floorDiv(mulDivCeil(raw, SCALE, x) - x, 2n);
+    }
+    return x;
+}
+//# sourceMappingURL=q128.js.map

package/dist/math/q128.js.map

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

package/dist/moon.d.ts

@@ -0,0 +1,245 @@
+import { Address } from '@ton/core';
+import { Asset } from './core/asset.ts';
+import { MoonApi, type MoonApiOptions, type PoolInfo, type PoolList, type PoolProtocol, type PositionRecord } from './api/index.ts';
+import type { CpmmPosition } from './pool/cpmm.ts';
+import type { ClmmPosition } from './pool/clmm.ts';
+import { type BinStep } from './math/clmm.ts';
+import type { GasPrices } from './core/gas.ts';
+import { type CpmmFeeBps, type CpmmPoolCreation, type ClmmPoolCreation } from './ops/pool.ts';
+import { type CurveBuy, type CurveCreation, type CurveSell, type MempadFeeBps } from './ops/mempad.ts';
+import type { LaunchMetadata } from './codec/mempad.ts';
+import { type Operation, type Sender } from './adapters/sender.ts';
+import { type TonClientLike } from './adapters/tonclient.ts';
+import type { StateSource } from './state/source.ts';
+import { CpmmPool } from './pool/cpmm.ts';
+import { ClmmPool } from './pool/clmm.ts';
+import { Jettons, type OpenableClient } from './jetton/index.ts';
+export type MoonOptions = {
+    /**
+     * Where on-chain state comes from: a TonClient, or anything with `getAccountState`.
+     * A client that can also `open` jetton masters and wallets (TonClient can) enables
+     * jetton lookups: decimals, symbols and the sender's jetton wallets are read from
+     * the chain.
+     */
+    client: (TonClientLike | StateSource) | (TonClientLike & OpenableClient);
+    /**
+     * Pool discovery and, unless `factories` is set, the factory addresses for
+     * create* calls. Optional — pass `false` to work purely from addresses.
+     * The API is never used for quotes or transaction bodies.
+     */
+    api?: MoonApi | MoonApiOptions | false;
+    /**
+     * Factory addresses. By default each create* call reads them from `api`; pin them
+     * here to take the API out of deciding where create* funds go, or when `api: false`.
+     * Not bundled in the package: they are deployment configuration and differ per
+     * network. Every `create*` method also accepts `factory` to override.
+     */
+    factories?: {
+        cpmm?: Address;
+        clmm?: Address;
+        mempad?: Address;
+    };
+    /**
+     * Jetton lookups to use instead of the ones built from `client`.
+     *
+     * Off-chain jetton metadata means an HTTP or IPFS fetch with no timeout of its own;
+     * pass `new Jettons(client, { contentResolver })` to bound or redirect it. Also lets
+     * a bare state-source `client` read decimals from the chain.
+     */
+    jettons?: Jettons;
+};
+/**
+ * The entry point.
+ *
+ * ```ts
+ * const moon = new Moon({ client: new TonClient({ endpoint, apiKey }) })
+ * const [info] = await moon.api.findPools(TON, USDT, 'cpmm')
+ * const pool = await moon.cpmmPool(info)
+ * ```
+ */
+export declare class Moon {
+    #private;
+    readonly state: StateSource;
+    /** Pool and position discovery. Throws when created with `api: false`. */
+    get api(): MoonApi;
+    /** Whether pool discovery is available at all. */
+    get hasApi(): boolean;
+    /**
+     * Jetton metadata and wallet lookups: `options.jettons`, or built from a client that
+     * can open jetton masters and wallets. `null` for a bare state source without
+     * `jettons`; then supply decimals and jetton wallet addresses yourself.
+     */
+    readonly jettons: Jettons | null;
+    /**
+     * The asset at this master, with decimals, symbol, name and image read from
+     * the chain through this Moon's client. Cached per master for the life of
+     * the Moon; a failed read is not cached.
+     *
+     * `null` or `'TON'` gives native TON without a request.
+     *
+     * @throws BuildError when the client cannot open jetton masters (a bare state
+     *   source) and no `jettons` were given — build the asset yourself with
+     *   `Asset.jetton(master, { decimals })`
+     * @throws JettonLookupError when the master cannot be read
+     */
+    asset(master: Address | string | null): Promise<Asset>;
+    /** Factory addresses given at construction. Per-call `factory` wins over these. */
+    readonly factories: {
+        cpmm?: Address;
+        clmm?: Address;
+        mempad?: Address;
+    };
+    constructor(options: MoonOptions);
+    /**
+     * The factory a create* call will use: the one passed to the call, else the one
+     * given to the constructor, else the one the API publishes (read per call).
+     * Throws a BuildError when none is available.
+     *
+     * An API-provided factory is only checked to parse as a factory, not to be the
+     * genuine moon.cx factory; pin `factories` to avoid trusting the API.
+     */
+    factoryAddress(protocol: 'cpmm' | 'clmm' | 'mempad', given?: Address): Promise<Address>;
+    /**
+     * Opens a CPMM pool by address, or by an entry from the listing.
+     *
+     * Token decimals are read from the jetton masters when this Moon has jetton lookups.
+     * Otherwise a listing entry's decimals are only used for display: they are `'listed'`
+     * in `pool.decimalsSource`, and amounts on those sides must be raw `bigint`.
+     *
+     * A listing entry must name the pool's own tokens in the pool's x/y order, or this throws.
+     */
+    cpmmPool(pool: Address | PoolInfo): Promise<CpmmPool>;
+    /**
+     * Opens a CLMM pool by address, or by an entry from the listing. Decimals
+     * and the entry's tokens are handled as in {@link cpmmPool}.
+     */
+    clmmPool(pool: Address | PoolInfo): Promise<ClmmPool>;
+    /**
+     * Opens a position from a listing record, resolving its pool and, for CLMM, its
+     * range from the bins it holds.
+     */
+    openPosition(record: PositionRecord): Promise<CpmmPosition | ClmmPosition>;
+    /**
+     * Creates a CPMM pool; the future pool address is returned in `details`.
+     *
+     * The pool address depends on the signing wallet, so pass `wallet`, or `sender`
+     * when signing elsewhere.
+     */
+    createCpmmPool(args: {
+        /** Defaults to `factories.cpmm`, else the factory the API publishes (see {@link Moon.factoryAddress}). */
+        factory?: Address;
+        assetA: Asset;
+        assetB: Asset;
+        /**
+         * Basis points: 10 = 0.10%, 20 = 0.20%, 30 = 0.30%, 50 = 0.50%,
+         * 100 = 1.00%, 200 = 2.00%. Write the number, or `FeeTier.Bps30`.
+         * Fixed forever at creation; there is no default.
+         */
+        feeBps: CpmmFeeBps;
+        wallet?: Sender;
+        /** The creating wallet, when it is not `wallet.address`. */
+        sender?: Address;
+        queryId?: bigint;
+    }): Promise<Operation<CpmmPoolCreation & {
+        poolAddress: Address;
+    }>>;
+    /**
+     * Creates a CLMM pool at a starting price. `price` is units of `assetB` per one
+     * `assetA`; it is inverted if the factory orders the pair the other way.
+     */
+    createClmmPool(args: {
+        /** Defaults to `factories.clmm`, else the factory the API publishes (see {@link Moon.factoryAddress}). */
+        factory?: Address;
+        assetA: Asset;
+        assetB: Asset;
+        /**
+         * Basis points per bin: 25 = 0.25%, 50 = 0.50%, 100 = 1.00%, 200 = 2.00%.
+         * Write the number, or `BinStep.Bps25`.
+         */
+        binStep: BinStep;
+        price: number;
+        wallet?: Sender;
+        queryId?: bigint;
+    }): Promise<Operation<ClmmPoolCreation & {
+        poolAddress: Address;
+    }>>;
+    /**
+     * Launches a token on a bonding curve.
+     *
+     * Reads the launch fee and curve code from the factory, then refuses if the curve
+     * address is already taken: a repeated `(factory, creator, salt)` is not refused on
+     * chain, and the factory keeps the fee.
+     */
+    createCurve(args: {
+        /** Defaults to `factories.mempad`, else the factory the API publishes (see {@link Moon.factoryAddress}). */
+        factory?: Address;
+        /**
+         * Basis points: 10 = 0.10%, 20 = 0.20%, 30 = 0.30%, 50 = 0.50%,
+         * 100 = 1.00%, 200 = 2.00%. Write the number, or `FeeTier.Bps30`.
+         *
+         * On a launch this is the fee of the CPMM pool the curve graduates
+         * into, and it also sets the creator's cut — see `MEMPAD_FEE_TIERS`.
+         */
+        feeBps: MempadFeeBps;
+        metadata: LaunchMetadata;
+        /** Exactly 0, or at least 0.01 GRAM. Anything between is exit 700. */
+        initialBuy?: bigint;
+        salt?: bigint;
+        wallet?: Sender;
+        /** The creating wallet, when it is not `wallet.address`. It fixes the address. */
+        sender?: Address;
+        queryId?: bigint;
+    }): Promise<Operation<CurveCreation & {
+        curveAddress: Address;
+    }>>;
+    /**
+     * Buys on a curve. Refuses locally when the curve is no longer trading, which on
+     * chain would fail with `WRONG_STATE` (555) after gas is spent.
+     */
+    curveBuy(args: {
+        curve: Address;
+        /**
+         * Purchase amount in nanograms that reaches the curve; gas is attached on top.
+         * With `gasIncluded: true` it is the whole message value instead.
+         */
+        value: bigint;
+        /** `value` is the whole message value, gas deducted from it, not the purchase amount. */
+        gasIncluded?: boolean;
+        minOut?: bigint;
+        /** Only for a chain whose config 21 is not mainnet's. */
+        prices?: GasPrices;
+        wallet?: Sender;
+        queryId?: bigint;
+    }): Promise<Operation<CurveBuy>>;
+    /**
+     * Sells back to a curve. Derives the seller's jetton wallet from the curve's own
+     * stored code (not the factory's), which the curve checks the sender against.
+     */
+    curveSell(args: {
+        curve: Address;
+        amount: bigint;
+        minOut?: bigint;
+        attach?: bigint;
+        wallet?: Sender;
+        /** The seller, when it is not `wallet.address`. */
+        sender?: Address;
+        queryId?: bigint;
+    }): Promise<Operation<CurveSell & {
+        jettonWallet: Address;
+    }>>;
+    /**
+     * Fetches the pool listing. One request; query the result locally.
+     *
+     * ```ts
+     * const pools = await moon.loadPools()      // one request
+     * const info = pools.best(TON, USDT, 'cpmm') // in memory
+     * ```
+     *
+     * Throws `PoolIndexWarmingError` (retryable, carries `retryAfterMs`) while the
+     * backend is still listing a requested protocol.
+     */
+    loadPools(protocol?: PoolProtocol): Promise<PoolList>;
+    /** Opens the deepest pool for a pair from a listing you already hold, without fetching. */
+    openPair(pools: PoolList, a: Asset, b: Asset, protocol: PoolProtocol): Promise<CpmmPool | ClmmPool>;
+}
+//# sourceMappingURL=moon.d.ts.map

package/dist/moon.d.ts.map

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