genlayer 0.27.0 → 0.28.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.28.0 (2025-09-03)
+
+### Features
+
+* improve how cli shows transactions receipts ([#250](https://github.com/yeagerai/genlayer-cli/issues/250)) ([610831a](https://github.com/yeagerai/genlayer-cli/commit/610831a23d0fc35b6b2d1ec0e1b1d88fb357c4b5))
+
 ## 0.27.0 (2025-09-01)
 
 ### Features

package/dist/index.js

@@ -17856,7 +17856,7 @@ var require_semver2 = __commonJS({
 import { program } from "commander";
 
 // package.json
-var version = "0.27.0";
+var version = "0.28.0";
 var package_default = {
   name: "genlayer",
   version,
@@ -43132,7 +43132,9 @@ var ReceiptAction = class extends BaseAction {
     status = TransactionStatus.FINALIZED,
     retries,
     interval,
-    rpc
+    rpc,
+    stdout,
+    stderr
   }) {
     const client = await this.getClient(rpc);
     await client.initializeConsensusSmartContract();
@@ -43148,6 +43150,22 @@ var ReceiptAction = class extends BaseAction {
         retries,
         interval
       });
+      if (stdout || stderr) {
+        const stdoutValue = result?.consensus_data?.leader_receipt[0]?.genvm_result?.stdout;
+        const stderrValue = result?.consensus_data?.leader_receipt[0]?.genvm_result?.stderr;
+        if (stdout && stderr) {
+          this.succeedSpinner("Transaction stdout and stderr", { stdout: stdoutValue, stderr: stderrValue });
+          return;
+        }
+        if (stdout) {
+          this.succeedSpinner("Transaction stdout retrieved successfully", stdoutValue);
+          return;
+        }
+        if (stderr) {
+          this.succeedSpinner("Transaction stderr retrieved successfully", stderrValue);
+          return;
+        }
+      }
       this.succeedSpinner("Transaction receipt retrieved successfully", result);
     } catch (error) {
       this.failSpinner("Error retrieving transaction receipt", error);
@@ -43190,7 +43208,7 @@ function parseIntOption(value, fallback2) {
 }
 function initializeTransactionsCommands(program2) {
   const validStatuses = Object.values(TransactionStatus).join(", ");
-  program2.command("receipt <txId>").description("Get transaction receipt by hash").option("--status <status>", `Transaction status to wait for (${validStatuses})`, TransactionStatus.FINALIZED).option("--retries <retries>", "Number of retries", (value) => parseIntOption(value, 100), 100).option("--interval <interval>", "Interval between retries in milliseconds", (value) => parseIntOption(value, 5e3), 5e3).option("--rpc <rpcUrl>", "RPC URL for the network").action(async (txId, options) => {
+  program2.command("receipt <txId>").description("Get transaction receipt by hash").option("--status <status>", `Transaction status to wait for (${validStatuses})`, TransactionStatus.FINALIZED).option("--retries <retries>", "Number of retries", (value) => parseIntOption(value, 100), 100).option("--interval <interval>", "Interval between retries in milliseconds", (value) => parseIntOption(value, 5e3), 5e3).option("--rpc <rpcUrl>", "RPC URL for the network").option("--stdout", "Print only stdout from the receipt").option("--stderr", "Print only stderr from the receipt").action(async (txId, options) => {
     const receiptAction = new ReceiptAction();
     await receiptAction.receipt({ txId, ...options });
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genlayer",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "GenLayer Command Line Tool",
   "main": "src/index.ts",
   "type": "module",

package/src/commands/transactions/index.ts

@@ -18,6 +18,8 @@ export function initializeTransactionsCommands(program: Command) {
     .option("--retries <retries>", "Number of retries", (value) => parseIntOption(value, 100), 100)
     .option("--interval <interval>", "Interval between retries in milliseconds", (value) => parseIntOption(value, 5000), 5000)
     .option("--rpc <rpcUrl>", "RPC URL for the network")
+    .option("--stdout", "Print only stdout from the receipt")
+    .option("--stderr", "Print only stderr from the receipt")
     .action(async (txId: TransactionHash, options: ReceiptOptions) => {
       const receiptAction = new ReceiptAction();
       

package/src/commands/transactions/receipt.ts

@@ -7,6 +7,8 @@ export interface ReceiptParams {
   retries?: number;
   interval?: number;
   rpc?: string;
+  stdout?: boolean;
+  stderr?: boolean;
 }
 
 export interface ReceiptOptions extends Omit<ReceiptParams, 'txId'> {}
@@ -37,6 +39,8 @@ export class ReceiptAction extends BaseAction {
     retries,
     interval,
     rpc,
+    stdout,
+    stderr,
   }: ReceiptParams): Promise<void> {
     const client = await this.getClient(rpc);
     await client.initializeConsensusSmartContract();
@@ -55,7 +59,29 @@ export class ReceiptAction extends BaseAction {
         retries,
         interval,
       });
-      
+
+      // If specific output flags are provided, print only those fields
+      if (stdout || stderr) {
+        const stdoutValue = (result as any)?.consensus_data?.leader_receipt[0]?.genvm_result?.stdout;
+        const stderrValue = (result as any)?.consensus_data?.leader_receipt[0]?.genvm_result?.stderr;
+
+        if (stdout && stderr) {
+          this.succeedSpinner("Transaction stdout and stderr", { stdout: stdoutValue, stderr: stderrValue });
+          return;
+        }
+
+        if (stdout) {
+          this.succeedSpinner("Transaction stdout retrieved successfully", stdoutValue);
+          return;
+        }
+
+        if (stderr) {
+          this.succeedSpinner("Transaction stderr retrieved successfully", stderrValue);
+          return;
+        }
+      }
+
+      // Default behavior (no flags): show full receipt result
       this.succeedSpinner("Transaction receipt retrieved successfully", result);
     } catch (error) {
       this.failSpinner("Error retrieving transaction receipt", error);

package/tests/actions/receipt.test.ts

@@ -170,4 +170,92 @@ describe("ReceiptAction", () => {
     }
   });
 
+  test("prints only stdout when --stdout is provided", async () => {
+    const mockReceipt = {
+      consensus_data: {
+        leader_receipt: [
+          {
+            genvm_result: {
+              stdout: "program stdout",
+              stderr: "program stderr",
+            },
+          },
+        ],
+      },
+    };
+
+    vi.mocked(mockClient.waitForTransactionReceipt).mockResolvedValue(mockReceipt as any);
+
+    await receiptAction.receipt({
+      txId: mockTxId,
+      retries: defaultRetries,
+      interval: defaultInterval,
+      stdout: true,
+    } as ReceiptParams);
+
+    expect(receiptAction["succeedSpinner"]).toHaveBeenCalledWith(
+      "Transaction stdout retrieved successfully",
+      "program stdout",
+    );
+  });
+
+  test("prints only stderr when --stderr is provided", async () => {
+    const mockReceipt = {
+      consensus_data: {
+        leader_receipt: [
+          {
+            genvm_result: {
+              stdout: "program stdout",
+              stderr: "program stderr",
+            },
+          },
+        ],
+      },
+    };
+
+    vi.mocked(mockClient.waitForTransactionReceipt).mockResolvedValue(mockReceipt as any);
+
+    await receiptAction.receipt({
+      txId: mockTxId,
+      retries: defaultRetries,
+      interval: defaultInterval,
+      stderr: true,
+    } as ReceiptParams);
+
+    expect(receiptAction["succeedSpinner"]).toHaveBeenCalledWith(
+      "Transaction stderr retrieved successfully",
+      "program stderr",
+    );
+  });
+
+  test("prints both stdout and stderr when both flags are provided", async () => {
+    const mockReceipt = {
+      consensus_data: {
+        leader_receipt: [
+          {
+            genvm_result: {
+              stdout: "program stdout",
+              stderr: "program stderr",
+            },
+          },
+        ],
+      },
+    };
+
+    vi.mocked(mockClient.waitForTransactionReceipt).mockResolvedValue(mockReceipt as any);
+
+    await receiptAction.receipt({
+      txId: mockTxId,
+      retries: defaultRetries,
+      interval: defaultInterval,
+      stdout: true,
+      stderr: true,
+    } as ReceiptParams);
+
+    expect(receiptAction["succeedSpinner"]).toHaveBeenCalledWith(
+      "Transaction stdout and stderr",
+      { stdout: "program stdout", stderr: "program stderr" },
+    );
+  });
+
 }); 

package/tests/commands/receipt.test.ts

@@ -105,4 +105,38 @@ describe("receipt command", () => {
       interval: 5000,
     });
   });
+
+  test("parses --stdout flag", async () => {
+    program.parse(["node", "test", "receipt", mockTxId, "--stdout"]);
+    expect(ReceiptAction.prototype.receipt).toHaveBeenCalledWith({
+      txId: mockTxId,
+      status: "FINALIZED",
+      retries: 100,
+      interval: 5000,
+      stdout: true,
+    });
+  });
+
+  test("parses --stderr flag", async () => {
+    program.parse(["node", "test", "receipt", mockTxId, "--stderr"]);
+    expect(ReceiptAction.prototype.receipt).toHaveBeenCalledWith({
+      txId: mockTxId,
+      status: "FINALIZED",
+      retries: 100,
+      interval: 5000,
+      stderr: true,
+    });
+  });
+
+  test("parses both --stdout and --stderr flags", async () => {
+    program.parse(["node", "test", "receipt", mockTxId, "--stdout", "--stderr"]);
+    expect(ReceiptAction.prototype.receipt).toHaveBeenCalledWith({
+      txId: mockTxId,
+      status: "FINALIZED",
+      retries: 100,
+      interval: 5000,
+      stdout: true,
+      stderr: true,
+    });
+  });
 });