Tenant + User Revenue Flow

This page explains how Kolibrio’s ETH RPC enables referral tracking and automated revenue sharing — allowing you to pay users cashback according to required proportions via cron

Summary

Kolibrio ETH RPC now supports referral-based user tracking and automated cashback payouts. Each transaction can attribute a percentage of eligible revenue to a referred user, while the remaining share is accumulated on the Tenant account. User rewards are distributed hourly once the minimum payout threshold of 0.01 ETH is reached. Base endpoint (example):

https://eth-rpc.kolibr.io
?api_key={api_key}
&allow_reverts={true/false}
&mode={dynamic | balanced | maxprofit}
&user_address={0x...}
&user_percent=50

Name	Type	Example
user_address	string (0x EVM address)	0x6ce70e85bEa007B66fc4f9E26C6591C4ccBccdb1
user_percent	integer (only integers. no floating point)	10, 25, 50
allow_reverts	boolean (true by default)	true, false
mode	enum	dynamic, balanced, maxprofit

Revenue & Settlement

Tenant revenue

• Revenue attributable to a Tenant is collected on the Tenant account.

• Tenant revenue is calculated as the difference between total transaction revenue and the allocated user_percent share.

• This remaining portion is accumulated on the Tenant profile for later claiming.

• The tenant owner can claim at any time directly in the app.

User (referrer) revenue

• The user_address accrues revenue proportional to user_percent.

• Payouts are processed hourly via cron when the accumulated amount exceeds 0.01 ETH.

• If the accrued amount is ≤ 0.01 ETH, it continues to accumulate until it crosses the minimum payment threshold, then the next hourly cycle distributes it.