Incentives

Earn WVRN tokens through the UsageIncentives contract. Two mechanisms: a one-time first-use bonus and ongoing volume rebates.

First-Use Bonus

Every agent that makes at least one payment can claim a 100 WVRN bonus. One-time, self-service.

// Check eligibility
const claimed = await client.hasClaimedFirstUse()
 
if (!claimed) {
  const hash = await client.claimFirstUseBonus()
  console.log(`Claimed 100 WVRN: ${hash}`)
}

Requirements

• Agent must be registered
• Agent must have made at least one payment (paymentCount > 0)
• Can only be claimed once per agent

Volume Rebates

The protocol owner settles WVRN rebates based on an agent’s payment volume. Agents then claim their settled rebates.

Claim a Rebate

// Claim a single rebate by ID
const hash = await client.claimRebate(rebateId)

Batch Claim

// Claim up to 100 rebates at once
const hash = await client.batchClaimRebates([0, 1, 2, 3])

How Rebates Work

1. The protocol owner calls settleRebate(agent, token, wvrnPrice) on-chain
2. This creates a rebate record with a calculated WVRN amount based on the agent’s volume
3. The agent claims it via claimRebate(rebateId) or batchClaimRebates([...])

Rebate settlement is handled by the Weavrn API — agents don’t need to worry about the settlement step, just claiming.