@moon-cx/sdk 0.0.0-stage → 2.0.1

package/dist/ops/swap.d.ts

@@ -0,0 +1,104 @@
+import type { Address } from '@ton/core';
+import { Amount } from '../core/amount.ts';
+import type { Asset } from '../core/asset.ts';
+import { Percent } from '../core/percent.ts';
+import { type GasRequirement } from '../core/gas.ts';
+import { type BuiltOperation } from '../core/tx.ts';
+import type { ClmmRangeState, CpmmPoolState } from '../state/storage.ts';
+/**
+ * A swap quote computed locally from on-chain state, with no backend involved.
+ * It is only as fresh as the state it was computed from.
+ */
+export type SwapQuote = {
+    protocol: 'cpmm' | 'clmm';
+    /** Where the swap is sent: a pool for CPMM, a range for CLMM. */
+    target: Address;
+    assetIn: Asset;
+    assetOut: Asset;
+    amountIn: Amount;
+    /** What the pool returns at the state this quote was built from. */
+    amountOut: Amount;
+    /**
+     * Minimum received, rounded down.
+     *
+     * CPMM: written into the message as `minOut` and enforced by the pool.
+     *
+     * CLMM: the range's swap message has no `minOut`;
+     * the message carries `sqrtPriceLimit` and this value is derived from it
+     * (`guaranteedOutAtLimit`) using the fees read at quote time. It holds only
+     * while those fees do not change: the range owner can raise `lpFee` and
+     * `protocolFee` to 100 bps each, which
+     * can cut the output by up to 1 − 0.99² / ((1 − lpFee)(1 − protocolFee)) < 2%.
+     * Overriding this field has no effect on CLMM.
+     */
+    minAmountOut: Amount;
+    priceImpactBps: number;
+    lpFee: Amount;
+    protocolFee: Amount;
+    /** True when the input side is X. Decides which leg and which direction. */
+    xIn: boolean;
+    gas: GasRequirement;
+    /** CLMM only: the Q128 price bound written into the message. */
+    sqrtPriceLimit?: bigint;
+    /** CLMM only: bins the swap is expected to cross. */
+    binsCrossed?: number[];
+};
+/**
+ * Quotes a CPMM swap from the pool's own reserves.
+ *
+ * Rejects up front for every reason the pool would reject, naming which one —
+ * a bounced message on the native leg is merely wasteful, but on the jetton
+ * leg the tokens are gone.
+ */
+export declare function quoteCpmmSwap(args: {
+    pool: Address;
+    state: CpmmPoolState;
+    assetIn: Asset;
+    assetOut: Asset;
+    amountIn: Amount;
+    slippage: Percent;
+}): SwapQuote;
+/**
+ * Quotes a CLMM swap by walking the range's bins.
+ *
+ * A partially fillable swap is refused rather than silently truncated: the
+ * range would take what it can and stop, and a caller who was quoted the
+ * full amount would not know why they received less.
+ */
+export declare function quoteClmmSwap(args: {
+    range: Address;
+    state: ClmmRangeState;
+    pool: {
+        masters: {
+            x: Address | null;
+            y: Address;
+        };
+    };
+    assetIn: Asset;
+    assetOut: Asset;
+    amountIn: Amount;
+    slippage: Percent;
+}): SwapQuote;
+export type SwapBuildArgs = {
+    quote: SwapQuote;
+    /** The wallet signing and paying. Also where leftover TON is returned. */
+    sender: Address;
+    /**
+     * The sender's own jetton wallet for the input asset.
+     *
+     * Required whenever the input is a jetton: a jetton transfer starts at the
+     * sender's wallet, and its address cannot be derived from the master without
+     * asking the master itself.
+     */
+    senderJettonWallet?: Address;
+    queryId?: bigint;
+};
+/** Builds the messages for a quoted swap. Nothing is sent. */
+export declare function buildSwap(args: SwapBuildArgs): BuiltOperation<SwapQuote>;
+/** Convenience: the pair ordered the way the factory orders it. */
+export declare function poolSides(a: Asset, b: Asset): {
+    x: Asset;
+    y: Asset;
+    inverted: boolean;
+};
+//# sourceMappingURL=swap.d.ts.map

