@@ -315,6 +315,11 @@ export type CellAnyLike = {
315315 * This class provides a unified interface for handling cells before they are included in a transaction,
316316 * or for cells that are already part of the blockchain state.
317317 *
318+ * @remarks
319+ * When representing an output of a transaction being built, which does not have a deterministic `outPoint` yet,
320+ * this class should be used without an `outPoint`. Once the transaction is on-chain, its outputs can be
321+ * represented as `Cell` instances with a defined `outPoint`.
322+ *
318323 * @public
319324 */
320325export class CellAny {
@@ -460,6 +465,12 @@ export type CellLike = CellAnyLike &
460465/**
461466 * Represents an on-chain CKB cell, which is a `CellAny` that is guaranteed to have an `outPoint`.
462467 * This class is typically used for cells that are already part of the blockchain state, such as transaction inputs.
468+ *
469+ * @remarks
470+ * An `outPoint` should only be included when it is deterministic.
471+ * For example, an output cell in a transaction currently being built does not have a deterministic `outPoint` yet,
472+ * and should be represented as a `CellAny` without an `outPoint`. This helps simplify logic elsewhere in the library.
473+ *
463474 * @public
464475 */
465476export class Cell extends CellAny {
@@ -1086,6 +1097,7 @@ export class WitnessArgs extends mol.Entity.Base<
10861097/**
10871098 * Convert a bytes to a num.
10881099 *
1100+ * @deprecated Use `Udt.balanceFrom` from `@ckb-ccc/udt` instead
10891101 * @public
10901102 */
10911103export function udtBalanceFrom ( dataLike : BytesLike ) : Num {
0 commit comments