@ickb/sdk 1000.0.82 → 9001.0.0

package/dist/order/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/order/matcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IAEjB,oEAAoE;IACpE,QAAQ,EAAE,KAAK,CAAC;QACd,kEAAkE;QAClE,KAAK,EAAE,UAAU,CAAC;QAElB,6DAA6D;QAC7D,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC;QAEvB,2DAA2D;QAC3D,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC;KACxB,CAAC,CAAC;CACJ;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,SAAgB,KAAK,EAAE,UAAU,CAAC;IAClC,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC;IAChC,SAAgB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC;IAChC,SAAgB,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC;IACpC,SAAgB,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC;IACpC,SAAgB,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC;IACrC,SAAgB,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC;IAC1C,SAAgB,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC;IAC1C,SAAgB,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC;IAExC,OAAO,eAeN;IAED,qFAAqF;IACrF,OAAc,IAAI,CAChB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,OAAO,EAClB,YAAY,EAAE,GAAG,CAAC,UAAU,GAC3B,YAAY,GAAG,SAAS,CAG1B;IAEM,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,KAAK,CAkB9C;IAEM,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,GAAG,KAAK,CAY/D;CACF"}

package/dist/order/matcher.js

@@ -0,0 +1,124 @@
+import { ccc } from "@ckb-ccc/core";
+import { ceilDiv } from "../utils/utils.js";
+/**
+ * One order's fills in one direction, in the contract's terms: `a` is the asset the order
+ * gives, `b` the asset the caller pays. A partial pays `b` between `bMinMatch` and
+ * `bMaxMatch`; paying `bMaxMatch` completes the order.
+ */
+export class OrderMatcher {
+    group;
+    isCkb2Udt;
+    aScale;
+    bScale;
+    aIn;
+    bIn;
+    aMin;
+    bMinMatch;
+    bMaxMatch;
+    bMaxOut;
+    constructor(group, isCkb2Udt, { aScale, bScale, aIn, bIn, aMin, bMinMatch, bMaxMatch, bMaxOut }) {
+        this.group = group;
+        this.isCkb2Udt = isCkb2Udt;
+        this.aScale = aScale;
+        this.bScale = bScale;
+        this.aIn = aIn;
+        this.bIn = bIn;
+        this.aMin = aMin;
+        this.bMinMatch = bMinMatch;
+        this.bMaxMatch = bMaxMatch;
+        this.bMaxOut = bMaxOut;
+    }
+    /** The order's matcher in one direction, or `undefined` when nothing gains in it. */
+    static from(group, isCkb2Udt, ckbMiningFee) {
+        const terms = orderMatcherTerms(group.order, isCkb2Udt, ckbMiningFee);
+        return terms === undefined ? undefined : new OrderMatcher(group, isCkb2Udt, terms);
+    }
+    match(bAllowance) {
+        if (bAllowance < this.bMinMatch) {
+            return { ckbDelta: 0n, udtDelta: 0n, partials: [] };
+        }
+        if (bAllowance >= this.bMaxMatch) {
+            return this.create(this.aMin, this.bMaxOut);
+        }
+        const bOut = this.bIn + bAllowance;
+        const aOut = nonDecreasing({
+            aScale: this.bScale,
+            bScale: this.aScale,
+            aIn: this.bIn,
+            bIn: this.aIn,
+            aOut: bOut,
+        });
+        return this.create(aOut, bOut);
+    }
+    create(aOut, bOut) {
+        return this.isCkb2Udt
+            ? {
+                ckbDelta: this.aIn - aOut,
+                udtDelta: this.bIn - bOut,
+                partials: [{ group: this.group, ckbOut: aOut, udtOut: bOut }],
+            }
+            : {
+                ckbDelta: this.bIn - bOut,
+                udtDelta: this.aIn - aOut,
+                partials: [{ group: this.group, ckbOut: bOut, udtOut: aOut }],
+            };
+    }
+}
+function orderMatcherTerms(order, isCkb2Udt, ckbMiningFee) {
+    if (isCkb2Udt ? !order.isCkb2UdtMatchable() : !order.isUdt2CkbMatchable()) {
+        return undefined;
+    }
+    const { info } = order.data;
+    const ckbMinMatch = info.getCkbMinMatch();
+    let terms;
+    if (isCkb2Udt) {
+        const { ckbScale: aScale, udtScale: bScale } = info.ckbToUdt;
+        terms = {
+            aScale,
+            bScale,
+            aIn: order.ckbValue,
+            bIn: order.udtValue,
+            aMin: order.cell.cellOutput.capacity - order.ckbUnoccupied,
+            // The contract's ckb2udt minimum is a plain CKB delta (limit_order entry.rs:116);
+            // a value-conserving partial moving u UDT moves u*udtScale/ckbScale CKB, so the
+            // UDT-denominated floor is ceil(minMatch * ckbScale / udtScale).
+            bMinMatch: ceilDiv(ckbMinMatch * aScale, bScale),
+        };
+    }
+    else {
+        const { ckbScale: bScale, udtScale: aScale } = info.udtToCkb;
+        // The contract's udt2ckb minimum values the UDT moved at the ratio, and a payment of
+        // p CKB moves floor(p*bScale/aScale) UDT, so the smallest payment the contract accepts
+        // is the one whose floor reaches ceil(min*bScale/aScale) UDT: the plain minimum,
+        // rounded up to the ratio's grid.
+        const udtMinMatch = ceilDiv(ckbMinMatch * bScale, aScale);
+        terms = {
+            aScale,
+            bScale,
+            aIn: order.udtValue,
+            bIn: order.ckbValue,
+            aMin: 0n,
+            bMinMatch: ceilDiv(udtMinMatch * aScale, bScale),
+        };
+    }
+    const { aScale, bScale, aIn, bIn, aMin, bMinMatch } = terms;
+    // A buyer pays the fill's mining fee out of the CKB it gives, so nothing gains once the
+    // fee eats that; a seller's fill brings CKB in, and its caller nets the fee (`netOf`).
+    if (aIn <= aMin + (isCkb2Udt ? ckbMiningFee : 0n)) {
+        return undefined;
+    }
+    const bMaxOut = nonDecreasing({ aScale, bScale, aIn, bIn, aOut: aMin });
+    const bMaxMatch = bMaxOut - bIn;
+    return {
+        ...terms,
+        // An order under its own minimum can only be completed.
+        bMinMatch: ccc.numMin(bMinMatch, bMaxMatch),
+        bMaxMatch,
+        bMaxOut,
+    };
+}
+/** The smallest `b` output that keeps the order's value non-decreasing at its ratio. */
+function nonDecreasing({ aScale, bScale, aIn, bIn, aOut, }) {
+    return ceilDiv(aScale * (aIn - aOut) + bScale * bIn, bScale);
+}
+//# sourceMappingURL=matcher.js.map

