npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@colligence/aave-address-book

v2.26.7

Published

This repository contains an up-to-date registry of all addresses of the Aave ecosystem's smart contracts, for its usage in Solidity codebases.

Downloads

11

Readme

Aave Address Book :book:

This repository contains an up-to-date registry of all addresses of the Aave ecosystem's smart contracts, for its usage in Solidity codebases.

The goal is for Solidity developers to have the most integrated environment possible when they want to develop on top of Aave, by just importing a package with all the necessary addresses to interact with.

You can find a searchable version of the address book on https://book.onaave.com/.

Usage with foundry

With Foundry installed and being in a Git repository:

forge install bgd-labs/aave-address-book

Import a pool specific collection of addresses & interfaces:

import {AaveV2Ethereum} from "aave-address-book/AaveV2Ethereum.sol";
import {AaveV3Avalanche} from "aave-address-book/AaveV3Avalanche.sol";

Import addresses and interfaces to interact with Governance:

import {AaveGovernanceV2} from "aave-address-book/AaveGovernanceV2.sol";
import {IGovernanceCore} from "aave-address-book/GovernanceV3.sol";

Import miscellaneous network addresses and interfaces relevant to the aave protocol:

import {Misc<Network>} from "aave-address-book/Aave<Network>.sol";

Production Recommendations

While there is a index import available in "aave-address-book/AaveAddressBook.sol", we only recommend using it in tests. Foundry currently does not eliminate unused code for verification. This results in rather gigantic verifications when using the index file import from aave-address-book/AaveAddressBook.sol. For production code we therefore recommend to use pool specific libraries (Aave[Version][Network][?SubPool]) exported from aave-address-book like AaveV2Ethereum for the V2 Ethereum pool.

Usage with node

Install

npm i @bgd-labs/aave-address-book

Usage

import * as pools from "@bgd-labs/aave-address-book"; // wildcard import
import { AaveV2Avalanche } from "@bgd-labs/aave-address-book"; // import specific pool

// all variables available on solidity version are available in javascript as well
console.log(AaveV2Avalanche.POOL_ADDRESSES_PROVIDER);
// "0xa97684ead0e402dC232d5A977953DF7ECBaB3CDb"

// in addition the chainId of the respecitve addresses is exported alongside
console.log(AaveV2Avalanche.CHAIN_ID);
// 43114

Running this repository

Generate files

The library is generated based on the scripts/generateAddresses.ts and scripts/generateABIs.ts scripts. You can regenerate the files by running yarn start.

Dependencies

forge update

Compilation

forge build

Testing

forge test

Adding a new Pool

To list a new pool in the address book, you simply need to add a new pool in the respective pools config and run yarn generate:addresses.

Adding new Addresses

a) Adding an address that can be obtained via onchain calls so it doesn't need to be hardcoded on the configs:

To achieve an addition here you need to add the address to the respective v2 type and/or v3 type and adjust the generator scripts accordingly. New types should be added to the AaveV2 and AaveV3 files.

b) Adding an address that cannot be obtained via onchain calls so it needs to be manually maintained:

To achieve an addition here, you need to alter the additionalAddresses section on the pool type and add your address to the respective pools. Additional addresses will currently be exported as type address. There's currently no possibility to define a custom type.

In any case you need to run yarn generate:addresses afterwards and commit the altered artifacts.