@xian-tech/dex 0.2.0

package/README.md

@@ -0,0 +1,109 @@
+# `@xian-tech/dex`
+
+Dependency-free routing and transaction-planning primitives for DEX clients,
+agents, and browser applications. The package performs no RPC reads, key
+handling, simulation, signing, or submission.
+
+The public surface has three layers:
+
+- protocol-neutral route enumeration driven by caller-supplied pool and quote
+  adapters;
+- reusable constant-product pricing with numeric or string pool IDs and
+  optional per-pool fees;
+- an explicit canonical Xian DEX v1 adapter for `con_pairs` / `con_dex` call
+  shapes and fee-on-transfer behavior.
+
+## Canonical Xian DEX v1
+
+```ts
+import {
+  deadlineFromNow,
+  planXianDexV1ExactInExecution,
+  selectBestXianDexV1ExactInRoute,
+} from "@xian-tech/dex";
+
+const quote = selectBestXianDexV1ExactInRoute({
+  pairs,
+  fromToken: "currency",
+  toToken: "con_usdc",
+  amountIn: 10,
+  feeBps: 30,
+  maxHops: 3,
+});
+
+if (!quote) throw new Error("No route");
+
+const plan = planXianDexV1ExactInExecution({
+  quote,
+  recipient: agentAddress,
+  allowance,
+  approvalAmount: 10,
+  slippageBps: 50,
+  deadline: deadlineFromNow(15),
+  routerContract: "con_dex",
+  feeOnTransferTokens: knownFeeOnTransferTokens,
+});
+
+for (const call of plan.calls) await submitCall(call);
+```
+
+Pass `routerContract` to target another deployment of the same v1 contract
+interface. The canonical adapter chooses the supporting fee-on-transfer
+entrypoint for flagged source/destination tokens and rejects a flagged
+intermediate token.
+
+## Another DEX or Pool Model
+
+Use the routing core with records and quote semantics owned by the integration:
+
+```ts
+import { selectBestExactInRoute } from "@xian-tech/dex/routing";
+
+const quote = selectBestExactInRoute({
+  pools,
+  adapter: {
+    poolId: (pool) => pool.address,
+    tokens: (pool) => pool.assets,
+    quoteExactIn: ({ pool, fromToken, amountIn }) =>
+      quoteStablePool(pool, fromToken, amountIn),
+  },
+  fromToken: "currency",
+  toToken: "con_usdc",
+  amountIn: 10,
+});
+```
+
+An execution adapter supplies the approval and swap ABI. The generic planner
+then applies slippage and allowance rules without assuming a router contract,
+function name, or keyword shape. See `tests/execution.test.ts` for a complete
+custom-ABI example.
+
+## Boundaries
+
+- Pool state and quote adapters are caller-owned.
+- All built-in quote math currently uses JavaScript numbers. Consumers needing
+  arbitrary precision must validate against on-chain simulation before signing.
+- The generic router handles simple non-split exact-input routes. DEX-specific
+  split routing or concentrated-liquidity traversal belongs in an adapter or a
+  future focused module.
+- New DEX integrations should add adapters, not duplicate the routing core.
+
+## Validation
+
+From the `xian-js` root:
+
+```bash
+npm run typecheck
+npm run build
+npm run test
+```
+
+Against a stack localnet with the canonical demo pool installed:
+
+```bash
+XIAN_PRIVATE_KEY="$XIAN_PRIVATE_KEY" npm run test:live:dex
+```
+
+The smoke test reads real reserves and signer fees, plans through the Xian DEX
+v1 adapter, submits any required approval plus the exact planned router call,
+and requires finalized successful receipts.

package/dist/adapters/xian-v1.d.ts

