Exchange rates

use RoundlyConsulting\Money\Currency;
use RoundlyConsulting\Money\Facades\Exchange;

$money = Money::ofMajor('10', 'EUR');

$money->convertTo('USD');                                      // default driver (ecb), latest rate
$money->convertTo('USD', now()->subDay());                     // historical
$money->convertTo('USD', rounding: RoundingMode::HalfAwayFromZero);

$conversion = Exchange::convertWithRate($money, 'CZK');
$conversion->original;    // 10.00 EUR
$conversion->converted;   // the CZK amount
$conversion->rate;        // ExchangeRate: from, to, rate (a Ratio), date, source

Exchange::rate(Currency::of('EUR'), Currency::of('USD'));      // default driver
Exchange::driver('database')->rate(Currency::of('EUR'), Currency::of('USD'));

// config/money.php
'exchange' => [
    'default' => env('MONEY_EXCHANGE_DRIVER', 'ecb'),
    'chain' => ['database', 'ecb'],   // what the chain driver tries, in order
    'pivot' => 'EUR',                 // triangulation currency for config + database
    'providers' => [
        'config' => [
            'rates' => [
                'EUR' => ['USD' => '1.0854', 'CZK' => '25.10'],   // decimal strings
            ],
        ],
    ],
],

use RoundlyConsulting\Money\Exchange\ExchangeRate;

$eurUsd = ExchangeRate::fromDecimal('EUR', 'USD', '1.0854', now(), source: 'manual');
$usdJpy = ExchangeRate::fromDecimal('USD', 'JPY', '147.25', now());

$eurUsd->rate;                                 // Ratio 5427/5000 — exact, never a float
$eurUsd->invert();                             // USD → EUR, exact
$eurUsd->through($usdJpy);                     // exact cross rate EUR → USD → JPY
$eurUsd->convert(Money::ofMajor('10', 'EUR')); // 10.85 USD — one rounding (HalfEven)
$eurUsd->decimal(4);                           // "1.0854"

php artisan vendor:publish --tag="money-migrations"
php artisan migrate

# .env
MONEY_EXCHANGE_DRIVER=chain      # database first, ECB as the fallback
MONEY_EXCHANGE_SCHEDULE=true     # refresh from the ECB at 16:30 Berlin time on weekdays

use RoundlyConsulting\Money\Facades\Exchange;

Exchange::rates()->manual('EUR', 'CZK', '25.10');          // effective today in money.exchange.timezone
Exchange::rates()->manual('EUR', 'CZK', '25.10', $date);   // or on a given date

use Carbon\CarbonInterface;
use RoundlyConsulting\Money\Contracts\ExchangeRateProvider;
use RoundlyConsulting\Money\Contracts\ExchangeRateSource;
use RoundlyConsulting\Money\Currency;
use RoundlyConsulting\Money\Exchange\ExchangeRate;
use RoundlyConsulting\Money\Facades\Exchange;

final class FixerProvider implements ExchangeRateProvider, ExchangeRateSource
{
    public function __construct(private FixerClient $client) {}   // your own API client

    public function rate(Currency $from, Currency $to, ?CarbonInterface $on = null): ExchangeRate
    {
        $decimal = $this->client->rate($from->code, $to->code, $on);   // e.g. "1.0854"

        return ExchangeRate::fromDecimal($from, $to, $decimal, $on ?? now(), source: 'fixer');
    }

    public function name(): string
    {
        return 'fixer';
    }

    public function fetch(CarbonInterface $from, CarbonInterface $to): iterable
    {
        foreach ($this->client->timeseries($from, $to) as $row) {
            yield ExchangeRate::fromDecimal($row['base'], $row['quote'], $row['rate'], $row['date'], source: 'fixer');
        }
    }
}

// In a service provider's boot()
Exchange::extend('fixer', fn ($app) => new FixerProvider($app->make(FixerClient::class)));