@moon-cx/sdk 0.0.0-stage → 2.0.1

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+## 2.0.1 — 2026-10-06
+
+- The package page links to the documentation: https://moon.cx/docs#sdk
+- The published protocol tables carry opcodes, field layouts, named constants and exit
+  codes only. `gatesAt`, `sourceOf` and `PROTOCOL.generatedFrom` are removed;
+  `SELL_MARKER` is a mempad constant (`constantOf('mempad', 'SELL_MARKER')`).
+- `GasRequirement.gate` and `InsufficientGasError` describe each check in words and
+  amounts.
+- Error texts changed: `(contract check: …)` is now `(on-chain check: …)`,
+  `ContractRejectedError` reads `the message was rejected on chain with exit code …`,
+  and the `EXIT_CODES` descriptions for 299, 510 and 700 are reworded. Error classes and
+  `exitCode` values are unchanged.
+
+## 2.0.0 — 2026-10-06
+
+- First release as `@moon-cx/sdk`.

package/README.md

@@ -1,3 +1,3 @@
-# Temporary Holding Version
+# @moon-cx/sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Documentation: https://moon.cx/docs#sdk

package/dist/adapters/sender.d.ts

@@ -0,0 +1,88 @@
+import type { Address } from '@ton/core';
+import { MoonError } from '../core/errors.ts';
+import type { Cell, MessageRelaxed } from '@ton/core';
+import type { BuiltOperation, TxRequest } from '../core/tx.ts';
+/**
+ * Anything that signs and sends: a keyed wallet, a TON Connect session, a
+ * multisig proposer or a queue.
+ */
+export type Sender = {
+    /** The wallet the operation is for. Used as the excess address. */
+    address: Address;
+    send(txs: readonly TxRequest[]): Promise<void>;
+};
+export declare class NoWalletError extends MoonError {
+    constructor(operation: string);
+}
+/** A prepared, unsent operation. Review it, then call {@link Operation.send}. */
+export type Operation<TDetails> = BuiltOperation<TDetails> & {
+    /** Signs and sends with the wallet it was prepared with, or `wallet` if given. */
+    send(wallet?: Sender): Promise<{
+        queryId: bigint;
+    }>;
+};
+/** Attaches `send()` to a built operation. Sends nothing by itself. */
+export declare function prepared<T>(built: BuiltOperation<T>, wallet: Sender | undefined): Operation<T>;
+/**
+ * The slice of an opened `@ton/ton` wallet the sender needs. Accepts
+ * V3R2, V4 and V5R1: `sendMode` is required and `authType` optional as in V5R1.
+ */
+export type WalletLike = {
+    address: Address;
+    getSeqno(): Promise<number>;
+    sendTransfer(args: {
+        secretKey: Buffer;
+        seqno: number;
+        sendMode: number;
+        messages: MessageRelaxed[];
+        authType?: 'external';
+    }): Promise<unknown>;
+};
+/** Builds internal messages the way `@ton/ton` expects them. `internal` fits. */
+export type InternalMessageFactory = (args: {
+    to: Address;
+    value: bigint;
+    body: Cell;
+    bounce: boolean;
+}) => MessageRelaxed;
+/**
+ * A sender backed by a wallet and its key.
+ *
+ * ```ts
+ * import { internal } from '@ton/ton'
+ * const sender = walletSender({ wallet, secretKey: keys.secretKey, internal })
+ * ```
+ *
+ * `internal` is passed in rather than imported so this package keeps no
+ * runtime dependency on `@ton/ton`.
+ */
+export declare function walletSender(args: {
+    wallet: WalletLike;
+    secretKey: Buffer;
+    internal: InternalMessageFactory;
+    /** Defaults to 3: pay fees separately, ignore errors. */
+    sendMode?: number;
+}): Sender;
+/** The slice of a TON Connect UI instance the sender needs. */
+export type TonConnectLike = {
+    account: {
+        address: string;
+    } | null;
+    sendTransaction(request: {
+        validUntil: number;
+        network?: string;
+        messages: {
+            address: string;
+            amount: string;
+            payload?: string;
+        }[];
+    }): Promise<unknown>;
+};
+/** A sender backed by TON Connect. Defaults to mainnet (`-239`) and a five-minute signing window. */
+export declare function tonConnectSender(args: {
+    connector: TonConnectLike;
+    address: Address;
+    validForSeconds?: number;
+    network?: string;
+}): Sender;
+//# sourceMappingURL=sender.d.ts.map

