@waiaas/daemon 2.9.0 → 2.10.0-rc

package/dist/pipeline/dry-run.js

@@ -0,0 +1,426 @@
+/**
+ * Dry-run simulation pipeline.
+ *
+ * Executes transaction stages in read-only mode with ZERO side effects:
+ * - No DB INSERT/UPDATE
+ * - No signing / key decryption
+ * - No on-chain submission
+ * - No notifications / events / audit logs
+ *
+ * Returns a DryRunSimulationResult with policy evaluation, fee estimate,
+ * balance changes, warnings, and simulation details.
+ *
+ * @see Phase 304 DESIGN-SPEC.md section 3 (SIM-02)
+ * @see Phase 309 Plan 01 Task 2
+ */
+import { eq } from 'drizzle-orm';
+import { TransactionRequestSchema, WAIaaSError, } from '@waiaas/core';
+import { wallets } from '../infrastructure/database/schema.js';
+import { buildByType, buildTransactionParam, getRequestAmount } from './stages.js';
+import { resolveEffectiveAmountUsd } from './resolve-effective-amount-usd.js';
+import { downgradeIfNoOwner } from '../workflow/owner-state.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const NATIVE_DECIMALS = { solana: 9, ethereum: 18 };
+const NATIVE_SYMBOLS = { solana: 'SOL', ethereum: 'ETH' };
+// ---------------------------------------------------------------------------
+// executeDryRun
+// ---------------------------------------------------------------------------
+/**
+ * Execute a transaction dry-run simulation.
+ *
+ * Returns DryRunSimulationResult with zero side effects.
+ * Policy denials return success=false (not thrown errors).
+ * Build/simulation failures produce warnings (not exceptions).
+ *
+ * @param deps - Dry-run dependencies (no keyStore, no notifications)
+ * @param walletId - Wallet ID
+ * @param request - Transaction request (5-type discriminatedUnion)
+ * @param resolvedNetwork - Pre-resolved network
+ * @param walletInfo - Wallet public key, chain, environment
+ * @returns DryRunSimulationResult
+ * @throws WAIaaSError('ACTION_VALIDATION_FAILED') for invalid request format
+ */
+export async function executeDryRun(deps, walletId, request, resolvedNetwork, walletInfo) {
+    const collector = {
+        validationPassed: false,
+        policyEvaluation: null,
+        downgraded: false,
+        unsignedTx: null,
+        simulationResult: null,
+        currentBalances: [],
+        warnings: [],
+        startTime: Date.now(),
+        amountUsd: null,
+        feeUsd: null,
+    };
+    const chain = walletInfo.chain;
+    const txType = request.type || 'TRANSFER';
+    const requestAmount = BigInt(getRequestAmount(request) || '0');
+    // -----------------------------------------------------------------------
+    // Stage 1': Validate only (no DB INSERT)
+    // -----------------------------------------------------------------------
+    const parseResult = TransactionRequestSchema.safeParse(request);
+    if (!parseResult.success) {
+        throw new WAIaaSError('ACTION_VALIDATION_FAILED', {
+            message: `Request validation failed: ${parseResult.error.message}`,
+        });
+    }
+    collector.validationPassed = true;
+    // -----------------------------------------------------------------------
+    // Stage 3': Policy evaluate only (no reserve, no DB update)
+    // -----------------------------------------------------------------------
+    const txParam = buildTransactionParam(request, txType, chain);
+    txParam.network = resolvedNetwork;
+    // Resolve USD amount from price oracle (read-only)
+    let priceResult;
+    if (deps.priceOracle) {
+        try {
+            priceResult = await resolveEffectiveAmountUsd(request, txType, chain, deps.priceOracle, resolvedNetwork);
+            if (priceResult.type === 'success') {
+                collector.amountUsd = priceResult.usdAmount;
+            }
+            else {
+                collector.warnings.push({
+                    code: 'ORACLE_PRICE_UNAVAILABLE',
+                    message: priceResult.type === 'notListed'
+                        ? `Price unavailable for token ${priceResult.tokenAddress}`
+                        : 'Price oracle unavailable',
+                    severity: 'warning',
+                });
+            }
+        }
+        catch {
+            collector.warnings.push({
+                code: 'ORACLE_PRICE_UNAVAILABLE',
+                message: 'Price oracle unavailable',
+                severity: 'warning',
+            });
+        }
+    }
+    // Evaluate policy (read-only -- evaluate(), NOT evaluateAndReserve())
+    const evaluation = await deps.policyEngine.evaluate(walletId, { ...txParam, network: resolvedNetwork });
+    collector.policyEvaluation = evaluation;
+    // Check for owner downgrade (APPROVAL -> DELAY when no owner)
+    if (evaluation.tier === 'APPROVAL') {
+        const walletRow = deps.db
+            .select({ ownerAddress: wallets.ownerAddress, ownerVerified: wallets.ownerVerified })
+            .from(wallets)
+            .where(eq(wallets.id, walletId))
+            .get();
+        const downgradeResult = downgradeIfNoOwner({
+            ownerAddress: walletRow?.ownerAddress ?? null,
+            ownerVerified: !!walletRow?.ownerVerified,
+        }, evaluation.tier);
+        if (downgradeResult.downgraded) {
+            collector.downgraded = true;
+            evaluation.tier = downgradeResult.tier;
+            collector.warnings.push({
+                code: 'DOWNGRADED_NO_OWNER',
+                message: 'APPROVAL tier downgraded to DELAY because no owner is registered',
+                severity: 'info',
+            });
+        }
+    }
+    // Add tier-specific warnings
+    if (evaluation.tier === 'APPROVAL') {
+        collector.warnings.push({
+            code: 'APPROVAL_REQUIRED',
+            message: `Owner approval is required${evaluation.approvalReason ? ` (${evaluation.approvalReason})` : ''}`,
+            severity: 'warning',
+        });
+    }
+    if (evaluation.tier === 'DELAY') {
+        collector.warnings.push({
+            code: 'DELAY_REQUIRED',
+            message: `Time delay of ${evaluation.delaySeconds ?? 900} seconds will be applied`,
+            severity: 'info',
+        });
+    }
+    if (evaluation.cumulativeWarning && evaluation.cumulativeWarning.ratio >= 0.8) {
+        collector.warnings.push({
+            code: 'CUMULATIVE_LIMIT_WARNING',
+            message: `Cumulative ${evaluation.cumulativeWarning.type} spending at ${Math.round(evaluation.cumulativeWarning.ratio * 100)}% of limit`,
+            severity: 'warning',
+        });
+    }
+    // Add policy denial reason-based warnings
+    if (!evaluation.allowed && evaluation.reason) {
+        if (evaluation.reason.includes('not in allowed list') || evaluation.reason.includes('Token transfer not allowed')) {
+            collector.warnings.push({
+                code: 'TOKEN_NOT_IN_ALLOWED_LIST',
+                message: evaluation.reason,
+                severity: 'error',
+            });
+        }
+        else if (evaluation.reason.includes('not whitelisted') || evaluation.reason.includes('Contract calls disabled')) {
+            collector.warnings.push({
+                code: 'CONTRACT_NOT_WHITELISTED',
+                message: evaluation.reason,
+                severity: 'error',
+            });
+        }
+        else if (evaluation.reason.includes('not in allowed networks')) {
+            collector.warnings.push({
+                code: 'NETWORK_NOT_ALLOWED',
+                message: evaluation.reason,
+                severity: 'error',
+            });
+        }
+    }
+    // If policy denied, skip build/simulate/balance but still return result
+    if (!evaluation.allowed) {
+        return buildResult(collector, request, txType, chain, resolvedNetwork);
+    }
+    // -----------------------------------------------------------------------
+    // Balance query
+    // -----------------------------------------------------------------------
+    const nativeDecimals = NATIVE_DECIMALS[chain] ?? 18;
+    const nativeSymbol = NATIVE_SYMBOLS[chain] ?? chain.toUpperCase();
+    try {
+        const balanceInfo = await deps.adapter.getBalance(walletInfo.publicKey);
+        collector.currentBalances.push({
+            asset: 'native',
+            symbol: balanceInfo.symbol || nativeSymbol,
+            decimals: balanceInfo.decimals || nativeDecimals,
+            balance: balanceInfo.balance,
+        });
+    }
+    catch {
+        collector.currentBalances.push({
+            asset: 'native',
+            symbol: nativeSymbol,
+            decimals: nativeDecimals,
+            balance: 0n,
+        });
+    }
+    // For TOKEN_TRANSFER, fetch token balance via getAssets
+    if (txType === 'TOKEN_TRANSFER') {
+        const tokenReq = request;
+        try {
+            const assets = await deps.adapter.getAssets(walletInfo.publicKey);
+            const tokenAsset = assets.find((a) => a.mint.toLowerCase() === tokenReq.token.address.toLowerCase());
+            if (tokenAsset) {
+                collector.currentBalances.push({
+                    asset: tokenReq.token.address,
+                    symbol: tokenAsset.symbol || tokenReq.token.symbol,
+                    decimals: tokenAsset.decimals ?? tokenReq.token.decimals,
+                    balance: tokenAsset.balance ?? 0n,
+                });
+            }
+            else {
+                collector.currentBalances.push({
+                    asset: tokenReq.token.address,
+                    symbol: tokenReq.token.symbol,
+                    decimals: tokenReq.token.decimals,
+                    balance: 0n,
+                });
+            }
+        }
+        catch {
+            collector.currentBalances.push({
+                asset: tokenReq.token.address,
+                symbol: tokenReq.token.symbol,
+                decimals: tokenReq.token.decimals,
+                balance: 0n,
+            });
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Stage 5a': Build (no signing)
+    // -----------------------------------------------------------------------
+    try {
+        collector.unsignedTx = await buildByType(deps.adapter, request, walletInfo.publicKey);
+    }
+    catch (err) {
+        const errMsg = err instanceof Error ? err.message : 'Build failed';
+        collector.warnings.push({
+            code: 'SIMULATION_FAILED',
+            message: `Transaction build failed: ${errMsg}`,
+            severity: 'warning',
+        });
+        collector.simulationResult = {
+            success: false,
+            logs: [],
+            error: errMsg,
+        };
+        return buildResult(collector, request, txType, chain, resolvedNetwork);
+    }
+    // -----------------------------------------------------------------------
+    // Stage 5b': Simulate (no signing, no submission)
+    // -----------------------------------------------------------------------
+    try {
+        collector.simulationResult = await deps.adapter.simulateTransaction(collector.unsignedTx);
+        if (!collector.simulationResult.success) {
+            collector.warnings.push({
+                code: 'SIMULATION_FAILED',
+                message: collector.simulationResult.error ?? 'Transaction simulation failed',
+                severity: 'warning',
+            });
+        }
+    }
+    catch (err) {
+        const errMsg = err instanceof Error ? err.message : 'Simulation failed';
+        collector.simulationResult = {
+            success: false,
+            logs: [],
+            error: errMsg,
+        };
+        collector.warnings.push({
+            code: 'SIMULATION_FAILED',
+            message: `Transaction simulation error: ${errMsg}`,
+            severity: 'warning',
+        });
+    }
+    // -----------------------------------------------------------------------
+    // Compute fee with gas safety margin and check balances
+    // -----------------------------------------------------------------------
+    const estimatedFee = collector.unsignedTx.estimatedFee;
+    const safetyFee = (estimatedFee * 120n) / 100n;
+    // Check balance sufficiency
+    const nativeBalance = collector.currentBalances.find((b) => b.asset === 'native');
+    if (nativeBalance) {
+        if (txType === 'TRANSFER' || txType === 'CONTRACT_CALL') {
+            const totalCost = requestAmount + safetyFee;
+            if (totalCost > nativeBalance.balance) {
+                collector.warnings.push({
+                    code: 'INSUFFICIENT_BALANCE_WITH_FEE',
+                    message: `Insufficient balance after fee: need ${totalCost.toString()}, have ${nativeBalance.balance.toString()}`,
+                    severity: 'error',
+                });
+            }
+        }
+        else {
+            if (safetyFee > nativeBalance.balance) {
+                collector.warnings.push({
+                    code: 'INSUFFICIENT_BALANCE_WITH_FEE',
+                    message: `Insufficient native balance for fee: need ${safetyFee.toString()}, have ${nativeBalance.balance.toString()}`,
+                    severity: 'error',
+                });
+            }
+        }
+    }
+    // For TOKEN_TRANSFER, check token balance
+    if (txType === 'TOKEN_TRANSFER') {
+        const tokenReq = request;
+        const tokenBalance = collector.currentBalances.find((b) => b.asset.toLowerCase() === tokenReq.token.address.toLowerCase());
+        if (tokenBalance && BigInt(tokenReq.amount) > tokenBalance.balance) {
+            collector.warnings.push({
+                code: 'INSUFFICIENT_BALANCE',
+                message: `Insufficient token balance: need ${tokenReq.amount}, have ${tokenBalance.balance.toString()}`,
+                severity: 'error',
+            });
+        }
+    }
+    // Check high fee ratio
+    if (requestAmount > 0n && safetyFee > 0n) {
+        const feeRatio = Number(safetyFee) / Number(requestAmount);
+        if (feeRatio > 0.1) {
+            collector.warnings.push({
+                code: 'HIGH_FEE_RATIO',
+                message: `Fee is ${Math.round(feeRatio * 100)}% of transaction amount`,
+                severity: 'info',
+            });
+        }
+    }
+    // Resolve fee USD if oracle available
+    if (deps.priceOracle) {
+        try {
+            const nativePrice = await deps.priceOracle.getNativePrice(chain);
+            const feeDecimals = NATIVE_DECIMALS[chain] ?? 18;
+            const feeHuman = Number(safetyFee) / Math.pow(10, feeDecimals);
+            collector.feeUsd = feeHuman * nativePrice.usdPrice;
+        }
+        catch {
+            // feeUsd stays null
+        }
+    }
+    return buildResult(collector, request, txType, chain, resolvedNetwork);
+}
+// ---------------------------------------------------------------------------
+// Build the final result from collector
+// ---------------------------------------------------------------------------
+function buildResult(collector, request, txType, chain, resolvedNetwork) {
+    const evaluation = collector.policyEvaluation;
+    const unsignedTx = collector.unsignedTx;
+    const nativeDecimals = NATIVE_DECIMALS[chain] ?? 18;
+    const nativeSymbol = NATIVE_SYMBOLS[chain] ?? chain.toUpperCase();
+    // Determine success: policy allowed
+    const success = !!evaluation?.allowed;
+    // Build fee estimate
+    let fee = null;
+    if (unsignedTx) {
+        const safetyFee = (unsignedTx.estimatedFee * 120n) / 100n;
+        fee = {
+            estimatedFee: safetyFee.toString(),
+            feeSymbol: nativeSymbol,
+            feeDecimals: nativeDecimals,
+            feeUsd: collector.feeUsd,
+        };
+    }
+    // Build balance changes from collector
+    const requestAmount = BigInt(getRequestAmount(request) || '0');
+    const balanceChanges = [];
+    for (const bal of collector.currentBalances) {
+        let changeAmount;
+        if (bal.asset === 'native') {
+            const feeAmount = unsignedTx ? (unsignedTx.estimatedFee * 120n) / 100n : 0n;
+            if (txType === 'TRANSFER' || txType === 'CONTRACT_CALL') {
+                // Native transfer: deduct amount + fee
+                changeAmount = -(requestAmount + feeAmount);
+            }
+            else {
+                // Token transfer/Approve/Batch: only deduct fee from native
+                changeAmount = -feeAmount;
+            }
+        }
+        else {
+            // Token balance: deduct token amount
+            changeAmount = -requestAmount;
+        }
+        const afterBalance = bal.balance + changeAmount;
+        balanceChanges.push({
+            asset: bal.asset,
+            symbol: bal.symbol,
+            decimals: bal.decimals,
+            currentBalance: bal.balance.toString(),
+            changeAmount: changeAmount.toString(),
+            afterBalance: afterBalance.toString(),
+        });
+    }
+    // Build simulation detail
+    const simulation = {
+        success: collector.simulationResult?.success ?? false,
+        logs: collector.simulationResult?.logs ?? [],
+        unitsConsumed: collector.simulationResult?.unitsConsumed != null
+            ? collector.simulationResult.unitsConsumed.toString()
+            : null,
+        error: collector.simulationResult?.error ?? (evaluation?.allowed === false ? 'Skipped: policy denied' : null),
+    };
+    // Build meta
+    const meta = {
+        chain: chain,
+        network: resolvedNetwork,
+        transactionType: txType,
+        durationMs: Date.now() - collector.startTime,
+    };
+    return {
+        success,
+        policy: {
+            tier: evaluation?.tier ?? 'INSTANT',
+            allowed: evaluation?.allowed ?? false,
+            reason: evaluation?.reason,
+            delaySeconds: evaluation?.delaySeconds,
+            approvalReason: evaluation?.approvalReason,
+            downgraded: collector.downgraded || undefined,
+            cumulativeWarning: evaluation?.cumulativeWarning,
+        },
+        fee,
+        balanceChanges,
+        warnings: collector.warnings,
+        simulation,
+        meta,
+    };
+}
+//# sourceMappingURL=dry-run.js.map

package/dist/pipeline/dry-run.js.map

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

package/dist/pipeline/index.d.ts

@@ -6,4 +6,5 @@ export { DefaultPolicyEngine } from './default-policy-engine.js';
 export { DatabasePolicyEngine } from './database-policy-engine.js';
 export { stage1Validate, stage2Auth, stage3Policy, stage4Wait, stage5Execute, stage6Confirm, type PipelineContext, } from './stages.js';
 export { resolveEffectiveAmountUsd, type PriceResult, type PriceResultSuccess, type PriceResultOracleDown, type PriceResultNotListed, } from './resolve-effective-amount-usd.js';
+export { executeDryRun, type DryRunDeps, type DryRunCollector, } from './dry-run.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/pipeline/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EACL,cAAc,EACd,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,EACb,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,yBAAyB,EACzB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EACL,cAAc,EACd,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,EACb,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,yBAAyB,EACzB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC"}

package/dist/pipeline/index.js

@@ -6,4 +6,6 @@ export { DefaultPolicyEngine } from './default-policy-engine.js';
 export { DatabasePolicyEngine } from './database-policy-engine.js';
 export { stage1Validate, stage2Auth, stage3Policy, stage4Wait, stage5Execute, stage6Confirm, } from './stages.js';
 export { resolveEffectiveAmountUsd, } from './resolve-effective-amount-usd.js';
+// v30.2 dry-run simulation
+export { executeDryRun, } from './dry-run.js';
 //# sourceMappingURL=index.js.map

package/dist/pipeline/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAqB,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EACL,cAAc,EACd,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,GAEd,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,yBAAyB,GAK1B,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAqB,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EACL,cAAc,EACd,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,GAEd,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,yBAAyB,GAK1B,MAAM,mCAAmC,CAAC;AAC3C,2BAA2B;AAC3B,OAAO,EACL,aAAa,GAGd,MAAM,cAAc,CAAC"}

package/dist/pipeline/pipeline.d.ts

@@ -8,10 +8,11 @@
  */
 import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
 import type { Database as SQLiteDatabase } from 'better-sqlite3';
-import type { IChainAdapter, IPolicyEngine, SendTransactionRequest, TransactionRequest } from '@waiaas/core';
+import type { IChainAdapter, IPolicyEngine, SendTransactionRequest, TransactionRequest, DryRunSimulationResult, IPriceOracle, IMetricsCounter } from '@waiaas/core';
 import type { LocalKeyStore } from '../infrastructure/keystore/keystore.js';
 import type * as schema from '../infrastructure/database/schema.js';
 import type { NotificationService } from '../notifications/notification-service.js';
+import type { SettingsService } from '../infrastructure/settings/settings-service.js';
 export interface PipelineDeps {
     db: BetterSQLite3Database<typeof schema>;
     adapter: IChainAdapter;
@@ -20,6 +21,9 @@ export interface PipelineDeps {
     masterPassword: string;
     sqlite?: SQLiteDatabase;
     notificationService?: NotificationService;
+    priceOracle?: IPriceOracle;
+    settingsService?: SettingsService;
+    metricsCounter?: IMetricsCounter;
 }
 export declare class TransactionPipeline {
     private readonly deps;
@@ -32,6 +36,19 @@ export declare class TransactionPipeline {
      * @returns The transaction ID (UUID v7)
      */
     executeSend(walletId: string, request: SendTransactionRequest | TransactionRequest): Promise<string>;
+    /**
+     * Execute a dry-run simulation of a transaction.
+     *
+     * Returns DryRunSimulationResult with zero side effects.
+     * No DB writes, no signing, no notifications, no events.
+     *
+     * @param walletId - Wallet initiating the simulation
+     * @param request - Transaction request (5-type discriminatedUnion)
+     * @returns DryRunSimulationResult
+     * @throws WAIaaSError('WALLET_NOT_FOUND') if wallet doesn't exist
+     * @throws WAIaaSError('WALLET_TERMINATED') if wallet is terminated
+     */
+    executeDryRun(walletId: string, request: TransactionRequest): Promise<DryRunSimulationResult>;
     /**
      * Get a transaction by ID.
      *

package/dist/pipeline/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,KAAK,EAA2C,aAAa,EAAE,aAAa,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGtJ,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,KAAK,MAAM,MAAM,sCAAsC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAgBpF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,qBAAqB,CAAC,OAAO,MAAM,CAAC,CAAC;IACzC,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,aAAa,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAMD,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAE/C;;;;;;OAMG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IA0C1G;;;;;;OAMG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAkBnB,SAAS;CAGxB"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,KAAK,EAA2C,aAAa,EAAE,aAAa,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAI7M,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,KAAK,MAAM,MAAM,sCAAsC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAgBtF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,qBAAqB,CAAC,OAAO,MAAM,CAAC,CAAC;IACzC,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,aAAa,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAE1C,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC,cAAc,CAAC,EAAE,eAAe,CAAC;CAClC;AAMD,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAE/C;;;;;;OAMG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IA0C1G;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAsCnG;;;;;;OAMG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAkBnB,SAAS;CAGxB"}

package/dist/pipeline/pipeline.js

@@ -9,6 +9,7 @@
 import { eq } from 'drizzle-orm';
 import { WAIaaSError } from '@waiaas/core';
 import { resolveNetwork } from './network-resolver.js';
+import { executeDryRun as executeDryRunFn } from './dry-run.js';
 import { wallets, transactions } from '../infrastructure/database/schema.js';
 import { stage1Validate, stage2Auth, stage3Policy, stage3_5GasCondition, stage4Wait, stage5Execute, stage6Confirm, } from './stages.js';
 // ---------------------------------------------------------------------------
@@ -59,6 +60,43 @@ export class TransactionPipeline {
         await stage6Confirm(ctx);
         return ctx.txId;
     }
+    /**
+     * Execute a dry-run simulation of a transaction.
+     *
+     * Returns DryRunSimulationResult with zero side effects.
+     * No DB writes, no signing, no notifications, no events.
+     *
+     * @param walletId - Wallet initiating the simulation
+     * @param request - Transaction request (5-type discriminatedUnion)
+     * @returns DryRunSimulationResult
+     * @throws WAIaaSError('WALLET_NOT_FOUND') if wallet doesn't exist
+     * @throws WAIaaSError('WALLET_TERMINATED') if wallet is terminated
+     */
+    async executeDryRun(walletId, request) {
+        const wallet = await this.getWallet(walletId);
+        if (!wallet) {
+            throw new WAIaaSError('WALLET_NOT_FOUND', {
+                message: `Wallet '${walletId}' not found`,
+            });
+        }
+        if (wallet.status === 'TERMINATED') {
+            throw new WAIaaSError('WALLET_TERMINATED', {
+                message: `Wallet '${walletId}' is terminated`,
+            });
+        }
+        const resolvedNet = resolveNetwork(request.network, wallet.environment, wallet.chain);
+        return executeDryRunFn({
+            db: this.deps.db,
+            adapter: this.deps.adapter,
+            policyEngine: this.deps.policyEngine,
+            priceOracle: this.deps.priceOracle,
+            settingsService: this.deps.settingsService,
+        }, walletId, request, resolvedNet, {
+            publicKey: wallet.publicKey,
+            chain: wallet.chain,
+            environment: wallet.environment,
+        });
+    }
     /**
      * Get a transaction by ID.
      *

package/dist/pipeline/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/pipeline/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAGjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAK7E,OAAO,EACL,cAAc,EACd,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,aAAa,EACb,aAAa,GACd,MAAM,aAAa,CAAC;AAgBrB,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,IAAkB;QAAlB,SAAI,GAAJ,IAAI,CAAc;IAAG,CAAC;IAEnD;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,OAAoD;QACtF,iBAAiB;QACjB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,WAAW,CAAC,kBAAkB,EAAE;gBACxC,OAAO,EAAE,WAAW,QAAQ,aAAa;aAC1C,CAAC,CAAC;QACL,CAAC;QAED,4DAA4D;QAC5D,MAAM,eAAe,GAAG,cAAc,CACnC,OAAgC,CAAC,OAAkC,EACpE,MAAM,CAAC,WAA8B,EACrC,MAAM,CAAC,KAAkB,CAC1B,CAAC;QAEF,0BAA0B;QAC1B,MAAM,GAAG,GAAoB;YAC3B,GAAG,IAAI,CAAC,IAAI;YACZ,QAAQ;YACR,MAAM,EAAE;gBACN,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC;YACD,eAAe;YACf,OAAO;YACP,IAAI,EAAE,EAAE;SACT,CAAC;QAEF,6EAA6E;QAC7E,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QACxB,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;QAEzB,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE;aAC1B,MAAM,EAAE;aACR,IAAI,CAAC,YAAY,CAAC;aAClB,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;aAChC,GAAG,EAAE,CAAC;QAET,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE;gBACpC,OAAO,EAAE,gBAAgB,IAAI,aAAa;aAC3C,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,0BAA0B;IAElB,KAAK,CAAC,SAAS,CAAC,QAAgB;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACnF,CAAC;CACF"}
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/pipeline/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/stages.d.ts

@@ -19,7 +19,7 @@ import type { DelayQueue } from '../workflow/delay-queue.js';
 import type { ApprovalWorkflow } from '../workflow/approval-workflow.js';
 import type { NotificationService } from '../notifications/notification-service.js';
 import type { SettingsService } from '../infrastructure/settings/settings-service.js';
-import type { IPriceOracle, IForexRateService } from '@waiaas/core';
+import type { IPriceOracle, IForexRateService, IMetricsCounter } from '@waiaas/core';
 import { type EventBus } from '@waiaas/core';
 import type { WcSigningBridge } from '../services/wc-signing-bridge.js';
 import type { ApprovalChannelRouter } from '../services/signing-sdk/approval-channel-router.js';
@@ -62,7 +62,32 @@ export interface PipelineContext {
     eventBus?: EventBus;
     wcSigningBridge?: WcSigningBridge;
     approvalChannelRouter?: ApprovalChannelRouter;
+    metricsCounter?: IMetricsCounter;
 }
+/** Safely extract `amount` from SendTransactionRequest | TransactionRequest. */
+export declare function getRequestAmount(req: SendTransactionRequest | TransactionRequest): string;
+/** Safely extract `to` from SendTransactionRequest | TransactionRequest. */
+export declare function getRequestTo(req: SendTransactionRequest | TransactionRequest): string;
+/** Safely extract `memo` from SendTransactionRequest | TransactionRequest. */
+export declare function getRequestMemo(req: SendTransactionRequest | TransactionRequest): string | undefined;
+export interface TransactionParam {
+    type: string;
+    amount: string;
+    toAddress: string;
+    chain: string;
+    network?: string;
+    tokenAddress?: string;
+    assetId?: string;
+    contractAddress?: string;
+    selector?: string;
+    spenderAddress?: string;
+    approveAmount?: string;
+    /** Token decimals for token_limits human-readable conversion (TOKEN_TRANSFER/APPROVE only). */
+    tokenDecimals?: number;
+    /** Action provider name for provider-trust policy bypass (set by ActionProviderRegistry). */
+    actionProvider?: string;
+}
+export declare function buildTransactionParam(req: SendTransactionRequest | TransactionRequest, txType: string, chain: string): TransactionParam;
 export declare function stage1Validate(ctx: PipelineContext): Promise<void>;
 export declare function stage2Auth(_ctx: PipelineContext): Promise<void>;
 export declare function stage3Policy(ctx: PipelineContext): Promise<void>;
@@ -82,6 +107,11 @@ export declare function stage3Policy(ctx: PipelineContext): Promise<void>;
  */
 export declare function stage3_5GasCondition(ctx: PipelineContext): Promise<void>;
 export declare function stage4Wait(ctx: PipelineContext): Promise<void>;
+/**
+ * Build unsigned transaction by dispatching to the correct IChainAdapter method
+ * based on request.type (TRANSFER/TOKEN_TRANSFER/CONTRACT_CALL/APPROVE/BATCH).
+ */
+export declare function buildByType(adapter: IChainAdapter, request: SendTransactionRequest | TransactionRequest, walletPublicKey: string): Promise<UnsignedTransaction>;
 /**
  * Stage 5: Build -> Simulate -> Sign -> Submit with CONC-01 retry logic.
  *