@waiaas/actions 2.8.0-rc.1 → 2.8.0

package/README.md

@@ -120,14 +120,25 @@ npx @waiaas/skills add all
 
 This adds `.skill.md` instruction files to your project. Include them in your agent's context and it learns the WAIaaS API automatically. Available skills: `setup`, `quickstart`, `wallet`, `transactions`, `policies`, `admin`, `actions`, `x402`.
 
-### Agent Self-Setup
+### Agent Self-Setup (Auto-Provision)
 
-AI agents can set up WAIaaS from scratch by following the setup skill:
+AI agents can set up WAIaaS fully autonomously with no human interaction:
 
-1. Install skills: `npx @waiaas/skills add all`
-2. Read and follow `waiaas-setup/SKILL.md`
+```bash
+npm install -g @waiaas/cli
+waiaas init --auto-provision     # Generates random master password → recovery.key
+waiaas start                     # No password prompt
+waiaas quickset                  # Creates wallets + sessions automatically
+waiaas set-master                # (Later) Harden password, then delete recovery.key
+```
+
+The `--auto-provision` flag generates a cryptographically random master password and saves it to `~/.waiaas/recovery.key`. All subsequent CLI commands read it automatically. See the [Agent Self-Setup Guide](docs/guides/agent-self-setup.md) for the complete flow.
 
-The setup skill guides through CLI installation, daemon startup, wallet creation, and session configuration. Master password prompts require human input.
+For manual setup with human-guided password entry, install skills and follow `waiaas-setup/SKILL.md`:
+
+```bash
+npx @waiaas/skills add all
+```
 
 ## Alternative: Docker
 
@@ -203,6 +214,7 @@ Enabled by default (`admin_ui = true` in config.toml).
 | [Security Model](docs/security-model.md) | Authentication, policy engine, Kill Switch, AutoStop |
 | [Deployment Guide](docs/deployment.md) | Docker, npm, configuration reference |
 | [API Reference](docs/api-reference.md) | REST API endpoints and authentication |
+| [Agent Self-Setup Guide](docs/guides/agent-self-setup.md) | Fully autonomous setup with auto-provision |
 | [Agent Skills Integration](docs/guides/agent-skills-integration.md) | Universal guide for 27+ AI agent platforms |
 | [Claude Code Integration](docs/guides/claude-code-integration.md) | Skill files + MCP server setup for Claude Code |
 | [OpenClaw Integration](docs/guides/openclaw-integration.md) | Quick setup for OpenClaw bot |

package/dist/index.d.ts

@@ -5,6 +5,7 @@
  * and individual provider classes for direct usage.
  */
 import type { IActionProvider } from '@waiaas/core';
+import type { IRpcCaller } from './providers/aave-v3/aave-rpc.js';
 export { JupiterSwapActionProvider } from './providers/jupiter-swap/index.js';
 export { JUPITER_PROGRAM_ID, JUPITER_SWAP_DEFAULTS } from './providers/jupiter-swap/config.js';
 export type { JupiterSwapConfig } from './providers/jupiter-swap/config.js';
@@ -24,6 +25,11 @@ export { JitoStakingActionProvider } from './providers/jito-staking/index.js';
 export { JITO_STAKING_DEFAULTS, JITO_MAINNET_ADDRESSES, getJitoAddresses } from './providers/jito-staking/config.js';
 export type { JitoStakingConfig } from './providers/jito-staking/config.js';
 export { JitoEpochTracker } from './providers/jito-staking/epoch-tracker.js';
+export { AaveV3LendingProvider } from './providers/aave-v3/index.js';
+export { AAVE_V3_DEFAULTS, AAVE_V3_ADDRESSES, getAaveAddresses, AAVE_CHAIN_ID_MAP } from './providers/aave-v3/config.js';
+export type { AaveV3Config, AaveChainAddresses } from './providers/aave-v3/config.js';
+export type { IRpcCaller, UserAccountData, ReserveData } from './providers/aave-v3/aave-rpc.js';
+export { decodeGetUserAccountData, decodeGetReserveData, simulateHealthFactor, rayToApy, hfToNumber, LIQUIDATION_THRESHOLD_HF, WARNING_THRESHOLD_HF } from './providers/aave-v3/aave-rpc.js';
 export { ActionApiClient } from './common/action-api-client.js';
 export { asBps, asPct, clampSlippageBps, bpsToPct, pctToBps } from './common/slippage.js';
 export type { SlippageBps, SlippagePct } from './common/slippage.js';
