@ckb-ccc/spore 0.1.0-alpha.2

package/dist/predefined/testnet.advanced.js

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

package/dist/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/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/predefined/types.js

@@ -0,0 +1,18 @@
+import { ccc } from "@ckb-ccc/core";
+export const DEFAULT_COBUILD_INFO_HASH = ccc.hashCkb(ccc.bytesFrom("CCC_DEFAULT_COBUILD_INFO", "utf8"));
+export var SporeVersion;
+(function (SporeVersion) {
+    SporeVersion["V1"] = "V1";
+    SporeVersion["V2"] = "V2";
+    SporeVersion["DID"] = "DID";
+})(SporeVersion || (SporeVersion = {}));
+export const SPORE_VERSION_DEFAULT = SporeVersion.V2;
+export class SporeScriptInfo extends ccc.ScriptInfo {
+    constructor(codeHash, hashType, cellDeps, cobuild) {
+        super(codeHash, hashType, cellDeps);
+        this.cobuild = cobuild;
+    }
+    static from(scriptInfoLike) {
+        return new SporeScriptInfo(ccc.hexFrom(scriptInfoLike.codeHash), ccc.hashTypeFrom(scriptInfoLike.hashType), scriptInfoLike.cellDeps.map((c) => ccc.CellDepInfo.from(c)), scriptInfoLike.cobuild);
+    }
+}

package/dist/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/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/predefined/utils.js

@@ -0,0 +1,26 @@
+import { SCRIPTS_CLUSTER_MAINNET, SCRIPTS_CLUSTER_TESTNET, SCRIPTS_SPORE_MAINNET, SCRIPTS_SPORE_TESTNET, } from "./advanced.js";
+import { SPORE_VERSION_DEFAULT, SporeScriptInfo, } from "./types.js";
+export function getSporeScriptInfos(client) {
+    return client.addressPrefix === "ckb"
+        ? SCRIPTS_SPORE_MAINNET
+        : SCRIPTS_SPORE_TESTNET;
+}
+export function getClusterScriptInfos(client) {
+    return client.addressPrefix === "ckb"
+        ? SCRIPTS_CLUSTER_MAINNET
+        : SCRIPTS_CLUSTER_TESTNET;
+}
+export function getSporeScriptInfo(client, version) {
+    const scriptInfo = getSporeScriptInfos(client)[version ?? SPORE_VERSION_DEFAULT];
+    if (!scriptInfo) {
+        throw new Error(`Spore script info not found of for version ${version} on ${client.addressPrefix}`);
+    }
+    return SporeScriptInfo.from(scriptInfo);
+}
+export function getClusterScriptInfo(client, version) {
+    const scriptInfo = getClusterScriptInfos(client)[version ?? SPORE_VERSION_DEFAULT];
+    if (!scriptInfo) {
+        throw new Error(`Cluster script info not found of for version ${version} on ${client.addressPrefix}`);
+    }
+    return SporeScriptInfo.from(scriptInfo);
+}

package/dist/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/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/spore/advanced.js

@@ -0,0 +1,62 @@
+import { ccc } from "@ckb-ccc/core";
+import { assembleTransferClusterAction } from "../advanced.js";
+import { assertCluster } from "../cluster/index.js";
+import { searchOneCellBySigner } from "../helper/index.js";
+export 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 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 searchOneCellBySigner(signer);
+                if (!proxy) {
+                    throw new Error("Cluster lock proxy cell not found");
+                }
+                tx.inputs.push(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(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 assembleTransferClusterAction(cluster.cellOutput, cluster.cellOutput, scriptInfoHash);
+            }
+            return;
+        }
+    }
+}

package/dist/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/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/spore/index.js

