Curve TriCrypto Factory

This github contains smart contracts (and accompanying tests) on an optimised version of Curve Finance Tricrypto pool deployed on Ethereum.

The AMM (automatic market maker) infrastructure involves the following parts:

1. Factory
2. AMM blueprint contract
3. Math
4. Views
5. Liquidity Gauge blueprint contract

The Factory can accommodate multiple blueprints of the AMM contract (deployed on chain). These blueprints are then specified by the user while deploying the pool. Similarly, liquidity gauges can be deployed through the factory contract as well for a specific pool, through liquidity gauge blueprint contracts.

The AMM is a 3-coin, auto-rebalancing Curve Cryptoswap implementation. The contract is a version 2.0.0, with several optimisations that make the contract cheaper for the end user. Also, unlike the older version: the pool contract is an ERC20-compliant LP token as well.

The Math contract contains the different math functions used in the AMM.

The Views contract contains view methods relevant for integrators and users looking to interact with the AMMs. Unlike the older tricrypto contracts. The address of the deployed Views contract is stored in the Factory: users are advised to query the stored views contract, since that is upgradeable by the Factory's admin.

The Factory AMMs have a hardcoded ADMIN_FEE, set to 50% of the earned profits. Factory admins can also implement parameter changes to the AMMs, change the fee recepient, upgrade/add blueprint contract addresses stored in the factory. Unlike the original tricrypto contracts, Factory tricrypto contracts cannot be killed by the admin.

In case of any issues that result in a borked AMM state, users can safely withdraw liquidity using remove_liquidity at balances proportional to the AMM balances.

For developers

To run tests:

> python -m pytest

To contribute

In order to contribute, please fork off of the main branch and make your changes there. Your commit messages should detail why you made your change in addition to what you did (unless it is a tiny change).

If you need to pull in any changes from main after making your fork (for example, to resolve potential merge conflicts), please avoid using git merge and instead, git rebase your branch

Please also include sufficient test cases, and sufficient docstrings. All tests must pass before a pull request can be accepted into main

Smart Contract Security Vulnerability Reporting

Please refrain from reporting any smart contract vulnerabilities publicly. The best place to report first is security@curve.fi.

Deployments

Ethereum:

1. Factory: 0x0c0e5f2fF0ff18a3be9b835635039256dC4B4963
2. AMM Blueprint: 0x66442B0C5260B92cAa9c234ECf2408CBf6b19a6f
3. Math: 0xcBFf3004a20dBfE2731543AA38599A526e0fD6eE
4. Views: 0x064253915b8449fdEFac2c4A74aA9fdF56691a31
5. Gauge Blueprint: 0x5fC124a161d888893529f67580ef94C2784e9233
6. TricryptoFactoryHandler: 0x30a4249C42be05215b6063691949710592859697

Updated AMM Blueprint (14-09-2023): 0xbC0797015fcFc47d9C1856639CaE50D0e69FbEE8

Deployed Pool:

1. TricryptoUSDC 0x7f86bf177dd4f3494b841a37e810a34dd56c829b

Arbitrum:

1. Factory: 0xbC0797015fcFc47d9C1856639CaE50D0e69FbEE8
2. AMM Blueprint: 0xd7E72f3615aa65b92A4DBdC211E296a35512988B
3. Math: 0x604388Bb1159AFd21eB5191cE22b4DeCdEE2Ae22
4. Views: 0x06452f9c013fc37169B57Eab8F50A7A48c9198A3

Updated AMM Blueprint (14-09-2023): 0xbC0797015fcFc47d9C1856639CaE50D0e69FbEE8

Deployed Pool:

1. TricryptoUSDC 0x7706128aFAC8875981b2412faC6C4f3053EA705f

License

(c) Curve.Fi, 2023 - All rights reserved.