Automation/Gasless meta-transactions

Gasless meta-transactions

How members act on Cadence without holding ETH — and the one step that still needs it.

The flow#

Cadence's contracts (AjoCircle, CircleFactory, TrustScoreRegistry) extend OpenZeppelin's ERC2771Context and trust one forwarder:

CadenceForwarder — 0xD73Eda898c3DbF6996d409fB2442Dd38f719e608

A member signs an EIP-712 ForwardRequest (free — no gas, just a signature) describing the call they want to make. The frontend posts it to /api/relay, which validates the target and function selector against a fixed allow-list, rate-limits the wallet, and forwards the already-signed request to the Meta-Transaction Relay workflow. That workflow re-verifies the signature onchain and submits execute(), paying gas from the KeeperHub-managed wallet. On the target contract, _msgSender() resolves to the original signer — not the relayer — so the action is attributed correctly onchain.

Creating a circle, joining, leaving, contributing, starting a round, replenishing or covering a deposit, withdrawing a deposit, cancelling an expired circle, and linking or unlinking an ERC-8004 identity — all gas-free.

The one exception#

Approving the real, already-deployed Base Sepolia USDC contract to spend on your behalf isn't sponsored. That USDC contract predates Cadence and was never written to trust ERC2771Context — it has no concept of a forwarded sender, so that one call has to be a normal, wallet-paid transaction. It's a one-time step per circle, and it's the entire reason a new wallet needs any Base Sepolia ETH at all — see Starter gas for new members.