package/dist/order/matcher.js.map

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

package/dist/order/order.d.ts

@@ -0,0 +1,63 @@
+import { ccc } from "@ckb-ccc/core";
+import { type ScriptDeps, type ValueComponents } from "../utils/utils.js";
+import { OrderGroup } from "./cells.js";
+import { type InfoLike } from "./info.js";
+import type { Match } from "./matcher.js";
+/**
+ * Builds and scans iCKB Stack order cells for one order script deployment.
+ */
+export declare class OrderManager implements ScriptDeps {
+    /** Order lock script this manager scans and builds for. */
+    readonly script: ccc.Script;
+    /** Cell deps required to execute the order script. */
+    readonly cellDeps: ccc.CellDep[];
+    /** UDT type script accepted by this order market. */
+    readonly udtScript: ccc.Script;
+    /**
+     * Creates an order manager for one order script, its cell deps, and UDT type.
+     */
+    constructor(script: ccc.Script, cellDeps: ccc.CellDep[], udtScript: ccc.Script);
+    /** Returns true when the cell is an order cell for this manager's scripts. */
+    isOrder(cell: ccc.Cell): boolean;
+    /**
+     * Adds a new order cell and its master cell to a partial transaction.
+     *
+     * @remarks
+     * The order output is locked by the order script and typed by the configured
+     * UDT. The following master output is typed by the order script and locked by
+     * the caller-provided lock.
+     */
+    mint(txLike: ccc.TransactionLike, lock: ccc.Script, infoLike: InfoLike, { ckbValue, udtValue }: ValueComponents): ccc.Transaction;
+    /**
+     * Adds inputs and partial outputs for a chosen match.
+     */
+    addMatch(txLike: ccc.TransactionLike, match: Match): ccc.Transaction;
+    /**
+     * Adds order groups and their master cells as melt inputs.
+     *
+     * @remarks Melts exactly the groups it is given: callers pass fulfilled groups
+     * to collect and a live group to cancel it.
+     */
+    melt(txLike: ccc.TransactionLike, groups: OrderGroup[]): ccc.Transaction;
+    /**
+     * Finds valid order groups by scanning order cells and master cells. Unresolved or
+     * invalid groups are skipped.
+     */
+    findOrders(client: ccc.Client): Promise<OrderGroup[]>;
+    private findSimpleOrders;
+    /**
+     * Every master with the block that committed it, which is its mint order's block too:
+     * a master is created beside its mint order and never changes until melted, so this
+     * dates how long the order has been on the book.
+     */
+    private findAllMasters;
+    /** Resolves one master and its descendant orders into a validated order group. */
+    private resolveOrderGroup;
+    /**
+     * The mint order created beside the master, read from the master's transaction: the
+     * client cache first, then the node, which records the response for the next read.
+     */
+    private findOrigin;
+    private validatedPartial;
+}
+//# sourceMappingURL=order.d.ts.map

