add: aave v3 action provider

typescript/agentkit/package.json

@@ -44,7 +44,11 @@
  "reflect-metadata": "^0.2.2",
  "twitter-api-v2": "^1.18.2",
  "viem": "^2.22.16",
- "zod": "^3.23.8"
+ "zod": "^3.23.8",
+ "@aave/contract-helpers": "^1.31.1",
+ "@aave/math-utils": "^1.31.1",
+ "ethers-v5": "npm:ethers@5.7.2",
+ "@bgd-labs/aave-address-book": "^4.9.0"
  },
  "devDependencies": {
  "@types/jest": "^29.5.14",

typescript/agentkit/src/action-providers/aave/README.md

@@ -0,0 +1,13 @@
+# Aave
+
+## Installation
+- Note this action requires packages from official `aave-utilities`, which has peer dependency on ethers v5 (v6 not supported)
+- Thus testing or running this requires installing the dependencies 
+- npm i @aave/contract-helpers @aave/math-utils @bgd-labs/aave-address-book ethers@5 
+
+
+## Featureset
+Currently these functions are tested
+- deposit
+- withdrawl
+

typescript/agentkit/src/action-providers/aave/aaveActionProvider.int.test.ts

@@ -0,0 +1,29 @@
+// import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+// import { AaveActionProvider } from "./aaveActionProvider";
+// import { providers } from "ethers-v5";
+
+// describe('withdraw', () => {
+// const actionProvider = new AaveActionProvider({
+// alchemyApiKey: process.env.ALCHEMY_API_KEY,
+// });
+// const CDP_WALLET_CONFIG = {
+// apiKeyName: process.env.CDP_API_KEY_NAME,
+// apiKeyPrivateKey: process.env.CDP_API_KEY_PRIVATE_KEY?.replace(/\\n/g, "\n"),
+// cdpWalletData: process.env.CDP_WALLET_DATA || '{}'
+// };
+
+// it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+
+// const evmWalletProvider = await CdpWalletProvider.configureWithWallet({
+// ...CDP_WALLET_CONFIG,
+// networkId: "base-sepolia", // other options: "base-mainnet", "ethereum-mainnet", "arbitrum-mainnet", "polygon-mainnet".
+// });
+
+// const response = await actionProvider.supply(evmWalletProvider, {
+// amount: '1',
+// poolAddress: market.POOL,
+// asset
+// });
+// })
+
+// });

typescript/agentkit/src/action-providers/aave/aaveActionProvider.test.ts

@@ -0,0 +1,184 @@
+import { AaveActionProvider, aaveActionProvider } from "./aaveActionProvider";
+import { ethers, providers, Wallet } from "ethers-v5";
+import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+import { ActionBundle, FaucetService, PoolBundle } from "@aave/contract-helpers";
+import * as markets from "@bgd-labs/aave-address-book";
+import { Address, Hex } from "viem";
+import { AAVEV3_BASE_SEPOLIA_MARKET_CONFIG } from "./markets";
+import { SupplySchema, WithdrawSchema } from "./schemas";
+import { approve } from "../../utils";
+import { createSupplyTxData } from "./aaveActionUtil";
+
+import { baseSepolia, sepolia } from "viem/chains";
+
+jest.mock("../../utils");
+const mockApprove = approve as jest.MockedFunction<typeof approve>;
+
+const cdpWalletData = process.env.CDP_WALLET_DATA || "{}";
+
+describe("SupplySchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ assetAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = SupplySchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = SupplySchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("WithdrawSchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ underlyingAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = WithdrawSchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = WithdrawSchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("Aave Action Provider", () => {
+ const alchemyConfig = {
+ apiKey: process.env.ALCHEMY_API_KEY,
+ };
+
+ const actionProvider = new AaveActionProvider();
+ let mockWallet: jest.Mocked<EvmWalletProvider>;
+ let mockProvider: jest.Mocked<providers.Provider>;
+
+ const MOCK_USER_ADDRESS = "0x9876543210987654321098765432109876543210";
+ const MOCK_TX_HASH = "0xabcdef1234567890";
+ const MOCK_RECEIPT = { status: 1, blockNumber: 1234567 };
+
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+
+ beforeEach(() => {
+ mockWallet = {
+ getAddress: jest.fn().mockReturnValue(MOCK_USER_ADDRESS),
+ getNetwork: jest
+ .fn()
+ .mockReturnValue({ protocolFamily: "evm", networkId: baseSepolia.network.toString() }),
+ sendTransaction: jest.fn().mockResolvedValue(MOCK_TX_HASH as `0x${string}`),
+ waitForTransactionReceipt: jest.fn().mockResolvedValue(MOCK_RECEIPT),
+ } as unknown as jest.Mocked<EvmWalletProvider>;
+
+ mockApprove.mockResolvedValue("Approval successful");
+ });
+
+ describe("withdraw", () => {
+ it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ assetATokenAddress: asset.A_TOKEN,
+ };
+
+ // const response = await actionProvider.withdraw(mockWallet, args);
+ });
+ });
+
+ describe("supply", () => {
+ it("should successfully supply USDC on Aaave v3 L2 base-sepolia", async () => {
+ const asset = markets.AaveV3BaseSepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ // fixture from createSupplyTxData with actual provider
+ // as we try to avoid mocking the L2Encoder encode logic and provider
+ const encodedTxData = "0x0000000000000000000000000000000000000000000000000000000000010000";
+
+ const txData =
+ "0x617ba037000000000000000000000000036cbd53842c5426634e7929541ec2318f3dcf7e000000000000000000000000000000000000000000000000000000000000000100000000000000000000000098765432109876543210987654321098765432100000000000000000000000000000000000000000000000000000000000000000";
+
+ console.log("encodedTxData", encodedTxData);
+
+ expect(mockWallet.sendTransaction).toHaveBeenCalledWith({
+ to: market.POOL as `0x${string}`,
+ data: txData,
+ });
+
+ expect(mockWallet.waitForTransactionReceipt).toHaveBeenCalledWith(MOCK_TX_HASH);
+ expect(response).toContain(
+ `Supplied 1 units of 0x036CbD53842c5426634e7929541eC2318f3dCF7e to Aave v3 Pool 0x07eA79F68B2B3df564D0A34F8e19D9B1e339814b with transaction hash: ${MOCK_TX_HASH} status:1`,
+ );
+ expect(response).toContain(MOCK_TX_HASH);
+ });
+
+ it("should handle transaction errors when supplying", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "0",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ mockWallet.sendTransaction.mockRejectedValue(new Error("Failed to supply"));
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ expect(response).toContain("Error supplying to Aave v3: Error: Supply amount must be > 0");
+ });
+ });
+
+ describe("supportsNetwork", () => {
+ it("should return true for Base Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "base-sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ it("should return true for Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ // For now
+ it("should return false for other EVM networks except sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "ethereum",
+ });
+ expect(result).toBe(false);
+ });
+
+ it("should return false for non-EVM networks", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "bitcoin",
+ networkId: "base-mainnet",
+ });
+ expect(result).toBe(false);
+ });
+ });
+});

typescript/agentkit/package.json

@@ -44,7 +44,11 @@
  "reflect-metadata": "^0.2.2",
  "twitter-api-v2": "^1.18.2",
  "viem": "^2.22.16",
