Aave SDK

The official SDK for Aave V4 👻.

Table of Contents

• Development Workflow
• Claude Code Integration
• Contributing
• License

Development Workflow

This section is for developers who want to contribute to the SDK.

Initial Setup

Clone the repository:

git clone https://github.com/aave/aave-sdk.git

Install the dependencies:

pnpm install

Pre-requisites:

• Node.js: >= v22. See installation guide.
• pnpm: v9.15.4. See installation guide.

Use nvm to manage your Node.js versions. Run the following command in the project root folder:

nvm use

to switch to the correct Node.js version.

Enable corepack to use the the correct version of pnpm.

Run the following command in the project root folder:

corepack install

to install the correct version once. After that corepack will automatically use the correct version of pnpm when entering the project folder.

Create a .env file copying the .env.example file:

cp .env.example .env

Update the .env file with the correct values.

Usage

Run the tests:

• pnpm test: Run unit and integration tests @aave/client and @aave/react packages.
• pnpm spec: Run the acceptance tests for the @aave/spec package.

Lint the code:

pnpm lint

Compile the code:

pnpm build

Clean the build:

pnpm clean

Create a new package:

pnpm new:package

IDE Setup

The project uses Biome to format and lint the code. You can install the Biome extension for your IDE: https://biomejs.dev/guides/editors/first-party-extensions/

Claude Code Integration

This project includes Claude Code configuration for AI-assisted development.

Skills

Skills are workflows that Claude Code can execute when invoked:

• /publish - Manually publishes SDK packages to npm. Handles version bumping, authentication, and git tags.
• /schema-update - Updates GraphQL schema from local or staging API server. Handles document updates, enum definitions, and input types.

Agents (WIP)

Warning

These agents are experimental and under active development.

Custom agents are specialized Claude configurations for specific tasks:

• reviewer - Reviews SDK code for quality, DX, and API design. Evaluates React hooks, TypeScript utilities, and GraphQL fragments.
• engineer - Implements SDK features with focus on DX and API ergonomics. Handles client actions, React hooks, and type-safe interfaces.

Contributing

We welcome contributions to the Aave SDK! If you're interested in contributing, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and commit them with clear messages.
4. Push your changes to your fork.
5. Open a pull request against the main branch of the original repository.
6. Ensure your code adheres to the project's coding standards and passes all tests.
7. Wait for code review and address any feedback provided by the maintainers.

If you have a pressing issue or feature request, please open an issue on GitHub. A lot of the abstraction is in the API so somethings could be out of scope in the SDK but we are happy to discuss it on the GitHub issues.

License

Aave SDK is MIT licensed.