@moon-cx/sdk 0.0.0-stage → 2.0.1

package/dist/codec/mempad.js

@@ -0,0 +1,162 @@
+import { Address, beginCell } from '@ton/core';
+import { assertLayout, constantOf, opcodeOf } from "../protocol/index.js";
+/** Field order this codec writes, per message. Checked against the protocol by the drift test. */
+export const MEMPAD_LAYOUTS = {
+    MsgCreateLaunch: ['queryId', 'salt', 'feeBps', 'initialBuy', 'content'],
+    MsgBuy: ['queryId', 'minOut'],
+    AskToBurn: ['queryId', 'jettonAmount', 'sendExcessesTo', 'customPayload'],
+    LaunchContent: ['name', 'symbol', 'image', 'extra'],
+    LaunchExtra: ['description', 'links'],
+    LaunchLinks: ['website', 'twitter', 'telegram'],
+    CurveInitData: ['factory', 'creator', 'salt'],
+};
+const op = (struct) => opcodeOf('mempad', struct);
+/**
+ * The 32-bit word that turns a burn into a sale. Without it the curve treats the
+ * burn as plain: refused with `WRONG_STATE` (555) while trading, and after
+ * graduation the tokens are destroyed with nothing paid out.
+ */
+export const SELL_MARKER = Number(constantOf('mempad', 'SELL_MARKER'));
+/** Bytes per cell in a snake chain: 1023 bits minus the ref, rounded down to whole bytes. */
+const SNAKE_BYTES_PER_CELL = 127;
+/**
+ * A string as the factory wants it: a strictly linear chain of raw UTF-8 bytes.
+ *
+ * - No TEP-64 `0x00` prefix: the factory adds it, and a second one would
+ *   become part of the stored string.
+ * - Strictly linear: the factory asserts `refs == cells - 1`, so the chain
+ *   cannot branch or be padded.
+ *
+ * Limits are in bytes, not characters.
+ */
+export function snakeChain(text) {
+    const bytes = Buffer.from(text, 'utf8');
+    const chunks = [];
+    for (let i = 0; i < bytes.length; i += SNAKE_BYTES_PER_CELL) {
+        chunks.push(bytes.subarray(i, i + SNAKE_BYTES_PER_CELL));
+    }
+    if (chunks.length === 0)
+        chunks.push(Buffer.alloc(0));
+    let cell = beginCell().storeBuffer(chunks[chunks.length - 1]).endCell();
+    for (let i = chunks.length - 2; i >= 0; i--) {
+        cell = beginCell().storeBuffer(chunks[i]).storeRef(cell).endCell();
+    }
+    return cell;
+}
+/** How many cells a string will occupy once chained. The factory caps this per field. */
+export function snakeCells(text) {
+    const length = Buffer.from(text, 'utf8').length;
+    return Math.max(1, Math.ceil(length / SNAKE_BYTES_PER_CELL));
+}
+/** Optional ref, written as `Maybe ^Cell`. */
+function storeMaybeRef(builder, cell) {
+    if (cell === null)
+        builder.storeBit(0);
+    else
+        builder.storeBit(1).storeRef(cell);
+}
+function linksCell(links) {
+    const website = links.website ? snakeChain(links.website) : null;
+    const twitter = links.twitter ? snakeChain(links.twitter) : null;
+    const telegram = links.telegram ? snakeChain(links.telegram) : null;
+    if (website === null && twitter === null && telegram === null)
+        return null;
+    const builder = beginCell();
+    storeMaybeRef(builder, website);
+    storeMaybeRef(builder, twitter);
+    storeMaybeRef(builder, telegram);
+    return builder.endCell();
+}
+/**
+ * The `LaunchContent` cell: three mandatory refs plus an optional `extra`.
+ *
+ * `description` is mandatory inside `extra`, so links without a description
+ * are dropped.
+ */
+export function encodeLaunchContent(meta) {
+    const links = meta.links ? linksCell(meta.links) : null;
+    let extra = null;
+    if (meta.description) {
+        const builder = beginCell().storeRef(snakeChain(meta.description));
+        storeMaybeRef(builder, links);
+        extra = builder.endCell();
+    }
+    const content = beginCell()
+        .storeRef(snakeChain(meta.name))
+        .storeRef(snakeChain(meta.symbol))
+        .storeRef(snakeChain(meta.image));
+    storeMaybeRef(content, extra);
+    return content.endCell();
+}
+/**
+ * `MsgCreateLaunch` — deploys a token and its bonding curve.
+ *
+ * The factory reads the bit fields positionally, so their order and widths must
+ * match exactly. The `content` ref's position does not matter.
+ */
+export function encodeCreateLaunch(args) {
+    return beginCell()
+        .storeUint(op('MsgCreateLaunch'), 32)
+        .storeUint(args.queryId, 64)
+        .storeUint(args.salt, 64)
+        .storeUint(args.feeBps, 8)
+        .storeCoins(args.initialBuy)
+        .storeRef(args.content)
+        .endCell();
+}
+/**
+ * `MsgBuy` — buys from the curve. The body carries no amount: the curve takes
+ * its overhead off the attached TON and spends the rest.
+ */
+export function encodeBuy(args) {
+    return beginCell()
+        .storeUint(op('MsgBuy'), 32)
+        .storeUint(args.queryId, 64)
+        .storeCoins(args.minOut)
+        .endCell();
+}
+/**
+ * The custom payload that marks a burn as a sale: marker word, then `minOut`.
+ * No query id; the curve reads exactly these two fields.
+ */
+export function encodeSellPayload(args) {
+    return beginCell().storeUint(SELL_MARKER, 32).storeCoins(args.minOut).endCell();
+}
+/**
+ * `AskToBurn` — sent to the seller's own jetton wallet, which forwards
+ * `customPayload` to the curve in the burn notification.
+ */
+export function encodeAskToBurn(args) {
+    const builder = beginCell()
+        .storeUint(op('AskToBurn'), 32)
+        .storeUint(args.queryId, 64)
+        .storeCoins(args.jettonAmount)
+        .storeAddress(args.sendExcessesTo);
+    storeMaybeRef(builder, args.customPayload);
+    return builder.endCell();
+}
+/** Gas units the curve charges itself for a buy. */
+export const MEMPAD_GAS_BUY = constantOf('mempad', 'GAS_BUY');
+/** What a jetton transfer costs, and exactly what a sell must attach. */
+export const MEMPAD_VALUE_JETTON_TRANSFER = constantOf('mempad', 'VALUE_JETTON_TRANSFER');
+/** The smallest purchase the curve accepts, after its overhead is removed. */
+export const MEMPAD_VALUE_MIN_BUY = constantOf('mempad', 'VALUE_MIN_BUY');
+/** The factory's own share of a deploy, on top of the launch fee. */
+export const MEMPAD_VALUE_CREATE_LAUNCH = constantOf('mempad', 'VALUE_CREATE_LAUNCH');
+/** Metadata limits, in bytes and cells, exactly as the factory asserts them. */
+export const MEMPAD_META_LIMITS = {
+    nameBytes: Number(constantOf('mempad', 'META_MAX_NAME_BYTES')),
+    symbolBytes: Number(constantOf('mempad', 'META_MAX_SYMBOL_BYTES')),
+    imageBytes: Number(constantOf('mempad', 'META_MAX_IMAGE_BYTES')),
+    imageCells: Number(constantOf('mempad', 'META_MAX_IMAGE_CELLS')),
+    descriptionBytes: Number(constantOf('mempad', 'META_MAX_DESC_BYTES')),
+    descriptionCells: Number(constantOf('mempad', 'META_MAX_DESC_CELLS')),
+    linkBytes: Number(constantOf('mempad', 'META_MAX_LINK_BYTES')),
+};
+/** Asserts this codec still matches the protocol. Called by the drift test. */
+export function assertMempadLayouts() {
+    for (const [struct, fields] of Object.entries(MEMPAD_LAYOUTS)) {
+        assertLayout('mempad', struct, fields);
+    }
+}
+//# sourceMappingURL=mempad.js.map

