@ickb/sdk 1000.0.81 → 9000.0.1

package/dist/udt.js

@@ -0,0 +1,244 @@
+import { ccc, mol } from "@ckb-ccc/core";
+import { isDaoDeposit } from "./dao.js";
+import { CheckedUint128LE, CheckedUint32LE, CheckedUint64LE } from "./utils/codec.js";
+import { transactionHeaders } from "./utils/transaction_header.js";
+const ickbXudtTypeOccupiedSize = 69;
+const udtDataSize = 16;
+const AR_0 = 10000000000000000n; // Base scale for CKB
+const depositUsedCapacity = ccc.fixedPointFrom(82); // 82n CKB
+const depositCapacityDelta = (depositUsedCapacity * AR_0) / ccc.fixedPointFrom(100000);
+const xudtOwnerMode = 0x80000000n;
+// A receipt's fixed prefix: 4 bytes of deposit quantity and 8 of deposit amount.
+export const receiptDataBytes = 12;
+const ReceiptDataCodec = mol.struct({
+    depositQuantity: CheckedUint32LE,
+    depositAmount: CheckedUint64LE,
+});
+/** Encodes a receipt payload. */
+export function encodeReceiptData(data) {
+    return ReceiptDataCodec.encode(data);
+}
+/**
+ * Decodes the fixed receipt-data prefix and ignores trailing cell payload bytes.
+ *
+ * @remarks The receipt data prefix is 12 bytes after the `0x` marker: 4 bytes for deposit
+ * quantity and 8 bytes for deposit amount. Later payload bytes belong to other protocol
+ * data and are intentionally tolerated here.
+ */
+export function decodeReceiptData(outputData) {
+    return ReceiptDataCodec.decode(outputData.slice(0, 2 + 2 * receiptDataBytes));
+}
+/**
+ * Soft per-deposit iCKB value cap used before applying the excess discount.
+ */
+export const ICKB_DEPOSIT_CAP = ccc.fixedPointFrom(100000); // 100,000 iCKB
+/**
+ * The iCKB xUDT token: its scripts, code cells, and the iCKB accounting of a
+ * transaction's inputs. Inputs carry iCKB as xUDT balances, as receipt value,
+ * and negatively as the first-phase deposits a transaction re-mints.
+ */
+export class IckbUdt {
+    /** The iCKB xUDT type script. */
+    script;
+    /** Out point of the xUDT code cell used by this iCKB token. */
+    udtCode;
+    /** Out point of the iCKB Logic code cell required by this token. */
+    logicCode;
+    /** Logic script whose hash is embedded in this iCKB xUDT type script. */
+    logicScript;
+    /** The Nervos DAO script, to recognize the first-phase deposits a transaction re-mints. */
+    daoScript;
+    /** Creates an instance of IckbUdt from its code and script references. */
+    constructor({ code, script, logicCode, logicScript, daoScript, }) {
+        this.script = ccc.Script.from(script);
+        this.udtCode = ccc.OutPoint.from(code);
+        this.logicCode = ccc.OutPoint.from(logicCode);
+        this.logicScript = ccc.Script.from(logicScript);
+        this.daoScript = ccc.Script.from(daoScript);
+    }
+    /**
+     * Computes the iCKB UDT type script from raw UDT and Logic scripts.
+     *
+     * Concatenates the iCKB logic script hash with the fixed 4-byte little-endian
+     * xUDT owner-mode flags postfix ("00000080") to form the UDT type script args.
+     *
+     * @param udtScript - The raw xUDT script (codeHash and hashType reused).
+     * @param ickbLogic - The iCKB logic script (hash used for args).
+     * @returns A new Script with the computed args.
+     */
+    static typeScriptFrom(udtScript, ickbLogic) {
+        const { codeHash, hashType } = udtScript;
+        return new ccc.Script(codeHash, hashType, ccc.hexFrom(ccc.bytesConcat(ickbLogic.hash(), CheckedUint32LE.encode(xudtOwnerMode))));
+    }
+    /**
+     * Minimum capacity for an iCKB xUDT cell locked by the supplied lock script.
+     */
+    static minimumXudtCellCapacity(lock) {
+        return (BigInt(8 + lock.occupiedSize + ickbXudtTypeOccupiedSize + udtDataSize) * ccc.One);
+    }
+    /**
+     * Returns true when a cell carries this iCKB xUDT type and enough UDT data.
+     */
+    isUdt(cellLike) {
+        const cell = ccc.CellAny.from(cellLike);
+        return (cell.cellOutput.type?.eq(this.script) === true &&
+            ccc.bytesFrom(cell.outputData).length >= udtDataSize);
+    }
+    /**
+     * Adds iCKB-specific cell dependencies to a transaction.
+     *
+     * Adds individual code deps (not dep group) for:
+     * - xUDT code cell (this.udtCode)
+     * - iCKB Logic code cell (this.logicCode)
+     *
+     * @param txLike - The transaction to add cell deps to.
+     * @returns The transaction with cell deps added.
+     */
+    addCellDeps(txLike) {
+        const tx = ccc.Transaction.from(txLike);
+        addCodeDep(tx, this.udtCode);
+        addCodeDep(tx, this.logicCode);
+        return tx;
+    }
+    /**
+     * iCKB carried by the transaction's inputs: xUDT balances plus receipt value,
+     * minus the first-phase deposits it re-mints. Final withdrawal inputs carry none.
+     * The protocol cells are valued at their deposit headers, each read once.
+     */
+    async inputBalance(tx, client) {
+        const cells = await Promise.all(tx.inputs.map(async (input) => {
+            try {
+                return await input.getCell(client);
+            }
+            catch (error) {
+                throw new Error(`Failed to load input cell ${input.previousOutput.toHex()}`, {
+                    cause: error,
+                });
+            }
+        }));
+        const valued = cells.map((cell) => this.protocolValue(cell));
+        const headers = await transactionHeaders(client, valued.flatMap((value) => (value === undefined ? [] : [value.txHash])));
+        let balance = ccc.Zero;
+        for (const [index, cell] of cells.entries()) {
+            const value = valued[index];
+            if (this.isUdt(cell)) {
+                balance += decodeUdtBalance(cell.outputData);
+            }
+            else if (value !== undefined) {
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- every protocol cell's hash was read above.
+                const header = headers.get(value.txHash);
+                balance += value.sign * ickbValue(value.amount, header) * value.quantity;
+            }
+        }
+        return balance;
+    }
+    /** What a protocol input (receipt or first-phase deposit) is worth once its header is known. */
+    protocolValue(cell) {
+        if (this.isUdt(cell) || cell.outPoint === undefined) {
+            return undefined;
+        }
+        const { type, lock } = cell.cellOutput;
+        if (type !== undefined && this.logicScript.eq(type)) {
+            let receipt;
+            try {
+                receipt = decodeReceiptData(cell.outputData);
+            }
+            catch (error) {
+                throw new Error(`Invalid iCKB receipt payload at ${cell.outPoint.toHex()}: ${cell.outputData}`, { cause: error });
+            }
+            return {
+                txHash: cell.outPoint.txHash,
+                amount: receipt.depositAmount,
+                quantity: receipt.depositQuantity,
+                sign: 1n,
+            };
+        }
+        if (this.logicScript.eq(lock) && isDaoDeposit(cell, this.daoScript)) {
+            return {
+                txHash: cell.outPoint.txHash,
+                amount: cell.capacityFree,
+                quantity: 1n,
+                sign: -1n,
+            };
+        }
+        return undefined;
+    }
+    /** iCKB the transaction's outputs require. */
+    outputBalance(tx) {
+        return Array.from(tx.outputCells).reduce((required, cell) => {
+            return this.isUdt(cell) ? required + decodeUdtBalance(cell.outputData) : required;
+        }, ccc.Zero);
+    }
+    /** Adds the iCKB change output when the surplus is positive; zero needs no output. */
+    addChange(tx, lock, balance) {
+        if (balance <= ccc.Zero) {
+            return;
+        }
+        tx.addOutput({ lock, type: this.script }, CheckedUint128LE.encode(balance));
+    }
+}
+function decodeUdtBalance(data) {
+    return CheckedUint128LE.decode(ccc.bytesFrom(data).slice(0, udtDataSize));
+}
+function addCodeDep(tx, outPoint) {
+    if (tx.cellDeps.some((dep) => dep.depType === "code" && dep.outPoint.eq(outPoint))) {
+        return;
+    }
+    tx.addCellDeps({ outPoint, depType: "code" });
+}
+/**
+ * Calculates iCKB value for unoccupied CKB capacity at a deposit header.
+ *
+ * @remarks
+ * Values above {@link ICKB_DEPOSIT_CAP} receive a 10% discount only on the
+ * excess amount.
+ */
+export function ickbValue(ckbUnoccupiedCapacity, header) {
+    let ickbAmount = convert(true, ckbUnoccupiedCapacity, ickbAccountingRatio(header));
+    if (ICKB_DEPOSIT_CAP < ickbAmount) {
+        // Apply a 10% discount for the amount exceeding the soft iCKB cap per deposit.
+        ickbAmount -= (ickbAmount - ICKB_DEPOSIT_CAP) / 10n;
+    }
+    return ickbAmount;
+}
+/**
+ * Converts between CKB and iCKB based on an explicit ratio.
+ *
+ * @param isCkb2Udt - A boolean indicating the direction of conversion (CKB to iCKB or vice versa).
+ * @param amount - The amount to convert.
+ * @param ratio - The CKB and iCKB scales to use.
+ * @returns The converted amount in the target unit as a `ccc.FixedPoint`.
+ */
+export function convert(isCkb2Udt, amount, ratio) {
+    if (ratio.ckbScale <= 0n || ratio.udtScale <= 0n) {
+        throw new Error("Exchange ratio scales must be positive");
+    }
+    return isCkb2Udt
+        ? (amount * ratio.ckbScale) / ratio.udtScale
+        : (amount * ratio.udtScale) / ratio.ckbScale;
+}
+/**
+ * Calculates the free-capacity accounting ratio at a block header.
+ *
+ * @param header - The block header whose DAO accumulated rate is used.
+ * @returns An object containing the CKB and UDT scales.
+ */
+export function ickbAccountingRatio(header) {
+    return {
+        ckbScale: AR_0,
+        udtScale: header.dao.ar,
+    };
+}
+/**
+ * Calculates the gross iCKB exchange ratio for a recoverable standard deposit.
+ *
+ * @remarks Includes the standard deposit's 82 CKB occupied capacity spread
+ * over the 100,000 iCKB reference amount.
+ */
+export function ickbExchangeRatio(header) {
+    return {
+        ckbScale: AR_0,
+        udtScale: header.dao.ar + depositCapacityDelta,
+    };
+}
+//# sourceMappingURL=udt.js.map

