{"id":15292359,"url":"https://github.com/Dvisacker/evm-projects","last_synced_at":"2025-02-23T07:33:14.446Z","repository":{"id":254521964,"uuid":"846030699","full_name":"Dvisacker/evm-projects","owner":"Dvisacker","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-13T07:27:29.000Z","size":22893,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-15T12:52:43.781Z","etag":null,"topics":["artemis","ethereum","evm","mev","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dvisacker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-MIT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-22T12:05:27.000Z","updated_at":"2025-02-13T07:27:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"12da39e5-9199-40e3-b949-62f8a7f5390d","html_url":"https://github.com/Dvisacker/evm-projects","commit_stats":{"total_commits":128,"total_committers":17,"mean_commits":7.529411764705882,"dds":0.2265625,"last_synced_commit":"cd2acc6f90bdebabe0f59eafce8ce1e4f3d41e7a"},"previous_names":["dvisacker/artemis-uni-tri-arb","dvisacker/bot","dvisacker/evm-projects"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dvisacker%2Fevm-projects","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dvisacker%2Fevm-projects/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dvisacker%2Fevm-projects/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dvisacker%2Fevm-projects/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dvisacker","download_url":"https://codeload.github.com/Dvisacker/evm-projects/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240286399,"owners_count":19777353,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["artemis","ethereum","evm","mev","rust"],"created_at":"2024-09-30T16:17:29.681Z","updated_at":"2025-02-23T07:33:14.382Z","avatar_url":"https://github.com/Dvisacker.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EVM projects \n\nVarious crates and binaries to trade and interact with EVM chains.\n\nThe pub/sub engine is originally forked from [Artemis](https://github.com/paradigmxyz/artemis).\n\n## Project Structure\n\n```\n/\n├── bin/                    # Binary crates (bot, cli, swap)\n├── crates/                 # Core library crates\n│   ├── addressbook/       # Address book to easily fetch known addresses\n│   ├── amms/              # Fork of amms-rs using alloy and with added support for curve, ramses, etc.  \n│   ├── engine/            # Pub/sub engine. Based on artemis.\n│   ├── db/                # Database models and queries\n│   ├── pool-manager/      # Pool storage manager for example for tagging and saving liquidity pools to db\n│   ├── tx-executor/       # Bundled tx encoder/executor\n│   ├── tx-simulator/      # Swap simulator\n│   ├── odos-client/       # Odos aggregator client\n│   ├── codex-client/      # Codex API client\n│   ├── lifi-client/       # Lifi bridge client\n│   ├── metadata/          # Functions to fetch aggregated chain data\n│   ├── provider/          # Provider utils\n│   ├── shared/            # Shared utils\n│   └── types/             # Shared types\n└── docker/               # Docker configuration\n```\n\n## Getting Started\n\n### Prerequisites\n\n- Rust 1.82 or higher\n- Docker (optional)\n- Access to Ethereum nodes or providers\n\n### Installation\n\n2. Copy the example environment file:\n```bash\ncp .env.example .env\n```\n\n3. Configure your environment variables in `.env`\n\n4. Build the project:\n```bash\ncargo build --release\n```\n\n### Running the Bot\n\n1. Using the CLI:\n```bash\ncargo run --bin cli -- --help\n```\n\n2. Using Docker:\n```bash\ndocker-compose up -d\n```\n\n## Configuration\n\nThe bot can be configured through:\n- Environment variables (`.env` file)\n- Command-line arguments\n- Configuration files\n\nSee `.env.example` for available configuration options.\n\n## Development\n\n### Adding New Strategies\n\n1. Create a new crate in `crates/strategies/`\n2. Implement the strategy traits from `engine`\n\n\n## Pool Storage Example CLI commands:\n\n### Get all Uniswap V3 pools on Base\n```bash\ncargo run --bin cli get-uniswap-v3-pools --chain-id 8453 --exchange uniswap-v3 --from-block 0 --step 5000 --tag univ3-base\n```\n\n### Get the most traded Uniswap V3 pools on Base\n```bash\ncargo run --bin cli get-most-traded-pools --chain-id 8453 --exchange uniswap-v3 --limit 100 --min-volume 100000 --tag univ3-base-most-traded\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDvisacker%2Fevm-projects","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDvisacker%2Fevm-projects","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDvisacker%2Fevm-projects/lists"}