package/dist/ops/swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap.d.ts","sourceRoot":"","sources":["../../src/ops/swap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAG7C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAiB,KAAK,cAAc,EAAkB,MAAM,eAAe,CAAA;AAMlF,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGxE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,KAAK,CAAA;IACd,QAAQ,EAAE,KAAK,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAA;IACjB;;;;;;;;;;;;OAYG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,GAAG,EAAE,OAAO,CAAA;IACZ,GAAG,EAAE,cAAc,CAAA;IACnB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA;AAaD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,aAAa,CAAA;IACpB,OAAO,EAAE,KAAK,CAAA;IACd,QAAQ,EAAE,KAAK,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;CAClB,GAAG,SAAS,CA2DZ;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,cAAc,CAAA;IACrB,IAAI,EAAE;QAAE,OAAO,EAAE;YAAE,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;YAAC,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAA;IACpD,OAAO,EAAE,KAAK,CAAA;IACd,QAAQ,EAAE,KAAK,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;CAClB,GAAG,SAAS,CA2FZ;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,SAAS,CAAA;IAChB,0EAA0E;IAC1E,MAAM,EAAE,OAAO,CAAA;IACf;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAAC,SAAS,CAAC,CA8ExE;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG;IAAE,CAAC,EAAE,KAAK,CAAC;IAAC,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAEvF"}

package/dist/ops/swap.js

