Add your contract address to start ingesting contract events.Documentation Index
Fetch the complete documentation index at: https://docs.formo.so/llms.txt
Use this file to discover all available pages before exploring further.
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 one 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