Claiming Rewards

After a contributor’s pull request has been verified and validated, zkPull enables the contributor to claim their reward directly on-chain.

Claiming rewards is:

  • Permissionless

  • Deterministic

  • Enforced by smart contracts

Once validation succeeds, no additional approval is required.


When Can Rewards Be Claimed?

A contributor can claim rewards only if:

  • zkTLS proof generation was successful

  • AVS validation has been completed

  • The bounty is still active

  • The claim limit has not been exceeded

If all conditions are met, the reward becomes immediately claimable.


Reward Claim Flow (Step-by-Step)

  1. Validation Completed AVS operators submit a successful validation result on-chain.

  2. Reward Becomes Claimable The smart contract marks the claim as valid.

  3. Contributor Initiates Claim The contributor clicks “Claim Rewards” in the zkPull interface.

  4. On-Chain Transfer Funds are transferred directly from the bounty escrow to the contributor’s wallet.

No human intervention is involved in this process.


Trustless Payout Guarantees

zkPull ensures:

  • Funds are already locked before work begins

  • Validation rules are objective and enforced

  • Rewards cannot be blocked or delayed

Once conditions are met, the protocol must pay.

This eliminates common failure cases found in traditional bounty systems.


Fee Handling & Transparency

At claim time:

  • The protocol fee is automatically deducted

  • AVS operator rewards are allocated

  • The contributor receives the net payout

All fee movements are visible on-chain and verifiable.


Failure & Edge Cases

If reward claiming fails:

  • Funds remain safely escrowed

  • No partial payouts occur

  • The claim can be retried if conditions are still valid

Common reasons:

  • Validation not yet finalized

  • Claim limit reached

  • Incorrect claim index

These cases are handled deterministically by the contract.

Last updated