feat: SSRI & UDT SDK

.changeset/large-points-obey.md

@@ -0,0 +1,7 @@
+---
+"@ckb-ccc/spore": minor
+"@ckb-ccc/shell": minor
+"@ckb-ccc/ccc": minor
+---
+
+feat: export backend packages in @ckb-ccc/shell

.changeset/swift-stingrays-remain.md

@@ -0,0 +1,7 @@
+---
+"@ckb-ccc/core": minor
+"@ckb-ccc/ssri": minor
+"@ckb-ccc/udt": minor
+---
+
+feat: SSRI & UDT SDK

README.md

@@ -48,7 +48,7 @@ For non-developers, you can [try CCC's app now here](https://app.ckbccc.com/) ([
 
 - [Sign and verify any message.](<https://github.com/ckb-devrel/ccc/tree/master/packages/demo/src/app/connected/(tools)/Sign/page.tsx>) ([Playground](https://live.ckbccc.com/?src=https://raw.githubusercontent.com/ckb-devrel/ccc/refs/heads/master/packages/examples/src/sign.ts))
 - [Transfer native CKB token.](<https://github.com/ckb-devrel/ccc/tree/master/packages/demo/src/app/connected/(tools)/Transfer/page.tsx>) ([Playground](https://live.ckbccc.com/?src=https://raw.githubusercontent.com/ckb-devrel/ccc/refs/heads/master/packages/examples/src/transfer.ts))
-- [Transfer xUDT token.](<https://github.com/ckb-devrel/ccc/tree/master/packages/demo/src/app/connected/(tools)/TransferXUdt/page.tsx>) ([Playground](https://live.ckbccc.com/?src=https://raw.githubusercontent.com/ckb-devrel/ccc/refs/heads/master/packages/examples/src/transferUdt.ts))
+- [Transfer UDT token.](<https://github.com/ckb-devrel/ccc/tree/master/packages/demo/src/app/connected/(tools)/TransferUdt/page.tsx>) ([Playground](https://live.ckbccc.com/?src=https://raw.githubusercontent.com/ckb-devrel/ccc/refs/heads/master/packages/examples/src/transferUdt.ts))
 - See [Misc: Single-Use-Seals](https://talk.nervos.org/t/en-cn-misc-single-use-seals/8279) to learn how token issuing works in the cell model.
   - [Issue xUDT token with the Single-Use Lock.](<https://github.com/ckb-devrel/ccc/tree/master/packages/demo/src/app/connected/(tools)/IssueXUdtSus/page.tsx>)
   - [Issue xUDT token controlled by a Type ID cell.](<https://github.com/ckb-devrel/ccc/tree/master/packages/demo/src/app/connected/(tools)/IssueXUdtTypeId/page.tsx>)
@@ -131,7 +131,7 @@ Follow the prompts to select your preferred framework template and start buildin
 
 We design CCC for both front-end and back-end developers. You need only one package to fulfil all your needs:
 
-- [NodeJS](https://www.npmjs.com/package/@ckb-ccc/core): `npm install @ckb-ccc/core`
+- [NodeJS](https://www.npmjs.com/package/@ckb-ccc/shell): `npm install @ckb-ccc/shell`
 - [Custom UI](https://www.npmjs.com/package/@ckb-ccc/ccc): `npm install @ckb-ccc/ccc`
 - [Web Component](https://www.npmjs.com/package/@ckb-ccc/connector): `npm install @ckb-ccc/connector`
 - [React](https://www.npmjs.com/package/@ckb-ccc/connector-react) ([Docs](https://docs.ckbccc.com/modules/_ckb_ccc_connector_react.html)): `npm install @ckb-ccc/connector-react`

packages/ccc/package.json

@@ -56,7 +56,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@ckb-ccc/core": "workspace:*",
+    "@ckb-ccc/shell": "workspace:*",
     "@ckb-ccc/eip6963": "workspace:*",
     "@ckb-ccc/joy-id": "workspace:*",
     "@ckb-ccc/nip07": "workspace:*",

packages/ccc/src/advancedBarrel.ts

@@ -1,7 +1,7 @@
-export * from "@ckb-ccc/core/advancedBarrel";
 export * from "@ckb-ccc/eip6963/advanced";
 export * from "@ckb-ccc/nip07/advanced";
 export * from "@ckb-ccc/okx/advanced";
+export * from "@ckb-ccc/shell/advancedBarrel";
 export * from "@ckb-ccc/uni-sat/advanced";
 export * from "@ckb-ccc/utxo-global/advanced";
 export * from "@ckb-ccc/xverse/advanced";

packages/ccc/src/barrel.ts

@@ -1,9 +1,9 @@
-export * from "@ckb-ccc/core/barrel";
 export * from "@ckb-ccc/eip6963";
 export * from "@ckb-ccc/joy-id";
 export * from "@ckb-ccc/nip07";
 export * from "@ckb-ccc/okx";
 export * from "@ckb-ccc/rei";
+export * from "@ckb-ccc/shell/barrel";
 export * from "@ckb-ccc/uni-sat";
 export * from "@ckb-ccc/utxo-global";
 export * from "@ckb-ccc/xverse";

packages/ccc/src/signersController.ts

@@ -1,9 +1,9 @@
-import { ccc } from "@ckb-ccc/core";
 import { Eip6963 } from "@ckb-ccc/eip6963";
 import { JoyId } from "@ckb-ccc/joy-id";
 import { Nip07 } from "@ckb-ccc/nip07";
 import { Okx } from "@ckb-ccc/okx";
 import { Rei } from "@ckb-ccc/rei";
+import { ccc } from "@ckb-ccc/shell";
 import { UniSat } from "@ckb-ccc/uni-sat";
 import { UtxoGlobal } from "@ckb-ccc/utxo-global";
 import { Xverse } from "@ckb-ccc/xverse";

packages/core/src/ckb/transaction.ts

@@ -1487,8 +1487,13 @@ export class Transaction extends mol.Entity.Base<
     return addedCount;
   }
 
-  async completeInputsByUdt(from: Signer, type: ScriptLike): Promise<number> {
-    const exceptedBalance = this.getOutputsUdtBalance(type);
+  async completeInputsByUdt(
+    from: Signer,
+    type: ScriptLike,
+    balanceTweak?: NumLike,
+  ): Promise<number> {
+    const exceptedBalance =
+      this.getOutputsUdtBalance(type) + numFrom(balanceTweak ?? 0);
     const inputsBalance = await this.getInputsUdtBalance(from.client, type);
     if (inputsBalance >= exceptedBalance) {
       return 0;

packages/core/src/jsonRpc/requestor.ts

@@ -102,7 +102,10 @@ export class RequestorJsonRpc {
         outTransformer,
       );
     } catch (err: unknown) {
-      await this.onError?.(err);
+      if (!this.onError) {
+        throw err;
+      }
+      await this.onError(err);
     }
   }
 

packages/demo/package.json

@@ -24,6 +24,7 @@
   "devDependencies": {
     "@ckb-ccc/connector-react": "workspace:*",
     "@ckb-ccc/lumos-patches": "workspace:*",
+    "@ckb-ccc/udt": "workspace:*",
     "@ckb-lumos/ckb-indexer": "^0.24.0-next.1",
     "@ckb-lumos/common-scripts": "^0.24.0-next.1",
     "@ckb-lumos/config-manager": "^0.24.0-next.1",

packages/demo/src/app/connected/(tools)/TransferUdt/page.tsx

@@ -0,0 +1,121 @@
+"use client";
+
+import React, { useEffect, useState } from "react";
+import { TextInput } from "@/src/components/Input";
+import { Button } from "@/src/components/Button";
+import { ccc } from "@ckb-ccc/connector-react";
+import { Textarea } from "@/src/components/Textarea";
+import { useGetExplorerLink } from "@/src/utils";
+import { useApp } from "@/src/context";
+import { ButtonsPanel } from "@/src/components/ButtonsPanel";
+
+export default function TransferUdt() {
+  const { client } = ccc.useCcc();
+  const { signer, createSender } = useApp();
+  const { log } = createSender("Transfer xUDT");
+
+  const { explorerTransaction } = useGetExplorerLink();
+
+  const [udtTxHash, setUdtTxHash] = useState<string>("");
+  const [udtIndex, setUdtIndex] = useState<string>("");
+  const [udtCodeHash, setUdtCodeHash] = useState<string>("");
+  const [udtHashType, setUdtHashType] = useState<string>("");
+  const [udtArgs, setUdtArgs] = useState<string>("");
+  const [transferTo, setTransferTo] = useState<string>("");
+  const [amount, setAmount] = useState<string>("");
+
+  useEffect(() => {
+    (async () => {
+      const script = await client.getKnownScript(ccc.KnownScript.XUdt);
+      setUdtCodeHash(script.codeHash);
+      setUdtHashType(script.hashType);
+      setUdtTxHash(script.cellDeps[0].cellDep.outPoint.txHash);
+      setUdtIndex(script.cellDeps[0].cellDep.outPoint.index.toString());
+    })();
+  }, [client]);
+
+  return (
+    <div className="flex w-full flex-col items-stretch">
+      <Textarea
+        label="Address"
+        placeholder="Addresses to transfer to, separated by lines"
+        state={[transferTo, setTransferTo]}
+      />
+      <TextInput
+        label="Amount"
+        placeholder="Amount to transfer for each"
+        state={[amount, setAmount]}
+      />
+      <TextInput
+        label="Args"
+        placeholder="UDT args to transfer"
+        state={[udtArgs, setUdtArgs]}
+      />
+      <TextInput
+        label="Code Hash"
+        placeholder="UDT args to transfer"
+        state={[udtCodeHash, setUdtCodeHash]}
+      />
+      <TextInput
+        label="Hash Type"
+        placeholder="UDT hash type to transfer"
+        state={[udtHashType, setUdtHashType]}
+      />
+      <TextInput
+        label="Script Code Tx Hash"
+        placeholder="Tx hash of the script code"
+        state={[udtTxHash, setUdtTxHash]}
+      />
+      <TextInput
+        label="Script Code index"
+        placeholder="Index of the script code"
+        state={[udtIndex, setUdtIndex]}
+      />
+      <ButtonsPanel>
+        <Button
+          className="self-center"
+          onClick={async () => {
+            if (!signer) {
+              return;
+            }
+            const toAddresses = await Promise.all(
+              transferTo
+                .split("\n")
+                .map((addr) => ccc.Address.fromString(addr, signer.client)),
+            );
+            const udt = new ccc.udt.Udt(
+              {
+                txHash: udtTxHash,
+                index: udtIndex,
+              },
+              {
+                codeHash: udtCodeHash,
+                hashType: udtHashType,
+                args: udtArgs,
+              },
+            );
+
+            const { res: tx } = await udt.transfer(
+              signer,
+              toAddresses.map(({ script }) => ({
+                to: script,
+                amount: amount,
+              })),
+            );
+            const completedTx = await udt.completeBy(tx, signer);
+            await completedTx.completeInputsByCapacity(signer);
+            await completedTx.completeFeeBy(signer);
+
+            // Sign and send the transaction
+            const txHash = await signer.sendTransaction(completedTx);
+            log("Transaction sent:", explorerTransaction(txHash));
+            await signer.client.waitTransaction(txHash);
+            log("Transaction committed:", explorerTransaction(txHash));
+          }}
+        >
+          Transfer
+        </Button>
+      </ButtonsPanel>
+    </div>
+  );
+}

packages/demo/src/app/connected/page.tsx

@@ -22,7 +22,7 @@ const TABS: [ReactNode, string, keyof typeof icons, string][] = [
     "Clock",
     "text-amber-500",
   ],
-  ["Transfer xUDT", "/connected/TransferXUdt", "BadgeCent", "text-emerald-500"],
+  ["Transfer UDT", "/connected/TransferUdt", "BadgeCent", "text-emerald-500"],
   ["Issue xUDT (SUS)", "/connected/IssueXUdtSus", "Rss", "text-sky-500"],
   [
     <div className="flex flex-col">