https://github.com/init4tech/signet-filler
An example filler service for the Signet network that monitors pending orders and fills profitable ones.
https://github.com/init4tech/signet-filler
Last synced: about 1 month ago
JSON representation
An example filler service for the Signet network that monitors pending orders and fills profitable ones.
- Host: GitHub
- URL: https://github.com/init4tech/signet-filler
- Owner: init4tech
- License: apache-2.0
- Created: 2026-02-09T16:38:17.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-02-18T11:59:33.000Z (about 1 month ago)
- Last Synced: 2026-02-18T15:54:27.655Z (about 1 month ago)
- Language: Rust
- Size: 147 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Signet Filler
A filler service for the Signet network that monitors pending orders and fills profitable ones.
The filler checks the transaction cache for pending orders shortly before each block boundary, evaluates their profitability, and submits fill bundles for orders that meet the configured profit threshold. It connects to both the host chain and rollup RPC endpoints, using a configurable signer for transaction signing.
## Configuration
Configuration is via environment variables. Run with `-h` or `--help` to see the full list:
```
signet-filler --help
```
### Environment Variables
| Variable | Description | Default |
|----------|-------------|---------|
| `SIGNET_FILLER_CHAIN_NAME` | Signet chain name | `parmigiana` |
| `SIGNET_FILLER_HOST_RPC_URL` | URL for Host RPC node (http/https/ws/wss) | `https://host-rpc.parmigiana.signet.sh` |
| `SIGNET_FILLER_ROLLUP_RPC_URL` | URL for Rollup RPC node (ws/wss only) | `wss://rpc.parmigiana.signet.sh` |
| `SIGNET_FILLER_BLOCK_LEAD_DURATION_MS` | How far before each block boundary to submit fill bundles, in milliseconds | `2000` |
| `SIGNET_FILLER_MIN_PROFIT_THRESHOLD_WEI` | Minimum profit threshold in wei | `100` |
| `SIGNET_FILLER_GAS_ESTIMATE_PER_ORDER` | Estimated gas per order fill | `150000` |
| `SIGNET_FILLER_GAS_PRICE_GWEI` | Assumed gas price in gwei | `1` |
| `SIGNET_FILLER_HEALTHCHECK_PORT` | Port for the healthcheck HTTP server | `8080` |
| `SIGNER_KEY` | AWS KMS key ID or local private key | N/A |
| `SIGNER_CHAIN_ID` | Chain ID for AWS signer [optional] | N/A |
## Limitations
### Fixed Pricing
The current implementation uses hardcoded USD exchange rates and decimal counts for a set of known tokens (USDC, USDT, WETH, WBTC, and the native/wrapped rollup token). Orders referencing any other token will be rejected with an `UnknownToken` error.
A future improvement could handle unknown tokens by querying the ERC-20 contract on-chain for `decimals()` and `totalSupply()`, then assuming total supply represents a fixed USD value (e.g. $10k) to derive a token price. This would allow the filler to process orders for arbitrary tokens rather than only the hardcoded set.
### Single-Block Bundle Submission
Fill bundles currently target only the next block (N+1). If the bundle is not included in that block, it expires and the filler must wait for the next polling cycle to retry with fresh signatures.
A more reliable approach would be to submit bundles targeting multiple consecutive blocks (N+1, N+2, N+3) simultaneously, reusing the same signed fills. This would improve inclusion rates without additional signing overhead.
## Future Development
### Dynamic Block Lead Duration
The `SIGNET_FILLER_BLOCK_LEAD_DURATION_MS` setting is currently a static configuration value. This could be replaced with a dynamically calculated lead duration based on heuristics of historical inclusion rates — adjusting automatically to submit earlier when inclusion rates are low, or later when they are high, to balance freshness of order data against submission reliability.
## License
Licensed under either of [Apache License, Version 2.0](LICENSE-APACHE) or [MIT License](LICENSE-MIT) at your option.