Chains
See the list of supported chains here.How to track smart contract events
Monitor your smart contract activity in real-time. This guide walks you through adding contracts, selecting events, and using contract data in analytics.Step 1: Navigate to Contract Events
- Go to the Formo Dashboard
- Select your project
- Click Settings in the left navigation
- Select the Contracts tab
Step 2: Add a contract
- Click Add Contract
- Fill in the contract details:
| Field | Description | Example |
|---|---|---|
| Chain | The blockchain network | Ethereum, Base, Arbitrum |
| Contract Address | Your contract’s address | 0x1234...abcd |
| Name (optional) | Friendly name for reference | ”Swap Router” |
| ABI (optional) | Formo automatically fetches the contract ABI from Etherscan to decode events. |
- Click Save
Step 3: Select smart contract events to track
After adding a contract, select on or more events to ingest into Formo:- Click on your contract in the list
- You’ll see all available events from the ABI
- Toggle on the events you want to track from the list
Step 4: View events in Activity Feed
Once configured, contract events appear in your Activity Feed:- Go to Activity in the left navigation
- Filter by the Contract Event event type to see contract events
- Click any event to see decoded parameters including transaction hash, block number, function name and function parameters
Step 5: Use contract events in funnels
Build funnels that include onchain actions:- Go to Funnels and click Create Funnel
- Add steps mixing offchain and onchain events:
- Step 1:
pageview (visit homepage) - Step 2:
connect(connect wallet) - Step 3:
transaction(successful tx) - Step 4:
SwapCompleted(contract event)
- Step 1:
Example: DEX swap tracking
Track user journey from landing page to completed swap:| Step | Event Type | Description |
|---|---|---|
| 1 | page | User lands on /swap |
| 2 | connect | User connects wallet |
| 3 | Contract: Approval | User approves token |
| 4 | Contract: Swap | Swap executed |
Supported chains
Contract events is available on 40+ chains including all major EVM chains.Next Steps
Build Funnels
Create conversion funnels with contract events
Activity Feed
View real-time contract activity
Supported Chains
Full list of supported networks
Custom Events
Track additional offchain events