@@ -0,0 +1,248 @@
+import { Amount } from "../core/amount.js";
+import { orderAssets } from "../core/asset.js";
+import { BuildError, PoolNotReadyError } from "../core/errors.js";
+import { Percent } from "../core/percent.js";
+import { clmmSwapGas, clmmSwapTonGas, cpmmSwapJettonForward, cpmmSwapTonGas, } from "../core/gas.js";
+import { randomQueryId } from "../core/tx.js";
+import * as cpmmCodec from "../codec/cpmm.js";
+import * as clmmCodec from "../codec/clmm.js";
+import { buildJettonTransfer } from "../codec/jetton.js";
+import { priceImpactBps, swapOutput, swapRejectionReason } from "../math/cpmm.js";
+import { guaranteedOutAtLimit, simulateClmmSwap, sqrtPriceLimitFor } from "../math/clmm-swap.js";
+import { assertJettonInput } from "./jetton-input.js";
+function sideOf(pool, asset) {
+    if (asset.isNative()) {
+        if (pool.masters.x === null)
+            return 'x';
+        throw new BuildError('this pool does not hold native TON');
+    }
+    const master = asset.master;
+    if (pool.masters.x !== null && pool.masters.x.equals(master))
+        return 'x';
+    if (pool.masters.y.equals(master))
+        return 'y';
+    throw new BuildError(`${asset.toString()} is not one of this pool's assets`);
+}
+/**
+ * Quotes a CPMM swap from the pool's own reserves.
+ *
+ * Rejects up front for every reason the pool would reject, naming which one —
+ * a bounced message on the native leg is merely wasteful, but on the jetton
+ * leg the tokens are gone.
+ */
+export function quoteCpmmSwap(args) {
+    if (!args.state.walletsResolved) {
+        throw new PoolNotReadyError(args.pool, 'the pool has not resolved its jetton wallets yet and would misroute the swap');
+    }
+    const inSide = sideOf(args.state, args.assetIn);
+    const outSide = sideOf(args.state, args.assetOut);
+    if (inSide === outSide)
+        throw new BuildError('input and output are the same side of the pool');
+    if (!args.assetIn.isNative())
+        assertJettonInput('cpmm', args.amountIn.raw);
+    const xIn = inSide === 'x';
+    const reserveIn = xIn ? args.state.reserves.x : args.state.reserves.y;
+    const reserveOut = xIn ? args.state.reserves.y : args.state.reserves.x;
+    const rejection = swapRejectionReason({
+        amountIn: args.amountIn.raw,
+        reserveIn,
+        reserveOut,
+        lpTotal: args.state.lpTotal,
+        lpFeeBps: args.state.lpFeeBps,
+        protocolFeeBps: args.state.protocolFeeBps,
+        minOut: 0n,
+    });
+    if (rejection !== null)
+        throw new BuildError(rejection);
+    const result = swapOutput({
+        amountIn: args.amountIn.raw,
+        reserveIn,
+        reserveOut,
+        lpFeeBps: args.state.lpFeeBps,
+        protocolFeeBps: args.state.protocolFeeBps,
+    });
+    const gas = args.assetIn.isNative()
+        ? cpmmSwapTonGas(args.amountIn.raw)
+        : cpmmSwapJettonForward();
+    return {
+        protocol: 'cpmm',
+        target: args.pool,
+        assetIn: args.assetIn,
+        assetOut: args.assetOut,
+        amountIn: args.amountIn,
+        amountOut: new Amount(result.amountOut, args.assetOut),
+        minAmountOut: new Amount(args.slippage.applyDown(result.amountOut), args.assetOut),
+        priceImpactBps: priceImpactBps({
+            amountIn: args.amountIn.raw,
+            amountOut: result.amountOut,
+            reserveIn,
+            reserveOut,
+        }),
+        lpFee: new Amount(result.lpFee, args.assetIn),
+        protocolFee: new Amount(result.protocolFee, args.assetIn),
+        xIn,
+        gas,
+    };
+}
+/**
+ * Quotes a CLMM swap by walking the range's bins.
+ *
+ * A partially fillable swap is refused rather than silently truncated: the
+ * range would take what it can and stop, and a caller who was quoted the
+ * full amount would not know why they received less.
+ */
+export function quoteClmmSwap(args) {
+    const inSide = sideOf(args.pool, args.assetIn);
+    const outSide = sideOf(args.pool, args.assetOut);
+    if (inSide === outSide)
+        throw new BuildError('input and output are the same side of the pool');
+    if (!args.assetIn.isNative())
+        assertJettonInput('clmm', args.amountIn.raw);
+    const xIn = inSide === 'x';
+    const simulation = simulateClmmSwap({
+        xIn,
+        amountIn: args.amountIn.raw,
+        bins: args.state.bins,
+        currentBin: args.state.currentBin,
+        currentSqrtPrice: args.state.currentSqrtPrice,
+        binStep: args.state.binStep,
+        lpFeeBps: args.state.lpFeeBps,
+        protocolFeeBps: args.state.protocolFeeBps,
+    });
+    if (simulation.unfilled > 0n) {
+        throw new BuildError(`this range can only fill ${args.amountIn.raw - simulation.unfilled} of ${args.amountIn.raw}: ` +
+            'it runs out of liquidity part way through. Try a smaller amount.');
+    }
+    if (simulation.amountOut <= 0n) {
+        throw new BuildError('this amount is too small to return anything at the current price');
+    }
+    // The bound is taken from the post-trade price: the range checks it after each
+    // bin step, so a bound from the starting
+    // price would reject any swap whose own impact reaches the tolerance.
+    const sqrtPriceLimit = sqrtPriceLimitFor({
+        xIn,
+        currentSqrtPrice: simulation.newSqrtPrice,
+        slippageBps: args.slippage.bps,
+    });
+    // The range's comparison is strict; a bound that rejects the swap itself only burns gas.
+    if (sqrtPriceLimit !== 0n) {
+        const passes = xIn
+            ? simulation.newSqrtPrice > sqrtPriceLimit
+            : simulation.newSqrtPrice < sqrtPriceLimit;
+        if (!passes) {
+            throw new BuildError('this swap moves the price past its own tolerance and the range would reject it — ' +
+                'widen the slippage or trade a smaller amount');
+        }
+    }
+    // Only the price bound is enforced on chain, so the minimum is derived from the
+    // exact bound that goes into the message, not from "output minus tolerance".
+    const guaranteed = guaranteedOutAtLimit({
+        xIn,
+        amountIn: args.amountIn.raw,
+        sqrtPriceLimit,
+        lpFeeBps: args.state.lpFeeBps,
+        protocolFeeBps: args.state.protocolFeeBps,
+    });
+    // The bound comes from this swap's own final price, so the guarantee cannot exceed
+    // the simulated output. If it does, the two disagree; fail loudly instead of clamping.
+    if (guaranteed > simulation.amountOut) {
+        throw new BuildError(`internal: the price bound promises ${guaranteed} but the simulation returns ` +
+            `${simulation.amountOut} — bound and simulation disagree`);
+    }
+    // Price impact from the sqrt-price shift, linearised: |p1/p0 - 1| ~ 2 * |s1/s0 - 1|.
+    const before = args.state.currentSqrtPrice;
+    const after = simulation.newSqrtPrice;
+    const moved = before > after ? before - after : after - before;
+    const impact = Number((moved * 20000n) / before);
+    return {
+        protocol: 'clmm',
+        target: args.range,
+        assetIn: args.assetIn,
+        assetOut: args.assetOut,
+        amountIn: args.amountIn,
+        amountOut: new Amount(simulation.amountOut, args.assetOut),
+        minAmountOut: new Amount(guaranteed, args.assetOut),
+        priceImpactBps: impact,
+        lpFee: new Amount(simulation.lpFees, args.assetIn),
+        protocolFee: new Amount(simulation.protocolFees, args.assetOut),
+        xIn,
+        gas: args.assetIn.isNative() ? clmmSwapTonGas(args.amountIn.raw) : clmmSwapGas(),
+        sqrtPriceLimit,
+        binsCrossed: simulation.binsCrossed,
+    };
+}
+/** Builds the messages for a quoted swap. Nothing is sent. */
+export function buildSwap(args) {
+    const queryId = args.queryId ?? randomQueryId();
+    const { quote } = args;
+    if (!quote.assetIn.isNative())
+        assertJettonInput(quote.protocol, quote.amountIn.raw);
+    const warnings = [];
+    // CPMM enforces minOut, CLMM enforces a price bound; on CLMM a zero bound comes
+    // from zero tolerance, not from 100%.
+    if (quote.protocol === 'clmm') {
+        if (quote.sqrtPriceLimit === 0n) {
+            warnings.push('no price bound is set: the range will fill this swap at any price it reaches');
+        }
+        else if (quote.minAmountOut.raw === 0n) {
+            warnings.push('the price bound is set, but this amount is too small for it to guarantee any output');
+        }
+    }
+    else if (quote.minAmountOut.raw === 0n) {
+        warnings.push('there is no minimum output: the swap will go through at any price');
+    }
+    else if (quote.minAmountOut.raw === quote.amountOut.raw) {
+        warnings.push('slippage tolerance is zero: the swap reverts if the price moves at all before it lands');
+    }
+    if (quote.priceImpactBps >= 500) {
+        warnings.push(`this trade moves the price by about ${(quote.priceImpactBps / 100).toFixed(2)}%`);
+    }
+    let txs;
+    if (quote.assetIn.isNative()) {
+        const body = quote.protocol === 'cpmm'
+            ? cpmmCodec.encodeSwap({
+                queryId,
+                swapAmount: quote.amountIn.raw,
+                excess: args.sender,
+                minOut: quote.minAmountOut.raw,
+            })
+            : clmmCodec.encodeSwap({
+                queryId,
+                swapAmount: quote.amountIn.raw,
+                excess: args.sender,
+                sqrtPriceLimit: quote.sqrtPriceLimit ?? 0n,
+            });
+        txs = [{ to: quote.target, value: quote.gas.attach, body }];
+    }
+    else {
+        if (args.senderJettonWallet === undefined) {
+            throw new BuildError(`swapping ${quote.assetIn.toString()} needs the sender's jetton wallet address — ` +
+                'pass senderJettonWallet');
+        }
+        const payload = quote.protocol === 'cpmm'
+            ? cpmmCodec.encodeJettonSwapPayload({
+                excess: args.sender,
+                minOut: quote.minAmountOut.raw,
+            })
+            : clmmCodec.encodeJettonSwapPayload({
+                excess: args.sender,
+                sqrtPriceLimit: quote.sqrtPriceLimit ?? 0n,
+            });
+        const body = buildJettonTransfer({
+            queryId,
+            amount: quote.amountIn.raw,
+            destination: quote.target,
+            responseDestination: args.sender,
+            forwardTonAmount: quote.gas.attach,
+            forwardPayload: payload,
+        });
+        // Extra 0.1 TON on top of the forward amount pays for the jetton transfer itself.
+        txs = [{ to: args.senderJettonWallet, value: quote.gas.attach + 100000000n, body }];
+    }
+    return { txs, queryId, details: quote, warnings };
+}
+/** Convenience: the pair ordered the way the factory orders it. */
+export function poolSides(a, b) {
+    return orderAssets(a, b);
+}
+//# sourceMappingURL=swap.js.map

