@waiaas/actions 2.6.0-rc.9 → 2.6.0

package/dist/providers/lido-staking/lido-contract.js

@@ -0,0 +1,83 @@
+/**
+ * Lido contract ABI encoding helpers.
+ *
+ * Manual ABI encoding (no viem dependency) for:
+ * - stETH submit(address _referral)
+ * - WithdrawalQueue requestWithdrawals(uint256[] _amounts, address _owner)
+ * - ERC-20 approve(address spender, uint256 amount)
+ *
+ * Function selectors are hardcoded hex constants derived from keccak256 of function signatures.
+ */
+// ---------------------------------------------------------------------------
+// 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));
+}
+// ---------------------------------------------------------------------------
+// submit(address _referral) -- function selector 0xa1903eab
+// ---------------------------------------------------------------------------
+/**
+ * Encode Lido stETH submit(address _referral) calldata.
+ * ETH value is sent as transaction value, not encoded in calldata.
+ *
+ * @param referral - Referral address (defaults to zero address)
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export function encodeSubmitCalldata(referral = '0x0000000000000000000000000000000000000000') {
+    const selector = '0xa1903eab';
+    const paddedReferral = addressToHex(referral);
+    return `${selector}${paddedReferral}`;
+}
+// ---------------------------------------------------------------------------
+// requestWithdrawals(uint256[] _amounts, address _owner) -- 0xd669a4e2
+// ---------------------------------------------------------------------------
+/**
+ * Encode Lido WithdrawalQueue requestWithdrawals(uint256[], address) calldata.
+ *
+ * ABI layout:
+ *   selector (4 bytes)
+ *   offset to amounts array (32 bytes) = 0x40 (64 decimal)
+ *   owner address (32 bytes)
+ *   array length (32 bytes)
+ *   array element 0 (32 bytes)
+ *   ... array element N (32 bytes)
+ *
+ * @param amounts - Array of stETH withdrawal amounts in wei
+ * @param owner - Address to receive the withdrawal NFT
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export function encodeRequestWithdrawalsCalldata(amounts, owner) {
+    const selector = '0xd669a4e2';
+    // offset to dynamic array = 0x40 (2 * 32 bytes: offset slot + owner slot)
+    const offsetHex = uint256ToHex(64n);
+    const ownerHex = addressToHex(owner);
+    const lengthHex = uint256ToHex(BigInt(amounts.length));
+    const elementsHex = amounts.map((a) => uint256ToHex(a)).join('');
+    return `${selector}${offsetHex}${ownerHex}${lengthHex}${elementsHex}`;
+}
+// ---------------------------------------------------------------------------
+// approve(address spender, uint256 amount) -- 0x095ea7b3
+// ---------------------------------------------------------------------------
+/**
+ * Encode ERC-20 approve(address spender, uint256 amount) calldata.
+ *
+ * @param spender - Spender address to approve
+ * @param amount - Amount to approve in wei
+ * @returns ABI-encoded calldata with 0x prefix
+ */
+export function encodeApproveCalldata(spender, amount) {
+    const selector = '0x095ea7b3';
+    const paddedSpender = addressToHex(spender);
+    const paddedAmount = uint256ToHex(amount);
+    return `${selector}${paddedSpender}${paddedAmount}`;
+}
+//# sourceMappingURL=lido-contract.js.map

package/dist/providers/lido-staking/lido-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lido-contract.js","sourceRoot":"","sources":["../../../src/providers/lido-staking/lido-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8EAA8E;AAC9E,sDAAsD;AACtD,8EAA8E;AAE9E,SAAS,MAAM,CAAC,KAAa,EAAE,SAAiB,EAAE;IAChD,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,YAAY,CAAC,OAAe;IACnC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,KAAK,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,8EAA8E;AAC9E,4DAA4D;AAC5D,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAmB,4CAA4C;IAE/D,MAAM,QAAQ,GAAG,YAAY,CAAC;IAC9B,MAAM,cAAc,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,GAAG,QAAQ,GAAG,cAAc,EAAE,CAAC;AACxC,CAAC;AAED,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAAiB,EACjB,KAAa;IAEb,MAAM,QAAQ,GAAG,YAAY,CAAC;IAE9B,0EAA0E;IAC1E,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEjE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,EAAE,CAAC;AACxE,CAAC;AAED,8EAA8E;AAC9E,yDAAyD;AACzD,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,MAAc;IACnE,MAAM,QAAQ,GAAG,YAAY,CAAC;IAC9B,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,EAAE,CAAC;AACtD,CAAC"}

package/dist/providers/lido-staking/withdrawal-tracker.d.ts

@@ -0,0 +1,21 @@
+/**
+ * LidoWithdrawalTracker - IAsyncStatusTracker for Lido withdrawal queue.
+ *
+ * Tracks Lido unstake requests via metadata-based polling (v1 implementation).
+ * Active polling: 30s x 480 = 4 hours, then TIMEOUT (terminal).
+ *
+ * Lido withdrawals typically take 1-5 days. This tracker monitors metadata
+ * state (set by external claim detection or manual status update) and emits
+ * STAKING_UNSTAKE_COMPLETED or STAKING_UNSTAKE_TIMEOUT notifications.
+ *
+ * @see packages/actions/src/common/async-status-tracker.ts
+ */
+import type { IAsyncStatusTracker, AsyncTrackingResult } from '../../common/async-status-tracker.js';
+export declare class LidoWithdrawalTracker implements IAsyncStatusTracker {
+    readonly name = "lido-withdrawal";
+    readonly maxAttempts = 480;
+    readonly pollIntervalMs = 30000;
+    readonly timeoutTransition: "TIMEOUT";
+    checkStatus(_txId: string, metadata: Record<string, unknown>): Promise<AsyncTrackingResult>;
+}
+//# sourceMappingURL=withdrawal-tracker.d.ts.map