@@ -42,7 +48,9 @@ interface ProviderRegistry {
  * Reads provider config from SettingsReader (DB > config.toml > default fallback chain).
  * Each provider is registered when its `actions.{name}_enabled` setting is 'true'.
  */
-export declare function registerBuiltInProviders(registry: ProviderRegistry, settingsReader: SettingsReader): {
+export declare function registerBuiltInProviders(registry: ProviderRegistry, settingsReader: SettingsReader, options?: {
+    rpcCaller?: IRpcCaller;
+}): {
     loaded: string[];
     skipped: string[];
 };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,cAAc,CAAC;AAWjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC/F,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC5I,YAAY,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC3F,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAEzG,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC7I,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAEvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACrH,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,GACb,MAAM,kCAAkC,CAAC;AAM1C,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,gBAAgB,EAC1B,cAAc,EAAE,cAAc,GAC7B;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAsHzC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -6,6 +6,8 @@ import { LidoStakingActionProvider } from './providers/lido-staking/index.js';
 import { getLidoAddresses } from './providers/lido-staking/config.js';
 import { JitoStakingActionProvider } from './providers/jito-staking/index.js';
 import { getJitoAddresses } from './providers/jito-staking/config.js';
+import { AaveV3LendingProvider } from './providers/aave-v3/index.js';
+import {} from './providers/aave-v3/config.js';
 // Re-export provider classes
 export { JupiterSwapActionProvider } from './providers/jupiter-swap/index.js';
 export { JUPITER_PROGRAM_ID, JUPITER_SWAP_DEFAULTS } from './providers/jupiter-swap/config.js';
@@ -21,6 +23,9 @@ export { LidoWithdrawalTracker } from './providers/lido-staking/withdrawal-track
 export { JitoStakingActionProvider } from './providers/jito-staking/index.js';
 export { JITO_STAKING_DEFAULTS, JITO_MAINNET_ADDRESSES, getJitoAddresses } from './providers/jito-staking/config.js';
 export { JitoEpochTracker } from './providers/jito-staking/epoch-tracker.js';
+export { AaveV3LendingProvider } from './providers/aave-v3/index.js';
+export { AAVE_V3_DEFAULTS, AAVE_V3_ADDRESSES, getAaveAddresses, AAVE_CHAIN_ID_MAP } from './providers/aave-v3/config.js';
+export { decodeGetUserAccountData, decodeGetReserveData, simulateHealthFactor, rayToApy, hfToNumber, LIQUIDATION_THRESHOLD_HF, WARNING_THRESHOLD_HF } from './providers/aave-v3/aave-rpc.js';
 // Re-export common utilities
 export { ActionApiClient } from './common/action-api-client.js';
 export { asBps, asPct, clampSlippageBps, bpsToPct, pctToBps } from './common/slippage.js';
@@ -32,7 +37,7 @@ export { BRIDGE_STATUS_VALUES, BridgeStatusEnum, } from './common/async-status-t
  * Reads provider config from SettingsReader (DB > config.toml > default fallback chain).
  * Each provider is registered when its `actions.{name}_enabled` setting is 'true'.
  */
-export function registerBuiltInProviders(registry, settingsReader) {
+export function registerBuiltInProviders(registry, settingsReader, options) {
     const loaded = [];
     const skipped = [];
     const providers = [
@@ -119,6 +124,14 @@ export function registerBuiltInProviders(registry, settingsReader) {
                 return new JitoStakingActionProvider(config);
             },
         },
+        {
+            key: 'aave_v3',
+            enabledKey: 'actions.aave_v3_enabled',
+            factory: () => {
+                const config = { enabled: true };
+                return new AaveV3LendingProvider(config, options?.rpcCaller);
+            },
+        },
     ];
     for (const { key, enabledKey, factory } of providers) {
         if (settingsReader.get(enabledKey) === 'true') {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/providers/aave-v3/aave-contracts.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Aave V3 manual hex ABI encoding helpers.
+ *
+ * Manual ABI encoding (no viem dependency) for:
+ * - Pool.supply(address,uint256,address,uint16)
+ * - Pool.borrow(address,uint256,uint256,uint16,address)
+ * - Pool.repay(address,uint256,uint256,address)
+ * - Pool.withdraw(address,uint256,address)
+ * - ERC-20 approve(address,uint256)
+ * - Pool.getUserAccountData(address) [read]
+ * - PoolDataProvider.getReserveData(address) [read]
+ *
+ * Function selectors are hardcoded hex constants derived from keccak256 of function signatures.
+ * Follows the Lido pattern (lido-contract.ts).
+ */
+export declare const AAVE_SELECTORS: {
+    readonly supply: "0x617ba037";
+    readonly borrow: "0xa415bcad";
+    readonly repay: "0x573ade81";
+    readonly withdraw: "0x69328dec";
+    readonly getUserAccountData: "0xbf92857c";
+    readonly getReserveData: "0x35ea6a75";
+    readonly approve: "0x095ea7b3";
+};
+export declare const MAX_UINT256: bigint;
+/**
+ * Encode Aave V3 Pool.supply() calldata.
+ *
+ * @param asset - ERC-20 token address to supply
+ * @param amount - Amount in token's smallest unit (wei for 18-decimal tokens)
+ * @param onBehalfOf - Address to credit the aToken to
+ * @param referralCode - Referral code (defaults to 0)
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export declare function encodeSupplyCalldata(asset: string, amount: bigint, onBehalfOf: string, referralCode?: number): string;
+/**
+ * Encode Aave V3 Pool.borrow() calldata.
+ *
+ * Parameter order matches IPool.sol: (asset, amount, interestRateMode, referralCode, onBehalfOf).
+ *
+ * @param asset - ERC-20 token address to borrow
+ * @param amount - Amount to borrow in token's smallest unit
+ * @param onBehalfOf - Address that will receive the borrowed tokens and incur the debt
+ * @param interestRateMode - 2 = variable (stable is deprecated)
+ * @param referralCode - Referral code (defaults to 0)
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export declare function encodeBorrowCalldata(asset: string, amount: bigint, onBehalfOf: string, interestRateMode?: bigint, referralCode?: number): string;
+/**
+ * Encode Aave V3 Pool.repay() calldata.
+ *
+ * @param asset - ERC-20 token address to repay
+ * @param amount - Amount to repay (use MAX_UINT256 for full repay)
+ * @param onBehalfOf - Address whose debt will be repaid
+ * @param interestRateMode - 2 = variable
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export declare function encodeRepayCalldata(asset: string, amount: bigint, onBehalfOf: string, interestRateMode?: bigint): string;
+/**
+ * Encode Aave V3 Pool.withdraw() calldata.
+ *
+ * @param asset - ERC-20 token address to withdraw
+ * @param amount - Amount to withdraw (use MAX_UINT256 for full withdrawal)
+ * @param to - Address to receive the withdrawn tokens
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export declare function encodeWithdrawCalldata(asset: string, amount: bigint, to: string): string;
+/**
+ * Encode ERC-20 approve(address spender, uint256 amount) calldata.
+ *
+ * @param spender - Spender address to approve
+ * @param amount - Amount to approve in token's smallest unit
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export declare function encodeApproveCalldata(spender: string, amount: bigint): string;
+/**
+ * Encode Pool.getUserAccountData(address) calldata.
+ *
+ * @param user - User address to query
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export declare function encodeGetUserAccountDataCalldata(user: string): string;
+/**
+ * Encode PoolDataProvider.getReserveData(address) calldata.
+ *
+ * @param asset - Asset address to query
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export declare function encodeGetReserveDataCalldata(asset: string): string;
+//# sourceMappingURL=aave-contracts.d.ts.map

package/dist/providers/aave-v3/aave-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave-contracts.d.ts","sourceRoot":"","sources":["../../../src/providers/aave-v3/aave-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAuBH,eAAO,MAAM,cAAc;;;;;;;;CAWjB,CAAC;AAMX,eAAO,MAAM,WAAW,QAAoB,CAAC;AAM7C;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAAU,GACvB,MAAM,CAER;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,gBAAgB,GAAE,MAAW,EAC7B,YAAY,GAAE,MAAU,GACvB,MAAM,CAER;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,gBAAgB,GAAE,MAAW,GAC5B,MAAM,CAER;AAMD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,GACT,MAAM,CAER;AAMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7E;AAMD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErE;AAMD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/dist/providers/aave-v3/aave-contracts.js

@@ -0,0 +1,148 @@
+/**
+ * Aave V3 manual hex ABI encoding helpers.
+ *
+ * Manual ABI encoding (no viem dependency) for:
+ * - Pool.supply(address,uint256,address,uint16)
+ * - Pool.borrow(address,uint256,uint256,uint16,address)
+ * - Pool.repay(address,uint256,uint256,address)
+ * - Pool.withdraw(address,uint256,address)
+ * - ERC-20 approve(address,uint256)
+ * - Pool.getUserAccountData(address) [read]
+ * - PoolDataProvider.getReserveData(address) [read]
+ *
+ * Function selectors are hardcoded hex constants derived from keccak256 of function signatures.
+ * Follows the Lido pattern (lido-contract.ts).
+ */
+// ---------------------------------------------------------------------------
+// Utility: pad a hex value to 32 bytes (64 hex chars)
+// ---------------------------------------------------------------------------
+function padHex(value, length = 64) {
+    return value.padStart(length, '0');
+}
+function addressToHex(address) {
+    return padHex(address.slice(2).toLowerCase());
+}
+function uint256ToHex(value) {
+    if (value < 0n)
+        throw new Error('uint256 cannot be negative');
+    return padHex(value.toString(16));
+}
+// ---------------------------------------------------------------------------
+// Function selectors (verified via keccak256)
+// ---------------------------------------------------------------------------
+export const AAVE_SELECTORS = {
+    // Pool write functions
+    supply: '0x617ba037', // supply(address,uint256,address,uint16)
+    borrow: '0xa415bcad', // borrow(address,uint256,uint256,uint16,address)
+    repay: '0x573ade81', // repay(address,uint256,uint256,address)
+    withdraw: '0x69328dec', // withdraw(address,uint256,address)
+    // Pool read functions
+    getUserAccountData: '0xbf92857c', // getUserAccountData(address)
+    getReserveData: '0x35ea6a75', // getReserveData(address)
+    // ERC-20
+    approve: '0x095ea7b3', // approve(address,uint256)
+};
+// ---------------------------------------------------------------------------
+// MAX_UINT256 sentinel (for full repay/withdraw)
+// ---------------------------------------------------------------------------
+export const MAX_UINT256 = (1n << 256n) - 1n;
+// ---------------------------------------------------------------------------
+// supply(address asset, uint256 amount, address onBehalfOf, uint16 referralCode)
+// ---------------------------------------------------------------------------
+/**
+ * Encode Aave V3 Pool.supply() calldata.
+ *
+ * @param asset - ERC-20 token address to supply
+ * @param amount - Amount in token's smallest unit (wei for 18-decimal tokens)
+ * @param onBehalfOf - Address to credit the aToken to
+ * @param referralCode - Referral code (defaults to 0)
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export function encodeSupplyCalldata(asset, amount, onBehalfOf, referralCode = 0) {
+    return `${AAVE_SELECTORS.supply}${addressToHex(asset)}${uint256ToHex(amount)}${addressToHex(onBehalfOf)}${uint256ToHex(BigInt(referralCode))}`;
+}
+// ---------------------------------------------------------------------------
+// borrow(address asset, uint256 amount, uint256 interestRateMode, uint16 referralCode, address onBehalfOf)
+// ---------------------------------------------------------------------------
+/**
+ * Encode Aave V3 Pool.borrow() calldata.
+ *
+ * Parameter order matches IPool.sol: (asset, amount, interestRateMode, referralCode, onBehalfOf).
+ *
+ * @param asset - ERC-20 token address to borrow
+ * @param amount - Amount to borrow in token's smallest unit
+ * @param onBehalfOf - Address that will receive the borrowed tokens and incur the debt
+ * @param interestRateMode - 2 = variable (stable is deprecated)
+ * @param referralCode - Referral code (defaults to 0)
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export function encodeBorrowCalldata(asset, amount, onBehalfOf, interestRateMode = 2n, referralCode = 0) {
+    return `${AAVE_SELECTORS.borrow}${addressToHex(asset)}${uint256ToHex(amount)}${uint256ToHex(interestRateMode)}${uint256ToHex(BigInt(referralCode))}${addressToHex(onBehalfOf)}`;
+}
+// ---------------------------------------------------------------------------
+// repay(address asset, uint256 amount, uint256 interestRateMode, address onBehalfOf)
+// ---------------------------------------------------------------------------
+/**
+ * Encode Aave V3 Pool.repay() calldata.
+ *
+ * @param asset - ERC-20 token address to repay
+ * @param amount - Amount to repay (use MAX_UINT256 for full repay)
+ * @param onBehalfOf - Address whose debt will be repaid
+ * @param interestRateMode - 2 = variable
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export function encodeRepayCalldata(asset, amount, onBehalfOf, interestRateMode = 2n) {
+    return `${AAVE_SELECTORS.repay}${addressToHex(asset)}${uint256ToHex(amount)}${uint256ToHex(interestRateMode)}${addressToHex(onBehalfOf)}`;
+}
+// ---------------------------------------------------------------------------
+// withdraw(address asset, uint256 amount, address to)
+// ---------------------------------------------------------------------------
+/**
+ * Encode Aave V3 Pool.withdraw() calldata.
+ *
+ * @param asset - ERC-20 token address to withdraw
+ * @param amount - Amount to withdraw (use MAX_UINT256 for full withdrawal)
+ * @param to - Address to receive the withdrawn tokens
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export function encodeWithdrawCalldata(asset, amount, to) {
+    return `${AAVE_SELECTORS.withdraw}${addressToHex(asset)}${uint256ToHex(amount)}${addressToHex(to)}`;
+}
+// ---------------------------------------------------------------------------
+// approve(address spender, uint256 amount) -- ERC-20
+// ---------------------------------------------------------------------------
+/**
+ * Encode ERC-20 approve(address spender, uint256 amount) calldata.
+ *
+ * @param spender - Spender address to approve
+ * @param amount - Amount to approve in token's smallest unit
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export function encodeApproveCalldata(spender, amount) {
+    return `${AAVE_SELECTORS.approve}${addressToHex(spender)}${uint256ToHex(amount)}`;
+}
+// ---------------------------------------------------------------------------
+// getUserAccountData(address user) -- read
+// ---------------------------------------------------------------------------
+/**
+ * Encode Pool.getUserAccountData(address) calldata.
+ *
+ * @param user - User address to query
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export function encodeGetUserAccountDataCalldata(user) {
+    return `${AAVE_SELECTORS.getUserAccountData}${addressToHex(user)}`;
+}
+// ---------------------------------------------------------------------------
+// getReserveData(address asset) -- read
+// ---------------------------------------------------------------------------
+/**
+ * Encode PoolDataProvider.getReserveData(address) calldata.
+ *
+ * @param asset - Asset address to query
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export function encodeGetReserveDataCalldata(asset) {
+    return `${AAVE_SELECTORS.getReserveData}${addressToHex(asset)}`;
+}
+//# sourceMappingURL=aave-contracts.js.map

package/dist/providers/aave-v3/aave-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave-contracts.js","sourceRoot":"","sources":["../../../src/providers/aave-v3/aave-contracts.ts"],"names":[],"mappings":"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"}

package/dist/providers/aave-v3/aave-rpc.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Lightweight RPC caller interface for read-only eth_call operations.
+ * Implementations wrap viem PublicClient or mock in tests.
+ */
+export interface IRpcCaller {
+    call(params: {
+        to: string;
+        data: string;
+        chainId?: number;
+    }): Promise<string>;
+}
+export interface UserAccountData {
+    /** Total collateral in base currency (8 decimals, USD). */
+    totalCollateralBase: bigint;
+    /** Total debt in base currency (8 decimals, USD). */
+    totalDebtBase: bigint;
+    /** Available borrows in base currency (8 decimals, USD). */
+    availableBorrowsBase: bigint;
+    /** Current liquidation threshold in basis points (e.g., 8250 = 82.5%). */
+    currentLiquidationThreshold: bigint;
+    /** Loan-to-value ratio in basis points (e.g., 8000 = 80%). */
+    ltv: bigint;
+    /** Health factor with 18 decimal precision (1e18 = HF 1.0). */
+    healthFactor: bigint;
+}
+export interface ReserveData {
+    /** Current supply rate in ray units (1e27). */
+    liquidityRate: bigint;
+    /** Current variable borrow rate in ray units (1e27). */
+    variableBorrowRate: bigint;
+    /** Liquidity index in ray units. */
+    liquidityIndex: bigint;
+    /** Variable borrow index in ray units. */
+    variableBorrowIndex: bigint;
+}
+/** Health factor at liquidation threshold (1.0 in 18 decimals). */
+export declare const LIQUIDATION_THRESHOLD_HF = 1000000000000000000n;
+/** Health factor warning threshold (1.2 in 18 decimals). */
+export declare const WARNING_THRESHOLD_HF = 1200000000000000000n;
+/**
+ * Decode Pool.getUserAccountData() response.
+ *
+ * Returns 6 uint256 values:
+ * [0] totalCollateralBase (8 decimals, base currency = USD)
+ * [1] totalDebtBase (8 decimals)
+ * [2] availableBorrowsBase (8 decimals)
+ * [3] currentLiquidationThreshold (basis points)
+ * [4] ltv (basis points)
+ * [5] healthFactor (18 decimals)
+ *
+ * @param hexResponse - Raw hex response from eth_call (with or without 0x prefix)
+ * @throws Error if hex string is too short
+ */
+export declare function decodeGetUserAccountData(hexResponse: string): UserAccountData;
+/**
+ * Decode PoolDataProvider.getReserveData() response (simplified).
+ *
+ * Extracts only the fields needed for APY calculation:
+ * - [1] liquidityIndex (index 1 = chars 64..128)
+ * - [2] variableBorrowIndex (index 2 = chars 128..192)
+ * - [3] currentLiquidityRate (index 3 = chars 192..256)
+ * - [4] currentVariableBorrowRate (index 4 = chars 256..320)
+ *
+ * @param hexResponse - Raw hex response from eth_call (with or without 0x prefix)
+ * @throws Error if hex string is too short
+ */
+export declare function decodeGetReserveData(hexResponse: string): ReserveData;
+/**
+ * Convert Aave V3 ray-unit rate to decimal APY.
+ *
+ * Linear approximation: rate / 1e27 (good enough for display at typical DeFi rates).
+ * Returns as decimal (e.g., 0.035 for 3.5% APY).
+ *
+ * @param rayRate - Rate in ray units (1e27)
+ */
+export declare function rayToApy(rayRate: bigint): number;
+/**
+ * Simulate health factor after a borrow or withdraw action.
+ *
+ * Uses bigint-only arithmetic for precision (Research Flag C2).
+ * Returns MAX_UINT256 when newTotalDebt is 0 (no debt = infinite HF).
+ *
+ * @param currentData - Current position data from getUserAccountData
+ * @param action - 'borrow' or 'withdraw'
+ * @param amountBase - Amount in base currency (8 decimals, USD)
+ * @returns Simulated health factor as 18-decimal bigint
+ */
+export declare function simulateHealthFactor(currentData: {
+    totalCollateralBase: bigint;
+    totalDebtBase: bigint;
+    currentLiquidationThreshold: bigint;
+}, action: 'borrow' | 'withdraw', amountBase: bigint): bigint;
+/**
+ * Convert 18-decimal bigint health factor to a display number.
+ *
+ * This is ONLY for API display responses, NOT for threshold comparisons.
+ * Use bigint comparisons (e.g., hf >= LIQUIDATION_THRESHOLD_HF) for safety checks.
+ *
+ * @param hf - Health factor as 18-decimal bigint
+ */
+export declare function hfToNumber(hf: bigint): number;
+//# sourceMappingURL=aave-rpc.d.ts.map

package/dist/providers/aave-v3/aave-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave-rpc.d.ts","sourceRoot":"","sources":["../../../src/providers/aave-v3/aave-rpc.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/E;AAMD,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0EAA0E;IAC1E,2BAA2B,EAAE,MAAM,CAAC;IACpC,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAMD,mEAAmE;AACnE,eAAO,MAAM,wBAAwB,uBAA6B,CAAC;AAEnE,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,uBAA6B,CAAC;AAM/D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAiB7E;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAerE;AAMD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhD;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE;IACX,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B,EAAE,MAAM,CAAC;CACrC,EACD,MAAM,EAAE,QAAQ,GAAG,UAAU,EAC7B,UAAU,EAAE,MAAM,GACjB,MAAM,CAmBR;AAMD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/providers/aave-v3/aave-rpc.js

@@ -0,0 +1,134 @@
+/**
+ * Aave V3 RPC response decoders, health factor simulation, and APY conversion.
+ *
+ * Pure functions operating on hex strings and bigints -- no actual RPC calls here.
+ * The IRpcCaller interface is the injection point for real RPC or mock in tests.
+ *
+ * IMPORTANT: All health factor threshold comparisons use bigint arithmetic.
+ * Never convert to Number for safety-critical HF checks (Research Flag C2).
+ */
+import { MAX_UINT256 } from './aave-contracts.js';
+// ---------------------------------------------------------------------------
+// Health factor threshold constants (18-decimal bigints)
+// ---------------------------------------------------------------------------
+/** Health factor at liquidation threshold (1.0 in 18 decimals). */
+export const LIQUIDATION_THRESHOLD_HF = 1000000000000000000n;
+/** Health factor warning threshold (1.2 in 18 decimals). */
+export const WARNING_THRESHOLD_HF = 1200000000000000000n;
+// ---------------------------------------------------------------------------
+// decodeGetUserAccountData -- parse 6 x uint256 from hex response
+// ---------------------------------------------------------------------------
+/**
+ * Decode Pool.getUserAccountData() response.
+ *
+ * Returns 6 uint256 values:
+ * [0] totalCollateralBase (8 decimals, base currency = USD)
+ * [1] totalDebtBase (8 decimals)
+ * [2] availableBorrowsBase (8 decimals)
+ * [3] currentLiquidationThreshold (basis points)
+ * [4] ltv (basis points)
+ * [5] healthFactor (18 decimals)
+ *
+ * @param hexResponse - Raw hex response from eth_call (with or without 0x prefix)
+ * @throws Error if hex string is too short
+ */
+export function decodeGetUserAccountData(hexResponse) {
+    const data = hexResponse.startsWith('0x') ? hexResponse.slice(2) : hexResponse;
+    if (data.length < 384) {
+        throw new Error(`Invalid getUserAccountData response: expected at least 384 hex chars (6 x 32 bytes), got ${data.length}`);
+    }
+    return {
+        totalCollateralBase: BigInt('0x' + data.slice(0, 64)),
+        totalDebtBase: BigInt('0x' + data.slice(64, 128)),
+        availableBorrowsBase: BigInt('0x' + data.slice(128, 192)),
+        currentLiquidationThreshold: BigInt('0x' + data.slice(192, 256)),
+        ltv: BigInt('0x' + data.slice(256, 320)),
+        healthFactor: BigInt('0x' + data.slice(320, 384)),
+    };
+}
+// ---------------------------------------------------------------------------
+// decodeGetReserveData -- extract rate fields from hex response
+// ---------------------------------------------------------------------------
+/**
+ * Decode PoolDataProvider.getReserveData() response (simplified).
+ *
+ * Extracts only the fields needed for APY calculation:
+ * - [1] liquidityIndex (index 1 = chars 64..128)
+ * - [2] variableBorrowIndex (index 2 = chars 128..192)
+ * - [3] currentLiquidityRate (index 3 = chars 192..256)
+ * - [4] currentVariableBorrowRate (index 4 = chars 256..320)
+ *
+ * @param hexResponse - Raw hex response from eth_call (with or without 0x prefix)
+ * @throws Error if hex string is too short
+ */
+export function decodeGetReserveData(hexResponse) {
+    const data = hexResponse.startsWith('0x') ? hexResponse.slice(2) : hexResponse;
+    if (data.length < 320) {
+        throw new Error(`Invalid getReserveData response: expected at least 320 hex chars (5 x 32 bytes), got ${data.length}`);
+    }
+    return {
+        liquidityIndex: BigInt('0x' + data.slice(64, 128)),
+        variableBorrowIndex: BigInt('0x' + data.slice(128, 192)),
+        liquidityRate: BigInt('0x' + data.slice(192, 256)),
+        variableBorrowRate: BigInt('0x' + data.slice(256, 320)),
+    };
+}
+// ---------------------------------------------------------------------------
+// rayToApy -- convert ray (1e27) rate to decimal APY
+// ---------------------------------------------------------------------------
+/**
+ * Convert Aave V3 ray-unit rate to decimal APY.
+ *
+ * Linear approximation: rate / 1e27 (good enough for display at typical DeFi rates).
+ * Returns as decimal (e.g., 0.035 for 3.5% APY).
+ *
+ * @param rayRate - Rate in ray units (1e27)
+ */
+export function rayToApy(rayRate) {
+    return Number(rayRate) / 1e27;
+}
+// ---------------------------------------------------------------------------
+// simulateHealthFactor -- pre-action HF estimation
+// ---------------------------------------------------------------------------
+/**
+ * Simulate health factor after a borrow or withdraw action.
+ *
+ * Uses bigint-only arithmetic for precision (Research Flag C2).
+ * Returns MAX_UINT256 when newTotalDebt is 0 (no debt = infinite HF).
+ *
+ * @param currentData - Current position data from getUserAccountData
+ * @param action - 'borrow' or 'withdraw'
+ * @param amountBase - Amount in base currency (8 decimals, USD)
+ * @returns Simulated health factor as 18-decimal bigint
+ */
+export function simulateHealthFactor(currentData, action, amountBase) {
+    let collateral = currentData.totalCollateralBase;
+    let newTotalDebt = currentData.totalDebtBase;
+    if (action === 'borrow') {
+        newTotalDebt = currentData.totalDebtBase + amountBase;
+    }
+    else {
+        // withdraw reduces collateral
+        collateral = currentData.totalCollateralBase - amountBase;
+    }
+    const collateralThresholdAdjusted = (collateral * currentData.currentLiquidationThreshold) / 10000n;
+    if (newTotalDebt === 0n) {
+        return MAX_UINT256;
+    }
+    return (collateralThresholdAdjusted * 10n ** 18n) / newTotalDebt;
+}
+// ---------------------------------------------------------------------------
+// hfToNumber -- convert 18-decimal bigint HF to display number
+// ---------------------------------------------------------------------------
+/**
+ * Convert 18-decimal bigint health factor to a display number.
+ *
+ * This is ONLY for API display responses, NOT for threshold comparisons.
+ * Use bigint comparisons (e.g., hf >= LIQUIDATION_THRESHOLD_HF) for safety checks.
+ *
+ * @param hf - Health factor as 18-decimal bigint
+ */
+export function hfToNumber(hf) {
+    return Number(hf) / 1e18;
+}
+//# sourceMappingURL=aave-rpc.js.map