@@ -0,0 +1,73 @@
+import { type ConstantProductExactInQuote, type ConstantProductPool } from "../constant-product.js";
+import { type ContractCallPlan, type ExactInExecutionAdapter, type ExactInExecutionPlan, type ExactInSwapPlan, type XianDatetime } from "../execution.js";
+export declare const DEFAULT_XIAN_DEX_V1_CONTRACTS: {
+    readonly router: "con_dex";
+    readonly pairs: "con_pairs";
+};
+export declare const DEFAULT_XIAN_DEX_V1_TRADE_FEE_BPS = 30;
+export interface XianFixed {
+    __fixed__: string;
+}
+export interface XianDexV1Pair extends Omit<ConstantProductPool<number>, "feeBps"> {
+}
+export interface XianDexV1ExactInQuoteHop {
+    pairId: number;
+    fromToken: string;
+    toToken: string;
+    reserveIn: number;
+    reserveOut: number;
+    amountIn: number;
+    amountOut: number;
+}
+export interface XianDexV1ExactInQuote extends Omit<ConstantProductExactInQuote<number>, "hops"> {
+    hops: XianDexV1ExactInQuoteHop[];
+    /** The canonical v1 signer fee applied uniformly to each hop. */
+    feeBps: number;
+}
+export interface XianDexV1QuoteRequest {
+    pairs: readonly XianDexV1Pair[];
+    fromToken: string;
+    toToken: string;
+    amountIn: number;
+    feeBps?: number;
+    maxHops?: number;
+}
+export interface XianDexV1ExecutionOptions {
+    routerContract?: string;
+    feeOnTransferTokens?: Iterable<string>;
+    supportingFeeOnTransfer?: boolean;
+}
+interface XianDexV1ExecutionMetadata {
+    supportingFeeOnTransfer: boolean;
+}
+export interface XianDexV1TokenApprovalRequest {
+    token: string;
+    spender?: string;
+    amount: number;
+}
+export interface XianDexV1SwapPlanRequest extends XianDexV1ExecutionOptions {
+    quote: XianDexV1ExactInQuote;
+    recipient: string;
+    slippageBps: number;
+    deadline: XianDatetime;
+}
+export interface XianDexV1ExecutionPlanRequest extends XianDexV1SwapPlanRequest {
+    allowance: number;
+    approvalAmount?: number;
+}
+export interface XianDexV1SwapPlan extends ExactInSwapPlan<XianDexV1ExecutionMetadata> {
+    supportingFeeOnTransfer: boolean;
+}
+export interface XianDexV1ExecutionPlan extends ExactInExecutionPlan<XianDexV1ExecutionMetadata> {
+    supportingFeeOnTransfer: boolean;
+}
+/** Encode a deterministic decimal for Xian transaction payloads. */
+export declare function xianFixed(value: number | string): XianFixed;
+export declare function enumerateXianDexV1ExactInRoutes(request: XianDexV1QuoteRequest): XianDexV1ExactInQuote[];
+export declare function selectBestXianDexV1ExactInRoute(request: XianDexV1QuoteRequest): XianDexV1ExactInQuote | null;
+export declare function planXianDexV1TokenApproval(request: XianDexV1TokenApprovalRequest): ContractCallPlan;
+export declare function createXianDexV1ExecutionAdapter(): ExactInExecutionAdapter<XianDexV1ExactInQuote, XianDexV1ExecutionOptions, XianDexV1ExecutionMetadata>;
+export declare function planXianDexV1ExactInSwap(request: XianDexV1SwapPlanRequest): XianDexV1SwapPlan;
+export declare function planXianDexV1ExactInExecution(request: XianDexV1ExecutionPlanRequest): XianDexV1ExecutionPlan;
+export {};
+//# sourceMappingURL=xian-v1.d.ts.map

package/dist/adapters/xian-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xian-v1.d.ts","sourceRoot":"","sources":["../../src/adapters/xian-v1.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,2BAA2B,EAEhC,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AAGzB,eAAO,MAAM,6BAA6B;;;CAGhC,CAAC;AAEX,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;CAAG;AAErF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,2BAA2B,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzD,IAAI,EAAE,wBAAwB,EAAE,CAAC;IACjC,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,UAAU,0BAA0B;IAClC,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAyB,SAAQ,yBAAyB;IACzE,KAAK,EAAE,qBAAqB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,6BAA8B,SAAQ,wBAAwB;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe,CAAC,0BAA0B,CAAC;IACpF,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,sBACf,SAAQ,oBAAoB,CAAC,0BAA0B,CAAC;IACxD,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAYD,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM3D;AAeD,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,qBAAqB,GAC7B,qBAAqB,EAAE,CAuBzB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,qBAAqB,GAC7B,qBAAqB,GAAG,IAAI,CAE9B;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,6BAA6B,GACrC,gBAAgB,CAUlB;AAED,wBAAgB,+BAA+B,IAAI,uBAAuB,CACxE,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,CAC3B,CA+CA;AAUD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CAanB;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,6BAA6B,GACrC,sBAAsB,CAexB"}

package/dist/adapters/xian-v1.js