package/dist/adapters/sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender.d.ts","sourceRoot":"","sources":["../../src/adapters/sender.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9D;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,GAAG,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/C,CAAA;AAED,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,SAAS,EAAE,MAAM;CAM9B;AAED,iFAAiF;AACjF,MAAM,MAAM,SAAS,CAAC,QAAQ,IAAI,cAAc,CAAC,QAAQ,CAAC,GAAG;IAC3D,kFAAkF;IAClF,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACpD,CAAA;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAU9F;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3B,YAAY,CAAC,IAAI,EAAE;QACjB,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,cAAc,EAAE,CAAA;QAC1B,QAAQ,CAAC,EAAE,UAAU,CAAA;KACtB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACrB,CAAA;AAED,iFAAiF;AACjF,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE;IAC1C,EAAE,EAAE,OAAO,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,OAAO,CAAA;CAChB,KAAK,cAAc,CAAA;AAEpB;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,sBAAsB,CAAA;IAChC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,MAAM,CAcT;AAED,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACnC,eAAe,CAAC,OAAO,EAAE;QACvB,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAClE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACrB,CAAA;AAED,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,SAAS,EAAE,cAAc,CAAA;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,GAAG,MAAM,CAeT"}

package/dist/adapters/sender.js

@@ -0,0 +1,62 @@
+import { MoonError } from "../core/errors.js";
+export class NoWalletError extends MoonError {
+    constructor(operation) {
+        super(`${operation} needs to know whose it is — pass wallet: walletSender(...), ` +
+            'or sender: <address> if you are signing elsewhere');
+    }
+}
+/** Attaches `send()` to a built operation. Sends nothing by itself. */
+export function prepared(built, wallet) {
+    return {
+        ...built,
+        send: async (override) => {
+            const to = override ?? wallet;
+            if (to === undefined)
+                throw new NoWalletError('sending');
+            await to.send(built.txs);
+            return { queryId: built.queryId };
+        },
+    };
+}
+/**
+ * A sender backed by a wallet and its key.
+ *
+ * ```ts
+ * import { internal } from '@ton/ton'
+ * const sender = walletSender({ wallet, secretKey: keys.secretKey, internal })
+ * ```
+ *
+ * `internal` is passed in rather than imported so this package keeps no
+ * runtime dependency on `@ton/ton`.
+ */
+export function walletSender(args) {
+    return {
+        address: args.wallet.address,
+        async send(txs) {
+            await args.wallet.sendTransfer({
+                secretKey: args.secretKey,
+                seqno: await args.wallet.getSeqno(),
+                sendMode: args.sendMode ?? 3,
+                messages: txs.map((tx) => args.internal({ to: tx.to, value: tx.value, body: tx.body, bounce: true })),
+            });
+        },
+    };
+}
+/** A sender backed by TON Connect. Defaults to mainnet (`-239`) and a five-minute signing window. */
+export function tonConnectSender(args) {
+    return {
+        address: args.address,
+        async send(txs) {
+            await args.connector.sendTransaction({
+                validUntil: Math.floor(Date.now() / 1000) + (args.validForSeconds ?? 300),
+                network: args.network ?? '-239',
+                messages: txs.map((tx) => ({
+                    address: tx.to.toString(),
+                    amount: tx.value.toString(),
+                    payload: tx.body.toBoc().toString('base64'),
+                })),
+            });
+        },
+    };
+}
+//# sourceMappingURL=sender.js.map

