Why Fee Abstraction Matters
On most EVM chains, users must hold the native token to pay for gas. This creates friction: a user who receives USDC on Celo canβt send it anywhere without first acquiring CELO. Fee abstraction removes this barrier entirely. With fee abstraction, a user holding only USDC can send transactions, interact with contracts, and pay gas β all in USDC. No bridging, no swaps, no extra steps. This is especially valuable for:- Onboarding new users who receive stablecoins but donβt know about gas tokens
- Payment applications where users transact in a single currency end-to-end
- AI agents that operate autonomously with a single token balance
How It Works
Fee abstraction is built into the Celo protocol at the node level β it is not a paymaster or relayer. When a transaction includes afeeCurrency field, the Celo blockchain:
- Calls
debitGasFeeson the fee currency contract to reserve the maximum gas cost - Executes the transaction normally
- Calls
creditGasFeesto refund unused gas and distribute fees to block producers
feeCurrency property on the transaction object.
For implementation details, see Using Fee Abstraction. To add a new fee currency to the protocol, see Adding Fee Currencies.
Allowlisted Fee Currencies
The protocol maintains a governable allowlist of smart contract addresses that can be used as fee currencies. These contracts implement an extension of the ERC20 interface with additional functions for debiting and crediting transaction fees (see Adding Fee Currencies). To fetch the current allowlist, callgetCurrencies() on the FeeCurrencyDirectory contract, or use celocli:
Adapters for Non-18-Decimal Tokens
After Contract Release 11, allowlisted addresses may be adapters rather than full ERC20 tokens. Adapters are used when a token has decimals other than 18 (e.g., USDC and USDT use 6 decimals). The Celo blockchain calculates gas pricing in 18 decimals, so adapters normalize the value.- For transfers: use the token address as usual.
- For
feeCurrency: use the adapter address. - For
balanceOf: querying via the adapter returns the balance as if the token had 18 decimals β useful for checking whether an account can cover gas without converting units.
adaptedToken() on the adapter contract.
For more on gas pricing, see Gas Pricing.
Adapter Addresses
Mainnet
Celo Sepolia (Testnet)
| Name | Token Address | Adapter Address |
|---|---|---|
USDC | 0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B | 0x4822e58de6f5e485eF90df51C41CE01721331dC0 |
Related
- Fee Abstraction for AI Agents β Using fee abstraction in autonomous agent backends
- x402: Agent Payments β HTTP-native stablecoin payments for agents
- Using Fee Abstraction β How to pay gas with alternate fee currencies in your transactions
- Adding Fee Currencies β How to implement and register a new fee currency