@twin.org/move-to-json 0.0.2-next.3 → 0.0.2-next.5

package/README.md

@@ -335,3 +335,58 @@ iota client call --package 0x2 --module package --function upgrade \
   --args 0xfd6269c28e3931e41aa9d9e08ffabb8162cf1fd0baaef14094b4442e6c743edf \
   --gas-budget 50000000
 ```
+
+## Known Issues
+
+### Windows
+
+#### Long Path Limitation Error
+
+**Error Symptoms:**
+
+- Build commands fail with `Failed to reset to latest Git state 'mainnet'`
+- Tests timeout during Move compilation
+- Git dependency resolution failures
+
+**Root Cause:**
+Windows has a default file path length limitation of 260 characters. The IOTA framework repository contains files with very long paths (especially in test directories) that exceed this limit, causing Git operations to fail during dependency resolution.
+
+**Solution:**
+Enable long path support in both Git and Windows:
+
+1. **Enable Git Long Paths:**
+
+   ```bash
+   git config --global core.longpaths true
+   ```
+
+2. **Enable Windows Long Path Support (requires Administrator privileges):**
+
+   ```powershell
+   # Run PowerShell as Administrator
+   Set-ItemProperty -Path 'HKLM:SYSTEM\CurrentControlSet\Control\FileSystem' -Name 'LongPathsEnabled' -Value 1
+   ```
+
+3. **Restart your computer** for Windows registry changes to take effect.
+
+**Verification:**
+After applying the fix, you should see successful Git dependency updates:
+
+```bash
+UPDATING GIT DEPENDENCY https://github.com/iotaledger/iota.git
+INCLUDING DEPENDENCY Iota
+INCLUDING DEPENDENCY MoveStdlib
+BUILDING nft
+```
+
+**Alternative Workaround:**
+If you cannot enable long path support system-wide, you can use the `--skip-fetch-latest-git-deps` flag as a workaround, though this will use cached dependencies instead of the latest versions:
+
+```bash
+iota move build --skip-fetch-latest-git-deps
+```
+
+## Contributing
+
+To contribute to this package see the guidelines for building and publishing in
+[CONTRIBUTING](./CONTRIBUTING.md)

package/dist/cjs/index.cjs

@@ -6,35 +6,14 @@ var cliCore = require('@twin.org/cli-core');
 var node_fs = require('node:fs');
 var core = require('@twin.org/core');
 var crypto = require('@twin.org/crypto');
+var dltIota = require('@twin.org/dlt-iota');
 var FastGlob = require('fast-glob');
 var node_child_process = require('node:child_process');
 var node_util = require('node:util');
 var client = require('@iota/iota-sdk/client');
 var faucet = require('@iota/iota-sdk/faucet');
-var dltIota = require('@twin.org/dlt-iota');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Network types supported for deployment
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-const NetworkTypes = {
-    /**
-     * Testnet.
-     */
-    Testnet: "testnet",
-    /**
-     * Devnet.
-     */
-    Devnet: "devnet",
-    /**
-     * Mainnet.
-     */
-    Mainnet: "mainnet"
-};
-
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /**
@@ -104,7 +83,7 @@ function buildCommandBuild(program) {
 async function actionCommandBuild(inputGlob, opts) {
     try {
         const network = opts.network ?? process.env.NETWORK;
-        core.Guards.arrayOneOf("commands", "network", network, Object.values(NetworkTypes));
+        core.Guards.arrayOneOf("commands", "network", network, Object.values(dltIota.NetworkTypes));
         // Verify the IOTA SDK before we do anything else
         await verifyIotaSDK();
         const { normalizedGlob, normalizedOutput, executionDir } = normalizePathsAndWorkingDir(inputGlob, opts.output ?? "smart-contract-deployments.json");
@@ -158,7 +137,7 @@ async function actionCommandBuild(inputGlob, opts) {
                     const { contractName, packageId, packageData } = compiled;
                     const targetNetworkData = finalJson[network];
                     targetNetworkData.packageId = packageId;
-                    targetNetworkData.package = packageData;
+                    targetNetworkData.packageBytecode = packageData;
                     cliCore.CLIDisplay.value(`Updated ${network} package`, contractName, 2);
                 }
             }
@@ -343,7 +322,7 @@ function buildCommandDeploy(program) {
         .action(actionCommandDeploy);
 }
 /**
- * Switch IOTA CLI to the target network environment.
+ * Switch IOTA CLI to the target network environment and set the active address.
  * @param network Target network to switch to
  * @param dryRun Whether this is a dry run (checks environment but doesn't switch)
  */
@@ -365,9 +344,27 @@ async function setIotaEnvironment(network, dryRun = false) {
             cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.iotaEnvironmentCheck"), `✅ ${network} environment exists`, 1);
             return;
         }
-        // Switch to target network environment
-        await execAsync(`iota client switch --env ${network}`);
+        // Derive the target address from existing mnemonic/seed
+        const addressIndex = core.Coerce.number(process.env.ADDRESS_INDEX) ?? 0;
+        const targetAddress = await getDeploymentWalletAddress(network, addressIndex);
+        // Check if address exists in IOTA CLI
+        const { stdout: addressListOutput } = await execAsync("iota client addresses --json");
+        const addressInfo = JSON.parse(addressListOutput);
+        const addressExists = addressInfo.addresses.some(([_, addr]) => addr === targetAddress);
+        cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.checkingAddress"), targetAddress, 1);
+        if (!addressExists) {
+            // Import the address using the mnemonic
+            cliCore.CLIDisplay.task(core.I18n.formatMessage("commands.deploy.progress.importingDeployerAddress"));
+            const mnemonic = await getDeploymentMnemonic(network);
+            const aliasName = `deployer-${network}`;
+            const derivationPath = crypto.Bip44.path(dltIota.Iota.DEFAULT_COIN_TYPE, 0, false, addressIndex).toString();
+            await execAsync(`iota keytool import "${mnemonic}" ed25519 "${derivationPath}" --alias "${aliasName}"`);
+            cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.importedDeployerAddress"), `${aliasName} (${targetAddress})`, 1);
+        }
+        // Switch both environment and address in one command
+        await execAsync(`iota client switch --env ${network} --address ${targetAddress}`);
         cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.switchedIotaEnvironment"), network, 1);
+        cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.switchedActiveAddress"), targetAddress, 1);
         // Verify the switch was successful
         const { stdout: activeEnv } = await execAsync("iota client active-env");
         if (!activeEnv.includes(network)) {
@@ -376,6 +373,16 @@ async function setIotaEnvironment(network, dryRun = false) {
                 activeEnv
             });
         }
+        // Verify address switch was successful
+        const { stdout: activeAddressOutput } = await execAsync("iota client active-address");
+        const activeAddress = activeAddressOutput.trim();
+        if (activeAddress !== targetAddress) {
+            throw new core.GeneralError("commands", "commands.deploy.addressSwitchFailed", {
+                network,
+                targetAddress,
+                activeAddress
+            });
+        }
     }
     catch (error) {
         throw new core.GeneralError("commands", "commands.deploy.environmentOperationFailed", { network, operation: dryRun ? "check" : "switch to" }, error);
@@ -397,7 +404,7 @@ async function actionCommandDeploy(opts) {
         const dryRun = opts.dryRun ?? false;
         const force = opts.force ?? false;
         const network = opts.network ?? process.env.NETWORK;
-        core.Guards.arrayOneOf("commands", "network", network, Object.values(NetworkTypes));
+        core.Guards.arrayOneOf("commands", "network", network, Object.values(dltIota.NetworkTypes));
         // Verify the IOTA SDK before we do anything else
         await verifyIotaSDK();
         // Check/switch to target network environment BEFORE loading config
@@ -405,7 +412,7 @@ async function actionCommandDeploy(opts) {
         const config = await createNetworkConfig(network);
         validateNetworkConfig(config, network);
         const contractsData = await loadCompiledContracts(contractsPath);
-        if (network === "mainnet") {
+        if (network === dltIota.NetworkTypes.Mainnet) {
             await validateDeploymentEnvironment(network);
         }
         const networkContracts = contractsData[network];
@@ -522,12 +529,12 @@ async function validateEnvironmentForNetwork(network, config, isDryRun = false)
     else {
         cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.walletAddress"), walletAddress, 1);
     }
-    if (network === "mainnet") {
+    if (network === dltIota.NetworkTypes.Mainnet) {
         await validateDeploymentEnvironment(network);
     }
-    else if ((network === "testnet" || network === "devnet") && !isDryRun) {
-        // For testnet/devnet, request funds from faucet
-        await requestFaucetFunds(network, walletAddress);
+    else if ((network === dltIota.NetworkTypes.Testnet || network === dltIota.NetworkTypes.Devnet) && !isDryRun) {
+        // For testnet/devnet, check balance first and only request funds if needed
+        await checkBalanceAndRequestFaucetIfNeeded(network, config, walletAddress);
     }
     return walletAddress;
 }
@@ -541,29 +548,31 @@ async function validateEnvironmentForNetwork(network, config, isDryRun = false)
  */
 async function checkWalletBalance(network, config, walletAddress, isDryRun = false) {
     const client$1 = new client.IotaClient({ url: config.rpc.url });
-    const balanceIota = await client$1.getBalance({ owner: walletAddress });
-    const balanceNumberIota = Number(balanceIota.totalBalance);
-    const requiredIota = nanosToIota(config.deployment.gasBudget);
+    const balanceResponse = await client$1.getBalance({ owner: walletAddress });
+    const balanceInNanos = Number(balanceResponse.totalBalance);
+    const requiredInNanos = config.deployment.gasBudget;
+    const balanceInIota = nanosToIota(balanceInNanos);
+    const requiredInIota = nanosToIota(requiredInNanos);
     const balanceLabel = isDryRun
         ? "commands.deploy.labels.dryRunWalletBalance"
         : "commands.deploy.labels.walletBalance";
     const gasBudgetLabel = isDryRun
         ? "commands.deploy.labels.dryRunGasBudget"
         : "commands.deploy.labels.gasBudget";
-    cliCore.CLIDisplay.value(core.I18n.formatMessage(balanceLabel), `${balanceNumberIota.toFixed(2)} IOTA`, 1);
-    cliCore.CLIDisplay.value(core.I18n.formatMessage(gasBudgetLabel), `${requiredIota.toFixed(2)} IOTA`, 1);
-    // Handle insufficient balance based on network and run type
-    if (balanceNumberIota < requiredIota) {
+    cliCore.CLIDisplay.value(core.I18n.formatMessage(balanceLabel), `${balanceInIota.toFixed(2)} IOTA`, 1);
+    cliCore.CLIDisplay.value(core.I18n.formatMessage(gasBudgetLabel), `${requiredInIota.toFixed(2)} IOTA`, 1);
+    // Handle insufficient balance based on network and run type (compare in same units - nanos)
+    if (balanceInNanos < requiredInNanos) {
         if (isDryRun) {
             cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.warning"), core.I18n.formatMessage("commands.deploy.labels.insufficientBalanceWarning", {
-                currentBalance: balanceNumberIota.toFixed(2),
-                requiredBalance: requiredIota.toFixed(2)
+                currentBalance: balanceInIota.toFixed(2),
+                requiredBalance: requiredInIota.toFixed(2)
             }), 2);
         }
-        else if (network === "mainnet") {
+        else if (network === dltIota.NetworkTypes.Mainnet) {
             throw new core.GeneralError("commands", "commands.deploy.insufficientBalance", {
-                balance: balanceNumberIota,
-                required: requiredIota,
+                balance: balanceInIota,
+                required: requiredInIota,
                 walletAddress
             });
         }
@@ -571,13 +580,13 @@ async function checkWalletBalance(network, config, walletAddress, isDryRun = fal
             // For testnet/devnet, show warning but continue
             cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.warning"), core.I18n.formatMessage("commands.deploy.labels.insufficientBalanceAfterFaucet", {
                 network,
-                balance: balanceNumberIota.toFixed(2),
-                required: requiredIota.toFixed(2),
+                balance: balanceInIota.toFixed(2),
+                required: requiredInIota.toFixed(2),
                 walletAddress
             }), 2);
         }
     }
-    return balanceNumberIota;
+    return balanceInNanos;
 }
 /**
  * Handle dry run validation and display.
@@ -613,10 +622,16 @@ async function handleActualDeployment(contractName, contractData, config, networ
         await checkWalletBalance(network, config, walletAddress, false);
         const deploymentResult = await deployWithIotaCli(config.deployment.gasBudget);
         contractData.deployedPackageId = deploymentResult.packageId;
-        contractData.upgradeCap = deploymentResult.upgradeCap;
+        contractData.upgradeCapabilityId = deploymentResult.upgradeCap;
+        if (deploymentResult.migrationStateId) {
+            contractData.migrationStateId = deploymentResult.migrationStateId;
+        }
         cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.deployedPackageIdResult"), deploymentResult.packageId, 1);
         if (deploymentResult.upgradeCap) {
-            cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.upgradeCapId"), deploymentResult.upgradeCap, 1);
+            cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.upgradeCapabilityIdResult"), deploymentResult.upgradeCap, 1);
+        }
+        if (contractData.migrationStateId) {
+            cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.migrationStateIdResult"), contractData.migrationStateId, 1);
         }
     }
     catch (err) {
@@ -628,7 +643,7 @@ async function handleActualDeployment(contractName, contractData, config, networ
  * @param contractName Name of the contract
  * @param contractData Contract compilation data
  * @param contractData.packageId Package ID
- * @param contractData.package Package
+ * @param contractData.packageBytecode Package bytecode
  * @param contractData.deployedPackageId Deployed package ID
  * @param config Network configuration
  * @param network Target network
@@ -682,7 +697,7 @@ function nanosToIota(nanos) {
  * @returns Promise that resolves when funding is complete.
  */
 async function requestFaucetFunds(network, walletAddress) {
-    if (network !== "testnet" && network !== "devnet") {
+    if (network !== dltIota.NetworkTypes.Testnet && network !== dltIota.NetworkTypes.Devnet) {
         return;
     }
     cliCore.CLIDisplay.task(core.I18n.formatMessage("commands.deploy.progress.requestingFaucetFunds", { network }));
@@ -695,20 +710,59 @@ async function requestFaucetFunds(network, walletAddress) {
         throw new core.GeneralError("commands", "commands.deploy.fundingFailed", undefined, response.error);
     }
     const client$1 = new client.IotaClient({ url: process.env.RPC_URL ?? "" });
-    const balanceIota = await client$1.getBalance({ owner: walletAddress });
-    const balanceNumberIota = Number(balanceIota.totalBalance);
-    if (balanceNumberIota > 0n) {
-        const amountIota = nanosToIota(Number(balanceNumberIota));
-        cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.faucetFundsRequested"), `${amountIota.toFixed(2)} IOTA`, 1);
+    const balanceResponse = await client$1.getBalance({ owner: walletAddress });
+    const balanceInNanos = Number(balanceResponse.totalBalance);
+    if (balanceInNanos > 0) {
+        const amountInIota = nanosToIota(balanceInNanos);
+        cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.faucetFundsRequested"), `${amountInIota.toFixed(2)} IOTA`, 1);
     }
     else {
         cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.warning"), core.I18n.formatMessage("commands.deploy.labels.faucetNoFundsAdded", { network }), 2);
     }
 }
+/**
+ * Check wallet balance and request faucet funds only if needed.
+ * @param network The target network (testnet or devnet).
+ * @param config Network configuration.
+ * @param walletAddress The wallet address to check and potentially fund.
+ * @returns Promise that resolves when balance check and optional funding is complete.
+ */
+async function checkBalanceAndRequestFaucetIfNeeded(network, config, walletAddress) {
+    if (network !== dltIota.NetworkTypes.Testnet && network !== dltIota.NetworkTypes.Devnet) {
+        return;
+    }
+    // Check current balance
+    const client$1 = new client.IotaClient({ url: config.rpc.url });
+    const balanceResponse = await client$1.getBalance({ owner: walletAddress });
+    const balanceInNanos = Number(balanceResponse.totalBalance);
+    const requiredInNanos = config.deployment.gasBudget;
+    // Convert to IOTA for display purposes
+    const balanceInIota = nanosToIota(balanceInNanos);
+    const requiredInIota = nanosToIota(requiredInNanos);
+    cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.walletBalance"), `${balanceInIota.toFixed(2)} IOTA`, 1);
+    cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.gasBudget"), `${requiredInIota.toFixed(2)} IOTA`, 1);
+    // Only request faucet funds if balance is insufficient (compare in same units - nanos)
+    if (balanceInNanos < requiredInNanos) {
+        cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.warning"), core.I18n.formatMessage("commands.deploy.labels.insufficientBalance", {
+            currentBalance: balanceInIota.toFixed(2),
+            requiredBalance: requiredInIota.toFixed(2)
+        }), 1);
+        cliCore.CLIDisplay.task(core.I18n.formatMessage("commands.deploy.progress.requestingAdditionalFaucetFunds"));
+        await requestFaucetFunds(network, walletAddress);
+        // Check balance again after faucet request
+        const updatedBalanceResponse = await client$1.getBalance({ owner: walletAddress });
+        const updatedBalanceInNanos = Number(updatedBalanceResponse.totalBalance);
+        const updatedBalanceInIota = nanosToIota(updatedBalanceInNanos);
+        cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.updatedWalletBalance"), `${updatedBalanceInIota.toFixed(2)} IOTA`, 1);
+    }
+    else {
+        cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.balanceCheck"), core.I18n.formatMessage("commands.deploy.labels.sufficientFundsAvailable"), 1);
+    }
+}
 /**
  * Deploy contract using IOTA CLI.
  * @param gasBudget Gas budget for deployment.
- * @returns Deployment result with package ID.
+ * @returns Deployment result with package ID, upgrade cap, and migration state ID.
  */
 async function deployWithIotaCli(gasBudget) {
     // Find the Move project directory
@@ -719,8 +773,11 @@ async function deployWithIotaCli(gasBudget) {
             currentDir: process.cwd()
         });
     }
+    // Prioritize Move.toml in current directory, then use first found
+    const currentDirMoveToml = path.join(process.cwd(), "Move.toml");
+    const selectedMoveToml = moveTomlPaths.find(p => p === currentDirMoveToml) ?? moveTomlPaths[0];
     // Use the actual Move project directory
-    const moveProjectRoot = path.dirname(moveTomlPaths[0]);
+    const moveProjectRoot = path.dirname(selectedMoveToml);
     cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.moveProjectRoot"), moveProjectRoot, 1);
     const publishCmd = `iota client publish --gas-budget ${gasBudget} --json`;
     cliCore.CLIDisplay.value(core.I18n.formatMessage("commands.deploy.labels.publishCommand"), publishCmd, 1);
@@ -736,9 +793,12 @@ async function deployWithIotaCli(gasBudget) {
     }
     // Extract UpgradeCap ID from created objects
     const upgradeCap = result.objectChanges?.find((change) => change.objectType === "0x2::package::UpgradeCap")?.objectId;
+    // Extract MigrationState ID from created objects
+    const migrationStateId = result.objectChanges?.find((change) => change.objectType?.endsWith("::MigrationState"))?.objectId;
     return {
         packageId,
-        upgradeCap
+        upgradeCap,
+        migrationStateId
     };
 }
 /**
@@ -774,7 +834,7 @@ class CLI extends cliCore.CLIBase {
         return this.execute({
             title: "TWIN Move to JSON",
             appName: "move-to-json",
-            version: "0.0.2-next.3", // x-release-please-version
+            version: "0.0.2-next.5", // x-release-please-version
             icon: "⚙️ ",
             supportsEnvFiles: true,
             overrideOutputWidth: options?.overrideOutputWidth
@@ -791,7 +851,6 @@ class CLI extends cliCore.CLIBase {
 }
 
 exports.CLI = CLI;
-exports.NetworkTypes = NetworkTypes;
 exports.actionCommandBuild = actionCommandBuild;
 exports.actionCommandDeploy = actionCommandDeploy;
 exports.buildCommandBuild = buildCommandBuild;

package/dist/esm/index.mjs

@@ -3,34 +3,13 @@ import { fileURLToPath } from 'node:url';
 import { CLIDisplay, CLIUtils, CLIBase } from '@twin.org/cli-core';
 import { promises } from 'node:fs';
 import { I18n, GeneralError, Guards, StringHelper, Converter, Is, Coerce } from '@twin.org/core';
-import { Sha3, Bip39 } from '@twin.org/crypto';
+import { Sha3, Bip44, Bip39 } from '@twin.org/crypto';
+import { NetworkTypes, Iota } from '@twin.org/dlt-iota';
 import FastGlob from 'fast-glob';
 import { exec } from 'node:child_process';
 import { promisify } from 'node:util';
 import { IotaClient } from '@iota/iota-sdk/client';
 import { requestIotaFromFaucetV0 } from '@iota/iota-sdk/faucet';
-import { Iota } from '@twin.org/dlt-iota';
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Network types supported for deployment
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-const NetworkTypes = {
-    /**
-     * Testnet.
-     */
-    Testnet: "testnet",
-    /**
-     * Devnet.
-     */
-    Devnet: "devnet",
-    /**
-     * Mainnet.
-     */
-    Mainnet: "mainnet"
-};
 
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
@@ -155,7 +134,7 @@ async function actionCommandBuild(inputGlob, opts) {
                     const { contractName, packageId, packageData } = compiled;
                     const targetNetworkData = finalJson[network];
                     targetNetworkData.packageId = packageId;
-                    targetNetworkData.package = packageData;
+                    targetNetworkData.packageBytecode = packageData;
                     CLIDisplay.value(`Updated ${network} package`, contractName, 2);
                 }
             }
@@ -340,7 +319,7 @@ function buildCommandDeploy(program) {
         .action(actionCommandDeploy);
 }
 /**
- * Switch IOTA CLI to the target network environment.
+ * Switch IOTA CLI to the target network environment and set the active address.
  * @param network Target network to switch to
  * @param dryRun Whether this is a dry run (checks environment but doesn't switch)
  */
@@ -362,9 +341,27 @@ async function setIotaEnvironment(network, dryRun = false) {
             CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.iotaEnvironmentCheck"), `✅ ${network} environment exists`, 1);
             return;
         }
-        // Switch to target network environment
-        await execAsync(`iota client switch --env ${network}`);
+        // Derive the target address from existing mnemonic/seed
+        const addressIndex = Coerce.number(process.env.ADDRESS_INDEX) ?? 0;
+        const targetAddress = await getDeploymentWalletAddress(network, addressIndex);
+        // Check if address exists in IOTA CLI
+        const { stdout: addressListOutput } = await execAsync("iota client addresses --json");
+        const addressInfo = JSON.parse(addressListOutput);
+        const addressExists = addressInfo.addresses.some(([_, addr]) => addr === targetAddress);
+        CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.checkingAddress"), targetAddress, 1);
+        if (!addressExists) {
+            // Import the address using the mnemonic
+            CLIDisplay.task(I18n.formatMessage("commands.deploy.progress.importingDeployerAddress"));
+            const mnemonic = await getDeploymentMnemonic(network);
+            const aliasName = `deployer-${network}`;
+            const derivationPath = Bip44.path(Iota.DEFAULT_COIN_TYPE, 0, false, addressIndex).toString();
+            await execAsync(`iota keytool import "${mnemonic}" ed25519 "${derivationPath}" --alias "${aliasName}"`);
+            CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.importedDeployerAddress"), `${aliasName} (${targetAddress})`, 1);
+        }
+        // Switch both environment and address in one command
+        await execAsync(`iota client switch --env ${network} --address ${targetAddress}`);
         CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.switchedIotaEnvironment"), network, 1);
+        CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.switchedActiveAddress"), targetAddress, 1);
         // Verify the switch was successful
         const { stdout: activeEnv } = await execAsync("iota client active-env");
         if (!activeEnv.includes(network)) {
@@ -373,6 +370,16 @@ async function setIotaEnvironment(network, dryRun = false) {
                 activeEnv
             });
         }
+        // Verify address switch was successful
+        const { stdout: activeAddressOutput } = await execAsync("iota client active-address");
+        const activeAddress = activeAddressOutput.trim();
+        if (activeAddress !== targetAddress) {
+            throw new GeneralError("commands", "commands.deploy.addressSwitchFailed", {
+                network,
+                targetAddress,
+                activeAddress
+            });
+        }
     }
     catch (error) {
         throw new GeneralError("commands", "commands.deploy.environmentOperationFailed", { network, operation: dryRun ? "check" : "switch to" }, error);
@@ -402,7 +409,7 @@ async function actionCommandDeploy(opts) {
         const config = await createNetworkConfig(network);
         validateNetworkConfig(config, network);
         const contractsData = await loadCompiledContracts(contractsPath);
-        if (network === "mainnet") {
+        if (network === NetworkTypes.Mainnet) {
             await validateDeploymentEnvironment(network);
         }
         const networkContracts = contractsData[network];
@@ -519,12 +526,12 @@ async function validateEnvironmentForNetwork(network, config, isDryRun = false)
     else {
         CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.walletAddress"), walletAddress, 1);
     }
-    if (network === "mainnet") {
+    if (network === NetworkTypes.Mainnet) {
         await validateDeploymentEnvironment(network);
     }
-    else if ((network === "testnet" || network === "devnet") && !isDryRun) {
-        // For testnet/devnet, request funds from faucet
-        await requestFaucetFunds(network, walletAddress);
+    else if ((network === NetworkTypes.Testnet || network === NetworkTypes.Devnet) && !isDryRun) {
+        // For testnet/devnet, check balance first and only request funds if needed
+        await checkBalanceAndRequestFaucetIfNeeded(network, config, walletAddress);
     }
     return walletAddress;
 }
@@ -538,29 +545,31 @@ async function validateEnvironmentForNetwork(network, config, isDryRun = false)
  */
 async function checkWalletBalance(network, config, walletAddress, isDryRun = false) {
     const client = new IotaClient({ url: config.rpc.url });
-    const balanceIota = await client.getBalance({ owner: walletAddress });
-    const balanceNumberIota = Number(balanceIota.totalBalance);
-    const requiredIota = nanosToIota(config.deployment.gasBudget);
+    const balanceResponse = await client.getBalance({ owner: walletAddress });
+    const balanceInNanos = Number(balanceResponse.totalBalance);
+    const requiredInNanos = config.deployment.gasBudget;
+    const balanceInIota = nanosToIota(balanceInNanos);
+    const requiredInIota = nanosToIota(requiredInNanos);
     const balanceLabel = isDryRun
         ? "commands.deploy.labels.dryRunWalletBalance"
         : "commands.deploy.labels.walletBalance";
     const gasBudgetLabel = isDryRun
         ? "commands.deploy.labels.dryRunGasBudget"
         : "commands.deploy.labels.gasBudget";
-    CLIDisplay.value(I18n.formatMessage(balanceLabel), `${balanceNumberIota.toFixed(2)} IOTA`, 1);
-    CLIDisplay.value(I18n.formatMessage(gasBudgetLabel), `${requiredIota.toFixed(2)} IOTA`, 1);
-    // Handle insufficient balance based on network and run type
-    if (balanceNumberIota < requiredIota) {
+    CLIDisplay.value(I18n.formatMessage(balanceLabel), `${balanceInIota.toFixed(2)} IOTA`, 1);
+    CLIDisplay.value(I18n.formatMessage(gasBudgetLabel), `${requiredInIota.toFixed(2)} IOTA`, 1);
+    // Handle insufficient balance based on network and run type (compare in same units - nanos)
+    if (balanceInNanos < requiredInNanos) {
         if (isDryRun) {
             CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.warning"), I18n.formatMessage("commands.deploy.labels.insufficientBalanceWarning", {
-                currentBalance: balanceNumberIota.toFixed(2),
-                requiredBalance: requiredIota.toFixed(2)
+                currentBalance: balanceInIota.toFixed(2),
+                requiredBalance: requiredInIota.toFixed(2)
             }), 2);
         }
-        else if (network === "mainnet") {
+        else if (network === NetworkTypes.Mainnet) {
             throw new GeneralError("commands", "commands.deploy.insufficientBalance", {
-                balance: balanceNumberIota,
-                required: requiredIota,
+                balance: balanceInIota,
+                required: requiredInIota,
                 walletAddress
             });
         }
@@ -568,13 +577,13 @@ async function checkWalletBalance(network, config, walletAddress, isDryRun = fal
             // For testnet/devnet, show warning but continue
             CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.warning"), I18n.formatMessage("commands.deploy.labels.insufficientBalanceAfterFaucet", {
                 network,
-                balance: balanceNumberIota.toFixed(2),
-                required: requiredIota.toFixed(2),
+                balance: balanceInIota.toFixed(2),
+                required: requiredInIota.toFixed(2),
                 walletAddress
             }), 2);
         }
     }
-    return balanceNumberIota;
+    return balanceInNanos;
 }
 /**
  * Handle dry run validation and display.
@@ -610,10 +619,16 @@ async function handleActualDeployment(contractName, contractData, config, networ
         await checkWalletBalance(network, config, walletAddress, false);
         const deploymentResult = await deployWithIotaCli(config.deployment.gasBudget);
         contractData.deployedPackageId = deploymentResult.packageId;
-        contractData.upgradeCap = deploymentResult.upgradeCap;
+        contractData.upgradeCapabilityId = deploymentResult.upgradeCap;
+        if (deploymentResult.migrationStateId) {
+            contractData.migrationStateId = deploymentResult.migrationStateId;
+        }
         CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.deployedPackageIdResult"), deploymentResult.packageId, 1);
         if (deploymentResult.upgradeCap) {
-            CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.upgradeCapId"), deploymentResult.upgradeCap, 1);
+            CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.upgradeCapabilityIdResult"), deploymentResult.upgradeCap, 1);
+        }
+        if (contractData.migrationStateId) {
+            CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.migrationStateIdResult"), contractData.migrationStateId, 1);
         }
     }
     catch (err) {
@@ -625,7 +640,7 @@ async function handleActualDeployment(contractName, contractData, config, networ
  * @param contractName Name of the contract
  * @param contractData Contract compilation data
  * @param contractData.packageId Package ID
- * @param contractData.package Package
+ * @param contractData.packageBytecode Package bytecode
  * @param contractData.deployedPackageId Deployed package ID
  * @param config Network configuration
  * @param network Target network
@@ -679,7 +694,7 @@ function nanosToIota(nanos) {
  * @returns Promise that resolves when funding is complete.
  */
 async function requestFaucetFunds(network, walletAddress) {
-    if (network !== "testnet" && network !== "devnet") {
+    if (network !== NetworkTypes.Testnet && network !== NetworkTypes.Devnet) {
         return;
     }
     CLIDisplay.task(I18n.formatMessage("commands.deploy.progress.requestingFaucetFunds", { network }));
@@ -692,20 +707,59 @@ async function requestFaucetFunds(network, walletAddress) {
         throw new GeneralError("commands", "commands.deploy.fundingFailed", undefined, response.error);
     }
     const client = new IotaClient({ url: process.env.RPC_URL ?? "" });
-    const balanceIota = await client.getBalance({ owner: walletAddress });
-    const balanceNumberIota = Number(balanceIota.totalBalance);
-    if (balanceNumberIota > 0n) {
-        const amountIota = nanosToIota(Number(balanceNumberIota));
-        CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.faucetFundsRequested"), `${amountIota.toFixed(2)} IOTA`, 1);
+    const balanceResponse = await client.getBalance({ owner: walletAddress });
+    const balanceInNanos = Number(balanceResponse.totalBalance);
+    if (balanceInNanos > 0) {
+        const amountInIota = nanosToIota(balanceInNanos);
+        CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.faucetFundsRequested"), `${amountInIota.toFixed(2)} IOTA`, 1);
     }
     else {
         CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.warning"), I18n.formatMessage("commands.deploy.labels.faucetNoFundsAdded", { network }), 2);
     }
 }
+/**
+ * Check wallet balance and request faucet funds only if needed.
+ * @param network The target network (testnet or devnet).
+ * @param config Network configuration.
+ * @param walletAddress The wallet address to check and potentially fund.
+ * @returns Promise that resolves when balance check and optional funding is complete.
+ */
+async function checkBalanceAndRequestFaucetIfNeeded(network, config, walletAddress) {
+    if (network !== NetworkTypes.Testnet && network !== NetworkTypes.Devnet) {
+        return;
+    }
+    // Check current balance
+    const client = new IotaClient({ url: config.rpc.url });
+    const balanceResponse = await client.getBalance({ owner: walletAddress });
+    const balanceInNanos = Number(balanceResponse.totalBalance);
+    const requiredInNanos = config.deployment.gasBudget;
+    // Convert to IOTA for display purposes
+    const balanceInIota = nanosToIota(balanceInNanos);
+    const requiredInIota = nanosToIota(requiredInNanos);
+    CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.walletBalance"), `${balanceInIota.toFixed(2)} IOTA`, 1);
+    CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.gasBudget"), `${requiredInIota.toFixed(2)} IOTA`, 1);
+    // Only request faucet funds if balance is insufficient (compare in same units - nanos)
+    if (balanceInNanos < requiredInNanos) {
+        CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.warning"), I18n.formatMessage("commands.deploy.labels.insufficientBalance", {
+            currentBalance: balanceInIota.toFixed(2),
+            requiredBalance: requiredInIota.toFixed(2)
+        }), 1);
+        CLIDisplay.task(I18n.formatMessage("commands.deploy.progress.requestingAdditionalFaucetFunds"));
+        await requestFaucetFunds(network, walletAddress);
+        // Check balance again after faucet request
+        const updatedBalanceResponse = await client.getBalance({ owner: walletAddress });
+        const updatedBalanceInNanos = Number(updatedBalanceResponse.totalBalance);
+        const updatedBalanceInIota = nanosToIota(updatedBalanceInNanos);
+        CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.updatedWalletBalance"), `${updatedBalanceInIota.toFixed(2)} IOTA`, 1);
+    }
+    else {
+        CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.balanceCheck"), I18n.formatMessage("commands.deploy.labels.sufficientFundsAvailable"), 1);
+    }
+}
 /**
  * Deploy contract using IOTA CLI.
  * @param gasBudget Gas budget for deployment.
- * @returns Deployment result with package ID.
+ * @returns Deployment result with package ID, upgrade cap, and migration state ID.
  */
 async function deployWithIotaCli(gasBudget) {
     // Find the Move project directory
@@ -716,8 +770,11 @@ async function deployWithIotaCli(gasBudget) {
             currentDir: process.cwd()
         });
     }
+    // Prioritize Move.toml in current directory, then use first found
+    const currentDirMoveToml = path.join(process.cwd(), "Move.toml");
+    const selectedMoveToml = moveTomlPaths.find(p => p === currentDirMoveToml) ?? moveTomlPaths[0];
     // Use the actual Move project directory
-    const moveProjectRoot = path.dirname(moveTomlPaths[0]);
+    const moveProjectRoot = path.dirname(selectedMoveToml);
     CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.moveProjectRoot"), moveProjectRoot, 1);
     const publishCmd = `iota client publish --gas-budget ${gasBudget} --json`;
     CLIDisplay.value(I18n.formatMessage("commands.deploy.labels.publishCommand"), publishCmd, 1);
@@ -733,9 +790,12 @@ async function deployWithIotaCli(gasBudget) {
     }
     // Extract UpgradeCap ID from created objects
     const upgradeCap = result.objectChanges?.find((change) => change.objectType === "0x2::package::UpgradeCap")?.objectId;
+    // Extract MigrationState ID from created objects
+    const migrationStateId = result.objectChanges?.find((change) => change.objectType?.endsWith("::MigrationState"))?.objectId;
     return {
         packageId,
-        upgradeCap
+        upgradeCap,
+        migrationStateId
     };
 }
 /**
@@ -771,7 +831,7 @@ class CLI extends CLIBase {
         return this.execute({
             title: "TWIN Move to JSON",
             appName: "move-to-json",
-            version: "0.0.2-next.3", // x-release-please-version
+            version: "0.0.2-next.5", // x-release-please-version
             icon: "⚙️ ",
             supportsEnvFiles: true,
             overrideOutputWidth: options?.overrideOutputWidth
@@ -787,4 +847,4 @@ class CLI extends CLIBase {
     }
 }
 
-export { CLI, NetworkTypes, actionCommandBuild, actionCommandDeploy, buildCommandBuild, buildCommandDeploy, getDeploymentMnemonic, getDeploymentSeed, searchDirectoryForMoveToml, validateDeploymentEnvironment, verifyIotaSDK };
+export { CLI, actionCommandBuild, actionCommandDeploy, buildCommandBuild, buildCommandDeploy, getDeploymentMnemonic, getDeploymentSeed, searchDirectoryForMoveToml, validateDeploymentEnvironment, verifyIotaSDK };

package/dist/locales/en.json

@@ -45,7 +45,8 @@
 				"noPackageData": "No package data found for contract in compiled modules",
 				"packageNotFoundOnNetwork": "Package {packageId} not found on network {network}. Please ensure the package is deployed.",
 				"dryRunInvalidConfig": "Dry run failed due to invalid configuration",
-				"noMoveTomlFilesFound": "No Move.toml files found in current directory or subdirectories. Make sure you're running this from a directory containing Move projects."
+				"noMoveTomlFilesFound": "No Move.toml files found in current directory or subdirectories. Make sure you're running this from a directory containing Move projects.",
+				"addressSwitchFailed": "Failed to switch to active address {targetAddress} for {network}. Active address: {activeAddress}"
 			}
 		},
 		"validation": {
@@ -226,6 +227,23 @@
 			"gasReservationFailed": "The gas reservation failed",
 			"gasStationExecutionFailed": "The gas station execution failed"
 		},
+		"iotaSmartContractUtils": {
+			"migrationFailed": "Smart contract migration failed",
+			"migrateSmartContractFailed": "Failed to migrate smart contract for object \"{objectId}\"",
+			"enableMigrationFailed": "Failed to enable migration for smart contract",
+			"disableMigrationFailed": "Failed to disable migration for smart contract",
+			"migrationStateNotReadable": "Cannot read migration state for ID \"{migrationStateId}\"",
+			"isMigrationActiveFailed": "Failed to check if migration is active",
+			"invalidVersionData": "Invalid version data received from smart contract",
+			"getCurrentContractVersionNoData": "No version data returned from contract",
+			"getCurrentContractVersionFailed": "Failed to get current contract version",
+			"objectNotReadable": "Cannot read object with ID \"{objectId}\"",
+			"objectInvalidFormat": "Object \"{objectId}\" has invalid format",
+			"validateObjectVersionFailed": "Failed to validate object version for \"{objectId}\"",
+			"getContractObjectIdsFailed": "Failed to get contract object IDs for namespace \"{namespace}\" on network \"{network}\"",
+			"adminCapNotFound": "AdminCap object not found for type \"{adminCapType}\" and address \"{adminAddress}\"",
+			"migrationStateNotFound": "MigrationState object not found for type \"{migrationStateType}\" and address \"{adminAddress}\""
+		},
 		"entitySchemaHelper": {
 			"noIsPrimary": "Property \"entitySchema.properties\" must contain a value with isPrimary set",
 			"multipleIsPrimary": "Property \"entitySchema.properties\" contains more than one property with isPrimary set",
@@ -413,7 +431,7 @@
 				"dryRunMode": "Dry Run Mode",
 				"forceMode": "Force Mode",
 				"deployedPackageId": "Deployed Package ID",
-				"upgradeCap": "Upgrade Cap",
+				"upgradeCapabilityId": "Upgrade Capability ID",
 				"gasUsed": "Gas Used",
 				"deploymentStatus": "Deployment Status",
 				"iotaEnvironmentCheck": "IOTA environment check",
@@ -430,7 +448,10 @@
 				"walletAddress": "Wallet Address",
 				"walletBalance": "Wallet Balance",
 				"deployedPackageIdResult": "Deployed Package ID",
-				"upgradeCapId": "UpgradeCap ID",
+				"upgradeCapabilityIdResult": "Upgrade Capability ID",
+				"migrationStateIdResult": "Migration State ID",
+				"importedDeployerAddress": "Imported deployer address",
+				"switchedActiveAddress": "Switched active address",
 				"moveProjectRoot": "Move Project Root",
 				"publishCommand": "Publish Command",
 				"workingDirectory": "Working Directory",
@@ -443,15 +464,20 @@
 				"balanceStatus": "Balance Status",
 				"faucetFundsRequested": "Faucet funds requested",
 				"faucetRequestFailed": "Faucet request failed for {network}: {error}",
-				"insufficientBalanceAfterFaucet": "Insufficient balance after faucet request on {network}: {balance} IOTA < {required} IOTA for wallet {walletAddress}. Attempting deployment anyway."
+				"insufficientBalanceAfterFaucet": "Insufficient balance after faucet request on {network}: {balance} IOTA < {required} IOTA for wallet {walletAddress}. Attempting deployment anyway.",
+				"updatedWalletBalance": "Updated wallet balance",
+				"balanceCheck": "Balance check",
+				"sufficientFundsAvailable": "Sufficient funds available, skipping faucet request"
 			},
 			"progress": {
 				"loadingContracts": "Loading compiled contracts...",
 				"checkingEnvironment": "Checking IOTA CLI environment...",
 				"settingEnvironment": "Setting IOTA CLI environment...",
+				"importingDeployerAddress": "Importing deployer address to IOTA CLI...",
 				"deployingContract": "Deploying contract: {contractName} ({network})",
 				"updatingContractsFile": "Updating contracts file...",
-				"requestingFaucetFunds": "Requesting funds from {network} faucet..."
+				"requestingFaucetFunds": "Requesting funds from {network} faucet...",
+				"requestingAdditionalFaucetFunds": "Requesting additional funds from faucet..."
 			},
 			"messages": {},
 			"section": {

package/dist/types/commands/build.d.ts

@@ -1,5 +1,5 @@
+import { NetworkTypes } from "@twin.org/dlt-iota";
 import type { Command } from "commander";
-import { NetworkTypes } from "../models/networkTypes";
 /**
  * Build the build command to be consumed by the CLI.
  * @param program The command to build on.

package/dist/types/commands/deploy.d.ts

@@ -1,5 +1,5 @@
+import { NetworkTypes } from "@twin.org/dlt-iota";
 import type { Command } from "commander";
-import { NetworkTypes } from "../models/networkTypes";
 /**
  * Build the deploy command.
  * @param program The command program.

package/dist/types/index.d.ts

@@ -1,10 +1,7 @@
 export * from "./cli";
 export * from "./commands/build";
 export * from "./commands/deploy";
-export * from "./models/IContractData";
 export * from "./models/INetworkConfig";
-export * from "./models/ISmartContractDeployments";
-export * from "./models/networkTypes";
 export * from "./utils/envSetup";
 export * from "./utils/iotaUtils";
 export * from "./utils/moveToJsonUtils";

package/dist/types/models/INetworkConfig.d.ts

@@ -1,4 +1,4 @@
-import type { NetworkTypes } from "./networkTypes";
+import type { NetworkTypes } from "@twin.org/dlt-iota";
 /**
  * Network configuration interface
  */

package/dist/types/utils/envSetup.d.ts

@@ -1,4 +1,4 @@
-import type { NetworkTypes } from "../models/networkTypes.js";
+import type { NetworkTypes } from "@twin.org/dlt-iota";
 /**
  * Validate that required environment variables are set for deployment.
  * @param network The target network.

package/docs/changelog.md

@@ -1,5 +1,33 @@
 # @twin.org/move-to-json - Changelog
 
+## [0.0.2-next.5](https://github.com/twinfoundation/dlt/compare/move-to-json-v0.0.2-next.4...move-to-json-v0.0.2-next.5) (2025-08-25)
+
+
+### Bug Fixes
+
+* modifying logging type param ([#36](https://github.com/twinfoundation/dlt/issues/36)) ([b884fcc](https://github.com/twinfoundation/dlt/commit/b884fccef5bea5c6818cf8bfa8af197d3622cac6))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dlt-iota bumped from 0.0.2-next.4 to 0.0.2-next.5
+
+## [0.0.2-next.4](https://github.com/twinfoundation/dlt/compare/move-to-json-v0.0.2-next.3...move-to-json-v0.0.2-next.4) (2025-08-22)
+
+
+### Features
+
+* upgrade capabilities ([#32](https://github.com/twinfoundation/dlt/issues/32)) ([437219f](https://github.com/twinfoundation/dlt/commit/437219f0f784ec38353c01e1c8ce6bfba3b1b530))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dlt-iota bumped from 0.0.2-next.3 to 0.0.2-next.4
+
 ## [0.0.2-next.3](https://github.com/twinfoundation/dlt/compare/move-to-json-v0.0.2-next.2...move-to-json-v0.0.2-next.3) (2025-08-20)
 
 

package/docs/reference/functions/actionCommandBuild.md

@@ -18,7 +18,7 @@ Additional options.
 
 #### network?
 
-[`NetworkTypes`](../type-aliases/NetworkTypes.md)
+`NetworkTypes`
 
 Target network (testnet/devnet/mainnet) - optional if NETWORK env var is set.
 

package/docs/reference/functions/actionCommandDeploy.md

@@ -18,7 +18,7 @@ Path to compiled modules JSON.
 
 #### network?
 
-[`NetworkTypes`](../type-aliases/NetworkTypes.md)
+`NetworkTypes`
 
 Network identifier - optional if NETWORK env var is set.
 

package/docs/reference/functions/getDeploymentMnemonic.md

@@ -8,7 +8,7 @@ Get the deployment mnemonic for a network.
 
 ### network
 
-[`NetworkTypes`](../type-aliases/NetworkTypes.md)
+`NetworkTypes`
 
 The target network.
 

package/docs/reference/functions/getDeploymentSeed.md

@@ -8,7 +8,7 @@ Get the deployment seed for a network (if available).
 
 ### network
 
-[`NetworkTypes`](../type-aliases/NetworkTypes.md)
+`NetworkTypes`
 
 The target network.
 

package/docs/reference/functions/validateDeploymentEnvironment.md

@@ -8,7 +8,7 @@ Validate that required environment variables are set for deployment.
 
 ### network
 
-[`NetworkTypes`](../type-aliases/NetworkTypes.md)
+`NetworkTypes`
 
 The target network.
 

package/docs/reference/index.md

@@ -6,18 +6,8 @@
 
 ## Interfaces
 
-- [IContractData](interfaces/IContractData.md)
 - [INetworkConfig](interfaces/INetworkConfig.md)
 
-## Type Aliases
-
-- [ISmartContractDeployments](type-aliases/ISmartContractDeployments.md)
-- [NetworkTypes](type-aliases/NetworkTypes.md)
-
-## Variables
-
-- [NetworkTypes](variables/NetworkTypes.md)
-
 ## Functions
 
 - [buildCommandBuild](functions/buildCommandBuild.md)

package/docs/reference/interfaces/INetworkConfig.md

@@ -6,7 +6,7 @@ Network configuration interface
 
 ### network
 
-> **network**: [`NetworkTypes`](../type-aliases/NetworkTypes.md)
+> **network**: `NetworkTypes`
 
 The network type
 

package/locales/en.json

@@ -36,7 +36,8 @@
 				"noPackageData": "No package data found for contract in compiled modules",
 				"packageNotFoundOnNetwork": "Package {packageId} not found on network {network}. Please ensure the package is deployed.",
 				"dryRunInvalidConfig": "Dry run failed due to invalid configuration",
-				"noMoveTomlFilesFound": "No Move.toml files found in current directory or subdirectories. Make sure you're running this from a directory containing Move projects."
+				"noMoveTomlFilesFound": "No Move.toml files found in current directory or subdirectories. Make sure you're running this from a directory containing Move projects.",
+				"addressSwitchFailed": "Failed to switch to active address {targetAddress} for {network}. Active address: {activeAddress}"
 			}
 		},
 		"envSetup": {
@@ -122,7 +123,7 @@
 				"dryRunMode": "Dry Run Mode",
 				"forceMode": "Force Mode",
 				"deployedPackageId": "Deployed Package ID",
-				"upgradeCap": "Upgrade Cap",
+				"upgradeCapabilityId": "Upgrade Capability ID",
 				"gasUsed": "Gas Used",
 				"deploymentStatus": "Deployment Status",
 				"iotaEnvironmentCheck": "IOTA environment check",
@@ -139,7 +140,10 @@
 				"walletAddress": "Wallet Address",
 				"walletBalance": "Wallet Balance",
 				"deployedPackageIdResult": "Deployed Package ID",
-				"upgradeCapId": "UpgradeCap ID",
+				"upgradeCapabilityIdResult": "Upgrade Capability ID",
+				"migrationStateIdResult": "Migration State ID",
+				"importedDeployerAddress": "Imported deployer address",
+				"switchedActiveAddress": "Switched active address",
 				"moveProjectRoot": "Move Project Root",
 				"publishCommand": "Publish Command",
 				"workingDirectory": "Working Directory",
@@ -152,15 +156,20 @@
 				"balanceStatus": "Balance Status",
 				"faucetFundsRequested": "Faucet funds requested",
 				"faucetRequestFailed": "Faucet request failed for {network}: {error}",
-				"insufficientBalanceAfterFaucet": "Insufficient balance after faucet request on {network}: {balance} IOTA < {required} IOTA for wallet {walletAddress}. Attempting deployment anyway."
+				"insufficientBalanceAfterFaucet": "Insufficient balance after faucet request on {network}: {balance} IOTA < {required} IOTA for wallet {walletAddress}. Attempting deployment anyway.",
+				"updatedWalletBalance": "Updated wallet balance",
+				"balanceCheck": "Balance check",
+				"sufficientFundsAvailable": "Sufficient funds available, skipping faucet request"
 			},
 			"progress": {
 				"loadingContracts": "Loading compiled contracts...",
 				"checkingEnvironment": "Checking IOTA CLI environment...",
 				"settingEnvironment": "Setting IOTA CLI environment...",
+				"importingDeployerAddress": "Importing deployer address to IOTA CLI...",
 				"deployingContract": "Deploying contract: {contractName} ({network})",
 				"updatingContractsFile": "Updating contracts file...",
-				"requestingFaucetFunds": "Requesting funds from {network} faucet..."
+				"requestingFaucetFunds": "Requesting funds from {network} faucet...",
+				"requestingAdditionalFaucetFunds": "Requesting additional funds from faucet..."
 			},
 			"messages": {},
 			"section": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/move-to-json",
-	"version": "0.0.2-next.3",
+	"version": "0.0.2-next.5",
 	"description": "Tool to convert Move source files to JSON",
 	"repository": {
 		"type": "git",
@@ -18,7 +18,7 @@
 		"@twin.org/cli-core": "next",
 		"@twin.org/core": "next",
 		"@twin.org/crypto": "next",
-		"@twin.org/dlt-iota": "0.0.2-next.3",
+		"@twin.org/dlt-iota": "0.0.2-next.5",
 		"@twin.org/nameof": "next",
 		"@twin.org/wallet-connector-iota": "next",
 		"commander": "14.0.0",

package/dist/types/models/IContractData.d.ts

@@ -1,21 +0,0 @@
-/**
- * Interface for contract data stored in smart-contract-deployments.json
- */
-export interface IContractData {
-    /**
-     * Package ID generated during build
-     */
-    packageId: string;
-    /**
-     * Base64-encoded package bytecode
-     */
-    package: string | string[];
-    /**
-     * Package ID from actual deployment
-     */
-    deployedPackageId?: string;
-    /**
-     * UpgradeCap object ID for package upgrades
-     */
-    upgradeCap?: string;
-}

package/dist/types/models/ISmartContractDeployments.d.ts

@@ -1,8 +0,0 @@
-import type { IContractData } from "./IContractData";
-import type { NetworkTypes } from "./networkTypes";
-/**
- * Type for the smart-contract-deployments.json structure, mapping each network to its contract data.
- */
-export type ISmartContractDeployments = {
-    [K in NetworkTypes]?: IContractData;
-};

package/dist/types/models/networkTypes.d.ts

@@ -1,21 +0,0 @@
-/**
- * Network types supported for deployment
- */
-export declare const NetworkTypes: {
-    /**
-     * Testnet.
-     */
-    readonly Testnet: "testnet";
-    /**
-     * Devnet.
-     */
-    readonly Devnet: "devnet";
-    /**
-     * Mainnet.
-     */
-    readonly Mainnet: "mainnet";
-};
-/**
- * Network types supported for deployment
- */
-export type NetworkTypes = (typeof NetworkTypes)[keyof typeof NetworkTypes];

package/docs/reference/interfaces/IContractData.md

@@ -1,35 +0,0 @@
-# Interface: IContractData
-
-Interface for contract data stored in smart-contract-deployments.json
-
-## Properties
-
-### packageId
-
-> **packageId**: `string`
-
-Package ID generated during build
-
-***
-
-### package
-
-> **package**: `string` \| `string`[]
-
-Base64-encoded package bytecode
-
-***
-
-### deployedPackageId?
-
-> `optional` **deployedPackageId**: `string`
-
-Package ID from actual deployment
-
-***
-
-### upgradeCap?
-
-> `optional` **upgradeCap**: `string`
-
-UpgradeCap object ID for package upgrades

package/docs/reference/type-aliases/ISmartContractDeployments.md

@@ -1,5 +0,0 @@
-# Type Alias: ISmartContractDeployments
-
-> **ISmartContractDeployments** = `{ [K in NetworkTypes]?: IContractData }`
-
-Type for the smart-contract-deployments.json structure, mapping each network to its contract data.

package/docs/reference/type-aliases/NetworkTypes.md

@@ -1,5 +0,0 @@
-# Type Alias: NetworkTypes
-
-> **NetworkTypes** = *typeof* [`NetworkTypes`](../variables/NetworkTypes.md)\[keyof *typeof* [`NetworkTypes`](../variables/NetworkTypes.md)\]
-
-Network types supported for deployment

package/docs/reference/variables/NetworkTypes.md

@@ -1,25 +0,0 @@
-# Variable: NetworkTypes
-
-> `const` **NetworkTypes**: `object`
-
-Network types supported for deployment
-
-## Type declaration
-
-### Testnet
-
-> `readonly` **Testnet**: `"testnet"` = `"testnet"`
-
-Testnet.
-
-### Devnet
-
-> `readonly` **Devnet**: `"devnet"` = `"devnet"`
-
-Devnet.
-
-### Mainnet
-
-> `readonly` **Mainnet**: `"mainnet"` = `"mainnet"`
-
-Mainnet.