Segmentation fault in examples/03_send_transaction with middleware

[ch4r10t33r]

Bug Description

Segmentation fault crash when running examples/03_send_transaction at "Example 3: Transaction with Middleware". The crash occurs after successfully creating legacy and EIP-1559 transactions, specifically when attempting to use middleware functionality.

Error Output

Example 3: Transaction with Middleware
───────────────────────────────────────
zsh: segmentation fault  ./zig-out/examples/03_send_transaction

Successful Output Before Crash

The example successfully completes:

• ✅ Wallet creation
• ✅ Provider connection to Sepolia
• ✅ Example 1: Legacy transaction creation
• ✅ Example 2: EIP-1559 transaction creation
• ❌ CRASH at Example 3: Transaction with Middleware

Steps to Reproduce

1. Build the examples:

   zig build -Dexamples examples

2. Run example 03:

   ./zig-out/examples/03_send_transaction

3. Crash occurs at Example 3 (middleware section)

Expected Behavior

Should successfully demonstrate transaction creation with gas middleware without crashing.

Environment

• Zig Version: 0.14.1
• OS: macOS (darwin 23.6.0)
• Architecture: ARM64 (Apple Silicon)
• Network: Sepolia testnet

Code Context

Check examples/03_send_transaction.zig around Example 3:

// Example 3: Transaction with Middleware
std.debug.print("Example 3: Transaction with Middleware\n", .{});
std.debug.print("───────────────────────────────────────\n", .{});
{
    // Likely creating GasMiddleware and using it
    // Crash happens here when interacting with middleware
}

Potential Root Causes

1. Middleware initialization issue - GasMiddleware may not be properly initialized
2. Provider lifetime - Middleware holds reference to provider that's invalid
3. u256 arithmetic issue - After migrating to native u256, some gas calculations might have issues
4. Memory corruption - Pointer issue in middleware code

Related Code Areas

• src/middleware/gas.zig - Gas middleware implementation
• examples/03_send_transaction.zig - Failing example (around line 120-140)
• Related to recent u256 migration where we changed:
  • .mulScalar() → *
  • .add() → +
  • .sub() → -

Additional Context

• This crash occurs after the u256 migration where arithmetic operations were changed
• Other examples work fine:
  • ✅ Example 01: Wallet creation
  • ✅ Example 04: Smart contracts (with memory leak warning)
  • ✅ Example 05: Transaction receipts
  • ✅ Example 06: Event monitoring
  • ❌ Example 02: Query blockchain (bus error - separate issue Bus error in RPC client during JSON stringification (examples/02_query_blockchain) #35)
  • ❌ Example 03: Send transaction (segfault - this issue)

Impact

• Severity: High - Segmentation fault is a critical error
• Scope: Affects middleware usage in examples (possibly production code too)
• User Impact: Cannot use gas middleware functionality

Related Issues

• Bus error in RPC client during JSON stringification (examples/02_query_blockchain) #35 - Bus error in RPC client (different crash)
• Related to u256 migration completed today

Next Steps

1. Review examples/03_send_transaction.zig lines around Example 3
2. Check if GasMiddleware properly handles native u256 arithmetic
3. Verify all gas calculation methods work with native u256
4. Add null pointer checks in middleware
5. Run under debugger to get exact crash location

Testing

After fix, verify with:

zig build -Dexamples examples
./zig-out/examples/03_send_transaction
# Should complete all examples without crash

[ch4r10t33r]

Fixed in latest commits. The issue was format specifiers for u256 values in print statements - changed {} to {d} for decimal formatting and {any} for generic formatting. Examples now compile successfully.

[ch4r10t33r]

Resolved: Fixed format specifiers in examples. All examples now build successfully.

[ch4r10t33r]

Reopening: The compilation errors were fixed, but the runtime segmentation fault still occurs when executing the middleware example. The crash happens at Example 3 in the running program, not during compilation.

[ch4r10t33r]

Confirmed Runtime Crash

Exit code: 139 (SIGSEGV - Segmentation Fault)

The example successfully completes:

• ✅ Example 1: Legacy Transaction
• ✅ Example 2: EIP-1559 Transaction
• ❌ CRASH at Example 3: Transaction with Middleware

The crash occurs immediately when Example 3 starts, after printing the header. This suggests the middleware initialization or first usage is causing the segfault.

Next debug steps:

1. Check examples/03_send_transaction.zig around line 100-140 (Example 3)
2. Review src/middleware/gas.zig for null pointer dereferences
3. Verify gas calculations with native u256 don't overflow
4. Check if provider reference in middleware is valid

[ch4r10t33r]

✅ RESOLVED - Same root cause as #35.

The segfault was caused by the dangling pointer in Provider structure. Fixed by implementing on-demand namespace creation.

Example 03 now runs successfully through middleware examples without crashing.