@moon-cx/sdk 0.0.0-stage → 2.0.1

package/dist/core/percent.js

@@ -0,0 +1,71 @@
+/** A slippage tolerance or fee share, held as whole basis points (never a float). */
+export class Percent {
+    /** Basis points. 1 bps = 0.01%. 10000 bps = 100%. */
+    bps;
+    constructor(bps) {
+        if (!Number.isInteger(bps)) {
+            throw new TypeError(`basis points must be a whole number, got ${bps}`);
+        }
+        if (bps < 0 || bps > 10_000) {
+            throw new TypeError(`basis points must be within 0..10000, got ${bps}`);
+        }
+        this.bps = bps;
+    }
+    /** `Percent.bps(50)` — half a percent. */
+    static bps(value) {
+        return new Percent(value);
+    }
+    /** `Percent.percent(0.5)` — the same half a percent, written the other way. */
+    static percent(value) {
+        const bps = value * 100;
+        if (!Number.isInteger(Math.round(bps * 1e6) / 1e6)) {
+            throw new TypeError(`${value}% is finer than one basis point`);
+        }
+        return new Percent(Math.round(bps));
+    }
+    /**
+     * 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) {
+        if (value instanceof Percent)
+            return value;
+        if (typeof value !== 'string') {
+            throw new TypeError('Percent.of takes a written value like "0.5%" or "50bps" — ' +
+                'for a bare number use Percent.bps(50) or Percent.percent(0.5)');
+        }
+        const text = value.trim().toLowerCase();
+        const bps = /^(\d+)\s*bps$/.exec(text);
+        if (bps)
+            return new Percent(Number(bps[1]));
+        const percent = /^(\d+(?:\.\d+)?)\s*%?$/.exec(text);
+        if (percent)
+            return Percent.percent(Number(percent[1]));
+        throw new TypeError(`cannot read ${JSON.stringify(value)} as a percentage`);
+    }
+    static zero() {
+        return new Percent(0);
+    }
+    isZero() {
+        return this.bps === 0;
+    }
+    /** Lower bound: what you must still accept. Rounds down, in your favour. */
+    applyDown(value) {
+        return (value * BigInt(10_000 - this.bps)) / 10000n;
+    }
+    /** Upper bound: the most you are willing to give. Rounds up. */
+    applyUp(value) {
+        const numerator = value * BigInt(10_000 + this.bps);
+        return numerator / 10000n + (numerator % 10000n === 0n ? 0n : 1n);
+    }
+    /** The share itself, rounded down: a fee of `bps` taken from `value`. */
+    of(value) {
+        return (value * BigInt(this.bps)) / 10000n;
+    }
+    toString() {
+        return `${this.bps / 100}%`;
+    }
+}
+//# sourceMappingURL=percent.js.map

package/dist/core/percent.js.map

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

package/dist/core/tx.d.ts

@@ -0,0 +1,36 @@
+import type { Address, Cell } from '@ton/core';
+/**
+ * One message to be signed and sent. The SDK never signs or sends by itself:
+ * hand this to a sender from `adapters/sender` or to your own wallet code.
+ */
+export type TxRequest = {
+    /** Destination: a pool, a range, a position, or your own jetton wallet. */
+    to: Address;
+    /** TON to attach, in nanotons. Already includes gas — do not add your own. */
+    value: bigint;
+    body: Cell;
+    /** Send mode hint for your own wallet code; the bundled senders do not read it. */
+    sendMode?: number;
+};
+/**
+ * A built operation: the messages plus what to show a user before they sign.
+ *
+ * `warnings` lists where the SDK adjusted the request to fit an on-chain rule,
+ * e.g. a range trimmed to its window or a deposit split at the per-position
+ * bin limit.
+ */
+export type BuiltOperation<TDetails = unknown> = {
+    txs: TxRequest[];
+    /** Correlates the on-chain result with this request. */
+    queryId: bigint;
+    details: TDetails;
+    warnings: string[];
+};
+/** Total TON leaving the wallet if every message in the batch is sent. */
+export declare function totalValue(txs: readonly TxRequest[]): bigint;
+/**
+ * A random 64-bit query id. The protocol carries it into the fulfil and reject
+ * messages, so an operation's outcome can be found later.
+ */
+export declare function randomQueryId(): bigint;
+//# sourceMappingURL=tx.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tx.d.ts","sourceRoot":"","sources":["../../src/core/tx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAE9C;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,2EAA2E;IAC3E,EAAE,EAAE,OAAO,CAAA;IACX,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,IAAI,CAAA;IACV,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,CAAC,QAAQ,GAAG,OAAO,IAAI;IAC/C,GAAG,EAAE,SAAS,EAAE,CAAA;IAChB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,QAAQ,CAAA;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CAAA;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAMtC"}

