Setup Guide

Configure on-chain event rewards in under 5 minutes.

Prerequisites

• A Resonance Partner Portal account
• A contract address on Soneium Mainnet
• Knowledge of which contract event you want to reward

Step 1: Create an Event

1. Open the Partner Portal → Rewards tab
2. Click Create Event
3. Select Onchain / Contract from the concept picker

Step 2: Configure the Contract

Fill in the contract configuration fields:

Field	Description	Example
Contract Address	The Soneium contract to watch	0x4183CD8f...cb33
Event Signature	Solidity event signature to filter on	Transfer(address,address,uint256)
Wallet Field	Which event parameter has the wallet to reward	from, to, sender, receiver
Confirmation Depth	Blocks to wait before processing (reorg safety)	3

Event Signature

The event signature is the Solidity event declaration without parameter names. Examples:

Transfer(address,address,uint256)
Approval(address,address,uint256)
Swap(address,uint256,uint256,uint256,uint256,address)
Staked(address,uint256)

Leave blank to match all events from the contract.

Wallet Field

This determines which event parameter contains the wallet address to reward:

• from — The first indexed address parameter (e.g., sender in a Transfer)
• to — The second indexed address parameter (e.g., receiver in a Transfer)
• sender — Alias for from
• receiver — Alias for to

Step 3: Set Rewards

Configure the reward amount and limits — same controls as any other event type:

• Reward Amount — RSNC per qualifying event
• Cooldown — Minimum time between rewards for the same user
• Max Claims — Per-user claim limit

Step 4: Save and Activate

Click Save. The Contract Reader Worker polls every minute — your contract will be watched starting on the next tick.

Verification

After saving, trigger a transaction on your watched contract. Within 1–2 minutes (plus confirmation depth), the reward should appear in the user's activity log and on the leaderboard.

Check the Analytics tab in the Partner Portal for event activity.