package/dist/udt.js.map

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

package/dist/utils/chain.d.ts

@@ -0,0 +1,38 @@
+import type { ccc } from "@ckb-ccc/core";
+/** Public CKB networks supported by Stack consumers. */
+export type SupportedChain = "mainnet" | "testnet";
+/** Canonical public identity of one supported CKB network. */
+export interface ChainIdentity {
+    /** Stack network selector represented by this identity. */
+    readonly chain: SupportedChain;
+    /** CKB specification network name. */
+    readonly networkName: string;
+    /** Canonical genesis block hash. */
+    readonly genesisHash: ccc.Hex;
+    /** Canonical genesis message used by the CKB specification. */
+    readonly genesisMessage: string;
+    /** Public specification location from which the genesis identity was derived. */
+    readonly genesisSource: string;
+    /** Canonical address prefix for this network. */
+    readonly addressPrefix: "ckb" | "ckt";
+}
+/** The immutable canonical identity of each supported chain. */
+export declare const chainIdentities: Readonly<{
+    readonly mainnet: Readonly<{
+        chain: "mainnet";
+        networkName: "ckb";
+        genesisHash: "0x92b197aa1fba0f63633922c61c92375c9c074a93e85963554f5499fe1450d0e5";
+        genesisMessage: "lina 0x18e020f6b1237a3d06b75121f25a7efa0550e4b3f44f974822f471902424c104";
+        genesisSource: "https://raw.githubusercontent.com/nervosnetwork/ckb/develop/resource/specs/mainnet.toml";
+        addressPrefix: "ckb";
+    }>;
+    readonly testnet: Readonly<{
+        chain: "testnet";
+        networkName: "ckb_testnet";
+        genesisHash: "0x10639e0895502b5688a6be8cf69460d76541bfa4821629d86d62ba0aae3f9606";
+        genesisMessage: "aggron-v4";
+        genesisSource: "https://raw.githubusercontent.com/nervosnetwork/ckb/develop/resource/specs/testnet.toml";
+        addressPrefix: "ckt";
+    }>;
+}>;
+//# sourceMappingURL=chain.d.ts.map