package/dist/adapters/sender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender.js","sourceRoot":"","sources":["../../src/adapters/sender.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAc7C,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,YAAY,SAAiB;QAC3B,KAAK,CACH,GAAG,SAAS,+DAA+D;YACzE,mDAAmD,CACtD,CAAA;IACH,CAAC;CACF;AAQD,uEAAuE;AACvE,MAAM,UAAU,QAAQ,CAAI,KAAwB,EAAE,MAA0B;IAC9E,OAAO;QACL,GAAG,KAAK;QACR,IAAI,EAAE,KAAK,EAAE,QAAiB,EAAE,EAAE;YAChC,MAAM,EAAE,GAAG,QAAQ,IAAI,MAAM,CAAA;YAC7B,IAAI,EAAE,KAAK,SAAS;gBAAE,MAAM,IAAI,aAAa,CAAC,SAAS,CAAC,CAAA;YACxD,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YACxB,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAA;QACnC,CAAC;KACF,CAAA;AACH,CAAC;AA0BD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,IAM5B;IACC,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;QAC5B,KAAK,CAAC,IAAI,CAAC,GAAG;YACZ,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;gBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,KAAK,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;gBACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC;gBAC5B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CACvB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAC3E;aACF,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC;AAYD,qGAAqG;AACrG,MAAM,UAAU,gBAAgB,CAAC,IAKhC;IACC,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,CAAC,IAAI,CAAC,GAAG;YACZ,MAAM,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC;gBACnC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,IAAI,GAAG,CAAC;gBACzE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,MAAM;gBAC/B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBACzB,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE;oBACzB,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE;oBAC3B,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;iBAC5C,CAAC,CAAC;aACJ,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/adapters/tonclient.d.ts

@@ -0,0 +1,13 @@
+import { Address } from '@ton/core';
+import type { StateSource } from '../state/source.ts';
+/** The slice of TonClient this SDK needs, typed structurally to avoid a runtime `@ton/ton` dependency. */
+export type TonClientLike = {
+    getContractState(address: Address): Promise<{
+        code: Buffer | null;
+        data: Buffer | null;
+        balance: bigint;
+    }>;
+};
+/** Wraps a TonClient as a state source. `new Moon({ client })` does this for you. */
+export declare function tonClientSource(client: TonClientLike): StateSource;
+//# sourceMappingURL=tonclient.d.ts.map

package/dist/adapters/tonclient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tonclient.d.ts","sourceRoot":"","sources":["../../src/adapters/tonclient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAQ,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,0GAA0G;AAC1G,MAAM,MAAM,aAAa,GAAG;IAC1B,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;QAC1C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACnB,OAAO,EAAE,MAAM,CAAA;KAChB,CAAC,CAAA;CACH,CAAA;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CAYlE"}

package/dist/adapters/tonclient.js

@@ -0,0 +1,17 @@
+import { Address, Cell } from '@ton/core';
+/** Wraps a TonClient as a state source. `new Moon({ client })` does this for you. */
+export function tonClientSource(client) {
+    return {
+        async getAccountState(address) {
+            const account = await client.getContractState(address);
+            if (account.code === null || account.data === null)
+                return null;
+            return {
+                code: Cell.fromBoc(account.code)[0],
+                data: Cell.fromBoc(account.data)[0],
+                balance: account.balance,
+            };
+        },
+    };
+}
+//# sourceMappingURL=tonclient.js.map

package/dist/adapters/tonclient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tonclient.js","sourceRoot":"","sources":["../../src/adapters/tonclient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAYzC,qFAAqF;AACrF,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,OAAO;QACL,KAAK,CAAC,eAAe,CAAC,OAAgB;YACpC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;YACtD,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAA;YAC/D,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE;gBACpC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE;gBACpC,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/api/index.d.ts