package/dist/codec/mempad.js.map

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

package/dist/core/amount.d.ts

@@ -0,0 +1,33 @@
+import { Asset } from './asset.ts';
+/**
+ * An amount of a specific asset, held exactly as an integer of the asset's
+ * smallest unit. Never a float: decimal input is parsed digit by digit, and
+ * carrying the asset stops amounts with different decimals from being mixed.
+ */
+export declare class Amount {
+    /** The value in the asset's smallest unit. */
+    readonly raw: bigint;
+    readonly asset: Asset;
+    constructor(raw: bigint, asset: Asset);
+    /** Wraps a value that is already in the smallest unit. */
+    static raw(value: bigint | number, asset: Asset): Amount;
+    /**
+     * Parses a human-readable amount: `Amount.of('10.5', ton)`.
+     *
+     * Prefer strings: a number with more than 15 significant digits has already
+     * lost precision before it gets here.
+     */
+    static of(value: string | number, asset: Asset): Amount;
+    static zero(asset: Asset): Amount;
+    isZero(): boolean;
+    private sameAsset;
+    plus(other: Amount): Amount;
+    minus(other: Amount): Amount;
+    /** Multiplies by a fraction, rounding down. Used for slippage and shares. */
+    mulDiv(numerator: bigint, denominator: bigint): Amount;
+    compare(other: Amount): -1 | 0 | 1;
+    /** Human-readable form, trailing zeros trimmed: `10.5`, `0.000000001`, `3`. */
+    toDecimal(): string;
+    toString(): string;
+}
+//# sourceMappingURL=amount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"amount.d.ts","sourceRoot":"","sources":["../../src/core/amount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC;;;;GAIG;AACH,qBAAa,MAAM;IACjB,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;gBAET,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;IAMrC,0DAA0D;IAC1D,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM;IAIxD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM;IAevD,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAIjC,MAAM,IAAI,OAAO;IAIjB,OAAO,CAAC,SAAS;IAQjB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAK3B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAK5B,6EAA6E;IAC7E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAKtD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAKlC,+EAA+E;IAC/E,SAAS,IAAI,MAAM;IAQnB,QAAQ,IAAI,MAAM;CAInB"}

