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
• GET /codec/parse/set-balances/{msg_id} - return a JSON serialized Action : Set-Balances of a given msg id from the LSTs oracles.

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-Notice
• 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/permaweb/atlas" }
atlas-flp = { package = "flp", git = "https://github.com/permaweb/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

for releases up to v0.4.2

Licensed at your option under either of:

• Apache License, Version 2.0
• MIT License

for releases after v0.4.2

• MIT License

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you will be licensed under the MIT License

Credits

This repository was initially developed by the Decent Land Labs team and is currently maintained and continuously developed by the Permaweb team.