@ckb-ccc/spore 0.1.0-alpha.2

package/dist.commonjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist.commonjs/predefined/advanced.d.ts

@@ -0,0 +1,3 @@
+export * from "./mainnet.advanced.js";
+export * from "./testnet.advanced.js";
+//# sourceMappingURL=advanced.d.ts.map

package/dist.commonjs/predefined/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../src/predefined/advanced.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist.commonjs/predefined/advanced.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./mainnet.advanced.js"), exports);
+__exportStar(require("./testnet.advanced.js"), exports);

package/dist.commonjs/predefined/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist.commonjs/predefined/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/predefined/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist.commonjs/predefined/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./utils.js"), exports);

package/dist.commonjs/predefined/mainnet.advanced.d.ts

@@ -0,0 +1,4 @@
+import { SporeScriptInfoLike, SporeVersion } from "./types.js";
+export declare const SCRIPTS_SPORE_MAINNET: Record<SporeVersion, SporeScriptInfoLike | undefined>;
+export declare const SCRIPTS_CLUSTER_MAINNET: Record<SporeVersion, SporeScriptInfoLike | undefined>;
+//# sourceMappingURL=mainnet.advanced.d.ts.map

package/dist.commonjs/predefined/mainnet.advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mainnet.advanced.d.ts","sourceRoot":"","sources":["../../src/predefined/mainnet.advanced.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/D,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,YAAY,EACZ,mBAAmB,GAAG,SAAS,CA6C/B,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAC1C,YAAY,EACZ,mBAAmB,GAAG,SAAS,CAsB/B,CAAC"}

package/dist.commonjs/predefined/mainnet.advanced.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCRIPTS_CLUSTER_MAINNET = exports.SCRIPTS_SPORE_MAINNET = void 0;
+const types_js_1 = require("./types.js");
+exports.SCRIPTS_SPORE_MAINNET = Object.freeze({
+    [types_js_1.SporeVersion.DID]: {
+        codeHash: "0xcfba73b58b6f30e70caed8a999748781b164ef9a1e218424a6fb55ebf641cb33",
+        hashType: "type",
+        cellDeps: [
+            {
+                cellDep: {
+                    outPoint: {
+                        txHash: "0x37c80ba8124780920bc8fe06b49e3535b43ca339bb9a97fb462b16d575bfa9a6",
+                        index: 0,
+                    },
+                    depType: "code",
+                },
+                type: {
+                    codeHash: "0x00000000000000000000000000000000000000000000000000545950455f4944",
+                    hashType: "type",
+                    args: "0x62312cd846659e188b05da11dc3f080b083c27371ea701d6026e11e713e0e3de",
+                },
+            },
+        ],
+        cobuild: true,
+    },
+    [types_js_1.SporeVersion.V2]: {
+        codeHash: "0x4a4dce1df3dffff7f8b2cd7dff7303df3b6150c9788cb75dcf6747247132b9f5",
+        hashType: "data1",
+        cellDeps: [
+            {
+                cellDep: {
+                    outPoint: {
+                        txHash: "0x96b198fb5ddbd1eed57ed667068f1f1e55d07907b4c0dbd38675a69ea1b69824",
+                        index: 0,
+                    },
+                    depType: "code",
+                },
+            },
+        ],
+        cobuild: true,
+    },
+    [types_js_1.SporeVersion.V1]: undefined,
+});
+exports.SCRIPTS_CLUSTER_MAINNET = Object.freeze({
+    [types_js_1.SporeVersion.V2]: {
+        codeHash: "0x7366a61534fa7c7e6225ecc0d828ea3b5366adec2b58206f2ee84995fe030075",
+        hashType: "data1",
+        cellDeps: [
+            {
+                cellDep: {
+                    outPoint: {
+                        txHash: "0xe464b7fb9311c5e2820e61c99afc615d6b98bdefbe318c34868c010cbd0dc938",
+                        index: 0,
+                    },
+                    depType: "code",
+                },
+            },
+        ],
+        cobuild: true,
+    },
+    [types_js_1.SporeVersion.V1]: undefined,
+    [types_js_1.SporeVersion.DID]: undefined,
+});

package/dist.commonjs/predefined/testnet.advanced.d.ts

