@layerzerolabs/oft-sui-sdk-v2 0.0.0-stage → 1.2.104

package/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2026 - LayerZero Labs Ltd.
+
+Permission is hereby granted, free of charge, to any
+person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the
+Software without restriction, including without
+limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following
+conditions:
+The above copyright notice and this permission notice
+shall be included in all copies or substantial portions
+of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,173 @@
-# Temporary Holding Version
+# @layerzerolabs/oft-sui-sdk-v2
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+LayerZero V2 SUI OFT (Omnichain Fungible Token) SDK
+
+## Overview
+
+This SDK provides TypeScript bindings for interacting with LayerZero V2 OFT contracts on the SUI blockchain. It enables developers to create, manage, and transfer omnichain fungible tokens across different blockchains using the LayerZero protocol.
+
+## Installation
+
+```bash
+npm install @layerzerolabs/oft-sui-sdk-v2
+# or
+yarn add @layerzerolabs/oft-sui-sdk-v2
+# or
+pnpm add @layerzerolabs/oft-sui-sdk-v2
+```
+
+The package is ESM only. It replaces `@layerzerolabs/lz-sui-oft-sdk-v2`, which also shipped a CommonJS build. CommonJS code can `require` it only on Node versions with `require(esm)` (20.19+ or 22.12+). Otherwise, use `import` or a dynamic `import()`.
+
+TypeScript consumers need `moduleResolution: bundler`. Under `node16` or `nodenext`, the package's type declarations do not resolve.
+
+The package uses `@mysten/sui` 2.x and does not depend on `@layerzerolabs/lz-sui-sdk-v2`. It brings its own client for the LayerZero endpoint send path, `SuiProtocolSDK`. Pass it any 2.x client (`SuiGrpcClient`, `SuiJsonRpcClient` or `SuiGraphQLClient`). For `@mysten/sui` 1.x, use `@layerzerolabs/oft-sui-sdk`, which keeps the 1.x API and depends on `lz-sui-sdk-v2`.
+
+`sendMoveCall` takes the native fee with `tx.coin()`. If the sender's address balance covers the fee, the fee is withdrawn from the address balance, so parallel sends from one account do not compete for the gas coin. Otherwise it is split from the gas coin, as before.
+
+## Features
+
+- **Cross-chain Transfers**: Send tokens across different blockchains
+- **OFT & OFT Adapter**: Interact with deployed OFT & OFT Adapter
+- **OFT Composer Manager**: Advanced composition functionality for complex cross-chain operations
+
+## Usage
+
+### Initialize OFT
+
+Create a new OFT that mints/burns tokens for cross-chain transfers:
+
+```typescript
+import { OFT, SuiProtocolSDK } from '@layerzerolabs/oft-sui-sdk-v2';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
+import { Transaction } from '@mysten/sui/transactions';
+
+const suiClient = new SuiGrpcClient({
+    network: 'mainnet',
+    baseUrl: 'https://fullnode.mainnet.sui.io:443',
+});
+
+// Initialize LayerZero protocol SDK
+const protocolSDK = new SuiProtocolSDK({
+    client: suiClient,
+    stage: 'mainnet',
+});
+
+// Create OFT instance with its call cap ID and coin type
+const oft = new OFT(protocolSDK, oftCallCapId, undefined, coinType);
+
+// Initialize OFT with treasury capability (for minting/burning)
+const initTx = new Transaction();
+const [adminCap, migrationCap] = oft.initOftMoveCall(
+    initTx,
+    coinType, // e.g., "0x123::my_coin::MY_COIN"
+    oftInitTicketId, // OFT creation ticket
+    oappObjectId, // Associated OApp object
+    treasuryCapId, // Treasury cap for minting/burning
+    metadataId, // Coin metadata
+    6, // Shared decimals for cross-chain compatibility
+);
+
+// Transfer capabilities to your address
+initTx.transferObjects([adminCap, migrationCap], initTx.pure.address(yourAddress));
+
+// Execute the transaction
+const result = await suiClient.signAndExecuteTransaction({ transaction: initTx, signer });
+```
+
+### Initialize OFT Adapter
+
+Create an OFT Adapter that wraps existing tokens:
+
+```typescript
+// Initialize OFT Adapter (wraps existing tokens without minting/burning)
+const adapterTx = new Transaction();
+const [adminCap, migrationCap] = oft.initOftAdapterMoveCall(
+    adapterTx,
+    coinType, // e.g., "0x123::my_coin::MY_COIN"
+    oftInitTicketId, // OFT creation ticket
+    oappObjectId, // Associated OApp object
+    metadataId, // Coin metadata
+    6, // Shared decimals for cross-chain compatibility
+);
+
+// Transfer capabilities to your address
+adapterTx.transferObjects([adminCap, migrationCap], adapterTx.pure.address(yourAddress));
+
+// Execute the transaction
+const result = await suiClient.signAndExecuteTransaction({ transaction: adapterTx, signer });
+```
+
+### Register OFT with LayerZero Endpoint
+
+```typescript
+// Register the OFT as an OApp with the LayerZero endpoint
+const registerTx = new Transaction();
+
+await oft.registerOAppMoveCall(
+    registerTx,
+    coinType, // Coin type
+    oftObjectId, // Created OFT object ID
+    oappObjectId, // Associated OApp object ID
+    composerManagerId, // OFT Composer Manager for handling compose messages
+);
+
+// Execute the transaction
+const result = await suiClient.signAndExecuteTransaction({ transaction: registerTx, signer });
+```
+
+### Set Peer for Cross-Chain Communication
+
+OApp configuration (peers, libraries, enforced options) is not part of this package. Use the OApp tooling for it.
+
+### Quote and Send Tokens
+
+```typescript
+// Create OFT instance with its OFT object ID and coin type
+const oft = new OFT(protocolSDK, oftCallCapId, oftObjectId, coinType);
+
+// Prepare send parameters
+const sendParam = {
+    dstEid: 30102, // Destination endpoint ID
+    to: recipientAddressBytes, // Recipient address as Uint8Array (32 bytes)
+    amountLd: 1000000n, // Amount in local decimals
+    minAmountLd: 990000n, // Minimum amount (slippage protection)
+    extraOptions: new Uint8Array(0), // LayerZero execution options
+    composeMsg: new Uint8Array(0), // Optional compose message
+    oftCmd: new Uint8Array(0), // Optional OFT command (unused in default OFT)
+};
+
+// Quote the transfer fees
+const messagingFee = await oft.quoteSend(
+    senderAddress,
+    sendParam,
+    false, // payInZro: false = pay in native token
+);
+
+// Execute the transfer
+const tx = new Transaction();
+
+// Take the amount from the sender's address balance or coins
+const coin = tx.coin({ type: coinType, balance: sendParam.amountLd });
+
+// Send the tokens
+await oft.sendMoveCall(
+    tx,
+    senderAddress,
+    sendParam,
+    coin,
+    messagingFee.nativeFee,
+    messagingFee.zroFee,
+    senderAddress, // refund address
+);
+
+// Transfer any remaining coins back to sender
+tx.transferObjects([coin], senderAddress);
+```
+
+## Documentation
+
+For detailed documentation and examples, please visit the [LayerZero documentation](https://docs.layerzero.network/).
+
+## License
+
+MIT

package/dist/2PVXPTJR.js

@@ -0,0 +1,57 @@
+import { OApp } from './HD4WZG6B.js';
+import { PtbBuilder } from './DUMP7ZFT.js';
+import { Utils } from './4DKNPMZP.js';
+import { Zro } from './GLVZWDOK.js';
+import { mergeDefaultPackageConfig, mergeDefaultObjectConfig } from './JUS4ARN3.js';
+import { Endpoint } from './F5PNGH74.js';
+import { __name } from './VUOMXK5T.js';
+
+// src/protocol/sdk.ts
+var SuiProtocolSDK = class {
+  static {
+    __name(this, "SuiProtocolSDK");
+  }
+  client;
+  stage;
+  packages;
+  objects;
+  #utils;
+  #zro;
+  #ptbBuilder;
+  #endpoint;
+  #oapps = /* @__PURE__ */ new Map();
+  constructor(options) {
+    this.client = options.client;
+    this.stage = options.stage ?? "mainnet";
+    this.packages = mergeDefaultPackageConfig(this.stage, options.packages);
+    this.objects = mergeDefaultObjectConfig(this.stage, options.objects);
+    this.#utils = new Utils(this.packages.utils, this.client);
+    this.#zro = new Zro(this.packages.zro, this.#utils);
+    this.#ptbBuilder = new PtbBuilder(this.packages.ptbMoveCall, this.client);
+    this.#endpoint = new Endpoint(this.client, this.packages, this.objects, this.#ptbBuilder);
+  }
+  getEndpoint() {
+    return this.#endpoint;
+  }
+  getZro() {
+    return this.#zro;
+  }
+  getUtils() {
+    return this.#utils;
+  }
+  getPtbBuilder() {
+    return this.#ptbBuilder;
+  }
+  getOApp(callCapId) {
+    let oapp = this.#oapps.get(callCapId);
+    if (oapp === void 0) {
+      oapp = new OApp(this.packages.oapp, callCapId, this.client, this.#endpoint);
+      this.#oapps.set(callCapId, oapp);
+    }
+    return oapp;
+  }
+};
+
+export { SuiProtocolSDK };
+//# sourceMappingURL=2PVXPTJR.js.map
+//# sourceMappingURL=2PVXPTJR.js.map

package/dist/2PVXPTJR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol/sdk.ts"],"names":["SuiProtocolSDK","client","stage","packages","objects","Map","options","mergeDefaultPackageConfig","mergeDefaultObjectConfig","Utils","utils","Zro","zro","PtbBuilder","ptbMoveCall","Endpoint","getEndpoint","getZro","getUtils","getPtbBuilder","getOApp","callCapId","oapp","get","undefined","OApp","set"],"mappings":";;;;;;;;;AAsBO,IAAMA,iBAAN,MAAMA;EApBb;;;AAqBaC,EAAAA,MAAAA;AACAC,EAAAA,KAAAA;AACAC,EAAAA,QAAAA;AACAC,EAAAA,OAAAA;AACA,EAAA,MAAA;AACA,EAAA,IAAA;AACA,EAAA,WAAA;AACA,EAAA,SAAA;AACA,EAAA,MAAA,uBAAaC,GAAAA,EAAAA;AAEtB,EAAA,WAAA,CAAYC,OAAAA,EAAgC;AACxC,IAAA,IAAA,CAAKL,SAASK,OAAAA,CAAQL,MAAAA;AACtB,IAAA,IAAA,CAAKC,KAAAA,GAAQI,QAAQJ,KAAAA,IAAS,SAAA;AAC9B,IAAA,IAAA,CAAKC,QAAAA,GAAWI,yBAAAA,CAA0B,IAAA,CAAKL,KAAAA,EAAOI,QAAQH,QAAQ,CAAA;AACtE,IAAA,IAAA,CAAKC,OAAAA,GAAUI,wBAAAA,CAAyB,IAAA,CAAKN,KAAAA,EAAOI,QAAQF,OAAO,CAAA;AACnE,IAAA,IAAA,CAAK,SAAS,IAAIK,KAAAA,CAAM,KAAKN,QAAAA,CAASO,KAAAA,EAAO,KAAKT,MAAM,CAAA;AACxD,IAAA,IAAA,CAAK,OAAO,IAAIU,GAAAA,CAAI,KAAKR,QAAAA,CAASS,GAAAA,EAAK,KAAK,MAAM,CAAA;AAClD,IAAA,IAAA,CAAK,cAAc,IAAIC,UAAAA,CAAW,KAAKV,QAAAA,CAASW,WAAAA,EAAa,KAAKb,MAAM,CAAA;AACxE,IAAA,IAAA,CAAK,SAAA,GAAY,IAAIc,QAAAA,CAAS,IAAA,CAAKd,MAAAA,EAAQ,KAAKE,QAAAA,EAAU,IAAA,CAAKC,OAAAA,EAAS,IAAA,CAAK,WAAW,CAAA;AAC5F,EAAA;EAEAY,WAAAA,GAAwB;AACpB,IAAA,OAAO,IAAA,CAAK,SAAA;AAChB,EAAA;EAEAC,MAAAA,GAAc;AACV,IAAA,OAAO,IAAA,CAAK,IAAA;AAChB,EAAA;EAEAC,QAAAA,GAAkB;AACd,IAAA,OAAO,IAAA,CAAK,MAAA;AAChB,EAAA;EAEAC,aAAAA,GAA4B;AACxB,IAAA,OAAO,IAAA,CAAK,WAAA;AAChB,EAAA;AAEAC,EAAAA,OAAAA,CAAQC,SAAAA,EAAyB;AAC7B,IAAA,IAAIC,IAAAA,GAAO,IAAA,CAAK,MAAA,CAAOC,GAAAA,CAAIF,SAAAA,CAAAA;AAC3B,IAAA,IAAIC,SAASE,MAAAA,EAAW;AACpBF,MAAAA,IAAAA,GAAO,IAAIG,KAAK,IAAA,CAAKtB,QAAAA,CAASmB,MAAMD,SAAAA,EAAW,IAAA,CAAKpB,MAAAA,EAAQ,IAAA,CAAK,SAAS,CAAA;AAC1E,MAAA,IAAA,CAAK,MAAA,CAAOyB,GAAAA,CAAIL,SAAAA,EAAWC,IAAAA,CAAAA;AAC/B,IAAA;AACA,IAAA,OAAOA,IAAAA;AACX,EAAA;AACJ","file":"2PVXPTJR.js","sourcesContent":["import type { ClientWithCoreApi } from '@mysten/sui/client';\n\nimport {\n    mergeDefaultObjectConfig,\n    mergeDefaultPackageConfig,\n    type ObjectOptions,\n    type PackageOptions,\n    type Stage,\n} from './deployments';\nimport { Endpoint } from './endpoint';\nimport { OApp } from './oapp';\nimport { PtbBuilder } from './ptb-builder';\nimport { Utils } from './utils';\nimport { Zro } from './zro';\n\nexport interface SuiProtocolSDKOptions {\n    client: ClientWithCoreApi;\n    stage?: Stage;\n    packages?: Partial<PackageOptions>;\n    objects?: Partial<ObjectOptions>;\n}\n\nexport class SuiProtocolSDK {\n    readonly client: ClientWithCoreApi;\n    readonly stage: Stage;\n    readonly packages: PackageOptions;\n    readonly objects: ObjectOptions;\n    readonly #utils: Utils;\n    readonly #zro: Zro;\n    readonly #ptbBuilder: PtbBuilder;\n    readonly #endpoint: Endpoint;\n    readonly #oapps = new Map<string, OApp>();\n\n    constructor(options: SuiProtocolSDKOptions) {\n        this.client = options.client;\n        this.stage = options.stage ?? 'mainnet';\n        this.packages = mergeDefaultPackageConfig(this.stage, options.packages);\n        this.objects = mergeDefaultObjectConfig(this.stage, options.objects);\n        this.#utils = new Utils(this.packages.utils, this.client);\n        this.#zro = new Zro(this.packages.zro, this.#utils);\n        this.#ptbBuilder = new PtbBuilder(this.packages.ptbMoveCall, this.client);\n        this.#endpoint = new Endpoint(this.client, this.packages, this.objects, this.#ptbBuilder);\n    }\n\n    getEndpoint(): Endpoint {\n        return this.#endpoint;\n    }\n\n    getZro(): Zro {\n        return this.#zro;\n    }\n\n    getUtils(): Utils {\n        return this.#utils;\n    }\n\n    getPtbBuilder(): PtbBuilder {\n        return this.#ptbBuilder;\n    }\n\n    getOApp(callCapId: string): OApp {\n        let oapp = this.#oapps.get(callCapId);\n        if (oapp === undefined) {\n            oapp = new OApp(this.packages.oapp, callCapId, this.client, this.#endpoint);\n            this.#oapps.set(callCapId, oapp);\n        }\n        return oapp;\n    }\n}\n"]}

package/dist/4DKNPMZP.js

@@ -0,0 +1,82 @@
+import { asBytes, asU64 } from './UIOGD65B.js';
+import { __name } from './VUOMXK5T.js';
+
+// src/protocol/utils.ts
+var Utils = class {
+  static {
+    __name(this, "Utils");
+  }
+  packageId;
+  client;
+  constructor(packageId, client) {
+    this.packageId = packageId;
+    this.client = client;
+  }
+  fromBytesMoveCall(tx, peer) {
+    return tx.moveCall({
+      target: `${this.packageId}::bytes32::from_bytes`,
+      arguments: [
+        asBytes(tx, peer)
+      ]
+    });
+  }
+  async splitCoinMoveCall(tx, coinType, owner, amount, limit = 200, pageSize = 50) {
+    const sufficientCoins = await this.#fetchSufficientCoins(owner, coinType, amount, limit, pageSize);
+    const totalBalance = sufficientCoins.reduce((sum, coin) => sum + BigInt(coin.balance), 0n);
+    const primaryCoin = sufficientCoins.find((coin) => BigInt(coin.balance) >= amount) ?? sufficientCoins[0];
+    const primaryCoinObj = tx.object(primaryCoin.objectId);
+    if (primaryCoin === sufficientCoins[0] && sufficientCoins.length > 1) {
+      tx.mergeCoins(primaryCoinObj, sufficientCoins.slice(1).map((coin) => tx.object(coin.objectId)));
+    }
+    const splitCoin = tx.splitCoins(primaryCoinObj, [
+      asU64(tx, amount)
+    ]);
+    if (totalBalance === amount) {
+      tx.moveCall({
+        target: "0x2::coin::destroy_zero",
+        arguments: [
+          primaryCoinObj
+        ],
+        typeArguments: [
+          coinType
+        ]
+      });
+    }
+    return splitCoin;
+  }
+  async #fetchSufficientCoins(owner, coinType, amount, limit, pageSize) {
+    const coins = [];
+    let accumulatedBalance = 0n;
+    let cursor = null;
+    do {
+      const coinsResponse = await this.client.core.listCoins({
+        owner,
+        coinType,
+        cursor,
+        limit: pageSize
+      });
+      if (coinsResponse.objects.length === 0) {
+        break;
+      }
+      for (const coin of coinsResponse.objects) {
+        coins.push(coin);
+        accumulatedBalance += BigInt(coin.balance);
+        if (accumulatedBalance >= amount) {
+          return coins;
+        }
+        if (coins.length >= limit) {
+          throw new Error(`Insufficient ${coinType} balance: reached maximum coin limit (${limit}) but still need ${amount - accumulatedBalance} more`);
+        }
+      }
+      cursor = coinsResponse.hasNextPage ? coinsResponse.cursor : null;
+    } while (cursor !== null);
+    if (accumulatedBalance < amount) {
+      throw new Error(`Insufficient ${coinType} balance: only found ${accumulatedBalance} but need ${amount} (shortfall: ${amount - accumulatedBalance})`);
+    }
+    return coins;
+  }
+};
+
+export { Utils };
+//# sourceMappingURL=4DKNPMZP.js.map
+//# sourceMappingURL=4DKNPMZP.js.map

package/dist/4DKNPMZP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol/utils.ts"],"names":["Utils","packageId","client","fromBytesMoveCall","tx","peer","moveCall","target","arguments","asBytes","splitCoinMoveCall","coinType","owner","amount","limit","pageSize","sufficientCoins","totalBalance","reduce","sum","coin","BigInt","balance","primaryCoin","find","primaryCoinObj","object","objectId","length","mergeCoins","slice","map","splitCoin","splitCoins","asU64","typeArguments","coins","accumulatedBalance","cursor","coinsResponse","core","listCoins","objects","push","Error","hasNextPage"],"mappings":";;;;AAKO,IAAMA,QAAN,MAAMA;EAFb;;;;;AAGI,EAAA,WAAA,CACoBC,WACAC,MAAAA,EAClB;SAFkBD,SAAAA,GAAAA,SAAAA;SACAC,MAAAA,GAAAA,MAAAA;AACjB,EAAA;AAEHC,EAAAA,iBAAAA,CAAkBC,IAAiBC,IAAAA,EAA2D;AAC1F,IAAA,OAAOD,GAAGE,QAAAA,CAAS;MACfC,MAAAA,EAAQ,CAAA,EAAG,KAAKN,SAAS,CAAA,qBAAA,CAAA;MACzBO,SAAAA,EAAW;AAACC,QAAAA,OAAAA,CAAQL,IAAIC,IAAAA;;KAC5B,CAAA;AACJ,EAAA;EAEA,MAAMK,iBAAAA,CACFN,IACAO,QAAAA,EACAC,KAAAA,EACAC,QACAC,KAAAA,GAAQ,GAAA,EACRC,WAAW,EAAA,EACe;AAC1B,IAAA,MAAMC,eAAAA,GAAkB,MAAM,IAAA,CAAK,qBAAA,CAC/BJ,OACAD,QAAAA,EACAE,MAAAA,EACAC,OACAC,QAAAA,CAAAA;AAEJ,IAAA,MAAME,YAAAA,GAAeD,eAAAA,CAAgBE,MAAAA,CAAO,CAACC,GAAAA,EAAKC,IAAAA,KAASD,GAAAA,GAAME,MAAAA,CAAOD,IAAAA,CAAKE,OAAO,CAAA,EAAG,EAAE,CAAA;AACzF,IAAA,MAAMC,WAAAA,GACFP,eAAAA,CAAgBQ,IAAAA,CAAK,CAACJ,IAAAA,KAASC,MAAAA,CAAOD,IAAAA,CAAKE,OAAO,CAAA,IAAKT,MAAAA,CAAAA,IAAWG,eAAAA,CAAgB,CAAA,CAAA;AACtF,IAAA,MAAMS,cAAAA,GAAiBrB,EAAAA,CAAGsB,MAAAA,CAAOH,WAAAA,CAAYI,QAAQ,CAAA;AACrD,IAAA,IAAIJ,gBAAgBP,eAAAA,CAAgB,CAAA,CAAA,IAAMA,eAAAA,CAAgBY,SAAS,CAAA,EAAG;AAClExB,MAAAA,EAAAA,CAAGyB,UAAAA,CACCJ,cAAAA,EACAT,eAAAA,CAAgBc,KAAAA,CAAM,CAAA,CAAA,CAAGC,GAAAA,CAAI,CAACX,IAAAA,KAAShB,EAAAA,CAAGsB,MAAAA,CAAON,IAAAA,CAAKO,QAAQ,CAAA,CAAA,CAAA;AAEtE,IAAA;AACA,IAAA,MAAMK,SAAAA,GAAY5B,EAAAA,CAAG6B,UAAAA,CAAWR,cAAAA,EAAgB;AAACS,MAAAA,KAAAA,CAAM9B,IAAIS,MAAAA;AAAQ,KAAA,CAAA;AACnE,IAAA,IAAII,iBAAiBJ,MAAAA,EAAQ;AACzBT,MAAAA,EAAAA,CAAGE,QAAAA,CAAS;QACRC,MAAAA,EAAQ,yBAAA;QACRC,SAAAA,EAAW;AAACiB,UAAAA;;QACZU,aAAAA,EAAe;AAACxB,UAAAA;;OACpB,CAAA;AACJ,IAAA;AACA,IAAA,OAAOqB,SAAAA;AACX,EAAA;AAEA,EAAA,MAAM,qBAAA,CACFpB,KAAAA,EACAD,QAAAA,EACAE,MAAAA,EACAC,OACAC,QAAAA,EAAgB;AAEhB,IAAA,MAAMqB,QAA+B,EAAA;AACrC,IAAA,IAAIC,kBAAAA,GAAqB,EAAA;AACzB,IAAA,IAAIC,MAAAA,GAAwB,IAAA;AAC5B,IAAA,GAAG;AACC,MAAA,MAAMC,aAAAA,GACF,MAAM,IAAA,CAAKrC,MAAAA,CAAOsC,KAAKC,SAAAA,CAAU;AAC7B7B,QAAAA,KAAAA;AACAD,QAAAA,QAAAA;AACA2B,QAAAA,MAAAA;QACAxB,KAAAA,EAAOC;OACX,CAAA;AACJ,MAAA,IAAIwB,aAAAA,CAAcG,OAAAA,CAAQd,MAAAA,KAAW,CAAA,EAAG;AACpC,QAAA;AACJ,MAAA;AACA,MAAA,KAAA,MAAWR,IAAAA,IAAQmB,cAAcG,OAAAA,EAAS;AACtCN,QAAAA,KAAAA,CAAMO,KAAKvB,IAAAA,CAAAA;AACXiB,QAAAA,kBAAAA,IAAsBhB,MAAAA,CAAOD,KAAKE,OAAO,CAAA;AACzC,QAAA,IAAIe,sBAAsBxB,MAAAA,EAAQ;AAC9B,UAAA,OAAOuB,KAAAA;AACX,QAAA;AACA,QAAA,IAAIA,KAAAA,CAAMR,UAAUd,KAAAA,EAAO;AACvB,UAAA,MAAM,IAAI8B,MACN,CAAA,aAAA,EAAgBjC,QAAAA,yCAAiDG,KAAAA,CAAAA,iBAAAA,EAAyBD,MAAAA,GAASwB,kBAAAA,CAAAA,KAAAA,CAAyB,CAAA;AAEpI,QAAA;AACJ,MAAA;AACAC,MAAAA,MAAAA,GAASC,aAAAA,CAAcM,WAAAA,GAAcN,aAAAA,CAAcD,MAAAA,GAAS,IAAA;AAChE,IAAA,CAAA,QAASA,MAAAA,KAAW,IAAA;AACpB,IAAA,IAAID,qBAAqBxB,MAAAA,EAAQ;AAC7B,MAAA,MAAM,IAAI+B,KAAAA,CACN,CAAA,aAAA,EAAgBjC,QAAAA,CAAAA,qBAAAA,EAAgC0B,kBAAAA,CAAAA,UAAAA,EAA+BxB,MAAAA,CAAAA,aAAAA,EAAsBA,MAAAA,GAASwB,kBAAAA,CAAAA,CAAAA,CAAqB,CAAA;AAE3I,IAAA;AACA,IAAA,OAAOD,KAAAA;AACX,EAAA;AACJ","file":"4DKNPMZP.js","sourcesContent":["import type { ClientWithCoreApi, SuiClientTypes } from '@mysten/sui/client';\nimport type { Transaction, TransactionArgument, TransactionResult } from '@mysten/sui/transactions';\n\nimport { asBytes, asU64 } from './args';\n\nexport class Utils {\n    constructor(\n        public readonly packageId: string,\n        public readonly client: ClientWithCoreApi,\n    ) {}\n\n    fromBytesMoveCall(tx: Transaction, peer: Uint8Array | TransactionArgument): TransactionResult {\n        return tx.moveCall({\n            target: `${this.packageId}::bytes32::from_bytes`,\n            arguments: [asBytes(tx, peer)],\n        });\n    }\n\n    async splitCoinMoveCall(\n        tx: Transaction,\n        coinType: string,\n        owner: string,\n        amount: bigint,\n        limit = 200,\n        pageSize = 50,\n    ): Promise<TransactionResult> {\n        const sufficientCoins = await this.#fetchSufficientCoins(\n            owner,\n            coinType,\n            amount,\n            limit,\n            pageSize,\n        );\n        const totalBalance = sufficientCoins.reduce((sum, coin) => sum + BigInt(coin.balance), 0n);\n        const primaryCoin =\n            sufficientCoins.find((coin) => BigInt(coin.balance) >= amount) ?? sufficientCoins[0];\n        const primaryCoinObj = tx.object(primaryCoin.objectId);\n        if (primaryCoin === sufficientCoins[0] && sufficientCoins.length > 1) {\n            tx.mergeCoins(\n                primaryCoinObj,\n                sufficientCoins.slice(1).map((coin) => tx.object(coin.objectId)),\n            );\n        }\n        const splitCoin = tx.splitCoins(primaryCoinObj, [asU64(tx, amount)]);\n        if (totalBalance === amount) {\n            tx.moveCall({\n                target: '0x2::coin::destroy_zero',\n                arguments: [primaryCoinObj],\n                typeArguments: [coinType],\n            });\n        }\n        return splitCoin;\n    }\n\n    async #fetchSufficientCoins(\n        owner: string,\n        coinType: string,\n        amount: bigint,\n        limit: number,\n        pageSize: number,\n    ): Promise<SuiClientTypes.Coin[]> {\n        const coins: SuiClientTypes.Coin[] = [];\n        let accumulatedBalance = 0n;\n        let cursor: string | null = null;\n        do {\n            const coinsResponse: SuiClientTypes.ListCoinsResponse =\n                await this.client.core.listCoins({\n                    owner,\n                    coinType,\n                    cursor,\n                    limit: pageSize,\n                });\n            if (coinsResponse.objects.length === 0) {\n                break;\n            }\n            for (const coin of coinsResponse.objects) {\n                coins.push(coin);\n                accumulatedBalance += BigInt(coin.balance);\n                if (accumulatedBalance >= amount) {\n                    return coins;\n                }\n                if (coins.length >= limit) {\n                    throw new Error(\n                        `Insufficient ${coinType} balance: reached maximum coin limit (${limit}) but still need ${amount - accumulatedBalance} more`,\n                    );\n                }\n            }\n            cursor = coinsResponse.hasNextPage ? coinsResponse.cursor : null;\n        } while (cursor !== null);\n        if (accumulatedBalance < amount) {\n            throw new Error(\n                `Insufficient ${coinType} balance: only found ${accumulatedBalance} but need ${amount} (shortfall: ${amount - accumulatedBalance})`,\n            );\n        }\n        return coins;\n    }\n}\n"]}