letgotine / aura-contracts

Aura Finance contracts

Aura Finance

Security

Smart contract security is a top priority for Aura, see Security documentation .

If you have any feedback or concerns, reach out to [email protected]

Dev

Pre Requisites

Submodule

$ git submodule init
$ git submodule update

Install

$ yarn install

Compile

Compile the smart contracts with Hardhat:

$ yarn compile

TypeChain

Compile the smart contracts and generate TypeChain artifacts:

$ yarn typechain

Lint Solidity

Lint the Solidity code:

$ yarn lint:sol

Lint TypeScript

Lint the TypeScript code:

$ yarn lint:ts

Test

Run the Mocha tests:

$ yarn test

Run fork tests

$ yarn test:fork:all

Tasks

Running in fork mode

$ NODE_URL=<FORK_URL> yarn task:fork <TASK_NAME>

Running task normally

$ NODE_URL=<NODE_URL> yarn task --network <NETWORK> <TASK_NAME>

Coverage

Generate the code coverage report:

$ yarn coverage

Clean

Delete the smart contract artifacts, the coverage reports and the Hardhat cache:

$ yarn clean

Local Fork

This runs a local node on your system, that can be used with Metamask, etc.

Run a local fork:

npx hardhat node --fork https://eth-mainnet.alchemyapi.io/v2/<API_KEY> --port <PORT>

Once you stake or lock CVX you may want to progress timestamps to check rewards stuff

export NODE_URL=<LOCAL_NODE_URL>
yarn task timeTravel --duration 69420 --network forking

Diagrams

Booster Reward Flow

Cvx Reward Flow

Deployments

Ethereum Mainnet (1)

Contract	Address
voterProxy	0xaF52695E1bB01A16D33D7194C28C42b10e0Dbec2
aura	0xC0c293ce456fF0ED870ADd98a0828Dd4d2903DBF
minter	0x59A5ccD34943CD0AdCf5ce703EE9F06889E13707
booster	0xA57b8d98dAE62B26Ec3bcC4a365338157060B234
boosterOwner	0x228a142081b456a9fF803d004504955032989f04
boosterOwnerSecondary	0xCe96e48A2893C599fe2601Cc1918882e1D001EaD
boosterHelper	0x82bbbC3c7B459913Ae6063858832a6C2c43D0Bd0
rewardFactory	0xBC8d9cAf4B6bf34773976c5707ad1F2778332DcA
tokenFactory	0x3eC040DbF7D953216F4C89A2e665d5073445f5Ba
proxyFactory	0xf5E2cFde016bd55BEF42a5A4bAad7E21cd39720d
stashFactory	0x54da426EFBB93fbaB5CF81bef03F9B9F00A3E915
extraRewardStashV3	0x4A53301Fe213ECA70f904cD3766C07DB3A621bF8
arbitratorVault	0x5d208cD54f5132f2BD0c1F1e8d8c864Bb6BEdc40
auraBAL	0x616e8BfA43F920657B3497DBf40D6b1A02D4608d
auraBALBpt	0x3dd0843a028c86e0b760b1a76929d1c5ef93a2dd
cvxCrvRewards	0x00A7BA8Ae7bca0B10A32Ea1f8e2a1Da980c6CAd2
initialCvxCrvStaking	0xC47162863a12227E5c3B0860715F9cF721651C0c
crvDepositor	0xeAd792B55340Aa20181A80d6a16db6A0ECd1b827
crvDepositorWrapper	0x68655AD9852a99C87C0934c7290BB62CFa5D4123
crvDepositorWrapperWithFee	0x6eb746A3F23D401f80AB033edeb65e1a8bB27586
auraLocker (vlAURA)	0x3Fa73f1E5d8A792C80F426fc8F84FBF7Ce9bBCAC
cvxStakingProxy	0xd9e863B7317a66fe0a4d2834910f604Fd6F89C6c
chef	0x1ab80F7Fb46B25b7e0B2cfAC23Fc88AC37aaf4e9
lbpBpt	0x6fc73b9d624b543f8b6b88fc3ce627877ff169ee
balLiquidityProvider	0xa7429af4DeB16827dAd0e71D8AEEa9C2bF70e32c
penaltyForwarder	0x4043569200F7a7a1D989AbbaBC2De2Bde1C20D1E
extraRewardsDistributor	0xA3739b206097317c72EF416F0E75BB8f58FbD308
poolManager	0x8Dd8cDb1f3d419CCDCbf4388bC05F4a7C8aEBD64
poolManagerProxy	0x2c809Ec701C088099c911AF9DdfA4A1Db6110F3c
poolManagerSecondaryProxy	0xa72932Aea1392b0Da9eDc34178dA2B29EcE2de54
vestedEscrows	0x5bd3fCA8D3d8c94a6419d85E0a76ec8Da52d836a
	0x24346652e0e2aE0CE05c781501fDF4Fe4553fAc6
	0x45025Ebc38647bcf7Edd2b40CfDaF3fbfE1538F5
	0x43B17088503F4CE1AED9fB302ED6BB51aD6694Fa
	0xFd72170339AC6d7bdda09D1eACA346B21a30D422
