@waiaas/actions 2.6.0-rc.9 → 2.6.0

package/dist/providers/jito-staking/jito-stake-pool.js

@@ -0,0 +1,355 @@
+/**
+ * SPL Stake Pool instruction encoding for Jito.
+ *
+ * Builds DepositSol and WithdrawSol instructions locally using zero external
+ * Solana SDK dependencies. Uses Node.js `node:crypto` for PDA derivation.
+ *
+ * The SolanaAdapter reconstructs TransactionInstructions from `programId`,
+ * `instructionData` (base64), and `accounts` -- so the provider must supply
+ * all resolved addresses.
+ *
+ * SPL Stake Pool instruction indices:
+ * - DepositSol = 14
+ * - WithdrawSol = 16
+ */
+import { createHash } from 'node:crypto';
+import { JITO_WITHDRAW_AUTHORITY, JITO_RESERVE_STAKE, JITO_MANAGER_FEE, SPL_TOKEN_PROGRAM, SYSTEM_PROGRAM, } from './config.js';
+// Re-export ChainError dynamically to avoid circular issues
+let _ChainError;
+async function getChainError() {
+    if (!_ChainError) {
+        const mod = await import('@waiaas/core');
+        _ChainError = mod.ChainError;
+    }
+    return _ChainError;
+}
+// ---------------------------------------------------------------------------
+// Base58 encoder/decoder (Bitcoin alphabet)
+// ---------------------------------------------------------------------------
+const BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+const BASE58_MAP = new Uint8Array(128);
+for (let i = 0; i < 128; i++)
+    BASE58_MAP[i] = 255;
+for (let i = 0; i < 58; i++)
+    BASE58_MAP[BASE58_ALPHABET.charCodeAt(i)] = i;
+/**
+ * Decode a base58 string to bytes.
+ */
+export function base58Decode(str) {
+    if (str.length === 0)
+        return new Uint8Array(0);
+    // Count leading '1's (they represent leading zero bytes)
+    let leadingZeros = 0;
+    for (let i = 0; i < str.length && str[i] === '1'; i++)
+        leadingZeros++;
+    // Allocate enough space (base58 is ~log(256)/log(58) ratio)
+    const size = Math.ceil((str.length * 733) / 1000) + 1;
+    const b256 = new Uint8Array(size);
+    for (let i = leadingZeros; i < str.length; i++) {
+        const ch = str.charCodeAt(i);
+        const digit = ch < 128 ? BASE58_MAP[ch] : 255;
+        if (digit === 255)
+            throw new Error(`Invalid base58 character: ${str[i]}`);
+        let carry = digit;
+        for (let j = size - 1; j >= 0; j--) {
+            carry += 58 * b256[j];
+            b256[j] = carry % 256;
+            carry = Math.floor(carry / 256);
+        }
+    }
+    // Skip leading zeros in b256 that are not part of the result
+    let start = 0;
+    while (start < size && b256[start] === 0)
+        start++;
+    const result = new Uint8Array(leadingZeros + (size - start));
+    for (let i = 0; i < leadingZeros; i++)
+        result[i] = 0;
+    for (let i = start; i < size; i++)
+        result[leadingZeros + i - start] = b256[i];
+    return result;
+}
+/**
+ * Encode bytes to a base58 string.
+ */
+export function base58Encode(bytes) {
+    if (bytes.length === 0)
+        return '';
+    // Count leading zeros
+    let leadingZeros = 0;
+    for (let i = 0; i < bytes.length && bytes[i] === 0; i++)
+        leadingZeros++;
+    // Allocate enough space
+    const size = Math.ceil((bytes.length * 138) / 100) + 1;
+    const b58 = new Uint8Array(size);
+    for (let i = leadingZeros; i < bytes.length; i++) {
+        let carry = bytes[i];
+        for (let j = size - 1; j >= 0; j--) {
+            carry += 256 * b58[j];
+            b58[j] = carry % 58;
+            carry = Math.floor(carry / 58);
+        }
+    }
+    // Skip leading zeros in b58
+    let start = 0;
+    while (start < size && b58[start] === 0)
+        start++;
+    let result = '1'.repeat(leadingZeros);
+    for (let i = start; i < size; i++) {
+        result += BASE58_ALPHABET[b58[i]];
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Ed25519 on-curve check + PDA derivation
+// ---------------------------------------------------------------------------
+// Ed25519 prime: p = 2^255 - 19
+const ED25519_P = (1n << 255n) - 19n;
+// Ed25519 curve constant d = -121665/121666 mod p
+// d = -121665 * modInverse(121666, p) mod p
+const ED25519_D = 37095705934669439343138083508754565189542113879843219016388785533085940283555n;
+/**
+ * Modular exponentiation: base^exp mod m using square-and-multiply.
+ */
+function modPow(base, exp, m) {
+    let result = 1n;
+    base = ((base % m) + m) % m;
+    while (exp > 0n) {
+        if (exp & 1n)
+            result = (result * base) % m;
+        exp >>= 1n;
+        base = (base * base) % m;
+    }
+    return result;
+}
+/**
+ * Check if a 32-byte compressed Ed25519 point represents a valid curve point.
+ *
+ * Ed25519 encoding: 32 bytes, little-endian y-coordinate, high bit of last byte = sign of x.
+ * A point is on curve if we can recover x from y using: x^2 = (y^2 - 1) / (d*y^2 + 1) mod p
+ * and the square root exists.
+ */
+function isOnCurve(point) {
+    if (point.length !== 32)
+        return false;
+    // Decode y from little-endian bytes (clear the sign bit from the last byte)
+    const lastByte = point[31];
+    const yBytes = new Uint8Array(point);
+    yBytes[31] = lastByte & 0x7f; // clear sign bit
+    let y = 0n;
+    for (let i = 0; i < 32; i++) {
+        y |= BigInt(yBytes[i]) << BigInt(i * 8);
+    }
+    // y must be < p
+    if (y >= ED25519_P)
+        return false;
+    // Compute x^2 = (y^2 - 1) / (d*y^2 + 1) mod p
+    const y2 = (y * y) % ED25519_P;
+    const numerator = ((y2 - 1n) % ED25519_P + ED25519_P) % ED25519_P;
+    const denominator = ((ED25519_D * y2 + 1n) % ED25519_P + ED25519_P) % ED25519_P;
+    // denominator inverse: denom^(p-2) mod p (Fermat's little theorem)
+    const denomInv = modPow(denominator, ED25519_P - 2n, ED25519_P);
+    const x2 = (numerator * denomInv) % ED25519_P;
+    if (x2 === 0n) {
+        // x = 0, valid if sign bit is 0
+        return (lastByte & 0x80) === 0;
+    }
+    // Check if x^2 has a square root mod p
+    // x = x2^((p+3)/8) mod p (since p ≡ 5 mod 8)
+    const x = modPow(x2, (ED25519_P + 3n) / 8n, ED25519_P);
+    if ((x * x) % ED25519_P === x2)
+        return true;
+    // Try x * sqrt(-1): sqrt(-1) = 2^((p-1)/4) mod p
+    const sqrtM1 = modPow(2n, (ED25519_P - 1n) / 4n, ED25519_P);
+    const x2Alt = (x * sqrtM1) % ED25519_P;
+    return (x2Alt * x2Alt) % ED25519_P === x2;
+}
+/**
+ * Find a program-derived address (PDA) for the given seeds and program ID.
+ *
+ * @param seeds - Array of seed buffers
+ * @param programId - Program ID as bytes (32 bytes)
+ * @returns [address_bytes (32), bump (number)]
+ */
+export async function findProgramAddress(seeds, programId) {
+    const PDA_MARKER = new TextEncoder().encode('ProgramDerivedAddress');
+    for (let bump = 255; bump >= 0; bump--) {
+        const hashInput = [
+            ...seeds,
+            new Uint8Array([bump]),
+            programId,
+            PDA_MARKER,
+        ];
+        // Concatenate all parts
+        let totalLen = 0;
+        for (const part of hashInput)
+            totalLen += part.length;
+        const buffer = new Uint8Array(totalLen);
+        let offset = 0;
+        for (const part of hashInput) {
+            buffer.set(part, offset);
+            offset += part.length;
+        }
+        const hash = createHash('sha256').update(buffer).digest();
+        const hashBytes = new Uint8Array(hash);
+        if (!isOnCurve(hashBytes)) {
+            return [hashBytes, bump];
+        }
+    }
+    throw new Error('Could not find a valid PDA');
+}
+// ---------------------------------------------------------------------------
+// Associated Token Address derivation
+// ---------------------------------------------------------------------------
+/** Associated Token Account Program ID. */
+const ATA_PROGRAM_ID = 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL';
+/**
+ * Derive the Associated Token Address (ATA) for a wallet and mint.
+ *
+ * @param wallet - Wallet public key (base58)
+ * @param mint - Token mint address (base58)
+ * @param tokenProgram - Token program ID (base58), defaults to SPL Token
+ * @returns ATA public key as base58 string
+ */
+export async function getAssociatedTokenAddress(wallet, mint, tokenProgram = SPL_TOKEN_PROGRAM) {
+    const walletBytes = base58Decode(wallet);
+    const mintBytes = base58Decode(mint);
+    const tokenProgramBytes = base58Decode(tokenProgram);
+    const ataProgramBytes = base58Decode(ATA_PROGRAM_ID);
+    const [address] = await findProgramAddress([walletBytes, tokenProgramBytes, mintBytes], ataProgramBytes);
+    return base58Encode(address);
+}
+// ---------------------------------------------------------------------------
+// Instruction data encoding
+// ---------------------------------------------------------------------------
+/**
+ * Encode DepositSol instruction data (index 14 + LE u64 amount).
+ * @returns base64-encoded instruction data
+ */
+export function encodeDepositSolData(amountLamports) {
+    const buffer = new Uint8Array(9); // 1 byte index + 8 bytes u64
+    buffer[0] = 14; // DepositSol instruction index
+    const view = new DataView(buffer.buffer);
+    view.setBigUint64(1, amountLamports, true); // little-endian
+    return Buffer.from(buffer).toString('base64');
+}
+/**
+ * Encode WithdrawSol instruction data (index 16 + LE u64 amount).
+ * @returns base64-encoded instruction data
+ */
+export function encodeWithdrawSolData(amountLamports) {
+    const buffer = new Uint8Array(9); // 1 byte index + 8 bytes u64
+    buffer[0] = 16; // WithdrawSol instruction index
+    const view = new DataView(buffer.buffer);
+    view.setBigUint64(1, amountLamports, true); // little-endian
+    return Buffer.from(buffer).toString('base64');
+}
+// ---------------------------------------------------------------------------
+// Amount parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parse a human-readable SOL amount string to lamports (bigint).
+ * SOL has 9 decimals (not 18 like ETH).
+ *
+ * "1.5" -> 1500000000n (1.5 SOL in lamports)
+ *
+ * @throws ChainError if amount is zero or negative
+ */
+export async function parseSolAmount(amount) {
+    const parts = amount.split('.');
+    const whole = BigInt(parts[0] || '0');
+    const decimals = (parts[1] || '').padEnd(9, '0').slice(0, 9);
+    const result = whole * 10n ** 9n + BigInt(decimals);
+    if (result <= 0n) {
+        const ChainError = await getChainError();
+        throw new ChainError('INVALID_INSTRUCTION', 'solana', {
+            message: 'Amount must be greater than 0',
+        });
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Sysvar and program addresses for WithdrawSol
+// ---------------------------------------------------------------------------
+const CLOCK_SYSVAR = 'SysvarC1ock11111111111111111111111111111111';
+const STAKE_HISTORY_SYSVAR = 'SysvarStakeHistory1111111111111111111111111';
+const STAKE_PROGRAM = 'Stake11111111111111111111111111111111111111';
+/**
+ * Build a ContractCallRequest for SPL Stake Pool DepositSol.
+ *
+ * SPL Stake Pool DepositSol accounts (in order):
+ * 0. stakePool (writable)
+ * 1. withdrawAuthority (PDA, read-only)
+ * 2. reserveStake (writable)
+ * 3. fundingAccount (signer, writable) = wallet
+ * 4. destTokenAccount (writable) = wallet's JitoSOL ATA
+ * 5. managerFeeAccount (writable)
+ * 6. referralFeeAccount (writable) = same as managerFeeAccount (no referral)
+ * 7. poolMint (writable) = JitoSOL mint
+ * 8. systemProgram (read-only)
+ * 9. tokenProgram (read-only)
+ */
+export async function buildDepositSolRequest(config, amountLamports, walletAddress) {
+    const destTokenAccount = await getAssociatedTokenAddress(walletAddress, config.jitosolMint, SPL_TOKEN_PROGRAM);
+    const accounts = [
+        { pubkey: config.stakePoolAddress, isSigner: false, isWritable: true },
+        { pubkey: JITO_WITHDRAW_AUTHORITY, isSigner: false, isWritable: false },
+        { pubkey: JITO_RESERVE_STAKE, isSigner: false, isWritable: true },
+        { pubkey: walletAddress, isSigner: true, isWritable: true },
+        { pubkey: destTokenAccount, isSigner: false, isWritable: true },
+        { pubkey: JITO_MANAGER_FEE, isSigner: false, isWritable: true },
+        { pubkey: JITO_MANAGER_FEE, isSigner: false, isWritable: true }, // referral = manager (no referral)
+        { pubkey: config.jitosolMint, isSigner: false, isWritable: true },
+        { pubkey: SYSTEM_PROGRAM, isSigner: false, isWritable: false },
+        { pubkey: SPL_TOKEN_PROGRAM, isSigner: false, isWritable: false },
+    ];
+    return {
+        type: 'CONTRACT_CALL',
+        to: config.stakePoolAddress,
+        programId: config.stakePoolProgram,
+        instructionData: encodeDepositSolData(amountLamports),
+        accounts,
+        value: amountLamports.toString(),
+    };
+}
+/**
+ * Build a ContractCallRequest for SPL Stake Pool WithdrawSol.
+ *
+ * SPL Stake Pool WithdrawSol accounts (in order):
+ * 0. stakePool (writable)
+ * 1. withdrawAuthority (PDA, read-only)
+ * 2. userTransferAuthority (signer) = wallet
+ * 3. sourceTokenAccount (writable) = wallet's JitoSOL ATA
+ * 4. reserveStake (writable)
+ * 5. destSolAccount (writable) = wallet (receives SOL)
+ * 6. managerFeeAccount (writable)
+ * 7. poolMint (writable) = JitoSOL mint
+ * 8. clock (read-only)
+ * 9. stakeHistory (read-only)
+ * 10. stakeProgram (read-only)
+ * 11. tokenProgram (read-only)
+ */
+export async function buildWithdrawSolRequest(config, amountLamports, walletAddress) {
+    const sourceTokenAccount = await getAssociatedTokenAddress(walletAddress, config.jitosolMint, SPL_TOKEN_PROGRAM);
+    const accounts = [
+        { pubkey: config.stakePoolAddress, isSigner: false, isWritable: true },
+        { pubkey: JITO_WITHDRAW_AUTHORITY, isSigner: false, isWritable: false },
+        { pubkey: walletAddress, isSigner: true, isWritable: false },
+        { pubkey: sourceTokenAccount, isSigner: false, isWritable: true },
+        { pubkey: JITO_RESERVE_STAKE, isSigner: false, isWritable: true },
+        { pubkey: walletAddress, isSigner: false, isWritable: true },
+        { pubkey: JITO_MANAGER_FEE, isSigner: false, isWritable: true },
+        { pubkey: config.jitosolMint, isSigner: false, isWritable: true },
+        { pubkey: CLOCK_SYSVAR, isSigner: false, isWritable: false },
+        { pubkey: STAKE_HISTORY_SYSVAR, isSigner: false, isWritable: false },
+        { pubkey: STAKE_PROGRAM, isSigner: false, isWritable: false },
+        { pubkey: SPL_TOKEN_PROGRAM, isSigner: false, isWritable: false },
+    ];
+    return {
+        type: 'CONTRACT_CALL',
+        to: config.stakePoolAddress,
+        programId: config.stakePoolProgram,
+        instructionData: encodeWithdrawSolData(amountLamports),
+        accounts,
+    };
+}
+//# sourceMappingURL=jito-stake-pool.js.map

package/dist/providers/jito-staking/jito-stake-pool.js.map

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

package/dist/providers/lido-staking/config.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Lido Staking configuration type, defaults, and contract address maps.
+ *
+ * Supports Ethereum mainnet and Holesky testnet.
+ * See: https://docs.lido.fi/deployed-contracts/
+ */
+export interface LidoStakingConfig {
+    enabled: boolean;
+    stethAddress: string;
+    withdrawalQueueAddress: string;
+}
+export declare const LIDO_MAINNET_ADDRESSES: {
+    readonly stethAddress: "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84";
+    readonly withdrawalQueueAddress: "0x889edC2eDab5f40e902b864aD4d7AdE8E412F9B1";
+};
+export declare const LIDO_TESTNET_ADDRESSES: {
+    readonly stethAddress: "0x3F1c547b21f65e10480dE3ad8E19fAAC46C95034";
+    readonly withdrawalQueueAddress: "0xc7cc160b58F8Bb0baC94b80847E2CF2800565C50";
+};
+export declare const LIDO_STAKING_DEFAULTS: LidoStakingConfig;
+/**
+ * Get Lido contract addresses for a given environment type.
+ * @param environment - 'mainnet' or 'testnet'
+ */
+export declare function getLidoAddresses(environment: 'mainnet' | 'testnet'): {
+    stethAddress: string;
+    withdrawalQueueAddress: string;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/providers/lido-staking/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/providers/lido-staking/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAMD,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC;AAMX,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC;AAMX,eAAO,MAAM,qBAAqB,EAAE,iBAGnC,CAAC;AAMF;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,SAAS,GAAG,SAAS,GACjC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,sBAAsB,EAAE,MAAM,CAAA;CAAE,CAI1D"}

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

@@ -0,0 +1,40 @@
+/**
+ * Lido Staking configuration type, defaults, and contract address maps.
+ *
+ * Supports Ethereum mainnet and Holesky testnet.
+ * See: https://docs.lido.fi/deployed-contracts/
+ */
+// ---------------------------------------------------------------------------
+// Mainnet addresses (Ethereum)
+// ---------------------------------------------------------------------------
+export const LIDO_MAINNET_ADDRESSES = {
+    stethAddress: '0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84',
+    withdrawalQueueAddress: '0x889edC2eDab5f40e902b864aD4d7AdE8E412F9B1',
+};
+// ---------------------------------------------------------------------------
+// Testnet addresses (Holesky -- Lido has no official Sepolia deployment)
+// ---------------------------------------------------------------------------
+export const LIDO_TESTNET_ADDRESSES = {
+    stethAddress: '0x3F1c547b21f65e10480dE3ad8E19fAAC46C95034',
+    withdrawalQueueAddress: '0xc7cc160b58F8Bb0baC94b80847E2CF2800565C50',
+};
+// ---------------------------------------------------------------------------
+// Defaults (disabled, mainnet addresses)
+// ---------------------------------------------------------------------------
+export const LIDO_STAKING_DEFAULTS = {
+    enabled: false,
+    ...LIDO_MAINNET_ADDRESSES,
+};
+// ---------------------------------------------------------------------------
+// Helper to select addresses by environment
+// ---------------------------------------------------------------------------
+/**
+ * Get Lido contract addresses for a given environment type.
+ * @param environment - 'mainnet' or 'testnet'
+ */
+export function getLidoAddresses(environment) {
+    return environment === 'testnet'
+        ? { ...LIDO_TESTNET_ADDRESSES }
+        : { ...LIDO_MAINNET_ADDRESSES };
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/providers/lido-staking/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY,EAAE,4CAA4C;IAC1D,sBAAsB,EAAE,4CAA4C;CAC5D,CAAC;AAEX,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY,EAAE,4CAA4C;IAC1D,sBAAsB,EAAE,4CAA4C;CAC5D,CAAC;AAEX,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,OAAO,EAAE,KAAK;IACd,GAAG,sBAAsB;CAC1B,CAAC;AAEF,8EAA8E;AAC9E,4CAA4C;AAC5C,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAkC;IAElC,OAAO,WAAW,KAAK,SAAS;QAC9B,CAAC,CAAC,EAAE,GAAG,sBAAsB,EAAE;QAC/B,CAAC,CAAC,EAAE,GAAG,sBAAsB,EAAE,CAAC;AACpC,CAAC"}

package/dist/providers/lido-staking/index.d.ts

@@ -0,0 +1,12 @@
+import type { IActionProvider, ActionProviderMetadata, ActionDefinition, ActionContext, ContractCallRequest } from '@waiaas/core';
+import { type LidoStakingConfig } from './config.js';
+export declare class LidoStakingActionProvider implements IActionProvider {
+    readonly metadata: ActionProviderMetadata;
+    readonly actions: readonly ActionDefinition[];
+    private readonly config;
+    constructor(config?: Partial<LidoStakingConfig>);
+    resolve(actionName: string, params: Record<string, unknown>, context: ActionContext): Promise<ContractCallRequest | ContractCallRequest[]>;
+    private resolveStake;
+    private resolveUnstake;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/lido-staking/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/lido-staking/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,iBAAiB,EAAyB,MAAM,aAAa,CAAC;AAgD5E,qBAAa,yBAA0B,YAAW,eAAe;IAC/D,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAE9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAE/B,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAiCzC,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,mBAAmB,GAAG,mBAAmB,EAAE,CAAC;IAkBvD,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,cAAc;CA+BvB"}

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

@@ -0,0 +1,129 @@
+/**
+ * Lido Staking Action Provider.
+ *
+ * Implements IActionProvider to resolve Lido liquid staking requests
+ * into ContractCallRequest arrays for the sequential pipeline.
+ *
+ * Actions:
+ * - stake: ETH -> stETH via Lido submit() (single element)
+ * - unstake: stETH -> ETH via WithdrawalQueue (2 elements: approve + requestWithdrawals)
+ */
+import { z } from 'zod';
+import { ChainError } from '@waiaas/core';
+import { LIDO_STAKING_DEFAULTS } from './config.js';
+import { encodeSubmitCalldata, encodeRequestWithdrawalsCalldata, encodeApproveCalldata, } from './lido-contract.js';
+// ---------------------------------------------------------------------------
+// Input schemas (Zod SSoT)
+// ---------------------------------------------------------------------------
+const LidoStakeInputSchema = z.object({
+    amount: z.string().min(1, 'amount is required (ETH, e.g. "1.0")'),
+});
+const LidoUnstakeInputSchema = z.object({
+    amount: z.string().min(1, 'amount is required (stETH, e.g. "1.0")'),
+});
+// ---------------------------------------------------------------------------
+// Amount parsing helper
+// ---------------------------------------------------------------------------
+/**
+ * Parse a human-readable ETH/stETH amount string to wei (bigint).
+ * Handles decimal amounts like "1.5" -> 1500000000000000000n.
+ *
+ * @throws ChainError if amount is zero or negative
+ */
+function parseEthAmount(amount) {
+    const parts = amount.split('.');
+    const whole = BigInt(parts[0] || '0');
+    const decimals = (parts[1] || '').padEnd(18, '0').slice(0, 18);
+    const result = whole * 10n ** 18n + BigInt(decimals);
+    if (result <= 0n) {
+        throw new ChainError('INVALID_INSTRUCTION', 'ethereum', {
+            message: 'Amount must be greater than 0',
+        });
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Provider implementation
+// ---------------------------------------------------------------------------
+export class LidoStakingActionProvider {
+    metadata;
+    actions;
+    config;
+    constructor(config) {
+        this.config = { ...LIDO_STAKING_DEFAULTS, ...config };
+        this.metadata = {
+            name: 'lido_staking',
+            description: 'Lido liquid staking protocol for ETH to stETH conversion with withdrawal support',
+            version: '1.0.0',
+            chains: ['ethereum'],
+            mcpExpose: true,
+            requiresApiKey: false,
+            requiredApis: [],
+        };
+        this.actions = [
+            {
+                name: 'stake',
+                description: 'Stake ETH to receive stETH via Lido protocol (submit). Immediate, no lock-up.',
+                chain: 'ethereum',
+                inputSchema: LidoStakeInputSchema,
+                riskLevel: 'medium',
+                defaultTier: 'DELAY',
+            },
+            {
+                name: 'unstake',
+                description: 'Request stETH to ETH withdrawal via Lido Withdrawal Queue. Takes 1-5 days to finalize.',
+                chain: 'ethereum',
+                inputSchema: LidoUnstakeInputSchema,
+                riskLevel: 'medium',
+                defaultTier: 'DELAY',
+            },
+        ];
+    }
+    async resolve(actionName, params, context) {
+        if (actionName === 'stake') {
+            return this.resolveStake(params);
+        }
+        if (actionName === 'unstake') {
+            return this.resolveUnstake(params, context);
+        }
+        throw new ChainError('INVALID_INSTRUCTION', 'ethereum', {
+            message: `Unknown action: ${actionName}`,
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Stake: ETH -> stETH via submit()
+    // -------------------------------------------------------------------------
+    resolveStake(params) {
+        const input = LidoStakeInputSchema.parse(params);
+        const amountWei = parseEthAmount(input.amount);
+        return {
+            type: 'CONTRACT_CALL',
+            to: this.config.stethAddress,
+            calldata: encodeSubmitCalldata(), // submit(address(0)) referral
+            value: amountWei.toString(), // ETH value sent with tx
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Unstake: stETH -> ETH via WithdrawalQueue (approve + requestWithdrawals)
+    // -------------------------------------------------------------------------
+    resolveUnstake(params, context) {
+        const input = LidoUnstakeInputSchema.parse(params);
+        const amountWei = parseEthAmount(input.amount);
+        // Step 1: Approve stETH to WithdrawalQueue
+        const approveRequest = {
+            type: 'CONTRACT_CALL',
+            to: this.config.stethAddress,
+            calldata: encodeApproveCalldata(this.config.withdrawalQueueAddress, amountWei),
+            value: '0',
+        };
+        // Step 2: Request withdrawal from WithdrawalQueue
+        const withdrawRequest = {
+            type: 'CONTRACT_CALL',
+            to: this.config.withdrawalQueueAddress,
+            calldata: encodeRequestWithdrawalsCalldata([amountWei], context.walletAddress),
+            value: '0',
+        };
+        return [approveRequest, withdrawRequest];
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/providers/lido-staking/lido-contract.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 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.
+ */
+/**
+ * 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 declare function encodeSubmitCalldata(referral?: string): string;
+/**
+ * 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 declare function encodeRequestWithdrawalsCalldata(amounts: bigint[], owner: string): string;
+/**
+ * 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 declare function encodeApproveCalldata(spender: string, amount: bigint): string;
+//# sourceMappingURL=lido-contract.d.ts.map

package/dist/providers/lido-staking/lido-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lido-contract.d.ts","sourceRoot":"","sources":["../../../src/providers/lido-staking/lido-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuBH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,GAAE,MAAqD,GAC9D,MAAM,CAIR;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,MAAM,GACZ,MAAM,CAUR;AAMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK7E"}