@ckb-ccc/udt 0.1.25 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @ckb-ccc/udt
 
+## 0.2.1
+### Patch Changes
+
+- Updated dependencies [[`98597b5`](https://github.com/ckb-devrel/ccc/commit/98597b56eb6eeb029b72ea963649155dfe1f4215), [`bef9d0a`](https://github.com/ckb-devrel/ccc/commit/bef9d0a037fba045eab24d7ad55400fa26fbbffd), [`8067a08`](https://github.com/ckb-devrel/ccc/commit/8067a08de041ffd7a624adea0b594eb283e2634e), [`7019a1a`](https://github.com/ckb-devrel/ccc/commit/7019a1a7f765dfa7940cdfe51474bcd347f18ec6), [`9beee4d`](https://github.com/ckb-devrel/ccc/commit/9beee4d7f39e4b4b19919c5feb86e1c8be0e089d), [`2d4e701`](https://github.com/ckb-devrel/ccc/commit/2d4e701e54e9bf5247c2363490009acc5606c0ea), [`0eb8435`](https://github.com/ckb-devrel/ccc/commit/0eb8435d9694602fce3b7e6a95f04f793452a88d)]:
+  - @ckb-ccc/core@1.15.0
+  - @ckb-ccc/ssri@0.3.1
+
+## 0.2.0
+### Minor Changes
+
+
+
+- [#381](https://github.com/ckb-devrel/ccc/pull/381) [`46cc045`](https://github.com/ckb-devrel/ccc/commit/46cc045a3eefe9ba6625482dc7f740a0c59c99d4) Thanks [@Hanssen0](https://github.com/Hanssen0)! - chore: bump packages
+
+
+### Patch Changes
+
+- Updated dependencies [[`46cc045`](https://github.com/ckb-devrel/ccc/commit/46cc045a3eefe9ba6625482dc7f740a0c59c99d4)]:
+  - @ckb-ccc/core@1.14.0
+  - @ckb-ccc/ssri@0.3.0
+
 ## 0.1.25
 ### Patch Changes
 

package/dist/barrel.d.mts

@@ -0,0 +1,179 @@
+import { ccc } from "@ckb-ccc/core";
+import { ssri } from "@ckb-ccc/ssri";
+
+//#region src/udt/index.d.ts
+/**
+ * Represents a User Defined Token (UDT) script compliant with the SSRI protocol.
+ *
+ * This class provides a comprehensive implementation for interacting with User Defined Tokens,
+ * supporting various token operations such as querying metadata, checking balances, and performing transfers.
+ * It supports both SSRI-compliant UDTs and legacy sUDT/xUDT standard tokens.
+ *
+ * @public
+ * @category Blockchain
+ * @category Token
+ */
+declare class Udt extends ssri.Trait {
+  readonly script: ccc.Script;
+  /**
+   * Constructs a new UDT (User Defined Token) script instance.
+   * By default it is a SSRI-compliant UDT.
+   *
+   * @param code - The script code cell of the UDT.
+   * @param script - The type script of the UDT.
+   * @param config - Optional configuration for the UDT instance.
+   * @param config.executor - The SSRI executor instance. If provided, enables SSRI-based operations.
+   * @example
+   * ```typescript
+   * const udt = new Udt(code, script, { executor });
+   * ```
+   */
+  constructor(code: ccc.OutPointLike, script: ccc.ScriptLike, config?: {
+    executor?: ssri.Executor | null;
+  } | null);
+  /**
+   * Retrieves the human-readable name of the User Defined Token.
+   *
+   * @param context - Optional SSRI context for script execution.
+   * @returns A promise resolving to the token's name.
+   */
+  name(context?: ssri.ContextScript): Promise<ssri.ExecutorResponse<string | undefined>>;
+  /**
+   * Retrieves the symbol of the UDT.
+   * @param context - Optional SSRI context for script execution.
+   * @returns The symbol of the UDT.
+   */
+  symbol(context?: ssri.ContextScript): Promise<ssri.ExecutorResponse<string | undefined>>;
+  /**
+   * Retrieves the decimals of the UDT.
+   * @param context - Optional SSRI context for script execution.
+   * @returns The decimals of the UDT.
+   */
+  decimals(context?: ssri.ContextScript): Promise<ssri.ExecutorResponse<ccc.Num | undefined>>;
+  /**
+   * Retrieves the icon of the UDT.
+   * @param context - Optional SSRI context for script execution.
+   * @returns The icon of the UDT.
+   */
+  icon(context?: ssri.ContextScript): Promise<ssri.ExecutorResponse<string | undefined>>;
+  /**
+   * Transfers UDT to specified addresses.
+   * @param signer - The signer to use for the transaction.
+   * @param transfers - The array of transfers.
+   * @param transfers.to - The receiver of token.
+   * @param transfers.amount - The amount of token to the receiver.
+   * @param tx - Transfer on the basis of an existing transaction to achieve combined actions. If not provided, a new transaction will be created.
+   * @returns The transaction result.
+   * @tag Mutation - This method represents a mutation of the onchain state and will return a transaction object.
+   * @example
+   * ```typescript
+   * const { script: change } = await signer.getRecommendedAddressObj();
+   * const { script: to } = await ccc.Address.fromString(receiver, signer.client);
+   *
+   * const udt = new Udt(
+   *   {
+   *     txHash: "0x4e2e832e0b1e7b5994681b621b00c1e65f577ee4b440ef95fa07db9bb3d50269",
+   *     index: 0,
+   *   },
+   *   {
+   *     codeHash: "0xcc9dc33ef234e14bc788c43a4848556a5fb16401a04662fc55db9bb201987037",
+   *     hashType: "type",
+   *     args: "0x71fd1985b2971a9903e4d8ed0d59e6710166985217ca0681437883837b86162f"
+   *   },
+   * );
+   *
+   * const { res: tx } = await udtTrait.transfer(
+   *   signer,
+   *   [{ to, amount: 100 }],
+   * );
+   *
+   * const completedTx = udt.completeUdtBy(tx, signer);
+   * await completedTx.completeInputsByCapacity(signer);
+   * await completedTx.completeFeeBy(signer);
+   * const transferTxHash = await signer.sendTransaction(completedTx);
+   * ```
+   */
+  transfer(signer: ccc.Signer, transfers: {
+    to: ccc.ScriptLike;
+    amount: ccc.NumLike;
+  }[], tx?: ccc.TransactionLike | null): Promise<ssri.ExecutorResponse<ccc.Transaction>>;
+  /**
+   * Mints new tokens to specified addresses. See the example in `transfer` as they are similar.
+   * @param signer - The signer to use for the transaction.
+   * @param mints - Array of mints
+   * @param mints.to - receiver of token
+   * @param mints.amount - amount to the receiver
+   * @param tx - Optional existing transaction to build upon
+   * @returns The transaction containing the mint operation
+   * @tag Mutation - This method represents a mutation of the onchain state
+   */
+  mint(signer: ccc.Signer, mints: {
+    to: ccc.ScriptLike;
+    amount: ccc.NumLike;
+  }[], tx?: ccc.TransactionLike | null): Promise<ssri.ExecutorResponse<ccc.Transaction>>;
+  /**
+   * Completes a UDT transaction by adding change output to a specific lock script.
+   * @param txLike - The transaction to complete.
+   * @param signer - The signer to use for input selection.
+   * @param change - The lock script for the change output.
+   * @returns The completed transaction.
+   */
+  completeChangeToLock(txLike: ccc.TransactionLike, signer: ccc.Signer, change: ccc.ScriptLike): Promise<ccc.Transaction>;
+  /**
+   * Completes a UDT transaction by adding change output to the signer's address.
+   * @param tx - The transaction to complete.
+   * @param from - The signer to use for input selection and change address.
+   * @returns The completed transaction.
+   */
+  completeBy(tx: ccc.TransactionLike, from: ccc.Signer): Promise<ccc.Transaction>;
+}
+//#endregion
+//#region src/udtPausable/index.d.ts
+/**
+ * Represents a UDT (User Defined Token) with pausable functionality.
+ * @extends {Udt} This must be a SSRI UDT that does not fallback to xUDT.
+ * @public
+ */
+declare class UdtPausable extends Udt {
+  constructor(code: ccc.OutPointLike, script: ccc.ScriptLike, config: {
+    executor: ssri.Executor;
+  });
+  /**
+   * Pauses the UDT for the specified lock scripts. Pausing/Unpause without lock scripts should take effect on the global level. Note that this method is only available if the pausable UDT uses external pause list.
+   * @param signer - The signer to use for the transaction.
+   * @param locks - The array of lock scripts to be paused.
+   * @param tx - The transaction to be used.
+   * @param extraLockHashes - Additional lock hashes to be paused.
+   * @returns The transaction result.
+   * @tag Mutation - This method represents a mutation of the onchain state and will return a transaction to be sent.
+   */
+  pause(signer: ccc.Signer, locks: ccc.ScriptLike[], tx?: ccc.TransactionLike | null, extraLockHashes?: ccc.HexLike[] | null): Promise<ssri.ExecutorResponse<ccc.Transaction>>;
+  /**
+   * Unpauses the UDT for the specified lock scripts. Note that this method is only available if the pausable UDT uses external pause list.
+   * @param signer - The signer to use for the transaction.
+   * @param locks - The array of lock scripts to be unpaused.
+   * @param tx - The transaction to be used.
+   * @param extraLockHashes - Additional lock hashes to be unpaused.
+   * @returns The transaction result.
+   * @tag Mutation - This method represents a mutation of the onchain state and will return a transaction to be sent.
+   */
+  unpause(signer: ccc.Signer, locks: ccc.ScriptLike[], tx?: ccc.TransactionLike | null, extraLockHashes?: ccc.HexLike[] | null): Promise<ssri.ExecutorResponse<ccc.Transaction>>;
+  /**
+   * Checks if the UDT is paused for the specified lock scripts within a transaction. If not using external pause list, it can also be run on Code environment level.
+   * @param locks - The lock scripts to check.
+   * @param extraLockHashes - Additional lock hashes to check.
+   * @returns True if any of the lock scripts are paused, false otherwise.
+   */
+  isPaused(locks: ccc.ScriptLike[], extraLockHashes?: ccc.HexLike[] | null): Promise<ssri.ExecutorResponse<boolean[]>>;
+  /**
+   * Enumerates all paused lock hashes in UDTPausableData.
+   * @returns The array of lock hashes.
+   */
+  enumeratePaused(offset?: ccc.Num, limit?: ccc.Num): Promise<ssri.ExecutorResponse<ccc.Hex[]>>;
+}
+declare namespace barrel_d_exports {
+  export { Udt, UdtPausable };
+}
+//#endregion
+export { Udt, UdtPausable, barrel_d_exports as t };
+//# sourceMappingURL=barrel.d.mts.map

package/dist/barrel.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barrel.d.mts","names":[],"sources":["../src/udt/index.ts","../src/udtPausable/index.ts","../src/barrel.ts"],"mappings":";;;;;;;AAcA;;;;;;;;cAAa,GAAA,SAAY,IAAA,CAAK,KAAA;EAAA,SACZ,MAAA,EAAQ,GAAA,CAAI,MAAA;EAsDhB;;;;;;;;;;;;;cAtCV,IAAA,EAAM,GAAA,CAAI,YAAA,EACV,MAAA,EAAQ,GAAA,CAAI,UAAA,EACZ,MAAA;IACE,QAAA,GAAW,IAAA,CAAK,QAAA;EAAA;EAkJjB;;;;;;EArIG,IAAA,CACJ,OAAA,GAAU,IAAA,CAAK,aAAA,GACd,OAAA,CAAQ,IAAA,CAAK,gBAAA;EA+Lb;;;;;EA5KG,MAAA,CACJ,OAAA,GAAU,IAAA,CAAK,aAAA,GACd,OAAA,CAAQ,IAAA,CAAK,gBAAA;EA0PK;;;;;EAlOf,QAAA,CACJ,OAAA,GAAU,IAAA,CAAK,aAAA,GACd,OAAA,CAAQ,IAAA,CAAK,gBAAA,CAAiB,GAAA,CAAI,GAAA;EAlFJ;;;;;EA0G3B,IAAA,CACJ,OAAA,GAAU,IAAA,CAAK,aAAA,GACd,OAAA,CAAQ,IAAA,CAAK,gBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDV,QAAA,CACJ,MAAA,EAAQ,GAAA,CAAI,MAAA,EACZ,SAAA;IACE,EAAA,EAAI,GAAA,CAAI,UAAA;IACR,MAAA,EAAQ,GAAA,CAAI,OAAA;EAAA,KAEd,EAAA,GAAK,GAAA,CAAI,eAAA,UACR,OAAA,CAAQ,IAAA,CAAK,gBAAA,CAAiB,GAAA,CAAI,WAAA;EAP/B;;;;;;;;;;EA4DA,IAAA,CACJ,MAAA,EAAQ,GAAA,CAAI,MAAA,EACZ,KAAA;IACE,EAAA,EAAI,GAAA,CAAI,UAAA;IACR,MAAA,EAAQ,GAAA,CAAI,OAAA;EAAA,KAEd,EAAA,GAAK,GAAA,CAAI,eAAA,UACR,OAAA,CAAQ,IAAA,CAAK,gBAAA,CAAiB,GAAA,CAAI,WAAA;EA5DlC;;;;;;;EA8GG,oBAAA,CACJ,MAAA,EAAQ,GAAA,CAAI,eAAA,EACZ,MAAA,EAAQ,GAAA,CAAI,MAAA,EACZ,MAAA,EAAQ,GAAA,CAAI,UAAA,GAAU,OAAA,CAAA,GAAA,CAAA,WAAA;EA3DtB;;;;;;EAsFI,UAAA,CAAW,EAAA,EAAI,GAAA,CAAI,eAAA,EAAiB,IAAA,EAAM,GAAA,CAAI,MAAA,GAAM,OAAA,CAAA,GAAA,CAAA,WAAA;AAAA;;;;;AAlT5D;;;cCLa,WAAA,SAAoB,GAAA;cAE7B,IAAA,EAAM,GAAA,CAAI,YAAA,EACV,MAAA,EAAQ,GAAA,CAAI,UAAA,EACZ,MAAA;IACE,QAAA,EAAU,IAAA,CAAK,QAAA;EAAA;EDkCP;;;;;;;;;ECnBN,KAAA,CACJ,MAAA,EAAQ,GAAA,CAAI,MAAA,EACZ,KAAA,EAAO,GAAA,CAAI,UAAA,IACX,EAAA,GAAK,GAAA,CAAI,eAAA,SACT,eAAA,GAAkB,GAAA,CAAI,OAAA,YACrB,OAAA,CAAQ,IAAA,CAAK,gBAAA,CAAiB,GAAA,CAAI,WAAA;EDuFzB;;;;;;;;;ECrDN,OAAA,CACJ,MAAA,EAAQ,GAAA,CAAI,MAAA,EACZ,KAAA,EAAO,GAAA,CAAI,UAAA,IACX,EAAA,GAAK,GAAA,CAAI,eAAA,SACT,eAAA,GAAkB,GAAA,CAAI,OAAA,YACrB,OAAA,CAAQ,IAAA,CAAK,gBAAA,CAAiB,GAAA,CAAI,WAAA;EDiK3B;;;;;;EClIJ,QAAA,CACJ,KAAA,EAAO,GAAA,CAAI,UAAA,IACX,eAAA,GAAkB,GAAA,CAAI,OAAA,YACrB,OAAA,CAAQ,IAAA,CAAK,gBAAA;EDwLN;;;;ECpKJ,eAAA,CACJ,MAAA,GAAS,GAAA,CAAI,GAAA,EACb,KAAA,GAAQ,GAAA,CAAI,GAAA,GACX,OAAA,CAAQ,IAAA,CAAK,gBAAA,CAAiB,GAAA,CAAI,GAAA;AAAA;AAAA"}

package/dist/barrel.mjs

@@ -0,0 +1,2 @@
+import{t as e}from"./rolldown-runtime-DK3Fl9T5.mjs";import{ccc as t}from"@ckb-ccc/core";import{ssri as n}from"@ckb-ccc/ssri";var r=class extends n.Trait{constructor(e,n,r){super(e,r?.executor),this.script=t.Script.from(n)}async name(e){if(this.executor){let n=await this.executor.runScriptTry(this.code,`UDT.name`,[],{script:this.script,...e});if(n)return n.map(e=>t.bytesTo(e,`utf8`))}return n.ExecutorResponse.new(void 0)}async symbol(e){if(this.executor){let n=await this.executor.runScriptTry(this.code,`UDT.symbol`,[],{script:this.script,...e});if(n)return n.map(e=>t.bytesTo(e,`utf8`))}return n.ExecutorResponse.new(void 0)}async decimals(e){if(this.executor){let n=await this.executor.runScriptTry(this.code,`UDT.decimals`,[],{script:this.script,...e});if(n)return n.map(e=>t.numFromBytes(e))}return n.ExecutorResponse.new(void 0)}async icon(e){if(this.executor){let n=await this.executor.runScriptTry(this.code,`UDT.icon`,[],{script:this.script,...e});if(n)return n.map(e=>t.bytesTo(e,`utf8`))}return n.ExecutorResponse.new(void 0)}async transfer(e,r,i){let a;if(this.executor){let n=t.Transaction.from(i??{});await n.completeInputsAtLeastOne(e);let o=await this.executor.runScriptTry(this.code,`UDT.transfer`,[n.toBytes(),t.ScriptVec.encode(r.map(({to:e})=>e)),t.mol.Uint128Vec.encode(r.map(({amount:e})=>e))],{script:this.script});o&&(a=o.map(e=>t.Transaction.fromBytes(e)))}if(!a){let e=t.Transaction.from(i??{});for(let{to:n,amount:i}of r)e.addOutput({lock:n,type:this.script},t.numLeToBytes(i,16));a=n.ExecutorResponse.new(e)}return a.res.addCellDeps({outPoint:this.code,depType:`code`}),a}async mint(e,r,i){let a;if(this.executor){let n=t.Transaction.from(i??{});await n.completeInputsAtLeastOne(e);let o=await this.executor.runScriptTry(this.code,`UDT.mint`,[n.toBytes(),t.ScriptVec.encode(r.map(({to:e})=>e)),t.mol.Uint128Vec.encode(r.map(({amount:e})=>e))],{script:this.script});o&&(a=o.map(e=>t.Transaction.fromBytes(e)))}if(!a){let e=t.Transaction.from(i??{});for(let{to:n,amount:i}of r)e.addOutput({lock:n,type:this.script},t.numLeToBytes(i,16));a=n.ExecutorResponse.new(e)}return a.res.addCellDeps({outPoint:this.code,depType:`code`}),a}async completeChangeToLock(e,n,r){let i=t.Transaction.from(e);await i.completeInputsByUdt(n,this.script);let a=await i.getInputsUdtBalance(n.client,this.script)-i.getOutputsUdtBalance(this.script);return a>t.Zero&&i.addOutput({lock:r,type:this.script},t.numLeToBytes(a,16)),i}async completeBy(e,t){let{script:n}=await t.getRecommendedAddressObj();return this.completeChangeToLock(e,t,n)}},i=class extends r{constructor(e,t,n){super(e,t,n)}async pause(e,n,r,i){let a=t.Transaction.from(r??{});await a.completeInputsAtLeastOne(e);let o=(await this.assertExecutor().runScript(this.code,`UDTPausable.pause`,[a.toBytes(),t.mol.Byte32Vec.encode(n.map(e=>t.Script.from(e).hash()).concat(i?.map(t.hexFrom)??[]))],{script:this.script})).map(e=>t.Transaction.fromBytes(e));return o.res.addCellDeps({outPoint:this.code,depType:`code`}),o}async unpause(e,n,r,i){let a=t.Transaction.from(r??{});await a.completeInputsAtLeastOne(e);let o=(await this.assertExecutor().runScript(this.code,`UDTPausable.unpause`,[a.toBytes(),t.mol.Byte32Vec.encode(n.map(e=>t.Script.from(e).hash()).concat(i?.map(t.hexFrom)??[]))],{script:this.script})).map(e=>t.Transaction.fromBytes(e));return o.res.addCellDeps({outPoint:this.code,depType:`code`}),o}async isPaused(e,n){return(await this.assertExecutor().runScript(this.code,`UDTPausable.is_paused`,[t.mol.Byte32Vec.encode(e.map(e=>t.Script.from(e).hash()).concat(n?.map(t.hexFrom)??[]))],{script:this.script})).map(e=>t.mol.BoolVec.decode(e))}async enumeratePaused(e,n){return(await this.assertExecutor().runScript(this.code,`UDTPausable.enumerate_paused`,[t.numToBytes(e??0,8),t.numToBytes(n??0,8)],{script:this.script})).map(e=>t.mol.Byte32Vec.decode(e))}},a=e({Udt:()=>r,UdtPausable:()=>i});export{r as Udt,i as UdtPausable,a as t};
+//# sourceMappingURL=barrel.mjs.map

package/dist/barrel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"barrel.mjs","names":[],"sources":["../src/udt/index.ts","../src/udtPausable/index.ts","../src/barrel.ts"],"sourcesContent":["import { ccc } from \"@ckb-ccc/core\";\nimport { ssri } from \"@ckb-ccc/ssri\";\n\n/**\n * Represents a User Defined Token (UDT) script compliant with the SSRI protocol.\n *\n * This class provides a comprehensive implementation for interacting with User Defined Tokens,\n * supporting various token operations such as querying metadata, checking balances, and performing transfers.\n * It supports both SSRI-compliant UDTs and legacy sUDT/xUDT standard tokens.\n *\n * @public\n * @category Blockchain\n * @category Token\n */\nexport class Udt extends ssri.Trait {\n  public readonly script: ccc.Script;\n\n  /**\n   * Constructs a new UDT (User Defined Token) script instance.\n   * By default it is a SSRI-compliant UDT.\n   *\n   * @param code - The script code cell of the UDT.\n   * @param script - The type script of the UDT.\n   * @param config - Optional configuration for the UDT instance.\n   * @param config.executor - The SSRI executor instance. If provided, enables SSRI-based operations.\n   * @example\n   * ```typescript\n   * const udt = new Udt(code, script, { executor });\n   * ```\n   */\n  constructor(\n    code: ccc.OutPointLike,\n    script: ccc.ScriptLike,\n    config?: {\n      executor?: ssri.Executor | null;\n    } | null,\n  ) {\n    super(code, config?.executor);\n    this.script = ccc.Script.from(script);\n  }\n\n  /**\n   * Retrieves the human-readable name of the User Defined Token.\n   *\n   * @param context - Optional SSRI context for script execution.\n   * @returns A promise resolving to the token's name.\n   */\n  async name(\n    context?: ssri.ContextScript,\n  ): Promise<ssri.ExecutorResponse<string | undefined>> {\n    if (this.executor) {\n      const res = await this.executor.runScriptTry(this.code, \"UDT.name\", [], {\n        script: this.script,\n        ...context,\n      });\n      if (res) {\n        return res.map((res) => ccc.bytesTo(res, \"utf8\"));\n      }\n    }\n\n    return ssri.ExecutorResponse.new(undefined);\n  }\n\n  /**\n   * Retrieves the symbol of the UDT.\n   * @param context - Optional SSRI context for script execution.\n   * @returns The symbol of the UDT.\n   */\n  async symbol(\n    context?: ssri.ContextScript,\n  ): Promise<ssri.ExecutorResponse<string | undefined>> {\n    if (this.executor) {\n      const res = await this.executor.runScriptTry(\n        this.code,\n        \"UDT.symbol\",\n        [],\n        {\n          script: this.script,\n          ...context,\n        },\n      );\n      if (res) {\n        return res.map((res) => ccc.bytesTo(res, \"utf8\"));\n      }\n    }\n\n    return ssri.ExecutorResponse.new(undefined);\n  }\n\n  /**\n   * Retrieves the decimals of the UDT.\n   * @param context - Optional SSRI context for script execution.\n   * @returns The decimals of the UDT.\n   */\n  async decimals(\n    context?: ssri.ContextScript,\n  ): Promise<ssri.ExecutorResponse<ccc.Num | undefined>> {\n    if (this.executor) {\n      const res = await this.executor.runScriptTry(\n        this.code,\n        \"UDT.decimals\",\n        [],\n        {\n          script: this.script,\n          ...context,\n        },\n      );\n      if (res) {\n        return res.map((res) => ccc.numFromBytes(res));\n      }\n    }\n\n    return ssri.ExecutorResponse.new(undefined);\n  }\n\n  /**\n   * Retrieves the icon of the UDT.\n   * @param context - Optional SSRI context for script execution.\n   * @returns The icon of the UDT.\n   */\n  async icon(\n    context?: ssri.ContextScript,\n  ): Promise<ssri.ExecutorResponse<string | undefined>> {\n    if (this.executor) {\n      const res = await this.executor.runScriptTry(this.code, \"UDT.icon\", [], {\n        script: this.script,\n        ...context,\n      });\n      if (res) {\n        return res.map((res) => ccc.bytesTo(res, \"utf8\"));\n      }\n    }\n\n    return ssri.ExecutorResponse.new(undefined);\n  }\n\n  /**\n   * Transfers UDT to specified addresses.\n   * @param signer - The signer to use for the transaction.\n   * @param transfers - The array of transfers.\n   * @param transfers.to - The receiver of token.\n   * @param transfers.amount - The amount of token to the receiver.\n   * @param tx - Transfer on the basis of an existing transaction to achieve combined actions. If not provided, a new transaction will be created.\n   * @returns The transaction result.\n   * @tag Mutation - This method represents a mutation of the onchain state and will return a transaction object.\n   * @example\n   * ```typescript\n   * const { script: change } = await signer.getRecommendedAddressObj();\n   * const { script: to } = await ccc.Address.fromString(receiver, signer.client);\n   *\n   * const udt = new Udt(\n   *   {\n   *     txHash: \"0x4e2e832e0b1e7b5994681b621b00c1e65f577ee4b440ef95fa07db9bb3d50269\",\n   *     index: 0,\n   *   },\n   *   {\n   *     codeHash: \"0xcc9dc33ef234e14bc788c43a4848556a5fb16401a04662fc55db9bb201987037\",\n   *     hashType: \"type\",\n   *     args: \"0x71fd1985b2971a9903e4d8ed0d59e6710166985217ca0681437883837b86162f\"\n   *   },\n   * );\n   *\n   * const { res: tx } = await udtTrait.transfer(\n   *   signer,\n   *   [{ to, amount: 100 }],\n   * );\n   *\n   * const completedTx = udt.completeUdtBy(tx, signer);\n   * await completedTx.completeInputsByCapacity(signer);\n   * await completedTx.completeFeeBy(signer);\n   * const transferTxHash = await signer.sendTransaction(completedTx);\n   * ```\n   */\n  async transfer(\n    signer: ccc.Signer,\n    transfers: {\n      to: ccc.ScriptLike;\n      amount: ccc.NumLike;\n    }[],\n    tx?: ccc.TransactionLike | null,\n  ): Promise<ssri.ExecutorResponse<ccc.Transaction>> {\n    let resTx;\n    if (this.executor) {\n      const txReq = ccc.Transaction.from(tx ?? {});\n      await txReq.completeInputsAtLeastOne(signer);\n\n      const res = await this.executor.runScriptTry(\n        this.code,\n        \"UDT.transfer\",\n        [\n          txReq.toBytes(),\n          ccc.ScriptVec.encode(transfers.map(({ to }) => to)),\n          ccc.mol.Uint128Vec.encode(transfers.map(({ amount }) => amount)),\n        ],\n        {\n          script: this.script,\n        },\n      );\n      if (res) {\n        resTx = res.map((res) => ccc.Transaction.fromBytes(res));\n      }\n    }\n\n    if (!resTx) {\n      const transfer = ccc.Transaction.from(tx ?? {});\n      for (const { to, amount } of transfers) {\n        transfer.addOutput(\n          {\n            lock: to,\n            type: this.script,\n          },\n          ccc.numLeToBytes(amount, 16),\n        );\n      }\n      resTx = ssri.ExecutorResponse.new(transfer);\n    }\n    resTx.res.addCellDeps({\n      outPoint: this.code,\n      depType: \"code\",\n    });\n    return resTx;\n  }\n\n  /**\n   * Mints new tokens to specified addresses. See the example in `transfer` as they are similar.\n   * @param signer - The signer to use for the transaction.\n   * @param mints - Array of mints\n   * @param mints.to - receiver of token\n   * @param mints.amount - amount to the receiver\n   * @param tx - Optional existing transaction to build upon\n   * @returns The transaction containing the mint operation\n   * @tag Mutation - This method represents a mutation of the onchain state\n   */\n  async mint(\n    signer: ccc.Signer,\n    mints: {\n      to: ccc.ScriptLike;\n      amount: ccc.NumLike;\n    }[],\n    tx?: ccc.TransactionLike | null,\n  ): Promise<ssri.ExecutorResponse<ccc.Transaction>> {\n    let resTx;\n    if (this.executor) {\n      const txReq = ccc.Transaction.from(tx ?? {});\n      await txReq.completeInputsAtLeastOne(signer);\n\n      const res = await this.executor.runScriptTry(\n        this.code,\n        \"UDT.mint\",\n        [\n          txReq.toBytes(),\n          ccc.ScriptVec.encode(mints.map(({ to }) => to)),\n          ccc.mol.Uint128Vec.encode(mints.map(({ amount }) => amount)),\n        ],\n        {\n          script: this.script,\n        },\n      );\n      if (res) {\n        resTx = res.map((res) => ccc.Transaction.fromBytes(res));\n      }\n    }\n\n    if (!resTx) {\n      const mint = ccc.Transaction.from(tx ?? {});\n      for (const { to, amount } of mints) {\n        mint.addOutput(\n          {\n            lock: to,\n            type: this.script,\n          },\n          ccc.numLeToBytes(amount, 16),\n        );\n      }\n      resTx = ssri.ExecutorResponse.new(mint);\n    }\n    resTx.res.addCellDeps({\n      outPoint: this.code,\n      depType: \"code\",\n    });\n    return resTx;\n  }\n\n  /**\n   * Completes a UDT transaction by adding change output to a specific lock script.\n   * @param txLike - The transaction to complete.\n   * @param signer - The signer to use for input selection.\n   * @param change - The lock script for the change output.\n   * @returns The completed transaction.\n   */\n  async completeChangeToLock(\n    txLike: ccc.TransactionLike,\n    signer: ccc.Signer,\n    change: ccc.ScriptLike,\n  ) {\n    const tx = ccc.Transaction.from(txLike);\n\n    await tx.completeInputsByUdt(signer, this.script);\n    const balanceDiff =\n      (await tx.getInputsUdtBalance(signer.client, this.script)) -\n      tx.getOutputsUdtBalance(this.script);\n    if (balanceDiff > ccc.Zero) {\n      tx.addOutput(\n        {\n          lock: change,\n          type: this.script,\n        },\n        ccc.numLeToBytes(balanceDiff, 16),\n      );\n    }\n\n    return tx;\n  }\n\n  /**\n   * Completes a UDT transaction by adding change output to the signer's address.\n   * @param tx - The transaction to complete.\n   * @param from - The signer to use for input selection and change address.\n   * @returns The completed transaction.\n   */\n  async completeBy(tx: ccc.TransactionLike, from: ccc.Signer) {\n    const { script } = await from.getRecommendedAddressObj();\n\n    return this.completeChangeToLock(tx, from, script);\n  }\n}\n","import { ccc } from \"@ckb-ccc/core\";\nimport { ssri } from \"@ckb-ccc/ssri\";\nimport { Udt } from \"../udt/index.js\";\n\n/**\n * Represents a UDT (User Defined Token) with pausable functionality.\n * @extends {Udt} This must be a SSRI UDT that does not fallback to xUDT.\n * @public\n */\nexport class UdtPausable extends Udt {\n  constructor(\n    code: ccc.OutPointLike,\n    script: ccc.ScriptLike,\n    config: {\n      executor: ssri.Executor;\n    },\n  ) {\n    super(code, script, config);\n  }\n\n  /**\n   * Pauses the UDT for the specified lock scripts. Pausing/Unpause without lock scripts should take effect on the global level. Note that this method is only available if the pausable UDT uses external pause list.\n   * @param signer - The signer to use for the transaction.\n   * @param locks - The array of lock scripts to be paused.\n   * @param tx - The transaction to be used.\n   * @param extraLockHashes - Additional lock hashes to be paused.\n   * @returns The transaction result.\n   * @tag Mutation - This method represents a mutation of the onchain state and will return a transaction to be sent.\n   */\n  async pause(\n    signer: ccc.Signer,\n    locks: ccc.ScriptLike[],\n    tx?: ccc.TransactionLike | null,\n    extraLockHashes?: ccc.HexLike[] | null,\n  ): Promise<ssri.ExecutorResponse<ccc.Transaction>> {\n    const txReq = ccc.Transaction.from(tx ?? {});\n    await txReq.completeInputsAtLeastOne(signer);\n\n    const res = await this.assertExecutor().runScript(\n      this.code,\n      \"UDTPausable.pause\",\n      [\n        txReq.toBytes(),\n        ccc.mol.Byte32Vec.encode(\n          locks\n            .map((l) => ccc.Script.from(l).hash())\n            .concat(extraLockHashes?.map(ccc.hexFrom) ?? []),\n        ),\n      ],\n      { script: this.script },\n    );\n    const resTx = res.map((res) => ccc.Transaction.fromBytes(res));\n    resTx.res.addCellDeps({\n      outPoint: this.code,\n      depType: \"code\",\n    });\n    return resTx;\n  }\n\n  /**\n   * Unpauses the UDT for the specified lock scripts. Note that this method is only available if the pausable UDT uses external pause list.\n   * @param signer - The signer to use for the transaction.\n   * @param locks - The array of lock scripts to be unpaused.\n   * @param tx - The transaction to be used.\n   * @param extraLockHashes - Additional lock hashes to be unpaused.\n   * @returns The transaction result.\n   * @tag Mutation - This method represents a mutation of the onchain state and will return a transaction to be sent.\n   */\n  async unpause(\n    signer: ccc.Signer,\n    locks: ccc.ScriptLike[],\n    tx?: ccc.TransactionLike | null,\n    extraLockHashes?: ccc.HexLike[] | null,\n  ): Promise<ssri.ExecutorResponse<ccc.Transaction>> {\n    const txReq = ccc.Transaction.from(tx ?? {});\n    await txReq.completeInputsAtLeastOne(signer);\n\n    const res = await this.assertExecutor().runScript(\n      this.code,\n      \"UDTPausable.unpause\",\n      [\n        txReq.toBytes(),\n        ccc.mol.Byte32Vec.encode(\n          locks\n            .map((l) => ccc.Script.from(l).hash())\n            .concat(extraLockHashes?.map(ccc.hexFrom) ?? []),\n        ),\n      ],\n      { script: this.script },\n    );\n    const resTx = res.map((res) => ccc.Transaction.fromBytes(res));\n    resTx.res.addCellDeps({\n      outPoint: this.code,\n      depType: \"code\",\n    });\n    return resTx;\n  }\n\n  /**\n   * Checks if the UDT is paused for the specified lock scripts within a transaction. If not using external pause list, it can also be run on Code environment level.\n   * @param locks - The lock scripts to check.\n   * @param extraLockHashes - Additional lock hashes to check.\n   * @returns True if any of the lock scripts are paused, false otherwise.\n   */\n  async isPaused(\n    locks: ccc.ScriptLike[],\n    extraLockHashes?: ccc.HexLike[] | null,\n  ): Promise<ssri.ExecutorResponse<boolean[]>> {\n    const res = await this.assertExecutor().runScript(\n      this.code,\n      \"UDTPausable.is_paused\",\n      [\n        ccc.mol.Byte32Vec.encode(\n          locks\n            .map((l) => ccc.Script.from(l).hash())\n            .concat(extraLockHashes?.map(ccc.hexFrom) ?? []),\n        ),\n      ],\n      { script: this.script },\n    );\n    return res.map((res) => ccc.mol.BoolVec.decode(res));\n  }\n\n  /**\n   * Enumerates all paused lock hashes in UDTPausableData.\n   * @returns The array of lock hashes.\n   */\n  async enumeratePaused(\n    offset?: ccc.Num,\n    limit?: ccc.Num,\n  ): Promise<ssri.ExecutorResponse<ccc.Hex[]>> {\n    const res = await this.assertExecutor().runScript(\n      this.code,\n      \"UDTPausable.enumerate_paused\",\n      [ccc.numToBytes(offset ?? 0, 8), ccc.numToBytes(limit ?? 0, 8)],\n      { script: this.script },\n    );\n\n    return res.map((res) => ccc.mol.Byte32Vec.decode(res));\n  }\n}\n","export * from \"./udt/index.js\";\nexport * from \"./udtPausable/index.js\";\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { Udt, UdtPausable, t as barrel_d_exports } from "./barrel.mjs";
+export { Udt, UdtPausable, barrel_d_exports as udt };

package/dist/index.mjs

@@ -0,0 +1 @@
+import{Udt as e,UdtPausable as t,t as n}from"./barrel.mjs";export{e as Udt,t as UdtPausable,n as udt};

package/dist/rolldown-runtime-DK3Fl9T5.mjs

@@ -0,0 +1 @@
+var e=Object.defineProperty,t=(t,n)=>{let r={};for(var i in t)e(r,i,{get:t[i],enumerable:!0});return n||e(r,Symbol.toStringTag,{value:`Module`}),r};export{t};

package/dist.commonjs/barrel.d.ts

@@ -1,3 +1,181 @@
-export * from "./udt/index.js";
-export * from "./udtPausable/index.js";
+import { ccc } from "@ckb-ccc/core";
+import { ssri } from "@ckb-ccc/ssri";
+
+//#region \0rolldown/runtime.js
+//#endregion
+//#region src/udt/index.d.ts
+/**
+ * Represents a User Defined Token (UDT) script compliant with the SSRI protocol.
+ *
+ * This class provides a comprehensive implementation for interacting with User Defined Tokens,
+ * supporting various token operations such as querying metadata, checking balances, and performing transfers.
+ * It supports both SSRI-compliant UDTs and legacy sUDT/xUDT standard tokens.
+ *
+ * @public
+ * @category Blockchain
+ * @category Token
+ */
+declare class Udt extends ssri.Trait {
+  readonly script: ccc.Script;
+  /**
+   * Constructs a new UDT (User Defined Token) script instance.
+   * By default it is a SSRI-compliant UDT.
+   *
+   * @param code - The script code cell of the UDT.
+   * @param script - The type script of the UDT.
+   * @param config - Optional configuration for the UDT instance.
+   * @param config.executor - The SSRI executor instance. If provided, enables SSRI-based operations.
+   * @example
+   * ```typescript
+   * const udt = new Udt(code, script, { executor });
+   * ```
+   */
+  constructor(code: ccc.OutPointLike, script: ccc.ScriptLike, config?: {
+    executor?: ssri.Executor | null;
+  } | null);
+  /**
+   * Retrieves the human-readable name of the User Defined Token.
+   *
+   * @param context - Optional SSRI context for script execution.
+   * @returns A promise resolving to the token's name.
+   */
+  name(context?: ssri.ContextScript): Promise<ssri.ExecutorResponse<string | undefined>>;
+  /**
+   * Retrieves the symbol of the UDT.
+   * @param context - Optional SSRI context for script execution.
+   * @returns The symbol of the UDT.
+   */
+  symbol(context?: ssri.ContextScript): Promise<ssri.ExecutorResponse<string | undefined>>;
+  /**
+   * Retrieves the decimals of the UDT.
+   * @param context - Optional SSRI context for script execution.
+   * @returns The decimals of the UDT.
+   */
+  decimals(context?: ssri.ContextScript): Promise<ssri.ExecutorResponse<ccc.Num | undefined>>;
+  /**
+   * Retrieves the icon of the UDT.
+   * @param context - Optional SSRI context for script execution.
+   * @returns The icon of the UDT.
+   */
+  icon(context?: ssri.ContextScript): Promise<ssri.ExecutorResponse<string | undefined>>;
+  /**
+   * Transfers UDT to specified addresses.
+   * @param signer - The signer to use for the transaction.
+   * @param transfers - The array of transfers.
+   * @param transfers.to - The receiver of token.
+   * @param transfers.amount - The amount of token to the receiver.
+   * @param tx - Transfer on the basis of an existing transaction to achieve combined actions. If not provided, a new transaction will be created.
+   * @returns The transaction result.
+   * @tag Mutation - This method represents a mutation of the onchain state and will return a transaction object.
+   * @example
+   * ```typescript
+   * const { script: change } = await signer.getRecommendedAddressObj();
+   * const { script: to } = await ccc.Address.fromString(receiver, signer.client);
+   *
+   * const udt = new Udt(
+   *   {
+   *     txHash: "0x4e2e832e0b1e7b5994681b621b00c1e65f577ee4b440ef95fa07db9bb3d50269",
+   *     index: 0,
+   *   },
+   *   {
+   *     codeHash: "0xcc9dc33ef234e14bc788c43a4848556a5fb16401a04662fc55db9bb201987037",
+   *     hashType: "type",
+   *     args: "0x71fd1985b2971a9903e4d8ed0d59e6710166985217ca0681437883837b86162f"
+   *   },
+   * );
+   *
+   * const { res: tx } = await udtTrait.transfer(
+   *   signer,
+   *   [{ to, amount: 100 }],
+   * );
+   *
+   * const completedTx = udt.completeUdtBy(tx, signer);
+   * await completedTx.completeInputsByCapacity(signer);
+   * await completedTx.completeFeeBy(signer);
+   * const transferTxHash = await signer.sendTransaction(completedTx);
+   * ```
+   */
+  transfer(signer: ccc.Signer, transfers: {
+    to: ccc.ScriptLike;
+    amount: ccc.NumLike;
+  }[], tx?: ccc.TransactionLike | null): Promise<ssri.ExecutorResponse<ccc.Transaction>>;
+  /**
+   * Mints new tokens to specified addresses. See the example in `transfer` as they are similar.
+   * @param signer - The signer to use for the transaction.
+   * @param mints - Array of mints
+   * @param mints.to - receiver of token
+   * @param mints.amount - amount to the receiver
+   * @param tx - Optional existing transaction to build upon
+   * @returns The transaction containing the mint operation
+   * @tag Mutation - This method represents a mutation of the onchain state
+   */
+  mint(signer: ccc.Signer, mints: {
+    to: ccc.ScriptLike;
+    amount: ccc.NumLike;
+  }[], tx?: ccc.TransactionLike | null): Promise<ssri.ExecutorResponse<ccc.Transaction>>;
+  /**
+   * Completes a UDT transaction by adding change output to a specific lock script.
+   * @param txLike - The transaction to complete.
+   * @param signer - The signer to use for input selection.
+   * @param change - The lock script for the change output.
+   * @returns The completed transaction.
+   */
+  completeChangeToLock(txLike: ccc.TransactionLike, signer: ccc.Signer, change: ccc.ScriptLike): Promise<ccc.Transaction>;
+  /**
+   * Completes a UDT transaction by adding change output to the signer's address.
+   * @param tx - The transaction to complete.
+   * @param from - The signer to use for input selection and change address.
+   * @returns The completed transaction.
+   */
+  completeBy(tx: ccc.TransactionLike, from: ccc.Signer): Promise<ccc.Transaction>;
+}
+//#endregion
+//#region src/udtPausable/index.d.ts
+/**
+ * Represents a UDT (User Defined Token) with pausable functionality.
+ * @extends {Udt} This must be a SSRI UDT that does not fallback to xUDT.
+ * @public
+ */
+declare class UdtPausable extends Udt {
+  constructor(code: ccc.OutPointLike, script: ccc.ScriptLike, config: {
+    executor: ssri.Executor;
+  });
+  /**
+   * Pauses the UDT for the specified lock scripts. Pausing/Unpause without lock scripts should take effect on the global level. Note that this method is only available if the pausable UDT uses external pause list.
+   * @param signer - The signer to use for the transaction.
+   * @param locks - The array of lock scripts to be paused.
+   * @param tx - The transaction to be used.
+   * @param extraLockHashes - Additional lock hashes to be paused.
+   * @returns The transaction result.
+   * @tag Mutation - This method represents a mutation of the onchain state and will return a transaction to be sent.
+   */
+  pause(signer: ccc.Signer, locks: ccc.ScriptLike[], tx?: ccc.TransactionLike | null, extraLockHashes?: ccc.HexLike[] | null): Promise<ssri.ExecutorResponse<ccc.Transaction>>;
+  /**
+   * Unpauses the UDT for the specified lock scripts. Note that this method is only available if the pausable UDT uses external pause list.
+   * @param signer - The signer to use for the transaction.
+   * @param locks - The array of lock scripts to be unpaused.
+   * @param tx - The transaction to be used.
+   * @param extraLockHashes - Additional lock hashes to be unpaused.
+   * @returns The transaction result.
+   * @tag Mutation - This method represents a mutation of the onchain state and will return a transaction to be sent.
+   */
+  unpause(signer: ccc.Signer, locks: ccc.ScriptLike[], tx?: ccc.TransactionLike | null, extraLockHashes?: ccc.HexLike[] | null): Promise<ssri.ExecutorResponse<ccc.Transaction>>;
+  /**
+   * Checks if the UDT is paused for the specified lock scripts within a transaction. If not using external pause list, it can also be run on Code environment level.
+   * @param locks - The lock scripts to check.
+   * @param extraLockHashes - Additional lock hashes to check.
+   * @returns True if any of the lock scripts are paused, false otherwise.
+   */
+  isPaused(locks: ccc.ScriptLike[], extraLockHashes?: ccc.HexLike[] | null): Promise<ssri.ExecutorResponse<boolean[]>>;
+  /**
+   * Enumerates all paused lock hashes in UDTPausableData.
+   * @returns The array of lock hashes.
+   */
+  enumeratePaused(offset?: ccc.Num, limit?: ccc.Num): Promise<ssri.ExecutorResponse<ccc.Hex[]>>;
+}
+declare namespace barrel_d_exports {
+  export { Udt, UdtPausable };
+}
+//#endregion
+export { Udt, UdtPausable, barrel_d_exports as t };
 //# sourceMappingURL=barrel.d.ts.map

package/dist.commonjs/barrel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"barrel.d.ts","sourceRoot":"","sources":["../src/barrel.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"barrel.d.ts","names":[],"sources":["../src/udt/index.ts","../src/udtPausable/index.ts","../src/barrel.ts"],"mappings":";;;;;;;;;;;;;;;;;cAca,GAAA,SAAY,IAAA,CAAK,KAAA;EAAA,SACZ,MAAA,EAAQ,GAAA,CAAI,MAAA;;;;;;;AAD9B;;;;;;;cAiBI,IAAA,EAAM,GAAA,CAAI,YAAA,EACV,MAAA,EAAQ,GAAA,CAAI,UAAA,EACZ,MAAA;IACE,QAAA,GAAW,IAAA,CAAK,QAAA;EAAA;EAmCR;;;;;;EAtBN,IAAA,CACJ,OAAA,GAAU,IAAA,CAAK,aAAA,GACd,OAAA,CAAQ,IAAA,CAAK,gBAAA;EAwEJ;;;;;EArDN,MAAA,CACJ,OAAA,GAAU,IAAA,CAAK,aAAA,GACd,OAAA,CAAQ,IAAA,CAAK,gBAAA;EA6GT;;;;;EArFD,QAAA,CACJ,OAAA,GAAU,IAAA,CAAK,aAAA,GACd,OAAA,CAAQ,IAAA,CAAK,gBAAA,CAAiB,GAAA,CAAI,GAAA;EA6IzB;;;;;EArHN,IAAA,CACJ,OAAA,GAAU,IAAA,CAAK,aAAA,GACd,OAAA,CAAQ,IAAA,CAAK,gBAAA;EA0KN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAvHJ,QAAA,CACJ,MAAA,EAAQ,GAAA,CAAI,MAAA,EACZ,SAAA;IACE,EAAA,EAAI,GAAA,CAAI,UAAA;IACR,MAAA,EAAQ,GAAA,CAAI,OAAA;EAAA,KAEd,EAAA,GAAK,GAAA,CAAI,eAAA,UACR,OAAA,CAAQ,IAAA,CAAK,gBAAA,CAAiB,GAAA,CAAI,WAAA;EAtF/B;;;;;;;;;;EA2IA,IAAA,CACJ,MAAA,EAAQ,GAAA,CAAI,MAAA,EACZ,KAAA;IACE,EAAA,EAAI,GAAA,CAAI,UAAA;IACR,MAAA,EAAQ,GAAA,CAAI,OAAA;EAAA,KAEd,EAAA,GAAK,GAAA,CAAI,eAAA,UACR,OAAA,CAAQ,IAAA,CAAK,gBAAA,CAAiB,GAAA,CAAI,WAAA;EAtH1B;;;;;;;EAwKL,oBAAA,CACJ,MAAA,EAAQ,GAAA,CAAI,eAAA,EACZ,MAAA,EAAQ,GAAA,CAAI,MAAA,EACZ,MAAA,EAAQ,GAAA,CAAI,UAAA,GAAU,OAAA,CAAA,GAAA,CAAA,WAAA;EArHZ;;;;;;EAgJN,UAAA,CAAW,EAAA,EAAI,GAAA,CAAI,eAAA,EAAiB,IAAA,EAAM,GAAA,CAAI,MAAA,GAAM,OAAA,CAAA,GAAA,CAAA,WAAA;AAAA;;;;;;;;cCvT/C,WAAA,SAAoB,GAAA;cAE7B,IAAA,EAAM,GAAA,CAAI,YAAA,EACV,MAAA,EAAQ,GAAA,CAAI,UAAA,EACZ,MAAA;IACE,QAAA,EAAU,IAAA,CAAK,QAAA;EAAA;;;;;;;;;;EAeb,KAAA,CACJ,MAAA,EAAQ,GAAA,CAAI,MAAA,EACZ,KAAA,EAAO,GAAA,CAAI,UAAA,IACX,EAAA,GAAK,GAAA,CAAI,eAAA,SACT,eAAA,GAAkB,GAAA,CAAI,OAAA,YACrB,OAAA,CAAQ,IAAA,CAAK,gBAAA,CAAiB,GAAA,CAAI,WAAA;EDpBtB;;;;;;;;;ECsDT,OAAA,CACJ,MAAA,EAAQ,GAAA,CAAI,MAAA,EACZ,KAAA,EAAO,GAAA,CAAI,UAAA,IACX,EAAA,GAAK,GAAA,CAAI,eAAA,SACT,eAAA,GAAkB,GAAA,CAAI,OAAA,YACrB,OAAA,CAAQ,IAAA,CAAK,gBAAA,CAAiB,GAAA,CAAI,WAAA;EDH1B;;;;;;ECkCL,QAAA,CACJ,KAAA,EAAO,GAAA,CAAI,UAAA,IACX,eAAA,GAAkB,GAAA,CAAI,OAAA,YACrB,OAAA,CAAQ,IAAA,CAAK,gBAAA;EDeL;;;;ECKL,eAAA,CACJ,MAAA,GAAS,GAAA,CAAI,GAAA,EACb,KAAA,GAAQ,GAAA,CAAI,GAAA,GACX,OAAA,CAAQ,IAAA,CAAK,gBAAA,CAAiB,GAAA,CAAI,GAAA;AAAA;AAAA"}

package/dist.commonjs/barrel.js

@@ -1,18 +1,2 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./udt/index.js"), exports);
-__exportStar(require("./udtPausable/index.js"), exports);
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.defineProperty,t=(t,n)=>{let r={};for(var i in t)e(r,i,{get:t[i],enumerable:!0});return n||e(r,Symbol.toStringTag,{value:`Module`}),r};let n=require("@ckb-ccc/core"),r=require("@ckb-ccc/ssri");var i=class extends r.ssri.Trait{constructor(e,t,r){super(e,r?.executor),this.script=n.ccc.Script.from(t)}async name(e){if(this.executor){let t=await this.executor.runScriptTry(this.code,`UDT.name`,[],{script:this.script,...e});if(t)return t.map(e=>n.ccc.bytesTo(e,`utf8`))}return r.ssri.ExecutorResponse.new(void 0)}async symbol(e){if(this.executor){let t=await this.executor.runScriptTry(this.code,`UDT.symbol`,[],{script:this.script,...e});if(t)return t.map(e=>n.ccc.bytesTo(e,`utf8`))}return r.ssri.ExecutorResponse.new(void 0)}async decimals(e){if(this.executor){let t=await this.executor.runScriptTry(this.code,`UDT.decimals`,[],{script:this.script,...e});if(t)return t.map(e=>n.ccc.numFromBytes(e))}return r.ssri.ExecutorResponse.new(void 0)}async icon(e){if(this.executor){let t=await this.executor.runScriptTry(this.code,`UDT.icon`,[],{script:this.script,...e});if(t)return t.map(e=>n.ccc.bytesTo(e,`utf8`))}return r.ssri.ExecutorResponse.new(void 0)}async transfer(e,t,i){let a;if(this.executor){let r=n.ccc.Transaction.from(i??{});await r.completeInputsAtLeastOne(e);let o=await this.executor.runScriptTry(this.code,`UDT.transfer`,[r.toBytes(),n.ccc.ScriptVec.encode(t.map(({to:e})=>e)),n.ccc.mol.Uint128Vec.encode(t.map(({amount:e})=>e))],{script:this.script});o&&(a=o.map(e=>n.ccc.Transaction.fromBytes(e)))}if(!a){let e=n.ccc.Transaction.from(i??{});for(let{to:r,amount:i}of t)e.addOutput({lock:r,type:this.script},n.ccc.numLeToBytes(i,16));a=r.ssri.ExecutorResponse.new(e)}return a.res.addCellDeps({outPoint:this.code,depType:`code`}),a}async mint(e,t,i){let a;if(this.executor){let r=n.ccc.Transaction.from(i??{});await r.completeInputsAtLeastOne(e);let o=await this.executor.runScriptTry(this.code,`UDT.mint`,[r.toBytes(),n.ccc.ScriptVec.encode(t.map(({to:e})=>e)),n.ccc.mol.Uint128Vec.encode(t.map(({amount:e})=>e))],{script:this.script});o&&(a=o.map(e=>n.ccc.Transaction.fromBytes(e)))}if(!a){let e=n.ccc.Transaction.from(i??{});for(let{to:r,amount:i}of t)e.addOutput({lock:r,type:this.script},n.ccc.numLeToBytes(i,16));a=r.ssri.ExecutorResponse.new(e)}return a.res.addCellDeps({outPoint:this.code,depType:`code`}),a}async completeChangeToLock(e,t,r){let i=n.ccc.Transaction.from(e);await i.completeInputsByUdt(t,this.script);let a=await i.getInputsUdtBalance(t.client,this.script)-i.getOutputsUdtBalance(this.script);return a>n.ccc.Zero&&i.addOutput({lock:r,type:this.script},n.ccc.numLeToBytes(a,16)),i}async completeBy(e,t){let{script:n}=await t.getRecommendedAddressObj();return this.completeChangeToLock(e,t,n)}},a=class extends i{constructor(e,t,n){super(e,t,n)}async pause(e,t,r,i){let a=n.ccc.Transaction.from(r??{});await a.completeInputsAtLeastOne(e);let o=(await this.assertExecutor().runScript(this.code,`UDTPausable.pause`,[a.toBytes(),n.ccc.mol.Byte32Vec.encode(t.map(e=>n.ccc.Script.from(e).hash()).concat(i?.map(n.ccc.hexFrom)??[]))],{script:this.script})).map(e=>n.ccc.Transaction.fromBytes(e));return o.res.addCellDeps({outPoint:this.code,depType:`code`}),o}async unpause(e,t,r,i){let a=n.ccc.Transaction.from(r??{});await a.completeInputsAtLeastOne(e);let o=(await this.assertExecutor().runScript(this.code,`UDTPausable.unpause`,[a.toBytes(),n.ccc.mol.Byte32Vec.encode(t.map(e=>n.ccc.Script.from(e).hash()).concat(i?.map(n.ccc.hexFrom)??[]))],{script:this.script})).map(e=>n.ccc.Transaction.fromBytes(e));return o.res.addCellDeps({outPoint:this.code,depType:`code`}),o}async isPaused(e,t){return(await this.assertExecutor().runScript(this.code,`UDTPausable.is_paused`,[n.ccc.mol.Byte32Vec.encode(e.map(e=>n.ccc.Script.from(e).hash()).concat(t?.map(n.ccc.hexFrom)??[]))],{script:this.script})).map(e=>n.ccc.mol.BoolVec.decode(e))}async enumeratePaused(e,t){return(await this.assertExecutor().runScript(this.code,`UDTPausable.enumerate_paused`,[n.ccc.numToBytes(e??0,8),n.ccc.numToBytes(t??0,8)],{script:this.script})).map(e=>n.ccc.mol.Byte32Vec.decode(e))}},o=t({Udt:()=>i,UdtPausable:()=>a});exports.Udt=i,exports.UdtPausable=a,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return o}});
+//# sourceMappingURL=barrel.js.map

package/dist.commonjs/barrel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"barrel.js","names":["ssri","ccc","ccc"],"sources":["../src/udt/index.ts","../src/udtPausable/index.ts","../src/barrel.ts"],"sourcesContent":["import { ccc } from \"@ckb-ccc/core\";\nimport { ssri } from \"@ckb-ccc/ssri\";\n\n/**\n * Represents a User Defined Token (UDT) script compliant with the SSRI protocol.\n *\n * This class provides a comprehensive implementation for interacting with User Defined Tokens,\n * supporting various token operations such as querying metadata, checking balances, and performing transfers.\n * It supports both SSRI-compliant UDTs and legacy sUDT/xUDT standard tokens.\n *\n * @public\n * @category Blockchain\n * @category Token\n */\nexport class Udt extends ssri.Trait {\n  public readonly script: ccc.Script;\n\n  /**\n   * Constructs a new UDT (User Defined Token) script instance.\n   * By default it is a SSRI-compliant UDT.\n   *\n   * @param code - The script code cell of the UDT.\n   * @param script - The type script of the UDT.\n   * @param config - Optional configuration for the UDT instance.\n   * @param config.executor - The SSRI executor instance. If provided, enables SSRI-based operations.\n   * @example\n   * ```typescript\n   * const udt = new Udt(code, script, { executor });\n   * ```\n   */\n  constructor(\n    code: ccc.OutPointLike,\n    script: ccc.ScriptLike,\n    config?: {\n      executor?: ssri.Executor | null;\n    } | null,\n  ) {\n    super(code, config?.executor);\n    this.script = ccc.Script.from(script);\n  }\n\n  /**\n   * Retrieves the human-readable name of the User Defined Token.\n   *\n   * @param context - Optional SSRI context for script execution.\n   * @returns A promise resolving to the token's name.\n   */\n  async name(\n    context?: ssri.ContextScript,\n  ): Promise<ssri.ExecutorResponse<string | undefined>> {\n    if (this.executor) {\n      const res = await this.executor.runScriptTry(this.code, \"UDT.name\", [], {\n        script: this.script,\n        ...context,\n      });\n      if (res) {\n        return res.map((res) => ccc.bytesTo(res, \"utf8\"));\n      }\n    }\n\n    return ssri.ExecutorResponse.new(undefined);\n  }\n\n  /**\n   * Retrieves the symbol of the UDT.\n   * @param context - Optional SSRI context for script execution.\n   * @returns The symbol of the UDT.\n   */\n  async symbol(\n    context?: ssri.ContextScript,\n  ): Promise<ssri.ExecutorResponse<string | undefined>> {\n    if (this.executor) {\n      const res = await this.executor.runScriptTry(\n        this.code,\n        \"UDT.symbol\",\n        [],\n        {\n          script: this.script,\n          ...context,\n        },\n      );\n      if (res) {\n        return res.map((res) => ccc.bytesTo(res, \"utf8\"));\n      }\n    }\n\n    return ssri.ExecutorResponse.new(undefined);\n  }\n\n  /**\n   * Retrieves the decimals of the UDT.\n   * @param context - Optional SSRI context for script execution.\n   * @returns The decimals of the UDT.\n   */\n  async decimals(\n    context?: ssri.ContextScript,\n  ): Promise<ssri.ExecutorResponse<ccc.Num | undefined>> {\n    if (this.executor) {\n      const res = await this.executor.runScriptTry(\n        this.code,\n        \"UDT.decimals\",\n        [],\n        {\n          script: this.script,\n          ...context,\n        },\n      );\n      if (res) {\n        return res.map((res) => ccc.numFromBytes(res));\n      }\n    }\n\n    return ssri.ExecutorResponse.new(undefined);\n  }\n\n  /**\n   * Retrieves the icon of the UDT.\n   * @param context - Optional SSRI context for script execution.\n   * @returns The icon of the UDT.\n   */\n  async icon(\n    context?: ssri.ContextScript,\n  ): Promise<ssri.ExecutorResponse<string | undefined>> {\n    if (this.executor) {\n      const res = await this.executor.runScriptTry(this.code, \"UDT.icon\", [], {\n        script: this.script,\n        ...context,\n      });\n      if (res) {\n        return res.map((res) => ccc.bytesTo(res, \"utf8\"));\n      }\n    }\n\n    return ssri.ExecutorResponse.new(undefined);\n  }\n\n  /**\n   * Transfers UDT to specified addresses.\n   * @param signer - The signer to use for the transaction.\n   * @param transfers - The array of transfers.\n   * @param transfers.to - The receiver of token.\n   * @param transfers.amount - The amount of token to the receiver.\n   * @param tx - Transfer on the basis of an existing transaction to achieve combined actions. If not provided, a new transaction will be created.\n   * @returns The transaction result.\n   * @tag Mutation - This method represents a mutation of the onchain state and will return a transaction object.\n   * @example\n   * ```typescript\n   * const { script: change } = await signer.getRecommendedAddressObj();\n   * const { script: to } = await ccc.Address.fromString(receiver, signer.client);\n   *\n   * const udt = new Udt(\n   *   {\n   *     txHash: \"0x4e2e832e0b1e7b5994681b621b00c1e65f577ee4b440ef95fa07db9bb3d50269\",\n   *     index: 0,\n   *   },\n   *   {\n   *     codeHash: \"0xcc9dc33ef234e14bc788c43a4848556a5fb16401a04662fc55db9bb201987037\",\n   *     hashType: \"type\",\n   *     args: \"0x71fd1985b2971a9903e4d8ed0d59e6710166985217ca0681437883837b86162f\"\n   *   },\n   * );\n   *\n   * const { res: tx } = await udtTrait.transfer(\n   *   signer,\n   *   [{ to, amount: 100 }],\n   * );\n   *\n   * const completedTx = udt.completeUdtBy(tx, signer);\n   * await completedTx.completeInputsByCapacity(signer);\n   * await completedTx.completeFeeBy(signer);\n   * const transferTxHash = await signer.sendTransaction(completedTx);\n   * ```\n   */\n  async transfer(\n    signer: ccc.Signer,\n    transfers: {\n      to: ccc.ScriptLike;\n      amount: ccc.NumLike;\n    }[],\n    tx?: ccc.TransactionLike | null,\n  ): Promise<ssri.ExecutorResponse<ccc.Transaction>> {\n    let resTx;\n    if (this.executor) {\n      const txReq = ccc.Transaction.from(tx ?? {});\n      await txReq.completeInputsAtLeastOne(signer);\n\n      const res = await this.executor.runScriptTry(\n        this.code,\n        \"UDT.transfer\",\n        [\n          txReq.toBytes(),\n          ccc.ScriptVec.encode(transfers.map(({ to }) => to)),\n          ccc.mol.Uint128Vec.encode(transfers.map(({ amount }) => amount)),\n        ],\n        {\n          script: this.script,\n        },\n      );\n      if (res) {\n        resTx = res.map((res) => ccc.Transaction.fromBytes(res));\n      }\n    }\n\n    if (!resTx) {\n      const transfer = ccc.Transaction.from(tx ?? {});\n      for (const { to, amount } of transfers) {\n        transfer.addOutput(\n          {\n            lock: to,\n            type: this.script,\n          },\n          ccc.numLeToBytes(amount, 16),\n        );\n      }\n      resTx = ssri.ExecutorResponse.new(transfer);\n    }\n    resTx.res.addCellDeps({\n      outPoint: this.code,\n      depType: \"code\",\n    });\n    return resTx;\n  }\n\n  /**\n   * Mints new tokens to specified addresses. See the example in `transfer` as they are similar.\n   * @param signer - The signer to use for the transaction.\n   * @param mints - Array of mints\n   * @param mints.to - receiver of token\n   * @param mints.amount - amount to the receiver\n   * @param tx - Optional existing transaction to build upon\n   * @returns The transaction containing the mint operation\n   * @tag Mutation - This method represents a mutation of the onchain state\n   */\n  async mint(\n    signer: ccc.Signer,\n    mints: {\n      to: ccc.ScriptLike;\n      amount: ccc.NumLike;\n    }[],\n    tx?: ccc.TransactionLike | null,\n  ): Promise<ssri.ExecutorResponse<ccc.Transaction>> {\n    let resTx;\n    if (this.executor) {\n      const txReq = ccc.Transaction.from(tx ?? {});\n      await txReq.completeInputsAtLeastOne(signer);\n\n      const res = await this.executor.runScriptTry(\n        this.code,\n        \"UDT.mint\",\n        [\n          txReq.toBytes(),\n          ccc.ScriptVec.encode(mints.map(({ to }) => to)),\n          ccc.mol.Uint128Vec.encode(mints.map(({ amount }) => amount)),\n        ],\n        {\n          script: this.script,\n        },\n      );\n      if (res) {\n        resTx = res.map((res) => ccc.Transaction.fromBytes(res));\n      }\n    }\n\n    if (!resTx) {\n      const mint = ccc.Transaction.from(tx ?? {});\n      for (const { to, amount } of mints) {\n        mint.addOutput(\n          {\n            lock: to,\n            type: this.script,\n          },\n          ccc.numLeToBytes(amount, 16),\n        );\n      }\n      resTx = ssri.ExecutorResponse.new(mint);\n    }\n    resTx.res.addCellDeps({\n      outPoint: this.code,\n      depType: \"code\",\n    });\n    return resTx;\n  }\n\n  /**\n   * Completes a UDT transaction by adding change output to a specific lock script.\n   * @param txLike - The transaction to complete.\n   * @param signer - The signer to use for input selection.\n   * @param change - The lock script for the change output.\n   * @returns The completed transaction.\n   */\n  async completeChangeToLock(\n    txLike: ccc.TransactionLike,\n    signer: ccc.Signer,\n    change: ccc.ScriptLike,\n  ) {\n    const tx = ccc.Transaction.from(txLike);\n\n    await tx.completeInputsByUdt(signer, this.script);\n    const balanceDiff =\n      (await tx.getInputsUdtBalance(signer.client, this.script)) -\n      tx.getOutputsUdtBalance(this.script);\n    if (balanceDiff > ccc.Zero) {\n      tx.addOutput(\n        {\n          lock: change,\n          type: this.script,\n        },\n        ccc.numLeToBytes(balanceDiff, 16),\n      );\n    }\n\n    return tx;\n  }\n\n  /**\n   * Completes a UDT transaction by adding change output to the signer's address.\n   * @param tx - The transaction to complete.\n   * @param from - The signer to use for input selection and change address.\n   * @returns The completed transaction.\n   */\n  async completeBy(tx: ccc.TransactionLike, from: ccc.Signer) {\n    const { script } = await from.getRecommendedAddressObj();\n\n    return this.completeChangeToLock(tx, from, script);\n  }\n}\n","import { ccc } from \"@ckb-ccc/core\";\nimport { ssri } from \"@ckb-ccc/ssri\";\nimport { Udt } from \"../udt/index.js\";\n\n/**\n * Represents a UDT (User Defined Token) with pausable functionality.\n * @extends {Udt} This must be a SSRI UDT that does not fallback to xUDT.\n * @public\n */\nexport class UdtPausable extends Udt {\n  constructor(\n    code: ccc.OutPointLike,\n    script: ccc.ScriptLike,\n    config: {\n      executor: ssri.Executor;\n    },\n  ) {\n    super(code, script, config);\n  }\n\n  /**\n   * Pauses the UDT for the specified lock scripts. Pausing/Unpause without lock scripts should take effect on the global level. Note that this method is only available if the pausable UDT uses external pause list.\n   * @param signer - The signer to use for the transaction.\n   * @param locks - The array of lock scripts to be paused.\n   * @param tx - The transaction to be used.\n   * @param extraLockHashes - Additional lock hashes to be paused.\n   * @returns The transaction result.\n   * @tag Mutation - This method represents a mutation of the onchain state and will return a transaction to be sent.\n   */\n  async pause(\n    signer: ccc.Signer,\n    locks: ccc.ScriptLike[],\n    tx?: ccc.TransactionLike | null,\n    extraLockHashes?: ccc.HexLike[] | null,\n  ): Promise<ssri.ExecutorResponse<ccc.Transaction>> {\n    const txReq = ccc.Transaction.from(tx ?? {});\n    await txReq.completeInputsAtLeastOne(signer);\n\n    const res = await this.assertExecutor().runScript(\n      this.code,\n      \"UDTPausable.pause\",\n      [\n        txReq.toBytes(),\n        ccc.mol.Byte32Vec.encode(\n          locks\n            .map((l) => ccc.Script.from(l).hash())\n            .concat(extraLockHashes?.map(ccc.hexFrom) ?? []),\n        ),\n      ],\n      { script: this.script },\n    );\n    const resTx = res.map((res) => ccc.Transaction.fromBytes(res));\n    resTx.res.addCellDeps({\n      outPoint: this.code,\n      depType: \"code\",\n    });\n    return resTx;\n  }\n\n  /**\n   * Unpauses the UDT for the specified lock scripts. Note that this method is only available if the pausable UDT uses external pause list.\n   * @param signer - The signer to use for the transaction.\n   * @param locks - The array of lock scripts to be unpaused.\n   * @param tx - The transaction to be used.\n   * @param extraLockHashes - Additional lock hashes to be unpaused.\n   * @returns The transaction result.\n   * @tag Mutation - This method represents a mutation of the onchain state and will return a transaction to be sent.\n   */\n  async unpause(\n    signer: ccc.Signer,\n    locks: ccc.ScriptLike[],\n    tx?: ccc.TransactionLike | null,\n    extraLockHashes?: ccc.HexLike[] | null,\n  ): Promise<ssri.ExecutorResponse<ccc.Transaction>> {\n    const txReq = ccc.Transaction.from(tx ?? {});\n    await txReq.completeInputsAtLeastOne(signer);\n\n    const res = await this.assertExecutor().runScript(\n      this.code,\n      \"UDTPausable.unpause\",\n      [\n        txReq.toBytes(),\n        ccc.mol.Byte32Vec.encode(\n          locks\n            .map((l) => ccc.Script.from(l).hash())\n            .concat(extraLockHashes?.map(ccc.hexFrom) ?? []),\n        ),\n      ],\n      { script: this.script },\n    );\n    const resTx = res.map((res) => ccc.Transaction.fromBytes(res));\n    resTx.res.addCellDeps({\n      outPoint: this.code,\n      depType: \"code\",\n    });\n    return resTx;\n  }\n\n  /**\n   * Checks if the UDT is paused for the specified lock scripts within a transaction. If not using external pause list, it can also be run on Code environment level.\n   * @param locks - The lock scripts to check.\n   * @param extraLockHashes - Additional lock hashes to check.\n   * @returns True if any of the lock scripts are paused, false otherwise.\n   */\n  async isPaused(\n    locks: ccc.ScriptLike[],\n    extraLockHashes?: ccc.HexLike[] | null,\n  ): Promise<ssri.ExecutorResponse<boolean[]>> {\n    const res = await this.assertExecutor().runScript(\n      this.code,\n      \"UDTPausable.is_paused\",\n      [\n        ccc.mol.Byte32Vec.encode(\n          locks\n            .map((l) => ccc.Script.from(l).hash())\n            .concat(extraLockHashes?.map(ccc.hexFrom) ?? []),\n        ),\n      ],\n      { script: this.script },\n    );\n    return res.map((res) => ccc.mol.BoolVec.decode(res));\n  }\n\n  /**\n   * Enumerates all paused lock hashes in UDTPausableData.\n   * @returns The array of lock hashes.\n   */\n  async enumeratePaused(\n    offset?: ccc.Num,\n    limit?: ccc.Num,\n  ): Promise<ssri.ExecutorResponse<ccc.Hex[]>> {\n    const res = await this.assertExecutor().runScript(\n      this.code,\n      \"UDTPausable.enumerate_paused\",\n      [ccc.numToBytes(offset ?? 0, 8), ccc.numToBytes(limit ?? 0, 8)],\n      { script: this.script },\n    );\n\n    return res.map((res) => ccc.mol.Byte32Vec.decode(res));\n  }\n}\n","export * from \"./udt/index.js\";\nexport * from \"./udtPausable/index.js\";\n"],"mappings":"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"}

package/dist.commonjs/index.d.ts

@@ -1,3 +1,2 @@
-export * from "./barrel.js";
-export * as udt from "./barrel.js";
-//# sourceMappingURL=index.d.ts.map
+import { Udt, UdtPausable, t as barrel_d_exports } from "./barrel.js";
+export { Udt, UdtPausable, barrel_d_exports as udt };

package/dist.commonjs/index.js

@@ -1,41 +1 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.udt = void 0;
-__exportStar(require("./barrel.js"), exports);
-exports.udt = __importStar(require("./barrel.js"));
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./barrel.js");exports.Udt=e.Udt,exports.UdtPausable=e.UdtPausable,Object.defineProperty(exports,"udt",{enumerable:!0,get:function(){return e.t}});