https://github.com/duneanalytics/sim-idx-example-sample-app
https://github.com/duneanalytics/sim-idx-example-sample-app
Last synced: 12 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/duneanalytics/sim-idx-example-sample-app
- Owner: duneanalytics
- Created: 2025-06-20T11:11:29.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-06-23T11:27:07.000Z (12 months ago)
- Last Synced: 2025-06-23T12:32:14.891Z (12 months ago)
- Language: Solidity
- Size: 29.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Sim IDX Sample Project
**Sim IDX** is a framework that helps you build and deploy applications that index blockchain data in minutes. Define listeners that react to specific onchain events, extract relevant data, and automatically make this data queryable via an API.
This sample project indexes **Uniswap V3 Factory pool creation events** and serves as your starting point for building with Sim IDX.
When you're ready to continue, the [Quickstart guide](https://sim.dune.com/idx) will walk you through authenticating and deploying your app.
## What You'll Edit
The main files you'll work with are:
- **`abis/`** - Add JSON ABI files for contracts you want to index
- **`listeners/src/Main.sol`** - Define your indexing logic, triggers, events, and handlers
- **`apis/src/index.ts`** - Define APIs for your indexed data
## App Structure
```
.
├── sim.toml # App configuration
├── apis/ # Your custom API code
├── abis/ # Contract ABI files (JSON)
│ └── UniswapV3Factory.json # Example: Uniswap V3 Factory ABI
├── listeners/ # Foundry project for listener contracts
│ ├── src/
│ │ └── Main.sol # Main listener contract (Edit this)
│ └── test/
│ └── Main.t.sol # Unit tests for your listener
```
## Next Steps
Ready to start building? Check out the comprehensive guides:
- **[Deploying Your App](http://docs.sim.dune.com/idx/deployment)** - Deploy your app
- **[Adding ABIs](https://docs.sim.dune.com/idx/cli#sim-abi)** - How to add contract ABIs
- **[Writing Listeners](https://docs.sim.dune.com/idx/listener)** - Define your indexing logic
- **[CLI Reference](https://docs.sim.dune.com/idx/cli)** - All available commands