package/dist/order/order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../src/order/order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAa,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAyB,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAI1C;;GAEG;AACH,qBAAa,YAAa,YAAW,UAAU;IAC7C,2DAA2D;IAC3D,SAAgB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;IACnC,sDAAsD;IACtD,SAAgB,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IACxC,qDAAqD;IACrD,SAAgB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC;IAEtC;;OAEG;IACH,YAAY,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAI7E;IAED,8EAA8E;IACvE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,OAAO,CAKtC;IAED;;;;;;;OAOG;IACI,IAAI,CACT,MAAM,EAAE,GAAG,CAAC,eAAe,EAC3B,IAAI,EAAE,GAAG,CAAC,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,eAAe,GACtC,GAAG,CAAC,WAAW,CAwBjB;IAED;;OAEG;IACI,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,WAAW,CA8B1E;IAED;;;;;OAKG;IACI,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,WAAW,CAkB9E;IAED;;;OAGG;IACU,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAyBjE;YAEa,gBAAgB;IAc9B;;;;OAIG;YACW,cAAc;IAgB5B,kFAAkF;YACpE,iBAAiB;IAoB/B;;;OAGG;YACW,UAAU;IA2CxB,OAAO,CAAC,gBAAgB;CAiBzB"}

package/dist/order/order.js

