@airswap/peer v0.3.0

Peer

:warning: This package is under active development. Do not use in production.

AirSwap is a peer-to-peer trading network for Ethereum tokens. This package contains source code and tests for a basic Peer contract that can be deployed with trading rules. In addition, there is a PeerFactory contract that deploys Peer contracts as well.

:bulb: Note: solidity-coverage does not cooperate with view functions. To run test coverage, remove the view keywords from functions in Peer.sol, IPeer.sol, and PeerFactory.sol.

Peer

Features

Limit Orders

Set rules to only take trades at specific prices.

Partial Fills

Send up to a maximum amount of a token.

Definitions

Constructor

Create a new Peer contract.

constructor(
  address _swapContract,
  address _peerContractOwner
) public

Params

Price Calculations

All amounts are in the smallest unit (e.g. wei), so all calculations based on price result in a whole number. For calculations that would result in a decimal, the amount is automatically floored by dropping the decimal. For example, a price of 5.25 and takerParam of 2 results in makerParam of 10 rather than 10.5. Tokens have many decimal places so these differences are very small.

Set a Rule

Set a trading rule on the peer.

function setRule(
  address _takerToken,
  address _makerToken,
  uint256 _maxTakerAmount,
  uint256 _priceCoef,
  uint256 _priceExp
) external onlyOwner

Params

Example

Set a rule to send up to 100,000 DAI for WETH at 0.0032 WETH/DAI

setRule(<WETHAddress>, <DAIAddress>, 100000, 32, 4)

Set a rule to send up to 100,000 DAI for WETH at 312.50 WETH/DAI

setRule(<WETHAddress>, <DAIAddress>, 100000, 32150, 2)

Set a rule to send up to 100,000 DAI for WETH at 312 WETH/DAI

setRule(<WETHAddress>, <DAIAddress>, 100000, 312, 0)

Unset a Rule

Unset a trading rule for the peer.

function unsetRule(
  address _takerToken,
  address _makerToken
) external onlyOwner

Params

Get a Maker-Side Quote

Get a quote for the maker (consumer) side. Often used to get a buy price for _quoteTakerToken.

function getMakerSideQuote(
  uint256 _quoteTakerParam,
  address _quoteTakerToken,
  address _quoteMakerToken
) external view returns (
  uint256 quoteMakerParam
)

Params

Reverts

Get a Taker-Side Quote

Get a quote for the taker (peer) side. Often used to get a sell price for _quoteMakerToken.

function getTakerSideQuote(
  uint256 _quoteMakerParam,
  address _quoteMakerToken,
  address _quoteTakerToken
) external view returns (
  uint256 quoteTakerParam
)

Params

Reverts

Get a Max Quote

Get the maximum quote from the peer.

function getMaxQuote(
  address _quoteTakerToken,
  address _quoteMakerToken
) external view returns (
  uint256 quoteTakerParam,
  uint256 quoteMakerParam
)

Params

Reverts

Provide an Order

Provide an order to the peer for taking.

function provideOrder(
  Types.Order memory _order
) public

Params

Reverts

Peer Factory

Features

Deploys Peer Contracts

Creates peers with a trusted interface

Has lookup to find peer contracts it has deployed

Definitions

Constructor

Create a new Peer contract.

constructor(
  address _swapContract,
  address _peerContractOwner
) public

Create a new Peer contract.

createPeer(
  address _swapContract,
  address _peerContractOwner
) external returns
  (address peerContractAddress)

Params

Lookup for deployed peers

To check whether a locator was deployed

function has(
  bytes32 _locator
) external returns (bool)

Params