@@ -0,0 +1,153 @@
+import { createConstantProductAdapter, } from "../constant-product.js";
+import { planExactInExecution, planExactInSwap, } from "../execution.js";
+import { enumerateExactInRoutes } from "../routing.js";
+export const DEFAULT_XIAN_DEX_V1_CONTRACTS = {
+    router: "con_dex",
+    pairs: "con_pairs",
+};
+export const DEFAULT_XIAN_DEX_V1_TRADE_FEE_BPS = 30;
+function assertNonEmpty(value, label) {
+    if (value.trim().length === 0)
+        throw new RangeError(`${label} must not be empty`);
+}
+function assertFinitePositive(value, label) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new RangeError(`${label} must be a finite positive number`);
+    }
+}
+/** Encode a deterministic decimal for Xian transaction payloads. */
+export function xianFixed(value) {
+    const text = String(value).trim();
+    if (text.length === 0 || !Number.isFinite(Number(text))) {
+        throw new RangeError("fixed value must be finite");
+    }
+    return { __fixed__: text };
+}
+function routeEndpoints(quote) {
+    if (quote.hops.length === 0 || quote.path.length !== quote.hops.length) {
+        throw new RangeError("quote must contain matching non-empty hops and path");
+    }
+    const firstHop = quote.hops[0];
+    const lastHop = quote.hops[quote.hops.length - 1];
+    if (!firstHop || !lastHop)
+        throw new RangeError("quote route is incomplete");
+    return { source: firstHop.fromToken, destination: lastHop.toToken };
+}
+export function enumerateXianDexV1ExactInRoutes(request) {
+    const feeBps = request.feeBps ?? DEFAULT_XIAN_DEX_V1_TRADE_FEE_BPS;
+    const quotes = enumerateExactInRoutes({
+        pools: request.pairs,
+        adapter: createConstantProductAdapter(feeBps),
+        fromToken: request.fromToken,
+        toToken: request.toToken,
+        amountIn: request.amountIn,
+        maxHops: request.maxHops,
+    });
+    return quotes.map((quote) => ({
+        ...quote,
+        feeBps,
+        hops: quote.hops.map((hop) => ({
+            pairId: hop.poolId,
+            fromToken: hop.fromToken,
+            toToken: hop.toToken,
+            reserveIn: hop.metadata.reserveIn,
+            reserveOut: hop.metadata.reserveOut,
+            amountIn: hop.amountIn,
+            amountOut: hop.amountOut,
+        })),
+    }));
+}
+export function selectBestXianDexV1ExactInRoute(request) {
+    return enumerateXianDexV1ExactInRoutes(request)[0] ?? null;
+}
+export function planXianDexV1TokenApproval(request) {
+    assertNonEmpty(request.token, "token");
+    const spender = request.spender ?? DEFAULT_XIAN_DEX_V1_CONTRACTS.router;
+    assertNonEmpty(spender, "spender");
+    assertFinitePositive(request.amount, "approval amount");
+    return {
+        contract: request.token,
+        function: "approve",
+        kwargs: { amount: xianFixed(request.amount), to: spender },
+    };
+}
+export function createXianDexV1ExecutionAdapter() {
+    return {
+        amountIn: (quote) => quote.amountIn,
+        amountOut: (quote) => quote.amountOut,
+        sourceToken: (quote) => routeEndpoints(quote).source,
+        approvalSpender: (options) => options.routerContract ?? DEFAULT_XIAN_DEX_V1_CONTRACTS.router,
+        buildApprovalCall: ({ token, spender, amount }) => planXianDexV1TokenApproval({ token, spender, amount }),
+        buildSwapCall: ({ quote, recipient, amountOutMin, deadline, options }) => {
+            const routerContract = options.routerContract ?? DEFAULT_XIAN_DEX_V1_CONTRACTS.router;
+            assertNonEmpty(routerContract, "routerContract");
+            const { source, destination } = routeEndpoints(quote);
+            const feeOnTransferTokens = new Set(options.feeOnTransferTokens ?? []);
+            const blockedIntermediate = quote.hops
+                .slice(0, -1)
+                .map((hop) => hop.toToken)
+                .find((token) => feeOnTransferTokens.has(token));
+            if (blockedIntermediate) {
+                throw new RangeError(`fee-on-transfer token ${blockedIntermediate} cannot be an intermediate route token`);
+            }
+            const supportingFeeOnTransfer = options.supportingFeeOnTransfer === true ||
+                feeOnTransferTokens.has(source) ||
+                feeOnTransferTokens.has(destination);
+            return {
+                call: {
+                    contract: routerContract,
+                    function: supportingFeeOnTransfer
+                        ? "swapExactTokensForTokensSupportingFeeOnTransferTokens"
+                        : "swapExactTokensForTokens",
+                    kwargs: {
+                        amountIn: xianFixed(quote.amountIn),
+                        amountOutMin: xianFixed(amountOutMin),
+                        path: [...quote.path],
+                        src: source,
+                        to: recipient,
+                        deadline,
+                    },
+                },
+                metadata: { supportingFeeOnTransfer },
+            };
+        },
+    };
+}
+function executionOptions(request) {
+    return {
+        routerContract: request.routerContract,
+        feeOnTransferTokens: request.feeOnTransferTokens,
+        supportingFeeOnTransfer: request.supportingFeeOnTransfer,
+    };
+}
+export function planXianDexV1ExactInSwap(request) {
+    const plan = planExactInSwap({
+        quote: request.quote,
+        recipient: request.recipient,
+        slippageBps: request.slippageBps,
+        deadline: request.deadline,
+        adapter: createXianDexV1ExecutionAdapter(),
+        options: executionOptions(request),
+    });
+    return {
+        ...plan,
+        supportingFeeOnTransfer: plan.adapterMetadata.supportingFeeOnTransfer,
+    };
+}
+export function planXianDexV1ExactInExecution(request) {
+    const plan = planExactInExecution({
+        quote: request.quote,
+        recipient: request.recipient,
+        allowance: request.allowance,
+        approvalAmount: request.approvalAmount,
+        slippageBps: request.slippageBps,
+        deadline: request.deadline,
+        adapter: createXianDexV1ExecutionAdapter(),
+        options: executionOptions(request),
+    });
+    return {
+        ...plan,
+        supportingFeeOnTransfer: plan.adapterMetadata.supportingFeeOnTransfer,
+    };
+}
+//# sourceMappingURL=xian-v1.js.map

package/dist/adapters/xian-v1.js.map

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

package/dist/constant-product.d.ts

@@ -0,0 +1,30 @@
+import { type ExactInQuote, type ExactInRoutingAdapter, type PoolId } from "./routing.js";
+export declare const DEFAULT_CONSTANT_PRODUCT_FEE_BPS = 30;
+export interface ConstantProductPool<Id extends PoolId = PoolId> {
+    id: Id;
+    token0: string;
+    token1: string;
+    reserve0: number;
+    reserve1: number;
+    /** Optional pool-specific fee; otherwise the adapter default is used. */
+    feeBps?: number;
+}
+export interface ConstantProductHopMetadata {
+    reserveIn: number;
+    reserveOut: number;
+    feeBps: number;
+}
+export type ConstantProductExactInQuote<Id extends PoolId = PoolId> = ExactInQuote<Id, ConstantProductHopMetadata>;
+export interface ConstantProductQuoteRequest<Id extends PoolId> {
+    pools: readonly ConstantProductPool<Id>[];
+    fromToken: string;
+    toToken: string;
+    amountIn: number;
+    defaultFeeBps?: number;
+    maxHops?: number;
+}
+export declare function amountOutForExactIn(amountIn: number, reserveIn: number, reserveOut: number, feeBps?: number): number;
+export declare function createConstantProductAdapter<Id extends PoolId>(defaultFeeBps?: number): ExactInRoutingAdapter<ConstantProductPool<Id>, Id, ConstantProductHopMetadata>;
+export declare function enumerateConstantProductExactInRoutes<Id extends PoolId>(request: ConstantProductQuoteRequest<Id>): ConstantProductExactInQuote<Id>[];
+export declare function selectBestConstantProductExactInRoute<Id extends PoolId>(request: ConstantProductQuoteRequest<Id>): ConstantProductExactInQuote<Id> | null;
+//# sourceMappingURL=constant-product.d.ts.map

