@ickb/sdk 1000.0.82 → 9001.0.0

package/dist/udt.d.ts

@@ -0,0 +1,108 @@
+import { ccc } from "@ckb-ccc/core";
+import type { ExchangeRatio } from "./utils/utils.js";
+export declare const receiptDataBytes = 12;
+/** The receipt payload for one or more identical iCKB deposits. */
+export interface ReceiptData {
+    /** Number of identical deposits represented by this receipt. */
+    depositQuantity: ccc.Num;
+    /** Free CKB capacity of each represented deposit before iCKB conversion. */
+    depositAmount: ccc.FixedPoint;
+}
+/** Encodes a receipt payload. */
+export declare function encodeReceiptData(data: ReceiptData): ccc.Bytes;
+/**
+ * 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 declare function decodeReceiptData(outputData: ccc.Hex): ReceiptData;
+/**
+ * Soft per-deposit iCKB value cap used before applying the excess discount.
+ */
+export declare const ICKB_DEPOSIT_CAP: bigint;
+/**
+ * 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 declare class IckbUdt {
+    /** The iCKB xUDT type script. */
+    readonly script: ccc.Script;
+    /** The iCKB dep group, which also carries the xUDT and iCKB Logic code cells. */
+    readonly cellDeps: ccc.CellDep[];
+    /** Logic script whose hash is embedded in this iCKB xUDT type script. */
+    readonly logicScript: ccc.Script;
+    /** The Nervos DAO script, to recognize the first-phase deposits a transaction re-mints. */
+    readonly daoScript: ccc.Script;
+    /** Creates an instance of IckbUdt from its code and script references. */
+    constructor({ script, cellDeps, logicScript, daoScript, }: {
+        script: ccc.ScriptLike;
+        cellDeps: ccc.CellDepLike[];
+        logicScript: ccc.ScriptLike;
+        daoScript: ccc.ScriptLike;
+    });
+    /**
+     * 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: ccc.Script, ickbLogic: ccc.Script): ccc.Script;
+    /**
+     * Minimum capacity for an iCKB xUDT cell locked by the supplied lock script.
+     */
+    static minimumXudtCellCapacity(lock: ccc.Script): ccc.FixedPoint;
+    /**
+     * Returns true when a cell carries this iCKB xUDT type and enough UDT data.
+     */
+    isUdt(cellLike: ccc.CellAnyLike): boolean;
+    /**
+     * iCKB carried by the transaction's inputs: xUDT balances plus receipt value, minus the
+     * first-phase deposits it re-mints. Receipts and deposits take the value the state read
+     * gave them at their deposit headers; a protocol input missing from `protocolCells` is
+     * a builder bug and throws, since iCKB Logic would refuse whatever it was valued at.
+     */
+    inputBalance(tx: ccc.Transaction, client: ccc.Client, protocolCells: readonly ProtocolCell[]): Promise<ccc.Num>;
+    /** 1 for a receipt, -1 for a first-phase iCKB deposit, 0 for any other cell. */
+    private protocolSign;
+    /** Adds the iCKB change output when the surplus is positive; zero needs no output. */
+    addChange(tx: ccc.Transaction, lock: ccc.ScriptLike, balance: ccc.Num): void;
+}
+/**
+ * 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 declare function ickbValue(ckbUnoccupiedCapacity: ccc.FixedPoint, header: ccc.ClientBlockHeader): ccc.FixedPoint;
+/** The iCKB worth `amount` CKB at `ratio`, rounded down. */
+export declare function udtFromCkb(amount: ccc.FixedPoint, ratio: ExchangeRatio): ccc.FixedPoint;
+/** The CKB worth `amount` iCKB at `ratio`, rounded down. */
+export declare function ckbFromUdt(amount: ccc.FixedPoint, ratio: ExchangeRatio): ccc.FixedPoint;
+/**
+ * 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 declare function ickbAccountingRatio(header: ccc.ClientBlockHeader): ExchangeRatio;
+/**
+ * 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 declare function ickbExchangeRatio(header: ccc.ClientBlockHeader): ExchangeRatio;
+/** A receipt or iCKB deposit with the iCKB value the state read gave it. */
+export interface ProtocolCell {
+    cell: ccc.Cell;
+    udtValue: ccc.Num;
+}
+//# sourceMappingURL=udt.d.ts.map

