@layerzerolabs/oft-iota-sdk 0.0.0-stage → 1.2.100

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,183 @@
-# Temporary Holding Version
+# @layerzerolabs/oft-iota-sdk
 
-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 IOTA OFT (Omnichain Fungible Token) SDK
+
+## Overview
+
+This SDK provides TypeScript bindings for interacting with LayerZero V2 OFT contracts on the IOTA 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-iota-sdk
+# or
+yarn add @layerzerolabs/oft-iota-sdk
+# or
+pnpm add @layerzerolabs/oft-iota-sdk
+```
+
+The package is ESM only. It replaces `@layerzerolabs/lz-iotal1-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.
+
+## 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 } from '@layerzerolabs/oft-iota-sdk';
+import { SDK, validateTransaction } from '@layerzerolabs/lz-iotal1-sdk-v2';
+import { Transaction } from '@iota/iota-sdk/transactions';
+import { Stage } from '@layerzerolabs/lz-definitions';
+
+// Initialize LayerZero protocol SDK
+const protocolSDK = new SDK({
+    client: iotaClient,
+    stage: 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 validateTransaction(iotaClient, signer, initTx);
+```
+
+### 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 validateTransaction(iotaClient, signer, adapterTx);
+```
+
+### Register OFT with LayerZero Endpoint
+
+```typescript
+import { validateTransaction } from '@layerzerolabs/lz-iotal1-sdk-v2';
+
+// 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 validateTransaction(iotaClient, signer, registerTx);
+```
+
+### Set Peer for Cross-Chain Communication
+
+```typescript
+import { validateTransaction } from '@layerzerolabs/lz-iotal1-sdk-v2';
+
+// Get OApp instance from OFT
+const oapp = protocolSDK.getOApp(oft.oftCallCapId);
+
+// Set peer OFT on destination chain
+const setPeerTx = new Transaction();
+await oapp.setPeerMoveCall(
+    setPeerTx,
+    remoteEid, // Remote chain endpoint ID (e.g., 30102 for Ethereum)
+    remotePeerBytes, // Remote OFT address as 32-byte array
+);
+
+// Execute the transaction
+const result = await validateTransaction(iotaClient, signer, setPeerTx);
+```
+
+### 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();
+
+// Split coins from sender's wallet
+const coin = await oft.splitCoinMoveCall(tx, senderAddress, 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/CDSWWWJ7.js

@@ -0,0 +1,58 @@
+import { __name } from './VUOMXK5T.js';
+import { bcs } from '@iota/iota-sdk/bcs';
+
+var OFTLimitBcs = bcs.struct("OFTLimit", {
+  min_amount_ld: bcs.U64,
+  max_amount_ld: bcs.U64
+});
+var OFTFeeDetailBcs = bcs.struct("OFTFeeDetail", {
+  fee_amount_ld: bcs.U64,
+  is_reward: bcs.Bool,
+  description: bcs.String
+});
+var OFTReceiptBcs = bcs.struct("OFTReceipt", {
+  amount_sent_ld: bcs.U64,
+  amount_received_ld: bcs.U64
+});
+var OFTInfoV1Bcs = bcs.struct("OFTInfoV1", {
+  oft_package: bcs.Address,
+  oft_object: bcs.Address
+});
+function parseOFTLimit(data) {
+  const parsed = OFTLimitBcs.parse(data);
+  return {
+    minAmountLd: BigInt(parsed.min_amount_ld),
+    maxAmountLd: BigInt(parsed.max_amount_ld)
+  };
+}
+__name(parseOFTLimit, "parseOFTLimit");
+function parseOFTFeeDetails(data) {
+  const vectorBcs = bcs.vector(OFTFeeDetailBcs);
+  const parsed = vectorBcs.parse(data);
+  return parsed.map((detail) => ({
+    feeAmountLd: BigInt(detail.fee_amount_ld),
+    isReward: detail.is_reward,
+    description: detail.description
+  }));
+}
+__name(parseOFTFeeDetails, "parseOFTFeeDetails");
+function parseOFTReceipt(data) {
+  const parsed = OFTReceiptBcs.parse(data);
+  return {
+    amountSentLd: BigInt(parsed.amount_sent_ld),
+    amountReceivedLd: BigInt(parsed.amount_received_ld)
+  };
+}
+__name(parseOFTReceipt, "parseOFTReceipt");
+function parseOFTInfoV1(data) {
+  const parsed = OFTInfoV1Bcs.parse(data);
+  return {
+    oftPackage: parsed.oft_package,
+    oftObject: parsed.oft_object
+  };
+}
+__name(parseOFTInfoV1, "parseOFTInfoV1");
+
+export { OFTFeeDetailBcs, OFTInfoV1Bcs, OFTLimitBcs, OFTReceiptBcs, parseOFTFeeDetails, parseOFTInfoV1, parseOFTLimit, parseOFTReceipt };
+//# sourceMappingURL=CDSWWWJ7.js.map
+//# sourceMappingURL=CDSWWWJ7.js.map

package/dist/CDSWWWJ7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bcs/oft.ts"],"names":["OFTLimitBcs","bcs","struct","min_amount_ld","U64","max_amount_ld","OFTFeeDetailBcs","fee_amount_ld","is_reward","Bool","description","String","OFTReceiptBcs","amount_sent_ld","amount_received_ld","OFTInfoV1Bcs","oft_package","Address","oft_object","parseOFTLimit","data","parsed","parse","minAmountLd","BigInt","maxAmountLd","parseOFTFeeDetails","vectorBcs","vector","map","detail","feeAmountLd","isReward","parseOFTReceipt","amountSentLd","amountReceivedLd","parseOFTInfoV1","oftPackage","oftObject"],"mappings":";;;AAKO,IAAMA,WAAAA,GAAcC,GAAAA,CAAIC,MAAAA,CAAO,UAAA,EAAY;AAC9CC,EAAAA,aAAAA,EAAeF,GAAAA,CAAIG,GAAAA;AACnBC,EAAAA,aAAAA,EAAeJ,GAAAA,CAAIG;AACvB,CAAA;AAGO,IAAME,eAAAA,GAAkBL,GAAAA,CAAIC,MAAAA,CAAO,cAAA,EAAgB;AACtDK,EAAAA,aAAAA,EAAeN,GAAAA,CAAIG,GAAAA;AACnBI,EAAAA,SAAAA,EAAWP,GAAAA,CAAIQ,IAAAA;AACfC,EAAAA,WAAAA,EAAaT,GAAAA,CAAIU;AACrB,CAAA;AAGO,IAAMC,aAAAA,GAAgBX,GAAAA,CAAIC,MAAAA,CAAO,YAAA,EAAc;AAClDW,EAAAA,cAAAA,EAAgBZ,GAAAA,CAAIG,GAAAA;AACpBU,EAAAA,kBAAAA,EAAoBb,GAAAA,CAAIG;AAC5B,CAAA;AAGO,IAAMW,YAAAA,GAAed,GAAAA,CAAIC,MAAAA,CAAO,WAAA,EAAa;AAChDc,EAAAA,WAAAA,EAAaf,GAAAA,CAAIgB,OAAAA;AACjBC,EAAAA,UAAAA,EAAYjB,GAAAA,CAAIgB;AACpB,CAAA;AAGO,SAASE,cAAcC,IAAAA,EAAgB;AAC1C,EAAA,MAAMC,MAAAA,GAASrB,WAAAA,CAAYsB,KAAAA,CAAMF,IAAAA,CAAAA;AACjC,EAAA,OAAO;IACHG,WAAAA,EAAaC,MAAAA,CAAOH,OAAOlB,aAAa,CAAA;IACxCsB,WAAAA,EAAaD,MAAAA,CAAOH,OAAOhB,aAAa;AAC5C,GAAA;AACJ;AANgBc,MAAAA,CAAAA,aAAAA,EAAAA,eAAAA,CAAAA;AAST,SAASO,mBAAmBN,IAAAA,EAAgB;AAE/C,EAAA,MAAMO,SAAAA,GAAY1B,GAAAA,CAAI2B,MAAAA,CAAOtB,eAAAA,CAAAA;AAC7B,EAAA,MAAMe,MAAAA,GAASM,SAAAA,CAAUL,KAAAA,CAAMF,IAAAA,CAAAA;AAE/B,EAAA,OAAOC,MAAAA,CAAOQ,GAAAA,CACV,CAACC,MAAAA,MAIM;IACHC,WAAAA,EAAaP,MAAAA,CAAOM,OAAOvB,aAAa,CAAA;AACxCyB,IAAAA,QAAAA,EAAUF,MAAAA,CAAOtB,SAAAA;AACjBE,IAAAA,WAAAA,EAAaoB,MAAAA,CAAOpB;GACxB,CAAA,CAAA;AAER;AAhBgBgB,MAAAA,CAAAA,kBAAAA,EAAAA,oBAAAA,CAAAA;AAmBT,SAASO,gBAAgBb,IAAAA,EAAgB;AAC5C,EAAA,MAAMC,MAAAA,GAAST,aAAAA,CAAcU,KAAAA,CAAMF,IAAAA,CAAAA;AACnC,EAAA,OAAO;IACHc,YAAAA,EAAcV,MAAAA,CAAOH,OAAOR,cAAc,CAAA;IAC1CsB,gBAAAA,EAAkBX,MAAAA,CAAOH,OAAOP,kBAAkB;AACtD,GAAA;AACJ;AANgBmB,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA;AAST,SAASG,eAAehB,IAAAA,EAAgB;AAC3C,EAAA,MAAMC,MAAAA,GAASN,YAAAA,CAAaO,KAAAA,CAAMF,IAAAA,CAAAA;AAClC,EAAA,OAAO;AACHiB,IAAAA,UAAAA,EAAYhB,MAAAA,CAAOL,WAAAA;AACnBsB,IAAAA,SAAAA,EAAWjB,MAAAA,CAAOH;AACtB,GAAA;AACJ;AANgBkB,MAAAA,CAAAA,cAAAA,EAAAA,gBAAAA,CAAAA","file":"CDSWWWJ7.js","sourcesContent":["import { bcs } from '@iota/iota-sdk/bcs';\n\nimport type { OFTFeeDetail, OFTInfoV1, OFTLimit, OFTReceipt } from '../types';\n\n// OFTLimit struct BCS definition\nexport const OFTLimitBcs = bcs.struct('OFTLimit', {\n    min_amount_ld: bcs.U64,\n    max_amount_ld: bcs.U64,\n});\n\n// OFTFeeDetail struct BCS definition\nexport const OFTFeeDetailBcs = bcs.struct('OFTFeeDetail', {\n    fee_amount_ld: bcs.U64,\n    is_reward: bcs.Bool,\n    description: bcs.String,\n});\n\n// OFTReceipt struct BCS definition\nexport const OFTReceiptBcs = bcs.struct('OFTReceipt', {\n    amount_sent_ld: bcs.U64,\n    amount_received_ld: bcs.U64,\n});\n\n// OFTInfoV1 struct BCS definition\nexport const OFTInfoV1Bcs = bcs.struct('OFTInfoV1', {\n    oft_package: bcs.Address,\n    oft_object: bcs.Address,\n});\n\n// Helper function to parse OFTLimit\nexport function parseOFTLimit(data: Uint8Array): OFTLimit {\n    const parsed = OFTLimitBcs.parse(data);\n    return {\n        minAmountLd: BigInt(parsed.min_amount_ld),\n        maxAmountLd: BigInt(parsed.max_amount_ld),\n    };\n}\n\n// Helper function to parse OFTFeeDetail array\nexport function parseOFTFeeDetails(data: Uint8Array): OFTFeeDetail[] {\n    // Parse as vector of OFTFeeDetail\n    const vectorBcs = bcs.vector(OFTFeeDetailBcs);\n    const parsed = vectorBcs.parse(data);\n\n    return parsed.map(\n        (detail: {\n            fee_amount_ld: string | number | bigint;\n            is_reward: boolean;\n            description: string;\n        }) => ({\n            feeAmountLd: BigInt(detail.fee_amount_ld),\n            isReward: detail.is_reward,\n            description: detail.description,\n        }),\n    );\n}\n\n// Helper function to parse OFTReceipt\nexport function parseOFTReceipt(data: Uint8Array): OFTReceipt {\n    const parsed = OFTReceiptBcs.parse(data);\n    return {\n        amountSentLd: BigInt(parsed.amount_sent_ld),\n        amountReceivedLd: BigInt(parsed.amount_received_ld),\n    };\n}\n\n// Helper function to parse OFTInfoV1\nexport function parseOFTInfoV1(data: Uint8Array): OFTInfoV1 {\n    const parsed = OFTInfoV1Bcs.parse(data);\n    return {\n        oftPackage: parsed.oft_package,\n        oftObject: parsed.oft_object,\n    };\n}\n"]}

package/dist/I5Z2GNDD.js

@@ -0,0 +1,9 @@
+// src/types.ts
+var OFTMsgType = {
+  SEND: 1,
+  SEND_AND_CALL: 2
+};
+
+export { OFTMsgType };
+//# sourceMappingURL=I5Z2GNDD.js.map
+//# sourceMappingURL=I5Z2GNDD.js.map

package/dist/I5Z2GNDD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"names":["OFTMsgType","SEND","SEND_AND_CALL"],"mappings":";AACO,IAAMA,UAAAA,GAAa;EACtBC,IAAAA,EAAM,CAAA;EACNC,aAAAA,EAAe;AACnB","file":"I5Z2GNDD.js","sourcesContent":["// Constants\nexport const OFTMsgType = {\n    SEND: 1,\n    SEND_AND_CALL: 2,\n} as const;\n\n// Type Definitions\nexport interface SendParam {\n    dstEid: number;\n    to: Uint8Array;\n    amountLd: bigint;\n    minAmountLd: bigint;\n    extraOptions: Uint8Array;\n    composeMsg: Uint8Array;\n    oftCmd: Uint8Array;\n}\n\nexport interface OFTLimit {\n    minAmountLd: bigint;\n    maxAmountLd: bigint;\n}\n\nexport interface OFTFeeDetail {\n    feeAmountLd: bigint;\n    description: string;\n    isReward: boolean;\n}\n\nexport interface OFTReceipt {\n    amountSentLd: bigint;\n    amountReceivedLd: bigint;\n}\n\nexport interface OFTInfoV1 {\n    oftPackage: string;\n    oftObject: string;\n}\n"]}