Custom model & translations

Your own ledger model

The Credit model is deliberately not final. Extend it to add relations, accessors or observers:

namespace App\Models;

use RoundlyConsulting\Credits\Models\Credit;

class LedgerEntry extends Credit
{
    protected $table = 'credits';

    // your own relations, accessors, observers ...
}

Then point the config at it — the relation, the balance reads and the scopes all use the configured class:

// config/credits.php
'model' => App\Models\LedgerEntry::class,

• A key that is not set — absent, null or blank — resolves the packaged Credit.
• Anything else must be Credit or a subclass of it — the ledger’s scopes and the bucket and amount columns depend on it — or the toolkit’s InvalidConfigurationException is thrown naming the key. A foreign class is never silently replaced.

Translations

The two exception messages live in the credits::messages translation group. Publish them with the credits-translations tag and edit them — or add a locale folder next to en:

// lang/vendor/credits/en/messages.php
return [
    'insufficient' => 'Insufficient credits: tried to deduct :requested but only :available are available.',
    'not_denominated' => 'The credits bucket [:bucket] is not denominated in a currency; map it in credits.currencies to use money amounts.',
];

InsufficientCreditsException renders :requested as an absolute amount; BucketNotDenominatedException fills :bucket with the resolved bucket name.