package/dist/utils/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/utils/chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEzC,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnD,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,iFAAiF;IACjF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,aAAa,EAAE,KAAK,GAAG,KAAK,CAAC;CACvC;AAED,gEAAgE;AAChE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;EAoB+B,CAAC"}

package/dist/utils/chain.js

@@ -0,0 +1,20 @@
+/** The immutable canonical identity of each supported chain. */
+export const chainIdentities = Object.freeze({
+    mainnet: Object.freeze({
+        chain: "mainnet",
+        networkName: "ckb",
+        genesisHash: "0x92b197aa1fba0f63633922c61c92375c9c074a93e85963554f5499fe1450d0e5",
+        genesisMessage: "lina 0x18e020f6b1237a3d06b75121f25a7efa0550e4b3f44f974822f471902424c104",
+        genesisSource: "https://raw.githubusercontent.com/nervosnetwork/ckb/develop/resource/specs/mainnet.toml",
+        addressPrefix: "ckb",
+    }),
+    testnet: Object.freeze({
+        chain: "testnet",
+        networkName: "ckb_testnet",
+        genesisHash: "0x10639e0895502b5688a6be8cf69460d76541bfa4821629d86d62ba0aae3f9606",
+        genesisMessage: "aggron-v4",
+        genesisSource: "https://raw.githubusercontent.com/nervosnetwork/ckb/develop/resource/specs/testnet.toml",
+        addressPrefix: "ckt",
+    }),
+});
+//# sourceMappingURL=chain.js.map