package/dist/constant-product.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant-product.d.ts","sourceRoot":"","sources":["../src/constant-product.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,MAAM,EACZ,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD,MAAM,WAAW,mBAAmB,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM;IAC7D,EAAE,EAAE,EAAE,CAAC;IACP,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,2BAA2B,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,IAAI,YAAY,CAChF,EAAE,EACF,0BAA0B,CAC3B,CAAC;AAEF,MAAM,WAAW,2BAA2B,CAAC,EAAE,SAAS,MAAM;IAC5D,KAAK,EAAE,SAAS,mBAAmB,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,SAAmC,GACxC,MAAM,CAcR;AAED,wBAAgB,4BAA4B,CAAC,EAAE,SAAS,MAAM,EAC5D,aAAa,SAAmC,GAC/C,qBAAqB,CACtB,mBAAmB,CAAC,EAAE,CAAC,EACvB,EAAE,EACF,0BAA0B,CAC3B,CAqBA;AAED,wBAAgB,qCAAqC,CAAC,EAAE,SAAS,MAAM,EACrE,OAAO,EAAE,2BAA2B,CAAC,EAAE,CAAC,GACvC,2BAA2B,CAAC,EAAE,CAAC,EAAE,CASnC;AAED,wBAAgB,qCAAqC,CAAC,EAAE,SAAS,MAAM,EACrE,OAAO,EAAE,2BAA2B,CAAC,EAAE,CAAC,GACvC,2BAA2B,CAAC,EAAE,CAAC,GAAG,IAAI,CASxC"}

package/dist/constant-product.js

@@ -0,0 +1,65 @@
+import { enumerateExactInRoutes, selectBestExactInRoute, } from "./routing.js";
+export const DEFAULT_CONSTANT_PRODUCT_FEE_BPS = 30;
+function assertBps(value, label) {
+    if (!Number.isInteger(value) || value < 0 || value > 10_000) {
+        throw new RangeError(`${label} must be an integer from 0 to 10000`);
+    }
+}
+export function amountOutForExactIn(amountIn, reserveIn, reserveOut, feeBps = DEFAULT_CONSTANT_PRODUCT_FEE_BPS) {
+    assertBps(feeBps, "feeBps");
+    if (!Number.isFinite(amountIn) ||
+        !Number.isFinite(reserveIn) ||
+        !Number.isFinite(reserveOut) ||
+        amountIn <= 0 ||
+        reserveIn <= 0 ||
+        reserveOut <= 0) {
+        return 0;
+    }
+    const amountInWithFee = amountIn * ((10_000 - feeBps) / 10_000);
+    return (amountInWithFee * reserveOut) / (reserveIn + amountInWithFee);
+}
+export function createConstantProductAdapter(defaultFeeBps = DEFAULT_CONSTANT_PRODUCT_FEE_BPS) {
+    assertBps(defaultFeeBps, "defaultFeeBps");
+    return {
+        poolId: (pool) => pool.id,
+        tokens: (pool) => [pool.token0, pool.token1],
+        quoteExactIn: ({ pool, fromToken, toToken, amountIn }) => {
+            const forward = fromToken === pool.token0 && toToken === pool.token1;
+            const reverse = fromToken === pool.token1 && toToken === pool.token0;
+            if (!forward && !reverse)
+                return null;
+            const reserveIn = forward ? pool.reserve0 : pool.reserve1;
+            const reserveOut = forward ? pool.reserve1 : pool.reserve0;
+            const feeBps = pool.feeBps ?? defaultFeeBps;
+            const amountOut = amountOutForExactIn(amountIn, reserveIn, reserveOut, feeBps);
+            if (amountOut <= 0)
+                return null;
+            return {
+                amountOut,
+                midPriceOut: reserveOut / reserveIn,
+                metadata: { reserveIn, reserveOut, feeBps },
+            };
+        },
+    };
+}
+export function enumerateConstantProductExactInRoutes(request) {
+    return enumerateExactInRoutes({
+        pools: request.pools,
+        adapter: createConstantProductAdapter(request.defaultFeeBps),
+        fromToken: request.fromToken,
+        toToken: request.toToken,
+        amountIn: request.amountIn,
+        maxHops: request.maxHops,
+    });
+}
+export function selectBestConstantProductExactInRoute(request) {
+    return selectBestExactInRoute({
+        pools: request.pools,
+        adapter: createConstantProductAdapter(request.defaultFeeBps),
+        fromToken: request.fromToken,
+        toToken: request.toToken,
+        amountIn: request.amountIn,
+        maxHops: request.maxHops,
+    });
+}
+//# sourceMappingURL=constant-product.js.map

package/dist/constant-product.js.map

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

package/dist/execution.d.ts