@@ -0,0 +1,234 @@
+import { ccc } from "@ckb-ccc/core";
+import { findCells } from "../utils/utils.js";
+import { MasterCell, OrderCell, OrderGroup } from "./cells.js";
+import { Info } from "./info.js";
+import { OrderData } from "./order_data.js";
+import { Relative } from "./relative.js";
+/**
+ * Builds and scans iCKB Stack order cells for one order script deployment.
+ */
+export class OrderManager {
+    /** Order lock script this manager scans and builds for. */
+    script;
+    /** Cell deps required to execute the order script. */
+    cellDeps;
+    /** UDT type script accepted by this order market. */
+    udtScript;
+    /**
+     * Creates an order manager for one order script, its cell deps, and UDT type.
+     */
+    constructor(script, cellDeps, udtScript) {
+        this.script = script;
+        this.cellDeps = cellDeps;
+        this.udtScript = udtScript;
+    }
+    /** Returns true when the cell is an order cell for this manager's scripts. */
+    isOrder(cell) {
+        return (cell.cellOutput.lock.eq(this.script) &&
+            Boolean(cell.cellOutput.type?.eq(this.udtScript)));
+    }
+    /**
+     * Adds a new order cell and its master cell to a partial transaction.
+     *
+     * @remarks
+     * The order output is locked by the order script and typed by the configured
+     * UDT. The following master output is typed by the order script and locked by
+     * the caller-provided lock.
+     */
+    mint(txLike, lock, infoLike, { ckbValue, udtValue }) {
+        const tx = ccc.Transaction.from(txLike);
+        const data = OrderData.from({
+            udtValue,
+            master: { type: "relative", value: Relative.create(1n) },
+            info: Info.from(infoLike),
+        });
+        data.validate();
+        if (ckbValue < 0n) {
+            throw new Error("ckbValue invalid, negative");
+        }
+        tx.addCellDeps(this.cellDeps);
+        const outputCount = tx.addOutput({ lock: this.script, type: this.udtScript }, data.toBytes());
+        const orderOutput = tx.outputs[outputCount - 1];
+        if (orderOutput === undefined) {
+            throw new Error("Failed to append order output");
+        }
+        orderOutput.capacity += ckbValue;
+        tx.addOutput({ lock, type: this.script });
+        return tx;
+    }
+    /**
+     * Adds inputs and partial outputs for a chosen match.
+     */
+    addMatch(txLike, match) {
+        const tx = ccc.Transaction.from(txLike);
+        const partials = match.partials.map((partial) => this.validatedPartial(partial));
+        let ckbDelta = 0n;
+        let udtDelta = 0n;
+        for (const { group, ckbOut, udtOut } of partials) {
+            ckbDelta += group.order.ckbValue - ckbOut;
+            udtDelta += group.order.udtValue - udtOut;
+        }
+        if (match.ckbDelta !== ckbDelta || match.udtDelta !== udtDelta) {
+            throw new Error("Match deltas do not match partial order accounting");
+        }
+        if (partials.length === 0) {
+            return tx;
+        }
+        tx.addCellDeps(this.cellDeps);
+        for (const { group, ckbOut, udtOut } of partials) {
+            const { order } = group;
+            tx.addInput(order.cell);
+            tx.addOutput({ lock: this.script, type: this.udtScript, capacity: ckbOut }, OrderData.from({
+                udtValue: udtOut,
+                master: { type: "absolute", value: order.getMaster() },
+                info: order.data.info,
+            }).toBytes());
+        }
+        return tx;
+    }
+    /**
+     * Adds order groups and their master cells as melt inputs.
+     *
+     * @remarks Melts exactly the groups it is given: callers pass fulfilled groups
+     * to collect and a live group to cancel it.
+     */
+    melt(txLike, groups) {
+        const tx = ccc.Transaction.from(txLike);
+        if (groups.length === 0) {
+            return tx;
+        }
+        for (const group of groups) {
+            if (!this.isOrder(group.order.cell)) {
+                throw new Error(`Melt order ${group.order.cell.outPoint.toHex()} does not match this order manager`);
+            }
+        }
+        tx.addCellDeps(this.cellDeps);
+        for (const group of groups) {
+            tx.addInput(group.order.cell);
+            tx.addInput(group.master.cell);
+        }
+        return tx;
+    }
+    /**
+     * Finds valid order groups by scanning order cells and master cells. Unresolved or
+     * invalid groups are skipped.
+     */
+    async findOrders(client) {
+        const [orders, masters] = await Promise.all([
+            this.findSimpleOrders(client),
+            this.findAllMasters(client),
+        ]);
+        const rawGroups = new Map(masters.map(({ master, blockNumber }) => [
+            master.cell.outPoint.toHex(),
+            { master, blockNumber, orders: new Array() },
+        ]));
+        for (const order of orders) {
+            rawGroups.get(order.getMaster().toHex())?.orders.push(order);
+        }
+        // Each group's origin is one transaction read; resolving them together turns a book of
+        // fifty orders from seconds of round trips into one.
+        const groups = await Promise.all([...rawGroups.values()]
+            .filter((rawGroup) => rawGroup.orders.length > 0)
+            .map(async ({ master, blockNumber, orders: candidates }) => this.resolveOrderGroup(client, master, blockNumber, candidates)));
+        return groups.filter((group) => group !== undefined);
+    }
+    async findSimpleOrders(client) {
+        const cells = await findCells(client, {
+            script: this.script,
+            scriptType: "lock",
+            filter: { script: this.udtScript },
+            scriptSearchMode: "exact",
+            withData: true,
+        });
+        return cells.flatMap(({ cell }) => {
+            const order = OrderCell.tryFrom(cell);
+            return order !== undefined && this.isOrder(cell) ? [order] : [];
+        });
+    }
+    /**
+     * Every master with the block that committed it, which is its mint order's block too:
+     * a master is created beside its mint order and never changes until melted, so this
+     * dates how long the order has been on the book.
+     */
+    async findAllMasters(client) {
+        // An exact type search returns master cells only, so nothing re-filters here.
+        const cells = await findCells(client, {
+            script: this.script,
+            scriptType: "type",
+            scriptSearchMode: "exact",
+            withData: true,
+        });
+        return cells.map(({ cell, blockNumber }) => ({
+            master: new MasterCell(cell),
+            blockNumber,
+        }));
+    }
+    /** Resolves one master and its descendant orders into a validated order group. */
+    async resolveOrderGroup(client, master, blockNumber, orders) {
+        const origin = await this.findOrigin(client, master.cell.outPoint);
+        const order = origin?.resolve(orders);
+        if (origin === undefined || order === undefined) {
+            return undefined;
+        }
+        const group = OrderGroup.tryFrom(master, order, origin, blockNumber);
+        // A dual-ratio order, valid on chain but placed by nothing in the stack, is left to
+        // whoever placed it: neither matched, estimated, shown nor melted here.
+        if (group === undefined || group.order.data.info.isDualRatio()) {
+            return undefined;
+        }
+        return group;
+    }
+    /**
+     * The mint order created beside the master, read from the master's transaction: the
+     * client cache first, then the node, which records the response for the next read.
+     */
+    async findOrigin(client, master) {
+        const { txHash, index: masterIndex } = master;
+        // A cached body is trusted like the scan that found the master: an order is a node's
+        // claim until the send checks every cell it spends against its creating transaction.
+        const response = (await client.cache.getTransactionResponse(txHash)) ??
+            (await client.getTransaction(txHash));
+        if (response === undefined) {
+            return undefined;
+        }
+        let origin;
+        for (const [i, output] of [...response.transaction.outputCells].entries()) {
+            const index = BigInt(i);
+            if (index === masterIndex) {
+                continue;
+            }
+            const cell = ccc.Cell.from({
+                cellOutput: output.cellOutput,
+                outputData: output.outputData,
+                outPoint: { txHash, index },
+            });
+            const order = OrderCell.tryFrom(cell);
+            if (order === undefined ||
+                !this.isOrder(cell) ||
+                !order.data.isMint() ||
+                !order.getMaster().eq(master)) {
+                continue;
+            }
+            if (origin !== undefined) {
+                // Two mint orders pointing at one master: the group is ambiguous, skip it.
+                return undefined;
+            }
+            origin = order;
+        }
+        return origin;
+    }
+    validatedPartial({ group, ckbOut, udtOut, }) {
+        const outPoint = group.order.cell.outPoint.toHex();
+        if (!this.isOrder(group.order.cell)) {
+            throw new Error(`Match order ${outPoint} does not match this order manager`);
+        }
+        if (ckbOut < 0n) {
+            throw new Error(`Match order ${outPoint} has negative CKB output`);
+        }
+        if (udtOut < 0n) {
+            throw new Error(`Match order ${outPoint} has negative UDT output`);
+        }
+        return { group, ckbOut, udtOut };
+    }
+}
+//# sourceMappingURL=order.js.map