package/dist/core/amount.js

@@ -0,0 +1,81 @@
+import { Asset } from "./asset.js";
+/**
+ * An amount of a specific asset, held exactly as an integer of the asset's
+ * smallest unit. Never a float: decimal input is parsed digit by digit, and
+ * carrying the asset stops amounts with different decimals from being mixed.
+ */
+export class Amount {
+    /** The value in the asset's smallest unit. */
+    raw;
+    asset;
+    constructor(raw, asset) {
+        if (raw < 0n)
+            throw new TypeError(`amount cannot be negative, got ${raw}`);
+        this.raw = raw;
+        this.asset = asset;
+    }
+    /** Wraps a value that is already in the smallest unit. */
+    static raw(value, asset) {
+        return new Amount(BigInt(value), asset);
+    }
+    /**
+     * Parses a human-readable amount: `Amount.of('10.5', ton)`.
+     *
+     * Prefer strings: a number with more than 15 significant digits has already
+     * lost precision before it gets here.
+     */
+    static of(value, asset) {
+        const text = typeof value === 'number' ? String(value) : value.trim();
+        if (!/^\d+(\.\d+)?$/.test(text)) {
+            throw new TypeError(`expected a non-negative decimal amount, got ${JSON.stringify(value)}`);
+        }
+        const [whole = '0', fraction = ''] = text.split('.');
+        if (fraction.length > asset.decimals) {
+            throw new TypeError(`${asset.toString()} has ${asset.decimals} decimals, but ${text} needs ${fraction.length}`);
+        }
+        const padded = fraction.padEnd(asset.decimals, '0');
+        return new Amount(BigInt(whole) * 10n ** BigInt(asset.decimals) + BigInt(padded || '0'), asset);
+    }
+    static zero(asset) {
+        return new Amount(0n, asset);
+    }
+    isZero() {
+        return this.raw === 0n;
+    }
+    sameAsset(other) {
+        if (!this.asset.equals(other.asset)) {
+            throw new TypeError(`cannot combine ${this.asset.toString()} with ${other.asset.toString()}`);
+        }
+    }
+    plus(other) {
+        this.sameAsset(other);
+        return new Amount(this.raw + other.raw, this.asset);
+    }
+    minus(other) {
+        this.sameAsset(other);
+        return new Amount(this.raw - other.raw, this.asset);
+    }
+    /** Multiplies by a fraction, rounding down. Used for slippage and shares. */
+    mulDiv(numerator, denominator) {
+        if (denominator === 0n)
+            throw new TypeError('division by zero');
+        return new Amount((this.raw * numerator) / denominator, this.asset);
+    }
+    compare(other) {
+        this.sameAsset(other);
+        return this.raw === other.raw ? 0 : this.raw < other.raw ? -1 : 1;
+    }
+    /** Human-readable form, trailing zeros trimmed: `10.5`, `0.000000001`, `3`. */
+    toDecimal() {
+        const unit = 10n ** BigInt(this.asset.decimals);
+        const whole = this.raw / unit;
+        const fraction = (this.raw % unit).toString().padStart(this.asset.decimals, '0');
+        const trimmed = fraction.replace(/0+$/, '');
+        return trimmed.length > 0 ? `${whole}.${trimmed}` : whole.toString();
+    }
+    toString() {
+        const symbol = this.asset.symbol;
+        return symbol !== undefined ? `${this.toDecimal()} ${symbol}` : this.toDecimal();
+    }
+}
+//# sourceMappingURL=amount.js.map

