it-healer/laravel-monero

A library for Laravel that allows you to create and manage the Monero cryptocurrency.

v1.0.0 2025-07-23 15:07 UTC

Requires

• php: ^8.2
• ext-curl: *
• ext-pcntl: *
• ext-posix: *
• illuminate/contracts: ^10.0|^11.0|^12.0
• spatie/laravel-package-tools: ^1.15

MIT

• IT-HEALER

• php
• laravel
• Monero
• XMR
• it-healer

README

Laravel Monero

Organization of payment acceptance and automation of payments of XMR coins on the Monero blockchain.

Installation

You can install the package via composer:

composer require it-healer/laravel-monero

After you can run installer using command:

php artisan monero:install

Optional, you can install Monero Wallet RPC using command:

php artisan monero:wallet-rpc

And run migrations:

php artisan migrate

Register Service Provider and Facade in app, edit config/app.php:

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

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

Add cron job, in file app/Console/Kernel in method schedule(Schedule $schedule) add

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

You must setup Supervisor, create file /etc/supervisor/conf.d/monero.conf with content (change user and paths):

[program:monero]
process_name=%(program_name)s
command=php /home/forge/example.com/artisan monero
autostart=true
autorestart=true
user=forge
redirect_stderr=true
stdout_logfile=/home/forge/example.com/monero.log
stopwaitsecs=3600

Commands

Monero Node sync with all wallets in here.

php artisan monero:node-sync [NODE ID]

Monero Wallet sync.

php artisan monero:wallet-sync [WALLET ID]

For Developers

Command for build JS script:

npm i
npm run build

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.