package/dist/ops/swap.js.map

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

package/dist/pool/amounts.d.ts

@@ -0,0 +1,36 @@
+import { Amount } from '../core/amount.ts';
+import type { Asset } from '../core/asset.ts';
+import type { PoolAssets } from './cpmm.ts';
+import type { DecimalsSource, PoolDecimalsSource } from './assets.ts';
+/**
+ * An amount as written.
+ *
+ * - `'50'` or `50`: fifty tokens; the asset's decimals are applied.
+ * - `50n`: fifty of the smallest unit, exactly as the chain counts them.
+ * - an {@link Amount}: already built, and checked against the asset.
+ *
+ * For a nine-decimal asset `50` is a billion times `50n`; use `bigint` only for raw units.
+ */
+export type AmountLike = Amount | string | number | bigint;
+/**
+ * The pool's own version of an asset, matched on the master address.
+ *
+ * Decimals must agree with the pool's copy, or this throws. With `decimalsSource`,
+ * a side whose decimals were read from the jetton master (`'chain'`) wins instead;
+ * without it every disagreement is refused.
+ */
+export declare function canonicalAsset(assets: PoolAssets, asset: Asset, decimalsSource?: PoolDecimalsSource): Asset;
+/**
+ * {@link toAmount} for one side of a pool, aware of where its decimals came from.
+ *
+ * On a side whose decimals are `'assumed'` or `'listed'`, only a raw `bigint` is
+ * accepted: a string, number or {@link Amount} would be converted at unverified decimals.
+ */
+export declare function poolAmount(value: AmountLike, asset: Asset, source: DecimalsSource): Amount;
+/**
+ * Reads an amount against a known asset. A ready-made {@link Amount} must agree
+ * with that asset on both identity and decimals; mismatched decimals are refused,
+ * not converted.
+ */
+export declare function toAmount(value: AmountLike, asset: Asset): Amount;
+//# sourceMappingURL=amounts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"amounts.d.ts","sourceRoot":"","sources":["../../src/pool/amounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErE;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAE1D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,KAAK,EACZ,cAAc,CAAC,EAAE,kBAAkB,GAClC,KAAK,CAuBP;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAgB1F;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAgBhE"}