- "zod": "^3.23.8"
+ "zod": "^3.23.8",
+ "@aave/contract-helpers": "^1.31.1",
+ "@aave/math-utils": "^1.31.1",
+ "ethers-v5": "npm:ethers@5.7.2",
+ "@bgd-labs/aave-address-book": "^4.9.0"
  },
  "devDependencies": {
  "@types/jest": "^29.5.14",

typescript/agentkit/src/action-providers/aave/README.md

@@ -0,0 +1,13 @@
+# Aave
+
+## Installation
+- Note this action requires packages from official `aave-utilities`, which has peer dependency on ethers v5 (v6 not supported)
+- Thus testing or running this requires installing the dependencies 
+- npm i @aave/contract-helpers @aave/math-utils @bgd-labs/aave-address-book ethers@5 
+
+
+## Featureset
+Currently these functions are tested
+- deposit
+- withdrawl
+

typescript/agentkit/src/action-providers/aave/aaveActionProvider.int.test.ts

@@ -0,0 +1,29 @@
+// import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+// import { AaveActionProvider } from "./aaveActionProvider";
+// import { providers } from "ethers-v5";
+
+// describe('withdraw', () => {
+// const actionProvider = new AaveActionProvider({
+// alchemyApiKey: process.env.ALCHEMY_API_KEY,
+// });
+// const CDP_WALLET_CONFIG = {
+// apiKeyName: process.env.CDP_API_KEY_NAME,
+// apiKeyPrivateKey: process.env.CDP_API_KEY_PRIVATE_KEY?.replace(/\\n/g, "\n"),
+// cdpWalletData: process.env.CDP_WALLET_DATA || '{}'
+// };
+
+// it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+
+// const evmWalletProvider = await CdpWalletProvider.configureWithWallet({
+// ...CDP_WALLET_CONFIG,
+// networkId: "base-sepolia", // other options: "base-mainnet", "ethereum-mainnet", "arbitrum-mainnet", "polygon-mainnet".
+// });
+
+// const response = await actionProvider.supply(evmWalletProvider, {
+// amount: '1',
+// poolAddress: market.POOL,
+// asset
+// });
+// })
+
+// });

typescript/agentkit/src/action-providers/aave/aaveActionProvider.test.ts

@@ -0,0 +1,184 @@
+import { AaveActionProvider, aaveActionProvider } from "./aaveActionProvider";
+import { ethers, providers, Wallet } from "ethers-v5";
+import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+import { ActionBundle, FaucetService, PoolBundle } from "@aave/contract-helpers";
+import * as markets from "@bgd-labs/aave-address-book";
+import { Address, Hex } from "viem";
+import { AAVEV3_BASE_SEPOLIA_MARKET_CONFIG } from "./markets";
+import { SupplySchema, WithdrawSchema } from "./schemas";
+import { approve } from "../../utils";
+import { createSupplyTxData } from "./aaveActionUtil";
+
+import { baseSepolia, sepolia } from "viem/chains";
+
+jest.mock("../../utils");
+const mockApprove = approve as jest.MockedFunction<typeof approve>;
+
+const cdpWalletData = process.env.CDP_WALLET_DATA || "{}";
+
+describe("SupplySchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ assetAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = SupplySchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = SupplySchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("WithdrawSchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ underlyingAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = WithdrawSchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = WithdrawSchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("Aave Action Provider", () => {
+ const alchemyConfig = {
+ apiKey: process.env.ALCHEMY_API_KEY,
+ };
+
+ const actionProvider = new AaveActionProvider();
+ let mockWallet: jest.Mocked<EvmWalletProvider>;
+ let mockProvider: jest.Mocked<providers.Provider>;
+
+ const MOCK_USER_ADDRESS = "0x9876543210987654321098765432109876543210";
+ const MOCK_TX_HASH = "0xabcdef1234567890";
+ const MOCK_RECEIPT = { status: 1, blockNumber: 1234567 };
+
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+
+ beforeEach(() => {
+ mockWallet = {
+ getAddress: jest.fn().mockReturnValue(MOCK_USER_ADDRESS),
+ getNetwork: jest
+ .fn()
+ .mockReturnValue({ protocolFamily: "evm", networkId: baseSepolia.network.toString() }),
+ sendTransaction: jest.fn().mockResolvedValue(MOCK_TX_HASH as `0x${string}`),
+ waitForTransactionReceipt: jest.fn().mockResolvedValue(MOCK_RECEIPT),
+ } as unknown as jest.Mocked<EvmWalletProvider>;
+
+ mockApprove.mockResolvedValue("Approval successful");
+ });
+
+ describe("withdraw", () => {
+ it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ assetATokenAddress: asset.A_TOKEN,
+ };
+
+ // const response = await actionProvider.withdraw(mockWallet, args);
+ });
+ });
+
+ describe("supply", () => {
+ it("should successfully supply USDC on Aaave v3 L2 base-sepolia", async () => {
+ const asset = markets.AaveV3BaseSepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ // fixture from createSupplyTxData with actual provider
+ // as we try to avoid mocking the L2Encoder encode logic and provider
+ const encodedTxData = "0x0000000000000000000000000000000000000000000000000000000000010000";
+
+ const txData =
+ "0x617ba037000000000000000000000000036cbd53842c5426634e7929541ec2318f3dcf7e000000000000000000000000000000000000000000000000000000000000000100000000000000000000000098765432109876543210987654321098765432100000000000000000000000000000000000000000000000000000000000000000";
+
+ console.log("encodedTxData", encodedTxData);
+
+ expect(mockWallet.sendTransaction).toHaveBeenCalledWith({
+ to: market.POOL as `0x${string}`,
+ data: txData,
+ });
+
+ expect(mockWallet.waitForTransactionReceipt).toHaveBeenCalledWith(MOCK_TX_HASH);
+ expect(response).toContain(
+ `Supplied 1 units of 0x036CbD53842c5426634e7929541eC2318f3dCF7e to Aave v3 Pool 0x07eA79F68B2B3df564D0A34F8e19D9B1e339814b with transaction hash: ${MOCK_TX_HASH} status:1`,
+ );
+ expect(response).toContain(MOCK_TX_HASH);
+ });
+
+ it("should handle transaction errors when supplying", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "0",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ mockWallet.sendTransaction.mockRejectedValue(new Error("Failed to supply"));
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ expect(response).toContain("Error supplying to Aave v3: Error: Supply amount must be > 0");
+ });
+ });
+
+ describe("supportsNetwork", () => {
+ it("should return true for Base Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "base-sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ it("should return true for Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ // For now
+ it("should return false for other EVM networks except sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "ethereum",
+ });
+ expect(result).toBe(false);
+ });
+
+ it("should return false for non-EVM networks", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "bitcoin",
+ networkId: "base-mainnet",
+ });
+ expect(result).toBe(false);
+ });
+ });
+});

typescript/agentkit/package.json

@@ -44,7 +44,11 @@
  "reflect-metadata": "^0.2.2",
  "twitter-api-v2": "^1.18.2",
  "viem": "^2.22.16",
