Overview
Sablier Airdrops use pre-configured Merkle trees, a data structure that efficiently stores recipient lists and their individual claim details.
General data flow
Merkle trees enable minimal onchain storage while maintaining cryptographic proof of eligibility. The system stores only the tree's root hash in the deployed Airstream contract, while the complete tree and recipient list reside in IPFS.
Operations like eligibility checks or claim detail requests follow this process:
- Read data from the IPFS file
- Generate Merkle proofs from the tree
- Interact with the contract using the obtained data
Open-source solution
We've built a Rust backend service that provides REST API access to Merkle tree functionality. This service handles tree creation, storage, and data retrieval for both the Sablier Interface and third-party applications.
Integrations
Integrate this API by forking the repository to run your own instance. We actively improve and optimize this service, so submit suggestions or issues directly on GitHub.
If you want to integrate the eligibility/claim functionality in your, you have the following options:
- Self Host the above api
- Reach out for a more powerful backend we can host for you
- Reach out for a custom script to pre-generate proofs and save them wherever it suits you