package/dist/pool/amounts.js

@@ -0,0 +1,68 @@
+import { Amount } from "../core/amount.js";
+import { BuildError } from "../core/errors.js";
+/**
+ * The pool's own version of an asset, matched on the master address.
+ *
+ * Decimals must agree with the pool's copy, or this throws. With `decimalsSource`,
+ * a side whose decimals were read from the jetton master (`'chain'`) wins instead;
+ * without it every disagreement is refused.
+ */
+export function canonicalAsset(assets, asset, decimalsSource) {
+    const side = asset.equals(assets.x) ? 'x' : asset.equals(assets.y) ? 'y' : null;
+    if (side === null) {
+        throw new BuildError(`${asset.toString()} is not one of this pool's assets ` +
+            `(${assets.x.toString()} / ${assets.y.toString()})`);
+    }
+    const own = assets[side];
+    if (asset.decimals === own.decimals || decimalsSource?.[side] === 'chain')
+        return own;
+    const where = decimalsSource?.[side] === 'assumed'
+        ? 'nothing read them from the master and none were passed, so it assumes nine'
+        : decimalsSource?.[side] === 'listed'
+            ? 'they came from the pool listing, not from the master'
+            : 'they were passed in, not read from the master';
+    throw new BuildError(`${asset.toString()} has ${asset.decimals} decimals in your asset, but this pool holds it ` +
+        `with ${own.decimals} (${where}). One of them is wrong, and a thousandfold hangs on ` +
+        'which: open the pool with a client that can read jetton metadata, or pass the ' +
+        'correct assets when opening it');
+}
+/**
+ * {@link toAmount} for one side of a pool, aware of where its decimals came from.
+ *
+ * On a side whose decimals are `'assumed'` or `'listed'`, only a raw `bigint` is
+ * accepted: a string, number or {@link Amount} would be converted at unverified decimals.
+ */
+export function poolAmount(value, asset, source) {
+    if ((source === 'assumed' || source === 'listed') && typeof value !== 'bigint') {
+        // An Amount is refused too: its raw units may come from the same unverified decimals.
+        const why = source === 'assumed'
+            ? 'nothing read them from the master and none were passed'
+            : 'they came from the pool listing, and nothing could check them against the master';
+        const what = value instanceof Amount ? `an Amount (${value.toString()})` : `'${String(value)}'`;
+        throw new BuildError(`the decimals of ${asset.toString()} are unverified in this pool: ${why}, so ${what} ` +
+            'cannot be turned into raw units safely. Pass raw units as a bigint (an Amount you ' +
+            'trust: its .raw), or open the pool with a client that can read jetton metadata, or ' +
+            'with { assets } naming the decimals yourself');
+    }
+    return toAmount(value, asset);
+}
+/**
+ * Reads an amount against a known asset. A ready-made {@link Amount} must agree
+ * with that asset on both identity and decimals; mismatched decimals are refused,
+ * not converted.
+ */
+export function toAmount(value, asset) {
+    if (typeof value === 'bigint')
+        return Amount.raw(value, asset);
+    if (!(value instanceof Amount))
+        return Amount.of(value, asset);
+    if (!value.asset.equals(asset)) {
+        throw new BuildError(`this amount is in ${value.asset.toString()}, but the operation is in ${asset.toString()}`);
+    }
+    if (value.asset.decimals !== asset.decimals) {
+        throw new BuildError(`this amount was built with ${value.asset.decimals} decimals, but ${asset.toString()} ` +
+            `has ${asset.decimals}. Pass the number instead and let the pool apply its own decimals.`);
+    }
+    return value;
+}
+//# sourceMappingURL=amounts.js.map

