Merge pull request #5 from farbcodegmbh/v0.2.2

Author: mweinschenk

src/Exceptions/RequirementException.php

@@ -0,0 +1,6 @@
+<?php
+
+namespace Farbcode\LaravelEvm\Exceptions;
+
+// Thrown when a mandatory PHP extension or runtime prerequisite is missing.
+class RequirementException extends EvmException {}

src/LaravelEvmServiceProvider.php

@@ -16,6 +16,7 @@
 use Farbcode\LaravelEvm\Crypto\LocalNonceManager;
 use Farbcode\LaravelEvm\Crypto\PrivateKeySigner;
 use Farbcode\LaravelEvm\Crypto\TxBuilderEip1559;
+use Farbcode\LaravelEvm\Exceptions\RequirementException;
 use Farbcode\LaravelEvm\Support\LogFilterBuilder;
 use Farbcode\LaravelEvm\Support\SimpleFeePolicy;
 use Illuminate\Contracts\Foundation\Application;
@@ -39,8 +40,14 @@ public function configurePackage(Package $package): void
             ]);
     }
 
-    public function packageRegistered()
+    public function packageRegistered(): void
     {
+        // Runtime environment guard: ensure GMP extension is loaded.
+        // This package relies on big integer math (Keccak, RLP, transaction signing).
+        if (! extension_loaded('gmp')) {
+            throw new RequirementException('The GMP PHP extension is required for laravel-evm. Please enable it: e.g. install with `apt install php-gmp` or add `extension=gmp` to your php.ini and restart PHP-FPM / CLI.');
+        }
+
         $this->app->singleton(RpcClient::class, fn () => new RpcHttpClient(
             config('evm.rpc_urls'),
             (int) config('evm.chain_id', 137)