> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allium.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Credit Debit

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\_address | to\_address | amount | event                        |
| ------------- | ----------- | ------ | ---------------------------- |
| X             | Y           | 1250   | X transfers 1250 tokens to Y |

In credit debit, it will be represented as **two rows**.

| address | counterparty\_address | amount | event                         |
| ------- | --------------------- | ------ | ----------------------------- |
| X       | Y                     | -1250  | X decrease 1250 tokens to Y   |
| Y       | X                     | 1250   | Y 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