@@ -0,0 +1,4 @@
+import { SporeScriptInfoLike, SporeVersion } from "./types.js";
+export declare const SCRIPTS_SPORE_TESTNET: Record<SporeVersion, SporeScriptInfoLike | undefined>;
+export declare const SCRIPTS_CLUSTER_TESTNET: Record<SporeVersion, SporeScriptInfoLike | undefined>;
+//# sourceMappingURL=testnet.advanced.d.ts.map

package/dist.commonjs/predefined/testnet.advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testnet.advanced.d.ts","sourceRoot":"","sources":["../../src/predefined/testnet.advanced.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/D,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,YAAY,EACZ,mBAAmB,GAAG,SAAS,CA4D/B,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAC1C,YAAY,EACZ,mBAAmB,GAAG,SAAS,CAsC/B,CAAC"}

package/dist.commonjs/predefined/testnet.advanced.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCRIPTS_CLUSTER_TESTNET = exports.SCRIPTS_SPORE_TESTNET = void 0;
+const types_js_1 = require("./types.js");
+exports.SCRIPTS_SPORE_TESTNET = Object.freeze({
+    [types_js_1.SporeVersion.DID]: {
+        codeHash: "0x0b1f412fbae26853ff7d082d422c2bdd9e2ff94ee8aaec11240a5b34cc6e890f",
+        hashType: "type",
+        cellDeps: [
+            {
+                cellDep: {
+                    outPoint: {
+                        txHash: "0x306961e0eb04ed972c60cb89a0aed1b0ef065d96d2fc0000c62db5275e32dc6f",
+                        index: 0,
+                    },
+                    depType: "code",
+                },
+                type: {
+                    codeHash: "0x00000000000000000000000000000000000000000000000000545950455f4944",
+                    hashType: "type",
+                    args: "0x80f0d4bf6b3951911aa6b98cc609d477a8a10b903b35cfd528d098e95c36f680",
+                },
+            },
+        ],
+    },
+    [types_js_1.SporeVersion.V2]: {
+        codeHash: "0x685a60219309029d01310311dba953d67029170ca4848a4ff638e57002130a0d",
+        hashType: "data1",
+        cellDeps: [
+            {
+                cellDep: {
+                    outPoint: {
+                        txHash: "0x5e8d2a517d50fd4bb4d01737a7952a1f1d35c8afc77240695bb569cd7d9d5a1f",
+                        index: 0,
+                    },
+                    depType: "code",
+                },
+            },
+        ],
+        cobuild: true,
+    },
+    [types_js_1.SporeVersion.V1]: {
+        codeHash: "0xbbad126377d45f90a8ee120da988a2d7332c78ba8fd679aab478a19d6c133494",
+        hashType: "data1",
+        cellDeps: [
+            {
+                cellDep: {
+                    outPoint: {
+                        txHash: "0xfd694382e621f175ddf81ce91ce2ecf8bfc027d53d7d31b8438f7d26fc37fd19",
+                        index: 0,
+                    },
+                    depType: "code",
+                },
+            },
+        ],
+    },
+});
+exports.SCRIPTS_CLUSTER_TESTNET = Object.freeze({
+    [types_js_1.SporeVersion.V2]: {
+        codeHash: "0x0bbe768b519d8ea7b96d58f1182eb7e6ef96c541fbd9526975077ee09f049058",
+        hashType: "data1",
+        cellDeps: [
+            {
+                cellDep: {
+                    outPoint: {
+                        txHash: "0xcebb174d6e300e26074aea2f5dbd7f694bb4fe3de52b6dfe205e54f90164510a",
+                        index: 0,
+                    },
+                    depType: "code",
+                },
+            },
+        ],
+        cobuild: true,
+    },
+    [types_js_1.SporeVersion.V1]: {
+        codeHash: "0x598d793defef36e2eeba54a9b45130e4ca92822e1d193671f490950c3b856080",
+        hashType: "data1",
+        cellDeps: [
+            {
+                cellDep: {
+                    outPoint: {
+                        txHash: "0x49551a20dfe39231e7db49431d26c9c08ceec96a29024eef3acc936deeb2ca76",
+                        index: 0,
+                    },
+                    depType: "code",
+                },
+            },
+        ],
+    },
+    [types_js_1.SporeVersion.DID]: undefined,
+});

package/dist.commonjs/predefined/types.d.ts