- "zod": "^3.23.8"
+ "zod": "^3.23.8",
+ "@aave/contract-helpers": "^1.31.1",
+ "@aave/math-utils": "^1.31.1",
+ "ethers-v5": "npm:ethers@5.7.2",
+ "@bgd-labs/aave-address-book": "^4.9.0"
  },
  "devDependencies": {
  "@types/jest": "^29.5.14",

typescript/agentkit/src/action-providers/aave/README.md

@@ -0,0 +1,13 @@
+# Aave
+
+## Installation
+- Note this action requires packages from official `aave-utilities`, which has peer dependency on ethers v5 (v6 not supported)
+- Thus testing or running this requires installing the dependencies 
+- npm i @aave/contract-helpers @aave/math-utils @bgd-labs/aave-address-book ethers@5 
+
+
+## Featureset
+Currently these functions are tested
+- deposit
+- withdrawl
+

typescript/agentkit/src/action-providers/aave/aaveActionProvider.int.test.ts

@@ -0,0 +1,29 @@
+// import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+// import { AaveActionProvider } from "./aaveActionProvider";
+// import { providers } from "ethers-v5";
+
+// describe('withdraw', () => {
+// const actionProvider = new AaveActionProvider({
+// alchemyApiKey: process.env.ALCHEMY_API_KEY,
+// });
+// const CDP_WALLET_CONFIG = {
+// apiKeyName: process.env.CDP_API_KEY_NAME,
+// apiKeyPrivateKey: process.env.CDP_API_KEY_PRIVATE_KEY?.replace(/\\n/g, "\n"),
+// cdpWalletData: process.env.CDP_WALLET_DATA || '{}'
+// };
+
+// it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+
+// const evmWalletProvider = await CdpWalletProvider.configureWithWallet({
+// ...CDP_WALLET_CONFIG,
+// networkId: "base-sepolia", // other options: "base-mainnet", "ethereum-mainnet", "arbitrum-mainnet", "polygon-mainnet".
+// });
+
+// const response = await actionProvider.supply(evmWalletProvider, {
+// amount: '1',
+// poolAddress: market.POOL,
+// asset
+// });
+// })
+
+// });

typescript/agentkit/src/action-providers/aave/aaveActionProvider.test.ts

@@ -0,0 +1,184 @@
+import { AaveActionProvider, aaveActionProvider } from "./aaveActionProvider";
+import { ethers, providers, Wallet } from "ethers-v5";
+import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+import { ActionBundle, FaucetService, PoolBundle } from "@aave/contract-helpers";
+import * as markets from "@bgd-labs/aave-address-book";
+import { Address, Hex } from "viem";
+import { AAVEV3_BASE_SEPOLIA_MARKET_CONFIG } from "./markets";
+import { SupplySchema, WithdrawSchema } from "./schemas";
+import { approve } from "../../utils";
+import { createSupplyTxData } from "./aaveActionUtil";
+
+import { baseSepolia, sepolia } from "viem/chains";
+
+jest.mock("../../utils");
+const mockApprove = approve as jest.MockedFunction<typeof approve>;
+
+const cdpWalletData = process.env.CDP_WALLET_DATA || "{}";
+
+describe("SupplySchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ assetAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = SupplySchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = SupplySchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("WithdrawSchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ underlyingAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = WithdrawSchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = WithdrawSchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("Aave Action Provider", () => {
+ const alchemyConfig = {
+ apiKey: process.env.ALCHEMY_API_KEY,
+ };
+
+ const actionProvider = new AaveActionProvider();
+ let mockWallet: jest.Mocked<EvmWalletProvider>;
+ let mockProvider: jest.Mocked<providers.Provider>;
+
+ const MOCK_USER_ADDRESS = "0x9876543210987654321098765432109876543210";
+ const MOCK_TX_HASH = "0xabcdef1234567890";
+ const MOCK_RECEIPT = { status: 1, blockNumber: 1234567 };
+
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+
+ beforeEach(() => {
+ mockWallet = {
+ getAddress: jest.fn().mockReturnValue(MOCK_USER_ADDRESS),
+ getNetwork: jest
+ .fn()
+ .mockReturnValue({ protocolFamily: "evm", networkId: baseSepolia.network.toString() }),
+ sendTransaction: jest.fn().mockResolvedValue(MOCK_TX_HASH as `0x${string}`),
+ waitForTransactionReceipt: jest.fn().mockResolvedValue(MOCK_RECEIPT),
+ } as unknown as jest.Mocked<EvmWalletProvider>;
+
+ mockApprove.mockResolvedValue("Approval successful");
+ });
+
+ describe("withdraw", () => {
+ it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ assetATokenAddress: asset.A_TOKEN,
+ };
+
+ // const response = await actionProvider.withdraw(mockWallet, args);
+ });
+ });
+
+ describe("supply", () => {
+ it("should successfully supply USDC on Aaave v3 L2 base-sepolia", async () => {
+ const asset = markets.AaveV3BaseSepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ // fixture from createSupplyTxData with actual provider
+ // as we try to avoid mocking the L2Encoder encode logic and provider
+ const encodedTxData = "0x0000000000000000000000000000000000000000000000000000000000010000";
+
+ const txData =
+ "0x617ba037000000000000000000000000036cbd53842c5426634e7929541ec2318f3dcf7e000000000000000000000000000000000000000000000000000000000000000100000000000000000000000098765432109876543210987654321098765432100000000000000000000000000000000000000000000000000000000000000000";
+
+ console.log("encodedTxData", encodedTxData);
+
+ expect(mockWallet.sendTransaction).toHaveBeenCalledWith({
+ to: market.POOL as `0x${string}`,
+ data: txData,
+ });
+
+ expect(mockWallet.waitForTransactionReceipt).toHaveBeenCalledWith(MOCK_TX_HASH);
+ expect(response).toContain(
+ `Supplied 1 units of 0x036CbD53842c5426634e7929541eC2318f3dCF7e to Aave v3 Pool 0x07eA79F68B2B3df564D0A34F8e19D9B1e339814b with transaction hash: ${MOCK_TX_HASH} status:1`,
+ );
+ expect(response).toContain(MOCK_TX_HASH);
+ });
+
+ it("should handle transaction errors when supplying", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "0",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ mockWallet.sendTransaction.mockRejectedValue(new Error("Failed to supply"));
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ expect(response).toContain("Error supplying to Aave v3: Error: Supply amount must be > 0");
+ });
+ });
+
+ describe("supportsNetwork", () => {
+ it("should return true for Base Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "base-sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ it("should return true for Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ // For now
+ it("should return false for other EVM networks except sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "ethereum",
+ });
+ expect(result).toBe(false);
+ });
+
+ it("should return false for non-EVM networks", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "bitcoin",
+ networkId: "base-mainnet",
+ });
+ expect(result).toBe(false);
+ });
+ });
+});

typescript/agentkit/package.json

@@ -44,7 +44,11 @@
  "reflect-metadata": "^0.2.2",
  "twitter-api-v2": "^1.18.2",
  "viem": "^2.22.16",