drops	0x45EB1A004373b1D8457134A2C04a42d69D287724
	0x1a661CF8D8cd69dD2A423F3626A461A24280a8fB
auraClaimZap	0x2E307704EfaE244c4aae6B63B601ee8DA69E92A9
claimFeesHelper	0xAf824c80aA77Ae7F379DA3Dc05fea0dC1941c200
rewardPoolDepositWrapper	0xB188b1CB84Fb0bA13cb9ee1292769F903A9feC59
ChefForwarder	0x57d23f0f101cBd25A05Fc56Fd07dE32bCBb622e9
ChefForwarderSiphonToken	0xc9307D63B3709F537D2158F43199a69682Ff0967
masterChefRewardHook	TBD
masterChefRewardHookSiphonToken	0xbB7A6Ec509D42177C100273b4cd785816daF8e4f
gaugeMigrator	0xCd36ed329d338C88775D6f499E99265989DeBA53
poolMigrator	0x12addE99768a82871EAaecFbDB065b12C56F0578
siphonToken	TBD
uniswapMigrator	0x5B6159F43585e8A130b0Bc1d31e38Ce7028145b6
auraMining	0x744Be650cea753de1e69BF6BAd3c98490A855f52
VirtualRewardsFactory	0x64E2dF8E5463f8c14e1c28C9782f7B4B6062b2c3
auraBalVault	0xfAA2eD111B4F580fCb85C48E6DC6782Dc5FCD7a6
auraBalVault Strategy	0x7372EcE4C18bEABc19981A53b557be90dcBd2b66
auraBalVault BBUSDHandler (v3)	0x1bAB8Bcb00B0Fd63D4e28249ad54f6e6329b7fCC
auraBalVault VirtualRewards	0xAc16927429c5c7Af63dD75BC9d8a58c63FfD0147
auraClaimZapV3	0x5b2364fD757E262253423373E4D57C5c011Ad7F4
auraBalStaker	0xa3fCaFCa8150636C3B736A16Cd73d49cC8A7E10E
feeScheduler	0x1a65276A9B6A0611506763839B1fFAe3E86718b4
veBalGrant	0x89f67f3054bFD662971854190Dbc18dcaBb416f6
auraViewHelpers	0x129bBda5087e132983e7c20ae1F761333D40c229
KeeperMulticall3	0x817F426B5a79599464488eCCf82c3F54b9330E15
WardenQuestScheduler	0x3FCB0Cc19C41E9D2DB3b9764032CD457bAA2fb47

Arbitrum (42161)

Contract	Address
AuraArbBalGrant	0x8D803f7f7e26E586ee90E5A872cf7830e21f7727

Goerli (5)