@@ -0,0 +1,58 @@
+export interface XianDatetime {
+    __time__: [number, number, number, number, number, number, number];
+}
+export interface ContractCallPlan {
+    contract: string;
+    function: string;
+    kwargs: Record<string, unknown>;
+}
+export interface ExactInExecutionAdapter<Quote, Options, Metadata = unknown> {
+    amountIn(quote: Quote): number;
+    amountOut(quote: Quote): number;
+    sourceToken(quote: Quote): string;
+    approvalSpender(options: Options): string;
+    buildSwapCall(args: {
+        quote: Quote;
+        recipient: string;
+        amountOutMin: number;
+        deadline: XianDatetime;
+        options: Options;
+    }): {
+        call: ContractCallPlan;
+        metadata: Metadata;
+    };
+    buildApprovalCall(args: {
+        token: string;
+        spender: string;
+        amount: number;
+        options: Options;
+    }): ContractCallPlan;
+}
+export interface ExactInSwapPlanRequest<Quote, Options, Metadata = unknown> {
+    quote: Quote;
+    recipient: string;
+    slippageBps: number;
+    deadline: XianDatetime;
+    adapter: ExactInExecutionAdapter<Quote, Options, Metadata>;
+    options: Options;
+}
+export interface ExactInSwapPlan<Metadata = unknown> {
+    call: ContractCallPlan;
+    amountOutMin: number;
+    adapterMetadata: Metadata;
+}
+export interface ExactInExecutionPlanRequest<Quote, Options, Metadata = unknown> extends ExactInSwapPlanRequest<Quote, Options, Metadata> {
+    allowance: number;
+    approvalAmount?: number;
+}
+export interface ExactInExecutionPlan<Metadata = unknown> extends ExactInSwapPlan<Metadata> {
+    approval: ContractCallPlan | null;
+    calls: ContractCallPlan[];
+}
+export declare function minimumAmountOut(amountOut: number, slippageBps: number): number;
+export declare function deadlineFromDate(date: Date): XianDatetime;
+export declare function deadlineFromNow(minutesFromNow: number, now?: number | Date): XianDatetime;
+export declare function requiresApproval(allowance: number, amountIn: number): boolean;
+export declare function planExactInSwap<Quote, Options, Metadata = unknown>(request: ExactInSwapPlanRequest<Quote, Options, Metadata>): ExactInSwapPlan<Metadata>;
+export declare function planExactInExecution<Quote, Options, Metadata = unknown>(request: ExactInExecutionPlanRequest<Quote, Options, Metadata>): ExactInExecutionPlan<Metadata>;
+//# sourceMappingURL=execution.d.ts.map

package/dist/execution.d.ts.map

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

package/dist/execution.js

@@ -0,0 +1,90 @@
+function assertNonEmpty(value, label) {
+    if (value.trim().length === 0)
+        throw new RangeError(`${label} must not be empty`);
+}
+function assertFiniteNonNegative(value, label) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new RangeError(`${label} must be a finite non-negative number`);
+    }
+}
+function assertFinitePositive(value, label) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new RangeError(`${label} must be a finite positive number`);
+    }
+}
+function assertBps(value, label) {
+    if (!Number.isInteger(value) || value < 0 || value > 10_000) {
+        throw new RangeError(`${label} must be an integer from 0 to 10000`);
+    }
+}
+export function minimumAmountOut(amountOut, slippageBps) {
+    assertFiniteNonNegative(amountOut, "amountOut");
+    assertBps(slippageBps, "slippageBps");
+    return amountOut * (1 - slippageBps / 10_000);
+}
+export function deadlineFromDate(date) {
+    if (!Number.isFinite(date.getTime()))
+        throw new RangeError("deadline date must be valid");
+    return {
+        __time__: [
+            date.getUTCFullYear(),
+            date.getUTCMonth() + 1,
+            date.getUTCDate(),
+            date.getUTCHours(),
+            date.getUTCMinutes(),
+            date.getUTCSeconds(),
+            date.getUTCMilliseconds() * 1_000,
+        ],
+    };
+}
+export function deadlineFromNow(minutesFromNow, now = Date.now()) {
+    assertFiniteNonNegative(minutesFromNow, "minutesFromNow");
+    const nowMs = now instanceof Date ? now.getTime() : now;
+    if (!Number.isFinite(nowMs))
+        throw new RangeError("now must be a valid date or timestamp");
+    return deadlineFromDate(new Date(nowMs + minutesFromNow * 60_000));
+}
+export function requiresApproval(allowance, amountIn) {
+    assertFiniteNonNegative(allowance, "allowance");
+    assertFinitePositive(amountIn, "amountIn");
+    return allowance < amountIn;
+}
+export function planExactInSwap(request) {
+    assertNonEmpty(request.recipient, "recipient");
+    const amountIn = request.adapter.amountIn(request.quote);
+    const amountOut = request.adapter.amountOut(request.quote);
+    assertFinitePositive(amountIn, "quote amountIn");
+    assertFiniteNonNegative(amountOut, "quote amountOut");
+    const amountOutMin = minimumAmountOut(amountOut, request.slippageBps);
+    const built = request.adapter.buildSwapCall({
+        quote: request.quote,
+        recipient: request.recipient,
+        amountOutMin,
+        deadline: request.deadline,
+        options: request.options,
+    });
+    return { call: built.call, amountOutMin, adapterMetadata: built.metadata };
+}
+export function planExactInExecution(request) {
+    const swap = planExactInSwap(request);
+    const amountIn = request.adapter.amountIn(request.quote);
+    const approvalNeeded = requiresApproval(request.allowance, amountIn);
+    const approvalAmount = request.approvalAmount ?? amountIn;
+    if (approvalNeeded && approvalAmount < amountIn) {
+        throw new RangeError("approvalAmount must cover the exact input amount");
+    }
+    const approval = approvalNeeded
+        ? request.adapter.buildApprovalCall({
+            token: request.adapter.sourceToken(request.quote),
+            spender: request.adapter.approvalSpender(request.options),
+            amount: approvalAmount,
+            options: request.options,
+        })
+        : null;
+    return {
+        ...swap,
+        approval,
+        calls: approval ? [approval, swap.call] : [swap.call],
+    };
+}
+//# sourceMappingURL=execution.js.map