package/dist/core/tx.js

@@ -0,0 +1,17 @@
+/** Total TON leaving the wallet if every message in the batch is sent. */
+export function totalValue(txs) {
+    return txs.reduce((sum, tx) => sum + tx.value, 0n);
+}
+/**
+ * A random 64-bit query id. The protocol carries it into the fulfil and reject
+ * messages, so an operation's outcome can be found later.
+ */
+export function randomQueryId() {
+    const bytes = new Uint8Array(8);
+    globalThis.crypto.getRandomValues(bytes);
+    let value = 0n;
+    for (const byte of bytes)
+        value = (value << 8n) | BigInt(byte);
+    return value;
+}
+//# sourceMappingURL=tx.js.map

package/dist/core/tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx.js","sourceRoot":"","sources":["../../src/core/tx.ts"],"names":[],"mappings":"AA+BA,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,GAAyB;IAClD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAA;IAC/B,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;IACxC,IAAI,KAAK,GAAG,EAAE,CAAA;IACd,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;IAC9D,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * `@moon-cx/sdk` — swaps, liquidity and positions on the moon.cx DEX.
+ *
+ * Opcodes, gas thresholds and limits live in `protocol/generated.ts` and are
+ * verified by tests. Operations return {@link TxRequest}s to sign and send;
+ * quotes use on-chain state and the same arithmetic the pools run. The only backend input that decides where money
+ * goes is the factory address for create* calls when `factories` is not pinned.
+ */
+export { Moon } from './moon.ts';
+export type { MoonOptions } from './moon.ts';
+export { CpmmPool, CpmmPosition } from './pool/cpmm.ts';
+export type { PoolAssets } from './pool/cpmm.ts';
+export { canonicalAsset, toAmount } from './pool/amounts.ts';
+export type { AmountLike } from './pool/amounts.ts';
+export type { DecimalsSource, PoolDecimalsSource } from './pool/assets.ts';
+export { ClmmPool, ClmmPosition, ClmmPositionIndex, ClmmRange } from './pool/clmm.ts';
+export type { ClmmDepositBounds, ClmmWithdrawal } from './pool/clmm.ts';
+export { MoonApi, MoonApiError, PoolIndexWarmingError, PoolList, WalletPositions, assetsOf, } from './api/index.ts';
+export type { ApiConfig, ApiMempadConfig, MoonApiOptions, PoolInfo, PoolProtocol, PositionRecord, TokenInfo, } from './api/index.ts';
+export { tonClientSource } from './adapters/tonclient.ts';
+export { NoWalletError, prepared, tonConnectSender, walletSender } from './adapters/sender.ts';
+export type { InternalMessageFactory, Operation, Sender, WalletLike } from './adapters/sender.ts';
+export { JettonLookupError, Jettons } from './jetton/index.ts';
+export type { OpenableClient, OpenedJettonMinter } from './jetton/index.ts';
+export type { TonClientLike } from './adapters/tonclient.ts';
+export { Asset, compareAddresses, orderAssets } from './core/asset.ts';
+export { FEE_BPS, FeeTier, isFeeBps } from './core/fee.ts';
+export type { FeeBps } from './core/fee.ts';
+export { Amount } from './core/amount.ts';
+export { Percent } from './core/percent.ts';
+export { randomQueryId, totalValue } from './core/tx.ts';
+export type { BuiltOperation, TxRequest } from './core/tx.ts';
+export { AmountTooSmallError, BuildError, ContractRejectedError, EXIT_CODES, InsufficientGasError, LimitExceededError, MoonError, PoolNotFoundError, PoolNotReadyError, SlippageError, StateError, describeExitCode, } from './core/errors.ts';
+export { CPMM_MIN_TON_DEPOSIT, DEFAULT_GAS_PRICES, LEGACY_GAS_PRICES, MAINNET_GAS_PRICES, GAS_HEADROOM, assertEnoughGas, gasFee, mempadBuyGas, } from './core/gas.ts';
+export type { GasPrices, GasRequirement, MempadBuyGas } from './core/gas.ts';
+export { PROTOCOL, constantOf, errorCode, fieldsOf, opcodeOf, } from './protocol/index.ts';
+export type { ProtocolName } from './protocol/index.ts';
+export { clmmLpAccountAddress, clmmLpPositionAddress, clmmPoolAddress, clmmRangeAddress, cpmmLpAccountAddress, cpmmLpPositionAddress, cpmmPoolAddress, MEMPAD_SHARD_DEPTH, mempadCurveAddress, mempadJettonWalletAddress, } from './state/address.ts';
+export { parseMempadCurve, parseMempadFactory, parseClmmPool, parseClmmPosition, parseClmmRange, parseClmmFactory, parseCpmmFactory, parseCpmmPool, parseCpmmPosition, } from './state/storage.ts';
+export type { Bin, ClmmPoolState, ClmmPositionState, ClmmRangeState, ClmmFactoryState, CpmmFactoryState, CpmmPoolState, CpmmPositionState, MempadCurveState, MempadFactoryState, } from './state/storage.ts';
+export { readContract, requireState, staticStateSource } from './state/source.ts';
+export type { AccountState, StateSource } from './state/source.ts';
+export { BINS_PER_RANGE, BIN_STEPS, BinStep, isBinStep, MAX_BINS_PER_POSITION, MAX_BINS_PER_SWAP, RANGE_OFFSET, binAtHumanPrice, binAtRawPrice, binBounds, binCoverage, binFees, binSides, binValue, contributeLiquidity, firstBinOfRange, lastBinOfRange, nearestBinToHumanPrice, nearestBinToRawPrice, priceAtBin, rangeOfBin, sqrtPriceAtBin, sqrtPriceToPrice, } from './math/clmm.ts';
+export { guaranteedOutAtLimit, simulateClmmSwap, sqrtPriceLimitFor } from './math/clmm-swap.ts';
+export type { ClmmSwapSimulation } from './math/clmm-swap.ts';
+export { depositLp, firstDepositLp, matchingDeposit, pendingFees, priceImpactBps, swapOutput, swapRejectionReason, withdrawAmounts, } from './math/cpmm.ts';
+export { buildSwap, quoteClmmSwap, quoteCpmmSwap } from './ops/swap.ts';
+export type { SwapQuote } from './ops/swap.ts';
+export { buildClmmDeposit, buildClmmWithdraw, buildCpmmDeposit, buildCpmmWithdraw, matchCpmmDeposit, planCpmmDeposit, shapeBins, } from './ops/liquidity.ts';
+export type { ClmmDepositPlan, CpmmDepositPlan, LiquidityShape } from './ops/liquidity.ts';
+export { CLMM_CREATE_POOL_ATTACH, CLMM_CREATE_POOL_GAS, CPMM_CREATE_POOL_ATTACH, CPMM_CREATE_POOL_GAS, buildClmmCreatePool, buildCpmmCreatePool, } from './ops/pool.ts';
+export type { ClmmPoolCreation, PoolCreation } from './ops/pool.ts';
+export { MEMPAD_FEE_BPS, MEMPAD_FEE_TIERS, MEMPAD_SELL_ATTACH, MEMPAD_SELL_MIN_ATTACH, buildCreateCurve, buildCurveBuy, buildCurveSell, buyValueForSpend, createLaunchValue, } from './ops/mempad.ts';
+export type { CurveBuy, CurveCreation, CurveSell, MempadFeeBps } from './ops/mempad.ts';
+export { LOCK_CONFIRMATION, buildCollectFees, buildLockForever, cpmmPendingFees, isLocked, } from './ops/position.ts';
+export * as cpmmCodec from './codec/cpmm.ts';
+export * as clmmCodec from './codec/clmm.ts';
+export * as mempadCodec from './codec/mempad.ts';
+export type { LaunchLinks, LaunchMetadata } from './codec/mempad.ts';
+export { buildJettonTransfer, JETTON_TRANSFER_OP } from './codec/jetton.ts';
+export { depositBinsToDict, parseDepositBins, sumBins } from './codec/bins.ts';
+export type { DepositBin } from './codec/bins.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,41 @@
+/**
+ * `@moon-cx/sdk` — swaps, liquidity and positions on the moon.cx DEX.
+ *
+ * Opcodes, gas thresholds and limits live in `protocol/generated.ts` and are
+ * verified by tests. Operations return {@link TxRequest}s to sign and send;
+ * quotes use on-chain state and the same arithmetic the pools run. The only backend input that decides where money
+ * goes is the factory address for create* calls when `factories` is not pinned.
+ */
+export { Moon } from "./moon.js";
+export { CpmmPool, CpmmPosition } from "./pool/cpmm.js";
+export { canonicalAsset, toAmount } from "./pool/amounts.js";
+export { ClmmPool, ClmmPosition, ClmmPositionIndex, ClmmRange } from "./pool/clmm.js";
+export { MoonApi, MoonApiError, PoolIndexWarmingError, PoolList, WalletPositions, assetsOf, } from "./api/index.js";
+export { tonClientSource } from "./adapters/tonclient.js";
+export { NoWalletError, prepared, tonConnectSender, walletSender } from "./adapters/sender.js";
+export { JettonLookupError, Jettons } from "./jetton/index.js";
+export { Asset, compareAddresses, orderAssets } from "./core/asset.js";
+export { FEE_BPS, FeeTier, isFeeBps } from "./core/fee.js";
+export { Amount } from "./core/amount.js";
+export { Percent } from "./core/percent.js";
+export { randomQueryId, totalValue } from "./core/tx.js";
+export { AmountTooSmallError, BuildError, ContractRejectedError, EXIT_CODES, InsufficientGasError, LimitExceededError, MoonError, PoolNotFoundError, PoolNotReadyError, SlippageError, StateError, describeExitCode, } from "./core/errors.js";
+export { CPMM_MIN_TON_DEPOSIT, DEFAULT_GAS_PRICES, LEGACY_GAS_PRICES, MAINNET_GAS_PRICES, GAS_HEADROOM, assertEnoughGas, gasFee, mempadBuyGas, } from "./core/gas.js";
+export { PROTOCOL, constantOf, errorCode, fieldsOf, opcodeOf, } from "./protocol/index.js";
+export { clmmLpAccountAddress, clmmLpPositionAddress, clmmPoolAddress, clmmRangeAddress, cpmmLpAccountAddress, cpmmLpPositionAddress, cpmmPoolAddress, MEMPAD_SHARD_DEPTH, mempadCurveAddress, mempadJettonWalletAddress, } from "./state/address.js";
+export { parseMempadCurve, parseMempadFactory, parseClmmPool, parseClmmPosition, parseClmmRange, parseClmmFactory, parseCpmmFactory, parseCpmmPool, parseCpmmPosition, } from "./state/storage.js";
+export { readContract, requireState, staticStateSource } from "./state/source.js";
+export { BINS_PER_RANGE, BIN_STEPS, BinStep, isBinStep, MAX_BINS_PER_POSITION, MAX_BINS_PER_SWAP, RANGE_OFFSET, binAtHumanPrice, binAtRawPrice, binBounds, binCoverage, binFees, binSides, binValue, contributeLiquidity, firstBinOfRange, lastBinOfRange, nearestBinToHumanPrice, nearestBinToRawPrice, priceAtBin, rangeOfBin, sqrtPriceAtBin, sqrtPriceToPrice, } from "./math/clmm.js";
+export { guaranteedOutAtLimit, simulateClmmSwap, sqrtPriceLimitFor } from "./math/clmm-swap.js";
+export { depositLp, firstDepositLp, matchingDeposit, pendingFees, priceImpactBps, swapOutput, swapRejectionReason, withdrawAmounts, } from "./math/cpmm.js";
+export { buildSwap, quoteClmmSwap, quoteCpmmSwap } from "./ops/swap.js";
+export { buildClmmDeposit, buildClmmWithdraw, buildCpmmDeposit, buildCpmmWithdraw, matchCpmmDeposit, planCpmmDeposit, shapeBins, } from "./ops/liquidity.js";
+export { CLMM_CREATE_POOL_ATTACH, CLMM_CREATE_POOL_GAS, CPMM_CREATE_POOL_ATTACH, CPMM_CREATE_POOL_GAS, buildClmmCreatePool, buildCpmmCreatePool, } from "./ops/pool.js";
+export { MEMPAD_FEE_BPS, MEMPAD_FEE_TIERS, MEMPAD_SELL_ATTACH, MEMPAD_SELL_MIN_ATTACH, buildCreateCurve, buildCurveBuy, buildCurveSell, buyValueForSpend, createLaunchValue, } from "./ops/mempad.js";
+export { LOCK_CONFIRMATION, buildCollectFees, buildLockForever, cpmmPendingFees, isLocked, } from "./ops/position.js";
+export * as cpmmCodec from "./codec/cpmm.js";
+export * as clmmCodec from "./codec/clmm.js";
+export * as mempadCodec from "./codec/mempad.js";
+export { buildJettonTransfer, JETTON_TRANSFER_OP } from "./codec/jetton.js";
+export { depositBinsToDict, parseDepositBins, sumBins } from "./codec/bins.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/jetton/index.d.ts