- "zod": "^3.23.8"
+ "zod": "^3.23.8",
+ "@aave/contract-helpers": "^1.31.1",
+ "@aave/math-utils": "^1.31.1",
+ "ethers-v5": "npm:ethers@5.7.2",
+ "@bgd-labs/aave-address-book": "^4.9.0"
  },
  "devDependencies": {
  "@types/jest": "^29.5.14",

typescript/agentkit/src/action-providers/aave/README.md

@@ -0,0 +1,13 @@
+# Aave
+
+## Installation
+- Note this action requires packages from official `aave-utilities`, which has peer dependency on ethers v5 (v6 not supported)
+- Thus testing or running this requires installing the dependencies 
+- npm i @aave/contract-helpers @aave/math-utils @bgd-labs/aave-address-book ethers@5 
+
+
+## Featureset
+Currently these functions are tested
+- deposit
+- withdrawl
+

typescript/agentkit/src/action-providers/aave/aaveActionProvider.int.test.ts

@@ -0,0 +1,29 @@
+// import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+// import { AaveActionProvider } from "./aaveActionProvider";
+// import { providers } from "ethers-v5";
+
+// describe('withdraw', () => {
+// const actionProvider = new AaveActionProvider({
+// alchemyApiKey: process.env.ALCHEMY_API_KEY,
+// });
+// const CDP_WALLET_CONFIG = {
+// apiKeyName: process.env.CDP_API_KEY_NAME,
+// apiKeyPrivateKey: process.env.CDP_API_KEY_PRIVATE_KEY?.replace(/\\n/g, "\n"),
+// cdpWalletData: process.env.CDP_WALLET_DATA || '{}'
+// };
+
+// it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+
+// const evmWalletProvider = await CdpWalletProvider.configureWithWallet({
+// ...CDP_WALLET_CONFIG,
+// networkId: "base-sepolia", // other options: "base-mainnet", "ethereum-mainnet", "arbitrum-mainnet", "polygon-mainnet".
+// });
+
+// const response = await actionProvider.supply(evmWalletProvider, {
+// amount: '1',
+// poolAddress: market.POOL,
+// asset
+// });
+// })
+
+// });

typescript/agentkit/src/action-providers/aave/aaveActionProvider.test.ts

@@ -0,0 +1,184 @@
+import { AaveActionProvider, aaveActionProvider } from "./aaveActionProvider";
+import { ethers, providers, Wallet } from "ethers-v5";
+import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+import { ActionBundle, FaucetService, PoolBundle } from "@aave/contract-helpers";
+import * as markets from "@bgd-labs/aave-address-book";
+import { Address, Hex } from "viem";
+import { AAVEV3_BASE_SEPOLIA_MARKET_CONFIG } from "./markets";
+import { SupplySchema, WithdrawSchema } from "./schemas";
+import { approve } from "../../utils";
+import { createSupplyTxData } from "./aaveActionUtil";
+
+import { baseSepolia, sepolia } from "viem/chains";
+
+jest.mock("../../utils");
+const mockApprove = approve as jest.MockedFunction<typeof approve>;
+
+const cdpWalletData = process.env.CDP_WALLET_DATA || "{}";
+
+describe("SupplySchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ assetAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = SupplySchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = SupplySchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("WithdrawSchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ underlyingAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = WithdrawSchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = WithdrawSchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("Aave Action Provider", () => {
+ const alchemyConfig = {
+ apiKey: process.env.ALCHEMY_API_KEY,
+ };
+
+ const actionProvider = new AaveActionProvider();
+ let mockWallet: jest.Mocked<EvmWalletProvider>;
+ let mockProvider: jest.Mocked<providers.Provider>;
+
+ const MOCK_USER_ADDRESS = "0x9876543210987654321098765432109876543210";
+ const MOCK_TX_HASH = "0xabcdef1234567890";
+ const MOCK_RECEIPT = { status: 1, blockNumber: 1234567 };
+
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+
+ beforeEach(() => {
+ mockWallet = {
+ getAddress: jest.fn().mockReturnValue(MOCK_USER_ADDRESS),
+ getNetwork: jest
+ .fn()
+ .mockReturnValue({ protocolFamily: "evm", networkId: baseSepolia.network.toString() }),
+ sendTransaction: jest.fn().mockResolvedValue(MOCK_TX_HASH as `0x${string}`),
+ waitForTransactionReceipt: jest.fn().mockResolvedValue(MOCK_RECEIPT),
+ } as unknown as jest.Mocked<EvmWalletProvider>;
+
+ mockApprove.mockResolvedValue("Approval successful");
+ });
+
+ describe("withdraw", () => {
+ it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ assetATokenAddress: asset.A_TOKEN,
+ };
+
+ // const response = await actionProvider.withdraw(mockWallet, args);
+ });
+ });
+
+ describe("supply", () => {
+ it("should successfully supply USDC on Aaave v3 L2 base-sepolia", async () => {
+ const asset = markets.AaveV3BaseSepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ // fixture from createSupplyTxData with actual provider
+ // as we try to avoid mocking the L2Encoder encode logic and provider
+ const encodedTxData = "0x0000000000000000000000000000000000000000000000000000000000010000";
+
+ const txData =
+ "0x617ba037000000000000000000000000036cbd53842c5426634e7929541ec2318f3dcf7e000000000000000000000000000000000000000000000000000000000000000100000000000000000000000098765432109876543210987654321098765432100000000000000000000000000000000000000000000000000000000000000000";
+
+ console.log("encodedTxData", encodedTxData);
+
+ expect(mockWallet.sendTransaction).toHaveBeenCalledWith({
+ to: market.POOL as `0x${string}`,
+ data: txData,
+ });
+
+ expect(mockWallet.waitForTransactionReceipt).toHaveBeenCalledWith(MOCK_TX_HASH);
+ expect(response).toContain(
+ `Supplied 1 units of 0x036CbD53842c5426634e7929541eC2318f3dCF7e to Aave v3 Pool 0x07eA79F68B2B3df564D0A34F8e19D9B1e339814b with transaction hash: ${MOCK_TX_HASH} status:1`,
+ );
+ expect(response).toContain(MOCK_TX_HASH);
+ });
+
+ it("should handle transaction errors when supplying", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "0",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ mockWallet.sendTransaction.mockRejectedValue(new Error("Failed to supply"));
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ expect(response).toContain("Error supplying to Aave v3: Error: Supply amount must be > 0");
+ });
+ });
+
+ describe("supportsNetwork", () => {
+ it("should return true for Base Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "base-sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ it("should return true for Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ // For now
+ it("should return false for other EVM networks except sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "ethereum",
+ });
+ expect(result).toBe(false);
+ });
+
+ it("should return false for non-EVM networks", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "bitcoin",
+ networkId: "base-mainnet",
+ });
+ expect(result).toBe(false);
+ });
+ });
+});

typescript/agentkit/package.json

@@ -44,7 +44,11 @@
  "reflect-metadata": "^0.2.2",
  "twitter-api-v2": "^1.18.2",
  "viem": "^2.22.16",
