How user fees are calculated and paid to applications using OneBalance
OneBalance enables applications to monetize their services through transparent and flexible fee structures. This page explains how fees work, who pays them, and how to configure them for your application.
User pays one consolidated fee to the app, Toolkit helps app to handle the underlying gas & paymaster costs.
Category | Fee Type | Who Pays | Description |
---|---|---|---|
Gas Fees | Same-Chain Execution | Application | The app pays the bill to the paymaster service in USD for same-chain execution routes |
Gas Fees | Cross-Chain Source | Application | The app pays the source chain gas cost to the paymaster service in USD |
Gas Fees | Cross-Chain Destination | User | This fee is included in the quote the solver provides for execution |
Monetization | Swaps & Transfers | User | App configures the fees and collects them to a dedicated address. The fee is paid in the input token and delivered with every user transaction |
Monetization | Function Calls | User | App calculates the fee it is willing to take and encodes this into the desired calldata to be executed as a transfer |
Our transactional API lets you monetize every on-chain action initiated by your end users. Each time an end user sends a transaction through your application one transparent service fee is calculated, composed of:
Field | Type | Description |
---|---|---|
percentageBps | uint16 | Fee in basis points (1 bp = 0.01%) |
usdBaseMultiplier | uint8 | Multiplier applied to the operational cost table |
beneficiary | string | The EVM address that collects the fees. Once non-EVM chains are supported, additional addresses will be added |
The following table shows a config example of base costs for different chains. These values are multiplied by the usdBaseMultiplier
to calculate the final network fee.
Chain | CAIP-2 ID | Base Cost (USD) |
---|---|---|
eip155:1 | $3.00 | |
eip155:43114 | $0.20 | |
eip155:56 | $0.10 | |
eip155:59144 | $0.5 | |
eip155:8453 | $0.02 | |
eip155:42161 | $0.02 | |
eip155:137 | $0.02 | |
eip155:81457 | $0.02 | |
eip155:10 | $0.02 |
Component | Formula |
---|---|
Percent component | percentFee = (amount × percentageBps) / 10,000 |
USD component | usdFee = Σ(chainCostUsd[chain] × usdBaseMultiplier) |
Conversion | USD fee is converted to the input asset using a live price feed |
Total fee | totalFee = percentFee + usdFeeAssetEquivalent |
1 ETH to USDC Swap on Arbitrum
Given:
percentageBps
= 30 (0.3%)usdBaseMultiplier
= 21 ETH = 2,500 USDC
beneficiary
address in the same token used for the transactionCustom Fee Structures: Need specialized pricing models or volume discounts? Contact our sales team to discuss custom fee arrangements for your business.