import net.milkbowl.vault.services.transaction.TransactionLogService;
import net.milkbowl.vault.services.transaction.TxRecord;
import net.milkbowl.vault.services.transaction.TxType;

@Service
public class MyService {

    private final TransactionLogService tx;

    public MyService(TransactionLogService tx) {
        this.tx = tx;
    }

    public void recordTransfer(UUID from, UUID to, double amount, String currency) {
        TxRecord record = TxRecord.builder()
            .type(TxType.TRANSFER)
            .fromUuid(from)
            .toUuid(to)
            .amount(new BigDecimal(amount))
            .currency(currency)
            .reason("Manual payment")
            .timestamp(System.currentTimeMillis())
            .build();

        tx.record(record); // Persisted asynchronously
    }
}

// Complete example: loan with installment
TxRecord loan = TxRecord.builder()
    .type(TxType.LOAN_GRANTED)
    .fromUuid(UUID_ZERO)           // From the system
    .toUuid(borrower.getUniqueId())
    .amount(new BigDecimal("5000.00"))
    .currency("coins")
    .reason("Personal loan - 12 installments")
    .extra(extra -> extra
        .put("loan_id", loan.getId())
        .put("installments", 12)
        .put("interest_rate_pct", 15.5)
    )
    .metadata(meta -> meta
        .world("survival")
        .server("srv01")
        .plugin("MyAuthorizerPlugin")
        .ipAddress("192.168.1.45")
    )
    .timestamp(System.currentTimeMillis())
    .build();

tx.record(loan);

import net.milkbowl.vault.api.events.TransactionEvent;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;

public class MyListener implements Listener {

    @EventHandler
    public void onTransaction(TransactionEvent event) {
        TxRecord tx = event.getTxRecord();

        // Filter by type:
        if (tx.type() == TxType.NOTE_DUPE_DETECTED) {
            Player admin = Bukkit.getPlayer(tx.toUuid());
            if (admin != null) {
                admin.sendMessage("&c⚠ Fraudulent note detected!");
            }
            return;
        }

        // Log to Discord via webhook (your own hooks):
        if (tx.type() == TxType.TRANSFER && tx.amount().doubleValue() > 100_000) {
            DiscordWebhook.send(tx.toString());
        }

        // Cancel (supports Cancellable):
        if (tx.type() == TxType.TRANSFER && isBlacklist(tx.toUuid())) {
            event.setCancelled(true);
            event.setCancelReason("Destination is blacklisted");
        }
    }
}

@Override
public void onEnable() {
    getServer().getPluginManager().registerEvents(new MyListener(), this);
}

import net.milkbowl.vault.api.events.BalanceChangeEvent;

@EventHandler
public void transferTax(BalanceChangeEvent event) {
    if (!event.isWithdraw()) return;

    double amount = event.getAmount();
    double tax = amount * 0.02;   // 2%

    // Apply tax
    SimpleEconomy eco = MyPlugin.getEconomy();
    eco.depositPlayer(
        Bukkit.getOfflinePlayer(UUID.fromString("00000000-0000-0000-0000-000000000000")),
        tax
    );
}

// Last 20 transactions for a player
List<TxRecord> recent = tx.lastN(player.getUniqueId(), 20);

// Filtering + pagination (for 45-slot GUI)
Page<TxRecord> page = tx.query()
    .where(player = player.getUniqueId())
    .where(type = TxType.TRANSFER)
    .orderByDesc("timestamp")
    .page(1, 45);   // 45 items for paginated GUI

page.items().forEach(System.out::println);
page.totalPages();