- "zod": "^3.23.8"
+ "zod": "^3.23.8",
+ "@aave/contract-helpers": "^1.31.1",
+ "@aave/math-utils": "^1.31.1",
+ "ethers-v5": "npm:ethers@5.7.2",
+ "@bgd-labs/aave-address-book": "^4.9.0"
  },
  "devDependencies": {
  "@types/jest": "^29.5.14",

typescript/agentkit/src/action-providers/aave/README.md

@@ -0,0 +1,13 @@
+# Aave
+
+## Installation
+- Note this action requires packages from official `aave-utilities`, which has peer dependency on ethers v5 (v6 not supported)
+- Thus testing or running this requires installing the dependencies 
+- npm i @aave/contract-helpers @aave/math-utils @bgd-labs/aave-address-book ethers@5 
+
+
+## Featureset
+Currently these functions are tested
+- deposit
+- withdrawl
+

typescript/agentkit/src/action-providers/aave/aaveActionProvider.int.test.ts

@@ -0,0 +1,29 @@
+// import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+// import { AaveActionProvider } from "./aaveActionProvider";
+// import { providers } from "ethers-v5";
+
+// describe('withdraw', () => {
+// const actionProvider = new AaveActionProvider({
+// alchemyApiKey: process.env.ALCHEMY_API_KEY,
+// });
+// const CDP_WALLET_CONFIG = {
+// apiKeyName: process.env.CDP_API_KEY_NAME,
+// apiKeyPrivateKey: process.env.CDP_API_KEY_PRIVATE_KEY?.replace(/\\n/g, "\n"),
+// cdpWalletData: process.env.CDP_WALLET_DATA || '{}'
+// };
+
+// it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+
+// const evmWalletProvider = await CdpWalletProvider.configureWithWallet({
+// ...CDP_WALLET_CONFIG,
+// networkId: "base-sepolia", // other options: "base-mainnet", "ethereum-mainnet", "arbitrum-mainnet", "polygon-mainnet".
+// });
+
+// const response = await actionProvider.supply(evmWalletProvider, {
+// amount: '1',
+// poolAddress: market.POOL,
+// asset
+// });
+// })
+
+// });

typescript/agentkit/src/action-providers/aave/aaveActionProvider.test.ts

@@ -0,0 +1,184 @@
+import { AaveActionProvider, aaveActionProvider } from "./aaveActionProvider";
+import { ethers, providers, Wallet } from "ethers-v5";
+import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+import { ActionBundle, FaucetService, PoolBundle } from "@aave/contract-helpers";
+import * as markets from "@bgd-labs/aave-address-book";
+import { Address, Hex } from "viem";
+import { AAVEV3_BASE_SEPOLIA_MARKET_CONFIG } from "./markets";
+import { SupplySchema, WithdrawSchema } from "./schemas";
+import { approve } from "../../utils";
+import { createSupplyTxData } from "./aaveActionUtil";
+
+import { baseSepolia, sepolia } from "viem/chains";
+
+jest.mock("../../utils");
+const mockApprove = approve as jest.MockedFunction<typeof approve>;
+
+const cdpWalletData = process.env.CDP_WALLET_DATA || "{}";
+
+describe("SupplySchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ assetAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = SupplySchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = SupplySchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("WithdrawSchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ underlyingAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = WithdrawSchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = WithdrawSchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("Aave Action Provider", () => {
+ const alchemyConfig = {
+ apiKey: process.env.ALCHEMY_API_KEY,
+ };
+
+ const actionProvider = new AaveActionProvider();
+ let mockWallet: jest.Mocked<EvmWalletProvider>;
+ let mockProvider: jest.Mocked<providers.Provider>;
+
+ const MOCK_USER_ADDRESS = "0x9876543210987654321098765432109876543210";
+ const MOCK_TX_HASH = "0xabcdef1234567890";
+ const MOCK_RECEIPT = { status: 1, blockNumber: 1234567 };
+
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+
+ beforeEach(() => {
+ mockWallet = {
+ getAddress: jest.fn().mockReturnValue(MOCK_USER_ADDRESS),
+ getNetwork: jest
+ .fn()
+ .mockReturnValue({ protocolFamily: "evm", networkId: baseSepolia.network.toString() }),
+ sendTransaction: jest.fn().mockResolvedValue(MOCK_TX_HASH as `0x${string}`),
+ waitForTransactionReceipt: jest.fn().mockResolvedValue(MOCK_RECEIPT),
+ } as unknown as jest.Mocked<EvmWalletProvider>;
+
+ mockApprove.mockResolvedValue("Approval successful");
+ });
+
+ describe("withdraw", () => {
+ it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ assetATokenAddress: asset.A_TOKEN,
+ };
+
+ // const response = await actionProvider.withdraw(mockWallet, args);
+ });
+ });
+
+ describe("supply", () => {
+ it("should successfully supply USDC on Aaave v3 L2 base-sepolia", async () => {
+ const asset = markets.AaveV3BaseSepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ // fixture from createSupplyTxData with actual provider
+ // as we try to avoid mocking the L2Encoder encode logic and provider
+ const encodedTxData = "0x0000000000000000000000000000000000000000000000000000000000010000";
+
+ const txData =
+ "0x617ba037000000000000000000000000036cbd53842c5426634e7929541ec2318f3dcf7e000000000000000000000000000000000000000000000000000000000000000100000000000000000000000098765432109876543210987654321098765432100000000000000000000000000000000000000000000000000000000000000000";
+
+ console.log("encodedTxData", encodedTxData);
+
+ expect(mockWallet.sendTransaction).toHaveBeenCalledWith({
+ to: market.POOL as `0x${string}`,
+ data: txData,
+ });
+
+ expect(mockWallet.waitForTransactionReceipt).toHaveBeenCalledWith(MOCK_TX_HASH);
+ expect(response).toContain(
+ `Supplied 1 units of 0x036CbD53842c5426634e7929541eC2318f3dCF7e to Aave v3 Pool 0x07eA79F68B2B3df564D0A34F8e19D9B1e339814b with transaction hash: ${MOCK_TX_HASH} status:1`,
+ );
+ expect(response).toContain(MOCK_TX_HASH);
+ });
+
+ it("should handle transaction errors when supplying", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "0",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ mockWallet.sendTransaction.mockRejectedValue(new Error("Failed to supply"));
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ expect(response).toContain("Error supplying to Aave v3: Error: Supply amount must be > 0");
+ });
+ });
+
+ describe("supportsNetwork", () => {
+ it("should return true for Base Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "base-sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ it("should return true for Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ // For now
+ it("should return false for other EVM networks except sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "ethereum",
+ });
+ expect(result).toBe(false);
+ });
+
+ it("should return false for non-EVM networks", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "bitcoin",
+ networkId: "base-mainnet",
+ });
+ expect(result).toBe(false);
+ });
+ });
+});

typescript/agentkit/package.json

@@ -44,7 +44,11 @@
  "reflect-metadata": "^0.2.2",
  "twitter-api-v2": "^1.18.2",
  "viem": "^2.22.16",
