@ckb-ccc/core 1.22.0 → 1.23.0

package/CHANGELOG.md

@@ -1,5 +1,76 @@
 # @ckb-ccc/core
 
+## 1.23.0
+
+### Minor Changes
+
+- [#575](https://github.com/ckb-devrel/ccc/pull/575) [`bb6cbf4`](https://github.com/ckb-devrel/ccc/commit/bb6cbf4ad68438c84faed61d8516530c643f3f4e) Thanks [@LusoCryptoLabs](https://github.com/LusoCryptoLabs)! - Add `AddressResolver` and `ClientConfig.addressResolver`, so `Address.fromString` can resolve representations it cannot parse, such as names, with a single Client. Passing a prefix-keyed record of Clients to `Address.fromString` is now deprecated; callers supporting multiple prefixes should try each Client themselves.
+
+- [#578](https://github.com/ckb-devrel/ccc/pull/578) [`21bf250`](https://github.com/ckb-devrel/ccc/commit/21bf2505cd9992a000da7a0c6a18b78aac67b34a) Thanks [@Hanssen0](https://github.com/Hanssen0)! - Generalize codec decode configuration into composable decode contexts.
+  
+  - Add a backward-compatible `Context` parameter to `Codec` and `CodecLike`.
+  - Infer decoder contexts in `Codec.from` and preserve them through mapping APIs.
+  - Propagate and combine child contexts across Molecule codec combinators.
+  - Forward optional decode contexts through `Entity.decode` and `Entity.fromBytes`.
+  - Keep `isExtraFieldIgnored` as Table-specific behavior while supporting deeply nested compatible decoding.
+
+- [#573](https://github.com/ckb-devrel/ccc/pull/573) [`8b650f0`](https://github.com/ckb-devrel/ccc/commit/8b650f0f06853923a6fa8cf9202f2854d215cf33) Thanks [@Hanssen0](https://github.com/Hanssen0)! - feat(core): add fixedUnion for fixed-size molecule union compositions
+  
+  - Introduce `mol.fixedUnion` to support fixed-size Molecule union extensions.
+  - Require all variants to have the same positive safe integer `byteLength`.
+  - Produce fixed-size codec (`byteLength = variantByteLength + 4`) that can be embedded into `mol.struct`, `mol.array`, and produces FixVec binary format in `mol.vector`.
+  - Support custom tag ID mappings with strict schema validation.
+
+- [#573](https://github.com/ckb-devrel/ccc/pull/573) [`de94e2c`](https://github.com/ckb-devrel/ccc/commit/de94e2c06778af3bcc413dd10f755806874afe45) Thanks [@Hanssen0](https://github.com/Hanssen0)! - fix(core)!: treat molecule union as dynamic-size type
+  
+  **BREAKING CHANGE**: In compliance with the Molecule specification (RFC 0008), standard `mol.union` is now strictly treated as a dynamic-size type (`byteLength` is `undefined`), regardless of whether all variants share identical byte lengths.
+  
+  Impact & Migration:
+  - When composed inside `mol.vector`, `mol.vector(mol.union(...))` now produces the canonical Molecule dynamic vector (DynVec) binary layout (`[full_size: uint32][offset_0]...[item_0]...`) instead of fixed vector (FixVec).
+  - Standalone encoding/decoding of a union item (`[item_id: uint32][payload]`) is unchanged.
+  - Standard `mol.union` can no longer be nested directly inside fixed-size containers (`mol.struct`, `mol.array`, `mol.fixedItemVec`).
+  - If you require fixed-size union layout for equal-length variants (FixVec in vector, or embedding in struct/array), use `mol.fixedUnion` (available via `@ckb-ccc/core`).
+
+### Patch Changes
+
+- [#577](https://github.com/ckb-devrel/ccc/pull/577) [`b21b27d`](https://github.com/ckb-devrel/ccc/commit/b21b27d4d29484b255d95105f6079ebb688b0e5c) Thanks [@Hanssen0](https://github.com/Hanssen0)! - Deprecate the ineffective `verbosity` and `withCycles` parameters on Client methods.
+
+- [#574](https://github.com/ckb-devrel/ccc/pull/574) [`a7bcb6d`](https://github.com/ckb-devrel/ccc/commit/a7bcb6d4db3e5255d9178a654a872050f86523ce) Thanks [@Hanssen0](https://github.com/Hanssen0)! - Fix in-memory cache partial matching to support interior byte sequences.
+
+- [#571](https://github.com/ckb-devrel/ccc/pull/571) [`6946dd1`](https://github.com/ckb-devrel/ccc/commit/6946dd123400954a21eccfa71a0fb5b4af271051) Thanks [@Hanssen0](https://github.com/Hanssen0)! - fix(core): avoid mutating existing transaction entities during capacity normalization
+  
+  Invalid existing `CellOutput`, `Cell`, `CellAny`, and `Transaction` instances are now reconstructed instead of being repaired in place.
+
+- [#573](https://github.com/ckb-devrel/ccc/pull/573) [`3506c09`](https://github.com/ckb-devrel/ccc/commit/3506c09a5d16f4ec33ed379b73951b47434e2370) Thanks [@Hanssen0](https://github.com/Hanssen0)! - Reject zero-size and non-safe-integer parameters in Molecule fixed-size types.
+  
+  - Validate constructor arguments for `mol.fixedItemVec`, `mol.array`, and `mol.struct` with `Number.isSafeInteger(val) && val > 0`.
+  - Reject zero-item or non-safe-integer count in `mol.array(itemCodec, 0)`.
+  - Reject empty-field structs `mol.struct({})` and structs containing zero-length fields.
+  - Validate that cumulative struct byte length and array byte length remain within the JavaScript safe integer range.
+
+- [#573](https://github.com/ckb-devrel/ccc/pull/573) [`665931f`](https://github.com/ckb-devrel/ccc/commit/665931f2e040cc19503f4924453cf9d8d8bec5e8) Thanks [@Hanssen0](https://github.com/Hanssen0)! - Validate Molecule Table and DynVec headers and offsets strictly.
+  
+  - Validate header total size matches buffer byte length.
+  - Validate field offsets count, 4-byte alignment, non-decreasing order, and offsets within payload bounds.
+  - Validate offsets for all fields in the Table header, including trailing fields omitted by the schema for forward compatibility.
+  - Disallow non-empty Table schemas from matching empty byte buffers, while properly supporting empty Table schemas.
+
+- [#573](https://github.com/ckb-devrel/ccc/pull/573) [`2c91baa`](https://github.com/ckb-devrel/ccc/commit/2c91baaeb7090442264c2067defaa2c34d1d067f) Thanks [@Hanssen0](https://github.com/Hanssen0)! - Validate tag length, schema, and custom field IDs in Molecule Union.
+  
+  - Reject inputs with fewer than 4 bytes during Union decoding.
+  - Strictly validate custom variant ID mappings: require unique valid uint32 IDs with an exact key match to the union layout, and reject non-enumerable or prototype-inherited properties.
+  - Throw structured and descriptive errors (`unknown union field index ...`) when decoding an unrecognized tag ID.
+
+## 1.22.1
+
+### Patch Changes
+
+- [#565](https://github.com/ckb-devrel/ccc/pull/565) [`90891c1`](https://github.com/ckb-devrel/ccc/commit/90891c15049cba439e041acb93868d0d9865d848) Thanks [@Hanssen0](https://github.com/Hanssen0)! - fix(core): ensure fee-completion convergence and prevent sub-occupied outputs
+
+- [#567](https://github.com/ckb-devrel/ccc/pull/567) [`5be7663`](https://github.com/ckb-devrel/ccc/commit/5be7663ce5857f75c349d111fd6983396365f308) Thanks [@Hanssen0](https://github.com/Hanssen0)! - Serialize `getFeeRateStatistics` block range parameter to hex to avoid BigInt serialization error.
+
+- [#563](https://github.com/ckb-devrel/ccc/pull/563) [`99c24ee`](https://github.com/ckb-devrel/ccc/commit/99c24ee6b93ed909aa601c3b4580732d320c14ec) Thanks [@Hanssen0](https://github.com/Hanssen0)! - Fix `fixedPointFrom` and `fixedPointToString` handling of negative fractional values.
+
 ## 1.22.0
 
 ### Minor Changes

package/dist/advanced.d.mts

@@ -1,2 +1,2 @@
-import { A as filterScriptByLenRange, B as addressPayloadFromString, C as CellRecord, D as filterData, Dn as DEFAULT_MIN_FEE_RATE, E as filterCell, En as DEFAULT_MAX_FEE_RATE, F as HASH_TYPE_TO_NUM, Ga as BytesFromEncoding, Gn as SignerJsonRpcInfo, I as NUM_TO_HASH_TYPE, Jn as SignerJsonRpcTransformers, Kn as SignerJsonRpcInfoPayload, L as ADDRESS_BECH32_LIMIT, M as DEP_TYPE_TO_NUM, N as NUM_TO_DEP_TYPE, O as filterNumByRange, On as clientSearchKeyRangeFrom, P as HASH_TYPES, R as AddressFormat, S as MAINNET_SCRIPTS, T as MapLru, Tn as ClientCollectableSearchKeyLike, _ as JsonRpcIndexerSearchKeyTransaction, a as JsonRpcBlock, b as JsonRpcTransaction, c as JsonRpcCellDep, d as JsonRpcDepType, f as JsonRpcHashType, g as JsonRpcIndexerSearchKeyFilter, h as JsonRpcIndexerSearchKey, i as JsonRpcTransformers, j as DEP_TYPES, k as filterScript, l as JsonRpcCellInput, m as JsonRpcIndexerFindTransactionsResponse, n as jsonRpcTransportFromUri, o as JsonRpcBlockHeader, p as JsonRpcIndexerFindTransactionsGroupedResponse, qn as SignerJsonRpcMessageToSign, r as CKB_BLAKE2B_PERSONAL, s as JsonRpcBlockUncle, t as advancedBarrel_d_exports, u as JsonRpcCellOutput, v as JsonRpcOutPoint, w as DEFAULT_CONFIRMED_BLOCK_TIME, wn as ClientCollectableSearchKeyFilterLike, x as TESTNET_SCRIPTS, y as JsonRpcScript, z as addressFromPayload } from "./advancedBarrel-Daj_LJkz.mjs";
+import { A as filterScriptByLenRange, B as addressPayloadFromString, C as CellRecord, D as filterData, Dn as DEFAULT_MAX_FEE_RATE, E as filterCell, En as ClientCollectableSearchKeyLike, F as HASH_TYPE_TO_NUM, I as NUM_TO_HASH_TYPE, Ja as BytesFromEncoding, Jn as SignerJsonRpcMessageToSign, Kn as SignerJsonRpcInfo, L as ADDRESS_BECH32_LIMIT, M as DEP_TYPE_TO_NUM, N as NUM_TO_DEP_TYPE, O as filterNumByRange, On as DEFAULT_MIN_FEE_RATE, P as HASH_TYPES, R as AddressFormat, S as MAINNET_SCRIPTS, T as MapLru, Tn as ClientCollectableSearchKeyFilterLike, Yn as SignerJsonRpcTransformers, _ as JsonRpcIndexerSearchKeyTransaction, a as JsonRpcBlock, b as JsonRpcTransaction, c as JsonRpcCellDep, d as JsonRpcDepType, f as JsonRpcHashType, g as JsonRpcIndexerSearchKeyFilter, h as JsonRpcIndexerSearchKey, i as JsonRpcTransformers, j as DEP_TYPES, k as filterScript, kn as clientSearchKeyRangeFrom, l as JsonRpcCellInput, m as JsonRpcIndexerFindTransactionsResponse, n as jsonRpcTransportFromUri, o as JsonRpcBlockHeader, p as JsonRpcIndexerFindTransactionsGroupedResponse, qn as SignerJsonRpcInfoPayload, r as CKB_BLAKE2B_PERSONAL, s as JsonRpcBlockUncle, t as advancedBarrel_d_exports, u as JsonRpcCellOutput, v as JsonRpcOutPoint, w as DEFAULT_CONFIRMED_BLOCK_TIME, x as TESTNET_SCRIPTS, y as JsonRpcScript, z as addressFromPayload } from "./advancedBarrel-BBbQZ2OW.mjs";
 export { ADDRESS_BECH32_LIMIT, AddressFormat, BytesFromEncoding, CKB_BLAKE2B_PERSONAL, CellRecord, ClientCollectableSearchKeyFilterLike, ClientCollectableSearchKeyLike, DEFAULT_CONFIRMED_BLOCK_TIME, DEFAULT_MAX_FEE_RATE, DEFAULT_MIN_FEE_RATE, DEP_TYPES, DEP_TYPE_TO_NUM, HASH_TYPES, HASH_TYPE_TO_NUM, JsonRpcBlock, JsonRpcBlockHeader, JsonRpcBlockUncle, JsonRpcCellDep, JsonRpcCellInput, JsonRpcCellOutput, JsonRpcDepType, JsonRpcHashType, JsonRpcIndexerFindTransactionsGroupedResponse, JsonRpcIndexerFindTransactionsResponse, JsonRpcIndexerSearchKey, JsonRpcIndexerSearchKeyFilter, JsonRpcIndexerSearchKeyTransaction, JsonRpcOutPoint, JsonRpcScript, JsonRpcTransaction, JsonRpcTransformers, MAINNET_SCRIPTS, MapLru, NUM_TO_DEP_TYPE, NUM_TO_HASH_TYPE, SignerJsonRpcInfo, SignerJsonRpcInfoPayload, SignerJsonRpcMessageToSign, SignerJsonRpcTransformers, TESTNET_SCRIPTS, addressFromPayload, addressPayloadFromString, advancedBarrel_d_exports as cccA, clientSearchKeyRangeFrom, filterCell, filterData, filterNumByRange, filterScript, filterScriptByLenRange, jsonRpcTransportFromUri };

package/dist/advanced.mjs

@@ -1 +1 @@
-import{$ as e,Cr as t,H as n,Q as r,U as i,W as a,_ as o,a as s,bt as c,c as l,d as u,et as d,f,g as p,h as m,i as h,m as g,n as _,o as v,p as y,r as b,s as x,t as S,v as C,vt as w,yt as T}from"./transformers-DAMi6ZOq.mjs";import{t as E}from"./advancedBarrel.mjs";export{_ as ADDRESS_BECH32_LIMIT,b as AddressFormat,t as CKB_BLAKE2B_PERSONAL,f as DEFAULT_CONFIRMED_BLOCK_TIME,w as DEFAULT_MAX_FEE_RATE,T as DEFAULT_MIN_FEE_RATE,n as DEP_TYPES,i as DEP_TYPE_TO_NUM,r as HASH_TYPES,e as HASH_TYPE_TO_NUM,x as JsonRpcTransformers,u as MAINNET_SCRIPTS,y as MapLru,a as NUM_TO_DEP_TYPE,d as NUM_TO_HASH_TYPE,S as SignerJsonRpcTransformers,v as TESTNET_SCRIPTS,h as addressFromPayload,s as addressPayloadFromString,E as cccA,c as clientSearchKeyRangeFrom,g as filterCell,m as filterData,p as filterNumByRange,o as filterScript,C as filterScriptByLenRange,l as jsonRpcTransportFromUri};
+import{$ as e,H as t,Q as n,U as r,W as i,_ as a,a as o,bt as s,c,d as l,et as u,f as d,g as f,h as p,i as m,m as h,n as g,o as _,p as v,r as y,s as b,t as x,v as S,vt as C,wr as w,yt as T}from"./transformers-BHt442Nd.mjs";import{t as E}from"./advancedBarrel.mjs";export{g as ADDRESS_BECH32_LIMIT,y as AddressFormat,w as CKB_BLAKE2B_PERSONAL,d as DEFAULT_CONFIRMED_BLOCK_TIME,C as DEFAULT_MAX_FEE_RATE,T as DEFAULT_MIN_FEE_RATE,t as DEP_TYPES,r as DEP_TYPE_TO_NUM,n as HASH_TYPES,e as HASH_TYPE_TO_NUM,b as JsonRpcTransformers,l as MAINNET_SCRIPTS,v as MapLru,i as NUM_TO_DEP_TYPE,u as NUM_TO_HASH_TYPE,x as SignerJsonRpcTransformers,_ as TESTNET_SCRIPTS,m as addressFromPayload,o as addressPayloadFromString,E as cccA,s as clientSearchKeyRangeFrom,h as filterCell,p as filterData,f as filterNumByRange,a as filterScript,S as filterScriptByLenRange,c as jsonRpcTransportFromUri};