@ckb-ccc/core 0.0.0-canary-20250214032000

package/dist/ckb/script.d.ts

@@ -0,0 +1,143 @@
+import { Bytes, BytesLike } from "../bytes/index.js";
+import { Client, KnownScript } from "../client/index.js";
+import { Hex, HexLike } from "../hex/index.js";
+import { mol } from "../molecule/index.js";
+export declare const HashTypeCodec: mol.Codec<HashTypeLike, HashType>;
+/**
+ * @public
+ */
+export type HashTypeLike = string | number | bigint;
+/**
+ * @public
+ */
+export type HashType = "type" | "data" | "data1" | "data2";
+/**
+ * Converts a HashTypeLike value to a HashType.
+ * @public
+ *
+ * @param val - The value to convert, which can be a string, number, or bigint.
+ * @returns The corresponding HashType.
+ *
+ * @throws Will throw an error if the input value is not a valid hash type.
+ *
+ * @example
+ * ```typescript
+ * const hashType = hashTypeFrom(1); // Outputs "data"
+ * const hashType = hashTypeFrom("type"); // Outputs "type"
+ * ```
+ */
+export declare function hashTypeFrom(val: HashTypeLike): HashType;
+/**
+ * Converts a HashTypeLike value to its corresponding byte representation.
+ * @public
+ *
+ * @param hashType - The hash type value to convert.
+ * @returns A Uint8Array containing the byte representation of the hash type.
+ *
+ * @example
+ * ```typescript
+ * const hashTypeBytes = hashTypeToBytes("type"); // Outputs Uint8Array [0]
+ * ```
+ */
+export declare function hashTypeToBytes(hashType: HashTypeLike): Bytes;
+/**
+ * Converts a byte-like value to a HashType.
+ * @public
+ *
+ * @param bytes - The byte-like value to convert.
+ * @returns The corresponding HashType.
+ *
+ * @throws Will throw an error if the input bytes do not correspond to a valid hash type.
+ *
+ * @example
+ * ```typescript
+ * const hashType = hashTypeFromBytes(new Uint8Array([0])); // Outputs "type"
+ * ```
+ */
+export declare function hashTypeFromBytes(bytes: BytesLike): HashType;
+/**
+ * @public
+ */
+export type ScriptLike = {
+    codeHash: BytesLike;
+    hashType: HashTypeLike;
+    args: BytesLike;
+};
+declare const Script_base: (abstract new () => {
+    toBytes(): Bytes;
+    clone(): Script;
+    eq(other: ScriptLike): boolean;
+    hash(): Hex;
+}) & {
+    byteLength?: number;
+    encode(_: ScriptLike): Bytes;
+    decode(_: BytesLike): Script;
+    fromBytes(_bytes: BytesLike): Script;
+    from(_: ScriptLike): Script;
+};
+/**
+ * @public
+ */
+export declare class Script extends Script_base {
+    codeHash: Hex;
+    hashType: HashType;
+    args: Hex;
+    /**
+     * Creates an instance of Script.
+     *
+     * @param codeHash - The code hash of the script.
+     * @param hashType - The hash type of the script.
+     * @param args - The arguments for the script.
+     */
+    constructor(codeHash: Hex, hashType: HashType, args: Hex);
+    get occupiedSize(): number;
+    /**
+     * Clone a script.
+     *
+     * @returns A cloned Script instance.
+     *
+     * @example
+     * ```typescript
+     * const script1 = script0.clone();
+     * ```
+     */
+    clone(): Script;
+    /**
+     * Creates a Script instance from a ScriptLike object.
+     *
+     * @param script - A ScriptLike object or an instance of Script.
+     * @returns A Script instance.
+     *
+     * @example
+     * ```typescript
+     * const script = Script.from({
+     *   codeHash: "0x1234...",
+     *   hashType: "type",
+     *   args: "0xabcd..."
+     * });
+     * ```
+     */
+    static from(script: ScriptLike): Script;
+    /**
+     * Creates a Script instance from client and known script.
+     *
+     * @param knownScript - A KnownScript enum.
+     * @param args - Args for the script.
+     * @param client - A ScriptLike object or an instance of Script.
+     * @returns A promise that resolves to the script instance.
+     *
+     * @example
+     * ```typescript
+     * const script = await Script.fromKnownScript(
+     *   client,
+     *   KnownScript.XUdt,
+     *   args: "0xabcd..."
+     * );
+     * ```
+     */
+    static fromKnownScript(client: Client, knownScript: KnownScript, args: HexLike): Promise<Script>;
+}
+export declare const ScriptOpt: mol.Codec<ScriptLike | null | undefined, Script | undefined>;
+export declare const ScriptVec: mol.Codec<ScriptLike[], Script[]>;
+export {};
+//# sourceMappingURL=script.d.ts.map