package/dist/core/amount.js.map

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

package/dist/core/asset.d.ts

@@ -0,0 +1,82 @@
+import { Address } from '@ton/core';
+import type { OpenableClient } from '../jetton/index.ts';
+/**
+ * An asset that can be traded or provided as liquidity: native TON, or a jetton
+ * identified by its master address.
+ *
+ * Use {@link Asset.native} and {@link Asset.jetton}; the SDK works out which
+ * pool side (`x` or `y`) an asset is on.
+ */
+export declare class Asset {
+    /** `'native'` for TON, `'jetton'` for everything else. */
+    readonly kind: 'native' | 'jetton';
+    /** Jetton master address; `null` for native TON. */
+    readonly master: Address | null;
+    /** Decimal places used when formatting amounts. TON is always 9. */
+    readonly decimals: number;
+    /** Optional display symbol. Never used in message building. */
+    readonly symbol: string | undefined;
+    /** Optional display name from the jetton metadata. Never used in message building. */
+    readonly name: string | undefined;
+    /** Optional image URL from the jetton metadata (http(s) or ipfs://), as the master states it. */
+    readonly image: string | undefined;
+    constructor(kind: 'native' | 'jetton', master: Address | null, decimals: number, symbol?: string, details?: {
+        name?: string;
+        image?: string;
+    });
+    /** Native TON. Always 9 decimals. */
+    static native(): Asset;
+    /**
+     * A jetton by master address, with the details you already know. Nothing is
+     * read from the chain; use {@link Asset.fetch} (or `moon.asset`) for that.
+     *
+     * @param master jetton master (minter) address, or its string form
+     * @param options `decimals` defaults to 9 — pass the real value if it differs,
+     *   otherwise human-readable amounts will be off by orders of magnitude
+     */
+    static jetton(master: Address | string, options?: {
+        decimals?: number;
+        symbol?: string;
+        name?: string;
+        image?: string;
+    }): Asset;
+    /**
+     * The asset at this master, with decimals, symbol, name and image read from
+     * its TEP-64 metadata (on-chain or behind an HTTP/IPFS link). `null` or
+     * `'TON'` gives native TON without a request.
+     *
+     * Each call reads again; inside a `Moon`, prefer `moon.asset(master)`, which
+     * caches per master.
+     *
+     * @param client any client that can open a jetton minter, e.g. `TonClient` from `@ton/ton`
+     * @throws JettonLookupError when the master cannot be read or its metadata
+     *   is unusable (for example decimals outside 0..30)
+     */
+    static fetch(master: Address | string | null, client: OpenableClient): Promise<Asset>;
+    isNative(): boolean;
+    equals(other: Asset): boolean;
+    toString(): string;
+}
+/**
+ * Lexicographic comparison of two serialised addresses — the TypeScript
+ * counterpart of TVM's `SDLEXCMP`, which orders a pool's two assets on chain.
+ *
+ * Returns -1, 0 or 1. A shorter slice that is a prefix of the longer one
+ * compares as smaller, matching TVM semantics.
+ */
+export declare function compareAddresses(a: Address | null, b: Address | null): -1 | 0 | 1;
+/**
+ * Orders a pair the way the factory does, so the pool address you derive
+ * is the one that actually exists on chain.
+ *
+ * Native TON always becomes X. Two jettons are ordered by `SDLEXCMP`.
+ *
+ * @returns the ordered pair, plus `inverted: true` when the arguments were
+ *   swapped — check it if you need to know which side your leg ended up on
+ */
+export declare function orderAssets(a: Asset, b: Asset): {
+    x: Asset;
+    y: Asset;
+    inverted: boolean;
+};
+//# sourceMappingURL=asset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asset.d.ts","sourceRoot":"","sources":["../../src/core/asset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAa,MAAM,WAAW,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD;;;;;;GAMG;AACH,qBAAa,KAAK;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAClC,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,iGAAiG;IACjG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;gBAGhC,IAAI,EAAE,QAAQ,GAAG,QAAQ,EACzB,MAAM,EAAE,OAAO,GAAG,IAAI,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAgB7C,qCAAqC;IACrC,MAAM,CAAC,MAAM,IAAI,KAAK;IAItB;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CACX,MAAM,EAAE,OAAO,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9E,KAAK;IAQR;;;;;;;;;;;OAWG;WACU,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAW3F,QAAQ,IAAI,OAAO;IAInB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAM7B,QAAQ,IAAI,MAAM;CAGnB;AAWD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,EAAE,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAWjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,CAAC,EAAE,KAAK,EACR,CAAC,EAAE,KAAK,GACP;IAAE,CAAC,EAAE,KAAK,CAAC;IAAC,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAY3C"}