Contract	Address
voterProxy	0xB6856b8725504Fc496f810d07a6659e1145b671d
aura	0x8Ef4f64D86016D30266c91cDDbE555B52a3Ce833
minter	0x4D790084E4E7a5caCb85156AaA4DD14eDf813bf8
booster	0xA0357552c3e4ACB2f5828D1322D90A22801AD196
boosterOwner	0xeAb0b6c2528C54887d5DD3765ed9Bd1884A1d125
arbitratorVault	0x8e258eaBDc2aeE5528A9517C0199DB8f5CdC2cC9
auraBAL	0x13CCfb302Ab3EC5e646bD9Bdc87180fD255ee6A8
auraBALBpt	0xD30d0B8667fd215ECEe125f56ae1e30d42659850
cvxCrvRewards	0xA2F294C74fe9d63Dc272b6a5C3aE494BfA0DF14B
initialCvxCrvStaking	0xEC24eBf4c3AE1fF5B8FeFdA36B63a36261Fb95c1
crvDepositor	0x46af03341e0Afb410c87c5A6dF412Bf5C8858cCc
crvDepositorWrapper	0x79CC68A74F388d260e6Ed8F8aE2ce810E8d6FE38
poolManager	0x68707046fF3fC67c931f0eb5f6d227bbe1DE6a7B
poolManagerProxy	0xA5e7926f7385c96c9a0DB751234EFc3eB503bA89
poolManagerSecondaryProxy	0x06531Dbfce795B84b4d29943eDF08239855c4D62
auraLocker	0x984B0aDFf6137BB1E00c977c594f4C1664894CEc
cvxStakingProxy	0x3DF79aFA5ECaCfB67719F0c34b562BA8cA5F0945
chef	0x8155a8fc133648aA21272dD5afE2a700B28c6250
vestedEscrows	0xad45617A84F30868Ee69d5A22dCB49AE0AD78D57
	0xaB79aa6238D0d4BB27651534Fb08F4Bf1Ece122B
	0x0Ee0CaE533B5c86910De029bbB3238c8824C11c4
	0xEEf969A8ebdf73C5c5D8A2855206F1154Cd1a297
drops	0xae6d5d7a8108c074220D3692C045696389d6D933
	0x68AAf3ac16b57f3eC47F766b11f18f3DFFdC18db
lbpBpt	N/A
balLiquidityProvider	0xaffFf00e97A82535AB9e6B22D26fB37B8b66B9dF
penaltyForwarder	0xB3Fa61fAC621e23A8fAcc26e54902D69851ac572
extraRewardsDistributor	0xa7AAa5feE1676938Eec8E45F984552C216da3796
pool8020Bpt	0xf8a0623ab66f985effc1c69d05f1af4badb01b00
claimZap	0x39c8bE679120fcE63c9bB6ED5c6bE8225C9f16b9
feeCollector	0x43Cd36E200EE1e590a930c21Fd1f67bb90d7f8B3
rewardDepositWrapper	0x9161Fb533BA46B48464F945E4520CDD0E8d4F223
extraRewardStashV3	0x006aCF075161129190432D52F49dC4Ed267AC23A
boosterOwnerSecondary	0x3F8fa3CBd1157C8BaA5374feea0058A9AE68eb93
poolManagerV4	0x67b36B5A54Ab33C0cD38682693eEc78D08B008d1
50slkBUL-50B-80BAL-20WETH	0x16442f5670083dB2eF1fe6820a59cb9Baa0113B5
vault	0x0E69F37f5009c174537277BA956A13663AAAa814
strategy	0x098810A74E7682fD650439E2b7440519cf4B022A
bbusdHandler	0xb30a0c7ac99D61650A528AbB31A46470C55f4834
auraRewards	0x6fE74EA452b21698bbC27617b2B23FB797393094
virtualRewardFactory	0x3f897302B09e763650D825Cd3c738EfDf8510Ad8
create2Factory	0xFf87D90216C236B39D74d5404AE86b8b1DA3b448

Arbitrum (42161)

Arbitrum Goerli (42163)

Contract	Address
create2Factory	0x2E1ADE7233e886D8041Fd7c3b87523F3DDC2169D

Ethereum Mainnet (1) @deprecated

