Skip to content

Commit

Permalink
autogenerate
Browse files Browse the repository at this point in the history
  • Loading branch information
melotik committed Aug 12, 2024
1 parent b71844a commit 1a35d0a
Show file tree
Hide file tree
Showing 5 changed files with 475 additions and 542 deletions.
4 changes: 1 addition & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,9 +31,7 @@ Below you will find links to each of the following verticals.
- [DEX](./schemas/dex/SCHEMA.md) (Decentralized Exchange)
- [Lending](./schemas/lending/SCHEMA.md) / MM (Money Market) / CDP (Collateralized Debt Position)
- Perpetuals / Options / Derivatives
- Pool-Based Bridge
- Mint-Based Bridge
- Intent-Based Bridge
- [Bridges](./schemas/bridge/SCHEMA.md) (Pool-Based, Mint-Based, Intent-Based)
- LSTs (Liquid Staking Tokens)
- [Yield Aggregators](./schemas/yield-aggregator/SCHEMA.md) (Leverage, Gambling, RWA, ALM, Liquidity/LP, Index)
- [DEX Aggregator](./schemas/dex-aggregator/SCHEMA.md)
Expand Down
135 changes: 135 additions & 0 deletions schemas/bridge/SCHEMA.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,135 @@
# Bridge

Standard table definitions for bridge protocols, including pool-based, mint-based, and intent-based bridges.

## Version: 1.0.0-alpha

### Tokens

List of tokens in bridge protocols.

| Property | Description | Type |
|-------------------------|-----------------------------------------------------------|--------|
| token_address | The contract address of the token. | string |
| token_symbol | The symbol of the token. | string |
| token_decimals | The decimal amount of the token. | number |
| chain_id | The blockchain ID where the token resides. | number |

### Pools

List of pools in bridge protocols (applicable for pool and mint based bridges).

| Property | Description | Type |
|-------------------------|-----------------------------------------------------------|--------|
| creation_timestamp | The timestamp this pool was created. | number |
| creation_block_number | The block number this pool was created on. | number |
| token_address | The contract address of the token being bridged or pooled. | string |
| token_index | (Optional, only applicable to pool-based) The index of the pooled token in the smart contract. | number |
| token_symbol | The symbol of the token. | string |
| fee_rate | The fee rate as a percentage for the pool, if applicable (ie, 2.3% fee as 2.3). | number |
| pool_address | The contract address of the pool. | string |
| chain_id | Standard chain ID (ie, the chain ID of the network the pool lives on). | number |
| bridge_type | The type of bridge (ie, pool-based, mint-based, or intent-based). | string |

### LP Snapshot

List of liquidity providers in pool-based bridge protocols.

| Property | Description | Type |
|-------------------------|-----------------------------------------------------------|--------|
| timestamp | The timestamp of the snapshot. | number |
| pool_address | The address of the pool. | string |
| lp_address | The address of the liquidity provider. | string |
| token_address | The contract address of the token supplied. | string |
| token_index | The index in the smart contract of this token, default to 0. | number |
| token_amount | The amount of the supplied token, decimal normalized. | number |
| token_amount_usd | The amount supplied, in USD. | number |
| chain_id | The standard chain ID where the liquidity provider resides. | number |
| bridge_type | The type of bridge (pool-based, mint-based, or intent-based). | string |

### User Snapshot

User level snapshot of accounts that have used the bridge (applicable to pool and intent based bridges).

| Property | Description | Type |
|-------------------------|-----------------------------------------------------------|--------|
| timestamp | The timestamp of the snapshot. | number |
| pool_address | (Optional, only applicable to pool-based) The contract address of the pool. | string |
| user_address | The address of the user this snapshot activity is based on. | string |
| amount_in_usd | The amount of tokens received on this network by the user in USD during the given snapshot. | number |
| amount_out_usd | The amount of tokens sent out of this network by the user in USD during the given snapshot. | number |
| chain_id | The standard chain ID where the bridger resides. | number |
| bridge_type | The type of bridge (pool-based, mint-based, or intent-based). | string |

### Pool Snapshot

Pool level snapshots for pool and mint based bridges.

| Property | Description | Type |
|-------------------------|-----------------------------------------------------------|--------|
| timestamp | The timestamp of the snapshot. | number |
| pool_address | The contract address of the pool. | string |
| token_address | The contract address of the token being bridged or pooled. | string |
| token_index | (Optional, only applicable to pool-based) The index of the pooled token in the smart contract. | number |
| token_symbol | The symbol of the token. | string |
| token_amount | The amount of the supplied token (in a pool-based bridge), decimal normalized. | number |
| token_amount_usd | The amount supplied, in USD. | number |
| volume_usd | The bridged volume in USD, during this snapshot. | number |
| fees_usd | The fees collected in USD, during the snapshot period. | number |
| chain_id | The standard chain ID where the pool resides. | number |
| bridge_type | The type of bridge (pool-based, mint-based, or intent-based). | string |

### Bridge Transactions

List of bridge transactions.

| Property | Description | Type |
|-------------------------|-----------------------------------------------------------|--------|
| timestamp | The timestamp of the transaction. | number |
| block_number | The block number of the transaction. | number |
| transaction_hash | The hash of the transaction this bridge originated from. | string |
| source_chain_id | The source standard chain ID. | number |
| destination_chain_id | The destination standard chain ID. | number |
| volume_usd | The volume of the transaction in USD. | number |
| user_address | The address of the user initiating the transaction. | string |
| solver_address | The address of the solver (for intent-based bridges). | string |
| pool_address | The address of the pool (for pool-based and mint-based bridges). | string |
| bridge_type | The type of bridge (pool-based, mint-based, or intent-based). | string |

### Maker Snapshot

List of makers in intent-based bridge protocols.

| Property | Description | Type |
|-------------------------|-----------------------------------------------------------|--------|
| timestamp | The timestamp of the snapshot. | number |
| user_address | The address of the maker. | string |
| amount_in_usd | The amount received in USD, during this snapshot. | number |
| amount_out_usd | The amount sent in USD, during this given snapshot. | number |
| fees_usd | The fees collected in USD, during this snapshot. | number |
| chain_id | The standard chain ID where the maker resides. | string |

### Taker Snapshot

List of takers in intent-based bridge protocols.

| Property | Description | Type |
|-------------------------|-----------------------------------------------------------|--------|
| timestamp | The timestamp of the snapshot. | number |
| user_address | The address of the taker. | string |
| volume_usd | The volume bridged in USD, in the given snapshot. | number |
| chain_id | The standard chain ID where the taker resides. | number |

### Token Snapshot

List of takers in intent-based bridge protocols.

| Property | Description | Type |
|-------------------------|-----------------------------------------------------------|--------|
| timestamp | The timestamp of the snapshot. | number |
| token_address | he contract address of the token. | string |
| volume_usd | The volume in USD, during the given period. | number |
| total_fees_usd | The fees collected in USD, during this given period. | number |
| chain_id | The standard chain ID where the token resides. | number |

> Note: This markdown file is auto-generated.
Loading

0 comments on commit 1a35d0a

Please sign in to comment.