fastlane-bot 0.13.1

Carbon Arbitrage Bot, an open-source arbitrage protocol, allows any user to perform arbitrage between Bancor ecosystem protocols and external exchanges and redirect arbitrage profits back to the protocol.

Fastlane Arbitrage Bot

⚠️ WARNING: Use at Your Own Risk

The Fastlane Bot requires an Ethereum private key. Your funds are AT RISK when you run the Fastlane Arbitrage Bot. Read the Preparation section below. The bot is provided as-is, with the authors and the Bprotocol Foundation not liable for any losses.

Overview

The Fastlane Arbitrage Bot identifies and executes arbitrage opportunities between Carbon, Bancor, and the broader market, enhancing market efficiency by aligning Carbon and Bancor with market trends.

Permanent URL for this repository: github.com/bancorprotocol/fastlane-bot

Getting Started

Installation

Install Fastlane Arbitrage Bot from PyPi using the following command:

pip install fastlane_bot

Or clone the repo from Bancor's GitHub:

git clone https://github.com/bancorprotocol/fastlane-bot
cd fastlane-bot
pip install -r requirements.txt
python setup.py install

Preparation

The Fastlane Arbitrage Bot needs access to an Ethereum wallet's private key. THIS KEY IS AT RISK AND SHOULD NOT BE USED ELSEWHERE. Maintain some ETH in the wallet for gas fees and regularly sweep profits. Supply the private key to the bot using an environment variable, as shown:

set ETH_PRIVATE_KEY_BE_CAREFUL="0x9c..."

The bot also needs access to the Ethereum blockchain, preconfigured to use Alchemy. Obtain a free API key from alchemy.com and supply it to the bot using an environment variable:

set WEB3_ALCHEMY_PROJECT_ID="0-R5..."

The bot uses python-dotenv to load environment variables from a .env file in the root directory. However, this is not recommended for security reasons, especially on unencrypted disks.

export WEB3_ALCHEMY_PROJECT_ID="0-R5..."
export ETH_PRIVATE_KEY_BE_CAREFUL="0x9c..."

Execution

After installation, run the bot with default parameters using the command:

python main.py 

Configuration Options

You can configure the Fastlane Arbitrage Bot using the options in the @click.option section of main.py. An overview of options is provided below:

• cache_latest_only (bool): Whether to cache only the latest events.
• arb_mode (str): Specifies the arbitrage mode. Options include:
  • single: Arbitrage between one Carbon curve and one other exchange curve.
  • multi (default): Arbitrage between multiple Carbon curves and one other exchange curve.
  • triangle: Triangular arbitrage between one Carbon curve and two other exchange curves.
  • multi_triangle: Triangular arbitrage between multiple Carbon curves and two other exchange curves.
  • bancor_v3: Arbitrage between two Bancor v3 pools and one other exchange curve.
• flashloan_tokens (str): Tokens the bot can use for flash loans. Specify tokens as a comma-separated string in TKN-ADDR format (e.g., BNT-FF1C, WETH-6Cc2).
• exchanges (str): Comma-separated string of exchanges to include.
• polling_interval (int): Bot's polling interval for new events.
• alchemy_max_block_fetch (int): Maximum number of blocks to fetch in a single request.
• reorg_delay (int): Number of blocks to wait to avoid reorgs.
• loglevel (str): Logging level, which can be DEBUG, INFO, WARNING, or ERROR.

Specify options in the command line. For example:

python main.py --arb_mode=multi --polling_interval=12 --reorg_delay=10 --loglevel=INFO

Troubleshooting

If you encounter import errors or ModuleNotFound exceptions, try:

python <absolute_path>/main.py

The Fastlane Arbitrage Bot uses Brownie with Alchemy for Ethereum network calls. If you need to manually configure Brownie, follow these steps:

brownie networks update_provider alchemy https://eth-{}.alchemyapi.io/v2/$WEB3_ALCHEMY_PROJECT_ID
brownie networks modify mainnet provider=alchemy
brownie networks set_provider alchemy

For further issues, check the Brownie documentation.

Change Log

We follow semantic versioning (major.minor.patch), updating the major number for backward incompatible API changes, minor for compatible changes, and patch for minor patches.

• v2.0 - Complete rewrite to include Carbon along with Bancor.
• v1.0 - Initial bot version for Bancor protocol pools only.