Contract	Address
auraClaimZap	0x623B83755a39B12161A63748f3f595A530917Ab2
booster	0x7818A1DA7BD1E64c199029E86Ba244a9798eEE10
boosterOwner	0xFa838Af70314135159b309bf27f1DbF1F954eC34
boosterHelper	0x00a31B98c325A8dcb8d1Dd41d65156A5C898F38c
claimFeesHelper	0xCEeCeA8035e81C1148210DB3b2f870F470CC81bf
cvxCrvRewards	0x5e5ea2048475854a5702F5B8468A51Ba1296EFcC
extraRewardStashV3	0xF9C0f3431F859e773eD052758052e06B6D175742
masterChefRewardHook	0x6a29cFd8A5F666A7D69da9437CD4c46616326815
poolManager	0xf843F61508Fc17543412DE55B10ED87f4C28DE50
poolManagerProxy	0x16A04E58a77aB1CE561A37371dFb479a8594947A
poolManagerSecondaryProxy	0xdc274F4854831FED60f9Eca12CaCbD449134cF67
proxyFactory	0x7eD9003C6003EaCe1e8C3ae99F0Bb19894377b0F
rewardFactory	0x45aaD11F2FA2C215bc9686eb6f06D46E0474F356
stashFactory	0x95171c9Ef5cA540A6d3502e9547fcFE022458Eb5
tokenFactory	0xb6CE51DEE8BD4A2Fd11c01205414dc26f0b453AC

Ethereum Mainnet (2) @deprecated

| auraBalVault BBUSDHandler (v2) | 0xC4eF943b7c2f6b387b37689f1e9fa6ecB738845d | | extraRewardStashV3 | 0x37C3EBfD4b0cF66DF19a413e92dd21E556915F98 | | poolManager | 0xB58Eb197c35157E6F3351718C4C387D284562BE5 | | gaugeMigrator | 0x7954bcDce86e86BeE7b1dEff48c3a0b9BCCe578B |

Goerli (5) @deprecated

Contract	Address
voterProxy	0x57d23f0f101cBd25A05Fc56Fd07dE32bCBb622e9
aura	0xFf3653ee692F541efB7c2214D72FE05A7A6EC01f
minter	0x3366EfDdc7d268759a1A1273740aE5C626b2DFbA
booster	0x2ad214dA65effA92159057957E50994440E99A1b
boosterOwner	0x6931835d072f50d98D7a7BF7B2C4faFdA86628d7
auraBAL	0xf80D3083b18fe3f11196E57438258330Ba4f15Ec
auraBALBpt	0xAc98C986d8318ff08109AE6F4E7043468dA9d0a2
cvxCrvRewards	0x09421e5d9c2b11f502482dce2b718b037fd10a25
initialCvxCrvStaking	N/A
crvDepositor	0xD2e06829a8464bd802Ef68A6C900F36db3a86cb1
crvDepositorWrapper	0x4AC5c047CfA39b14fb06564DEC7D85e6fA2b045a
poolManager	0x0B4566B619Dc12381E386564E45df62316259E71
auraLocker	0x1e5B33222977642Bf64EC80846BBF83A016727A0
cvxStakingProxy	0x1a8bb30f2aff498ef026d2bccc8971a30144b93c
chef	0xa3fCaFCa8150636C3B736A16Cd73d49cC8A7E10E
lbpBpt	N/A
balLiquidityProvider	N/A
penaltyForwarder	N/A
extraRewardsDistributor	0xbdfFBBD7Ac592a53405AE152B6D23CF3F6B8a738
pool8020Bpt	0xf8a0623ab66f985effc1c69d05f1af4badb01b00
claimZap	0x9Ba88Cb931B46a6E646B9bd0ba677D375647EB23
vestedEscrows	N/A
drops	N/A
claimFeesHelper	0xDc2f8293f7f3E49a949df6A1FB1bCb9200eC3982
rewardPoolDepositWrapper	0x0a6bcB3a0C03aB2Bc8A058ee02ed11D50b494083
GaugeMigrator	0x432d9d821ed4a6fc29f41631e27ba91d4800f081
sushiSwapMigrator	0x68664CA1fCa837de57d8cdE8B83d3A9587De2E58
auraBalVault	0x064D9Aea351205c01dA2270fFe19C8e4Ca91904B
vaultStrategy	0xab07f0279023886222e80E25CB4a01CD007B6764
vaultBbusdHandler	0x55850230cE77f670B8FBf47469F935cF41304e0a
vaultAuraRewards	0xdE23dd408747886a6E1F4337D80B9b0F7a4cBbF0
feeForwarder	0xE14360AA496A85FCfe4B75AFD2ec4d95CbA38Fe1