# Katana Chain Bridge deposits Methodology

## 1. Overview

Bridge deposits measures the total value of assets held in bridge contracts on Ethereum that are dedicated to Katana Chain. This metric includes assets moved through the canonical Agglayer bridge as well as assets held in specific vault bridge contracts. It serves as a leading indicator of capital flows and the total liquidity available for users to transact within the Katana Chain ecosystem.

## 2. Data sources

- **Blockchain events**: `BridgeEvent` and `ClaimEvent` events from `AgglayerBridge` contracts, and asset balances for specific vault bridge addresses on Ethereum
- **External data**: End-of-day price feeds and asset metadata

## 3. Step-by-step calculation

### Component A: AgglayerBridge canonical flows

- **Purpose**: Captures the cumulative net value of assets moved through the canonical Agglayer bridge infrastructure.
- **Logic**: `BridgeEvent` events are filtered where the destination network is identified as Katana Chain. `ClaimEvent` events are filtered by decoding the global index to isolate withdrawals originating from Katana Chain. Specific vault bridge assets, including vbUSDC, vbWBTC, vbUSDT, vbETH, and vbUSDS, are excluded from these event logs to prevent double-counting with portfolio-tracked balances. Net flows are calculated by subtracting claims from deposits, aggregated by day, and transformed into a cumulative balance through a running sum.
- **Key fields**: `amount`, `originAddress`, `destinationNetwork`, `globalIndex`

### Component B: Vault bridge portfolio tracking

- **Purpose**: Tracks the value of assets held in external vault bridge contracts that back synthetic or wrapped assets on Katana Chain.
- **Logic**: Daily balances are calculated for a predefined set of vault bridge contract addresses on Ethereum. This involves aggregating all historical token transfers and native currency movements associated with these specific accounts to determine the total inventory of assets held as collateral.
- **Key fields**: `account_address`, `token_address`, `amount`

### Component C: USD conversion and final aggregation

- **Purpose**: Normalizes all captured asset values into a unified USD-denominated metric.
- **Logic**: The cumulative balances from the canonical bridge and the daily balances from the vault bridge portfolio are combined. All asset amounts are normalized by decimal precision and multiplied by end-of-day price feeds. A forward-filling strategy is applied to the cumulative totals to ensure data continuity for every timestamp. The final metric is aggregated at a daily granularity using UTC day boundaries.

*This methodology was automatically generated by Token Terminal's methodology analyzer.*

Value of assets held in a project's bridge contracts.

Bridge deposits

Blockchains (L2)

The network uses pessimistic proofs via the AgglayerGateway for settlement on Ethereum, with vault bridges for cross-chain asset transfers.

Katana Network provides a scalable execution environment connected to Ethereum through the Agglayer interoperability layer.

Katana Chain

Bridge deposits

Bridge deposits

Chain breakdown