RGB++ core

.changeset/clean-chefs-roll.md

@@ -0,0 +1,6 @@
+---
+"@ckb-ccc/core": patch
+---
+
+fix(core): avoid circular dependency
+

.changeset/clean-shoes-thank.md

@@ -0,0 +1,6 @@
+---
+"@ckb-ccc/core": minor
+---
+
+feat(core): `Signer.findCellsOnChain`
+

.changeset/curvy-baboons-sip.md

@@ -0,0 +1,6 @@
+---
+"@ckb-ccc/core": minor
+---
+
+feat(core): optional `shouldAddInputs` for `Transaction.completeFee`
+

.changeset/empty-shrimps-buy.md

@@ -0,0 +1,6 @@
+---
+"@ckb-ccc/core": patch
+---
+
+perf(core): optimize Transaction.completeFee
+

.changeset/green-news-behave.md

@@ -0,0 +1,6 @@
+---
+"@ckb-ccc/core": minor
+---
+
+feat(core): auto capacity completion
+

.changeset/old-eagles-bake.md

@@ -0,0 +1,6 @@
+---
+"@ckb-ccc/core": patch
+---
+
+feat(core): default `Signer.prepareTransaction`
+

.changeset/salty-apples-check.md

@@ -0,0 +1,9 @@
+---
+"@ckb-ccc/core": minor
+"@ckb-ccc/ssri": patch
+---
+
+feat(core): add `CellAny`
+
+It's definitely a mistake to name `CellOnChain` `Cell`, but there is nothing we can do with that right now. To avoid more duplicate code, `CellAny` was added to represent a cell that's on-chain or off-chain.
+

.changeset/shiny-ants-say.md

@@ -0,0 +1,5 @@
+---
+"@ckb-ccc/core": patch
+---
+
+`hexFrom` passthru normalized hex and `numToHex` enforce hex normalization

.changeset/six-steaks-grab.md

@@ -0,0 +1,5 @@
+---
+"@ckb-ccc/core": patch
+---
+
+Simplify MapLru, while improving Complexity

.changeset/sixty-games-scream.md

@@ -0,0 +1,5 @@
+---
+"@ckb-ccc/core": major
+---
+
+fix(core)!: `getFeeRateStatistics` may returns `null` on devnet

.changeset/tangy-memes-sit.md

@@ -0,0 +1,6 @@
+---
+"@ckb-ccc/core": major
+---
+
+feat(core): `reduce` and `reduceAsync` for `Iterable`
+

.changeset/ten-ties-kiss.md

@@ -0,0 +1,6 @@
+---
+"@ckb-ccc/core": minor
+---
+
+feat(core): multiple scripts for `SignerCkbScriptReadonly`
+

.changeset/weak-otters-dance.md

@@ -0,0 +1,6 @@
+---
+"@ckb-ccc/core": patch
+---
+
+fix(core): `Transaction.clone` should clone inputs' cache
+

.changeset/wise-news-admire.md

@@ -0,0 +1,6 @@
+---
+"@ckb-ccc/core": patch
+---
+
+fix(core):  Invalid Uint64 0x00: with redundant leading zeros.
+

package.json

@@ -48,4 +48,4 @@
     ]
   },
   "packageManager": "pnpm@10.8.1"
-}
+}

packages/core/src/client/client.ts

@@ -54,13 +54,13 @@ export abstract class Client {
 
   abstract getFeeRateStatistics(
     blockRange?: NumLike,
-  ): Promise<{ mean: Num; median: Num }>;
+  ): Promise<{ mean?: Num; median?: Num }>;
   async getFeeRate(
     blockRange?: NumLike,
     options?: { maxFeeRate?: NumLike },
   ): Promise<Num> {
     const feeRate = numMax(
-      (await this.getFeeRateStatistics(blockRange)).median,
+      (await this.getFeeRateStatistics(blockRange)).median ?? Zero,
       DEFAULT_MIN_FEE_RATE,
     );
 

packages/core/src/client/clientPublicMainnet.advanced.ts

@@ -480,4 +480,72 @@ export const MAINNET_SCRIPTS: Record<KnownScript, ScriptInfoLike | undefined> =
         },
       ],
     },