- "zod": "^3.23.8"
+ "zod": "^3.23.8",
+ "@aave/contract-helpers": "^1.31.1",
+ "@aave/math-utils": "^1.31.1",
+ "ethers-v5": "npm:ethers@5.7.2",
+ "@bgd-labs/aave-address-book": "^4.9.0"
  },
  "devDependencies": {
  "@types/jest": "^29.5.14",

typescript/agentkit/src/action-providers/aave/README.md

@@ -0,0 +1,13 @@
+# Aave
+
+## Installation
+- Note this action requires packages from official `aave-utilities`, which has peer dependency on ethers v5 (v6 not supported)
+- Thus testing or running this requires installing the dependencies 
+- npm i @aave/contract-helpers @aave/math-utils @bgd-labs/aave-address-book ethers@5 
+
+
+## Featureset
+Currently these functions are tested
+- deposit
+- withdrawl
+

typescript/agentkit/src/action-providers/aave/aaveActionProvider.int.test.ts

@@ -0,0 +1,29 @@
+// import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+// import { AaveActionProvider } from "./aaveActionProvider";
+// import { providers } from "ethers-v5";
+
+// describe('withdraw', () => {
+// const actionProvider = new AaveActionProvider({
+// alchemyApiKey: process.env.ALCHEMY_API_KEY,
+// });
+// const CDP_WALLET_CONFIG = {
+// apiKeyName: process.env.CDP_API_KEY_NAME,
+// apiKeyPrivateKey: process.env.CDP_API_KEY_PRIVATE_KEY?.replace(/\\n/g, "\n"),
+// cdpWalletData: process.env.CDP_WALLET_DATA || '{}'
+// };
+
+// it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+
+// const evmWalletProvider = await CdpWalletProvider.configureWithWallet({
+// ...CDP_WALLET_CONFIG,
+// networkId: "base-sepolia", // other options: "base-mainnet", "ethereum-mainnet", "arbitrum-mainnet", "polygon-mainnet".
+// });
+
+// const response = await actionProvider.supply(evmWalletProvider, {
+// amount: '1',
+// poolAddress: market.POOL,
+// asset
+// });
+// })
+
+// });

typescript/agentkit/src/action-providers/aave/aaveActionProvider.test.ts

@@ -0,0 +1,184 @@
+import { AaveActionProvider, aaveActionProvider } from "./aaveActionProvider";
+import { ethers, providers, Wallet } from "ethers-v5";
+import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+import { ActionBundle, FaucetService, PoolBundle } from "@aave/contract-helpers";
+import * as markets from "@bgd-labs/aave-address-book";
+import { Address, Hex } from "viem";
+import { AAVEV3_BASE_SEPOLIA_MARKET_CONFIG } from "./markets";
+import { SupplySchema, WithdrawSchema } from "./schemas";
+import { approve } from "../../utils";
+import { createSupplyTxData } from "./aaveActionUtil";
+
+import { baseSepolia, sepolia } from "viem/chains";
+
+jest.mock("../../utils");
+const mockApprove = approve as jest.MockedFunction<typeof approve>;
+
+const cdpWalletData = process.env.CDP_WALLET_DATA || "{}";
+
+describe("SupplySchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ assetAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = SupplySchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = SupplySchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("WithdrawSchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ underlyingAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = WithdrawSchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = WithdrawSchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("Aave Action Provider", () => {
+ const alchemyConfig = {
+ apiKey: process.env.ALCHEMY_API_KEY,
+ };
+
+ const actionProvider = new AaveActionProvider();
+ let mockWallet: jest.Mocked<EvmWalletProvider>;
+ let mockProvider: jest.Mocked<providers.Provider>;
+
+ const MOCK_USER_ADDRESS = "0x9876543210987654321098765432109876543210";
+ const MOCK_TX_HASH = "0xabcdef1234567890";
+ const MOCK_RECEIPT = { status: 1, blockNumber: 1234567 };
+
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+
+ beforeEach(() => {
+ mockWallet = {
+ getAddress: jest.fn().mockReturnValue(MOCK_USER_ADDRESS),
+ getNetwork: jest
+ .fn()
+ .mockReturnValue({ protocolFamily: "evm", networkId: baseSepolia.network.toString() }),
+ sendTransaction: jest.fn().mockResolvedValue(MOCK_TX_HASH as `0x${string}`),
+ waitForTransactionReceipt: jest.fn().mockResolvedValue(MOCK_RECEIPT),
+ } as unknown as jest.Mocked<EvmWalletProvider>;
+
+ mockApprove.mockResolvedValue("Approval successful");
+ });
+
+ describe("withdraw", () => {
+ it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ assetATokenAddress: asset.A_TOKEN,
+ };
+
+ // const response = await actionProvider.withdraw(mockWallet, args);
+ });
+ });
+
+ describe("supply", () => {
+ it("should successfully supply USDC on Aaave v3 L2 base-sepolia", async () => {
+ const asset = markets.AaveV3BaseSepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ // fixture from createSupplyTxData with actual provider
+ // as we try to avoid mocking the L2Encoder encode logic and provider
+ const encodedTxData = "0x0000000000000000000000000000000000000000000000000000000000010000";
+
+ const txData =
+ "0x617ba037000000000000000000000000036cbd53842c5426634e7929541ec2318f3dcf7e000000000000000000000000000000000000000000000000000000000000000100000000000000000000000098765432109876543210987654321098765432100000000000000000000000000000000000000000000000000000000000000000";
+
+ console.log("encodedTxData", encodedTxData);
+
+ expect(mockWallet.sendTransaction).toHaveBeenCalledWith({
+ to: market.POOL as `0x${string}`,
+ data: txData,
+ });
+
+ expect(mockWallet.waitForTransactionReceipt).toHaveBeenCalledWith(MOCK_TX_HASH);
+ expect(response).toContain(
+ `Supplied 1 units of 0x036CbD53842c5426634e7929541eC2318f3dCF7e to Aave v3 Pool 0x07eA79F68B2B3df564D0A34F8e19D9B1e339814b with transaction hash: ${MOCK_TX_HASH} status:1`,
+ );
+ expect(response).toContain(MOCK_TX_HASH);
+ });
+
+ it("should handle transaction errors when supplying", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "0",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ mockWallet.sendTransaction.mockRejectedValue(new Error("Failed to supply"));
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ expect(response).toContain("Error supplying to Aave v3: Error: Supply amount must be > 0");
+ });
+ });
+
+ describe("supportsNetwork", () => {
+ it("should return true for Base Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "base-sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ it("should return true for Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ // For now
+ it("should return false for other EVM networks except sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "ethereum",
+ });
+ expect(result).toBe(false);
+ });
+
+ it("should return false for non-EVM networks", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "bitcoin",
+ networkId: "base-mainnet",
+ });
+ expect(result).toBe(false);
+ });
+ });
+});

typescript/agentkit/package.json

@@ -44,7 +44,11 @@
  "reflect-metadata": "^0.2.2",
  "twitter-api-v2": "^1.18.2",
  "viem": "^2.22.16",