@@ -0,0 +1,17 @@
+import { ccc } from "@ckb-ccc/core";
+export declare const DEFAULT_COBUILD_INFO_HASH: `0x${string}`;
+export declare enum SporeVersion {
+    V1 = "V1",
+    V2 = "V2",
+    DID = "DID"
+}
+export declare const SPORE_VERSION_DEFAULT = SporeVersion.V2;
+export type SporeScriptInfoLike = ccc.ScriptInfoLike & {
+    cobuild?: boolean;
+};
+export declare class SporeScriptInfo extends ccc.ScriptInfo {
+    cobuild?: boolean | undefined;
+    constructor(codeHash: ccc.Hex, hashType: ccc.HashType, cellDeps: ccc.CellDepInfo[], cobuild?: boolean | undefined);
+    static from(scriptInfoLike: SporeScriptInfoLike): SporeScriptInfo;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist.commonjs/predefined/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/predefined/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,eAAO,MAAM,yBAAyB,eAErC,CAAC;AAEF,oBAAY,YAAY;IACtB,EAAE,OAAO;IACT,EAAE,OAAO;IACT,GAAG,QAAQ;CACZ;AAED,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAErD,MAAM,MAAM,mBAAmB,GAAG,GAAG,CAAC,cAAc,GAAG;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,qBAAa,eAAgB,SAAQ,GAAG,CAAC,UAAU;IAKxC,OAAO,CAAC,EAAE,OAAO;gBAHxB,QAAQ,EAAE,GAAG,CAAC,GAAG,EACjB,QAAQ,EAAE,GAAG,CAAC,QAAQ,EACtB,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE,EACpB,OAAO,CAAC,EAAE,OAAO,YAAA;IAK1B,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,mBAAmB,GAAG,eAAe;CAQlE"}

package/dist.commonjs/predefined/types.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SporeScriptInfo = exports.SPORE_VERSION_DEFAULT = exports.SporeVersion = exports.DEFAULT_COBUILD_INFO_HASH = void 0;
+const core_1 = require("@ckb-ccc/core");
+exports.DEFAULT_COBUILD_INFO_HASH = core_1.ccc.hashCkb(core_1.ccc.bytesFrom("CCC_DEFAULT_COBUILD_INFO", "utf8"));
+var SporeVersion;
+(function (SporeVersion) {
+    SporeVersion["V1"] = "V1";
+    SporeVersion["V2"] = "V2";
+    SporeVersion["DID"] = "DID";
+})(SporeVersion || (exports.SporeVersion = SporeVersion = {}));
+exports.SPORE_VERSION_DEFAULT = SporeVersion.V2;
+class SporeScriptInfo extends core_1.ccc.ScriptInfo {
+    constructor(codeHash, hashType, cellDeps, cobuild) {
+        super(codeHash, hashType, cellDeps);
+        this.cobuild = cobuild;
+    }
+    static from(scriptInfoLike) {
+        return new SporeScriptInfo(core_1.ccc.hexFrom(scriptInfoLike.codeHash), core_1.ccc.hashTypeFrom(scriptInfoLike.hashType), scriptInfoLike.cellDeps.map((c) => core_1.ccc.CellDepInfo.from(c)), scriptInfoLike.cobuild);
+    }
+}
+exports.SporeScriptInfo = SporeScriptInfo;

package/dist.commonjs/predefined/utils.d.ts

@@ -0,0 +1,7 @@
+import { ccc } from "@ckb-ccc/core";
+import { SporeScriptInfo, SporeVersion } from "./types.js";
+export declare function getSporeScriptInfos(client: ccc.Client): Record<SporeVersion, import("./types.js").SporeScriptInfoLike | undefined>;
+export declare function getClusterScriptInfos(client: ccc.Client): Record<SporeVersion, import("./types.js").SporeScriptInfoLike | undefined>;
+export declare function getSporeScriptInfo(client: ccc.Client, version?: SporeVersion): SporeScriptInfo;
+export declare function getClusterScriptInfo(client: ccc.Client, version?: SporeVersion): SporeScriptInfo;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/predefined/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAOpC,OAAO,EAEL,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,8EAIrD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,8EAIvD;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,eAAe,CAWjB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,eAAe,CAWjB"}

package/dist.commonjs/predefined/utils.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSporeScriptInfos = getSporeScriptInfos;
+exports.getClusterScriptInfos = getClusterScriptInfos;
+exports.getSporeScriptInfo = getSporeScriptInfo;
+exports.getClusterScriptInfo = getClusterScriptInfo;
+const advanced_js_1 = require("./advanced.js");
+const types_js_1 = require("./types.js");
+function getSporeScriptInfos(client) {
+    return client.addressPrefix === "ckb"
+        ? advanced_js_1.SCRIPTS_SPORE_MAINNET
+        : advanced_js_1.SCRIPTS_SPORE_TESTNET;
+}
+function getClusterScriptInfos(client) {
+    return client.addressPrefix === "ckb"
+        ? advanced_js_1.SCRIPTS_CLUSTER_MAINNET
+        : advanced_js_1.SCRIPTS_CLUSTER_TESTNET;
+}
+function getSporeScriptInfo(client, version) {
+    const scriptInfo = getSporeScriptInfos(client)[version ?? types_js_1.SPORE_VERSION_DEFAULT];
+    if (!scriptInfo) {
+        throw new Error(`Spore script info not found of for version ${version} on ${client.addressPrefix}`);
+    }
+    return types_js_1.SporeScriptInfo.from(scriptInfo);
+}
+function getClusterScriptInfo(client, version) {
+    const scriptInfo = getClusterScriptInfos(client)[version ?? types_js_1.SPORE_VERSION_DEFAULT];
+    if (!scriptInfo) {
+        throw new Error(`Cluster script info not found of for version ${version} on ${client.addressPrefix}`);
+    }
+    return types_js_1.SporeScriptInfo.from(scriptInfo);
+}

package/dist.commonjs/spore/advanced.d.ts

@@ -0,0 +1,5 @@
+import { ccc } from "@ckb-ccc/core";
+import { UnpackResult } from "@ckb-lumos/codec";
+import { Action, SporeData } from "../codec/index.js";
+export declare function prepareCluster(signer: ccc.Signer, tx: ccc.Transaction, data: SporeData, clusterMode?: "lockProxy" | "clusterCell" | "skip", scriptInfoHash?: ccc.HexLike): Promise<UnpackResult<typeof Action> | undefined>;
+//# sourceMappingURL=advanced.d.ts.map

package/dist.commonjs/spore/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../src/spore/advanced.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGtD,wBAAsB,cAAc,CAClC,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,EAAE,EAAE,GAAG,CAAC,WAAW,EACnB,IAAI,EAAE,SAAS,EACf,WAAW,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,MAAM,EAClD,cAAc,CAAC,EAAE,GAAG,CAAC,OAAO,GAC3B,OAAO,CAAC,YAAY,CAAC,OAAO,MAAM,CAAC,GAAG,SAAS,CAAC,CA0ElD"}

package/dist.commonjs/spore/advanced.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareCluster = prepareCluster;
+const core_1 = require("@ckb-ccc/core");
+const advanced_js_1 = require("../advanced.js");
+const index_js_1 = require("../cluster/index.js");
+const index_js_2 = require("../helper/index.js");
+async function prepareCluster(signer, tx, data, clusterMode, scriptInfoHash) {
+    // skip if the spore is not belong to a cluster
+    if (!data.clusterId || clusterMode === "skip") {
+        return;
+    }
+    if (!clusterMode) {
+        throw Error("clusterMode is undefined but the spore has a cluster");
+    }
+    const { cell: cluster, scriptInfo } = await (0, index_js_1.assertCluster)(signer.client, data.clusterId);
+    // If this cluster has been processed, nothing will happen to the tx
+    switch (clusterMode) {
+        case "lockProxy": {
+            const lock = cluster.cellOutput.lock;
+            if (!(await tx.findInputIndexByLock(lock, signer.client))) {
+                // note: We can only search proxy of signer, if any custom logic is in need, developer should get
+                // the proxy filled in transaction before invoking `createSpore`
+                const proxy = await (0, index_js_2.searchOneCellBySigner)(signer);
+                if (!proxy) {
+                    throw new Error("Cluster lock proxy cell not found");
+                }
+                tx.inputs.push(core_1.ccc.CellInput.from({
+                    previousOutput: proxy.outPoint,
+                    ...proxy,
+                }));
+            }
+            if (tx.outputs.every((output) => output.lock !== lock)) {
+                tx.addOutput({
+                    lock,
+                });
+            }
+            tx.addCellDeps({
+                outPoint: cluster.outPoint,
+                depType: "code",
+            });
+            return;
+        }
+        case "clusterCell": {
+            if (tx.inputs.some((i) => i.previousOutput.eq(cluster.outPoint))) {
+                return;
+            }
+            tx.inputs.push(core_1.ccc.CellInput.from({
+                previousOutput: cluster.outPoint,
+                ...cluster,
+            }));
+            tx.addOutput(cluster.cellOutput, cluster.outputData);
+            await tx.addCellDepInfos(signer.client, scriptInfo.cellDeps);
+            // note: add cluster as cellDep, which will be used in Spore contract
+            tx.addCellDeps({
+                outPoint: cluster.outPoint,
+                depType: "code",
+            });
+            if (scriptInfo.cobuild) {
+                return (0, advanced_js_1.assembleTransferClusterAction)(cluster.cellOutput, cluster.cellOutput, scriptInfoHash);
+            }
+            return;
+        }
+    }
+}

package/dist.commonjs/spore/index.d.ts

@@ -0,0 +1,80 @@
+import { ccc } from "@ckb-ccc/core";
+import { SporeData } from "../codec/index.js";
+import { SporeScriptInfo, SporeScriptInfoLike } from "../predefined/index.js";
+export declare function findSpore(client: ccc.Client, args: ccc.HexLike, scripts?: SporeScriptInfoLike[]): Promise<{
+    cell: ccc.Cell;
+    scriptInfo: SporeScriptInfo;
+} | undefined>;
+export declare function assertSpore(client: ccc.Client, args: ccc.HexLike, scripts?: SporeScriptInfoLike[]): Promise<{
+    cell: ccc.Cell;
+    scriptInfo: SporeScriptInfo;
+}>;
+/**
+ * Create one Spore cell with the specified Spore data.
+ *
+ * @param signer who takes the responsibility to balance and sign the transaction
+ * @param data specific format of data required by Spore protocol
+ * @param to owner of new spore cell, signer if no provided
+ * @param clusterMode how to process cluster cell **(if clusterId is not provided in SporeData, this parameter will be ignored)**
+ *   - undefined: error if the spore has a cluster but the clusterMode is not set
+ *   - lockProxy: put a cell that uses the same lock from Cluster cell in both Inputs and Outputs
+ *   - clusterCell: directly put Cluster cell in Inputs and Outputs
+ *   - skip: don't handle the cluster logic
+ * @param tx the transaction skeleton, if not provided, a new one will be created
+ * @param scriptInfo the script info of Spore cell, if not provided, the default script info will be used
+ * @param scriptInfoHash the script info hash used in cobuild
+ * @returns
+ *  - **tx**: a new transaction that contains created Spore cells
+ *  - **id**: the sporeId of created Spore cell
+ */
+export declare function createSpore(params: {
+    signer: ccc.Signer;
+    data: SporeData;
+    to?: ccc.ScriptLike;
+    clusterMode?: "lockProxy" | "clusterCell" | "skip";
+    tx?: ccc.TransactionLike;
+    scriptInfo?: SporeScriptInfoLike;
+    scriptInfoHash?: ccc.HexLike;
+}): Promise<{
+    tx: ccc.Transaction;
+    id: ccc.Hex;
+}>;
+/**
+ * Transfer one Spore cell
+ *
+ * @param signer who takes the responsibility to balance and sign the transaction
+ * @param id sporeId
+ * @param to Spore's new owner
+ * @param tx the transaction skeleton, if not provided, a new one will be created
+ * @param scriptInfoHash the script info hash used in cobuild
+ * @returns
+ *  - **tx**: a new transaction that contains transferred Spore cells
+ */
+export declare function transferSpore(params: {
+    signer: ccc.Signer;
+    id: ccc.HexLike;
+    to: ccc.ScriptLike;
+    tx?: ccc.TransactionLike;
+    scriptInfoHash?: ccc.HexLike;
+}): Promise<{
+    tx: ccc.Transaction;
+}>;
+/**
+ * Melt one Spore cell
+ *
+ * @param signer who takes the responsibility to balance and sign the transaction
+ * @param id sporeId to be melted
+ * @param tx the transaction skeleton, if not provided, a new one will be created
+ * @param scriptInfoHash the script info hash used in cobuild
+ * @returns
+ *  - **tx**: a new transaction that contains melted Spore cell
+ */
+export declare function meltSpore(params: {
+    signer: ccc.Signer;
+    id: ccc.HexLike;
+    tx?: ccc.TransactionLike;
+    scriptInfoHash?: ccc.HexLike;
+}): Promise<{
+    tx: ccc.Transaction;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist.commonjs/spore/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spore/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAOpC,OAAO,EAAE,SAAS,EAAoB,MAAM,mBAAmB,CAAC;AAKhE,OAAO,EACL,eAAe,EACf,mBAAmB,EAGpB,MAAM,wBAAwB,CAAC;AAGhC,wBAAsB,SAAS,CAC7B,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,IAAI,EAAE,GAAG,CAAC,OAAO,EACjB,OAAO,CAAC,EAAE,mBAAmB,EAAE,GAC9B,OAAO,CACN;IACE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC;IACf,UAAU,EAAE,eAAe,CAAC;CAC7B,GACD,SAAS,CACZ,CAMA;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,IAAI,EAAE,GAAG,CAAC,OAAO,EACjB,OAAO,CAAC,EAAE,mBAAmB,EAAE,GAC9B,OAAO,CAAC;IACT,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC;IACf,UAAU,EAAE,eAAe,CAAC;CAC7B,CAAC,CAQD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE;IACxC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,MAAM,CAAC;IACnD,EAAE,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,cAAc,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;CAC9B,GAAG,OAAO,CAAC;IACV,EAAE,EAAE,GAAG,CAAC,WAAW,CAAC;IACpB,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC;CACb,CAAC,CAqDD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;IACnB,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC;IAChB,EAAE,EAAE,GAAG,CAAC,UAAU,CAAC;IACnB,EAAE,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC;IACzB,cAAc,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;CAC9B,GAAG,OAAO,CAAC;IACV,EAAE,EAAE,GAAG,CAAC,WAAW,CAAC;CACrB,CAAC,CAmCD;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE;IACtC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;IACnB,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC;IAChB,EAAE,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC;IACzB,cAAc,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;CAC9B,GAAG,OAAO,CAAC;IACV,EAAE,EAAE,GAAG,CAAC,WAAW,CAAC;CACrB,CAAC,CAuBD"}

package/dist.commonjs/spore/index.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findSpore = findSpore;
+exports.assertSpore = assertSpore;
+exports.createSpore = createSpore;
+exports.transferSpore = transferSpore;
+exports.meltSpore = meltSpore;
+const core_1 = require("@ckb-ccc/core");
+const advanced_js_1 = require("../advanced.js");
+const index_js_1 = require("../codec/index.js");
+const index_js_2 = require("../helper/index.js");
+const index_js_3 = require("../predefined/index.js");
+const advanced_js_2 = require("./advanced.js");
+async function findSpore(client, args, scripts) {
+    return (0, index_js_2.findSingletonCellByArgs)(client, args, scripts ?? Object.values((0, index_js_3.getSporeScriptInfos)(client)));
+}
+async function assertSpore(client, args, scripts) {
+    const res = await findSpore(client, args, scripts);
+    if (!res) {
+        throw new Error(`Spore ${core_1.ccc.hexFrom(args)} not found`);
+    }
+    return res;
+}
+/**
+ * Create one Spore cell with the specified Spore data.
+ *
+ * @param signer who takes the responsibility to balance and sign the transaction
+ * @param data specific format of data required by Spore protocol
+ * @param to owner of new spore cell, signer if no provided
+ * @param clusterMode how to process cluster cell **(if clusterId is not provided in SporeData, this parameter will be ignored)**
+ *   - undefined: error if the spore has a cluster but the clusterMode is not set
+ *   - lockProxy: put a cell that uses the same lock from Cluster cell in both Inputs and Outputs
+ *   - clusterCell: directly put Cluster cell in Inputs and Outputs
+ *   - skip: don't handle the cluster logic
+ * @param tx the transaction skeleton, if not provided, a new one will be created
+ * @param scriptInfo the script info of Spore cell, if not provided, the default script info will be used
+ * @param scriptInfoHash the script info hash used in cobuild
+ * @returns
+ *  - **tx**: a new transaction that contains created Spore cells
+ *  - **id**: the sporeId of created Spore cell
+ */
+async function createSpore(params) {
+    const { signer, data, to, clusterMode, scriptInfoHash } = params;
+    const scriptInfo = params.scriptInfo ?? (0, index_js_3.getSporeScriptInfo)(signer.client);
+    // prepare transaction
+    const actions = [];
+    const ids = [];
+    const tx = core_1.ccc.Transaction.from(params.tx ?? {});
+    if (tx.inputs.length === 0) {
+        await (0, index_js_2.injectOneCapacityCell)(signer, tx);
+    }
+    const { script: lock } = await signer.getRecommendedAddressObj();
+    // build spore cell
+    const id = core_1.ccc.hashTypeId(tx.inputs[0], tx.outputs.length);
+    ids.push(id);
+    const packedData = (0, index_js_1.packRawSporeData)(data);
+    tx.addOutput({
+        lock: to ?? lock,
+        type: {
+            ...scriptInfo,
+            args: id,
+        },
+    }, packedData);
+    // create spore action
+    if (scriptInfo.cobuild) {
+        const output = tx.outputs[tx.outputs.length - 1];
+        const createAction = (0, advanced_js_1.assembleCreateSporeAction)(output, packedData, scriptInfoHash);
+        actions.push(createAction);
+    }
+    // complete cellDeps
+    await tx.addCellDepInfos(signer.client, scriptInfo.cellDeps);
+    const action = await (0, advanced_js_2.prepareCluster)(signer, tx, data, clusterMode);
+    if (action) {
+        actions.push(action);
+    }
+    return {
+        tx: await (0, advanced_js_1.prepareSporeTransaction)(signer, tx, actions),
+        id,
+    };
+}
+/**
+ * Transfer one Spore cell
+ *
+ * @param signer who takes the responsibility to balance and sign the transaction
+ * @param id sporeId
+ * @param to Spore's new owner
+ * @param tx the transaction skeleton, if not provided, a new one will be created
+ * @param scriptInfoHash the script info hash used in cobuild
+ * @returns
+ *  - **tx**: a new transaction that contains transferred Spore cells
+ */
+async function transferSpore(params) {
+    const { signer, id, to, scriptInfoHash } = params;
+    // prepare transaction
+    const tx = core_1.ccc.Transaction.from(params.tx ?? {});
+    const { cell: sporeCell, scriptInfo } = await assertSpore(signer.client, id);
+    await tx.addCellDepInfos(signer.client, scriptInfo.cellDeps);
+    tx.inputs.push(core_1.ccc.CellInput.from({
+        previousOutput: sporeCell.outPoint,
+        ...sporeCell,
+    }));
+    tx.addOutput({
+        lock: to,
+        type: sporeCell.cellOutput.type,
+    }, sporeCell.outputData);
+    const actions = scriptInfo.cobuild
+        ? [
+            (0, advanced_js_1.assembleTransferSporeAction)(sporeCell.cellOutput, tx.outputs[tx.outputs.length - 1], scriptInfoHash),
+        ]
+        : [];
+    return {
+        tx: await (0, advanced_js_1.prepareSporeTransaction)(signer, tx, actions),
+    };
+}
+/**
+ * Melt one Spore cell
+ *
+ * @param signer who takes the responsibility to balance and sign the transaction
+ * @param id sporeId to be melted
+ * @param tx the transaction skeleton, if not provided, a new one will be created
+ * @param scriptInfoHash the script info hash used in cobuild
+ * @returns
+ *  - **tx**: a new transaction that contains melted Spore cell
+ */
+async function meltSpore(params) {
+    const { signer, id, scriptInfoHash } = params;
+    // prepare transaction
+    const tx = core_1.ccc.Transaction.from(params.tx ?? {});
+    // build spore cell
+    const { cell: sporeCell, scriptInfo } = await assertSpore(signer.client, id);
+    await tx.addCellDepInfos(signer.client, scriptInfo.cellDeps);
+    tx.inputs.push(core_1.ccc.CellInput.from({
+        previousOutput: sporeCell.outPoint,
+        ...sporeCell,
+    }));
+    const actions = scriptInfo.cobuild
+        ? [(0, advanced_js_1.assembleMeltSporeAction)(sporeCell.cellOutput, scriptInfoHash)]
+        : [];
+    return {
+        tx: await (0, advanced_js_1.prepareSporeTransaction)(signer, tx, actions),
+    };
+}