@@ -0,0 +1,135 @@
+import { ccc } from "@ckb-ccc/core";
+import { assembleCreateSporeAction, assembleMeltSporeAction, assembleTransferSporeAction, prepareSporeTransaction, } from "../advanced.js";
+import { packRawSporeData } from "../codec/index.js";
+import { findSingletonCellByArgs, injectOneCapacityCell, } from "../helper/index.js";
+import { getSporeScriptInfo, getSporeScriptInfos, } from "../predefined/index.js";
+import { prepareCluster } from "./advanced.js";
+export async function findSpore(client, args, scripts) {
+    return findSingletonCellByArgs(client, args, scripts ?? Object.values(getSporeScriptInfos(client)));
+}
+export async function assertSpore(client, args, scripts) {
+    const res = await findSpore(client, args, scripts);
+    if (!res) {
+        throw new Error(`Spore ${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
+ */
+export async function createSpore(params) {
+    const { signer, data, to, clusterMode, scriptInfoHash } = params;
+    const scriptInfo = params.scriptInfo ?? getSporeScriptInfo(signer.client);
+    // prepare transaction
+    const actions = [];
+    const ids = [];
+    const tx = ccc.Transaction.from(params.tx ?? {});
+    if (tx.inputs.length === 0) {
+        await injectOneCapacityCell(signer, tx);
+    }
+    const { script: lock } = await signer.getRecommendedAddressObj();
+    // build spore cell
+    const id = ccc.hashTypeId(tx.inputs[0], tx.outputs.length);
+    ids.push(id);
+    const packedData = 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 = assembleCreateSporeAction(output, packedData, scriptInfoHash);
+        actions.push(createAction);
+    }
+    // complete cellDeps
+    await tx.addCellDepInfos(signer.client, scriptInfo.cellDeps);
+    const action = await prepareCluster(signer, tx, data, clusterMode);
+    if (action) {
+        actions.push(action);
+    }
+    return {
+        tx: await 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
+ */
+export async function transferSpore(params) {
+    const { signer, id, to, scriptInfoHash } = params;
+    // prepare transaction
+    const tx = ccc.Transaction.from(params.tx ?? {});
+    const { cell: sporeCell, scriptInfo } = await assertSpore(signer.client, id);
+    await tx.addCellDepInfos(signer.client, scriptInfo.cellDeps);
+    tx.inputs.push(ccc.CellInput.from({
+        previousOutput: sporeCell.outPoint,
+        ...sporeCell,
+    }));
+    tx.addOutput({
+        lock: to,
+        type: sporeCell.cellOutput.type,
+    }, sporeCell.outputData);
+    const actions = scriptInfo.cobuild
+        ? [
+            assembleTransferSporeAction(sporeCell.cellOutput, tx.outputs[tx.outputs.length - 1], scriptInfoHash),
+        ]
+        : [];
+    return {
+        tx: await 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
+ */
+export async function meltSpore(params) {
+    const { signer, id, scriptInfoHash } = params;
+    // prepare transaction
+    const tx = 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(ccc.CellInput.from({
+        previousOutput: sporeCell.outPoint,
+        ...sporeCell,
+    }));
+    const actions = scriptInfo.cobuild
+        ? [assembleMeltSporeAction(sporeCell.cellOutput, scriptInfoHash)]
+        : [];
+    return {
+        tx: await prepareSporeTransaction(signer, tx, actions),
+    };
+}

package/dist.commonjs/advanced.d.ts

@@ -0,0 +1,5 @@
+export * from "./cobuild/index.js";
+export * from "./codec/index.js";
+export * from "./predefined/advanced.js";
+export * from "./spore/advanced.js";
+//# sourceMappingURL=advanced.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../src/advanced.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}

package/dist.commonjs/advanced.js

@@ -0,0 +1,20 @@
+"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("./cobuild/index.js"), exports);
+__exportStar(require("./codec/index.js"), exports);
+__exportStar(require("./predefined/advanced.js"), exports);
+__exportStar(require("./spore/advanced.js"), exports);

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

@@ -0,0 +1,56 @@
+import { ccc } from "@ckb-ccc/core";
+import { ClusterData } from "../codec/index.js";
+import { SporeScriptInfo, SporeScriptInfoLike } from "../predefined/index.js";
+export declare function findCluster(client: ccc.Client, args: ccc.HexLike, scripts?: SporeScriptInfoLike[]): Promise<{
+    cell: ccc.Cell;
+    scriptInfo: SporeScriptInfo;
+} | undefined>;
+export declare function assertCluster(client: ccc.Client, args: ccc.HexLike, scripts?: SporeScriptInfoLike[]): Promise<{
+    cell: ccc.Cell;
+    scriptInfo: SporeScriptInfo;
+}>;
+/**
+ * Create a new Cluster cell
+ *
+ * @param signer who takes the responsibility to balance and sign the transaction
+ * @param data specific format of data required by Cluster protocol
+ * @param to the owner of the Cluster cell, which will be replaced with signer if not provided
+ * @param tx the transaction skeleton, if not provided, a new one will be created
+ * @param scriptInfo the script info of new cluster, default spore version if undefined
+ * @param scriptInfoHash the script info hash used in cobuild
+ * @returns
+ *  - **tx**: a new transaction that contains created Cluster cell
+ *  - **id**: the id of the created Cluster cell
+ */
+export declare function createSporeCluster(params: {
+    signer: ccc.Signer;
+    data: ClusterData;
+    to?: ccc.ScriptLike;
+    tx?: ccc.TransactionLike;
+    scriptInfo?: SporeScriptInfoLike;
+    scriptInfoHash?: ccc.HexLike;
+}): Promise<{
+    tx: ccc.Transaction;
+    id: ccc.Hex;
+}>;
+/**
+ * Transfer a Cluster cell
+ *
+ * @param signer who takes the responsibility to balance and sign the transaction
+ * @param id the id of the Cluster cell to be transferred
+ * @param to the new owner of the Cluster cell
+ * @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 Cluster cell
+ */
+export declare function transferSporeCluster(params: {
+    signer: ccc.Signer;
+    id: ccc.HexLike;
+    to: ccc.ScriptLike;
+    tx?: ccc.TransactionLike;
+    scriptInfoHash?: ccc.HexLike;
+}): Promise<{
+    tx: ccc.Transaction;
+}>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cluster/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAMpC,OAAO,EAAE,WAAW,EAAsB,MAAM,mBAAmB,CAAC;AAKpE,OAAO,EACL,eAAe,EACf,mBAAmB,EAGpB,MAAM,wBAAwB,CAAC;AAEhC,wBAAsB,WAAW,CAC/B,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,aAAa,CACjC,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;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC;IACpB,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,CA0CD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,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,CAwCD"}

package/dist.commonjs/cluster/index.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findCluster = findCluster;
+exports.assertCluster = assertCluster;
+exports.createSporeCluster = createSporeCluster;
+exports.transferSporeCluster = transferSporeCluster;
+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");
+async function findCluster(client, args, scripts) {
+    return (0, index_js_2.findSingletonCellByArgs)(client, args, scripts ?? Object.values((0, index_js_3.getClusterScriptInfos)(client)));
+}
+async function assertCluster(client, args, scripts) {
+    const res = await findCluster(client, args, scripts);
+    if (!res) {
+        throw new Error(`Cluster ${core_1.ccc.hexFrom(args)} not found`);
+    }
+    return res;
+}
+/**
+ * Create a new Cluster cell
+ *
+ * @param signer who takes the responsibility to balance and sign the transaction
+ * @param data specific format of data required by Cluster protocol
+ * @param to the owner of the Cluster cell, which will be replaced with signer if not provided
+ * @param tx the transaction skeleton, if not provided, a new one will be created
+ * @param scriptInfo the script info of new cluster, default spore version if undefined
+ * @param scriptInfoHash the script info hash used in cobuild
+ * @returns
+ *  - **tx**: a new transaction that contains created Cluster cell
+ *  - **id**: the id of the created Cluster cell
+ */
+async function createSporeCluster(params) {
+    const { signer, data, to, scriptInfoHash } = params;
+    const scriptInfo = params.scriptInfo ?? (0, index_js_3.getClusterScriptInfo)(signer.client);
+    // prepare transaction
+    const tx = core_1.ccc.Transaction.from(params.tx ?? {});
+    if (tx.inputs.length === 0) {
+        await (0, index_js_2.injectOneCapacityCell)(signer, tx);
+    }
+    // build cluster cell
+    const id = core_1.ccc.hashTypeId(tx.inputs[0], tx.outputs.length);
+    const packedClusterData = (0, index_js_1.packRawClusterData)(data);
+    tx.addOutput({
+        lock: to ?? (await signer.getRecommendedAddressObj()).script,
+        type: {
+            ...scriptInfo,
+            args: id,
+        },
+    }, packedClusterData);
+    // complete cellDeps
+    await tx.addCellDepInfos(signer.client, scriptInfo.cellDeps);
+    // generate cobuild action
+    const actions = scriptInfo.cobuild
+        ? [
+            (0, advanced_js_1.assembleCreateClusterAction)(tx.outputs[tx.outputs.length - 1], packedClusterData, scriptInfoHash),
+        ]
+        : [];
+    return {
+        tx: await (0, advanced_js_1.prepareSporeTransaction)(signer, tx, actions),
+        id,
+    };
+}
+/**
+ * Transfer a Cluster cell
+ *
+ * @param signer who takes the responsibility to balance and sign the transaction
+ * @param id the id of the Cluster cell to be transferred
+ * @param to the new owner of the Cluster cell
+ * @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 Cluster cell
+ */
+async function transferSporeCluster(params) {
+    const { signer, id, to, scriptInfoHash } = params;
+    // prepare transaction
+    const tx = core_1.ccc.Transaction.from(params.tx ?? {});
+    // build cluster cell
+    const { cell: cluster, scriptInfo } = await assertCluster(signer.client, id);
+    tx.inputs.push(core_1.ccc.CellInput.from({
+        previousOutput: cluster.outPoint,
+        ...cluster,
+    }));
+    tx.addOutput({
+        lock: to,
+        type: cluster.cellOutput.type,
+    }, cluster.outputData);
+    // complete cellDeps
+    await tx.addCellDepInfos(signer.client, scriptInfo.cellDeps);
+    // generate cobuild action
+    const actions = scriptInfo.cobuild
+        ? [
+            (0, advanced_js_1.assembleTransferClusterAction)(cluster.cellOutput, tx.outputs[tx.outputs.length - 1], scriptInfoHash),
+        ]
+        : [];
+    return {
+        tx: await (0, advanced_js_1.prepareSporeTransaction)(signer, tx, actions),
+    };
+}