From 4356beedb12a6c9ba9fc3651c60b421860f35c06 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gergely=20B=C3=A9k=C3=A9si?= <gergely.bekesi@ethswarm.org>
Date: Mon, 21 Sep 2026 13:56:54 +0200
Subject: [PATCH 1/2] feat: make Bytes primitive inspectable

---
 src/bytes/bytes.ts       | 20 ++++++++++++++++++--
 test/typed-bytes.test.ts | 18 +++++++++++++++++-
 2 files changed, 35 insertions(+), 3 deletions(-)

diff --git a/src/bytes/bytes.ts b/src/bytes/bytes.ts
index b2748c7..b3a6daf 100644
--- a/src/bytes/bytes.ts
+++ b/src/bytes/bytes.ts
@@ -6,6 +6,8 @@ const ENCODER = new TextEncoder()
 
 const HEX_PATTERN = /^(0x)?[0-9a-fA-F]*$/i
 
+const INSPECT: unique symbol = Symbol.for('nodejs.util.inspect.custom')
+
 function hasToHexMethod(value: unknown): value is { toHex(): string } {
   return typeof value === 'object' && value !== null && typeof (value as { toHex?: unknown }).toHex === 'function'
 }
@@ -154,12 +156,19 @@ export class Bytes {
   }
 
   /**
-   * Decodes the bytes as UTF-8 JSON.
+   * Parses the bytes as UTF-8 JSON.
    */
-  public toJSON(): unknown {
+  public parseJson(): unknown {
     return JSON.parse(this.toUtf8())
   }
 
+  /**
+   * Serialized as its hex string by `JSON.stringify`.
+   */
+  public toJSON(): string {
+    return this.toHex()
+  }
+
   /**
    * Byte-wise equality against another Bytes instance, raw bytes, or hex string.
    */
@@ -173,4 +182,11 @@ export class Bytes {
   public represent(): string {
     return this.toHex()
   }
+
+  /**
+   * Printed as its hex string by `console.log` and `util.inspect` in Node.
+   */
+  public [INSPECT](): string {
+    return this.represent()
+  }
 }
diff --git a/test/typed-bytes.test.ts b/test/typed-bytes.test.ts
index c3fca99..3361efc 100644
--- a/test/typed-bytes.test.ts
+++ b/test/typed-bytes.test.ts
@@ -1,3 +1,4 @@
+import { inspect } from 'node:util'
 import { describe, expect, it } from 'vitest'
 import { keccak256 } from '../src/crypto/keccak.js'
 import { BatchId } from '../src/bytes/batch-id.js'
@@ -63,7 +64,22 @@ describe('Bytes', () => {
 
   it('parses JSON from its UTF-8 content', () => {
     const bytes = Bytes.fromUtf8(JSON.stringify({ a: 1 }))
-    expect(bytes.toJSON()).toEqual({ a: 1 })
+    expect(bytes.parseJson()).toEqual({ a: 1 })
+  })
+
+  it('stringifies to hex, standalone and as a property', () => {
+    const id = new BatchId('ab'.repeat(32))
+    expect(id.toJSON()).toBe('ab'.repeat(32))
+    expect(JSON.stringify(id)).toBe(`"${'ab'.repeat(32)}"`)
+    expect(JSON.stringify({ id })).toBe(`{"id":"${'ab'.repeat(32)}"}`)
+    expect(`${id}`).toBe('ab'.repeat(32))
+  })
+
+  it('inspects as hex, standalone and nested', () => {
+    const id = new BatchId('ab'.repeat(32))
+    expect(inspect(id)).toBe('ab'.repeat(32))
+    expect(inspect({ id }, { breakLength: Infinity })).toBe(`{ id: ${'ab'.repeat(32)} }`)
+    expect(inspect([new Span('0102030405060708')])).toBe('[ 0102030405060708 ]')
   })
 
   it('static keccak256 matches the direct function', () => {

From 939a020ef479cb4b5464865dca63dfad5142eae5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gergely=20B=C3=A9k=C3=A9si?= <gergely.bekesi@ethswarm.org>
Date: Mon, 21 Sep 2026 14:34:52 +0200
Subject: [PATCH 2/2] fix: simplify symbol format

---
 src/bytes/bytes.ts | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/bytes/bytes.ts b/src/bytes/bytes.ts
index b3a6daf..fad0976 100644
--- a/src/bytes/bytes.ts
+++ b/src/bytes/bytes.ts
@@ -6,8 +6,6 @@ const ENCODER = new TextEncoder()
 
 const HEX_PATTERN = /^(0x)?[0-9a-fA-F]*$/i
 
-const INSPECT: unique symbol = Symbol.for('nodejs.util.inspect.custom')
-
 function hasToHexMethod(value: unknown): value is { toHex(): string } {
   return typeof value === 'object' && value !== null && typeof (value as { toHex?: unknown }).toHex === 'function'
 }
@@ -186,7 +184,7 @@ export class Bytes {
   /**
    * Printed as its hex string by `console.log` and `util.inspect` in Node.
    */
-  public [INSPECT](): string {
+  public [Symbol.for('nodejs.util.inspect.custom')](): string {
     return this.represent()
   }
 }