package/dist/core/asset.js

@@ -0,0 +1,143 @@
+import { Address, beginCell } from '@ton/core';
+/**
+ * An asset that can be traded or provided as liquidity: native TON, or a jetton
+ * identified by its master address.
+ *
+ * Use {@link Asset.native} and {@link Asset.jetton}; the SDK works out which
+ * pool side (`x` or `y`) an asset is on.
+ */
+export class Asset {
+    /** `'native'` for TON, `'jetton'` for everything else. */
+    kind;
+    /** Jetton master address; `null` for native TON. */
+    master;
+    /** Decimal places used when formatting amounts. TON is always 9. */
+    decimals;
+    /** Optional display symbol. Never used in message building. */
+    symbol;
+    /** Optional display name from the jetton metadata. Never used in message building. */
+    name;
+    /** Optional image URL from the jetton metadata (http(s) or ipfs://), as the master states it. */
+    image;
+    constructor(kind, master, decimals, symbol, details) {
+        if (kind === 'jetton' && master === null) {
+            throw new TypeError('Asset.jetton requires a master address');
+        }
+        if (!Number.isInteger(decimals) || decimals < 0 || decimals > 30) {
+            throw new TypeError(`decimals must be an integer in 0..30, got ${decimals}`);
+        }
+        this.kind = kind;
+        this.master = master;
+        this.decimals = decimals;
+        this.symbol = symbol;
+        this.name = details?.name;
+        this.image = details?.image;
+    }
+    /** Native TON. Always 9 decimals. */
+    static native() {
+        return new Asset('native', null, 9, 'TON');
+    }
+    /**
+     * A jetton by master address, with the details you already know. Nothing is
+     * read from the chain; use {@link Asset.fetch} (or `moon.asset`) for that.
+     *
+     * @param master jetton master (minter) address, or its string form
+     * @param options `decimals` defaults to 9 — pass the real value if it differs,
+     *   otherwise human-readable amounts will be off by orders of magnitude
+     */
+    static jetton(master, options) {
+        const address = typeof master === 'string' ? Address.parse(master) : master;
+        return new Asset('jetton', address, options?.decimals ?? 9, options?.symbol, {
+            ...(options?.name !== undefined ? { name: options.name } : {}),
+            ...(options?.image !== undefined ? { image: options.image } : {}),
+        });
+    }
+    /**
+     * The asset at this master, with decimals, symbol, name and image read from
+     * its TEP-64 metadata (on-chain or behind an HTTP/IPFS link). `null` or
+     * `'TON'` gives native TON without a request.
+     *
+     * Each call reads again; inside a `Moon`, prefer `moon.asset(master)`, which
+     * caches per master.
+     *
+     * @param client any client that can open a jetton minter, e.g. `TonClient` from `@ton/ton`
+     * @throws JettonLookupError when the master cannot be read or its metadata
+     *   is unusable (for example decimals outside 0..30)
+     */
+    static async fetch(master, client) {
+        if (master === null || (typeof master === 'string' && master.trim().toUpperCase() === 'TON')) {
+            return Asset.native();
+        }
+        const address = typeof master === 'string' ? Address.parse(master) : master;
+        // Dynamic import keeps assets-sdk out of the light subpaths (`./math`,
+        // `./protocol`) that also load this module.
+        const { Jettons } = await import("../jetton/index.js");
+        return new Jettons(client).asset(address);
+    }
+    isNative() {
+        return this.kind === 'native';
+    }
+    equals(other) {
+        if (this.kind !== other.kind)
+            return false;
+        if (this.master === null || other.master === null)
+            return this.master === other.master;
+        return this.master.equals(other.master);
+    }
+    toString() {
+        return this.isNative() ? 'TON' : `jetton:${this.master.toString()}`;
+    }
+}
+/**
+ * Serialised MsgAddress bits, exactly as they are stored on chain.
+ * addr_none is 2 bits; addr_std is 267.
+ */
+function addressBits(address) {
+    const { bits } = beginCell().storeAddress(address).endCell();
+    return { at: (i) => bits.at(i), length: bits.length };
+}
+/**
+ * Lexicographic comparison of two serialised addresses — the TypeScript
+ * counterpart of TVM's `SDLEXCMP`, which orders a pool's two assets on chain.
+ *
+ * Returns -1, 0 or 1. A shorter slice that is a prefix of the longer one
+ * compares as smaller, matching TVM semantics.
+ */
+export function compareAddresses(a, b) {
+    const left = addressBits(a);
+    const right = addressBits(b);
+    const common = Math.min(left.length, right.length);
+    for (let i = 0; i < common; i++) {
+        const l = left.at(i);
+        const r = right.at(i);
+        if (l !== r)
+            return l ? 1 : -1;
+    }
+    if (left.length === right.length)
+        return 0;
+    return left.length < right.length ? -1 : 1;
+}
+/**
+ * Orders a pair the way the factory does, so the pool address you derive
+ * is the one that actually exists on chain.
+ *
+ * Native TON always becomes X. Two jettons are ordered by `SDLEXCMP`.
+ *
+ * @returns the ordered pair, plus `inverted: true` when the arguments were
+ *   swapped — check it if you need to know which side your leg ended up on
+ */
+export function orderAssets(a, b) {
+    if (a.isNative() && b.isNative()) {
+        throw new TypeError('a pool needs two different assets, both sides are native TON');
+    }
+    if (a.isNative())
+        return { x: a, y: b, inverted: false };
+    if (b.isNative())
+        return { x: b, y: a, inverted: true };
+    const order = compareAddresses(a.master, b.master);
+    if (order === 0) {
+        throw new TypeError(`a pool needs two different assets, both sides are ${a.toString()}`);
+    }
+    return order === -1 ? { x: a, y: b, inverted: false } : { x: b, y: a, inverted: true };
+}
+//# sourceMappingURL=asset.js.map