@@ -0,0 +1,210 @@
+import { Address } from '@ton/core';
+import { Asset } from '../core/asset.ts';
+import { MoonError } from '../core/errors.ts';
+/**
+ * Optional backend client: pool listing, a wallet's positions, and the deployment's
+ * factory addresses. Quotes and transaction bodies are always computed locally.
+ * `Moon` sends create* calls to the factories from here unless `factories` is pinned.
+ */
+export type PoolProtocol = 'cpmm' | 'clmm';
+/** One token, as the pool listing describes it. */
+export type TokenInfo = {
+    symbol: string;
+    name: string;
+    /** Jetton master, or `null` for native TON. */
+    address: Address | null;
+    decimals: number;
+};
+/** One pool from the listing. */
+export type PoolInfo = {
+    /** Pool address. */
+    address: Address;
+    protocol: PoolProtocol;
+    tokens: {
+        x: TokenInfo;
+        y: TokenInfo;
+    };
+    /**
+     * LP fee tier in basis points, the number the pool is named by ("0.3%" for 30).
+     * Not the whole swap fee; see `totalFeeBps`.
+     */
+    feeBps: number;
+    /** Protocol share of the swap fee, basis points. `null` from a backend that does not send it. */
+    protocolFeeBps: number | null;
+    /**
+     * Total swap fee in basis points: `feeBps + protocolFeeBps`. CPMM takes both shares
+     * from the input; CLMM takes the LP share from the input and the protocol share from
+     * the output. `null` from a backend that does not send it.
+     */
+    totalFeeBps: number | null;
+    /** CLMM only. */
+    binStep: number | null;
+    tvlUsd: number | null;
+    volume24hUsd: number | null;
+    /** `null` when the backend has no meaningful APR: the pool's TVL is below its floor. */
+    aprPct: number | null;
+    price: number | null;
+};
+/**
+ * One of a wallet's positions, as the backend describes it. Use `address` to open it
+ * on chain and read the real numbers there.
+ */
+export type PositionRecord = {
+    /** The LP position address. Pass it to `pool.positionAt()` or `range.positionAt()`. */
+    address: Address;
+    /** Index within the range. `null` for CPMM, where one wallet has one position. */
+    nftIndex: bigint | null;
+    pool: Address;
+    protocol: PoolProtocol;
+    /** Backend status: `in-range`, `out-range`, or `closed`. */
+    status: string;
+    /** Bin bounds, CLMM only. */
+    bins: {
+        low: number;
+        high: number;
+    } | null;
+    /** Price bounds, CLMM only. */
+    prices: {
+        low: number;
+        high: number;
+    } | null;
+    liquidityUsd: number | null;
+    feesUsd: number | null;
+    aprPct: number | null;
+};
+export declare class MoonApiError extends MoonError {
+    readonly status: number;
+    /** The response's `Retry-After`, in milliseconds; `null` when it sent none. */
+    readonly retryAfterMs: number | null;
+    /** The response body as text, cut to 2000 characters. */
+    readonly body: string;
+    /**
+     * `true` for a 503 or 429: the same request is expected to succeed later. Check this
+     * (or `instanceof PoolIndexWarmingError`) rather than a particular status.
+     */
+    readonly retryable: boolean;
+    constructor(path: string, status: number, body: string, retryAfterMs?: number | null);
+}
+/**
+ * The backend has not finished listing pools of a protocol you asked for. Retryable:
+ * wait `retryAfterMs` (5 s when the backend does not say) and call again.
+ *
+ * Thrown instead of returning a shorter list, which would look like "no pool for this
+ * pair". Covers both a 503 from a per-protocol route and `incompleteTypes` in a 200 from
+ * `GET /v1/pools`; `status` is 503 in both cases (the 200 is visible in `body`).
+ * `load('cpmm')` still works while only CLMM is being listed.
+ */
+export declare class PoolIndexWarmingError extends MoonApiError {
+    /** Always `true`: this condition clears by itself; retry after `retryAfterMs`. */
+    readonly retryable: true;
+    /** The protocols that are not listed yet — the ones you asked for. */
+    readonly incomplete: readonly PoolProtocol[];
+    /** Never `null` here: the backend's `Retry-After` (at least 1 s), or 5 s. */
+    readonly retryAfterMs: number;
+    constructor(path: string, body: string, incomplete: readonly PoolProtocol[], retryAfterMs: number | null);
+}
+/** What GET /v1/config publishes: the network and the DEX factories. */
+export type ApiConfig = {
+    /** 'mainnet' | 'testnet' as the backend reports it; null if it says nothing. */
+    network: string | null;
+    /** null — the deployment has no such factory (not deployed or turned off). */
+    cpmmFactory: Address | null;
+    clmmFactory: Address | null;
+    /** The Degen Jackpot address. */
+    jackpot: Address | null;
+};
+/** What GET /v1/mempad/launches/config publishes about the launch factory. */
+export type ApiMempadConfig = {
+    network: string | null;
+    /** null — launches are turned off on this deployment. */
+    factory: Address | null;
+};
+export type MoonApiOptions = {
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    /** Request timeout in milliseconds. Defaults to 15 seconds. */
+    timeoutMs?: number;
+};
+export declare class MoonApi {
+    readonly baseUrl: string;
+    private readonly doFetch;
+    private readonly timeoutMs;
+    constructor(options?: MoonApiOptions);
+    private get;
+    /**
+     * Fetches the pool listing once and returns it indexed for in-memory lookups.
+     * Call {@link PoolList.refresh} for fresh numbers.
+     *
+     * The list is always complete for the protocols asked for; while the backend is
+     * still listing one of them this throws {@link PoolIndexWarmingError} (retryable).
+     */
+    load(protocol?: PoolProtocol): Promise<PoolList>;
+    /**
+     * One raw fetch of the listing as a plain array. Prefer {@link load} rather than
+     * calling this per lookup.
+     */
+    fetchPools(protocol?: PoolProtocol): Promise<PoolInfo[]>;
+    /**
+     * The deployment's network and DEX factory addresses (GET /v1/config). `Moon` asks
+     * once, when a create* call needs a factory and none was given.
+     */
+    config(): Promise<ApiConfig>;
+    /** The launch factory (GET /v1/mempad/launches/config); a separate service from {@link config}. */
+    mempadConfig(): Promise<ApiMempadConfig>;
+    /**
+     * A wallet's positions in one request. The records are pointers: open them with
+     * `range.positionAt()` and read the real numbers on chain.
+     */
+    positionsOf(wallet: Address | string, options?: {
+        pool?: Address | string;
+    }): Promise<WalletPositions>;
+}
+/**
+ * A wallet's positions, split by protocol: a CPMM position is one per pool, while a
+ * wallet can hold many CLMM positions per range.
+ */
+export declare class WalletPositions {
+    /** Every position, in the order the backend returned them. */
+    readonly all: readonly PositionRecord[];
+    readonly cpmm: readonly PositionRecord[];
+    readonly clmm: readonly PositionRecord[];
+    constructor(positions: readonly PositionRecord[]);
+    get size(): number;
+    /** Positions in one pool. */
+    inPool(pool: Address | string): PositionRecord[];
+    /** Positions the backend still considers open. */
+    active(): PositionRecord[];
+}
+/** The pool listing, fetched once and queried in memory; only {@link refresh} hits the network. */
+export declare class PoolList {
+    #private;
+    /** Every pool in the listing, in the order the backend returned them. */
+    readonly pools: readonly PoolInfo[];
+    /** Unix milliseconds when this listing was fetched. */
+    readonly fetchedAt: number;
+    constructor(api: MoonApi, protocol: PoolProtocol | undefined, pools: readonly PoolInfo[]);
+    get size(): number;
+    /** How long ago this listing was fetched, in milliseconds. */
+    get ageMs(): number;
+    /** Every pool, optionally narrowed to one protocol. */
+    all(protocol?: PoolProtocol): PoolInfo[];
+    byAddress(address: Address | string): PoolInfo | null;
+    /** Pools holding both assets, deepest first. Pure lookup, no request. */
+    find(a: Asset, b: Asset, protocol?: PoolProtocol): PoolInfo[];
+    /** The deepest pool for a pair, or `null`. */
+    best(a: Asset, b: Asset, protocol?: PoolProtocol): PoolInfo | null;
+    /** Every asset that appears in the listing, as {@link Asset} objects. */
+    assets(): Asset[];
+    /** Fetches the listing again and returns a new list. This one is unchanged. */
+    refresh(): Promise<PoolList>;
+}
+/**
+ * Turns a listing entry into SDK assets with the listing's decimals. A pool opened with
+ * them, on a client that cannot read jetton metadata, reports `'listed'` in
+ * `pool.decimalsSource` and takes amounts on that side only as raw `bigint`.
+ */
+export declare function assetsOf(pool: PoolInfo): {
+    x: Asset;
+    y: Asset;
+};
+//# sourceMappingURL=index.d.ts.map

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

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