README.md

Component Protocol version 1

Component Protocol is an automated market maker for assets of the same numeraire. It is ideal for stablecoin to stablecoin trades, and other assets like BTC on ETH and staking derivatives.

Contracts

Component Protocol is currently deployed to mainnet at the following addresses

• Component 50% USDP,25% USDC,25% USDT Pool
• Component 50% USDP,25% DAI,25% sUSD Pool
• Component 50% USDP,25% WXDAI,25% USDC Pool (xDai)
• Component 50% WXDAI,50% Dai(bsc) Pool (xDai)
• Component 25% DAI(bsc),25% USDC(bsc),25% USDC,25% WXDAI Pool (xDai)
• Component 50% USDP,25% BUSD,25% USDT Pool (BSC)
• Component 45% BUSD,45% USDT,10% USDC Pool (BSC)
• Assimilator Contracts on Ethereum
  • USDP Assimilator
  • USDC Assimilator
  • USDT Assimilator
  • DAI Assimilator
  • SUSD Assimilator
• Assimilator Contracts on xDai
  • USDP Assimilator 0xFe7ed09C4956f7cdb54eC4ffCB9818Db2D7025b8
  • USDC Assimilator 0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83
  • WXDAI Assimilator 0xe91D153E0b41518A2Ce8Dd3D7944Fa863463a97d
  • DAI(bsc) Assimilator 0xFc8B2690F66B46fEC8B3ceeb95fF4Ac35a0054BC
  • USDC(bsc) Assimilator 0xD10Cc63531a514BBa7789682E487Add1f15A51E2
• Assimilator Contracts on BSC
  • USDP Assimilator 0xDACD011A71f8c9619642bf482f1D4CeB338cfFCf
  • BUSD Assimilator 0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56
  • USDT Assimilator 0x55d398326f99059fF775485246999027B3197955
  • USDC Assimilator 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d

Security

Shell Protocol v1 (from which this repo has been forked) has been audited by Consensys Diligence and ABDK Consulting. Audit reports will be available soon.

Documentation

Documentation for Component will be available soon.

Development

Prerequisites

Install Nix: https://nixos.org/download.html

Install dapp.tools (provides dapp, seth, hevm executables):

nix-env -iA dapp -f https://github.com/dapphub/dapptools/archive/afbb707102baa77eac6ad70873fcd3c59a2ff53c.tar.gz

(older releases, including 0.31.1, have library deployment bugs)

Install dependencies:

# in the repo root dir:
dapp update

Install compiler:

nix-env -f https://github.com/dapphub/dapptools/archive/master.tar.gz -iA solc-static-versions.solc_0_5_15

Build

dapp --use solc:0.5.15 build

*build is non-incremental

Local test

Use local_testing branch. Local tests require compiler upgrade, this change is yet to be merged into master.