Contributor reward distribution for DAOs. Members allocate GIVE tokens to peers within an epoch; the resulting weighted graph drives compensation, retroactive funding, or reputation scores. Backend is Hasura GraphQL.
- 01contributor compensation
- 02peer-to-peer allocation
- 03retroactive rewards
- 04DAO contributor recognition
- 05circle / team budgets
- pnpm add graphql-request
| Variable | Scope | Description |
|---|---|---|
| COORDINAPE_API_KEY | Server | Circle-scoped API key generated from a Coordinape circle's admin settings. Sent as the `Authorization` header against https://api.coordinape.com/api/v2/graphql. |
| COORDINAPE_CIRCLE_ID | Client | Numeric ID of the Coordinape circle this integration reads/writes. |
Use Coordinape's GraphQL API to read epoch results and member contributions. POST to `https://api.coordinape.com/api/v2/graphql` with `Authorization: <COORDINAPE_API_KEY>` (no `Bearer` prefix). Query `circles_by_pk(id: $id) { users { name address give_token_received } epochs(where: {ended: {_eq: true}}) { number token_gifts { recipient_address tokens } }`. To write contributions, mutate `createContribution(object: { circle_id, description, user_id })`. For payouts, export the epoch's allocation CSV and feed it into Safe / Sablier / Hedgey rather than expecting Coordinape to push funds itself.
- ⚑Coordinape does not move funds — it only computes allocations. Connect the output to Safe (manual), Sablier streams, or Hedgey vests for actual payment.
- ⚑GIVE tokens reset every epoch and are non-transferable — historical totals are stored on `token_gifts`, not as live balances.
- ⚑Self-allocation is disabled by default in most circles; queries that aggregate `give_token_received` will silently exclude self-votes.
- ⚑API keys are circle-scoped, not user-scoped — leaking a key exposes the entire circle's contribution history.
- ⚑Coordinape's smart-contract distribution flow uses Merkle vesting on Hedgey; the on-chain leaves are immutable once the epoch is finalized, so corrections require a new distribution.