The credit-debit model provides a double-entry accounting system for tracking asset movements on the blockchain. This model is particularly useful for analyzing token flows, calculating balances, and understanding asset distribution patterns.

​
Overview

Credit Debit vs Transfers Credit-debit tables transform single transfer events into two corresponding entries:

  • A debit (negative) entry for the sending address

  • A credit (positive) entry for the receiving address

Example Using an ERC20 token as an example, a token transfer will be represented as follows:

from_addressto_addressamountevent
XY1250X transfers 1250 tokens to Y

In credit debit, it will be represented two rows.

addresscounterparty_addressamountevent
XY-1250X decrease 1250 tokens to Y
YX1250Y increase 1250 tokens from X

​
Advantages Over Transfer Tables

  1. Balance Calculation

    • Easy summation of all credits and debits for an address

    • Simplified queries for net position calculations

    • Natural handling of complex transactions

  2. Flow Analysis

    • Clear visualization of token inflows and outflows

    • Simple aggregation of total volume by address

    • Easy identification of major senders/receivers

  3. Data Consistency

    • Built-in verification through balanced entries

    • Self-auditing through equal total credits and debits

    • Simplified reconciliation process