Wallet State Projection

If you need custom wallet fields (held_balance, balance_after, state_hash), use WalletBatchProjectorInterface.

Package provides hook only. Projection rules stay in your app code.

This keeps updates in same UPDATE wallets ... query.

1) Add columns

Add custom columns to wallets in your app migration.

2) Register projector

'projectors' => [
    'wallet' => \App\Wallet\WalletStateBatchProjector::class,
],

3) Implement projector

use Bavix\Wallet\Internal\Projector\WalletBatchProjectorInterface;

final readonly class WalletStateBatchProjector implements WalletBatchProjectorInterface
{
    public function project(array $balances, array $walletsById): array
    {
        $rows = [];
        foreach ($balances as $walletId => $resultingBalance) {
            $wallet = $walletsById[$walletId] ?? null;
            if ($wallet === null) {
                continue;
            }

            $heldBalance = (string) ($wallet->getAttribute('held_balance') ?? '0');
            $rows[$walletId] = [
                'balance_after' => $resultingBalance,
                'held_balance' => $heldBalance,
                'state_hash' => hash('sha256', $wallet->uuid.':'.$resultingBalance.':'.$heldBalance),
            ];
        }

        return $rows;
    }
}

For transaction columns, see Transaction State Projection.