package/dist/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../src/execution.ts"],"names":[],"mappings":"AAyDA,SAAS,cAAc,CAAC,KAAa,EAAE,KAAa;IAClD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;AACpF,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa,EAAE,KAAa;IAC3D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,UAAU,CAAC,GAAG,KAAK,uCAAuC,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa,EAAE,KAAa;IACxD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,UAAU,CAAC,GAAG,KAAK,mCAAmC,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,KAAa;IAC7C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,MAAM,EAAE,CAAC;QAC5D,MAAM,IAAI,UAAU,CAAC,GAAG,KAAK,qCAAqC,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,WAAmB;IACrE,uBAAuB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAChD,SAAS,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACtC,OAAO,SAAS,GAAG,CAAC,CAAC,GAAG,WAAW,GAAG,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAU;IACzC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,6BAA6B,CAAC,CAAC;IAC1F,OAAO;QACL,QAAQ,EAAE;YACR,IAAI,CAAC,cAAc,EAAE;YACrB,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC;YACtB,IAAI,CAAC,UAAU,EAAE;YACjB,IAAI,CAAC,WAAW,EAAE;YAClB,IAAI,CAAC,aAAa,EAAE;YACpB,IAAI,CAAC,aAAa,EAAE;YACpB,IAAI,CAAC,kBAAkB,EAAE,GAAG,KAAK;SAClC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,cAAsB,EACtB,MAAqB,IAAI,CAAC,GAAG,EAAE;IAE/B,uBAAuB,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,GAAG,YAAY,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,uCAAuC,CAAC,CAAC;IAC3F,OAAO,gBAAgB,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,cAAc,GAAG,MAAM,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,QAAgB;IAClE,uBAAuB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAChD,oBAAoB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC3C,OAAO,SAAS,GAAG,QAAQ,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAAyD;IAEzD,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3D,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IACjD,uBAAuB,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;QAC1C,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY;QACZ,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;IACH,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAA8D;IAE9D,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,QAAQ,CAAC;IAC1D,IAAI,cAAc,IAAI,cAAc,GAAG,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,UAAU,CAAC,kDAAkD,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,QAAQ,GAAG,cAAc;QAC7B,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC;YAChC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;YACjD,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC;YACzD,MAAM,EAAE,cAAc;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IACT,OAAO;QACL,GAAG,IAAI;QACP,QAAQ;QACR,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KACtD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./routing.js";
+export * from "./constant-product.js";
+export * from "./execution.js";
+export * from "./adapters/xian-v1.js";
+//# 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":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./routing.js";
+export * from "./constant-product.js";
+export * from "./execution.js";
+export * from "./adapters/xian-v1.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":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}

package/dist/routing.d.ts

@@ -0,0 +1,50 @@
+export declare const DEFAULT_MAX_HOPS = 3;
+export type PoolId = string | number;
+export interface ExactInPoolQuote<HopMetadata = unknown> {
+    amountOut: number;
+    /** Output tokens per input token before price impact and fees. */
+    midPriceOut: number;
+    metadata: HopMetadata;
+}
+export interface ExactInRoutingAdapter<Pool, Id extends PoolId, HopMetadata = unknown> {
+    poolId(pool: Pool): Id;
+    tokens(pool: Pool): readonly [string, string];
+    quoteExactIn(args: {
+        pool: Pool;
+        fromToken: string;
+        toToken: string;
+        amountIn: number;
+    }): ExactInPoolQuote<HopMetadata> | null;
+    comparePoolIds?(left: Id, right: Id): number;
+}
+export interface ExactInQuoteHop<Id extends PoolId, HopMetadata = unknown> {
+    poolId: Id;
+    fromToken: string;
+    toToken: string;
+    amountIn: number;
+    amountOut: number;
+    metadata: HopMetadata;
+}
+export interface ExactInQuote<Id extends PoolId = PoolId, HopMetadata = unknown> {
+    amountIn: number;
+    amountOut: number;
+    hops: ExactInQuoteHop<Id, HopMetadata>[];
+    path: Id[];
+    /** Fractional loss versus the route's spot mid-price, including route fees. */
+    priceImpact: number;
+    /** Output tokens per input token at the route's zero-impact spot price. */
+    midPriceOut: number;
+}
+export interface ExactInQuoteRequest<Pool, Id extends PoolId, HopMetadata = unknown> {
+    pools: readonly Pool[];
+    adapter: ExactInRoutingAdapter<Pool, Id, HopMetadata>;
+    fromToken: string;
+    toToken: string;
+    amountIn: number;
+    maxHops?: number;
+}
+export declare function calculatePriceImpact(amountIn: number, amountOut: number, midPriceOut: number): number;
+/** Enumerate viable simple routes using caller-supplied pool and quote semantics. */
+export declare function enumerateExactInRoutes<Pool, Id extends PoolId, HopMetadata = unknown>(request: ExactInQuoteRequest<Pool, Id, HopMetadata>): ExactInQuote<Id, HopMetadata>[];
+export declare function selectBestExactInRoute<Pool, Id extends PoolId, HopMetadata = unknown>(request: ExactInQuoteRequest<Pool, Id, HopMetadata>): ExactInQuote<Id, HopMetadata> | null;
+//# sourceMappingURL=routing.d.ts.map

