fix(docs-sync): stop overwriting the generated root _meta.json

.github/workflows/sync-docs.yml

@@ -72,30 +72,6 @@ jobs:
           rsync -a "${{ github.workspace }}/docs/api-references/" pages/api-references/genlayer-cli/
           # Copy README as sibling file (strip badges/emojis)
           sed -E '/^\[!\[.*\]\(https:\/\/(img\.shields\.io|dcbadge|badge\.fury)/d' "${{ github.workspace }}/README.md" > pages/api-references/genlayer-cli.mdx
-          # Write _meta.json
-          cat > pages/api-references/genlayer-cli/_meta.json << 'METAEOF'
-          {
-            "init": "init",
-            "up": "up",
-            "stop": "stop",
-            "new": "new",
-            "config": "config",
-            "network": "network",
-            "deploy": "deploy",
-            "call": "call",
-            "write": "write",
-            "schema": "schema",
-            "code": "code",
-            "receipt": "receipt",
-            "trace": "trace",
-            "appeal": "appeal",
-            "appeal-bond": "appeal-bond",
-            "account": "account",
-            "staking": "staking",
-            "localnet": "localnet",
-            "update": "update"
-          }
-          METAEOF
           if [ -z "$(git status --porcelain)" ]; then
             echo "No changes to commit"
             exit 0

docs/api-references/_meta.json

@@ -1,9 +1,13 @@
 {
+  "index": "Overview",
   "environment": "Environment",
   "configuration": "Configuration",
   "contracts": "Contracts",
   "transactions": "Transactions",
   "accounts": "Accounts",
   "staking": "Staking",
-  "localnet": "Localnet"
+  "localnet": "Localnet",
+  "estimate-fees": "estimate-fees",
+  "finalize": "finalize",
+  "finalize-batch": "finalize-batch"
 }

docs/api-references/contracts/deploy.mdx

@@ -14,4 +14,7 @@ Deploy intelligent contracts
 | --- | --- | --- | :---: | --- |
 |  | --contract <contractPath> | Path to the smart contract to deploy | No |  |
 |  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --fees <json> | Transaction fee options JSON passed to genlayer-js. | No |  |
+|  | --fee-value <wei> | Fee deposit value to send with the transaction | No |  |
+|  | --valid-until <unixTimestamp> | Unix timestamp after which the transaction is invalid | No |  |
 | -h | --help | display help for command | No |  |

docs/api-references/contracts/write.mdx

@@ -18,4 +18,7 @@ Sends a transaction to a contract method that modifies the state
 | Short | Long | Description | Required | Default |
 | --- | --- | --- | :---: | --- |
 |  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --fees <json> | Transaction fee options JSON passed to genlayer-js. | No |  |
+|  | --fee-value <wei> | Fee deposit value to send with the transaction | No |  |
+|  | --valid-until <unixTimestamp> | Unix timestamp after which the transaction is invalid | No |  |
 | -h | --help | display help for command | No |  |

docs/api-references/estimate-fees.mdx

@@ -0,0 +1,25 @@
+---
+title: estimate-fees
+---
+
+Build a transaction fee preset, optionally from a Studio/localnet write
+simulation
+
+### Usage
+
+`$ genlayer estimate-fees [options] [contractAddress] [method]`
+
+### Arguments
+
+- `[contractAddress]`
+- `[method]`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --rpc <rpcUrl> | RPC URL for the network | No |  |
+|  | --fees <json> | Fee estimate options JSON passed to genlayer-js estimateTransactionFees. | No |  |
+|  | --json | Print the fee estimate as JSON without spinner output | No |  |
+|  | --include-report | Include simulation fee accounting/report in the generated estimate output | No |  |
+| -h | --help | display help for command | No |  |

docs/api-references/finalize-batch.mdx

@@ -0,0 +1,20 @@
+---
+title: finalize-batch
+---
+
+Finalize a batch of idle transactions in a single call (public call)
+
+### Usage
+
+`$ genlayer finalize-batch [options] <txIds...>`
+
+### Arguments
+
+- `<txIds...>`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --rpc &lt;rpcUrl&gt; | RPC URL for the network | No |  |
+| -h | --help | display help for command | No |  |

docs/api-references/finalize.mdx

