About

A monitoring and indexing system for the Fairlaunch Bridge and its associated active Fairlaunch Projects (FLPs) - checkout the monitored FLPs here

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=<TAG_NAME>&value=<TAG_VALUE>&protocol=<A|B>&limit=<N> - (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

Token messages (ao.TN.1):

• GET /token/{token}/info - returns token indexer info (token: ao, pi)
• GET /token/{token}/txs?order=asc|desc - list token messages (indexed) - ordering by blockheight.
• GET /token/{token}/txs/{msg_id} - message by id (includes tags).
• GET /token/{token}/txs/tags?key=<TAG_NAME>&value=<TAG_VALUE>&source=<transfer|process>&limit=<N> - filter token messages by tag.
• GET /token/{token}/frequency?limit=<N> - counts per Action + top Sender/Recipient frequencies.
• GET /token/{token}/top/richlist?limit=<N> - top spenders/receivers by Quantity (12 decimals)

Token N.B amount filters use human units (12 decimals) and are applied against the Quantity tag.

Example token filters:

• GET /token/ao/txs?source=transfer&action=Transfer&min_amount=1.5&max_amount=10
• GET /token/ao/txs?action=Debit-Ntoken indexer error token=pi start=1638421 err=http status: 504otice&from_ts=1739059000&to_ts=1739062000
• GET /token/pi/txs?block_min=1638421&block_max=1639000&recipient=<AR_ADDRESS>

Using the workspace crates in Rust

[dependencies]
atlas-common = { package = "common", git = "https://github.com/loadnetwork/atlas" }
atlas-flp = { package = "flp", git = "https://github.com/loadnetwork/atlas" }

Examples:

common

use common::gql::OracleStakers;
let oracle = OracleStakers::new("usds").build()?.send()?;
let tx_id = oracle.last_update()?;

flp

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
• MIT License

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.