lido-nation / adapayments
package for receiving cardano native token payments in php, laravel, and woocommerce
Requires
- php: ^8.3
- illuminate/config: ^11.20 || ^12.0 || ^13.0
- saloonphp/saloon: ^4.0
- symfony/finder: ^7.1 || ^8.0
- vlucas/phpdotenv: ^5.6
Requires (Dev)
- laravel/pint: ^1.0
- mockery/mockery: ^1.6
- pestphp/pest: ^4.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is not auto-updated.
Last update: 2026-10-31 19:09:45 UTC
README
This is where your description should go. Try and limit it to a paragraph or two. Consider adding a small example.
Support us
lidonation.com
Installation
You can install the package via composer:
composer require lido-nation/adapayments
Usage
List your product in USD, allow user to pay in ada
$priceInAda round(usd_to_ada($item['price']), 2);
Testing
composer test
Running the demo store
Create src/.env from src/.env.example, then start the built-in server:
php -S 127.0.0.1:8899 -t src/public
Open http://127.0.0.1:8899/store.
Use a Blockfrost Mainnet, Preview, or Preprod URL. The wallet, provider project, and receiving address must use the same network. CIP-30 cannot distinguish Preview from Preprod; select the matching testnet in the wallet explicitly. The demo exposes its Blockfrost project ID to the browser; use a dedicated, quota-limited project. Never configure wallet secrets in this demo.
The UI reports submission, not confirmation or fulfilment. This is a demo: there is no server-side order verification. Use test ADA for manual checks.
Local wallet and amount regression checks (Node 24):
node --experimental-vm-modules --test tests/js/*.cjs
Browser smoke checks (install Playwright and Chromium locally first):
node tests/browser/checkout.cjs
To verify installation and configuration loading with Laravel 13 and Symfony Finder 8, use PHP 8.4 or later and run:
tests/compatibility/laravel13.sh
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- [Lido Nation](https://github.com/Lido Nation)
- All Contributors
License
The MIT License (MIT). Please see License File for more information.