fee-abstraction

Configure Celo transactions to pay gas fees with ERC-20 tokens.

8|4|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/celo-org/agent-skills --skill fee-abstraction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fee-abstraction
Source: https://github.com/celo-org/agent-skills/tree/main/skills/fee-abstraction
Command: npx skills add https://github.com/celo-org/agent-skills --skill fee-abstraction

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables developers to pay gas fees for Celo transactions using ERC-20 tokens instead of native CELO, simplifying user onboarding and reducing on-chain friction.

Core Features & Use Cases

  • Fee currency support: Pay gas with USDC, USDT, cUSD across mainnet and testnets.
  • Adapter-based gas calculations: Uses adapters for 6-decimal tokens to align with 18-decimal gas internally.
  • Wallet compatibility: Works with MiniPay, Valora, and compatible dApps; see references for details.

Quick Start

  • Use the fee-abstraction skill to send a transaction on Celo with gas paid in USDC by setting feeCurrency to the USDC adapter address.

Frequently Asked Questions about fee-abstraction

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I pay gas fees with ERC-20 tokens on Celo?

Pay gas fees with ERC-20 tokens on Celo by setting the feeCurrency parameter to a supported token's adapter address in your Viem transaction. Supported tokens include USDC, USDT, and cUSD on mainnet and testnets; the FeeCurrencyDirectory contract at 0x9212Fb72ae65367A7c887eC4Ad9bE310BAC611BF lists all supported currencies.

Does Celo gas abstraction work with MiniPay and Valora wallets?

Yes, fee abstraction works with wallets that support feeCurrency, including MiniPay, Valora, and compatible dApps. Ensure your wallet implementation recognizes the feeCurrency parameter in transactions to enable token-based gas payments.

What are adapter addresses and why do I need them for gas fees on Celo?

Adapter addresses convert 6-decimal ERC-20 tokens to 18-decimal format internally for gas calculations on Celo. Use adapter addresses when paying fees with tokens like USDC or USDT to ensure correct gas amount calculations across the network.

Can I use fee abstraction on both Celo mainnet and testnet?

Yes, fee abstraction for ERC-20 token gas payments is supported on both Celo mainnet and testnets. The same supported tokens and adapter addresses apply across environments.

What tokens can I use to pay gas fees instead of CELO?

You can pay Celo gas fees with ERC-20 tokens listed in the FeeCurrencyDirectory contract, including USDC, USDT, and cUSD. Query the directory at 0x9212Fb72ae65367A7c887eC4Ad9bE310BAC611BF for the complete supported token list.

How does Viem support Celo's fee abstraction for gas payments?

Viem enables fee abstraction by allowing you to construct transactions with the feeCurrency parameter set to a supported token adapter address. This integrates directly with Celo's gas fee system to charge fees in your chosen ERC-20 token.