package/dist/utils/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../src/utils/chain.ts"],"names":[],"mappings":"AAqBA,gEAAgE;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,oEAAoE;QACjF,cAAc,EACZ,yEAAyE;QAC3E,aAAa,EACX,yFAAyF;QAC3F,aAAa,EAAE,KAAK;KACrB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE,oEAAoE;QACjF,cAAc,EAAE,WAAW;QAC3B,aAAa,EACX,yFAAyF;QAC3F,aAAa,EAAE,KAAK;KACrB,CAAC;CACsD,CAAC,CAAC"}

package/dist/utils/codec.d.ts

@@ -0,0 +1,19 @@
+import { ccc } from "@ckb-ccc/core";
+/**
+ * Codec for little-endian 32-bit signed integers.
+ *
+ * @remarks
+ * The encoder rejects numeric values outside the signed 32-bit range before
+ * writing bytes. Decoding reads a signed little-endian integer from the bytes
+ * after CCC byte normalization.
+ */
+export declare const CheckedInt32LE: ccc.Codec<ccc.NumLike, number, any>;
+/** Checked codec for 8-bit unsigned integers. */
+export declare const CheckedUint8: ccc.Codec<ccc.NumLike, bigint, any>;
+/** Checked codec for little-endian 32-bit unsigned integers. */
+export declare const CheckedUint32LE: ccc.Codec<ccc.NumLike, bigint, any>;
+/** Checked codec for little-endian 64-bit unsigned integers. */
+export declare const CheckedUint64LE: ccc.Codec<ccc.NumLike, bigint, any>;
+/** Checked codec for little-endian 128-bit unsigned integers. */
+export declare const CheckedUint128LE: ccc.Codec<ccc.NumLike, bigint, any>;
+//# sourceMappingURL=codec.d.ts.map

package/dist/utils/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/utils/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,qCAmBzB,CAAC;AAEH,iDAAiD;AACjD,eAAO,MAAM,YAAY,qCAAmB,CAAC;AAE7C,gEAAgE;AAChE,eAAO,MAAM,eAAe,qCAAmB,CAAC;AAEhD,gEAAgE;AAChE,eAAO,MAAM,eAAe,qCAAmB,CAAC;AAEhD,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,qCAAoB,CAAC"}

package/dist/utils/codec.js

