FRAG
token airdrop.
To support this, Fragmetric takes periodic snapshots of wfragAsset
balances held within integrated DeFi protocols. Each DeFi partner is responsible for implementing a snapshot module that emits per-user balance data in a standardized format.
Integration Requirements
You must implement aSourceStreamFactory
that produces { owner, baseTokenBalance }
entries for all users in your protocol’s pool.
- Create your snapshot source module under: https://github.com/fragmetric-labs/fragmetric-snapshot/tree/main/src/commands/snapshot/source
- Implement the snapshot logic:
- Validate arguments.
- Call
produceSnapshot(...)
for each user. - Call
close(...)
at the end or on error.
- Register your source in
sources.ts
. - Implement a smoke test file for the actual pool with your source.
- Submit a pull request.
Snapshot Rules
-
TVL Must Match
The total of all baseTokenBalance values must exactly equal the pool’s actual
wfragAsset
TVL. This guarantees snapshot integrity and fair accounting. -
Liquidity Category Exception
For protocols in the LIQUIDITY category, You may convert the full LP token value into synthetic
wfragAsset
terms (e.g.,fragSOL + JitoSOL → wfragSOL
). This is allowed to compensate liquidity providers for impermanent loss and to incentivize liquidity depth in DeFi integrations.