Airdrops Endpoints
The Graph
This subgraph tracks events emitted by the Sablier Airdrops contracts, specifically the ones in charge of Merkle distributions. It deals with airdrop-specific actions like the factory deploying an airdrop campaign, admin clawbacks, and users claiming airdrops.
Airdrops work in tandem with our Vesting feature since some Merkle distributions will produce new Lockup streams.
Since The Graph has sunset their Hosted Service, we've transitioned our subgraphs to either the Studio or The Decentralized Network. See the supported networks and our endpoints below.
Source Code
Endpoints
Envio
While there is a subgraph for each chain Sablier is deployed on, the Envio indexer is a single endpoint that aggregates data across all chains. This approach allows for querying all Sablier data from a single API.
This indexers tracks the events emitted by the @sablier/airdrops contracts, specifically the ones in charge of merkle
distributions. It deals with airdrops-specific actions like the factory creating an airstream campaign, admin clawbacks,
or users claiming stream NFTs as defined in the attached Merkle tree.
Source Code
Endpoints
| Chain | Endpoint on the Hosted Network |
|---|---|
| All-Networks3 | https://indexer.hyperindex.xyz/[...]/v1/graphql |
The endpoint is meant to be plugged into a query client. Use Hasura's online explorer to view the entities and query API.
Sablier SDK: Merkle API
Sablier's Airdrops rely on pre-configured Merkle trees. This data structure contains the list of recipients as well as their individual claim details. We use the following service to create the Merkle tree, as well as proofs for the recipient's claims.
Source Code
Endpoints
| Host | Endpoint |
|---|---|
| Sablier | https://sablier-merkle-api.vercel.app |
Footnotes
-
The Graph's Studio endpoints are considered for testing purposes and may be rate-limited ↩
-
Endpoints could include the following types: (1) The Graph's Decentralized Network (paid) or (2) Custom Nodes (e.g. LightLink). Because the "Decentralized Network" subgraph flavors (e.g., Legacy Ethereum) operate on The Graph Network, you will need to substitute the
YOUR_API_KEYplaceholder in the Query URL with your own API key. If you require assistance with managing your API keys and configuring indexer preferences, this article serves as an excellent guide ↩ -
All-Networks means most of the networks supported by Sablier, e.g., Mainnet, Optimism, Polygon, Sepolia. The full list can be found here. To add a new chain to our Envio indexer, create a new list of contracts (
/addresses) and import that configuration into our bundles (see/bundles). ↩