package/dist/order/order.js.map

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

package/dist/order/order_data.d.ts

@@ -0,0 +1,51 @@
+import { ccc } from "@ckb-ccc/core";
+import { Info, type InfoLike } from "./info.js";
+import { type Master, type MasterLike } from "./master.js";
+/**
+ * Wire shape for order cell data.
+ */
+export interface OrderDataLike {
+    /** UDT amount held by the order cell. */
+    udtValue: ccc.FixedPointLike;
+    /** Relative or absolute pointer to the master cell. */
+    master: MasterLike;
+    /** Price and minimum-match metadata. */
+    info: InfoLike;
+}
+/**
+ * Serialized order cell payload.
+ */
+export interface OrderData {
+    /** UDT amount held by the order cell. */
+    udtValue: ccc.FixedPoint;
+    /** Master-cell pointer. */
+    master: Master;
+    /** Price and minimum-match metadata. */
+    info: Info;
+    /** Creates a copy of this order payload. */
+    clone(): OrderData;
+    /** Returns whether another value has the same order payload. */
+    eq(other: OrderDataLike): boolean;
+    /** Resolves a relative master against `current`, or returns the absolute master. */
+    getMaster(current: ccc.OutPoint): ccc.OutPoint;
+    /** Returns the CKB hash of the serialized order payload. */
+    hash(): ccc.Hex;
+    /** Returns whether the master pointer is relative to the current output. */
+    isMint(): boolean;
+    /** Serializes the order payload to bytes. */
+    toBytes(): ccc.Bytes;
+    /** Serializes the order payload to full-width hexadecimal. */
+    toHex(): ccc.Hex;
+    /** Throws if the UDT value, master pointer, or info is invalid. */
+    validate(): void;
+}
+/** CCC-backed order-data constructor and codec. */
+export declare const OrderData: {
+    byteLength?: number;
+    new (udtValue: ccc.FixedPoint, master: Master, info: Info): OrderData;
+    decode: (encoded: ccc.BytesLike) => OrderData;
+    encode: (data: OrderDataLike) => ccc.Bytes;
+    from: (data: OrderDataLike) => OrderData;
+    fromBytes: (encoded: ccc.BytesLike) => OrderData;
+};
+//# sourceMappingURL=order_data.d.ts.map

