@ckb-ccc/spore 0.0.0-canary-20250214032000

package/CHANGELOG.md

@@ -0,0 +1,181 @@
+# @ckb-ccc/spore
+
+## 0.0.0-canary-20250214032000
+
+### Patch Changes
+
+- [#158](https://github.com/ckb-devrel/ccc/pull/158) [`6f10589`](https://github.com/ckb-devrel/ccc/commit/6f1058977e7aa113808fa74793f1ad5d672626d2) Thanks [@Hanssen0](https://github.com/Hanssen0)! - feat(core): Transaction utils
+
+- Updated dependencies [[`80e605d`](https://github.com/ckb-devrel/ccc/commit/80e605d0645e87b4e8b5be85c63322f7a3926e38), [`def62a0`](https://github.com/ckb-devrel/ccc/commit/def62a08bf908c6a21fe91c8db2c60848a2ada52), [`d584059`](https://github.com/ckb-devrel/ccc/commit/d584059644e8bcd3a0ea8b0314fdcbb68ee66013), [`1e88ad8`](https://github.com/ckb-devrel/ccc/commit/1e88ad8743428b46b28fe790bd559b96df8a6ce4), [`6f10589`](https://github.com/ckb-devrel/ccc/commit/6f1058977e7aa113808fa74793f1ad5d672626d2), [`d7728d9`](https://github.com/ckb-devrel/ccc/commit/d7728d9edb46c9c5a2bfeb342fc68a8b1c0fec5d)]:
+  - @ckb-ccc/core@0.0.0-canary-20250214032000
+
+## 1.2.1
+
+### Patch Changes
+
+- Updated dependencies [[`28c211d`](https://github.com/ckb-devrel/ccc/commit/28c211d839a2d2305eca56e82ba7da144aa3df4a)]:
+  - @ckb-ccc/core@1.5.0
+
+## 1.2.0
+
+### Minor Changes
+
+- [#136](https://github.com/ckb-devrel/ccc/pull/136) [`a1d5626`](https://github.com/ckb-devrel/ccc/commit/a1d56266da68602495054ad6b627b998ef27f04d) Thanks [@ashuralyk](https://github.com/ashuralyk)! - feat(spore): support decoding rendered dob data from spore data and cluster data
+
+### Patch Changes
+
+- Updated dependencies [[`3fdb2c4`](https://github.com/ckb-devrel/ccc/commit/3fdb2c477d0b2766b231e436b8f396f047b02634), [`f429087`](https://github.com/ckb-devrel/ccc/commit/f4290874dfab3fe58844e5169673c5d47bda64e3)]:
+  - @ckb-ccc/core@1.4.0
+
+## 1.1.1
+
+### Patch Changes
+
+- [`5d4517e`](https://github.com/ckb-devrel/ccc/commit/5d4517e049b541b2a695db7821c4cfc2218678e0) Thanks [@sfsf332](https://github.com/sfsf332)! - refactor(spore): unified findSpore(s) interface
+
+- Updated dependencies [[`a48cccf`](https://github.com/ckb-devrel/ccc/commit/a48cccfae3ce6b3456a5eb863f207e7e5a6e568f)]:
+  - @ckb-ccc/core@1.3.1
+
+## 1.1.0
+
+### Minor Changes
+
+- [#130](https://github.com/ckb-devrel/ccc/pull/130) [`8c97c85`](https://github.com/ckb-devrel/ccc/commit/8c97c851db4a2d940c7e59116ca7620cfd0afae1) Thanks [@Hanssen0](https://github.com/Hanssen0)! - feat: export backend packages in @ckb-ccc/shell
+
+### Patch Changes
+
+- [#131](https://github.com/ckb-devrel/ccc/pull/131) [`4c76f9e`](https://github.com/ckb-devrel/ccc/commit/4c76f9e2a93a226fcfc4c32a5378bb531bfff08f) Thanks [@Hanssen0](https://github.com/Hanssen0)! - feat(core): Transaction.completeInputs(Add/AtLeast)One
+
+- Updated dependencies [[`4dbf4fd`](https://github.com/ckb-devrel/ccc/commit/4dbf4fd8021cf14d05282706a7667ea7d108fb09), [`4c76f9e`](https://github.com/ckb-devrel/ccc/commit/4c76f9e2a93a226fcfc4c32a5378bb531bfff08f), [`c2c4c26`](https://github.com/ckb-devrel/ccc/commit/c2c4c264e04461948e4b913b2f22054e6032ddc8), [`b6a73fa`](https://github.com/ckb-devrel/ccc/commit/b6a73fa9628ebdff51cb8f246309654cd53e36f2), [`8c97c85`](https://github.com/ckb-devrel/ccc/commit/8c97c851db4a2d940c7e59116ca7620cfd0afae1)]:
+  - @ckb-ccc/core@1.3.0
+
+## 1.0.8
+
+### Patch Changes
+
+- Updated dependencies [[`01263bd`](https://github.com/ckb-devrel/ccc/commit/01263bd8c601fa8fcdfa24be52601716e1864843)]:
+  - @ckb-ccc/core@1.2.3
+
+## 1.0.7
+
+### Patch Changes
+
+- [#123](https://github.com/ckb-devrel/ccc/pull/123) [`7e64eea`](https://github.com/ckb-devrel/ccc/commit/7e64eeac15268725358f74b531a3013c9189979c) Thanks [@Hanssen0](https://github.com/Hanssen0)! - fix: spore cluster lock proxy
+
+## 1.0.6
+
+### Patch Changes
+
+- Updated dependencies [[`7886e3d`](https://github.com/ckb-devrel/ccc/commit/7886e3d89e9ca8f3514a2044c6dd4e8ec6b49933)]:
+  - @ckb-ccc/core@1.2.2
+
+## 1.0.5
+
+### Patch Changes
+
+- Updated dependencies [[`94e2618`](https://github.com/ckb-devrel/ccc/commit/94e26182515e09d6086ec5b653d091f117a499e6)]:
+  - @ckb-ccc/core@1.2.1
+
+## 1.0.4
+
+### Patch Changes
+
+- Updated dependencies [[`128e87b`](https://github.com/ckb-devrel/ccc/commit/128e87b5ca3e97bfe7842e76f786aa6aec010797)]:
+  - @ckb-ccc/core@1.2.0
+
+## 1.0.3
+
+### Patch Changes
+
+- Updated dependencies [[`925991c`](https://github.com/ckb-devrel/ccc/commit/925991c8a24b1f34667e30b28b69812e936e3928)]:
+  - @ckb-ccc/core@1.1.1
+
+## 1.0.2
+
+### Patch Changes
+
+- Updated dependencies [[`ddc0a28`](https://github.com/ckb-devrel/ccc/commit/ddc0a281c3d1dfa6ebc990dae92994f026dfddcc)]:
+  - @ckb-ccc/core@1.1.0
+
+## 1.0.1
+
+### Patch Changes
+
+- [#111](https://github.com/ckb-devrel/ccc/pull/111) [`719055b`](https://github.com/ckb-devrel/ccc/commit/719055b404f31b40362f51714b9f11c85b857581) Thanks [@Hanssen0](https://github.com/Hanssen0)! - fix: call stack overflow caused by spread operator
+
+- Updated dependencies [[`719055b`](https://github.com/ckb-devrel/ccc/commit/719055b404f31b40362f51714b9f11c85b857581), [`94caaca`](https://github.com/ckb-devrel/ccc/commit/94caaca11c63752a25282d42f51161c94397dec6)]:
+  - @ckb-ccc/core@1.0.1
+
+## 1.0.0
+
+### Major Changes
+
+- [#107](https://github.com/ckb-devrel/ccc/pull/107) [`b99f55f`](https://github.com/ckb-devrel/ccc/commit/b99f55f74e64106391ce53f7d0bd0fa7522023cc) Thanks [@Hanssen0](https://github.com/Hanssen0)! - feat: molecule
+
+### Patch Changes
+
+- Updated dependencies [[`b99f55f`](https://github.com/ckb-devrel/ccc/commit/b99f55f74e64106391ce53f7d0bd0fa7522023cc)]:
+  - @ckb-ccc/core@1.0.0
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [[`c1cb910`](https://github.com/ckb-devrel/ccc/commit/c1cb91091780c7b33fbbd683ef8edc9f11452ecd)]:
+  - @ckb-ccc/core@0.1.2
+
+## 0.1.1
+
+### Patch Changes
+
+- [#101](https://github.com/ckb-devrel/ccc/pull/101) [`d9affcc`](https://github.com/ckb-devrel/ccc/commit/d9affcc01c7b839b227e4d79bcb66e717577502a) Thanks [@Hanssen0](https://github.com/Hanssen0)! - fix: commonjs
+
+- Updated dependencies [[`d9affcc`](https://github.com/ckb-devrel/ccc/commit/d9affcc01c7b839b227e4d79bcb66e717577502a)]:
+  - @ckb-ccc/core@0.1.1
+
+## 0.1.0
+
+### Minor Changes
+
+- [#74](https://github.com/ckb-devrel/ccc/pull/74) [`f21d7e4`](https://github.com/ckb-devrel/ccc/commit/f21d7e4cf422edab4a836ef6d678b620594fef8d) Thanks [@Hanssen0](https://github.com/Hanssen0)! - add spore package and some known scripts
+
+### Patch Changes
+
+- [#88](https://github.com/ckb-devrel/ccc/pull/88) [`f07a506`](https://github.com/ckb-devrel/ccc/commit/f07a506bd6fc27fe659a17d2f7baaeec54716d81) Thanks [@ashuralyk](https://github.com/ashuralyk)! - feat: molecule codec
+  feat: spore searcher
+- Updated dependencies [[`a3d5359`](https://github.com/ckb-devrel/ccc/commit/a3d53595f6dd11f2f59cdf0086b3d7ce558a2fdd), [`8824ff2`](https://github.com/ckb-devrel/ccc/commit/8824ff27af3b76186f1a7d6db8c907cd66f09d6a), [`f07a506`](https://github.com/ckb-devrel/ccc/commit/f07a506bd6fc27fe659a17d2f7baaeec54716d81), [`f21d7e4`](https://github.com/ckb-devrel/ccc/commit/f21d7e4cf422edab4a836ef6d678b620594fef8d), [`acfc050`](https://github.com/ckb-devrel/ccc/commit/acfc0502cd6beb48b9310dec8411dcd630507366), [`1720d5a`](https://github.com/ckb-devrel/ccc/commit/1720d5a398543f1c6e24763eeaf15d84cd2214bf), [`e63a06e`](https://github.com/ckb-devrel/ccc/commit/e63a06ee75ac8595208d216dec88a4228c465e23), [`c092988`](https://github.com/ckb-devrel/ccc/commit/c092988e7765b9ac79498d6bd72a6a2f62859b6f), [`50f2ce0`](https://github.com/ckb-devrel/ccc/commit/50f2ce08e74cb3fbeae926267d42e28b426fd7f4), [`4709384`](https://github.com/ckb-devrel/ccc/commit/4709384e37188991cb937b16f99f47ca82c912b8)]:
+  - @ckb-ccc/core@0.1.0
+
+## 0.1.0-alpha.5
+
+### Patch Changes
+
+- [#88](https://github.com/ckb-devrel/ccc/pull/88) [`f07a506`](https://github.com/ckb-devrel/ccc/commit/f07a506bd6fc27fe659a17d2f7baaeec54716d81) Thanks [@ashuralyk](https://github.com/ashuralyk)! - feat: molecule codec
+  feat: spore searcher
+- Updated dependencies [[`f07a506`](https://github.com/ckb-devrel/ccc/commit/f07a506bd6fc27fe659a17d2f7baaeec54716d81)]:
+  - @ckb-ccc/core@0.1.0-alpha.7
+
+## 0.1.0-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [[`4709384`](https://github.com/ckb-devrel/ccc/commit/4709384e37188991cb937b16f99f47ca82c912b8)]:
+  - @ckb-ccc/core@0.1.0-alpha.6
+
+## 0.1.0-alpha.3
+
+### Patch Changes
+
+- Updated dependencies [[`50f2ce0`](https://github.com/ckb-devrel/ccc/commit/50f2ce08e74cb3fbeae926267d42e28b426fd7f4)]:
+  - @ckb-ccc/core@0.1.0-alpha.5
+
+## 0.1.0-alpha.2
+
+### Minor Changes
+
+- [#74](https://github.com/ckb-devrel/ccc/pull/74) [`f21d7e4`](https://github.com/ckb-devrel/ccc/commit/f21d7e4cf422edab4a836ef6d678b620594fef8d) Thanks [@Hanssen0](https://github.com/Hanssen0)! - add spore package and some known scripts
+
+### Patch Changes
+
+- Updated dependencies [[`f21d7e4`](https://github.com/ckb-devrel/ccc/commit/f21d7e4cf422edab4a836ef6d678b620594fef8d)]:
+  - @ckb-ccc/core@0.1.0-alpha.4

package/README.md

@@ -0,0 +1,43 @@
+<p align="center">
+  <a href="https://app.ckbccc.com/">
+    <img alt="Logo" src="https://raw.githubusercontent.com/ckb-devrel/ccc/master/assets/logoAndText.svg" style="height: 8rem; max-width: 90%; padding: 0.5rem 0;" />
+  </a>
+</p>
+
+<h1 align="center" style="font-size: 48px;">
+  CCC's support for Spore protocol
+</h1>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@ckb-ccc/spore"><img
+    alt="NPM Version" src="https://img.shields.io/npm/v/%40ckb-ccc%2Fspore"
+  /></a>
+  <img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/ckb-devrel/ccc" />
+  <img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/ckb-devrel/ccc/master" />
+  <img alt="GitHub branch check runs" src="https://img.shields.io/github/check-runs/ckb-devrel/ccc/master" />
+  <a href="https://live.ckbccc.com/"><img
+    alt="Playground" src="https://img.shields.io/website?url=https%3A%2F%2Flive.ckbccc.com%2F&label=Playground"
+  /></a>
+  <a href="https://app.ckbccc.com/"><img
+    alt="App" src="https://img.shields.io/website?url=https%3A%2F%2Fapp.ckbccc.com%2F&label=App"
+  /></a>
+  <a href="https://docs.ckbccc.com/"><img
+    alt="Docs" src="https://img.shields.io/website?url=https%3A%2F%2Fdocs.ckbccc.com%2F&label=Docs"
+  /></a>
+</p>
+
+<p align="center">
+  CCC - CKBers' Codebase is a one-stop solution for your CKB JS/TS ecosystem development.
+  <br />
+  Empower yourself with CCC to discover the unlimited potential of CKB.
+  <br />
+  Interoperate with wallets from different chain ecosystems.
+  <br />
+  Fully enabling CKB's Turing completeness and cryptographic freedom power.
+</p>
+
+For non-developers, you can also [try CCC's app now here](https://app.ckbccc.com/). It showcases how to use CCC for some basic scenarios in CKB.
+
+<h3 align="center">
+  Read more about CCC on <a href="https://docs.ckbccc.com">our website</a> or <a href="https://github.com/ckb-devrel/ccc">GitHub Repo</a>.
+</h3>

package/dist/advanced.d.ts

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

package/dist/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../src/advanced.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAC"}

package/dist/advanced.js

@@ -0,0 +1,2 @@
+export * from "./advancedBarrel.js";
+export * as sporeA from "./advancedBarrel.js";

package/dist/advancedBarrel.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=advancedBarrel.d.ts.map

package/dist/advancedBarrel.d.ts.map

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

package/dist/advancedBarrel.js

@@ -0,0 +1,4 @@
+export * from "./cobuild/index.js";
+export * from "./codec/index.js";
+export * from "./predefined/advanced.js";
+export * from "./spore/advanced.js";

package/dist/barrel.d.ts

@@ -0,0 +1,5 @@
+export * from "./cluster/index.js";
+export * as dob from "./dob/index.js";
+export * from "./predefined/index.js";
+export * from "./spore/index.js";
+//# sourceMappingURL=barrel.d.ts.map

package/dist/barrel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barrel.d.ts","sourceRoot":"","sources":["../src/barrel.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/barrel.js

@@ -0,0 +1,4 @@
+export * from "./cluster/index.js";
+export * as dob from "./dob/index.js";
+export * from "./predefined/index.js";
+export * from "./spore/index.js";

package/dist/cluster/index.d.ts

@@ -0,0 +1,76 @@
+import { ccc } from "@ckb-ccc/core";
+import { ClusterDataView } from "../codec/index.js";
+import { SporeScriptInfo, SporeScriptInfoLike } from "../predefined/index.js";
+export declare function findCluster(client: ccc.Client, id: ccc.HexLike, scripts?: SporeScriptInfoLike[]): Promise<{
+    cell: ccc.Cell;
+    cluster: ccc.Cell;
+    clusterData: ClusterDataView;
+    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: ClusterDataView;
+    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;
+}>;
+/**
+ * Search on-chain clusters under the signer's control
+ *
+ * @param signer the owner of clusters
+ * @param order the order in creation time of clusters
+ * @param scriptInfos the deployed script infos of clusters
+ */
+export declare function findSporeClustersBySigner({ signer, order, limit, scriptInfos, }: {
+    signer: ccc.Signer;
+    order?: "asc" | "desc";
+    limit?: number;
+    scriptInfos?: SporeScriptInfoLike[];
+}): AsyncGenerator<{
+    cell: ccc.Cell;
+    cluster: ccc.Cell;
+    clusterData: ClusterDataView;
+    scriptInfo: SporeScriptInfo;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/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,EACL,eAAe,EAGhB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,eAAe,EACf,mBAAmB,EAGpB,MAAM,wBAAwB,CAAC;AAEhC,wBAAsB,WAAW,CAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,EAAE,EAAE,GAAG,CAAC,OAAO,EACf,OAAO,CAAC,EAAE,mBAAmB,EAAE,GAC9B,OAAO,CACN;IACE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC;IACf,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC;IAClB,WAAW,EAAE,eAAe,CAAC;IAC7B,UAAU,EAAE,eAAe,CAAC;CAC7B,GACD,SAAS,CACZ,CAgBA;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,eAAe,CAAC;IACtB,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,CAwCD;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,CAmCD;AAED;;;;;;GAMG;AACH,wBAAuB,yBAAyB,CAAC,EAC/C,MAAM,EACN,KAAK,EACL,KAAK,EACL,WAAW,GACZ,EAAE;IACD,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACrC,GAAG,cAAc,CAAC;IACjB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC;IACf,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC;IAClB,WAAW,EAAE,eAAe,CAAC;IAC7B,UAAU,EAAE,eAAe,CAAC;CAC7B,CAAC,CA0BD"}

package/dist/cluster/index.js

@@ -0,0 +1,128 @@
+import { ccc } from "@ckb-ccc/core";
+import { assembleCreateClusterAction, assembleTransferClusterAction, prepareSporeTransaction, } from "../advanced.js";
+import { packRawClusterData, unpackToRawClusterData, } from "../codec/index.js";
+import { findSingletonCellByArgs } from "../helper/index.js";
+import { SporeScriptInfo, getClusterScriptInfo, getClusterScriptInfos, } from "../predefined/index.js";
+export async function findCluster(client, id, scripts) {
+    const found = await findSingletonCellByArgs(client, id, scripts ?? Object.values(getClusterScriptInfos(client)));
+    if (!found) {
+        return;
+    }
+    return {
+        cell: found.cell,
+        cluster: found.cell,
+        clusterData: unpackToRawClusterData(found.cell.outputData),
+        scriptInfo: found.scriptInfo,
+    };
+}
+export async function assertCluster(client, args, scripts) {
+    const res = await findCluster(client, args, scripts);
+    if (!res) {
+        throw new Error(`Cluster ${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
+ */
+export async function createSporeCluster(params) {
+    const { signer, data, to, scriptInfoHash } = params;
+    const scriptInfo = params.scriptInfo ?? getClusterScriptInfo(signer.client);
+    // prepare transaction
+    const tx = ccc.Transaction.from(params.tx ?? {});
+    await tx.completeInputsAtLeastOne(signer);
+    // build cluster cell
+    const id = ccc.hashTypeId(tx.inputs[0], tx.outputs.length);
+    const packedClusterData = 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
+        ? [
+            assembleCreateClusterAction(tx.outputs[tx.outputs.length - 1], packedClusterData, scriptInfoHash),
+        ]
+        : [];
+    return {
+        tx: await 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
+ */
+export async function transferSporeCluster(params) {
+    const { signer, id, to, scriptInfoHash } = params;
+    // prepare transaction
+    const tx = ccc.Transaction.from(params.tx ?? {});
+    // build cluster cell
+    const { cell: cluster, scriptInfo } = await assertCluster(signer.client, id);
+    tx.addInput(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
+        ? [
+            assembleTransferClusterAction(cluster.cellOutput, tx.outputs[tx.outputs.length - 1], scriptInfoHash),
+        ]
+        : [];
+    return {
+        tx: await prepareSporeTransaction(signer, tx, actions),
+    };
+}
+/**
+ * Search on-chain clusters under the signer's control
+ *
+ * @param signer the owner of clusters
+ * @param order the order in creation time of clusters
+ * @param scriptInfos the deployed script infos of clusters
+ */
+export async function* findSporeClustersBySigner({ signer, order, limit, scriptInfos, }) {
+    for (const scriptInfo of scriptInfos ??
+        Object.values(getClusterScriptInfos(signer.client))) {
+        if (!scriptInfo) {
+            continue;
+        }
+        for await (const cluster of signer.findCells({
+            script: {
+                ...scriptInfo,
+                args: "",
+            },
+        }, true, order, limit)) {
+            yield {
+                cell: cluster,
+                cluster,
+                clusterData: unpackToRawClusterData(cluster.outputData),
+                scriptInfo: SporeScriptInfo.from(scriptInfo),
+            };
+        }
+    }
+}

package/dist/cobuild/index.d.ts

@@ -0,0 +1,12 @@
+import { ccc, mol } from "@ckb-ccc/core";
+import { Action, ActionVec, WitnessLayout } from "../codec/index.js";
+export declare function assembleCreateSporeAction(sporeOutput: ccc.CellOutputLike, sporeData: ccc.BytesLike, scriptInfoHash?: ccc.HexLike): mol.EncodableType<typeof Action>;
+export declare function assembleTransferSporeAction(sporeInput: ccc.CellOutputLike, sporeOutput: ccc.CellOutputLike, scriptInfoHash?: ccc.HexLike): mol.EncodableType<typeof Action>;
+export declare function assembleMeltSporeAction(sporeInput: ccc.CellOutputLike, scriptInfoHash?: ccc.HexLike): mol.EncodableType<typeof Action>;
+export declare function assembleCreateClusterAction(clusterOutput: ccc.CellOutputLike, clusterData: ccc.BytesLike, scriptInfoHash?: ccc.HexLike): mol.EncodableType<typeof Action>;
+export declare function assembleTransferClusterAction(clusterInput: ccc.CellOutputLike, clusterOutput: ccc.CellOutputLike, scriptInfoHash?: ccc.HexLike): mol.EncodableType<typeof Action>;
+export declare function prepareSporeTransaction(signer: ccc.Signer, txLike: ccc.TransactionLike, actions: mol.EncodableType<typeof ActionVec>): Promise<ccc.Transaction>;
+export declare function unpackCommonCobuildProof(data: ccc.HexLike): mol.EncodableType<typeof WitnessLayout> | undefined;
+export declare function extractCobuildActionsFromTx(tx: ccc.Transaction): mol.EncodableType<typeof ActionVec>;
+export declare function injectCobuild(tx: ccc.Transaction, actions: mol.EncodableType<typeof ActionVec>): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/cobuild/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cobuild/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,MAAM,EACN,SAAS,EAET,aAAa,EACd,MAAM,mBAAmB,CAAC;AAG3B,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,GAAG,CAAC,cAAc,EAC/B,SAAS,EAAE,GAAG,CAAC,SAAS,EACxB,cAAc,GAAE,GAAG,CAAC,OAAmC,GACtD,GAAG,CAAC,aAAa,CAAC,OAAO,MAAM,CAAC,CAsBlC;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,GAAG,CAAC,cAAc,EAC9B,WAAW,EAAE,GAAG,CAAC,cAAc,EAC/B,cAAc,GAAE,GAAG,CAAC,OAAmC,GACtD,GAAG,CAAC,aAAa,CAAC,OAAO,MAAM,CAAC,CA0BlC;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,GAAG,CAAC,cAAc,EAC9B,cAAc,GAAE,GAAG,CAAC,OAAmC,GACtD,GAAG,CAAC,aAAa,CAAC,OAAO,MAAM,CAAC,CAqBlC;AAED,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,GAAG,CAAC,cAAc,EACjC,WAAW,EAAE,GAAG,CAAC,SAAS,EAC1B,cAAc,GAAE,GAAG,CAAC,OAAmC,GACtD,GAAG,CAAC,aAAa,CAAC,OAAO,MAAM,CAAC,CAsBlC;AAED,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,GAAG,CAAC,cAAc,EAChC,aAAa,EAAE,GAAG,CAAC,cAAc,EACjC,cAAc,GAAE,GAAG,CAAC,OAAmC,GACtD,GAAG,CAAC,aAAa,CAAC,OAAO,MAAM,CAAC,CAyBlC;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,MAAM,EAAE,GAAG,CAAC,eAAe,EAC3B,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,OAAO,SAAS,CAAC,GAC3C,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAW1B;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,GAAG,CAAC,OAAO,GAChB,GAAG,CAAC,aAAa,CAAC,OAAO,aAAa,CAAC,GAAG,SAAS,CAMrD;AAED,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,GAAG,CAAC,WAAW,GAClB,GAAG,CAAC,aAAa,CAAC,OAAO,SAAS,CAAC,CAiBrC;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,GAAG,CAAC,WAAW,EACnB,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,OAAO,SAAS,CAAC,GAC3C,IAAI,CAaN"}