@ickb/sdk 1000.0.81 → 9000.0.1

package/dist/order/order.js

@@ -0,0 +1,239 @@
+import { ccc } from "@ckb-ccc/core";
+import { findCells } from "../utils/utils.js";
+import { attestResolvedOrderGroup, MasterCell, OrderCell, OrderGroup, validatedOrderGroup, } 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);
+        const selected = groups.map(validatedOrderGroup);
+        if (selected.length === 0) {
+            return tx;
+        }
+        for (const group of selected) {
+            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 selected) {
+            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) => [
+            master.cell.outPoint.toHex(),
+            { master, 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, orders: candidates }) => this.resolveOrderGroup(client, master, 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] : [];
+        });
+    }
+    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) => new MasterCell(cell));
+    }
+    /** Resolves one master and its descendant orders into a validated order group. */
+    async resolveOrderGroup(client, master, orders) {
+        const found = await this.findOrigin(client, master.cell.outPoint);
+        const order = found?.origin.resolve(orders);
+        if (found === undefined || order === undefined) {
+            return undefined;
+        }
+        const group = OrderGroup.tryFrom(master, order, found.origin, found.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 attestResolvedOrderGroup(group);
+    }
+    /**
+     * The mint order created beside the master, read from the master's transaction: the
+     * client cache first, then the node, recording the response for the next read. The
+     * response's block number dates the order; an uncommitted origin has none.
+     */
+    async findOrigin(client, master) {
+        const { txHash, index: masterIndex } = master;
+        const response = await cachedTransactionResponse(client, 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 === undefined
+            ? undefined
+            : { origin, blockNumber: response.blockNumber };
+    }
+    validatedPartial({ group, ckbOut, udtOut, }) {
+        const validated = validatedOrderGroup(group);
+        const outPoint = validated.order.cell.outPoint.toHex();
+        if (!this.isOrder(validated.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: validated, ckbOut, udtOut };
+    }
+}
+async function cachedTransactionResponse(client, txHash) {
+    // As CCC's own readers do, trust the cache only once the transaction is in a block: the
+    // cache also holds what CCC records at broadcast and what a lagging node answered, and a
+    // long-lived client would otherwise keep that answer for good.
+    const cached = await client.cache.getTransactionResponse(txHash);
+    if (cached?.blockNumber !== undefined) {
+        return cached;
+    }
+    // CCC's read records a found response in the cache itself.
+    return client.getTransaction(txHash);
+}
+//# 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;AA2DD,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,64 @@
+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();
+// 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,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,42 @@
+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;
+    /** Converts an amount in the selected direction, rounding up only when requested. */
+    convert(isCkb2Udt: boolean, amount: ccc.FixedPoint, mustCeil: boolean): ccc.FixedPoint;
+    /** 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,qFAAqF;IACrF,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC;IACvF,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;AA4FD,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"}

package/dist/order/ratio.js

@@ -0,0 +1,82 @@
+import { ccc, mol } from "@ckb-ccc/core";
+import { CheckedUint64LE } from "../utils/codec.js";
+import { compareBigInt } from "../utils/utils.js";
+const maxUint64 = (1n << 64n) - 1n;
+const RatioCodec = mol.struct({
+    ckbScale: CheckedUint64LE,
+    udtScale: CheckedUint64LE,
+});
+const RatioBase = ccc.Entity.Base();
+// eslint-disable-next-line @typescript-eslint/no-shadow -- Preserve the runtime constructor name.
+const RatioImplementation = class Ratio extends RatioBase {
+    static {
+        ccc.codec(RatioCodec)(this);
+    }
+    /** CKB-side scale. */
+    ckbScale;
+    /** UDT-side scale. */
+    udtScale;
+    /** Creates a ratio from raw scales. */
+    constructor(ckbScale, udtScale) {
+        super();
+        this.ckbScale = ckbScale;
+        this.udtScale = udtScale;
+    }
+    /** Normalizes an exchange ratio wire object or existing entity into `Ratio`. */
+    static from(ratio) {
+        if (ratio instanceof Ratio) {
+            return ratio;
+        }
+        const { ckbScale, udtScale } = ratio;
+        return new Ratio(ckbScale, udtScale);
+    }
+    /** Throws when the ratio is neither empty nor fully populated. */
+    validate() {
+        if (this.ckbScale < 0n ||
+            this.ckbScale > maxUint64 ||
+            this.udtScale < 0n ||
+            this.udtScale > maxUint64) {
+            throw new Error("Ratio scale exceeds Uint64");
+        }
+        if (!this.isEmpty() && !this.isPopulated()) {
+            throw new Error("Ratio invalid: not empty, not populated");
+        }
+    }
+    /** Returns true for the sentinel empty ratio. */
+    isEmpty() {
+        return this.ckbScale === 0n && this.udtScale === 0n;
+    }
+    /** Returns true when both scales are positive. */
+    isPopulated() {
+        return this.ckbScale > 0n && this.udtScale > 0n;
+    }
+    /** Creates the sentinel empty ratio. */
+    static empty() {
+        return new Ratio(0n, 0n);
+    }
+    /** Compares two populated ratios by effective CKB-to-UDT price. */
+    compare(other) {
+        if (this.udtScale === other.udtScale) {
+            return compareBigInt(this.ckbScale, other.ckbScale);
+        }
+        if (this.ckbScale === other.ckbScale) {
+            return compareBigInt(other.udtScale, this.udtScale);
+        }
+        return compareBigInt(this.ckbScale * other.udtScale, other.ckbScale * this.udtScale);
+    }
+    /** Converts an amount in the requested direction with optional ceiling. */
+    convert(isCkb2Udt, amount, mustCeil) {
+        if (!this.isPopulated()) {
+            throw new Error("Invalid midpoint ExchangeRatio");
+        }
+        let { ckbScale: aScale, udtScale: bScale } = this;
+        if (!isCkb2Udt) {
+            [aScale, bScale] = [bScale, aScale];
+        }
+        return (amount * aScale + (mustCeil ? bScale - 1n : 0n)) / bScale;
+    }
+};
+/** CCC-backed ratio constructor and codec. */
+// eslint-disable-next-line @typescript-eslint/no-redeclare -- The public type and runtime constructor intentionally share a name.
+export const Ratio = RatioImplementation;
+//# sourceMappingURL=ratio.js.map

package/dist/order/ratio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratio.js","sourceRoot":"","sources":["../../src/order/ratio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAsB,MAAM,mBAAmB,CAAC;AAEtE,MAAM,SAAS,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;AAEnC,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC;IAC5B,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,eAAe;CAC1B,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAwB,CAAC;AAgC1D,kGAAkG;AAClG,MAAM,mBAAmB,GAAG,MAAM,KAAM,SAAQ,SAAS;IACvD;QACE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,sBAAsB;IACN,QAAQ,CAAU;IAClC,sBAAsB;IACN,QAAQ,CAAU;IAElC,uCAAuC;IACvC,YAAY,QAAiB,EAAE,QAAiB;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,gFAAgF;IACzE,MAAM,CAAU,IAAI,CAAC,KAAoB;QAC9C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;QACrC,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,kEAAkE;IAC3D,QAAQ;QACb,IACE,IAAI,CAAC,QAAQ,GAAG,EAAE;YAClB,IAAI,CAAC,QAAQ,GAAG,SAAS;YACzB,IAAI,CAAC,QAAQ,GAAG,EAAE;YAClB,IAAI,CAAC,QAAQ,GAAG,SAAS,EACzB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,iDAAiD;IAC1C,OAAO;QACZ,OAAO,IAAI,CAAC,QAAQ,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ,KAAK,EAAE,CAAC;IACtD,CAAC;IAED,kDAAkD;IAC3C,WAAW;QAChB,OAAO,IAAI,CAAC,QAAQ,GAAG,EAAE,IAAI,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IAClD,CAAC;IAED,wCAAwC;IACjC,MAAM,CAAC,KAAK;QACjB,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,mEAAmE;IAC5D,OAAO,CAAC,KAAY;QACzB,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,OAAO,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvF,CAAC;IAED,2EAA2E;IACpE,OAAO,CACZ,SAAkB,EAClB,MAAsB,EACtB,QAAiB;QAEjB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAClD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC;IACpE,CAAC;CACF,CAAC;AAEF,8CAA8C;AAC9C,kIAAkI;AAClI,MAAM,CAAC,MAAM,KAAK,GAQd,mBAAmB,CAAC"}

package/dist/order/relative.d.ts

@@ -0,0 +1,43 @@
+import { ccc } from "@ckb-ccc/core";
+/**
+ * Wire shape for a relative master pointer.
+ */
+export interface RelativeLike {
+    /** Must be the 32-byte zero padding used by the standard encoding. */
+    padding: ccc.BytesLike;
+    /** Signed output-index distance from the current order to its master. */
+    distance: ccc.NumLike;
+}
+/**
+ * Relative pointer from an order output to its master output.
+ */
+export interface Relative {
+    /** Standard zero padding. */
+    padding: ccc.Bytes;
+    /** Signed output-index distance to the master output. */
+    distance: ccc.Num;
+    /** Creates a copy of this relative pointer. */
+    clone(): Relative;
+    /** Returns whether another value has the same padding and distance. */
+    eq(other: RelativeLike): boolean;
+    /** Returns the CKB hash of the serialized relative pointer. */
+    hash(): ccc.Hex;
+    /** Serializes the relative pointer to bytes. */
+    toBytes(): ccc.Bytes;
+    /** Serializes the relative pointer to full-width hexadecimal. */
+    toHex(): ccc.Hex;
+    /** Throws unless padding is canonical and distance fits Int32. */
+    validate(): void;
+}
+/** CCC-backed relative-pointer constructor and codec. */
+export declare const Relative: {
+    byteLength?: number;
+    new (padding: ccc.Bytes, distance: ccc.Num): Relative;
+    create: (distance: ccc.Num) => Relative;
+    decode: (encoded: ccc.BytesLike) => Relative;
+    encode: (relative: RelativeLike) => ccc.Bytes;
+    from: (relative: RelativeLike) => Relative;
+    fromBytes: (encoded: ccc.BytesLike) => Relative;
+    padding: () => ccc.Bytes;
+};
+//# sourceMappingURL=relative.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relative.d.ts","sourceRoot":"","sources":["../../src/order/relative.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAO,MAAM,eAAe,CAAC;AAMzC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC;IACvB,yEAAyE;IACzE,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;CACvB;AASD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,6BAA6B;IAC7B,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC;IACnB,yDAAyD;IACzD,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC;IAClB,+CAA+C;IAC/C,KAAK,IAAI,QAAQ,CAAC;IAClB,uEAAuE;IACvE,EAAE,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC;IACjC,+DAA+D;IAC/D,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC;IAChB,gDAAgD;IAChD,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC;IACrB,iEAAiE;IACjE,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC;IACjB,kEAAkE;IAClE,QAAQ,IAAI,IAAI,CAAC;CAClB;AAmDD,yDAAyD;AAEzD,eAAO,MAAM,QAAQ,EAAE;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,OAAO,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,GAAG,GAAG,QAAQ,CAAC;IACtD,MAAM,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,KAAK,QAAQ,CAAC;IACxC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC;IAC7C,MAAM,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,GAAG,CAAC,KAAK,CAAC;IAC9C,IAAI,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,QAAQ,CAAC;IAC3C,SAAS,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC;IAChD,OAAO,EAAE,MAAM,GAAG,CAAC,KAAK,CAAC;CACD,CAAC"}

package/dist/order/relative.js

@@ -0,0 +1,54 @@
+import { ccc, mol } from "@ckb-ccc/core";
+import { CheckedInt32LE } from "../utils/codec.js";
+const minInt32 = -(1n << 31n);
+const maxInt32 = (1n << 31n) - 1n;
+const RelativeCodec = mol.struct({
+    padding: mol.Byte32,
+    distance: CheckedInt32LE,
+});
+const RelativeBase = ccc.Entity.Base();
+// eslint-disable-next-line @typescript-eslint/no-shadow -- Preserve the runtime constructor name.
+const RelativeImplementation = class Relative extends RelativeBase {
+    static {
+        ccc.codec(RelativeCodec)(this);
+    }
+    /** Standard zero padding. */
+    padding;
+    /** Signed output-index distance to the master output. */
+    distance;
+    /** Creates a normalized relative pointer. */
+    constructor(padding, distance) {
+        super();
+        this.padding = padding;
+        this.distance = distance;
+    }
+    /** Normalizes a relative pointer wire object or existing entity into `Relative`. */
+    static from(relative) {
+        if (relative instanceof Relative) {
+            return relative;
+        }
+        const { padding, distance } = relative;
+        return new Relative(ccc.bytesFrom(padding), ccc.numFrom(distance));
+    }
+    /** Creates a relative pointer with standard zero padding. */
+    static create(distance) {
+        return new Relative(Relative.padding(), distance);
+    }
+    /** Returns the standard 32-byte zero padding. */
+    static padding() {
+        return new Uint8Array(32);
+    }
+    /** Throws when padding is not the standard 32-byte zero value. */
+    validate() {
+        if (this.padding.length !== 32 || this.padding.some((x) => x !== 0)) {
+            throw new Error("Relative master invalid, non standard padding");
+        }
+        if (this.distance < minInt32 || this.distance > maxInt32) {
+            throw new Error("Relative master distance exceeds Int32");
+        }
+    }
+};
+/** CCC-backed relative-pointer constructor and codec. */
+// eslint-disable-next-line @typescript-eslint/no-redeclare -- The public type and runtime constructor intentionally share a name.
+export const Relative = RelativeImplementation;
+//# sourceMappingURL=relative.js.map

package/dist/order/relative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative.js","sourceRoot":"","sources":["../../src/order/relative.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC;AAC9B,MAAM,QAAQ,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;AAYlC,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC;IAC/B,OAAO,EAAE,GAAG,CAAC,MAAM;IACnB,QAAQ,EAAE,cAAc;CACzB,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAA0B,CAAC;AAwB/D,kGAAkG;AAClG,MAAM,sBAAsB,GAAG,MAAM,QAAS,SAAQ,YAAY;IAChE;QACE,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,6BAA6B;IACb,OAAO,CAAY;IACnC,yDAAyD;IACzC,QAAQ,CAAU;IAElC,6CAA6C;IAC7C,YAAY,OAAkB,EAAE,QAAiB;QAC/C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,oFAAoF;IAC7E,MAAM,CAAU,IAAI,CAAC,QAAsB;QAChD,IAAI,QAAQ,YAAY,QAAQ,EAAE,CAAC;YACjC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;QACvC,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,6DAA6D;IACtD,MAAM,CAAC,MAAM,CAAC,QAAiB;QACpC,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,iDAAiD;IAC1C,MAAM,CAAC,OAAO;QACnB,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,kEAAkE;IAC3D,QAAQ;QACb,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF,CAAC;AAEF,yDAAyD;AACzD,kIAAkI;AAClI,MAAM,CAAC,MAAM,QAAQ,GASjB,sBAAsB,CAAC"}