feat(engine): optimize throughput

.env.example

@@ -0,0 +1 @@
+DATABASE_URL=postgres://torii:torii@localhost:5432/torii

Cargo.toml

@@ -77,7 +77,7 @@ clap = { version = "4.5", features = ["derive"] }
 
 # ETL Pipeline dependencies
 starknet = "0.17"
-sqlx = { version = "0.8", features = ["runtime-tokio", "sqlite"] }
+sqlx = { version = "0.8", features = ["runtime-tokio", "sqlite", "postgres", "any"] }
 async-trait = "0.1"
 anyhow = "1.0"
 chrono = "0.4"

README.md

@@ -37,6 +37,18 @@ This work is still in progress, refer to the modules documentation for more deta
 
 ## 🚀 Quick Start
 
+### Start PostgreSQL (Docker Compose)
+
+```bash
+docker compose up -d postgres
+```
+
+Default connection string:
+
+```bash
+export DATABASE_URL=postgres://torii:torii@localhost:5432/torii
+```
+
 ### Running Examples
 
 ```bash

bins/torii-erc20/README.md

@@ -76,11 +76,14 @@ torii-erc20 \
   --from-block <START> \
   --to-block <END> \
   --db-path ./my-data.db \
+  --database-url postgres://torii:torii@localhost:5432/torii \
   --port 3000 \
   --no-auto-discovery \
   --contracts <ADDR1>,<ADDR2>
 ```
 
+`--database-url` (or `DATABASE_URL`) enables PostgreSQL-backed storage for both engine state and ERC20 data. If unset, local SQLite files are used.
+
 ## Architecture
 
 ```

bins/torii-erc20/src/config.rs

@@ -30,6 +30,13 @@ pub struct Config {
     #[arg(long, default_value = "./erc20-data.db")]
     pub db_path: String,
 
+    /// Optional engine database URL/path.
+    ///
+    /// Supports PostgreSQL (`postgres://...`) and SQLite (`sqlite:...` or file path).
+    /// When omitted, engine state uses `<db-path parent>/engine.db`.
+    #[arg(long, env = "DATABASE_URL")]
+    pub database_url: Option<String>,
+
     /// Disable auto-discovery of ERC20 contracts
     ///
     /// When enabled, only explicitly configured contracts will be indexed.