Skip to content

Escrow & Claims

Shared concepts for bounties and contracts. Keep the community-first flow; the app abstracts complexity while remaining verifiable on-chain.

Roles

  • Sponsor: Creates escrows, funds, approves releases.
  • Talent: Receives payouts.
  • Operator: Optional co-signer and circuit-breaker (pause/unpause).
  • Owner: Upgrade authority and token allowlist admin.

Tokens & allowlist

  • Supports ETH and approved ERC-20 assets.
  • Programme ops steward the allowlist and publish changes to keep participants informed.

Pause, upgrades, safety

  • Escrows can be paused/unpaused by operator/owner.
  • UUPS upgradeable; owner authorizes upgrades.
  • Guards: nonces, expirations, token mismatch checks, and clawbacks.

Bounties: flow

  • Sponsor defines the reward scope, funding pool, and expiry window.
  • Funds move into escrow and stay locked until the distribution list is finalised.
  • The team validates the list of eligible contributors and publishes it for claims.
  • Contributors submit claims through the app with supporting proof; the system checks eligibility automatically.
  • When the window closes, any unused funds can be redirected according to programme policy.

Contracts (milestones): flow

  • Sponsor and talent agree on milestones, success signals, and payout stages.
  • Each milestone receives funding when work is underway, keeping later stages locked until needed.
  • Reviews lead to an approval record that unlocks the relevant payout; optional co-signers can double-check sensitive releases.
  • If a milestone stalls past the agreed window, the sponsor can pull back the remaining allocation for re-planning.

Events to watch

  • Bounties: creation, funding, distribution publish, successful claims, and any refunds.
  • Milestones: funding, approval, release, and refund checkpoints.

Troubleshooting claims

  • Eligibility mismatch: Confirm you are using the wallet and amount listed in the latest distribution post.
  • Duplicate claim: Claims are single-use; reach out to ops if you believe this is in error.
  • Funding gap: Sponsors can top up escrows if the pool runs short.
  • Expired approval: Approvals have windows; request a refreshed review when timelines shift.

Where to get help

  • Programme ops can confirm escrow states, resolve disputes, and escalate security issues.
  • Reach out in the #ops-support channel or log a ticket if you need a manual review.