How to Claim Bounties

Understand bounty calculations, caps, and the claiming process

Overview

Each Safe Harbor agreement defines bounty terms. Understanding these ensures you receive fair compensation.

Read Bounty Terms

BountyTerms memory terms = agreement.getBountyTerms();

uint256 percentage = terms.bountyPercentage;      // e.g., 10 for 10%
uint256 cap = terms.bountyCapUsd;                 // e.g., 5_000_000
bool canRetain = terms.retainable;                // Keep from recovered?
IdentityRequirements identity = terms.identity;   // KYC level
uint256 aggregateCap = terms.aggregateBountyCapUsd;  // Total cap across whitehats

How Much You Earn

Your bounty amount, the USD cap and how to convert it to tokens, the aggregate cap, and retainable vs return-all settlement are all defined by the agreement's bounty terms. See Bounty Terms → Calculation and Settlement for the formula, worked examples, and conversions.

Get Recovery Address

string memory recoveryStr = agreement.getAssetRecoveryAddress("eip155:627");
// Parse to address for transfers

Tax Considerations

⚠️

Bounties are likely taxable income. Keep records of:

  • Date of attack
  • Assets recovered (types and amounts)
  • Bounty received
  • USD value at time of receipt

Safe Harbor Protection

Understand your legal protections