@@ -0,0 +1,66 @@
+import { ccc } from "@ckb-ccc/core";
+/**
+ * Codec for little-endian 32-bit signed integers.
+ *
+ * @remarks
+ * The encoder rejects numeric values outside the signed 32-bit range before
+ * writing bytes. Decoding reads a signed little-endian integer from the bytes
+ * after CCC byte normalization.
+ */
+export const CheckedInt32LE = ccc.Codec.from({
+    byteLength: 4,
+    encode: (numLike) => {
+        const normalized = normalizeInteger(numLike);
+        if (normalized < -2147483648n || normalized > 2147483647n) {
+            throw new Error("NumLike out of int32 bounds");
+        }
+        const num = Number(normalized);
+        const encoded = new Uint8Array(4);
+        new DataView(encoded.buffer).setInt32(0, num, true);
+        return encoded;
+    },
+    decode: (bytesLike) => {
+        const bytes = ccc.bytesFrom(bytesLike);
+        return new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength).getInt32(0, true);
+    },
+});
+/** Checked codec for 8-bit unsigned integers. */
+export const CheckedUint8 = checkedUintLE(1);
+/** Checked codec for little-endian 32-bit unsigned integers. */
+export const CheckedUint32LE = checkedUintLE(4);
+/** Checked codec for little-endian 64-bit unsigned integers. */
+export const CheckedUint64LE = checkedUintLE(8);
+/** Checked codec for little-endian 128-bit unsigned integers. */
+export const CheckedUint128LE = checkedUintLE(16);
+function checkedUintLE(byteLength) {
+    const bitLength = BigInt(byteLength * 8);
+    const max = (1n << bitLength) - 1n;
+    return ccc.Codec.from({
+        byteLength,
+        encode: (numLike) => {
+            const num = normalizeInteger(numLike);
+            if (num < 0n || num > max) {
+                throw new Error(`NumLike out of uint${String(bitLength)} bounds`);
+            }
+            return ccc.numLeToBytes(num, byteLength);
+        },
+        decode: ccc.numFromBytes,
+    });
+}
+function normalizeInteger(numLike) {
+    if (typeof numLike === "number") {
+        if (!Number.isFinite(numLike) || !Number.isInteger(numLike)) {
+            throw new TypeError("NumLike must be a finite integer");
+        }
+        if (!Number.isSafeInteger(numLike)) {
+            throw new TypeError("NumLike number must be a safe integer");
+        }
+    }
+    try {
+        return ccc.numFrom(numLike);
+    }
+    catch {
+        throw new TypeError("NumLike must be a finite integer");
+    }
+}
+//# sourceMappingURL=codec.js.map

package/dist/utils/codec.js.map

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

package/dist/utils/transaction_header.d.ts

@@ -0,0 +1,17 @@
+import type { ccc } from "@ckb-ccc/core";
+/**
+ * The header of the block that committed `txHash`, without the transaction body, which no
+ * caller reads. A client with a JSON-RPC requestor, the connector's composed client
+ * included, asks the node for the status only (verbosity 1) and then the header by number,
+ * which CCC caches once confirmed; a cold read of the pool then moves a few bytes per
+ * deposit instead of every deposit transaction. Any other client keeps the typed lookup.
+ */
+export declare function getTransactionHeader(client: ccc.Client, txHash: ccc.Hex): Promise<ccc.ClientBlockHeader | undefined>;
+/**
+ * The committing headers of a batch of transactions, each hash read once. A batch is one
+ * coherent read: the cells came from one scan, so every header must exist.
+ */
+export declare function transactionHeaders(client: ccc.Client, txHashes: Iterable<ccc.Hex>): Promise<Map<ccc.Hex, ccc.ClientBlockHeader>>;
+/** The headers of a batch of block numbers, each read once; every block must exist. */
+export declare function headersByNumber(client: ccc.Client, blockNumbers: Iterable<ccc.Num>): Promise<Map<ccc.Num, ccc.ClientBlockHeader>>;
+//# sourceMappingURL=transaction_header.d.ts.map

package/dist/utils/transaction_header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction_header.d.ts","sourceRoot":"","sources":["../../src/utils/transaction_header.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAGzC;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,MAAM,EAAE,GAAG,CAAC,GAAG,GACd,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAS5C;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,GAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAc9C;AAED,uFAAuF;AACvF,wBAAsB,eAAe,CACnC,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,GAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAc9C"}

package/dist/utils/transaction_header.js