package/dist/pool/amounts.js.map

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

package/dist/pool/assets.d.ts

@@ -0,0 +1,45 @@
+import type { Address } from '@ton/core';
+import { Asset } from '../core/asset.ts';
+import type { Jettons } from '../jetton/index.ts';
+import type { PoolAssets } from './cpmm.ts';
+/**
+ * Where a pool side's decimals came from.
+ *
+ * - `'chain'`: read from the jetton master's metadata, or native TON (always nine).
+ *   The only source treated as verified.
+ * - `'given'`: passed in `assets` when the pool was opened; not checked.
+ * - `'listed'`: from a pool listing entry (`moon.cpmmPool(info)`, `assetsOf`,
+ *   `PoolList.assets()`); not checked. Display only: amounts must be a raw `bigint`.
+ * - `'assumed'`: no source; nine decimals for display, amounts must be a raw `bigint`.
+ *
+ * Prices (`pool.price`, `binAtPrice`) use these decimals whatever their source.
+ */
+export type DecimalsSource = 'chain' | 'given' | 'listed' | 'assumed';
+/** Decimals provenance, per pool side. */
+export type PoolDecimalsSource = {
+    x: DecimalsSource;
+    y: DecimalsSource;
+};
+/** Marks an asset built from a pool listing entry. Internal. */
+export declare function listedAsset(asset: Asset): Asset;
+/**
+ * The pool's assets, checked against the pool's own storage.
+ *
+ * Identity and order come only from `masters`: each given asset must be the token
+ * on the same side on chain, or this throws (a swapped pair is refused, not reordered).
+ * Decimals are read from the jetton master when `jettons` is available; otherwise
+ * given decimals are used and marked unverified (`'listed'` if from a listing).
+ */
+export declare function resolvePoolAssets(args: {
+    pool: Address;
+    masters: {
+        x: Address | null;
+        y: Address;
+    };
+    given: Partial<PoolAssets> | undefined;
+    jettons: Jettons | null;
+}): Promise<{
+    assets: PoolAssets;
+    decimalsSource: PoolDecimalsSource;
+}>;
+//# sourceMappingURL=assets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/pool/assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAExC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAA;AAErE,0CAA0C;AAC1C,MAAM,MAAM,kBAAkB,GAAG;IAAE,CAAC,EAAE,cAAc,CAAC;IAAC,CAAC,EAAE,cAAc,CAAA;CAAE,CAAA;AAMzE,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAG/C;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE;QAAE,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAAC,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IAC1C,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAA;IACtC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;CACxB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,cAAc,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAwCtE"}