package/dist/order/order_data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order_data.d.ts","sourceRoot":"","sources":["../../src/order/order_data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAO,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AAIrB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,EAAE,GAAG,CAAC,cAAc,CAAC;IAC7B,uDAAuD;IACvD,MAAM,EAAE,UAAU,CAAC;IACnB,wCAAwC;IACxC,IAAI,EAAE,QAAQ,CAAC;CAChB;AAUD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC;IACzB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,IAAI,EAAE,IAAI,CAAC;IACX,4CAA4C;IAC5C,KAAK,IAAI,SAAS,CAAC;IACnB,gEAAgE;IAChE,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IAClC,oFAAoF;IACpF,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC/C,4DAA4D;IAC5D,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC;IAChB,4EAA4E;IAC5E,MAAM,IAAI,OAAO,CAAC;IAClB,6CAA6C;IAC7C,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC;IACrB,8DAA8D;IAC9D,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC;IACjB,mEAAmE;IACnE,QAAQ,IAAI,IAAI,CAAC;CAClB;AA8DD,mDAAmD;AAEnD,eAAO,MAAM,SAAS,EAAE;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,QAAQ,EAAE,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IACtE,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC;IAC9C,MAAM,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,GAAG,CAAC,KAAK,CAAC;IAC3C,IAAI,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,SAAS,CAAC;IACzC,SAAS,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC;CACxB,CAAC"}

package/dist/order/order_data.js