@@ -0,0 +1,20 @@
+---
+title: finalize
+---
+
+Finalize a transaction that is ready to be finalized (public call)
+
+### Usage
+
+`$ genlayer finalize [options] <txId>`
+
+### Arguments
+
+- `<txId>`
+
+### Options
+
+| Short | Long | Description | Required | Default |
+| --- | --- | --- | :---: | --- |
+|  | --rpc &lt;rpcUrl&gt; | RPC URL for the network | No |  |
+| -h | --help | display help for command | No |  |

docs/api-references/index.mdx

@@ -6,7 +6,7 @@ GenLayer CLI is a development environment for the GenLayer ecosystem. It allows
 developers to interact with the protocol by creating accounts, sending
 transactions, and working with Intelligent Contracts by testing, debugging, and
 deploying them.
-Version: `0.34.0`
+Version: `0.39.1`
 
 ### Command List
 
@@ -17,6 +17,7 @@ Version: `0.34.0`
 - `genlayer deploy` — Deploy intelligent contracts
 - `genlayer call` — Call a contract method without sending a transaction or changing the state
 - `genlayer write` — Sends a transaction to a contract method that modifies the state
+- `genlayer estimate-fees` — Build a transaction fee preset, optionally from a Studio/localnet write simulation
 - `genlayer schema` — Get the schema for a deployed contract
 - `genlayer code` — Get the source for a deployed contract
 - `genlayer config` — Manage CLI configuration, including the default network
@@ -28,6 +29,8 @@ Version: `0.34.0`
 - `genlayer appeal` — Appeal a transaction by its hash
 - `genlayer appeal-bond` — Show minimum appeal bond required for a transaction
 - `genlayer trace` — Get execution trace for a transaction (return data, stdout, stderr, GenVM logs)
+- `genlayer finalize` — Finalize a transaction that is ready to be finalized (public call)
+- `genlayer finalize-batch` — Finalize a batch of idle transactions in a single call (public call)
 - `genlayer staking` — Staking operations for validators and delegators
 
 ---

docs/api-references/transactions/receipt.mdx

@@ -16,7 +16,7 @@ Get transaction receipt by hash
 
 | Short | Long | Description | Required | Default |
 | --- | --- | --- | :---: | --- |
-|  | --status <status> | Transaction status to wait for (UNINITIALIZED, PENDING, PROPOSING, COMMITTING, REVEALING, ACCEPTED, UNDETERMINED, FINALIZED, CANCELED, APPEAL_REVEALING, APPEAL_COMMITTING, READY_TO_FINALIZE, VALIDATORS_TIMEOUT, LEADER_TIMEOUT) (default: "FINALIZED") | No |  |
+|  | --status <status> | Transaction status to wait for (UNINITIALIZED, PENDING, PROPOSING, COMMITTING, REVEALING, ACCEPTED, UNDETERMINED, FINALIZED, CANCELED, APPEAL_REVEALING, APPEAL_COMMITTING, READY_TO_FINALIZE, VALIDATORS_TIMEOUT, LEADER_TIMEOUT, LEADER_REVEALING) | No | `FINALIZED` |
 |  | --retries <retries> | Number of retries | No | `100` |
 |  | --interval <interval> | Interval between retries in milliseconds (default: 5000) | No |  |
 |  | --rpc <rpcUrl> | RPC URL for the network | No |  |

scripts/generate-cli-docs.mjs

@@ -294,10 +294,18 @@ async function main() {
     'staking': 'Staking',
     'localnet': 'Localnet',
   };
-  const rootMeta = {};
+  const rootMeta = { index: 'Overview' };
   for (const [key, label] of Object.entries(GROUP_LABELS)) {
     rootMeta[key] = label;
   }
+  // Ungrouped top-level commands (e.g. finalize) still need nav entries
+  const ungrouped = outputs
+    .filter((o) => o.relDir === '' && o.filename !== 'index.mdx')
+    .map((o) => o.filename.replace(/\.mdx$/, ''))
+    .sort();
+  for (const slug of ungrouped) {
+    if (!rootMeta[slug]) rootMeta[slug] = slug;
+  }
   await fs.writeFile(path.join(rootOut, '_meta.json'), JSON.stringify(rootMeta, null, 2), 'utf8');
 
   // Write _meta.json for each group subdirectory