genlayer 0.38.8 → 0.38.10

package/dist/index.js

@@ -20078,7 +20078,7 @@ var require_cli_table3 = __commonJS({
 import { program } from "commander";
 
 // package.json
-var version = "0.38.8";
+var version = "0.38.10";
 var package_default = {
   name: "genlayer",
   version,
@@ -20088,15 +20088,6 @@ var package_default = {
   bin: {
     genlayer: "./dist/index.js"
   },
-  files: [
-    "dist",
-    "scripts",
-    "templates",
-    ".env.example",
-    "docker-compose.yml",
-    "README.md",
-    "LICENSE"
-  ],
   scripts: {
     test: "vitest",
     "test:watch": "vitest --watch",
@@ -20157,7 +20148,7 @@ var package_default = {
     dotenv: "^17.0.0",
     ethers: "^6.13.4",
     "fs-extra": "^11.3.0",
-    "genlayer-js": "^0.23.0",
+    "genlayer-js": "^0.27.9",
     inquirer: "^12.0.0",
     keytar: "^7.9.0",
     "node-fetch": "^3.0.0",
@@ -50653,7 +50644,7 @@ var testnetBradbury = defineChain({
   defaultConsensusMaxRotations: 3
 });
 
-// node_modules/genlayer-js/dist/chunk-ZHBOSLFN.js
+// node_modules/genlayer-js/dist/chunk-EY35NPSE.js
 var CalldataAddress = class {
   constructor(addr) {
     __publicField(this, "bytes");
@@ -50780,6 +50771,12 @@ var transactionResultNumberToName = {
   "7": "MAJORITY_DISAGREE"
   /* MAJORITY_DISAGREE */
 };
+var executionResultNumberToName = {
+  "0": "NOT_VOTED",
+  "1": "FINISHED_WITH_RETURN",
+  "2": "FINISHED_WITH_ERROR"
+  /* FINISHED_WITH_ERROR */
+};
 var voteTypeNumberToName = {
   "0": "NOT_VOTED",
   "1": "AGREE",
@@ -51413,9 +51410,10 @@ function extractGenCallResult(result) {
 }
 var contractActions = (client, publicClient) => {
   return {
+    /** Retrieves the source code of a deployed contract. Localnet only. */
     getContractCode: async (address) => {
       if (client.chain.id !== localnet.id) {
-        throw new Error("Getting contract code is not supported on this network");
+        throw new Error(`getContractCode is only available on localnet (current chain: ${client.chain.name})`);
       }
       const result = await client.request({
         method: "gen_getContractCode",
@@ -51424,9 +51422,10 @@ var contractActions = (client, publicClient) => {
       const codeBytes = b64ToArray(result);
       return new TextDecoder().decode(codeBytes);
     },
+    /** Gets the schema (methods and constructor) of a deployed contract. Localnet only. */
     getContractSchema: async (address) => {
       if (client.chain.id !== localnet.id) {
-        throw new Error("Contract schema is not supported on this network");
+        throw new Error(`getContractSchema is only available on localnet (current chain: ${client.chain.name})`);
       }
       const schema = await client.request({
         method: "gen_getContractSchema",
@@ -51434,9 +51433,10 @@ var contractActions = (client, publicClient) => {
       });
       return schema;
     },
+    /** Generates a schema for contract code without deploying it. Localnet only. */
     getContractSchemaForCode: async (contractCode) => {
       if (client.chain.id !== localnet.id) {
-        throw new Error("Contract schema is not supported on this network");
+        throw new Error(`getContractSchema is only available on localnet (current chain: ${client.chain.name})`);
       }
       const schema = await client.request({
         method: "gen_getContractSchemaForCode",
@@ -51444,6 +51444,7 @@ var contractActions = (client, publicClient) => {
       });
       return schema;
     },
+    /** Executes a read-only contract call without modifying state. */
     readContract: async (args) => {
       const {
         account,
@@ -51481,6 +51482,7 @@ var contractActions = (client, publicClient) => {
       }
       return toJsonSafeDeep(decoded);
     },
+    /** Simulates a state-modifying contract call without executing on-chain. */
     simulateWriteContract: async (args) => {
       const {
         account,
@@ -51513,6 +51515,7 @@ var contractActions = (client, publicClient) => {
       const resultBinary = fromHex(prefixedResult, "bytes");
       return decode2(resultBinary);
     },
+    /** Executes a state-modifying function on a contract through consensus. Returns the transaction hash. */
     writeContract: async (args) => {
       const {
         account,
@@ -51543,6 +51546,7 @@ var contractActions = (client, publicClient) => {
         value
       });
     },
+    /** Deploys a new intelligent contract to GenLayer. Returns the transaction hash. */
     deployContract: async (args) => {
       const {
         account,
@@ -51574,6 +51578,7 @@ var contractActions = (client, publicClient) => {
         senderAccount
       });
     },
+    /** Calculates the minimum bond required to appeal a transaction. */
     getMinAppealBond: async (args) => {
       const { txId } = args;
       if (!client.chain.feeManagerContract?.address || !client.chain.roundsStorageContract?.address) {
@@ -51595,6 +51600,7 @@ var contractActions = (client, publicClient) => {
       });
       return minBond;
     },
+    /** Appeals a consensus transaction to trigger a new round of validation. */
     appealTransaction: async (args) => {
       const { account, txId } = args;
       let { value } = args;
@@ -51638,6 +51644,17 @@ var validateAccount = (Account4) => {
   }
   return Account4;
 };
+var CREATED_TRANSACTION_EVENT_ABI = [
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "bytes32", name: "txId", type: "bytes32" },
+      { indexed: false, internalType: "uint256", name: "txSlot", type: "uint256" }
+    ],
+    name: "CreatedTransaction",
+    type: "event"
+  }
+];
 var ADD_TRANSACTION_ABI_V5 = [
   {
     type: "function",
@@ -51752,6 +51769,25 @@ var isAddTransactionAbiMismatchError = (error) => {
   ].filter(Boolean).join(" ").toLowerCase();
   return errorMessage.includes("invalid pointer in tuple") || errorMessage.includes("invalid pointer") || errorMessage.includes("could not decode") || errorMessage.includes("invalid arrayify value") || errorMessage.includes("types/value length mismatch");
 };
+var extractTxIdFromLogs = (client, logs) => {
+  const newTxEvents = parseEventLogs({
+    abi: client.chain.consensusMainContract?.abi,
+    eventName: "NewTransaction",
+    logs
+  });
+  if (newTxEvents.length > 0) {
+    return newTxEvents[0].args["txId"];
+  }
+  const createdTxEvents = parseEventLogs({
+    abi: CREATED_TRANSACTION_EVENT_ABI,
+    eventName: "CreatedTransaction",
+    logs
+  });
+  if (createdTxEvents.length > 0) {
+    return createdTxEvents[0].args["txId"];
+  }
+  return null;
+};
 var _sendTransaction = async ({
   client,
   publicClient,
@@ -51761,7 +51797,7 @@ var _sendTransaction = async ({
   value = 0n
 }) => {
   if (!client.chain.consensusMainContract?.address) {
-    throw new Error("Consensus main contract not initialized. Please ensure client is properly initialized.");
+    throw new Error(`Consensus main contract address not found in chain config for "${client.chain.name}".`);
   }
   const validatedSenderAccount = validateAccount(senderAccount);
   const nonce = await client.getCurrentNonce({ address: validatedSenderAccount.address });
@@ -51780,7 +51816,7 @@ var _sendTransaction = async ({
     }
     if (validatedSenderAccount?.type === "local") {
       if (!validatedSenderAccount?.signTransaction) {
-        throw new Error("Account does not support signTransaction");
+        throw new Error("Local account does not support signTransaction. Use a private key account created via privateKeyToAccount().");
       }
       const gasPriceHex2 = await client.request({
         method: "eth_gasPrice"
@@ -51800,17 +51836,15 @@ var _sendTransaction = async ({
       const txHash = await client.sendRawTransaction({ serializedTransaction });
       const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
       if (receipt.status === "reverted") {
-        throw new Error("Transaction reverted");
+        throw new Error(`Transaction reverted: EVM tx ${txHash} to consensus contract ${client.chain.consensusMainContract?.address} was reverted.`);
       }
-      const newTxEvents = parseEventLogs({
-        abi: client.chain.consensusMainContract?.abi,
-        eventName: "NewTransaction",
-        logs: receipt.logs
-      });
-      if (newTxEvents.length === 0) {
-        throw new Error("Transaction not processed by consensus");
+      const txId = extractTxIdFromLogs(client, receipt.logs);
+      if (!txId) {
+        throw new Error(
+          `Transaction not processed by consensus: EVM tx ${txHash} succeeded but no NewTransaction or CreatedTransaction event was found in the receipt logs.`
+        );
       }
-      return newTxEvents[0].args["txId"];
+      return txId;
     }
     let gasPriceHex;
     try {
@@ -51836,10 +51870,21 @@ var _sendTransaction = async ({
       chainId: `0x${client.chain.id.toString(16)}`,
       ...gasPriceHex ? { gasPrice: gasPriceHex } : {}
     };
-    return await client.request({
+    const evmTxHash = await client.request({
       method: "eth_sendTransaction",
       params: [formattedRequest]
     });
+    const externalReceipt = await publicClient.waitForTransactionReceipt({ hash: evmTxHash });
+    if (externalReceipt.status === "reverted") {
+      throw new Error(`Transaction reverted: EVM tx ${evmTxHash} to consensus contract ${client.chain.consensusMainContract?.address} was reverted.`);
+    }
+    const externalTxId = extractTxIdFromLogs(client, externalReceipt.logs);
+    if (!externalTxId) {
+      throw new Error(
+        `Transaction not processed by consensus: EVM tx ${evmTxHash} succeeded but no NewTransaction or CreatedTransaction event was found in the receipt logs.`
+      );
+    }
+    return externalTxId;
   };
   try {
     return await sendWithEncodedData(encodedData);
@@ -51960,6 +52005,8 @@ var decodeTransaction = (tx) => {
     },
     statusName: transactionsStatusNumberToName[String(tx.status)],
     resultName: transactionResultNumberToName[String(tx.result)],
+    txExecutionResult: tx.txExecutionResult !== void 0 ? Number(tx.txExecutionResult) : void 0,
+    txExecutionResultName: tx.txExecutionResult !== void 0 ? executionResultNumberToName[String(tx.txExecutionResult)] : void 0,
     lastRound: {
       ...tx.lastRound,
       round: tx.lastRound?.round?.toString() ?? "0",
@@ -52093,6 +52140,7 @@ var decodeLocalnetTransaction = (tx) => {
   return tx;
 };
 var receiptActions = (client, publicClient) => ({
+  /** Polls until a transaction reaches the specified status. Returns the transaction receipt. */
   waitForTransactionReceipt: async ({
     hash: hash3,
     status = "ACCEPTED",
@@ -52104,7 +52152,7 @@ var receiptActions = (client, publicClient) => ({
       hash: hash3
     });
     if (!transaction) {
-      throw new Error("Transaction not found");
+      throw new Error(`Transaction not found: ${hash3}`);
     }
     const transactionStatusString = String(transaction.status);
     const requestedStatus = transactionsStatusNameToNumber[status];
@@ -52119,7 +52167,7 @@ var receiptActions = (client, publicClient) => ({
       return finalTransaction;
     }
     if (retries === 0) {
-      throw new Error("Transaction status is not " + status);
+      throw new Error(`Timed out waiting for transaction ${hash3} to reach status "${status}" (current status: ${transactionStatusString}).`);
     }
     await sleep(interval);
     return receiptActions(client, publicClient).waitForTransactionReceipt({
@@ -52132,6 +52180,7 @@ var receiptActions = (client, publicClient) => ({
   }
 });
 var transactionActions = (client, publicClient) => ({
+  /** Fetches transaction data including status, execution result, and consensus details. */
   getTransaction: async ({ hash: hash3 }) => {
     if (client.chain.isStudio) {
       const transaction2 = await client.getTransaction({ hash: hash3 });
@@ -52140,18 +52189,62 @@ var transactionActions = (client, publicClient) => ({
       transaction2.statusName = localnetStatus;
       return decodeLocalnetTransaction(transaction2);
     }
-    const transaction = await publicClient.readContract({
-      address: client.chain.consensusDataContract?.address,
-      abi: client.chain.consensusDataContract?.abi,
-      functionName: "getTransactionData",
-      args: [
-        hash3,
-        Math.round((/* @__PURE__ */ new Date()).getTime() / 1e3)
-        // unix seconds
-      ]
-    });
+    const contractAddress = client.chain.consensusDataContract?.address;
+    const contractAbi = client.chain.consensusDataContract?.abi;
+    const [txDataRaw, allDataRaw] = await Promise.all([
+      publicClient.readContract({
+        address: contractAddress,
+        abi: contractAbi,
+        functionName: "getTransactionData",
+        args: [hash3, Math.round((/* @__PURE__ */ new Date()).getTime() / 1e3)]
+      }),
+      publicClient.readContract({
+        address: contractAddress,
+        abi: contractAbi,
+        functionName: "getTransactionAllData",
+        args: [hash3]
+      })
+    ]);
+    const txData = txDataRaw;
+    const [txAllData, _roundsData] = allDataRaw;
+    const transaction = {
+      ...txData,
+      txExecutionResult: Number(txAllData.txExecutionResult)
+    };
     return decodeTransaction(transaction);
   },
+  /** Returns transaction IDs of child transactions created from emitted messages. */
+  getTriggeredTransactionIds: async ({ hash: hash3 }) => {
+    if (client.chain.isStudio) {
+      const tx2 = await client.getTransaction({ hash: hash3 });
+      return tx2.triggered_transactions ?? [];
+    }
+    const tx = await transactionActions(client, publicClient).getTransaction({ hash: hash3 });
+    const proposalBlock = BigInt(tx.readStateBlockRange?.proposalBlock ?? "0");
+    if (proposalBlock === BigInt(0)) return [];
+    const scanRange = BigInt(100);
+    const latestBlock = await publicClient.getBlockNumber();
+    const toBlock = proposalBlock + scanRange < latestBlock ? proposalBlock + scanRange : latestBlock;
+    const consensusAddress = client.chain.consensusMainContract?.address;
+    const internalMessageProcessedTopic = keccak256(stringToBytes("InternalMessageProcessed(bytes32,address,address)"));
+    const logs = await publicClient.getLogs({
+      address: consensusAddress,
+      event: void 0,
+      fromBlock: proposalBlock,
+      toBlock,
+      topics: [internalMessageProcessedTopic, hash3]
+    });
+    return logs.map((log) => log.topics[1]).filter(Boolean);
+  },
+  /** Fetches the full execution trace including return data, stdout, stderr, and GenVM logs. */
+  debugTraceTransaction: async ({ hash: hash3, round = 0 }) => {
+    const result = await client.request({
+      method: "gen_dbg_traceTransaction",
+      params: [{ txID: hash3, round }]
+    });
+    return result;
+  },
+  /** Cancels a pending transaction. Studio networks only. */
   cancelTransaction: async ({ hash: hash3 }) => {
     if (!client.chain.isStudio) {
       throw new Error("cancelTransaction is only available on studio-based chains (localnet/studionet)");
@@ -52179,6 +52272,33 @@ var transactionActions = (client, publicClient) => ({
       params: [hash3, signature]
     });
   },
+  /** Returns the queue slot position of a transaction in the pending queue. */
+  getTransactionQueuePosition: async ({ hash: hash3 }) => {
+    const consensusAddress = client.chain.consensusMainContract?.address;
+    const consensusAbi = client.chain.consensusMainContract?.abi;
+    const queuesAddress = await publicClient.readContract({
+      address: consensusAddress,
+      abi: consensusAbi,
+      functionName: "queues"
+    });
+    const QUEUES_ABI = [
+      {
+        inputs: [{ internalType: "bytes32", name: "txId", type: "bytes32" }],
+        name: "getTransactionQueuePosition",
+        outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+        stateMutability: "view",
+        type: "function"
+      }
+    ];
+    const position = await publicClient.readContract({
+      address: queuesAddress,
+      abi: QUEUES_ABI,
+      functionName: "getTransactionQueuePosition",
+      args: [hash3]
+    });
+    return Number(position);
+  },
+  /** Estimates gas required for a transaction. */
   estimateTransactionGas: async (transactionParams) => {
     const formattedParams = {
       from: transactionParams.from || client.account?.address,
@@ -52450,6 +52570,7 @@ var stakingActions = (client, publicClient) => {
     });
   };
   return {
+    /** Joins as a validator with the specified stake amount. */
     validatorJoin: async (options) => {
       const amount = parseStakingAmount(options.amount);
       const stakingAddress = getStakingAddress();
@@ -52491,6 +52612,7 @@ var stakingActions = (client, publicClient) => {
         amountRaw: amount
       };
     },
+    /** Adds additional self-stake to an active validator position. */
     validatorDeposit: async (options) => {
       const amount = parseStakingAmount(options.amount);
       const data = encodeFunctionData({
@@ -52499,6 +52621,7 @@ var stakingActions = (client, publicClient) => {
       });
       return executeWrite({ to: getStakingAddress(), data, value: amount });
     },
+    /** Exits a validator position by burning the specified shares. */
     validatorExit: async (options) => {
       const shares = typeof options.shares === "string" ? BigInt(options.shares) : options.shares;
       const data = encodeFunctionData({
@@ -52508,6 +52631,7 @@ var stakingActions = (client, publicClient) => {
       });
       return executeWrite({ to: getStakingAddress(), data });
     },
+    /** Claims pending validator withdrawals. */
     validatorClaim: async (options) => {
       if (!options?.validator && !client.account) {
         throw new Error("Either provide validator address or initialize client with an account");
@@ -52521,6 +52645,7 @@ var stakingActions = (client, publicClient) => {
       const result = await executeWrite({ to: getStakingAddress(), data });
       return { ...result, claimedAmount: 0n };
     },
+    /** Primes a validator for participation in the next epoch. */
     validatorPrime: async (options) => {
       const data = encodeFunctionData({
         abi: STAKING_ABI,
@@ -52529,6 +52654,7 @@ var stakingActions = (client, publicClient) => {
       });
       return executeWrite({ to: getStakingAddress(), data });
     },
+    /** Sets the operator address for a validator wallet. */
     setOperator: async (options) => {
       const data = encodeFunctionData({
         abi: VALIDATOR_WALLET_ABI,
@@ -52537,6 +52663,7 @@ var stakingActions = (client, publicClient) => {
       });
       return executeWrite({ to: options.validator, data });
     },
+    /** Sets validator identity information (name, website, social links). */
     setIdentity: async (options) => {
       let extraCidBytes = "0x";
       if (options.extraCid) {
@@ -52563,6 +52690,7 @@ var stakingActions = (client, publicClient) => {
       });
       return executeWrite({ to: options.validator, data });
     },
+    /** Delegates stake to a validator. */
     delegatorJoin: async (options) => {
       const amount = parseStakingAmount(options.amount);
       const data = encodeFunctionData({
@@ -52579,6 +52707,7 @@ var stakingActions = (client, publicClient) => {
         amountRaw: amount
       };
     },
+    /** Exits a delegation by burning the specified shares. */
     delegatorExit: async (options) => {
       const shares = typeof options.shares === "string" ? BigInt(options.shares) : options.shares;
       const data = encodeFunctionData({
@@ -52588,6 +52717,7 @@ var stakingActions = (client, publicClient) => {
       });
       return executeWrite({ to: getStakingAddress(), data });
     },
+    /** Claims pending delegator withdrawals. */
     delegatorClaim: async (options) => {
       if (!options.delegator && !client.account) {
         throw new Error("Either provide delegator address or initialize client with an account");
@@ -52600,10 +52730,12 @@ var stakingActions = (client, publicClient) => {
       });
       return executeWrite({ to: getStakingAddress(), data });
     },
+    /** Checks if an address is an active validator. */
     isValidator: async (address) => {
       const contract = getReadOnlyStakingContract();
       return contract.read.isValidator([address]);
     },
+    /** Returns comprehensive information about a validator including stake, identity, and status. */
     getValidatorInfo: async (validator) => {
       const contract = getReadOnlyStakingContract();
       const isVal = await contract.read.isValidator([validator]);
@@ -52683,6 +52815,7 @@ var stakingActions = (client, publicClient) => {
         pendingWithdrawals
       };
     },
+    /** Returns delegation stake information for a delegator-validator pair. */
     getStakeInfo: async (delegator, validator) => {
       const contract = getReadOnlyStakingContract();
       const shares = await contract.read.sharesOf([delegator, validator]);
@@ -52736,6 +52869,7 @@ var stakingActions = (client, publicClient) => {
         pendingWithdrawals
       };
     },
+    /** Returns current epoch information including timing, stake requirements, and inflation data. */
     getEpochInfo: async () => {
       const contract = getReadOnlyStakingContract();
       const [
@@ -52792,6 +52926,7 @@ var stakingActions = (client, publicClient) => {
         delegatorMinStakeRaw: delMinStake
       };
     },
+    /** Returns detailed data for a specific epoch. */
     getEpochData: async (epochNumber) => {
       const contract = getReadOnlyStakingContract();
       const [currentEpoch, epochOdd, epochEven] = await Promise.all([
@@ -52820,19 +52955,23 @@ var stakingActions = (client, publicClient) => {
         slashed: raw[10]
       };
     },
+    /** Returns addresses of all currently active validators. */
     getActiveValidators: async () => {
       const contract = getReadOnlyStakingContract();
       const validators = await contract.read.activeValidators();
       return validators.filter((v) => v !== "0x0000000000000000000000000000000000000000");
     },
+    /** Returns the count of active validators. */
     getActiveValidatorsCount: async () => {
       const contract = getReadOnlyStakingContract();
       return contract.read.activeValidatorsCount();
     },
+    /** Returns addresses of validators currently in quarantine. */
     getQuarantinedValidators: async () => {
       const contract = getReadOnlyStakingContract();
       return contract.read.getValidatorQuarantineList();
     },
+    /** Returns banned validators with ban duration and permanent ban status. */
     getBannedValidators: async (startIndex = 0n, size5 = 100n) => {
       const contract = getReadOnlyStakingContract();
       const result = await contract.read.getAllBannedValidators([startIndex, size5]);
@@ -52842,6 +52981,7 @@ var stakingActions = (client, publicClient) => {
         permanentlyBanned: v.permanentlyBanned
       }));
     },
+    /** Returns detailed quarantine information with pagination. */
     getQuarantinedValidatorsDetailed: async (startIndex = 0n, size5 = 100n) => {
       const contract = getReadOnlyStakingContract();
       const result = await contract.read.getAllQuarantinedValidators([startIndex, size5]);
@@ -52869,11 +53009,19 @@ function chainActions(_client) {
     }
   };
 }
+var PROVIDER_METHODS = /* @__PURE__ */ new Set([
+  "eth_accounts",
+  "eth_requestAccounts",
+  "eth_sendTransaction",
+  "eth_signTransaction",
+  "personal_sign",
+  "eth_signTypedData_v4"
+]);
 var getCustomTransportConfig = (config, chainConfig) => {
   const isAddress2 = typeof config.account !== "object";
   return {
     async request({ method, params = [] }) {
-      if (method.startsWith("eth_") && isAddress2) {
+      if (PROVIDER_METHODS.has(method) && isAddress2) {
         const provider = config.provider || (typeof window !== "undefined" ? window.ethereum : void 0);
         if (provider) {
           try {
@@ -52884,29 +53032,27 @@ var getCustomTransportConfig = (config, chainConfig) => {
           }
         }
       }
-      {
-        try {
-          const response = await fetch(chainConfig.rpcUrls.default.http[0], {
-            method: "POST",
-            headers: {
-              "Content-Type": "application/json"
-            },
-            body: JSON.stringify({
-              jsonrpc: "2.0",
-              id: Date.now(),
-              method,
-              params
-            })
-          });
-          const data = await response.json();
-          if (data.error) {
-            throw data.error;
-          }
-          return data.result;
-        } catch (err) {
-          console.error(`Error fetching ${method} from GenLayer RPC`);
-          throw err;
+      try {
+        const response = await fetch(chainConfig.rpcUrls.default.http[0], {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: Date.now(),
+            method,
+            params
+          })
+        });
+        const data = await response.json();
+        if (data.error) {
+          throw data.error;
         }
+        return data.result;
+      } catch (err) {
+        console.error(`GenLayer RPC error (${method}):`, err.message || err);
+        throw err;
       }
     }
   };
@@ -53928,6 +54074,9 @@ Run npm install -g genlayer to update
 `);
     }
   }
+  async ensureDockerRunning() {
+    await this.docker.ping();
+  }
   async checkInstallRequirements() {
     const requirementsInstalled = {
       docker: false
@@ -54278,6 +54427,16 @@ var StartAction = class extends BaseAction {
     this.simulatorService.setComposeOptions(headless, ollama);
     this.startSpinner("Checking CLI version...");
     await this.simulatorService.checkCliVersion();
+    this.setSpinnerText("Checking Docker...");
+    try {
+      await this.simulatorService.ensureDockerRunning();
+    } catch (error) {
+      this.failSpinner(
+        "Docker is not running. Please start Docker Desktop and try again.",
+        error
+      );
+      return;
+    }
     const isRunning = await this.simulatorService.isLocalnetRunning();
     if (isRunning) {
       this.stopSpinner();

package/docs/api-references/_meta.json

@@ -0,0 +1,9 @@
+{
+  "environment": "Environment",
+  "configuration": "Configuration",
+  "contracts": "Contracts",
+  "transactions": "Transactions",
+  "accounts": "Accounts",
+  "staking": "Staking",
+  "localnet": "Localnet"
+}

package/docs/api-references/accounts/_meta.json

@@ -0,0 +1,3 @@
+{
+  "account": "account"
+}

package/docs/api-references/accounts/account/create.mdx

@@ -0,0 +1,19 @@
+---
+title: account create
+---
+
+Create a new account with encrypted keystore
+
+### Usage
+
+`$ genlayer account create [options]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --name <name> | Name for the account | No |  |
+|  | --password <password> | Password for the keystore (skips interactive prompt) | No |  |
+|  | --overwrite | Overwrite existing account | No | `false` |
+|  | --no-set-active | Do not set as active account | No |  |
+| -h | --help | display help for command | No |  |