@@ -0,0 +1,67 @@
+import { ccc, mol } from "@ckb-ccc/core";
+import { CheckedUint128LE } from "../utils/codec.js";
+import { Info } from "./info.js";
+import { MasterCodec, masterFrom, masterValidate, } from "./master.js";
+const maxUint128 = (1n << 128n) - 1n;
+const OrderDataCodec = mol.struct({
+    udtValue: CheckedUint128LE,
+    master: MasterCodec,
+    info: Info,
+});
+const OrderBase = ccc.Entity.Base();
+// An interface, this class expression and a typed const rather than one plain class: a
+// class extending `ccc.Entity.Base<...>()` emits an unexported `*_base` declaration, which
+// API Extractor's ae-forgotten-export rejects (tried 2026-10-30).
+// eslint-disable-next-line @typescript-eslint/no-shadow -- Preserve the runtime constructor name.
+const OrderDataImplementation = class OrderData extends OrderBase {
+    static {
+        ccc.codec(OrderDataCodec)(this);
+    }
+    /** UDT amount held by the order cell. */
+    udtValue;
+    /** Master-cell pointer. */
+    master;
+    /** Price and minimum-match metadata. */
+    info;
+    /** Creates normalized order data. */
+    constructor(udtValue, master, info) {
+        super();
+        this.udtValue = udtValue;
+        this.master = master;
+        this.info = info;
+    }
+    /** Normalizes an `OrderDataLike` wire object or existing entity into `OrderData`. */
+    static from(data) {
+        if (data instanceof OrderData) {
+            return data;
+        }
+        const { udtValue, master, info } = data;
+        return new OrderData(ccc.numFrom(udtValue), masterFrom(master), Info.from(info));
+    }
+    /** Throws when the order payload is not internally valid. */
+    validate() {
+        if (this.udtValue < 0n) {
+            throw new Error("udtValue invalid, negative");
+        }
+        if (this.udtValue > maxUint128) {
+            throw new Error("udtValue exceeds Uint128");
+        }
+        masterValidate(this.master);
+        this.info.validate();
+    }
+    /** Returns true when the master pointer is relative to the current output. */
+    isMint() {
+        return this.master.type === "relative";
+    }
+    /** Resolves the master out point relative to the current order out point. */
+    getMaster(current) {
+        const { type, value } = this.master;
+        return type === "relative"
+            ? new ccc.OutPoint(current.txHash, current.index + value.distance)
+            : value;
+    }
+};
+/** CCC-backed order-data constructor and codec. */
+// eslint-disable-next-line @typescript-eslint/no-redeclare -- The public type and runtime constructor intentionally share a name.
+export const OrderData = OrderDataImplementation;
+//# sourceMappingURL=order_data.js.map

package/dist/order/order_data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order_data.js","sourceRoot":"","sources":["../../src/order/order_data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAiB,MAAM,WAAW,CAAC;AAChD,OAAO,EACL,WAAW,EACX,UAAU,EACV,cAAc,GAGf,MAAM,aAAa,CAAC;AAErB,MAAM,UAAU,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;AAcrC,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC;IAChC,QAAQ,EAAE,gBAAgB;IAC1B,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,IAAI;CACX,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAA4B,CAAC;AA8B9D,uFAAuF;AACvF,2FAA2F;AAC3F,kEAAkE;AAClE,kGAAkG;AAClG,MAAM,uBAAuB,GAAG,MAAM,SAAU,SAAQ,SAAS;IAC/D;QACE,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,yCAAyC;IACzB,QAAQ,CAAiB;IACzC,2BAA2B;IACX,MAAM,CAAS;IAC/B,wCAAwC;IACxB,IAAI,CAAO;IAE3B,qCAAqC;IACrC,YAAY,QAAwB,EAAE,MAAc,EAAE,IAAU;QAC9D,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,qFAAqF;IAC9E,MAAM,CAAU,IAAI,CAAC,IAAmB;QAC7C,IAAI,IAAI,YAAY,SAAS,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACxC,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,6DAA6D;IACtD,QAAQ;QACb,IAAI,IAAI,CAAC,QAAQ,GAAG,EAAE,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,GAAG,UAAU,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;IACvB,CAAC;IAED,8EAA8E;IACvE,MAAM;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;IACzC,CAAC;IAED,6EAA6E;IACtE,SAAS,CAAC,OAAqB;QACpC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QACpC,OAAO,IAAI,KAAK,UAAU;YACxB,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC;YAClE,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC;CACF,CAAC;AAEF,mDAAmD;AACnD,kIAAkI;AAClI,MAAM,CAAC,MAAM,SAAS,GAOlB,uBAAuB,CAAC"}