package/dist/core/asset.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,70 @@
+import type { Address } from '@ton/core';
+/**
+ * Base class for every SDK error. Subclasses carry the numbers involved as
+ * fields, so callers can react without parsing the message.
+ */
+export declare class MoonError extends Error {
+    constructor(message: string);
+}
+/** The built transaction would be rejected or would lose funds. Nothing was sent. */
+export declare class BuildError extends MoonError {
+}
+/** The requested pool does not exist, or its address could not be derived. */
+export declare class PoolNotFoundError extends MoonError {
+    readonly assets: [string, string];
+    constructor(assetA: string, assetB: string);
+}
+/** The pool exists but cannot trade yet — usually no liquidity, or wallets not resolved. */
+export declare class PoolNotReadyError extends MoonError {
+    readonly address: Address;
+    readonly reason: string;
+    constructor(address: Address, reason: string);
+}
+/**
+ * The attached TON would not clear an on-chain gas gate. Thrown before
+ * building: on a jetton leg the receiving pool or range throws after the
+ * jettons are credited.
+ */
+export declare class InsufficientGasError extends BuildError {
+    readonly need: bigint;
+    readonly have: bigint;
+    readonly gate: string;
+    constructor(need: bigint, have: bigint, gate: string);
+}
+/** The amount is below a minimum enforced on chain. */
+export declare class AmountTooSmallError extends BuildError {
+    readonly minimum: bigint;
+    readonly got: bigint;
+    constructor(what: string, minimum: bigint, got: bigint, gate: string);
+}
+/** An on-chain limit would be exceeded: bins per position, bins per swap, range window. */
+export declare class LimitExceededError extends BuildError {
+    readonly limit: number;
+    readonly got: number;
+    constructor(what: string, limit: number, got: number, hint?: string);
+}
+/** The quote moved further than the tolerance allows. */
+export declare class SlippageError extends MoonError {
+    readonly expected: bigint;
+    readonly got: bigint;
+    constructor(expected: bigint, got: bigint);
+}
+/** On-chain state could not be read or did not parse as the expected pool, range, position or wallet. */
+export declare class StateError extends MoonError {
+    readonly address: Address;
+    constructor(address: Address, message: string);
+}
+/** A sent message was rejected on chain. */
+export declare class ContractRejectedError extends MoonError {
+    readonly exitCode: number;
+    readonly queryId: bigint | undefined;
+    constructor(exitCode: number, description: string, queryId?: bigint);
+}
+/**
+ * Plain-language descriptions of the protocol's exit codes (identical in CPMM
+ * and CLMM; pinned by the protocol drift test).
+ */
+export declare const EXIT_CODES: Readonly<Record<number, string>>;
+/** Turns an exit code into a sentence, falling back to the bare number. */
+export declare function describeExitCode(exitCode: number): string;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED,qFAAqF;AACrF,qBAAa,UAAW,SAAQ,SAAS;CAAG;AAE5C,8EAA8E;AAC9E,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;gBAErB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI3C;AAED,4FAA4F;AAC5F,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;gBAEX,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;CAK7C;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CASrD;AAED,uDAAuD;AACvD,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;gBAER,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAKrE;AAED,2FAA2F;AAC3F,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;gBAER,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAKpE;AAED,yDAAyD;AACzD,qBAAa,aAAc,SAAQ,SAAS;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;gBAER,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAK1C;AAED,yGAAyG;AACzG,qBAAa,UAAW,SAAQ,SAAS;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;gBAEb,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;CAI9C;AAED,4CAA4C;AAC5C,qBAAa,qBAAsB,SAAQ,SAAS;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;gBAExB,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAKpE;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQvD,CAAA;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD"}