@@ -0,0 +1,53 @@
+import type { Address } from '@ton/core';
+import { JettonMinter } from '@ton-community/assets-sdk';
+import { type ContentResolver } from '@ton-community/assets-sdk/dist/content.js';
+import { Asset } from '../core/asset.ts';
+import { MoonError } from '../core/errors.ts';
+/**
+ * Jetton wallet addresses and metadata from the chain, via
+ * `@ton-community/assets-sdk` (on-chain TEP-64 or HTTP/IPFS metadata).
+ */
+/**
+ * A client that can open a jetton minter — `TonClient` from `@ton/ton` qualifies.
+ *
+ * Not generic on purpose: TonClient's `open` carries a type constraint that an
+ * unconstrained generic would not satisfy.
+ */
+export type OpenableClient = {
+    open(minter: JettonMinter): OpenedJettonMinter;
+};
+export type OpenedJettonMinter = {
+    getWalletAddress(owner: Address): Promise<Address>;
+    getContent(): Promise<{
+        symbol?: string;
+        decimals?: number;
+        name?: string;
+        image?: string | Uint8Array;
+    }>;
+};
+export declare class JettonLookupError extends MoonError {
+    readonly master: Address;
+    constructor(master: Address, what: string, cause: unknown);
+}
+/** Resolves jettons, caching results for the lifetime of the instance. */
+export declare class Jettons {
+    #private;
+    constructor(client: OpenableClient, options?: {
+        contentResolver?: ContentResolver;
+    });
+    /** The jetton as an {@link Asset}, with decimals, symbol, name and image read from its master. */
+    asset(master: Address): Promise<Asset>;
+    /** Native TON, or the jetton at this master. */
+    assetOf(master: Address | null): Promise<Asset>;
+    /** The owner's wallet for this jetton, from the master's `get_wallet_address`. */
+    walletOf(master: Address, owner: Address): Promise<Address>;
+    /** Wallet addresses for whichever sides of a pool are jettons. */
+    walletsFor(masters: {
+        x: Address | null;
+        y: Address;
+    }, owner: Address): Promise<{
+        x?: Address;
+        y?: Address;
+    }>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jetton/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAGxD,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,2CAA2C,CAAA;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE7C;;;GAGG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,kBAAkB,CAAA;CAC/C,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAElD,UAAU,IAAI,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAC,CAAA;CAC1G,CAAA;AAED,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;gBAEZ,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAO1D;AAED,0EAA0E;AAC1E,qBAAa,OAAO;;gBAMN,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,eAAe,CAAA;KAAE;IASnF,kGAAkG;IAC5F,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;IA2B5C,gDAAgD;IAC1C,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;IAIrD,kFAAkF;IAC5E,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBjE,kEAAkE;IAC5D,UAAU,CACd,OAAO,EAAE;QAAE,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAAC,CAAC,EAAE,OAAO,CAAA;KAAE,EAC1C,KAAK,EAAE,OAAO,GACb,OAAO,CAAC;QAAE,CAAC,CAAC,EAAE,OAAO,CAAC;QAAC,CAAC,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAOzC"}

package/dist/jetton/index.js

@@ -0,0 +1,90 @@
+import { JettonMinter } from '@ton-community/assets-sdk';
+// The content resolver is not re-exported from the package root and there is
+// no `exports` map, hence the internal path.
+import { DefaultContentResolver, } from '@ton-community/assets-sdk/dist/content.js';
+import { Asset } from "../core/asset.js";
+import { MoonError } from "../core/errors.js";
+export class JettonLookupError extends MoonError {
+    master;
+    constructor(master, what, cause) {
+        super(`could not read ${what} for jetton ${master.toString()}: ` +
+            (cause instanceof Error ? cause.message : String(cause)));
+        this.master = master;
+    }
+}
+/** Resolves jettons, caching results for the lifetime of the instance. */
+export class Jettons {
+    #client;
+    #contentResolver;
+    #assets = new Map();
+    #wallets = new Map();
+    constructor(client, options) {
+        this.#client = client;
+        this.#contentResolver = options?.contentResolver ?? new DefaultContentResolver();
+    }
+    #minter(master) {
+        return this.#client.open(JettonMinter.createFromAddress(master, this.#contentResolver));
+    }
+    /** The jetton as an {@link Asset}, with decimals, symbol, name and image read from its master. */
+    async asset(master) {
+        const key = master.toRawString();
+        const cached = this.#assets.get(key);
+        if (cached)
+            return cached;
+        const pending = (async () => {
+            try {
+                const content = await this.#minter(master).getContent();
+                return Asset.jetton(master, {
+                    decimals: content.decimals ?? 9,
+                    ...(content.symbol !== undefined ? { symbol: content.symbol } : {}),
+                    ...(typeof content.name === 'string' ? { name: content.name } : {}),
+                    ...(typeof content.image === 'string' ? { image: content.image } : {}),
+                });
+            }
+            catch (cause) {
+                throw new JettonLookupError(master, 'metadata', cause);
+            }
+        })();
+        this.#assets.set(key, pending);
+        // Coalesce concurrent reads, but let the next call retry a transient failure.
+        void pending.catch(() => {
+            if (this.#assets.get(key) === pending)
+                this.#assets.delete(key);
+        });
+        return pending;
+    }
+    /** Native TON, or the jetton at this master. */
+    async assetOf(master) {
+        return master === null ? Asset.native() : this.asset(master);
+    }
+    /** The owner's wallet for this jetton, from the master's `get_wallet_address`. */
+    async walletOf(master, owner) {
+        const key = `${master.toRawString()}|${owner.toRawString()}`;
+        const cached = this.#wallets.get(key);
+        if (cached)
+            return cached;
+        const pending = (async () => {
+            try {
+                return await this.#minter(master).getWalletAddress(owner);
+            }
+            catch (cause) {
+                throw new JettonLookupError(master, 'wallet address', cause);
+            }
+        })();
+        this.#wallets.set(key, pending);
+        void pending.catch(() => {
+            if (this.#wallets.get(key) === pending)
+                this.#wallets.delete(key);
+        });
+        return pending;
+    }
+    /** Wallet addresses for whichever sides of a pool are jettons. */
+    async walletsFor(masters, owner) {
+        const [x, y] = await Promise.all([
+            masters.x === null ? undefined : this.walletOf(masters.x, owner),
+            this.walletOf(masters.y, owner),
+        ]);
+        return { ...(x !== undefined ? { x } : {}), y };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/jetton/index.js.map

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

package/dist/math/clmm-swap.d.ts

@@ -0,0 +1,80 @@
+import type { Bin } from '../state/storage.ts';
+export type SwapStep = {
+    bin: number;
+    newSqrtPrice: bigint;
+    out: bigint;
+    remaining: bigint;
+    lpFee: bigint;
+    protocolFee: bigint;
+};
+export type ClmmSwapSimulation = {
+    amountOut: bigint;
+    /** Price after the swap, as a Q128 square root. */
+    newSqrtPrice: bigint;
+    /** Bins the swap touched, in the order it crossed them. */
+    binsCrossed: number[];
+    lpFees: bigint;
+    protocolFees: bigint;
+    /** Input that could not be filled — the range ran out of liquidity. */
+    unfilled: bigint;
+};
+/**
+ * Runs a swap against a range's bins.
+ *
+ * `xIn` decides direction: X in walks the price down through lower bins, Y in
+ * walks it up. The range stops after forty bins, so a swap large enough to
+ * cross more is refused here too, before it is signed.
+ */
+export declare function simulateClmmSwap(args: {
+    xIn: boolean;
+    amountIn: bigint;
+    bins: ReadonlyMap<bigint, Bin>;
+    currentBin: number;
+    currentSqrtPrice: bigint;
+    binStep: number;
+    lpFeeBps: number;
+    protocolFeeBps: number;
+}): ClmmSwapSimulation;
+/**
+ * Turns a slippage tolerance into the Q128 price bound the range expects.
+ *
+ * CLMM bounds a swap by price, not by output: X in must keep the price above
+ * the bound, Y in must keep it below. Zero means unbounded, which on a live
+ * pool means accepting any price at all.
+ */
+export declare function sqrtPriceLimitFor(args: {
+    xIn: boolean;
+    currentSqrtPrice: bigint;
+    slippageBps: number;
+}): bigint;
+/**
+ * Output guaranteed by the price limit, the only on-chain guard a CLMM swap has.
+ *
+ * A CLMM swap message carries no `minOut`: the range checks the price after
+ * every bin and refunds the whole input if the limit is crossed. The minimum
+ * received is therefore what follows from the limit, and this computes it.
+ *
+ * Price moves monotonically during a swap, so every chunk of input converts
+ * at a price no worse than the limit. The LP fee comes off the input and the
+ * protocol fee off the output:
+ *
+ *     xIn:  out ≥ (Δin − LP) · p_lim · (1 − f_pr)
+ *     yIn:  out ≥ (Δin − LP) / p_lim · (1 − f_pr),     p = (sqrtP/2¹²⁸)²
+ *
+ * The bound is deliberately loose. The quote places the limit one slippage
+ * tolerance beyond the post-trade price, so actual output usually exceeds
+ * the guarantee by about that tolerance; equality needs the whole swap to
+ * fill at the limit price.
+ *
+ * Rounding always goes against the caller: both fees round up and both
+ * price conversions round down.
+ */
+export declare function guaranteedOutAtLimit(args: {
+    xIn: boolean;
+    amountIn: bigint;
+    /** Q128 price limit exactly as sent in the message. Zero means no limit. */
+    sqrtPriceLimit: bigint;
+    lpFeeBps: number;
+    protocolFeeBps: number;
+}): bigint;
+//# sourceMappingURL=clmm-swap.d.ts.map

package/dist/math/clmm-swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clmm-swap.d.ts","sourceRoot":"","sources":["../../src/math/clmm-swap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AAyD9C,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAwGD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAA;IACpB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,OAAO,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;CACvB,GAAG,kBAAkB,CAkGrB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,OAAO,CAAA;IACZ,gBAAgB,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;CACpB,GAAG,MAAM,CAMT;AAgBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,OAAO,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;CACvB,GAAG,MAAM,CAqBT"}