From 0dacc9ca8bb9c419345ae970ddbaee98e146614e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 17 Nov 2025 18:46:32 +0000
Subject: [PATCH 1/3] chore(deps): update kornrunner/ethereum-address
 requirement

Updates the requirements on [kornrunner/ethereum-address](https://github.com/kornrunner/php-ethereum-address) to permit the latest version.
- [Release notes](https://github.com/kornrunner/php-ethereum-address/releases)
- [Commits](https://github.com/kornrunner/php-ethereum-address/compare/v0.3.0...v0.4.0)

---
updated-dependencies:
- dependency-name: kornrunner/ethereum-address
  dependency-version: 0.4.0
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 composer.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/composer.json b/composer.json
index 06fa941..8101ca3 100644
--- a/composer.json
+++ b/composer.json
@@ -26,7 +26,7 @@
     "require": {
         "php": "^8.4",
         "illuminate/contracts": "^11.0||^12.0",
-        "kornrunner/ethereum-address": "^0.3.0",
+        "kornrunner/ethereum-address": "^0.4.0",
         "kornrunner/keccak": "^1.1",
         "spatie/laravel-package-tools": "^1.16",
         "web3p/ethereum-tx": "^0.4.3"

From f2a5e0aae12e78bcf0c86c029fcebe56ff8d05e4 Mon Sep 17 00:00:00 2001
From: Martin Weinschenk <martin.weinschenk@farbcode.net>
Date: Thu, 20 Nov 2025 09:18:49 +0100
Subject: [PATCH 2/3] chore: add check if gmp php extension is installed

---
 src/Exceptions/RequirementException.php | 7 +++++++
 src/LaravelEvmServiceProvider.php       | 9 ++++++++-
 2 files changed, 15 insertions(+), 1 deletion(-)
 create mode 100644 src/Exceptions/RequirementException.php

diff --git a/src/Exceptions/RequirementException.php b/src/Exceptions/RequirementException.php
new file mode 100644
index 0000000..a002789
--- /dev/null
+++ b/src/Exceptions/RequirementException.php
@@ -0,0 +1,7 @@
+<?php
+
+namespace Farbcode\LaravelEvm\Exceptions;
+
+// Thrown when a mandatory PHP extension or runtime prerequisite is missing.
+class RequirementException extends EvmException {}
+
diff --git a/src/LaravelEvmServiceProvider.php b/src/LaravelEvmServiceProvider.php
index 2738518..ba8d4e9 100644
--- a/src/LaravelEvmServiceProvider.php
+++ b/src/LaravelEvmServiceProvider.php
@@ -21,6 +21,7 @@
 use Illuminate\Contracts\Foundation\Application;
 use Spatie\LaravelPackageTools\Package;
 use Spatie\LaravelPackageTools\PackageServiceProvider;
+use Farbcode\LaravelEvm\Exceptions\RequirementException;
 
 class LaravelEvmServiceProvider extends PackageServiceProvider
 {
@@ -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)

From 1d9852dd0c93fa4ea36e0b3afd010bff1a9123e7 Mon Sep 17 00:00:00 2001
From: mweinschenk <4179436+mweinschenk@users.noreply.github.com>
Date: Thu, 20 Nov 2025 08:22:49 +0000
Subject: [PATCH 3/3] Fix styling

---
 src/Exceptions/RequirementException.php | 1 -
 src/LaravelEvmServiceProvider.php       | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/Exceptions/RequirementException.php b/src/Exceptions/RequirementException.php
index a002789..ebc0e6a 100644
--- a/src/Exceptions/RequirementException.php
+++ b/src/Exceptions/RequirementException.php
@@ -4,4 +4,3 @@
 
 // Thrown when a mandatory PHP extension or runtime prerequisite is missing.
 class RequirementException extends EvmException {}
-
diff --git a/src/LaravelEvmServiceProvider.php b/src/LaravelEvmServiceProvider.php
index ba8d4e9..6fdd94c 100644
--- a/src/LaravelEvmServiceProvider.php
+++ b/src/LaravelEvmServiceProvider.php
@@ -16,12 +16,12 @@
 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;
 use Spatie\LaravelPackageTools\Package;
 use Spatie\LaravelPackageTools\PackageServiceProvider;
-use Farbcode\LaravelEvm\Exceptions\RequirementException;
 
 class LaravelEvmServiceProvider extends PackageServiceProvider
 {