- "zod": "^3.23.8"
+ "zod": "^3.23.8",
+ "@aave/contract-helpers": "^1.31.1",
+ "@aave/math-utils": "^1.31.1",
+ "ethers-v5": "npm:ethers@5.7.2",
+ "@bgd-labs/aave-address-book": "^4.9.0"
  },
  "devDependencies": {
  "@types/jest": "^29.5.14",

typescript/agentkit/src/action-providers/aave/README.md

@@ -0,0 +1,13 @@
+# Aave
+
+## Installation
+- Note this action requires packages from official `aave-utilities`, which has peer dependency on ethers v5 (v6 not supported)
+- Thus testing or running this requires installing the dependencies 
+- npm i @aave/contract-helpers @aave/math-utils @bgd-labs/aave-address-book ethers@5 
+
+
+## Featureset
+Currently these functions are tested
+- deposit
+- withdrawl
+

typescript/agentkit/src/action-providers/aave/aaveActionProvider.int.test.ts

@@ -0,0 +1,29 @@
+// import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+// import { AaveActionProvider } from "./aaveActionProvider";
+// import { providers } from "ethers-v5";
+
+// describe('withdraw', () => {
+// const actionProvider = new AaveActionProvider({
+// alchemyApiKey: process.env.ALCHEMY_API_KEY,
+// });
+// const CDP_WALLET_CONFIG = {
+// apiKeyName: process.env.CDP_API_KEY_NAME,
+// apiKeyPrivateKey: process.env.CDP_API_KEY_PRIVATE_KEY?.replace(/\\n/g, "\n"),
+// cdpWalletData: process.env.CDP_WALLET_DATA || '{}'
+// };
+
+// it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+
+// const evmWalletProvider = await CdpWalletProvider.configureWithWallet({
+// ...CDP_WALLET_CONFIG,
+// networkId: "base-sepolia", // other options: "base-mainnet", "ethereum-mainnet", "arbitrum-mainnet", "polygon-mainnet".
+// });
+
+// const response = await actionProvider.supply(evmWalletProvider, {
+// amount: '1',
+// poolAddress: market.POOL,
+// asset
+// });
+// })
+
+// });

typescript/agentkit/src/action-providers/aave/aaveActionProvider.test.ts

@@ -0,0 +1,184 @@
+import { AaveActionProvider, aaveActionProvider } from "./aaveActionProvider";
+import { ethers, providers, Wallet } from "ethers-v5";
+import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+import { ActionBundle, FaucetService, PoolBundle } from "@aave/contract-helpers";
+import * as markets from "@bgd-labs/aave-address-book";
+import { Address, Hex } from "viem";
+import { AAVEV3_BASE_SEPOLIA_MARKET_CONFIG } from "./markets";
+import { SupplySchema, WithdrawSchema } from "./schemas";
+import { approve } from "../../utils";
+import { createSupplyTxData } from "./aaveActionUtil";
+
+import { baseSepolia, sepolia } from "viem/chains";
+
+jest.mock("../../utils");
+const mockApprove = approve as jest.MockedFunction<typeof approve>;
+
+const cdpWalletData = process.env.CDP_WALLET_DATA || "{}";
+
+describe("SupplySchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ assetAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = SupplySchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = SupplySchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("WithdrawSchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ underlyingAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = WithdrawSchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = WithdrawSchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("Aave Action Provider", () => {
+ const alchemyConfig = {
+ apiKey: process.env.ALCHEMY_API_KEY,
+ };
+
+ const actionProvider = new AaveActionProvider();
+ let mockWallet: jest.Mocked<EvmWalletProvider>;
+ let mockProvider: jest.Mocked<providers.Provider>;
+
+ const MOCK_USER_ADDRESS = "0x9876543210987654321098765432109876543210";
+ const MOCK_TX_HASH = "0xabcdef1234567890";
+ const MOCK_RECEIPT = { status: 1, blockNumber: 1234567 };
+
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+
+ beforeEach(() => {
+ mockWallet = {
+ getAddress: jest.fn().mockReturnValue(MOCK_USER_ADDRESS),
+ getNetwork: jest
+ .fn()
+ .mockReturnValue({ protocolFamily: "evm", networkId: baseSepolia.network.toString() }),
+ sendTransaction: jest.fn().mockResolvedValue(MOCK_TX_HASH as `0x${string}`),
+ waitForTransactionReceipt: jest.fn().mockResolvedValue(MOCK_RECEIPT),
+ } as unknown as jest.Mocked<EvmWalletProvider>;
+
+ mockApprove.mockResolvedValue("Approval successful");
+ });
+
+ describe("withdraw", () => {
+ it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ assetATokenAddress: asset.A_TOKEN,
+ };
+
+ // const response = await actionProvider.withdraw(mockWallet, args);
+ });
+ });
+
+ describe("supply", () => {
+ it("should successfully supply USDC on Aaave v3 L2 base-sepolia", async () => {
+ const asset = markets.AaveV3BaseSepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ // fixture from createSupplyTxData with actual provider
+ // as we try to avoid mocking the L2Encoder encode logic and provider
+ const encodedTxData = "0x0000000000000000000000000000000000000000000000000000000000010000";
+
+ const txData =
+ "0x617ba037000000000000000000000000036cbd53842c5426634e7929541ec2318f3dcf7e000000000000000000000000000000000000000000000000000000000000000100000000000000000000000098765432109876543210987654321098765432100000000000000000000000000000000000000000000000000000000000000000";
+
+ console.log("encodedTxData", encodedTxData);
+
+ expect(mockWallet.sendTransaction).toHaveBeenCalledWith({
+ to: market.POOL as `0x${string}`,
+ data: txData,
+ });
+
+ expect(mockWallet.waitForTransactionReceipt).toHaveBeenCalledWith(MOCK_TX_HASH);
+ expect(response).toContain(
+ `Supplied 1 units of 0x036CbD53842c5426634e7929541eC2318f3dCF7e to Aave v3 Pool 0x07eA79F68B2B3df564D0A34F8e19D9B1e339814b with transaction hash: ${MOCK_TX_HASH} status:1`,
+ );
+ expect(response).toContain(MOCK_TX_HASH);
+ });
+
+ it("should handle transaction errors when supplying", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "0",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ mockWallet.sendTransaction.mockRejectedValue(new Error("Failed to supply"));
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ expect(response).toContain("Error supplying to Aave v3: Error: Supply amount must be > 0");
+ });
+ });
+
+ describe("supportsNetwork", () => {
+ it("should return true for Base Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "base-sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ it("should return true for Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ // For now
+ it("should return false for other EVM networks except sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "ethereum",
+ });
+ expect(result).toBe(false);
+ });
+
+ it("should return false for non-EVM networks", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "bitcoin",
+ networkId: "base-mainnet",
+ });
+ expect(result).toBe(false);
+ });
+ });
+});

typescript/agentkit/package.json

@@ -44,7 +44,11 @@
  "reflect-metadata": "^0.2.2",
  "twitter-api-v2": "^1.18.2",
  "viem": "^2.22.16",