package/dist/ckb/script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../src/ckb/script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAa,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAW,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAO3C,eAAO,MAAM,aAAa,EAAE,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,CAI1D,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AACpD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3D;;;;;;;;;;;;;;GAcG;AAEH,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,QAAQ,CAmBxD;AAED;;;;;;;;;;;GAWG;AAEH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,KAAK,CAE7D;AAED;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAE5D;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;;;;;;;;;;;;;AACF;;GAEG;AACH,qBAOa,MAAO,SAAQ,WAAqC;IAStD,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,QAAQ;IAClB,IAAI,EAAE,GAAG;IAVlB;;;;;;OAMG;gBAEM,QAAQ,EAAE,GAAG,EACb,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,GAAG;IAKlB,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;;;;;;OASG;IACH,KAAK,IAAI,MAAM;IAIf;;;;;;;;;;;;;;OAcG;IAEH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAYvC;;;;;;;;;;;;;;;;OAgBG;WAEU,eAAe,CAC1B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,MAAM,CAAC;CAUnB;AAED,eAAO,MAAM,SAAS,8DAAqB,CAAC;AAC5C,eAAO,MAAM,SAAS,mCAAqB,CAAC"}

package/dist/ckb/script.js

@@ -0,0 +1,167 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var Script_1;
+import { bytesFrom } from "../bytes/index.js";
+import { hexFrom } from "../hex/index.js";
+import { mol } from "../molecule/index.js";
+import { HASH_TYPES, HASH_TYPE_TO_NUM, NUM_TO_HASH_TYPE, } from "./script.advanced.js";
+export const HashTypeCodec = mol.Codec.from({
+    byteLength: 1,
+    encode: hashTypeToBytes,
+    decode: hashTypeFromBytes,
+});
+/**
+ * Converts a HashTypeLike value to a HashType.
+ * @public
+ *
+ * @param val - The value to convert, which can be a string, number, or bigint.
+ * @returns The corresponding HashType.
+ *
+ * @throws Will throw an error if the input value is not a valid hash type.
+ *
+ * @example
+ * ```typescript
+ * const hashType = hashTypeFrom(1); // Outputs "data"
+ * const hashType = hashTypeFrom("type"); // Outputs "type"
+ * ```
+ */
+export function hashTypeFrom(val) {
+    const hashType = (() => {
+        if (typeof val === "number") {
+            return NUM_TO_HASH_TYPE[val];
+        }
+        if (typeof val === "bigint") {
+            return NUM_TO_HASH_TYPE[Number(val)];
+        }
+        if (!HASH_TYPES.includes(val)) {
+            return;
+        }
+        return val;
+    })();
+    if (hashType === undefined) {
+        throw new Error(`Invalid hash type ${val}`);
+    }
+    return hashType;
+}
+/**
+ * Converts a HashTypeLike value to its corresponding byte representation.
+ * @public
+ *
+ * @param hashType - The hash type value to convert.
+ * @returns A Uint8Array containing the byte representation of the hash type.
+ *
+ * @example
+ * ```typescript
+ * const hashTypeBytes = hashTypeToBytes("type"); // Outputs Uint8Array [0]
+ * ```
+ */
+export function hashTypeToBytes(hashType) {
+    return bytesFrom([HASH_TYPE_TO_NUM[hashTypeFrom(hashType)]]);
+}
+/**
+ * Converts a byte-like value to a HashType.
+ * @public
+ *
+ * @param bytes - The byte-like value to convert.
+ * @returns The corresponding HashType.
+ *
+ * @throws Will throw an error if the input bytes do not correspond to a valid hash type.
+ *
+ * @example
+ * ```typescript
+ * const hashType = hashTypeFromBytes(new Uint8Array([0])); // Outputs "type"
+ * ```
+ */
+export function hashTypeFromBytes(bytes) {
+    return NUM_TO_HASH_TYPE[bytesFrom(bytes)[0]];
+}
+/**
+ * @public
+ */
+let Script = Script_1 = class Script extends mol.Entity.Base() {
+    /**
+     * Creates an instance of Script.
+     *
+     * @param codeHash - The code hash of the script.
+     * @param hashType - The hash type of the script.
+     * @param args - The arguments for the script.
+     */
+    constructor(codeHash, hashType, args) {
+        super();
+        this.codeHash = codeHash;
+        this.hashType = hashType;
+        this.args = args;
+    }
+    get occupiedSize() {
+        return 33 + bytesFrom(this.args).length;
+    }
+    /**
+     * Clone a script.
+     *
+     * @returns A cloned Script instance.
+     *
+     * @example
+     * ```typescript
+     * const script1 = script0.clone();
+     * ```
+     */
+    clone() {
+        return new Script_1(this.codeHash, this.hashType, this.args);
+    }
+    /**
+     * Creates a Script instance from a ScriptLike object.
+     *
+     * @param script - A ScriptLike object or an instance of Script.
+     * @returns A Script instance.
+     *
+     * @example
+     * ```typescript
+     * const script = Script.from({
+     *   codeHash: "0x1234...",
+     *   hashType: "type",
+     *   args: "0xabcd..."
+     * });
+     * ```
+     */
+    static from(script) {
+        if (script instanceof Script_1) {
+            return script;
+        }
+        return new Script_1(hexFrom(script.codeHash), hashTypeFrom(script.hashType), hexFrom(script.args));
+    }
+    /**
+     * Creates a Script instance from client and known script.
+     *
+     * @param knownScript - A KnownScript enum.
+     * @param args - Args for the script.
+     * @param client - A ScriptLike object or an instance of Script.
+     * @returns A promise that resolves to the script instance.
+     *
+     * @example
+     * ```typescript
+     * const script = await Script.fromKnownScript(
+     *   client,
+     *   KnownScript.XUdt,
+     *   args: "0xabcd..."
+     * );
+     * ```
+     */
+    static async fromKnownScript(client, knownScript, args) {
+        const script = await client.getKnownScript(knownScript);
+        return new Script_1(script.codeHash, script.hashType, hexFrom(args));
+    }
+};
+Script = Script_1 = __decorate([
+    mol.codec(mol.table({
+        codeHash: mol.Byte32,
+        hashType: HashTypeCodec,
+        args: mol.Bytes,
+    }))
+], Script);
+export { Script };
+export const ScriptOpt = mol.option(Script);
+export const ScriptVec = mol.vector(Script);

package/dist/ckb/transaction.advanced.d.ts

@@ -0,0 +1,5 @@
+import { type DepType } from "./transaction.js";
+export declare const DEP_TYPE_TO_NUM: Record<DepType, number>;
+export declare const NUM_TO_DEP_TYPE: Record<number, DepType>;
+export declare const DEP_TYPES: string[];
+//# sourceMappingURL=transaction.advanced.d.ts.map

package/dist/ckb/transaction.advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.advanced.d.ts","sourceRoot":"","sources":["../../src/ckb/transaction.advanced.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAGnD,CAAC;AACF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAGnD,CAAC;AACF,eAAO,MAAM,SAAS,EAAE,MAAM,EAAiC,CAAC"}

package/dist/ckb/transaction.advanced.js

@@ -0,0 +1,9 @@
+export const DEP_TYPE_TO_NUM = {
+    code: 0x00,
+    depGroup: 0x01,
+};
+export const NUM_TO_DEP_TYPE = {
+    0x00: "code",
+    0x01: "depGroup",
+};
+export const DEP_TYPES = Object.keys(DEP_TYPE_TO_NUM);