Weave Code
Laravel Wallet Swap Laravel Package
bavix/laravel-wallet-swap
A Laravel package that adds swap and exchange support to bavix/laravel-wallet, enabling atomic balance conversions between wallets or currencies with configurable rates and a clean, framework-friendly API.
Package for working with currencies in laravel-wallet.
Frequently asked questions about Laravel Wallet Swap
- What does bavix/laravel-wallet-swap do in a Laravel application?
- It extends bavix/laravel-wallet with swap and exchange support so you can perform atomic balance conversions between wallets or currencies. It is useful when your Laravel app needs wallet-to-wallet movement, exchange workflows, or configurable conversion rates instead of custom ledger logic. It is an extension, so it fits best when laravel-wallet is already your wallet abstraction.
- How do I install bavix/laravel-wallet-swap with Composer?
- Install it with Composer using composer require bavix/laravel-wallet-swap after confirming your application already uses a compatible bavix/laravel-wallet version. Review the package documentation for any configuration publishing or migration steps, then run your application test suite. For version 8.0.0, check that your Composer constraints align with laravel-wallet 12.
- How do I configure exchange rates for wallet swaps?
- Version 8.0.0 supports configurable rates for swaps and exchanges, but the exact configuration keys should be taken from the package documentation. Define the currency pairs and rate sources your application needs, then test conversions for precision, rounding, and unsupported pairs. Keep rate configuration under application control so changes are reviewable and testable.
- Which Laravel and PHP versions are supported by laravel-wallet-swap 8.0.0?
- The provided release notes do not list exact Laravel and PHP version ranges for 8.0.0. Because 8.0.0 adds support for laravel-wallet 12, confirm the supported Laravel, PHP, and database combinations through Composer constraints and the package documentation. Test against the exact versions used in your application before upgrading.
- Does laravel-wallet-swap 8.0.0 require bavix/laravel-wallet 12?
- Release 8.0.0 is a compatibility release that adds support for laravel-wallet 12. The notes do not explicitly say whether it can coexist with earlier laravel-wallet majors, so review Composer constraints rather than assuming compatibility. Treat laravel-wallet 12 as the primary validation target and regression-test swap behavior on that line.
- How do I upgrade from laravel-wallet-swap 7.0.1 to 8.0.0?
- Pin your current laravel-wallet-swap 7.0.1 and laravel-wallet versions, create an upgrade branch, and review Composer constraints for 8.0.0. If your app is not already on laravel-wallet 12, upgrade that dependency first as required, then upgrade laravel-wallet-swap. Run migrations in a disposable environment and execute targeted swap tests plus your full suite before canary deployment. Keep a rollback path to 7.0.1 and the previous wallet version until production behavior is confirmed.
- Are swap APIs, events, and migrations unchanged in version 8.0.0?
- The 8.0.0 notes are dominated by laravel-wallet 12 support, PHPUnit 11, and GitHub Actions updates, with no explicit new swap features called out. The provided context does not include a migration guide beyond the changelog, so do not assume swap APIs, events, migrations, or configuration contracts are unchanged. Validate those contracts directly against the new version before production rollout.
- How should I test atomic swaps, concurrency, and failure cases in Laravel?
- Build targeted integration tests for swap creation, completion, reversal or failure paths, and concurrent balance movement, not just unit tests for rate calculation. Use a disposable database to validate migrations and schema expectations, and test against your supported Laravel, PHP, and database matrix. The release context flags concurrency, idempotency, and partial-failure behavior as key questions, so cover them explicitly in your own suite.
- When should I avoid using laravel-wallet-swap and write custom wallet logic?
- Avoid adding laravel-wallet-swap if your application does not already use bavix/laravel-wallet or only needs simple balances and transactions. The package is most valuable when you need wallet-to-wallet exchange, swap orchestration, multi-wallet balance movement, or configurable conversion rates. If those workflows are not on your roadmap, the extra dependency and upgrade surface may not be justified.
- Is bavix/laravel-wallet-swap actively maintained and safe for production?
- Version 8.0.0 shows active dependency and CI hygiene, including alignment with laravel-wallet 12 and automated dependency updates. It is still a community package, so confirm maintainer responsiveness, documentation quality, issue activity, and security-response posture for your production use. Treat major upgrades deliberately and do not auto-merge them without regression testing.
Weaver
How can I help you explore Laravel packages today?