package/dist/order/ratio.d.ts

@@ -0,0 +1,40 @@
+import { ccc } from "@ckb-ccc/core";
+import { type ExchangeRatio } from "../utils/utils.js";
+/**
+ * Serialized exchange ratio used by order info.
+ *
+ * @remarks
+ * A ratio is either empty (`0, 0`) or populated with both scales greater than
+ * zero. Mixed empty/populated values are invalid.
+ */
+export interface Ratio extends ExchangeRatio {
+    /** Creates a copy of this ratio. */
+    clone(): Ratio;
+    /** Compares effective CKB-to-UDT prices, returning their numeric ordering. */
+    compare(other: Ratio): number;
+    /** Returns whether another value has the same scales. */
+    eq(other: ExchangeRatio): boolean;
+    /** Returns the CKB hash of the serialized ratio. */
+    hash(): ccc.Hex;
+    /** Returns whether both scales are zero. */
+    isEmpty(): boolean;
+    /** Returns whether both scales are positive. */
+    isPopulated(): boolean;
+    /** Serializes the ratio to bytes. */
+    toBytes(): ccc.Bytes;
+    /** Serializes the ratio to full-width hexadecimal. */
+    toHex(): ccc.Hex;
+    /** Throws unless both scales fit Uint64 and are both zero or both positive. */
+    validate(): void;
+}
+/** CCC-backed ratio constructor and codec. */
+export declare const Ratio: {
+    byteLength?: number;
+    new (ckbScale: ccc.Num, udtScale: ccc.Num): Ratio;
+    decode: (encoded: ccc.BytesLike) => Ratio;
+    empty: () => Ratio;
+    encode: (ratio: ExchangeRatio) => ccc.Bytes;
+    from: (ratio: ExchangeRatio) => Ratio;
+    fromBytes: (encoded: ccc.BytesLike) => Ratio;
+};
+//# sourceMappingURL=ratio.d.ts.map

package/dist/order/ratio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratio.d.ts","sourceRoot":"","sources":["../../src/order/ratio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAO,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAWtE;;;;;;GAMG;AACH,MAAM,WAAW,KAAM,SAAQ,aAAa;IAC1C,oCAAoC;IACpC,KAAK,IAAI,KAAK,CAAC;IACf,8EAA8E;IAC9E,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B,yDAAyD;IACzD,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IAClC,oDAAoD;IACpD,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC;IAChB,4CAA4C;IAC5C,OAAO,IAAI,OAAO,CAAC;IACnB,gDAAgD;IAChD,WAAW,IAAI,OAAO,CAAC;IACvB,qCAAqC;IACrC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC;IACrB,sDAAsD;IACtD,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC;IACjB,+EAA+E;IAC/E,QAAQ,IAAI,IAAI,CAAC;CAClB;AA6ED,8CAA8C;AAE9C,eAAO,MAAM,KAAK,EAAE;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,QAAQ,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC;IAClD,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,KAAK,KAAK,CAAC;IAC1C,KAAK,EAAE,MAAM,KAAK,CAAC;IACnB,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,GAAG,CAAC,KAAK,CAAC;IAC5C,IAAI,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,KAAK,CAAC;IACtC,SAAS,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,KAAK,KAAK,CAAC;CACxB,CAAC"}