Sandbox of Aave Markets that replicates a forked production environment. The environment is envisioned for testing liquidations or other integrations that requires a production state using Hardhat Node and Alchemy.
- Git
- Node.js version >= 16
- You can install and manage any Node.js version easily with nvm
Clone the repository:
git clone https://github.com/aave/aave-sandbox.git
Install dependencies:
npm i
Compile Contract:
npm run compile
Create a .env file
touch .env
Obtain an Alchemy API key to be able to fork chains. The free tier of Alchemy allows archival node.
Once you have the Alchemy key, open .env with your favorite editor and fill the environment variable named ALCHEMY_KEY, as follows:
# Content of .env file
ALCHEMY_KEY=your-alchemy-key
If you want to integrate any of the deployed Aave markets, you can spin a sandbox node in the following way.
In a separate window, run the sandbox Hardhat fork node that will be reachable via JSON RPC at http://127.0.0.1:8545/. You can spin the sandbox node with one of the following commands:
node:fork:arc
node:fork:main-v2
node:fork:polygon-v3
node:fork:avalanche-v3
node:fork:arbitrum-v3
node:fork:optimism-v3
node:fork:fantom-v3
node:fork:harmony-v3,
node:fork:main-v3
Now you can connect to the Hardhat Node via JSON RPC at http://127.0.0.1:8545/ in your project and use official deployed addresses to interact with the market.
Once the node is running, the following tasks will be available, and will point to the local sandbox node.
"feed-market": "hardhat --network localhost feed-market --market $0",
"feed-accounts": "hardhat --network localhost feed-accounts --market $0",
"whitelist-accounts:arc": "hardhat --network localhost whitelist-accounts --market $@",
"print-accounts": "hardhat --network localhost print-accounts -- $@",
The feed-market command will add simulated users and liquidity to a forked market.
Usage:
npm run feed-market:main-v3
or replace main-v3 with one of: arc, main-v2, polygon-v3, arbitrum-v3, avalanche-v3, optimism-v3, harmony-v3, fantom-v3.
You can mint official ERC20 tokens to any address using the feed-account task. The task will override the balance of the address via hardhat_setStorage.
You can use the following command as a faucet to get all ERC20 tokens being used inside a market:
npm run feed-accounts:polygon-v3 -- --accounts 0x976EA74026E726554dB657fA54763abd0C3a0aa9,<other-user-address>
Note: the extra -- is important to pass arguments to Hardhat
View user positions and health factors from accounts passed to --accounts parameter with the following command:
npm run print-accounts:polygon-v3 -- --accounts 0x23618e81E3f5cdF7f54C3d65f7FBc0aBf5B21E8f,0x14dC79964da2C08b23698B3D3cc7Ca32193d9955
Note: the extra -- is important to pass arguments to Hardhat
Output:
User Info:
- Address: 0x976EA74026E726554dB657fA54763abd0C3a0aa9
- Health Factor: 0.918421511765627487
- Balances
┌─────────┬───────────────────┬───────────────────┬──────────────────────────┬────────┐
│ (index) │ enabledCollateral │ collateralBalance │ debtBalance │ symbol │
├─────────┼───────────────────┼───────────────────┼──────────────────────────┼────────┤
│ 0 │ true │ '50000.0' │ '0.0' │ 'USDC' │
│ 1 │ false │ '0.0' │ '43.0' │ 'WBTC' │
│ 2 │ false │ '0.0' │ '543.999999948668340512' │ 'WETH' │
│ 3 │ true │ '50000.0' │ '0.0' │ 'AAVE' │
└─────────┴───────────────────┴───────────────────┴──────────────────────────┴────────┘
[...]
For whitelisting your accounts or smart contracts like liquidation bots into Aave Arc Sandbox, you can use the following command passing in addresses to --accounts parameter:
npm run whitelist-accounts:arc --accounts <your-account-address>,<your-smart-contract-address>
Note: the extra -- is important to pass arguments to Hardhat
By default Hardhat node mines blocks every time you perform a transaction, but for some scenarios you may need the node to mine blocks by interval.
You can enable Hardhat to mine blocks every 5 seconds with the following command:
npm run set-interval-mining
To disable mining empty blocks, you can run:
npm run set-interval-mining:off