feat: add generate new address command

Author: mweinschenk

README.md

@@ -44,6 +44,36 @@ $res = $contract->call('isAnchored', [1, '0x'.$hashHex]);
 $jobId = $contract->sendAsync('anchor', [1, '0x'.$hashHex, 'meta']);
 ```
 
+### Generate new addresses
+
+The package ships with a helper to generate fresh Ethereum keypairs (using `kornrunner/ethereum-address`).
+
+Generate one address (JSON output):
+
+```bash
+php artisan evm:address:generate --json
+```
+
+Generate 3 addresses (table output):
+
+```bash
+php artisan evm:address:generate --count=3
+```
+
+Sample JSON response:
+
+```json
+[
+	{
+		"address": "0xAbcDEF1234...",
+		"private_key": "0x6f8d...64hex",
+		"public_key": "0x04b3...uncompressed"
+	}
+]
+```
+
+Security note: Private keys are shown once. Persist them securely (e.g. Vault, KMS). Never commit them.
+
 ## Testing
 
 ```bash

src/Jobs/SendTransaction.php

@@ -71,11 +71,16 @@ public function handle(RpcClient $rpc, Signer $signer, NonceManager $nonces, Fee
             return;
         }
 
-        // First broadcast
-        $raw = new EIP1559Transaction($fields)->sign($pk);
-        $txHash = $rpc->call('eth_sendRawTransaction', [$raw]);
-        $nonces->markUsed($from, $nonce);
-        event(new TxBroadcasted($txHash, $fields));
+        // First broadcast with error handling
+        try {
+            $raw = new EIP1559Transaction($fields)->sign($pk);
+            $txHash = $rpc->call('eth_sendRawTransaction', [$raw]);
+            $nonces->markUsed($from, $nonce);
+            event(new TxBroadcasted($txHash, $fields));
+        } catch (\Throwable $e) {
+            event(new TxFailed($this->address, $this->data, 'rpc_send_error: '.$e->getMessage()));
+            return;
+        }
 
         $timeout = (int)($this->opts['timeout'] ?? $this->txCfg['confirm_timeout']);
         $pollMs = (int)($this->opts['poll_ms'] ?? $this->txCfg['poll_interval_ms']);
@@ -101,9 +106,14 @@ public function handle(RpcClient $rpc, Signer $signer, NonceManager $nonces, Fee
             // Emit replacement attempt (before rebroadcast)
             event(new TxReplaced($oldTxHash, $fields, $i + 1));
 
-            $raw = new EIP1559Transaction($fields)->sign($pk);
-            $txHash = $rpc->call('eth_sendRawTransaction', [$raw]);
-            event(new TxBroadcasted($txHash, $fields));
+            try {
+                $raw = new EIP1559Transaction($fields)->sign($pk);
+                $txHash = $rpc->call('eth_sendRawTransaction', [$raw]);
+                event(new TxBroadcasted($txHash, $fields));
+            } catch (\Throwable $e) {
+                event(new TxFailed($this->address, $this->data, 'rpc_send_error_replacement_'.$i.': '.$e->getMessage()));
+                return;
+            }
 
             $deadline = time() + $timeout;
             while (time() < $deadline) {
@@ -116,6 +126,10 @@ public function handle(RpcClient $rpc, Signer $signer, NonceManager $nonces, Fee
             }
         }
 
-        event(new TxFailed($this->address, $this->data, 'No receipt after attempts'));
+        event(new TxFailed(
+            $this->address,
+            $this->data,
+            sprintf('no_receipt_after_%d_replacements (last maxFee=%d priority=%d)', $maxRep, $fields['maxFeePerGas'], $fields['maxPriorityFeePerGas'])
+        ));
     }
 }

tests/Unit/SendTransactionFailureTest.php

@@ -0,0 +1,53 @@
+<?php
+
+use Illuminate\Support\Facades\Event;
+use Farbcode\LaravelEvm\Jobs\SendTransaction;
+use Farbcode\LaravelEvm\Events\TxFailed;
+use Farbcode\LaravelEvm\Contracts\{RpcClient, Signer, NonceManager, FeePolicy};
+
+class FFailSigner implements Signer {
+    public function __construct(private string $pk) {}
+    public function getAddress(): string { return '0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef'; }
+    public function privateKey(): string { return $this->pk; }
+}
+class FFailNonce implements NonceManager {
+    public function getPendingNonce(string $address, callable $fetcher): int { return 1; }
+    public function markUsed(string $address, int $nonce): void {}
+}
+class FFailFees implements FeePolicy {
+    public function suggest(callable $gasPriceFetcher): array { return [1_000_000_000, 50_000_000_000]; }
+    public function replace(int $oldPriority, int $oldMax): array { return [$oldPriority + 1_000_000_000, $oldMax + 10_000_000_000]; }
+}
+class FFailRpc implements RpcClient {
+    public function call(string $method, array $params = []): mixed {
+        if ($method === 'eth_estimateGas') { return '0x5208'; }
+        if ($method === 'eth_getTransactionCount') { return '0x1'; }
+        if ($method === 'eth_gasPrice') { return '0x3b9aca00'; }
+        if ($method === 'eth_getTransactionReceipt') { return []; }
+        if ($method === 'eth_sendRawTransaction') { throw new RuntimeException('simulated failure'); }
+        return [];
+    }
+    public function callRaw(string $method, array $params = []): array { return []; }
+    public function health(): array { return ['chainId' => 137, 'block' => 123]; }
+}
+
+it('emits TxFailed on initial broadcast error', function () {
+    Event::fake();
+    $job = new SendTransaction(
+        address: '0xContract',
+        data: '0xabcdef',
+        opts: ['timeout' => 1],
+        chainId: 137,
+        txCfg: [
+            'estimate_padding' => 1.2,
+            'confirm_timeout' => 0,
+            'max_replacements' => 0,
+            'poll_interval_ms' => 50,
+            'queue' => 'evm-send'
+        ]
+    );
+    $job->handle(new FFailRpc(), new FFailSigner('0x'.str_repeat('aa',32)), new FFailNonce(), new FFailFees());
+    Event::assertDispatched(TxFailed::class, function ($e) {
+        return str_contains($e->reason, 'rpc_send_error');
+    });
+});