Skip to main content

ElizaOS Arbitrage Plugin

A powerful DEX arbitrage trading plugin for ElizaOS, designed to identify and automatically execute profitable cross-market trading opportunities on Ethereum-based decentralized exchanges.

Overview​

The ElizaOS Arbitrage Plugin monitors multiple decentralized exchanges (DEXs) like Uniswap and Sushiswap for price discrepancies in token pairs. When it identifies a profitable arbitrage opportunity that exceeds the configured threshold, it automatically executes the trade using Flashbots bundles to maximize profits and minimize risk.

Features​

  • Real-time Market Monitoring: Continuously watches market conditions across multiple DEXs via WebSocket connections
  • Automated Opportunity Detection: Analyzes price differences to identify profitable arbitrage paths
  • Smart Trade Execution: Uses Flashbots to execute trades privately and avoid front-running
  • Configurable Trading Parameters: Customizable profit thresholds, gas limits, and other trading parameters
  • Risk Management: Advanced volume optimization to minimize price impact and maximize profits
  • Performance Optimization: Efficient batch processing and concurrent operations for minimal latency

Prerequisites​

  • Node.js 18 or higher
  • An Ethereum wallet with private key
  • Access to an Ethereum WSS endpoint
  • Flashbots relay signing key
  • Bundle executor smart contract deployment

Installation​

npm install @elizaos-plugins/plugin-arbitrage

Configuration​

To use the plugin, you need to configure your ElizaOS character with the necessary settings:

{
  "name": "Trader",
  "settings": {
    "secrets": {
      "EVM_PRIVATE_KEY": "YOUR_PRIVATE_KEY_HERE",
      "FLASHBOTS_RELAY_SIGNING_KEY": "YOUR_FLASHBOTS_KEY_HERE",
      "BUNDLE_EXECUTOR_ADDRESS": "YOUR_EXECUTOR_ADDRESS_HERE"
    },
    "arbitrage": {
      "ethereumWsUrl": "YOUR_ETH_WSS_URL",
      "rpcUrl": "YOUR_ETH_RPC_URL"
    }
  },
  "plugins": ["@elizaos/plugin-arbitrage", "@elizaos/plugin-evm"]
}

Required Settings​

SettingDescription
EVM_PRIVATE_KEYPrivate key for your Ethereum wallet (keep this secure!)
FLASHBOTS_RELAY_SIGNING_KEYSigning key for Flashbots bundles
BUNDLE_EXECUTOR_ADDRESSAddress of your bundle executor contract
ethereumWsUrlWebSocket URL for your Ethereum node
rpcUrlRPC URL for your Ethereum node

Usage​

The plugin integrates with ElizaOS and provides the following capabilities:

Actions​

  • EXECUTE_ARBITRAGE: Scans for and executes profitable arbitrage opportunities

Providers​

  • marketProvider: Provides real-time market data and arbitrage opportunities

Example Interactions​

User: "Find arbitrage opportunities"
Trader: "Scanning for arbitrage trades..."

Advanced Configuration​

You can customize trading parameters by modifying the thresholds in src/config/thresholds.ts:

export const DEFAULT_THRESHOLDS: MarketThresholds = {
  minProfitThreshold: BigNumber.from('100000000000000'), // 0.0001 ETH
  maxTradeSize: BigNumber.from('1000000000000000000'), // 1 ETH
  gasLimit: 500000,
  minerRewardPercentage: 90,
};

Architecture​

The plugin consists of several key components:

  • Core Engine: Implements the arbitrage detection and execution logic
  • Market Adapters: Interfaces with various DEXs like Uniswap and Sushiswap
  • WebSocket Manager: Handles real-time market data updates
  • Service Layer: Integrates with ElizaOS to provide plugin functionality

Security Considerations​

  • Ensure your private keys are stored securely
  • Test with small amounts before deploying with significant capital
  • Monitor gas costs to ensure profitability
  • Implement circuit breakers for market volatility