@@ -0,0 +1,44 @@
+import { jsonRpcRequestor, rawTransactionStatus } from "./utils.js";
+/**
+ * The header of the block that committed `txHash`, without the transaction body, which no
+ * caller reads. A client with a JSON-RPC requestor, the connector's composed client
+ * included, asks the node for the status only (verbosity 1) and then the header by number,
+ * which CCC caches once confirmed; a cold read of the pool then moves a few bytes per
+ * deposit instead of every deposit transaction. Any other client keeps the typed lookup.
+ */
+export async function getTransactionHeader(client, txHash) {
+    const requestor = jsonRpcRequestor(client);
+    if (requestor === undefined) {
+        return (await client.getTransactionWithHeader(txHash))?.header;
+    }
+    const { blockNumber } = rawTransactionStatus(await requestor.request("get_transaction", [txHash, "0x1"]));
+    return blockNumber === undefined ? undefined : client.getHeaderByNumber(blockNumber);
+}
+/**
+ * The committing headers of a batch of transactions, each hash read once. A batch is one
+ * coherent read: the cells came from one scan, so every header must exist.
+ */
+export async function transactionHeaders(client, txHashes) {
+    const distinct = [...new Set(txHashes)];
+    const headers = await Promise.all(distinct.map(async (txHash) => getTransactionHeader(client, txHash)));
+    return new Map(distinct.map((txHash, index) => {
+        const header = headers[index];
+        if (header === undefined) {
+            throw new Error(`Header not found for txHash ${txHash}`);
+        }
+        return [txHash, header];
+    }));
+}
+/** The headers of a batch of block numbers, each read once; every block must exist. */
+export async function headersByNumber(client, blockNumbers) {
+    const distinct = [...new Set(blockNumbers)];
+    const headers = await Promise.all(distinct.map(async (blockNumber) => client.getHeaderByNumber(blockNumber)));
+    return new Map(distinct.map((blockNumber, index) => {
+        const header = headers[index];
+        if (header === undefined) {
+            throw new Error(`Header not found for block number ${String(blockNumber)}`);
+        }
+        return [blockNumber, header];
+    }));
+}
+//# sourceMappingURL=transaction_header.js.map

package/dist/utils/transaction_header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction_header.js","sourceRoot":"","sources":["../../src/utils/transaction_header.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAkB,EAClB,MAAe;IAEf,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,MAAM,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC;IACjE,CAAC;IACD,MAAM,EAAE,WAAW,EAAE,GAAG,oBAAoB,CAC1C,MAAM,SAAS,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAC5D,CAAC;IACF,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;AACvF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAkB,EAClB,QAA2B;IAE3B,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CACrE,CAAC;IACF,OAAO,IAAI,GAAG,CACZ,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAkB,EAClB,YAA+B;IAE/B,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAC3E,CAAC;IACF,OAAO,IAAI,GAAG,CACZ,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/utils/utils.d.ts