package/dist/providers/lido-staking/withdrawal-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdrawal-tracker.d.ts","sourceRoot":"","sources":["../../../src/providers/lido-staking/withdrawal-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAKrG,qBAAa,qBAAsB,YAAW,mBAAmB;IAC/D,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,WAAW,OAAO;IAC3B,QAAQ,CAAC,cAAc,SAAU;IACjC,QAAQ,CAAC,iBAAiB,EAAG,SAAS,CAAU;IAE1C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA2BlG"}

package/dist/providers/lido-staking/withdrawal-tracker.js

@@ -0,0 +1,46 @@
+/**
+ * LidoWithdrawalTracker - IAsyncStatusTracker for Lido withdrawal queue.
+ *
+ * Tracks Lido unstake requests via metadata-based polling (v1 implementation).
+ * Active polling: 30s x 480 = 4 hours, then TIMEOUT (terminal).
+ *
+ * Lido withdrawals typically take 1-5 days. This tracker monitors metadata
+ * state (set by external claim detection or manual status update) and emits
+ * STAKING_UNSTAKE_COMPLETED or STAKING_UNSTAKE_TIMEOUT notifications.
+ *
+ * @see packages/actions/src/common/async-status-tracker.ts
+ */
+/** Days after which a Lido withdrawal is considered overdue for timeout hint. */
+const LIDO_EXPECTED_DAYS = 5;
+export class LidoWithdrawalTracker {
+    name = 'lido-withdrawal';
+    maxAttempts = 480; // 480 x 30s = 4 hours active polling
+    pollIntervalMs = 30_000; // 30 seconds
+    timeoutTransition = 'TIMEOUT';
+    async checkStatus(_txId, metadata) {
+        // If metadata.status is already 'claimable', withdrawal is complete
+        if (metadata.status === 'claimable') {
+            return {
+                state: 'COMPLETED',
+                details: {
+                    completedAt: Date.now(),
+                    protocol: 'lido',
+                    notificationEvent: 'STAKING_UNSTAKE_COMPLETED',
+                },
+            };
+        }
+        // Calculate estimated days remaining based on withdrawal request time
+        const requestedAt = metadata.withdrawalRequestedAt;
+        const estimatedDaysRemaining = requestedAt
+            ? Math.max(0, LIDO_EXPECTED_DAYS - (Date.now() - requestedAt) / (1000 * 60 * 60 * 24))
+            : LIDO_EXPECTED_DAYS;
+        return {
+            state: 'PENDING',
+            details: {
+                estimatedDaysRemaining: Math.round(estimatedDaysRemaining * 10) / 10,
+                protocol: 'lido',
+            },
+        };
+    }
+}
+//# sourceMappingURL=withdrawal-tracker.js.map

package/dist/providers/lido-staking/withdrawal-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdrawal-tracker.js","sourceRoot":"","sources":["../../../src/providers/lido-staking/withdrawal-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,iFAAiF;AACjF,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,MAAM,OAAO,qBAAqB;IACvB,IAAI,GAAG,iBAAiB,CAAC;IACzB,WAAW,GAAG,GAAG,CAAC,CAAU,qCAAqC;IACjE,cAAc,GAAG,MAAM,CAAC,CAAI,aAAa;IACzC,iBAAiB,GAAG,SAAkB,CAAC;IAEhD,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,QAAiC;QAChE,oEAAoE;QACpE,IAAI,QAAQ,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACpC,OAAO;gBACL,KAAK,EAAE,WAAW;gBAClB,OAAO,EAAE;oBACP,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;oBACvB,QAAQ,EAAE,MAAM;oBAChB,iBAAiB,EAAE,2BAA2B;iBAC/C;aACF,CAAC;QACJ,CAAC;QAED,sEAAsE;QACtE,MAAM,WAAW,GAAG,QAAQ,CAAC,qBAA2C,CAAC;QACzE,MAAM,sBAAsB,GAAG,WAAW;YACxC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YACtF,CAAC,CAAC,kBAAkB,CAAC;QAEvB,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE;gBACP,sBAAsB,EAAE,IAAI,CAAC,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,GAAG,EAAE;gBACpE,QAAQ,EAAE,MAAM;aACjB;SACF,CAAC;IACJ,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waiaas/actions",
-  "version": "2.6.0-rc.9",
+  "version": "2.6.0",
   "description": "WAIaaS built-in DeFi Action Provider implementations",
   "license": "MIT",
   "type": "module",
@@ -29,7 +29,7 @@
   ],
   "dependencies": {
     "zod": "^3.24.0",
-    "@waiaas/core": "2.6.0-rc.9"
+    "@waiaas/core": "2.6.0"
   },
   "devDependencies": {
     "@types/node": "^25.2.3",