@aave/cli 4.1.0-next.9 → 4.1.1

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @aave/cli
 $ aave COMMAND
 running command...
 $ aave (--version)
-@aave/cli/4.1.0-next.9 darwin-arm64 node-v22.17.0
+@aave/cli/4.1.0 darwin-arm64 node-v22.17.0
 $ aave --help [COMMAND]
 USAGE
   $ aave COMMAND
@@ -29,9 +29,33 @@ USAGE
 <!-- usagestop -->
 # Commands
 <!-- commands -->
+* [`aave borrows list`](#aave-borrows-list)
 * [`aave hubs list`](#aave-hubs-list)
+* [`aave positions list`](#aave-positions-list)
 * [`aave reserves list`](#aave-reserves-list)
 * [`aave spokes list`](#aave-spokes-list)
+* [`aave supplies list`](#aave-supplies-list)
+
+## `aave borrows list`
+
+List user borrows for a specific chain
+
+```
+USAGE
+  $ aave borrows list --user <evm-address> -c <chain-id> [--json]
+
+FLAGS
+  -c, --chain_id=<chain-id>  (required) Chain ID to query borrows from
+      --user=<evm-address>   (required) User address
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List user borrows for a specific chain
+```
+
+_See code: [src/commands/borrows/list.ts](https://github.com/aave/aave-v4-sdk/blob/v4.1.0/src/commands/borrows/list.ts)_
 
 ## `aave hubs list`
 
@@ -51,7 +75,28 @@ DESCRIPTION
   List Aave v4 liquidity hubs
 ```
 
-_See code: [src/commands/hubs/list.ts](https://github.com/aave/aave-v4-sdk/blob/v4.1.0-next.9/src/commands/hubs/list.ts)_
+_See code: [src/commands/hubs/list.ts](https://github.com/aave/aave-v4-sdk/blob/v4.1.0/src/commands/hubs/list.ts)_
+
+## `aave positions list`
+
+List user positions across chains
+
+```
+USAGE
+  $ aave positions list --user <evm-address> -c <chain-id> [--json]
+
+FLAGS
+  -c, --chain_id=<chain-id>  (required) Filter by chain ID
+      --user=<evm-address>   (required) User address
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List user positions across chains
+```
+
+_See code: [src/commands/positions/list.ts](https://github.com/aave/aave-v4-sdk/blob/v4.1.0/src/commands/positions/list.ts)_
 
 ## `aave reserves list`
 
@@ -74,7 +119,7 @@ DESCRIPTION
   List Aave v4 reserves
 ```
 
-_See code: [src/commands/reserves/list.ts](https://github.com/aave/aave-v4-sdk/blob/v4.1.0-next.9/src/commands/reserves/list.ts)_
+_See code: [src/commands/reserves/list.ts](https://github.com/aave/aave-v4-sdk/blob/v4.1.0/src/commands/reserves/list.ts)_
 
 ## `aave spokes list`
 
@@ -96,5 +141,26 @@ DESCRIPTION
   List Aave v4 spokes
 ```
 
-_See code: [src/commands/spokes/list.ts](https://github.com/aave/aave-v4-sdk/blob/v4.1.0-next.9/src/commands/spokes/list.ts)_
+_See code: [src/commands/spokes/list.ts](https://github.com/aave/aave-v4-sdk/blob/v4.1.0/src/commands/spokes/list.ts)_
+
+## `aave supplies list`
+
+List user supplies for a specific chain
+
+```
+USAGE
+  $ aave supplies list --user <evm-address> -c <chain-id> [--json]
+
+FLAGS
+  -c, --chain_id=<chain-id>  (required) Chain ID to query supplies from
+      --user=<evm-address>   (required) User address
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List user supplies for a specific chain
+```
+
+_See code: [src/commands/supplies/list.ts](https://github.com/aave/aave-v4-sdk/blob/v4.1.0/src/commands/supplies/list.ts)_
 <!-- commandsstop -->

package/dist/commands/borrows/list.d.ts

@@ -0,0 +1,14 @@
+import { type ChainId, type EvmAddress, InvariantError, type UnexpectedError, type UserBorrowItem } from '@aave/client';
+import * as common from '../../common.js';
+export default class ListBorrows extends common.V4Command {
+    static description: string;
+    static flags: {
+        user: import("@oclif/core/interfaces").OptionFlag<EvmAddress, import("@oclif/core/interfaces").CustomOptions>;
+        chain_id: import("@oclif/core/interfaces").OptionFlag<ChainId, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    headers: {
+        value: string;
+    }[];
+    private getBorrowsRequest;
+    run(): Promise<UserBorrowItem[] | InvariantError | UnexpectedError>;
+}

package/dist/commands/borrows/list.js

@@ -0,0 +1,63 @@
+import { InvariantError, invariant, ok, ResultAsync, } from '@aave/client';
+import { userBorrows } from '@aave/client/actions';
+import * as common from '../../common.js';
+export default class ListBorrows extends common.V4Command {
+    static description = 'List user borrows for a specific chain';
+    static flags = {
+        user: common.address({
+            required: true,
+            description: 'User address',
+        }),
+        chain_id: common.chain({
+            required: true,
+            description: 'Chain ID to query borrows from',
+        }),
+    };
+    headers = [
+        { value: 'Asset' },
+        { value: 'Borrowed' },
+        { value: 'Interest Owed' },
+        { value: 'Total Debt' },
+        { value: 'Borrow APY' },
+        { value: 'Spoke' },
+    ];
+    getBorrowsRequest() {
+        return ResultAsync.fromPromise(this.parse(ListBorrows), (error) => new InvariantError(String(error))).andThen(({ flags }) => {
+            const user = flags.user;
+            const chainId = flags.chain_id;
+            invariant(user, 'You must provide a user address');
+            invariant(chainId, 'You must provide a chain ID');
+            return ok({
+                query: {
+                    userChains: {
+                        user,
+                        chainIds: [chainId],
+                    },
+                },
+            });
+        });
+    }
+    async run() {
+        const result = await this.getBorrowsRequest()
+            .andThen((request) => userBorrows(this.client, request))
+            .andThen((borrows) => {
+            if (borrows.length === 0) {
+                this.log('No borrows found for this user.');
+                return ok(borrows);
+            }
+            this.display(borrows.map((item) => [
+                item.principal.token.info.name,
+                `${item.principal.amount.value.toFixed(4)} `,
+                `${item.interest.amount.value.toFixed(4)} `,
+                `${(item.debt.amount.value).toFixed(4)} `,
+                `${item.reserve.summary.borrowApy.normalized.toFixed(4)}%`,
+                item.reserve.spoke.name,
+            ]));
+            return ok(borrows);
+        });
+        if (result.isErr()) {
+            this.error(result.error);
+        }
+        return result.value;
+    }
+}

package/dist/commands/positions/list.d.ts

@@ -0,0 +1,14 @@
+import { type ChainId, type EvmAddress, InvariantError, type UnexpectedError, type UserPosition } from '@aave/client';
+import * as common from '../../common.js';
+export default class ListPositions extends common.V4Command {
+    static description: string;
+    static flags: {
+        user: import("@oclif/core/interfaces").OptionFlag<EvmAddress, import("@oclif/core/interfaces").CustomOptions>;
+        chain_id: import("@oclif/core/interfaces").OptionFlag<ChainId, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    headers: {
+        value: string;
+    }[];
+    private getPositionsRequest;
+    run(): Promise<UserPosition[] | InvariantError | UnexpectedError>;
+}

package/dist/commands/positions/list.js

@@ -0,0 +1,65 @@
+import { InvariantError, invariant, ok, ResultAsync, } from '@aave/client';
+import { userPositions } from '@aave/client/actions';
+import * as common from '../../common.js';
+export default class ListPositions extends common.V4Command {
+    static description = 'List user positions across chains';
+    static flags = {
+        user: common.address({
+            required: true,
+            description: 'User address',
+        }),
+        chain_id: common.chain({
+            required: true,
+            description: 'Filter by chain ID',
+        }),
+    };
+    headers = [
+        { value: 'Position ID' },
+        { value: 'Spoke' },
+        { value: 'Chain' },
+        { value: 'Total Supplied' },
+        { value: 'Total Borrowed' },
+        { value: 'Health Factor' },
+        { value: 'Collateral Enabled' },
+    ];
+    getPositionsRequest() {
+        return ResultAsync.fromPromise(this.parse(ListPositions), (error) => new InvariantError(String(error))).andThen(({ flags }) => {
+            const user = flags.user;
+            const chainId = flags.chain_id;
+            invariant(user, 'You must provide a user address');
+            invariant(chainId, 'You must provide a chain ID');
+            return ok({
+                user,
+                filter: {
+                    chainIds: [chainId],
+                },
+            });
+        });
+    }
+    async run() {
+        const result = await this.getPositionsRequest()
+            .andThen((request) => userPositions(this.client, request))
+            .andThen((positions) => {
+            if (positions.length === 0) {
+                this.log('No positions found for this user');
+                return ok(positions);
+            }
+            this.display(positions.map((item) => [
+                item.id,
+                item.spoke.name,
+                `${item.spoke.chain.name} (id=${item.spoke.chain.chainId})`,
+                `${item.totalSupplied.current.symbol}${item.totalSupplied.current.value.toFixed(2)}`,
+                `${item.totalDebt.current.symbol}${item.totalDebt.current.value.toFixed(2)}`,
+                item.healthFactor.current?.toFixed(2) ?? 'N/A',
+                Number(item.totalCollateral.current.value.toFixed(0)) > 0
+                    ? 'Yes'
+                    : 'No',
+            ]));
+            return ok(positions);
+        });
+        if (result.isErr()) {
+            this.error(result.error);
+        }
+        return result.value;
+    }
+}

package/dist/commands/supplies/list.d.ts

@@ -0,0 +1,14 @@
+import { type ChainId, type EvmAddress, InvariantError, type UnexpectedError, type UserSupplyItem } from '@aave/client';
+import * as common from '../../common.js';
+export default class ListSupplies extends common.V4Command {
+    static description: string;
+    static flags: {
+        user: import("@oclif/core/interfaces").OptionFlag<EvmAddress, import("@oclif/core/interfaces").CustomOptions>;
+        chain_id: import("@oclif/core/interfaces").OptionFlag<ChainId, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    headers: {
+        value: string;
+    }[];
+    private getSuppliesRequest;
+    run(): Promise<UserSupplyItem[] | InvariantError | UnexpectedError>;
+}

package/dist/commands/supplies/list.js

@@ -0,0 +1,65 @@
+import { InvariantError, invariant, ok, ResultAsync, } from '@aave/client';
+import { userSupplies } from '@aave/client/actions';
+import * as common from '../../common.js';
+export default class ListSupplies extends common.V4Command {
+    static description = 'List user supplies for a specific chain';
+    static flags = {
+        user: common.address({
+            required: true,
+            description: 'User address',
+        }),
+        chain_id: common.chain({
+            required: true,
+            description: 'Chain ID to query supplies from',
+        }),
+    };
+    headers = [
+        { value: 'Asset' },
+        { value: 'Supplied' },
+        { value: 'Interest Earned' },
+        { value: 'Withdrawable' },
+        { value: 'APY' },
+        { value: 'Collateral' },
+        { value: 'Spoke' },
+    ];
+    getSuppliesRequest() {
+        return ResultAsync.fromPromise(this.parse(ListSupplies), (error) => new InvariantError(String(error))).andThen(({ flags }) => {
+            const user = flags.user;
+            const chainId = flags.chain_id;
+            invariant(user, 'You must provide a user address');
+            invariant(chainId, 'You must provide a chain ID');
+            return ok({
+                query: {
+                    userChains: {
+                        user,
+                        chainIds: [chainId],
+                    },
+                },
+            });
+        });
+    }
+    async run() {
+        const result = await this.getSuppliesRequest()
+            .andThen((request) => userSupplies(this.client, request))
+            .andThen((supplies) => {
+            if (supplies.length === 0) {
+                this.log('No supplies found for this user');
+                return ok(supplies);
+            }
+            this.display(supplies.map((item) => [
+                `${item.reserve.asset.underlying.info.name} (${item.reserve.asset.underlying.info.symbol})`,
+                `${item.principal.amount.value.toFixed(4)} `,
+                `${item.interest.amount.value.toFixed(4)} `,
+                `${item.withdrawable.amount.value.toFixed(4)}`,
+                `${item.reserve.summary.supplyApy.normalized.toFixed(4)}%`,
+                item.isCollateral ? 'Yes' : 'No',
+                item.reserve.spoke.name,
+            ]));
+            return ok(supplies);
+        });
+        if (result.isErr()) {
+            this.error(result.error);
+        }
+        return result.value;
+    }
+}

package/oclif.manifest.json

@@ -1,5 +1,60 @@
 {
   "commands": {
+    "borrows:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List user borrows for a specific chain",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "staging": {
+          "description": "Use staging environment",
+          "hidden": true,
+          "name": "staging",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "user": {
+          "description": "User address",
+          "name": "user",
+          "required": true,
+          "hasDynamicHelp": false,
+          "helpValue": "<evm-address>",
+          "multiple": false,
+          "type": "option"
+        },
+        "chain_id": {
+          "char": "c",
+          "description": "Chain ID to query borrows from",
+          "name": "chain_id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "helpValue": "<chain-id>",
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "borrows:list",
+      "pluginAlias": "@aave/cli",
+      "pluginName": "@aave/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "borrows",
+        "list.js"
+      ]
+    },
     "hubs:list": {
       "aliases": [],
       "args": {},
@@ -45,10 +100,10 @@
         "list.js"
       ]
     },
-    "reserves:list": {
+    "positions:list": {
       "aliases": [],
       "args": {},
-      "description": "List Aave v4 reserves",
+      "description": "List user positions across chains",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -64,26 +119,61 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "spoke_id": {
-          "char": "s",
-          "description": "The spoke ID (e.g. SGVsbG8h…)",
-          "name": "spoke_id",
-          "relationships": [
-            {
-              "type": "none",
-              "flags": [
-                "hub_id",
-                "chain_id",
-                "hub_address"
-              ]
-            }
-          ],
-          "required": false,
+        "user": {
+          "description": "User address",
+          "name": "user",
+          "required": true,
           "hasDynamicHelp": false,
-          "helpValue": "<spoke-id>",
+          "helpValue": "<evm-address>",
           "multiple": false,
           "type": "option"
         },
+        "chain_id": {
+          "char": "c",
+          "description": "Filter by chain ID",
+          "name": "chain_id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "helpValue": "<chain-id>",
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "positions:list",
+      "pluginAlias": "@aave/cli",
+      "pluginName": "@aave/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "positions",
+        "list.js"
+      ]
+    },
+    "spokes:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List Aave v4 spokes",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "staging": {
+          "description": "Use staging environment",
+          "hidden": true,
+          "name": "staging",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "hub_id": {
           "char": "h",
           "description": "The hub ID (e.g. SGVsbG8h…)",
@@ -92,13 +182,11 @@
             {
               "type": "none",
               "flags": [
-                "spoke_id",
                 "chain_id",
                 "hub_address"
               ]
             }
           ],
-          "required": false,
           "hasDynamicHelp": false,
           "helpValue": "<hub-id>",
           "multiple": false,
@@ -112,7 +200,6 @@
             {
               "type": "none",
               "flags": [
-                "spoke_id",
                 "hub_id"
               ]
             }
@@ -133,7 +220,6 @@
             {
               "type": "none",
               "flags": [
-                "spoke_id",
                 "hub_id"
               ]
             },
@@ -152,7 +238,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "reserves:list",
+      "id": "spokes:list",
       "pluginAlias": "@aave/cli",
       "pluginName": "@aave/cli",
       "pluginType": "core",
@@ -162,14 +248,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "reserves",
+        "spokes",
         "list.js"
       ]
     },
-    "spokes:list": {
+    "reserves:list": {
       "aliases": [],
       "args": {},
-      "description": "List Aave v4 spokes",
+      "description": "List Aave v4 reserves",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -185,6 +271,26 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "spoke_id": {
+          "char": "s",
+          "description": "The spoke ID (e.g. SGVsbG8h…)",
+          "name": "spoke_id",
+          "relationships": [
+            {
+              "type": "none",
+              "flags": [
+                "hub_id",
+                "chain_id",
+                "hub_address"
+              ]
+            }
+          ],
+          "required": false,
+          "hasDynamicHelp": false,
+          "helpValue": "<spoke-id>",
+          "multiple": false,
+          "type": "option"
+        },
         "hub_id": {
           "char": "h",
           "description": "The hub ID (e.g. SGVsbG8h…)",
@@ -193,11 +299,13 @@
             {
               "type": "none",
               "flags": [
+                "spoke_id",
                 "chain_id",
                 "hub_address"
               ]
             }
           ],
+          "required": false,
           "hasDynamicHelp": false,
           "helpValue": "<hub-id>",
           "multiple": false,
@@ -211,6 +319,7 @@
             {
               "type": "none",
               "flags": [
+                "spoke_id",
                 "hub_id"
               ]
             }
@@ -231,6 +340,7 @@
             {
               "type": "none",
               "flags": [
+                "spoke_id",
                 "hub_id"
               ]
             },
@@ -249,7 +359,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "spokes:list",
+      "id": "reserves:list",
       "pluginAlias": "@aave/cli",
       "pluginName": "@aave/cli",
       "pluginType": "core",
@@ -259,10 +369,65 @@
       "relativePath": [
         "dist",
         "commands",
-        "spokes",
+        "reserves",
+        "list.js"
+      ]
+    },
+    "supplies:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List user supplies for a specific chain",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "staging": {
+          "description": "Use staging environment",
+          "hidden": true,
+          "name": "staging",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "user": {
+          "description": "User address",
+          "name": "user",
+          "required": true,
+          "hasDynamicHelp": false,
+          "helpValue": "<evm-address>",
+          "multiple": false,
+          "type": "option"
+        },
+        "chain_id": {
+          "char": "c",
+          "description": "Chain ID to query supplies from",
+          "name": "chain_id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "helpValue": "<chain-id>",
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "supplies:list",
+      "pluginAlias": "@aave/cli",
+      "pluginName": "@aave/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "supplies",
         "list.js"
       ]
     }
   },
-  "version": "4.1.0-next.9"
+  "version": "4.1.1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aave/cli",
-  "version": "4.1.0-next.9",
+  "version": "4.1.1",
   "description": "CLI to interact with AaveKit API",
   "keywords": [
     "aave",
@@ -30,13 +30,13 @@
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-plugins": "^5",
     "tty-table": "^5.0.0",
-    "@aave/client": "4.0.0-next.16"
+    "@aave/client": "4.0.1"
   },
   "devDependencies": {
     "@oclif/test": "^4",
     "@types/node": "^24",
-    "oclif": "^4",
-    "rimraf": "^6.1.2",
+    "oclif": "^4.22.81",
+    "rimraf": "^6.1.3",
     "tsx": "^4.20.3",
     "typescript": "^5"
   },
@@ -60,6 +60,6 @@
   },
   "scripts": {
     "build": "rimraf dist && tsc -b",
-    "version": "oclif readme && git add README.md"
+    "readme": "oclif readme"
   }
 }