Firefly V3 Periphery

This repository contains the periphery smart contracts for the Firefly V3 Protocol. For the lower level core contracts, see the firefly-core-v3 repository.

Bug bounty

This repository is subject to the Firefly V3 bug bounty program, per the terms defined here.

Local deployment

In order to deploy this code to a local testnet, you should install the npm package @firefly-dex/v3-periphery and import bytecode imported from artifacts located at @firefly-dex/v3-periphery/artifacts/contracts/*/*.json. For example:

import {
  abi as SWAP_ROUTER_ABI,
  bytecode as SWAP_ROUTER_BYTECODE,
} from '@firefly-dex/v3-periphery/artifacts/contracts/SwapRouter.sol/SwapRouter.json'

// deploy the bytecode

This will ensure that you are testing against the same bytecode that is deployed to mainnet and public testnets, and all Firefly code will correctly interoperate with your local deployment.

Using solidity interfaces

The Firefly v3 periphery interfaces are available for import into solidity smart contracts via the npm artifact @firefly-dex/v3-periphery, e.g.:

import '@firefly-dex/v3-periphery/contracts/interfaces/ISwapRouter.sol';

contract MyContract {
  ISwapRouter router;

  function doSomethingWithSwapRouter() {
    // router.exactInput(...);
  }
}