+    [KnownScript.RgbppLock]: {
+      codeHash:
+        "0xbc6c568a1a0d0a09f6844dc9d74ddb4343c32143ff25f727c59edf4fb72d6936",
+      hashType: "type",
+      cellDeps: [
+        {
+          cellDep: {
+            outPoint: {
+              txHash:
+                "0xcb4d9f9726e66306bfda6359d39d3bea8b4e5345d0f95f26a3e51626ebe82a63",
+              index: 0,
+            },
+            depType: "code",
+          },
+          type: {
+            codeHash:
+              "0x00000000000000000000000000000000000000000000000000545950455f4944",
+            hashType: "type",
+            args: "0x68ad3d9e0bb9ea841a5d1fcd600137bd3f45401e759e353121f26cd0d981452f",
+          },
+        },
+        // Rgbpp lock config cell dep
+        {
+          cellDep: {
+            outPoint: {
+              txHash:
+                "0xcb4d9f9726e66306bfda6359d39d3bea8b4e5345d0f95f26a3e51626ebe82a63",
+              index: 1,
+            },
+            depType: "code",
+          },
+        },
+      ],
+    },
+    [KnownScript.BtcTimeLock]: {
+      codeHash:
+        "0x70d64497a075bd651e98ac030455ea200637ee325a12ad08aff03f1a117e5a62",
+      hashType: "type",
+      cellDeps: [
+        {
+          cellDep: {
+            outPoint: {
+              txHash:
+                "0x3d1c26b966504b09253ad84173bf3baa7b8135c5ff520c32cf70b631c1d08b9b",
+              index: 0,
+            },
+            depType: "code",
+          },
+          type: {
+            codeHash:
+              "0x00000000000000000000000000000000000000000000000000545950455f4944",
+            hashType: "type",
+            args: "0x44b8253ae18e913a2845b0d548eaf6b3ba1099ed26835888932a754194028a8a",
+          },
+        },
+        // btc time lock config cell dep
+        {
+          cellDep: {
+            outPoint: {
+              txHash:
+                "0x3d1c26b966504b09253ad84173bf3baa7b8135c5ff520c32cf70b631c1d08b9b",
+              index: 1,
+            },
+            depType: "code",
+          },
+        },
+      ],
+    },
   });

packages/core/src/client/clientPublicTestnet.advanced.ts

@@ -492,4 +492,72 @@ export const TESTNET_SCRIPTS: Record<KnownScript, ScriptInfoLike> =
         },
       ],
     },
+    [KnownScript.RgbppLock]: {
+      codeHash:
+        "0x61ca7a4796a4eb19ca4f0d065cb9b10ddcf002f10f7cbb810c706cb6bb5c3248",
+      hashType: "type",
+      cellDeps: [
+        {
+          cellDep: {
+            outPoint: {
+              txHash:
+                "0x0d1567da0979f78b297d5311442669fbd1bd853c8be324c5ab6da41e7a1ed6e5",
+              index: 0,
+            },
+            depType: "code",
+          },
+          type: {
+            codeHash:
+              "0x00000000000000000000000000000000000000000000000000545950455f4944",
+            hashType: "type",
+            args: "0xa3bc8441df149def76cfe15fec7b1e51d949548bc27fb7a75e9d4b3ef1c12c7f",
+          },
+        },
+        // Rgbpp lock config cell dep for Bitcoin Testnet3
+        {
+          cellDep: {
+            outPoint: {
+              txHash:
+                "0x0d1567da0979f78b297d5311442669fbd1bd853c8be324c5ab6da41e7a1ed6e5",
+              index: 1,
+            },
+            depType: "code",
+          },
+        },
+      ],
+    },
+    [KnownScript.BtcTimeLock]: {
+      codeHash:
+        "0x00cdf8fab0f8ac638758ebf5ea5e4052b1d71e8a77b9f43139718621f6849326",
+      hashType: "type",
+      cellDeps: [
+        {
+          cellDep: {
+            outPoint: {
+              txHash:
+                "0x8fb747ff0416a43e135c583b028f98c7b81d3770551b196eb7ba1062dd9acc94",
+              index: 0,
+            },
+            depType: "code",
+          },
+          type: {
+            codeHash:
+              "0x00000000000000000000000000000000000000000000000000545950455f4944",
+            hashType: "type",
+            args: "0xc9828585e6dd2afacb9e6e8ca7deb0975121aabee5c7983178a45509ffaec984",
+          },
+        },
+        // btc time lock config cell dep for Bitcoin Testnet3
+        {
+          cellDep: {
+            outPoint: {
+              txHash:
+                "0x8fb747ff0416a43e135c583b028f98c7b81d3770551b196eb7ba1062dd9acc94",
+              index: 1,
+            },
+            depType: "code",
+          },
+        },
+      ],
+    },
   });

packages/core/src/client/jsonRpc/client.ts