package/dist/udt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"udt.d.ts","sourceRoot":"","sources":["../src/udt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAO,MAAM,eAAe,CAAC;AAGzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAUtD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,eAAe,EAAE,GAAG,CAAC,GAAG,CAAC;IACzB,4EAA4E;IAC5E,aAAa,EAAE,GAAG,CAAC,UAAU,CAAC;CAC/B;AAOD,iCAAiC;AACjC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,GAAG,CAAC,KAAK,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,GAAG,CAAC,GAAG,GAAG,WAAW,CAElE;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAA6B,CAAC;AAE3D;;;;GAIG;AACH,qBAAa,OAAO;IAClB,iCAAiC;IACjC,SAAgB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;IAEnC,iFAAiF;IACjF,SAAgB,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAExC,yEAAyE;IACzE,SAAgB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC;IAExC,2FAA2F;IAC3F,SAAgB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC;IAEtC,0EAA0E;IAC1E,YAAY,EACV,MAAM,EACN,QAAQ,EACR,WAAW,EACX,SAAS,GACV,EAAE;QACD,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC;QACvB,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;QAC5B,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC;QAC5B,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC;KAC3B,EAKA;IAED;;;;;;;;;OASG;IACH,OAAc,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CASrF;IAED;;OAEG;IACH,OAAc,uBAAuB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,UAAU,CAItE;IAED;;OAEG;IACI,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,WAAW,GAAG,OAAO,CAM/C;IAED;;;;;OAKG;IACU,YAAY,CACvB,EAAE,EAAE,GAAG,CAAC,WAAW,EACnB,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,aAAa,EAAE,SAAS,YAAY,EAAE,GACrC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAwBlB;IAED,gFAAgF;IAChF,OAAO,CAAC,YAAY;IAQpB,sFAAsF;IAC/E,SAAS,CAAC,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,GAAG,IAAI,CAKlF;CACF;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,qBAAqB,EAAE,GAAG,CAAC,UAAU,EACrC,MAAM,EAAE,GAAG,CAAC,iBAAiB,GAC5B,GAAG,CAAC,UAAU,CAQhB;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,aAAa,GAAG,GAAG,CAAC,UAAU,CAGvF;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,aAAa,GAAG,GAAG,CAAC,UAAU,CAGvF;AAQD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,iBAAiB,GAAG,aAAa,CAKhF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,iBAAiB,GAAG,aAAa,CAK9E;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC;CACnB"}

package/dist/udt.js

@@ -0,0 +1,180 @@
+import { ccc, mol } from "@ckb-ccc/core";
+import { isDaoDeposit } from "./dao.js";
+import { CheckedUint128LE, CheckedUint32LE, CheckedUint64LE } from "./utils/codec.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;
+    /** The iCKB dep group, which also carries the xUDT and iCKB Logic code cells. */
+    cellDeps;
+    /** 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({ script, cellDeps, logicScript, daoScript, }) {
+        this.script = ccc.Script.from(script);
+        this.cellDeps = cellDeps.map((cellDep) => ccc.CellDep.from(cellDep));
+        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);
+    }
+    /**
+     * iCKB carried by the transaction's inputs: xUDT balances plus receipt value, minus the
+     * first-phase deposits it re-mints. Receipts and deposits take the value the state read
+     * gave them at their deposit headers; a protocol input missing from `protocolCells` is
+     * a builder bug and throws, since iCKB Logic would refuse whatever it was valued at.
+     */
+    async inputBalance(tx, client, protocolCells) {
+        const values = new Map(protocolCells.map(({ cell, udtValue }) => [cell.outPoint.toHex(), udtValue]));
+        let balance = ccc.Zero;
+        for (const input of tx.inputs) {
+            const cell = await input.getCell(client);
+            if (this.isUdt(cell)) {
+                balance += ccc.udtBalanceFrom(cell.outputData);
+                continue;
+            }
+            const sign = this.protocolSign(cell);
+            if (sign === 0n) {
+                continue;
+            }
+            const value = values.get(cell.outPoint.toHex());
+            if (value === undefined) {
+                throw new Error(`iCKB input ${cell.outPoint.toHex()} has no value from the state read`);
+            }
+            balance += sign * value;
+        }
+        return balance;
+    }
+    /** 1 for a receipt, -1 for a first-phase iCKB deposit, 0 for any other cell. */
+    protocolSign(cell) {
+        const { type, lock } = cell.cellOutput;
+        if (type !== undefined && this.logicScript.eq(type)) {
+            return 1n;
+        }
+        return this.logicScript.eq(lock) && isDaoDeposit(cell, this.daoScript) ? -1n : 0n;
+    }
+    /** 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));
+    }
+}
+/**
+ * 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 = udtFromCkb(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;
+}
+/** The iCKB worth `amount` CKB at `ratio`, rounded down. */
+export function udtFromCkb(amount, ratio) {
+    assertPositive(ratio);
+    return (amount * ratio.ckbScale) / ratio.udtScale;
+}
+/** The CKB worth `amount` iCKB at `ratio`, rounded down. */
+export function ckbFromUdt(amount, ratio) {
+    assertPositive(ratio);
+    return (amount * ratio.udtScale) / ratio.ckbScale;
+}
+function assertPositive({ ckbScale, udtScale }) {
+    if (ckbScale <= 0n || udtScale <= 0n) {
+        throw new Error("Exchange ratio scales must be positive");
+    }
+}
+/**
+ * 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,3 @@
+/** Public CKB networks supported by Stack consumers. */
+export type SupportedChain = "mainnet" | "testnet";
+//# 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,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC"}

package/dist/utils/chain.js

