gattaca-com/propamm

This repository provides scripts for automatically trading against a specific type of decentralized exchange pool on Ethereum, called a propAMM, across three particular protocols named FermiSwap, Kipseli, and Bebop. An AMM, short for automated market maker, is a smart contract that lets people swap one cryptocurrency token for another using a pricing formula instead of matching buyers and sellers directly. The trades in this project are submitted through a service called Titan's bundle relay, which groups transactions together before they reach the Ethereum network. There are three main pieces. A quoter script connects to a live data feed of pool state changes and simulates trades before they happen, showing what price a trade of a chosen dollar amount would get without actually sending it. A taker script, available in both Python and a matching Rust version that behaves the same way, does the real work: it converts plain ETH into wrapped ETH, grants the token approvals a swap needs, then signs and sends the actual trade. There is also an optional smart contract called KipseliGuard that anyone can use as a safety wrapper around the Kipseli pool, checking that a trade does not lose more value than expected to price movement between when it is prepared and when it executes. To use any of this, someone needs access to an Ethereum node connection, called an RPC endpoint, that supports certain advanced simulation features, available from paid providers like Alchemy or Infura, or by running a node themselves, since free public options usually will not work. Sending real trades additionally requires the private key of a funded Ethereum wallet, supplied through an environment variable, while the quoting tool does not need any funds or key at all. The taker script supports a one time setup step, single test trades without sending, and a continuous mode that watches live prices and automatically submits trades that meet chosen conditions like minimum priority fee and timing interval. The project is released under the MIT license.