website

twitter

discord

Blockchains (L2)

Soneium

# Soneium Bridge deposits Methodology

## 1. Overview

Bridge deposits measures the total USD value of tokens held in Soneium's bridge contracts on Ethereum. This metric tracks the amount of value that users have deposited into bridge contracts to move assets from Ethereum to the Soneium Layer 2 network. The calculation aggregates token balances across all designated bridge addresses and converts them to USD values using end-of-day price feeds.

## 2. Data sources

The calculation relies on several types of blockchain and external data:

- **Ethereum token transfers**: Parsed `Transfer` events from ERC20 tokens and native ETH transfers to track token movements into and out of bridge addresses
- **Token balance snapshots**: Daily token balance data for each bridge contract address, derived from processing transfer events
- **End-of-day token price feeds**: USD price data for all tokens held in bridge contracts, used for value conversion
- **Token metadata**: Token contract information including decimal places, symbols, and token classifications
- **Chain availability data**: Information about which time periods have valid data coverage for reporting

## 3. Step-by-step calculation

### Component A: Bridge address identification
- **Purpose**: Define the specific contract addresses that hold bridged assets for Soneium
- **Logic**: Four Ethereum addresses are configured as Soneium bridge contracts: `0x88e529a6ccd302c948689cd5156c83d4614fae92`, `0xeb9bf100225c214efc3e7c651ebbadcf85177607`, `0xc67a8c5f22b40274ca7c4a56db89569ee2ad3fab`, and `0x2f543a7c9cc80cc2427c892b96263098d23ee55a`. These addresses represent the smart contracts that users deposit tokens into when bridging from Ethereum to Soneium.
- **Key fields**: The `account_addresses` list contains the bridge contract addresses that will be monitored for token balances

### Component B: Portfolio balance calculation
- **Purpose**: Calculate the token balances held at each bridge address for all tokens
- **Logic**: The system processes all `Transfer` events involving the bridge addresses to determine current token holdings. For each bridge address, it tracks inflows (transfers to the address) and outflows (transfers from the address) to calculate running balances. This includes both ERC20 token transfers and native ETH transfers. The calculation maintains balances for every token that has ever interacted with the bridge contracts.
- **Key fields**: The `balance` field represents the token amount held at each bridge address, with proper decimal adjustment applied based on token metadata

### Component C: USD value conversion
- **Purpose**: Convert all token balances to USD values for aggregation
- **Logic**: Each token balance is converted to USD using end-of-day price feeds. The system looks up the USD price for each token and multiplies it by the token balance. Token amounts are properly adjusted for decimal places using token metadata before price conversion. If a token lacks price data, its USD value is treated as zero.
- **Key fields**: The converted `balance` amounts represent USD values of tokens held in bridge contracts

### Component D: Business metadata application
- **Purpose**: Apply categorical information for business reporting and filtering
- **Logic**: Each balance record is tagged with business-relevant metadata. The `chain_id` field identifies Ethereum as the source chain. The `market_sector_id` is set to "blockchains_l2" to categorize this as a Layer 2 blockchain metric. The `business_segment_id` is set to "blockchain" to group it with other blockchain infrastructure metrics. The `product_id` is set to null as this is a protocol-level rather than product-specific metric.
- **Key fields**: `timestamp`, `timestamp_grain`, `chain_id`, `market_sector_id`, `business_segment_id`, and `product_id` provide the business context for the metric

### Final aggregation
- **Combining components**: All USD-converted token balances across the four bridge addresses are summed together to calculate the total `bridge_deposits` value. This represents the aggregate USD value of all tokens held in Soneium bridge contracts.
- **Currency conversion**: All token balances are converted to USD using end-of-day price feeds, with proper decimal adjustment applied before conversion
- **Time aggregation**: The metric is calculated with daily timestamp grain, providing daily snapshots of bridge deposit values
- **Final calculation**: The final `bridge_deposits` value equals the sum of all USD-converted token balances held across the four designated Soneium bridge contract addresses. A fill-forward strategy is applied to handle missing data points, carrying the last known value forward for any gaps in the time series. Chain availability filtering ensures only time periods with valid data coverage are included in the final results.

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

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

Soneium

Bridge deposits

Bridge deposits

Competitive landscape

Chain breakdown