@@ -131,9 +131,9 @@ export abstract class ClientJsonRpc extends Client {
   getFeeRateStatistics = this.buildSender(
     "get_fee_rate_statistics",
     [(n: NumLike) => apply(numFrom, n)],
-    ({ mean, median }: { mean: NumLike; median: NumLike }) => ({
-      mean: numFrom(mean),
-      median: numFrom(median),
+    (res: { mean: NumLike; median: NumLike } | null | undefined) => ({
+      mean: apply(numFrom, res?.mean),
+      median: apply(numFrom, res?.median),
     }),
   ) as Client["getFeeRateStatistics"];
 

packages/core/src/client/knownScript.ts

@@ -26,4 +26,8 @@ export enum KnownScript {
   TypeBurnLock = "TypeBurnLock",
   EasyToDiscoverType = "EasyToDiscoverType",
   TimeLock = "TimeLock",
+
+  // RGB++ related scripts
+  RgbppLock = "RgbppLock",
+  BtcTimeLock = "BtcTimeLock",
 }

packages/core/src/hex/index.ts

@@ -13,8 +13,33 @@ export type Hex = `0x${string}`;
 export type HexLike = BytesLike;
 
 /**
- * Converts a HexLike value to a Hex string.
- * @public
+ * Determines whether a given value is a properly formatted hexadecimal string (ccc.Hex).
+ *
+ * A valid hexadecimal string:
+ * - Has at least two characters.
+ * - Starts with "0x".
+ * - Has an even length.
+ * - Contains only characters representing digits (0-9) or lowercase letters (a-f) after the "0x" prefix.
+ *
+ * @param v - The value to validate as a hexadecimal (ccc.Hex) string.
+ * @returns True if the string is a valid hex string, false otherwise.
+ */
+export function isHex(v: unknown): v is Hex {
+  if (!(typeof v === "string" && v.length % 2 === 0 && v.startsWith("0x"))) {
+    return false;
+  }
+
+  for (let i = 2; i < v.length; i++) {
+    const c = v.charAt(i);
+    if (!(("0" <= c && c <= "9") || ("a" <= c && c <= "f"))) {
+      return false;
+    }
+  }
+  return true;
+}
+
+/**
+ * Returns the hexadecimal representation of the given value.
  *
  * @param hex - The value to convert, which can be a string, Uint8Array, ArrayBuffer, or number array.
  * @returns A Hex string representing the value.
@@ -26,5 +51,10 @@ export type HexLike = BytesLike;
  * ```
  */
 export function hexFrom(hex: HexLike): Hex {
+  // Passthru an already normalized hex. V8 optimization: maintain existing hidden string fields.
+  if (isHex(hex)) {
+    return hex;
+  }
+
   return `0x${bytesTo(bytesFrom(hex), "hex")}`;
 }

packages/core/src/num/index.ts

@@ -1,4 +1,5 @@
 import { Bytes, BytesLike, bytesConcat, bytesFrom } from "../bytes/index.js";
+import { Zero } from "../fixedPoint/index.js";
 import { Hex, HexLike, hexFrom } from "../hex/index.js";
 
 /**
@@ -90,19 +91,31 @@ export function numFrom(val: NumLike): Num {
 }
 
 /**
- * Converts a NumLike value to a hexadecimal string.
+ * Converts a {@link NumLike} value into its hexadecimal string representation, prefixed with `0x`.
+ *
+ * @remarks
+ * This function returns the direct hexadecimal representation of the number, which may have an odd number of digits.
+ * For a full-byte representation (an even number of hex digits), consider using {@link numToBytes}, {@link numLeToBytes}, or {@link numBeToBytes} and then converting the resulting byte array to a hex string.
+ *
  * @public
  *
  * @param val - The value to convert, which can be a string, number, bigint, or HexLike.
- * @returns A Hex string representing the numeric value.
+ * @returns A Hex string representing the number.
+ *
+ * @throws {Error} If the normalized numeric value is negative.
  *
  * @example
  * ```typescript
- * const hex = numToHex(12345); // Outputs "0x3039"
+ * const hex = numToHex(4660); // "0x1234"
+ * const oddLengthHex = numToHex(10); // "0xa"
  * ```
  */
 export function numToHex(val: NumLike): Hex {
-  return `0x${numFrom(val).toString(16)}`;
+  const v = numFrom(val);
+  if (v < Zero) {
+    throw new Error("value must be non-negative");
+  }
+  return `0x${v.toString(16)}`;
 }
 
 /**