@@ -0,0 +1,2 @@
+export {};
+//# 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":""}

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;AAMH,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,69 @@
+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);
+    },
+});
+// CCC's unsigned codecs throw on overflow but encode a negative as its two's complement
+// without a word, and `Ratio.toBytes()` is public and skips `validate`, so these checked
+// codecs keep "never encode a negative" in one place; CCC has no signed Int32 codec at all.
+/** 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/utils.d.ts

@@ -0,0 +1,99 @@
+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;
+/**
+ * A CCC client cache sized for a whole pool: 4096 headers and 4096 transaction bodies,
+ * where CCC's defaults keep 128 and 256 (SDK README, Account state). An LRU fills only as
+ * far as the book and pool need.
+ */
+export declare function clientCache(): ccc.ClientCacheMemory;
+/** A committed cell and the block the node names for its creating transaction. */
+export interface ScannedCell {
+    cell: ccc.Cell;
+    blockNumber: ccc.Num;
+}
+/**
+ * Reads every committed cell matching the key with the block the node names for it, page
+ * by page through the raw requestor (CCC's typed scan drops the block), bypassing CCC's
+ * cell cache. A full page whose cursor does not advance throws. Why: SDK README, Account
+ * state.
+ */
+export declare function findCells(client: ccc.Client, keyLike: ccc.ClientIndexerSearchKeyLike): Promise<ScannedCell[]>;
+/** 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>>;
+/**
+ * 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;
+/**
+ * The client's JSON-RPC requestor, which the SDK's raw reads need: scans with block
+ * numbers, status polls and transaction proofs. 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;
+/** `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;AAGpC;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,GAAG,CAAC,iBAAiB,CAEnD;AAED,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC;IACf,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,OAAO,EAAE,GAAG,CAAC,0BAA0B,GACtC,OAAO,CAAC,WAAW,EAAE,CAAC,CA+BxB;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;AAaD;;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;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAMzE;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"}

package/dist/utils/utils.js

@@ -0,0 +1,130 @@
+import { ccc } from "@ckb-ccc/core";
+import { cccA } from "@ckb-ccc/core/advanced";
+/**
+ * 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 const defaultCellPageSize = 400;
+/**
+ * A CCC client cache sized for a whole pool: 4096 headers and 4096 transaction bodies,
+ * where CCC's defaults keep 128 and 256 (SDK README, Account state). An LRU fills only as
+ * far as the book and pool need.
+ */
+export function clientCache() {
+    return new ccc.ClientCacheMemory(512, 4096, 4096);
+}
+/**
+ * Reads every committed cell matching the key with the block the node names for it, page
+ * by page through the raw requestor (CCC's typed scan drops the block), bypassing CCC's
+ * cell cache. A full page whose cursor does not advance throws. Why: SDK README, Account
+ * state.
+ */
+export async function findCells(client, keyLike) {
+    const requestor = jsonRpcRequestor(client);
+    const key = cccA.JsonRpcTransformers.indexerSearchKeyFrom(keyLike);
+    const cells = [];
+    let after;
+    for (;;) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion, no-restricted-syntax -- the node's indexer answer, parsed field by field below as CCC's own transformer does.
+        const page = (await requestor.request("get_cells", [
+            key,
+            "asc",
+            ccc.numToHex(defaultCellPageSize),
+            after,
+        ]));
+        for (const object of page.objects) {
+            cells.push({
+                cell: ccc.Cell.from({
+                    outPoint: cccA.JsonRpcTransformers.outPointTo(object.out_point),
+                    cellOutput: cccA.JsonRpcTransformers.cellOutputTo(object.output),
+                    outputData: object.output_data ?? "0x",
+                }),
+                blockNumber: ccc.numFrom(object.block_number),
+            });
+        }
+        if (page.objects.length < defaultCellPageSize) {
+            return cells;
+        }
+        if (page.last_cursor === after) {
+            throw new Error("Cell scan cursor did not advance");
+        }
+        after = page.last_cursor;
+    }
+}
+/** 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];
+    }));
+}
+/**
+ * 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 function isPlainCapacityCell(cell) {
+    return cell.cellOutput.type === undefined && cell.outputData === "0x";
+}
+/**
+ * The client's JSON-RPC requestor, which the SDK's raw reads need: scans with block
+ * numbers, status polls and transaction proofs. 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 function jsonRpcRequestor(client) {
+    const requestor = "requestor" in client ? client.requestor : undefined;
+    if (!(requestor instanceof ccc.RequestorJsonRpc)) {
+        throw new TypeError("The SDK needs a JSON-RPC client");
+    }
+    return requestor;
+}
+/** `numerator / denominator` rounded up; the denominator is positive. */
+export function ceilDiv(numerator, denominator) {
+    return (numerator + denominator - 1n) / denominator;
+}
+/**
+ * Compares two bigint values using sort-compatible ordering.
+ *
+ * @returns `-1` when `left` is smaller, `1` when `left` is larger, and `0` when equal.
+ */
+export function compareBigInt(left, right) {
+    if (left < right) {
+        return -1;
+    }
+    if (left > right) {
+        return 1;
+    }
+    return 0;
+}
+/**
+ * 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 function* unique(items) {
+    const set = new Set();
+    for (const i of items) {
+        const key = i.toHex();
+        if (!set.has(key)) {
+            set.add(key);
+            yield i;
+        }
+    }
+}
+//# sourceMappingURL=utils.js.map