package/dist/pool/assets.js

@@ -0,0 +1,57 @@
+import { Asset } from "../core/asset.js";
+import { BuildError } from "../core/errors.js";
+// Assets built from a listing response. The mark lives on the object so it survives
+// being passed back in by an integrator (assetsOf, PoolList.assets()).
+const fromListing = new WeakSet();
+/** Marks an asset built from a pool listing entry. Internal. */
+export function listedAsset(asset) {
+    fromListing.add(asset);
+    return asset;
+}
+/**
+ * The pool's assets, checked against the pool's own storage.
+ *
+ * Identity and order come only from `masters`: each given asset must be the token
+ * on the same side on chain, or this throws (a swapped pair is refused, not reordered).
+ * Decimals are read from the jetton master when `jettons` is available; otherwise
+ * given decimals are used and marked unverified (`'listed'` if from a listing).
+ */
+export async function resolvePoolAssets(args) {
+    const { pool, masters, given, jettons } = args;
+    const own = {
+        x: masters.x === null ? Asset.native() : Asset.jetton(masters.x),
+        y: Asset.jetton(masters.y),
+    };
+    for (const side of ['x', 'y']) {
+        const asset = given?.[side];
+        if (asset === undefined || asset.equals(own[side]))
+            continue;
+        const other = side === 'x' ? 'y' : 'x';
+        const order = `x = ${own.x.toString()}, y = ${own.y.toString()}`;
+        throw new BuildError(asset.equals(own[other])
+            ? `assets.${side} is ${asset.toString()}, but in pool ${pool.toString()} that token ` +
+                `is ${other}: the pool's own order is ${order}. Pass the assets in that order, ` +
+                'or open the pool by address alone'
+            : `assets.${side} is ${asset.toString()}, which pool ${pool.toString()} does not hold: ` +
+                `its storage names ${order}`);
+    }
+    if (jettons !== null) {
+        const [x, y] = await Promise.all([jettons.assetOf(masters.x), jettons.asset(masters.y)]);
+        return { assets: { x, y }, decimalsSource: { x: 'chain', y: 'chain' } };
+    }
+    const pick = (side) => {
+        const asset = given?.[side];
+        // Native TON always has nine decimals.
+        if (own[side].isNative()) {
+            return [asset !== undefined && asset.decimals === 9 ? asset : Asset.native(), 'chain'];
+        }
+        if (asset === undefined)
+            return [own[side], 'assumed'];
+        // Listing decimals cannot be verified here; poolAmount restricts that side to raw input.
+        return [asset, fromListing.has(asset) ? 'listed' : 'given'];
+    };
+    const [x, xFrom] = pick('x');
+    const [y, yFrom] = pick('y');
+    return { assets: { x, y }, decimalsSource: { x: xFrom, y: yFrom } };
+}
+//# sourceMappingURL=assets.js.map

package/dist/pool/assets.js.map

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