L2Vista-api-server

In the expansive world of cross-chain protocols, L2Vista-api-server stands out as a pivotal solution. This isn't just an API—it's our answer to the fragmented web of Ethereum's layer2 transactions, weaving them into a unified narrative.

Introduction

Navigating the myriad of cross-chain transactions can be daunting. Enter L2Vista: a unified platform distilling transactions from notable chains like Optimism, Base, Zora, and Mode. With support from The-Graph and Covalent, our API server specializes in tracking cross-chain protocols, including Hyperlane and Chainlink CCIP, with unparalleled accuracy.

Flow Chart

flowchart TD
    OP[Optimsim] --> A[CCIP Contract]
    OP --> B[Hyperlane Contract]
    BA[Base] --> A[CCIP Contract]
    BA --> B[Hyperlane Contract]
    ZO[ZORA] --> A[CCIP Contract]
    ZO --> B[Hyperlane Contract]
    MODE --> A
    MODE --> B
    A --> |A-1. get event from TheGraph| C(DB Server)
    B --> |A-2. get event from TheGraph| C(DB Server)
    C[DB Server] -->  D[API Server]
    A[CCIP Contract] --> |B-1. get tx info from Covalant|D[API Server]
    B[Hyperlane Contract] --> |B-2. get tx info from Covalant|D[API Server]
    D--> |C-1. Check Data|D
    D[API Server]--> E[Front End]
    E --> |D-1. Check Data|E
    E --> Client

Loading

API Endpoints

Transaction History API

made up with thegraph : https://thegraph.com/

Fetch the intricacies of every transaction:

/tx?amount=5&skip=0&tochain=420&hash=0xa82c95ceb3a44b5a2bf752af8f066c9a2a4a908860c98f3514161be596260d2d

Parameters:

• amount and skip are mandatory. They serve as guiding lights in this vast transactional ocean.
• Dive deeper with optional parameters like formchain, tochain, and hash.

Transaction Count API

made up with thegraph : https://thegraph.com/

Quantifying the myriad transactions:

/tx?amount=5&skip=0&fromchain=999&tochain=420

• Optional parameters: formchain, tochain, and hash.

My Page API

made up with covalant : https://www.covalenthq.com/docs/

My Balance API

Get multichain token balances of target address:

/mybalance?address=0xa40aa030A3ba4f42FDCd2B7bC33d5B03770290ea&nft=true

Parameters:

• nft , address is mandatory.
• it shows all assets of users (inclued nft info if it is true)

My Portfolio API

Get multichain portfolio(ohlc information) of target address:

/myportfolio?address=0xa40aa030A3ba4f42FDCd2B7bC33d5B03770290ea

Parameters:

• address is mandatory.

My Approval API

Get multichain token approval lists of target address:

/myapproved?address=0xa40aa030A3ba4f42FDCd2B7bC33d5B03770290ea

Parameters:

• address is mandatory.

My Tx API

Get multichain tx lists of target address:

/mytx?address=0xa40aa030A3ba4f42FDCd2B7bC33d5B03770290ea

Parameters:

• address is mandatory.

My Info API

Get multichain tx summary of target address:

/myinfo?address=0xa40aa030A3ba4f42FDCd2B7bC33d5B03770290ea

Parameters:

• address is mandatory.

Set Up Configuration:

1. Review the .example.env file.
2. Create a .env file based on the example. Adjust the values as

For Linux or macOS:

cp .example.env .env

For Windows:

copy .example.env .env

Quick Start Guide

1. Install Dependencies:

npm install

2. Launch the Project:

npm start

Contributing

If you'd like to contribute to the project, please fork the repository, make your changes, and submit a pull request. We appreciate all contributions and feedback!