- "zod": "^3.23.8"
+ "zod": "^3.23.8",
+ "@aave/contract-helpers": "^1.31.1",
+ "@aave/math-utils": "^1.31.1",
+ "ethers-v5": "npm:ethers@5.7.2",
+ "@bgd-labs/aave-address-book": "^4.9.0"
  },
  "devDependencies": {
  "@types/jest": "^29.5.14",

typescript/agentkit/src/action-providers/aave/README.md

@@ -0,0 +1,13 @@
+# Aave
+
+## Installation
+- Note this action requires packages from official `aave-utilities`, which has peer dependency on ethers v5 (v6 not supported)
+- Thus testing or running this requires installing the dependencies 
+- npm i @aave/contract-helpers @aave/math-utils @bgd-labs/aave-address-book ethers@5 
+
+
+## Featureset
+Currently these functions are tested
+- deposit
+- withdrawl
+

typescript/agentkit/src/action-providers/aave/aaveActionProvider.int.test.ts

@@ -0,0 +1,29 @@
+// import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+// import { AaveActionProvider } from "./aaveActionProvider";
+// import { providers } from "ethers-v5";
+
+// describe('withdraw', () => {
+// const actionProvider = new AaveActionProvider({
+// alchemyApiKey: process.env.ALCHEMY_API_KEY,
+// });
+// const CDP_WALLET_CONFIG = {
+// apiKeyName: process.env.CDP_API_KEY_NAME,
+// apiKeyPrivateKey: process.env.CDP_API_KEY_PRIVATE_KEY?.replace(/\\n/g, "\n"),
+// cdpWalletData: process.env.CDP_WALLET_DATA || '{}'
+// };
+
+// it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+
+// const evmWalletProvider = await CdpWalletProvider.configureWithWallet({
+// ...CDP_WALLET_CONFIG,
+// networkId: "base-sepolia", // other options: "base-mainnet", "ethereum-mainnet", "arbitrum-mainnet", "polygon-mainnet".
+// });
+
+// const response = await actionProvider.supply(evmWalletProvider, {
+// amount: '1',
+// poolAddress: market.POOL,
+// asset
+// });
+// })
+
+// });

typescript/agentkit/src/action-providers/aave/aaveActionProvider.test.ts

@@ -0,0 +1,184 @@
+import { AaveActionProvider, aaveActionProvider } from "./aaveActionProvider";
+import { ethers, providers, Wallet } from "ethers-v5";
+import { CdpWalletProvider, EvmWalletProvider } from "../../wallet-providers";
+import { ActionBundle, FaucetService, PoolBundle } from "@aave/contract-helpers";
+import * as markets from "@bgd-labs/aave-address-book";
+import { Address, Hex } from "viem";
+import { AAVEV3_BASE_SEPOLIA_MARKET_CONFIG } from "./markets";
+import { SupplySchema, WithdrawSchema } from "./schemas";
+import { approve } from "../../utils";
+import { createSupplyTxData } from "./aaveActionUtil";
+
+import { baseSepolia, sepolia } from "viem/chains";
+
+jest.mock("../../utils");
+const mockApprove = approve as jest.MockedFunction<typeof approve>;
+
+const cdpWalletData = process.env.CDP_WALLET_DATA || "{}";
+
+describe("SupplySchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ assetAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = SupplySchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = SupplySchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("WithdrawSchema", () => {
+ it("should successfully parse valid input", () => {
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+ const validInput = {
+ amount: "1",
+ underlyingAddress: markets.AaveV3Sepolia.ASSETS.USDC.UNDERLYING,
+ };
+
+ const result = WithdrawSchema.safeParse(validInput);
+
+ expect(result.success).toBe(true);
+ expect(result.data).toEqual(validInput);
+ });
+
+ it("should fail parsing empty input", () => {
+ const emptyInput = {};
+ const result = WithdrawSchema.safeParse(emptyInput);
+
+ expect(result.success).toBe(false);
+ });
+});
+
+describe("Aave Action Provider", () => {
+ const alchemyConfig = {
+ apiKey: process.env.ALCHEMY_API_KEY,
+ };
+
+ const actionProvider = new AaveActionProvider();
+ let mockWallet: jest.Mocked<EvmWalletProvider>;
+ let mockProvider: jest.Mocked<providers.Provider>;
+
+ const MOCK_USER_ADDRESS = "0x9876543210987654321098765432109876543210";
+ const MOCK_TX_HASH = "0xabcdef1234567890";
+ const MOCK_RECEIPT = { status: 1, blockNumber: 1234567 };
+
+ const market = AAVEV3_BASE_SEPOLIA_MARKET_CONFIG;
+
+ beforeEach(() => {
+ mockWallet = {
+ getAddress: jest.fn().mockReturnValue(MOCK_USER_ADDRESS),
+ getNetwork: jest
+ .fn()
+ .mockReturnValue({ protocolFamily: "evm", networkId: baseSepolia.network.toString() }),
+ sendTransaction: jest.fn().mockResolvedValue(MOCK_TX_HASH as `0x${string}`),
+ waitForTransactionReceipt: jest.fn().mockResolvedValue(MOCK_RECEIPT),
+ } as unknown as jest.Mocked<EvmWalletProvider>;
+
+ mockApprove.mockResolvedValue("Approval successful");
+ });
+
+ describe("withdraw", () => {
+ it("should successfully withdraw USDC from Aave v3 L2 bas-sepolia", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ assetATokenAddress: asset.A_TOKEN,
+ };
+
+ // const response = await actionProvider.withdraw(mockWallet, args);
+ });
+ });
+
+ describe("supply", () => {
+ it("should successfully supply USDC on Aaave v3 L2 base-sepolia", async () => {
+ const asset = markets.AaveV3BaseSepolia.ASSETS.USDC;
+ const args = {
+ amount: "1",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ // fixture from createSupplyTxData with actual provider
+ // as we try to avoid mocking the L2Encoder encode logic and provider
+ const encodedTxData = "0x0000000000000000000000000000000000000000000000000000000000010000";
+
+ const txData =
+ "0x617ba037000000000000000000000000036cbd53842c5426634e7929541ec2318f3dcf7e000000000000000000000000000000000000000000000000000000000000000100000000000000000000000098765432109876543210987654321098765432100000000000000000000000000000000000000000000000000000000000000000";
+
+ console.log("encodedTxData", encodedTxData);
+
+ expect(mockWallet.sendTransaction).toHaveBeenCalledWith({
+ to: market.POOL as `0x${string}`,
+ data: txData,
+ });
+
+ expect(mockWallet.waitForTransactionReceipt).toHaveBeenCalledWith(MOCK_TX_HASH);
+ expect(response).toContain(
+ `Supplied 1 units of 0x036CbD53842c5426634e7929541eC2318f3dCF7e to Aave v3 Pool 0x07eA79F68B2B3df564D0A34F8e19D9B1e339814b with transaction hash: ${MOCK_TX_HASH} status:1`,
+ );
+ expect(response).toContain(MOCK_TX_HASH);
+ });
+
+ it("should handle transaction errors when supplying", async () => {
+ const asset = markets.AaveV3Sepolia.ASSETS.USDC;
+ const args = {
+ amount: "0",
+ assetAddress: asset.UNDERLYING,
+ };
+
+ mockWallet.sendTransaction.mockRejectedValue(new Error("Failed to supply"));
+
+ const response = await actionProvider.supply(mockWallet, args);
+
+ expect(response).toContain("Error supplying to Aave v3: Error: Supply amount must be > 0");
+ });
+ });
+
+ describe("supportsNetwork", () => {
+ it("should return true for Base Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "base-sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ it("should return true for Sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "sepolia",
+ });
+ expect(result).toBe(true);
+ });
+
+ // For now
+ it("should return false for other EVM networks except sepolia", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "evm",
+ networkId: "ethereum",
+ });
+ expect(result).toBe(false);
+ });
+
+ it("should return false for non-EVM networks", () => {
+ const result = actionProvider.supportsNetwork({
+ protocolFamily: "bitcoin",
+ networkId: "base-mainnet",
+ });
+ expect(result).toBe(false);
+ });
+ });
+});