How johngrantuk/balancerbot works
This repository’s product is an off-chain Ethereum arbitrage bot backed by an atomic on-chain executor. The principal workflow reads exchange prices, compares Kyber’s ETH-to-token quote with Uniswap’s token-to-ETH rate, prepares token approval and trade calls, then submits a trade through the executor. The README documents the executor’s all-or-nothing two-leg swap. The React client appears to be an unrelated Truffle starter example, so it is not included. Contract internals are represented from README descriptions because their source was not sampled.
Main entry points: main.js Bot runner · KyberUniArbContract.sol Atomic arbitrage executor · UniswapExchange.sol Uniswap exchange · ERC20Token.sol ERC20 token
Components 15
Bot and pricing
- Bot runner
main.js - Rate comparison
main.js
Trade execution
- Approval flow
main.js - Trade preparation
main.js - Transaction submission
main.js - Atomic arbitrage executor
contracts/KyberUniArbContract.sol
Exchange protocols
- Kyber quote client
main.js - Uniswap market client
main.js - Kyber proxy
contracts/KyberNetworkProxy.sol - Uniswap exchange
contracts/UniswapExchange.sol
Token assets
- ERC20 token
contracts/ERC20Token.sol
Other components
- Bot operator
- Ethereum RPC
- Kyber Network
- Uniswap protocol
Connections 18
- Bot operator → Bot runner: starts
main.js - Bot runner → Approval flow: checks approval
main.js - Bot runner → Rate comparison: checks rates
main.js - Rate comparison → Kyber quote client: requests quote
main.js - Rate comparison → Uniswap market client: reads market
main.js - Kyber quote client → Kyber Network: queries rates
main.js - Uniswap market client → Uniswap protocol: reads reserves
main.js - Approval flow → Atomic arbitrage executor: calls approval
main.js - Approval flow → ERC20 token: checks allowance
main.js - Approval flow → Uniswap exchange: gets exchange
main.js - Bot runner → Trade preparation: prepares trade
main.js - Trade preparation → Uniswap market client: gets execution details
main.js - Bot runner → Transaction submission: submits trade
main.js - Transaction submission → Atomic arbitrage executor: sends transaction
main.js - Transaction submission → Ethereum RPC: broadcasts signed transaction
main.js - Atomic arbitrage executor → Kyber proxy: swaps via Kyber
README.md - Atomic arbitrage executor → Uniswap exchange: swaps via Uniswap
README.md - Atomic arbitrage executor → ERC20 token: trades ERC20
README.md