package/dist/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAErC,MAAM,WAAW,gBAAgB,CAAC,WAAW,GAAG,OAAO;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB,CACpC,IAAI,EACJ,EAAE,SAAS,MAAM,EACjB,WAAW,GAAG,OAAO;IAErB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;IACvB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,YAAY,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,IAAI,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,gBAAgB,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACzC,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC;CAC9C;AAED,MAAM,WAAW,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,WAAW,GAAG,OAAO;IACvE,MAAM,EAAE,EAAE,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,EAAE,WAAW,GAAG,OAAO;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC;IACzC,IAAI,EAAE,EAAE,EAAE,CAAC;IACX,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB,CAClC,IAAI,EACJ,EAAE,SAAS,MAAM,EACjB,WAAW,GAAG,OAAO;IAErB,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IACvB,OAAO,EAAE,qBAAqB,CAAC,IAAI,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2JD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,MAAM,CAGR;AAqDD,qFAAqF;AACrF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,EAAE,SAAS,MAAM,EAAE,WAAW,GAAG,OAAO,EACnF,OAAO,EAAE,mBAAmB,CAAC,IAAI,EAAE,EAAE,EAAE,WAAW,CAAC,GAClD,YAAY,CAAC,EAAE,EAAE,WAAW,CAAC,EAAE,CA+BjC;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,EAAE,SAAS,MAAM,EAAE,WAAW,GAAG,OAAO,EACnF,OAAO,EAAE,mBAAmB,CAAC,IAAI,EAAE,EAAE,EAAE,WAAW,CAAC,GAClD,YAAY,CAAC,EAAE,EAAE,WAAW,CAAC,GAAG,IAAI,CAEtC"}

package/dist/routing.js

