https://github.com/loadnetwork/atlas
https://github.com/loadnetwork/atlas
ao flp indexer
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/loadnetwork/atlas
- Owner: loadnetwork
- License: apache-2.0
- Created: 2025-11-26T10:56:42.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-02-04T10:01:47.000Z (3 months ago)
- Last Synced: 2026-02-04T11:43:01.035Z (3 months ago)
- Topics: ao, flp, indexer
- Language: Rust
- Homepage: https://atlas-server.decent.land
- Size: 404 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
## About
A monitoring and indexing system for the [Fairlaunch Bridge](https://ao.arweave.net/#/mint) and its associated active [Fairlaunch Projects (FLPs)](https://ao.arweave.net/#/delegate/) - checkout the monitored FLPs [here](./crates/common/src/projects.rs)
## Using the HTTP API
Base endpoint: https://atlas-server.decent.land
#### Example requests:
- `GET /` – health info.
- `GET /wallet/delegations/{ar_address}` – latest Set-Delegation payload for a wallet.
- `GET /wallet/delegation-mappings/{ar_address}` - delegation preference history over Arweave blockheight, goes back to the start of _delegation process deployment.
- `GET /wallet/identity/eoa/{eoa}` - returns the list of Arweave addresses associated with an EOA (bridge's identity linkage lookup)
- `GET /wallet/identity/ar-wallet/{ar_address}` - reverse proxy of `/eoa/{eoa}`
- `GET /oracle/{ticker}` – raw `Set-Balances` data payload for `usds`, `dai`, or `steth` oracles.
- `GET oracle/feed/{ticker}` - returns the recent indexed oracle feeds -aggregated- with additional metadata
- `GET /flp/delegators/{pid}` – merged snapshot of all tickers (LSTs + AR) delegating to a given FLP, including wallet/EVM mapping, factors, token amounts, and AR amounts.
- `GET /flp/delegators/multi?limit=100` - returns a list of delegators that delegate to at least 2 distinct FLPs.
- `GET /flp/minting/{project}` - returns the latest FLP's cycle `Own-Minting-Report` data
- `GET /flp/metadata/all` - return a vector of the tracked FLPs and their metadata
- `GET /flp/{project}/cycles?ticker={ticker}&limit={n}` - returns the total delegated assets for the `ticker`'s oracle (LST) cycle per `project`
Legacy network (ao.TN.1) explorer stats:
- `GET /explorer/blocks?limit=100` - emits the last N indexed blocks.
- `GET /explorer/day?day=YYYY-MM-DD` - per-block unique counts + summed-over-block totals for the given date (defaults to `today`).
- `GET /explorer/days?limit=N` - same payload as `/explorer/day`, aggregated for the last N days (defaults to 7).
Mainnet network (ao.N.1) explorer stats:
- `GET /mainnet/explorer/blocks?limit=100` - emits the last N indexed blocks.
- `GET /mainnet/explorer/day?day=YYYY-MM-DD` - per-block unique counts + summed-over-block totals for the given date (defaults to `today`).
- `GET /mainnet/explorer/days?limit=N` - same payload as `/explorer/day`, aggregated for the last N days (defaults to 7).
> explorer N.B: Fields ending in `_over_blocks` are summed across blocks (no dedup over all-day blocks); other counters are unique per block and safe to sum.
- `GET /mainnet/messages/recent` - returns recently indexed ao mainnet messages.
- `GET /mainnet/messages/block/{height}` - returns the indexed ao messages at a given Arweave blockheight (settled messages)
- `GET /mainnet/messages/tags?key=&value=&protocol=&limit=` - (case sensitive) returns the ao messages for the given tag KV filter, and data protocol (A|B).
- `GET /mainnet/info` - returns ao mainnet indexer info
> ***mainnet N.B***
the mainnet (ao.N.1) have 2 type of tags for messages, in Atlas,
we label them as type A and type B:
>
> tag format:
>- type A follows lower-case tags key format
>- type B follows Header-Case tags key format
>
> indexing start height/date:
>- type A start blockheight: 1_594_020 -- Jan 22 2025
>- type B start blockheight: 1_616_999 -- Feb 25 2025
AO token messages (ao.TN.1):
- `GET /token/ao/info` - returns the $AO token indexer info
- `GET /token/ao/txs?order=asc|desc` - list AO token messages (indexed) - ordering by blockheight.
- `GET /token/ao/txs/{msg_id}` - message by id (includes tags).
- `GET /token/ao/txs/tags?key=&value=&source=&limit=` - filter AO token messages by tag.
- `GET /token/ao/top/frequency?limit=` - counts per Action + top Sender/Recipient frequencies.
- `GET /token/ao/top/richlist?limit=` - top spenders/receivers by Quantity (12 decimals)
> ***AO token N.B***
> amount filters use human units (12 decimals) and are applied against the `Quantity` tag.
Example AO token filters:
- `GET /token/ao/txs?source=transfer&action=Transfer&min_amount=1.5&max_amount=10`
- `GET /token/ao/txs?action=Debit-Notice&from_ts=1739059000&to_ts=1739062000`
- `GET /token/ao/txs?block_min=1606020&block_max=1606040&recipient=`
## Using the workspace crates in Rust
```toml
[dependencies]
atlas-common = { package = "common", git = "https://github.com/loadnetwork/atlas" }
atlas-flp = { package = "flp", git = "https://github.com/loadnetwork/atlas" }
```
Examples:
### `common`
```rust
use common::gql::OracleStakers;
let oracle = OracleStakers::new("usds").build()?.send()?;
let tx_id = oracle.last_update()?;
```
### `flp`
```rust
use flp::wallet::get_wallet_delegations;
let prefs = get_wallet_delegations("wallet_ar_address")?;
```
## License
Licensed at your option under either of:
* [Apache License, Version 2.0](./LICENSE-APACHE)
* [MIT License](./LICENSE-MIT)
## Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.