README

Laravel Ethereum Module is a Laravel package for work with cryptocurrency Ethereum, with the support ERC-20 tokens. It allows you to generate HD wallets using mnemonic phrase, validate addresses, get addresses balances and resources, preview and send ETH/ERC-20 tokens. You can automate the acceptance and withdrawal of cryptocurrency in your application.

Requirements

The following versions of PHP are supported by this version.

PHP 8.2 and older
Laravel 10 or older
PHP Extensions: GMP, BCMath, CType.

Installation

You can install the package via composer:

composer require it-healer/laravel-ethereum

After you can run installer using command:

php artisan ethereum:install

And run migrations:

php artisan migrate

'providers' => ServiceProvider::defaultProviders()->merge([
    ...,
    \ItHealer\LaravelEthereum\EthereumServiceProvider::class,
])->toArray(),

'aliases' => Facade::defaultAliases()->merge([
    ...,
    'Ethereum' => \ItHealer\LaravelEthereum\Facades\Ethereum::class,
])->toArray(),

For Laravel 10 you edit file app/Console/Kernel in method schedule(Schedule $schedule) add:

$schedule->command('ethereum:sync')
    ->everyMinute()
    ->runInBackground();

or for Laravel 11+ add this content to routes/console.php:

use Illuminate\Support\Facades\Schedule;

...

Schedule::command('ethereum:sync')
    ->everyMinute()
    ->runInBackground();

Examples

First you need to add Ethereum Nodes, you can register account in ANKR.COM get take HTTPS Endpoint with API key for Ethereum blockchain:

use \ItHealer\LaravelEthereum\Facades\Ethereum;

Ethereum::createNode('My node', 'https://rpc.ankr.com/eth/{API_KEY}');

Second you need add Ethereum Explorer, you can register account in Etherscan.io API and take Endpoint with API key:

use \ItHealer\LaravelEthereum\Facades\Ethereum;

Ethereum::createExplorer('My explorer', 'https://api.etherscan.io/api', '{API_KEY}');

You can create ERC-20 Token:

use \ItHealer\LaravelEthereum\Facades\Ethereum;

$contractAddress = '0xdac17f958d2ee523a2206206994597c13d831ec7';
Ethereum::createToken($contractAddress);

Now you can create new Wallet:

use \ItHealer\LaravelEthereum\Facades\Ethereum;

$wallet = Ethereum::createWallet('My wallet');

Custom derivation path

Different wallets use different BIP-44 paths. The path template is stored per wallet (the {index} placeholder is replaced with the address index); the default is the standard m/44'/60'/0'/0/{index} used by MetaMask and most software wallets, so existing wallets and projects are not affected.

use \ItHealer\LaravelEthereum\Ethereum as EthereumCore;
use \ItHealer\LaravelEthereum\Facades\Ethereum;

// Ledger Live: m/44'/60'/{index}'/0/0
$wallet = Ethereum::createWallet('Ledger', derivationPath: EthereumCore::PATH_LEDGER_LIVE);

// Ledger Legacy / MyEtherWallet: m/44'/60'/0'/{index}
$wallet = Ethereum::createWallet('Old Ledger', derivationPath: EthereumCore::PATH_LEDGER_LEGACY);

// Any custom template
$wallet = Ethereum::createWallet('Custom', derivationPath: "m/44'/60'/1'/0/{index}");

The default template can be changed via config('ethereum.wallet.default_derivation_path').

Adaptive synchronization (touch)

Enable adaptive sync (ethereum.touch) so addresses are polled often while in use and rarely while idle, instead of every run. An address is "active" for waiting_seconds after its last touch_at (set on user/merchant activity); while active it syncs no more often than fast_interval, while idle no more often than slow_interval.

// config/ethereum.php
'touch' => [
    'enabled' => true,
    'waiting_seconds' => 1800,  // stay "active" 30 min after last touch
    'fast_interval' => 60,      // while active: at most once per 60s
    'slow_interval' => 3600,    // while idle: at most once per hour (null = skip idle entirely)
],

Mark activity by updating touch_at when the wallet is used (GUI view, API call, unlock):

$address->update(['touch_at' => now()]);
// or in bulk for a wallet:
$wallet->addresses()->update(['touch_at' => now()]);

Defaults (fast_interval 0, slow_interval null) preserve the legacy behavior: active addresses sync every run, idle ones are skipped. ethereum:address-sync --force bypasses the schedule.

Alchemy support

Alchemy can be used both as an RPC node and as a transaction-history explorer (alchemy_getAssetTransfers), and for real-time deposits via Address Activity webhooks.

// RPC node + Alchemy explorer (drop-in alternative to Etherscan)
Ethereum::createAlchemyNode(apiKey: 'YOUR_ALCHEMY_KEY', name: 'alchemy');
Ethereum::createAlchemyExplorer(apiKey: 'YOUR_ALCHEMY_KEY', name: 'alchemy');

The explorer is driver-based (ethereum_explorers.driver = etherscan_v2 | alchemy); the sync, deposits and webhook handler are unchanged. The chain is taken from config('ethereum.explorer.chain_id') (1 = mainnet, 11155111 = Sepolia).

Compute Units & load balancing

Every node/explorer request is metered in a credits counter (Compute Units) that resets monthly; getNode()/getExplorer() pick the least-used one, spreading load and Alchemy CU spend. CU costs come from ItHealer\LaravelEthereum\Services\Alchemy\ComputeUnits (override in config('ethereum.compute_units')). Set ethereum.sync.track_outgoing=false to detect deposits only and halve getAssetTransfers requests.

Real-time deposits (Address Activity webhooks)

ETHEREUM_ALCHEMY_NOTIFY_AUTH_TOKEN=your-notify-auth-token   # dashboard → Webhooks → AUTH TOKEN
ETHEREUM_ALCHEMY_WEBHOOK_ENABLED=true
ETHEREUM_ALCHEMY_WEBHOOK_URL=https://your-app.com/ethereum/alchemy/webhook
ETHEREUM_ALCHEMY_AUTO_SUBSCRIBE=true

php artisan ethereum:alchemy-setup --reconcile   # create the webhook + subscribe existing addresses
php artisan ethereum:alchemy-reconcile           # sync watched-address list
php artisan ethereum:confirm-deposits            # mature confirmations (webhooks fire once)

Alchemy pushes a signed notification on incoming/outgoing activity; the package verifies the HMAC signature and triggers a targeted AddressSync. Facade API: Ethereum::ensureAlchemyWebhook(), subscribeAlchemyAddress(), unsubscribeAlchemyAddress(), reconcileAlchemyWebhook().

Custom development & contacts / Заказная разработка и контакты

EN — Need a new project built from scratch, or these modules integrated into your existing application? Contact the developer directly — custom development, module integration and ongoing support are available.

RU — Нужен новый проект «под ключ» или интеграция этих модулей в существующее приложение? Свяжитесь с разработчиком напрямую — доступны заказная разработка, интеграция модулей и поддержка.

🌐 Website / Сайт: it-healer.com
✈️ Telegram: @biodynamist · +90 551 629 47 16
📱 WhatsApp: +90 551 629 47 16
📧 Email: info@it-healer.com
🐛 Issues / Баг-репорты: GitHub Issues

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

IT-HEALER

License

The MIT License (MIT). Please see License File for more information.

it-healer / laravel-ethereum

Maintainers

Package info

Statistics

Security