@@ -0,0 +1,192 @@
+export const DEFAULT_MAX_HOPS = 3;
+function assertNonEmpty(value, label) {
+    if (value.trim().length === 0)
+        throw new RangeError(`${label} must not be empty`);
+}
+function assertFinitePositive(value, label) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new RangeError(`${label} must be a finite positive number`);
+    }
+}
+function compareStrings(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function defaultComparePoolIds(left, right) {
+    if (typeof left === "number" && typeof right === "number")
+        return left - right;
+    const leftKey = `${typeof left}:${String(left)}`;
+    const rightKey = `${typeof right}:${String(right)}`;
+    return compareStrings(leftKey, rightKey);
+}
+function compareIdLists(left, right, compare) {
+    const sharedLength = Math.min(left.length, right.length);
+    for (let index = 0; index < sharedLength; index += 1) {
+        const leftValue = left[index];
+        const rightValue = right[index];
+        if (leftValue === undefined || rightValue === undefined)
+            continue;
+        const result = compare(leftValue, rightValue);
+        if (result !== 0)
+            return result;
+    }
+    return left.length - right.length;
+}
+function poolIdentity(id) {
+    return `${typeof id}:${String(id)}`;
+}
+function buildAdjacency(pools, adapter) {
+    const adjacency = new Map();
+    const seenPoolIds = new Set();
+    const compareIds = adapter.comparePoolIds ?? defaultComparePoolIds;
+    const sortedPools = [...pools].sort((left, right) => {
+        const idComparison = compareIds(adapter.poolId(left), adapter.poolId(right));
+        if (idComparison !== 0)
+            return idComparison;
+        const [left0, left1] = adapter.tokens(left);
+        const [right0, right1] = adapter.tokens(right);
+        return compareStrings(left0, right0) || compareStrings(left1, right1);
+    });
+    const push = (token, edge) => {
+        const edges = adjacency.get(token);
+        if (edges)
+            edges.push(edge);
+        else
+            adjacency.set(token, [edge]);
+    };
+    for (const pool of sortedPools) {
+        const id = adapter.poolId(pool);
+        if ((typeof id === "string" && id.length === 0) ||
+            (typeof id === "number" && !Number.isFinite(id))) {
+            throw new RangeError("pool ids must be non-empty strings or finite numbers");
+        }
+        const identity = poolIdentity(id);
+        if (seenPoolIds.has(identity))
+            throw new RangeError(`duplicate pool id ${String(id)}`);
+        seenPoolIds.add(identity);
+        const [token0, token1] = adapter.tokens(pool);
+        assertNonEmpty(token0, `pool ${String(id)} token0`);
+        assertNonEmpty(token1, `pool ${String(id)} token1`);
+        if (token0 === token1) {
+            throw new RangeError(`pool ${String(id)} must contain two different tokens`);
+        }
+        push(token0, { pool, poolId: id, other: token1 });
+        push(token1, { pool, poolId: id, other: token0 });
+    }
+    for (const edges of adjacency.values()) {
+        edges.sort((left, right) => compareIds(left.poolId, right.poolId) || compareStrings(left.other, right.other));
+    }
+    return adjacency;
+}
+function enumerateCandidates(adjacency, fromToken, toToken, maxHops, compareIds) {
+    const candidates = [];
+    const visitedTokens = new Set([fromToken]);
+    const usedPools = new Set();
+    const visit = (current, route) => {
+        if (route.poolIds.length > 0 && current === toToken) {
+            candidates.push({
+                poolIds: [...route.poolIds],
+                tokens: [...route.tokens],
+                edges: [...route.edges],
+            });
+            return;
+        }
+        if (route.poolIds.length >= maxHops)
+            return;
+        for (const edge of adjacency.get(current) ?? []) {
+            const identity = poolIdentity(edge.poolId);
+            if (usedPools.has(identity))
+                continue;
+            if (visitedTokens.has(edge.other) && edge.other !== toToken)
+                continue;
+            usedPools.add(identity);
+            visitedTokens.add(edge.other);
+            route.poolIds.push(edge.poolId);
+            route.tokens.push(edge.other);
+            route.edges.push(edge);
+            visit(edge.other, route);
+            route.edges.pop();
+            route.tokens.pop();
+            route.poolIds.pop();
+            usedPools.delete(identity);
+            if (edge.other !== toToken)
+                visitedTokens.delete(edge.other);
+        }
+    };
+    visit(fromToken, { poolIds: [], tokens: [fromToken], edges: [] });
+    return candidates.sort((left, right) => left.poolIds.length - right.poolIds.length ||
+        compareIdLists(left.poolIds, right.poolIds, compareIds) ||
+        compareStrings(left.tokens.join("\u0000"), right.tokens.join("\u0000")));
+}
+export function calculatePriceImpact(amountIn, amountOut, midPriceOut) {
+    if (amountIn <= 0 || amountOut <= 0 || midPriceOut <= 0)
+        return 0;
+    return Math.max(0, 1 - amountOut / amountIn / midPriceOut);
+}
+function quoteCandidate(candidate, amountIn, adapter) {
+    let currentAmount = amountIn;
+    let midPriceOut = 1;
+    const hops = [];
+    for (let index = 0; index < candidate.edges.length; index += 1) {
+        const edge = candidate.edges[index];
+        const fromToken = candidate.tokens[index];
+        const toToken = candidate.tokens[index + 1];
+        if (!edge || fromToken === undefined || toToken === undefined)
+            return null;
+        const quoted = adapter.quoteExactIn({
+            pool: edge.pool,
+            fromToken,
+            toToken,
+            amountIn: currentAmount,
+        });
+        if (quoted === null ||
+            !Number.isFinite(quoted.amountOut) ||
+            !Number.isFinite(quoted.midPriceOut) ||
+            quoted.amountOut <= 0 ||
+            quoted.midPriceOut <= 0) {
+            return null;
+        }
+        hops.push({
+            poolId: edge.poolId,
+            fromToken,
+            toToken,
+            amountIn: currentAmount,
+            amountOut: quoted.amountOut,
+            metadata: quoted.metadata,
+        });
+        midPriceOut *= quoted.midPriceOut;
+        currentAmount = quoted.amountOut;
+    }
+    return {
+        amountIn,
+        amountOut: currentAmount,
+        hops,
+        path: [...candidate.poolIds],
+        priceImpact: calculatePriceImpact(amountIn, currentAmount, midPriceOut),
+        midPriceOut,
+    };
+}
+/** Enumerate viable simple routes using caller-supplied pool and quote semantics. */
+export function enumerateExactInRoutes(request) {
+    assertNonEmpty(request.fromToken, "fromToken");
+    assertNonEmpty(request.toToken, "toToken");
+    assertFinitePositive(request.amountIn, "amountIn");
+    const maxHops = request.maxHops ?? DEFAULT_MAX_HOPS;
+    if (!Number.isInteger(maxHops) || maxHops <= 0) {
+        throw new RangeError("maxHops must be a positive integer");
+    }
+    if (request.fromToken === request.toToken)
+        return [];
+    const compareIds = request.adapter.comparePoolIds ?? defaultComparePoolIds;
+    const candidates = enumerateCandidates(buildAdjacency(request.pools, request.adapter), request.fromToken, request.toToken, maxHops, compareIds);
+    return candidates
+        .map((candidate) => quoteCandidate(candidate, request.amountIn, request.adapter))
+        .filter((quote) => quote !== null)
+        .sort((left, right) => right.amountOut - left.amountOut ||
+        left.path.length - right.path.length ||
+        compareIdLists(left.path, right.path, compareIds) ||
+        compareStrings(left.hops.map((hop) => hop.toToken).join("\u0000"), right.hops.map((hop) => hop.toToken).join("\u0000")));
+}
+export function selectBestExactInRoute(request) {
+    return enumerateExactInRoutes(request)[0] ?? null;
+}
+//# sourceMappingURL=routing.js.map

package/dist/routing.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@xian-tech/dex",
+  "version": "0.2.0",
+  "description": "Deterministic Xian DEX quoting and transaction planning",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xian-technology/xian-js.git",
+    "directory": "packages/dex"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./routing": {
+      "types": "./dist/routing.d.ts",
+      "import": "./dist/routing.js",
+      "default": "./dist/routing.js"
+    },
+    "./constant-product": {
+      "types": "./dist/constant-product.d.ts",
+      "import": "./dist/constant-product.js",
+      "default": "./dist/constant-product.js"
+    },
+    "./execution": {
+      "types": "./dist/execution.d.ts",
+      "import": "./dist/execution.js",
+      "default": "./dist/execution.js"
+    },
+    "./adapters/xian-v1": {
+      "types": "./dist/adapters/xian-v1.d.ts",
+      "import": "./dist/adapters/xian-v1.js",
+      "default": "./dist/adapters/xian-v1.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "npm run clean && tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
+}