@@ -0,0 +1,126 @@
+import { ccc } from "@ckb-ccc/core";
+/**
+ * The default page size used when querying cells from the chain.
+ *
+ * This page size is aligned with Nervos CKB's pull request #4576
+ * (https://github.com/nervosnetwork/ckb/pull/4576) to avoid excessive paging.
+ */
+export declare const defaultCellPageSize = 400;
+/**
+ * Reads every committed cell matching the key, page by page, without touching
+ * CCC's cell cache. The scan ends on the first short page.
+ *
+ * @remarks A full page must advance the cursor; otherwise the read throws so a faulty
+ * endpoint in the app's public node pool cannot keep the scan looping forever.
+ * The cursor continues ordering, not a coherent snapshot. There is no aggregate budget:
+ * a large book costs a slower read rather than a partial result.
+ */
+export declare function findCells(client: ccc.Client, keyLike: ccc.ClientIndexerSearchKeyLike): Promise<ccc.Cell[]>;
+/**
+ * Local transaction inclusion metadata.
+ */
+export interface TransactionHeader {
+    /**
+     * The block header used for inclusion-dependent calculations.
+     */
+    header: ccc.ClientBlockHeader;
+    /**
+     * The transaction hash when the caller has resolved it for the header.
+     */
+    txHash?: ccc.Hex;
+}
+/**
+ * CKB and UDT amounts carried by a cell, order, or planned value.
+ */
+export interface ValueComponents {
+    /** CKB-side amount as a `ccc.FixedPoint`. */
+    ckbValue: ccc.FixedPoint;
+    /** UDT-side amount as a `ccc.FixedPoint`. */
+    udtValue: ccc.FixedPoint;
+}
+/**
+ * Integer scale pair for comparing or converting CKB-side and UDT-side values.
+ *
+ * @remarks
+ * CKB-to-UDT conversions multiply by `ckbScale` and divide by `udtScale`.
+ * UDT-to-CKB conversions swap the scales. Callers choose the rounding policy.
+ */
+export interface ExchangeRatio {
+    /** Numerator scale for CKB-side values. */
+    ckbScale: ccc.Num;
+    /** Numerator scale for UDT-side values. */
+    udtScale: ccc.Num;
+}
+/**
+ * Script plus cell dependencies needed to build transactions that use it.
+ */
+export interface ScriptDeps {
+    /**
+     * The lock or type script.
+     */
+    script: ccc.Script;
+    /**
+     * Cell dependencies required to resolve the script code.
+     */
+    cellDeps: ccc.CellDep[];
+}
+/**
+ * True when a cell has no type script and no data payload.
+ *
+ * @remarks
+ * This is a structural filter for plain capacity cells. Spendability still
+ * depends on the lock script, live cell state, and transaction context.
+ */
+export declare function isPlainCapacityCell(cell: ccc.Cell): boolean;
+/**
+ * Performs asynchronously a binary search to find the smallest index `i` in the range [0, n)
+ * such that the function `f(i)` returns true. It is assumed that for the range
+ * [0, n), if `f(i)` is true, then `f(i+1)` is also true. This means that there
+ * is a prefix of the input range where `f` is false, followed by a suffix where
+ * `f` is true. If no such index exists, the function returns `n`.
+ *
+ * The function `f` is only called for indices in the range [0, n).
+ *
+ * @param n - The non-negative integer upper bound of the search range (exclusive).
+ * @param f - An async function that takes an index `i` and returns a boolean value.
+ * @returns The smallest index `i` such that `f(i)` is true, or `n` if no such index exists.
+ *
+ * @remarks Adapted from Go's standard library search implementation:
+ * {@link https://go.dev/src/sort/search.go}
+ */
+export declare function asyncBinarySearch(n: number, f: (i: number) => Promise<boolean>): Promise<number>;
+/**
+ * The client's JSON-RPC requestor, when it has one. The connector hands the interface a
+ * composition proxy over the public client (`ClientWithFeeRate`, a `ccc.Client` but not a
+ * `ccc.ClientJsonRpc`), so `instanceof` misses it; the proxy forwards the property.
+ */
+export declare function jsonRpcRequestor(client: ccc.Client): ccc.RequestorJsonRpc | undefined;
+/** A node's raw `get_transaction` status record (verbosity 1), the fields the stack reads. */
+export declare function rawTransactionStatus(response: unknown): {
+    status: string | undefined;
+    reason: string | undefined;
+    blockNumber: ccc.Num | undefined;
+};
+export declare function minBigInt(left: bigint, right: bigint): bigint;
+export declare function maxBigInt(left: bigint, right: bigint): bigint;
+/** `numerator / denominator` rounded up; the denominator is positive. */
+export declare function ceilDiv(numerator: bigint, denominator: bigint): bigint;
+/**
+ * Compares two bigint values using sort-compatible ordering.
+ *
+ * @returns `-1` when `left` is smaller, `1` when `left` is larger, and `0` when equal.
+ */
+export declare function compareBigInt(left: bigint, right: bigint): number;
+/**
+ * Yields unique items from the given iterable based on their hex representation.
+ *
+ * The function uses a Set to track the hex-string keys of items that have already been yielded.
+ * Only the first occurrence of each unique key is yielded.
+ *
+ * @typeParam T - A type that extends ccc.Entity.
+ * @param items - An iterable collection of items of type T.
+ * @returns A generator that yields items from the iterable, ensuring that each item's
+ *          hex representation (via toHex()) is unique.
+ */
+export declare function unique<T extends ccc.Entity>(items: Iterable<T>): Generator<T>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,OAAO,EAAE,GAAG,CAAC,0BAA0B,GACtC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAoBrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,MAAM,EAAE,GAAG,CAAC,iBAAiB,CAAC;IAE9B;;OAEG;IACH,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC;IAEzB,6CAA6C;IAC7C,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC;IAElB,2CAA2C;IAC3C,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,OAAO,CAE3D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,gBAAgB,GAAG,SAAS,CAMrF;AAED,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG;IACvD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,WAAW,EAAE,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC;CAClC,CAmBA;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUjE;AAED;;;;;;;;;;GAUG;AACH,wBAAiB,MAAM,CAAC,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAS9E"}