Skip to main content

0x Protocol

0x Protocol is a decentralized exchange infrastructure that enables the peer-to-peer exchange of tokens on Ethereum and other blockchains. It functions as an aggregator, sourcing liquidity from various DEXes to provide the best rates for traders.

Overview​

0x Protocol offers several key features:

  • Liquidity Aggregation: Sources liquidity from multiple DEXes to find the best rates
  • Gas Optimization: Implements efficient routing to minimize gas costs
  • Limit Orders: Supports limit orders through off-chain order books
  • RFQ System: Request-for-quote system for professional market makers
  • Multi-Chain Support: Available on multiple blockchains beyond Ethereum
  • 0x API: Simple API for developers to integrate swap functionality

Integration with Bloctopus​

When using Bloctopus with a forked Ethereum network, you can interact with 0x Protocol contracts that are already deployed on mainnet. This allows you to test your DeFi applications against real 0x Protocol infrastructure.

info

This sample guide is for forked Ethereum networks but you can adapt the respective contract addresses when using other forked networks (e.g. Optimism, Arbitrum)

Key Contracts​

The main 0x Protocol contracts you'll interact with:

  • Exchange Proxy: 0xdef1c0ded9bec7f1a1670819833240f027b25eff
  • Zero Ex: 0x61935cbdd02287b511119ddb11aeb42f1593b7ef
  • Staking Proxy: 0xa26e80e7Dea86279c6d778D702Cc413E6CFfA777

Sample Implementation​

The DeFi Samples repository contains ready-to-use scripts for interacting with 0x Protocol:

  • Query: query.js - Get information about supported DEXes and protocol configuration
  • Quote: quote.js - Get price quotes for token swaps using the 0x API
  • Swap: swap.js - Execute token swaps using the 0x Exchange Proxy

Running the Scripts​

To run these scripts with Bloctopus:

  1. Clone the DeFi Samples repository:

    git clone https://github.com/LZeroAnalytics/defi-samples.git
    cd defi-samples

  2. Install dependencies:

    npm install

  3. Create a .env file with your Bloctopus RPC endpoint and private key:

    RPC_URL=https://your-bloctopus-rpc-endpoint
    PRIVATE_KEY=your-private-key

  4. Run a script:

    npx hardhat run scripts/protocols/0x/query.js
    npx hardhat run scripts/protocols/0x/quote.js
    npx hardhat run scripts/protocols/0x/swap.js

Testing with Bloctopus​

To test 0x Protocol interactions using Bloctopus:

  1. Create a forked Ethereum network in Bloctopus
  2. Configure your Hardhat project to use the Bloctopus RPC endpoint
  3. Run your scripts or tests against the forked network

Resources​