@waiaas/core 2.0.0-rc.1

package/dist/interfaces/action-provider.types.js

@@ -0,0 +1,65 @@
+/**
+ * Action Provider types and interfaces (Zod SSoT).
+ *
+ * Defines ActionProviderMetadata, ActionDefinition, ActionContext,
+ * and IActionProvider for the v1.5 Action Provider framework.
+ * Actual provider implementations (ESM plugins) live in the daemon package
+ * or in ~/.waiaas/actions/ user plugin directory.
+ *
+ * Design source: doc 62 (action-provider-architecture).
+ */
+import { z } from 'zod';
+import { ChainTypeEnum } from '../enums/chain.js';
+// ---------------------------------------------------------------------------
+// Zod SSoT: ActionProviderMetadata
+// ---------------------------------------------------------------------------
+/** Metadata describing an Action Provider (name, version, chains, flags). */
+export const ActionProviderMetadataSchema = z.object({
+    /** Provider name: lowercase alphanumeric + underscore, 3-50 chars. */
+    name: z.string().regex(/^[a-z][a-z0-9_]*$/).min(3).max(50),
+    /** Human-readable description, 10-500 chars. */
+    description: z.string().min(10).max(500),
+    /** SemVer version string. */
+    version: z.string().regex(/^\d+\.\d+\.\d+$/),
+    /** Supported chains (at least 1). */
+    chains: z.array(ChainTypeEnum).min(1),
+    /** Whether to expose actions as MCP tools. Defaults to false. */
+    mcpExpose: z.boolean().default(false),
+    /** Whether this provider requires an API key. Defaults to false. */
+    requiresApiKey: z.boolean().default(false),
+    /** List of required external API identifiers. Defaults to []. */
+    requiredApis: z.array(z.string()).optional().default([]),
+});
+// ---------------------------------------------------------------------------
+// Zod SSoT: ActionDefinition
+// ---------------------------------------------------------------------------
+/** Definition of a single action within a provider. */
+export const ActionDefinitionSchema = z.object({
+    /** Action name: lowercase alphanumeric + underscore, 3-50 chars. */
+    name: z.string().regex(/^[a-z][a-z0-9_]*$/).min(3).max(50),
+    /** Human-readable description, 20-1000 chars. */
+    description: z.string().min(20).max(1000),
+    /** Target chain for this action. */
+    chain: ChainTypeEnum,
+    /** Zod schema for input validation (duck-typed at registration). */
+    inputSchema: z.any(),
+    /** Risk level classification. */
+    riskLevel: z.enum(['low', 'medium', 'high']),
+    /** Default policy tier for this action. */
+    defaultTier: z.enum(['INSTANT', 'NOTIFY', 'DELAY', 'APPROVAL']),
+});
+// ---------------------------------------------------------------------------
+// Zod SSoT: ActionContext
+// ---------------------------------------------------------------------------
+/** Context passed to resolve() containing wallet and session info. */
+export const ActionContextSchema = z.object({
+    /** Wallet address (public key). */
+    walletAddress: z.string().min(1),
+    /** Target chain. */
+    chain: ChainTypeEnum,
+    /** Wallet UUID. */
+    walletId: z.string(),
+    /** Session UUID (optional for admin-initiated actions). */
+    sessionId: z.string().optional(),
+});
+//# sourceMappingURL=action-provider.types.js.map

package/dist/interfaces/action-provider.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-provider.types.js","sourceRoot":"","sources":["../../src/interfaces/action-provider.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAE9E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,sEAAsE;IACtE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1D,gDAAgD;IAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACxC,6BAA6B;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAC5C,qCAAqC;IACrC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,iEAAiE;IACjE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACrC,oEAAoE;IACpE,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC1C,iEAAiE;IACjE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACzD,CAAC,CAAC;AAKH,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E,uDAAuD;AACvD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,oEAAoE;IACpE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1D,iDAAiD;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACzC,oCAAoC;IACpC,KAAK,EAAE,aAAa;IACpB,oEAAoE;IACpE,WAAW,EAAE,CAAC,CAAC,GAAG,EAAE;IACpB,iCAAiC;IACjC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,2CAA2C;IAC3C,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;CAChE,CAAC,CAAC;AAKH,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,sEAAsE;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,mCAAmC;IACnC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,oBAAoB;IACpB,KAAK,EAAE,aAAa;IACpB,mBAAmB;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,2DAA2D;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}

package/dist/interfaces/chain-adapter.types.d.ts

@@ -0,0 +1,216 @@
+import type { ChainType } from '../enums/chain.js';
+/** Token amount with raw bigint value, decimals, and symbol. */
+export interface TokenAmount {
+    /** Raw amount in smallest unit (lamports/wei). */
+    raw: bigint;
+    /** Decimal places. SOL=9, ETH=18, USDC=6. */
+    decimals: number;
+    /** Token symbol. 'SOL', 'ETH', 'USDC', etc. */
+    symbol: string;
+}
+/** Native token transfer request. Chain-agnostic common parameters. */
+export interface TransferRequest {
+    /** Sender address (chain-specific format). */
+    from: string;
+    /** Recipient address (chain-specific format). */
+    to: string;
+    /** Transfer amount in smallest unit (lamports/wei). */
+    amount: bigint;
+    /** Optional memo (max 256 bytes). Solana: Memo Program, EVM: tx data. */
+    memo?: string;
+}
+/** Built unsigned transaction. Output of buildTransaction(), input to simulate/sign. */
+export interface UnsignedTransaction {
+    /** Target chain. */
+    chain: ChainType;
+    /** Chain-specific serialized transaction bytes. */
+    serialized: Uint8Array;
+    /** Estimated fee in smallest unit. */
+    estimatedFee: bigint;
+    /** Transaction expiry. Solana: blockhash lifetime (~60s). EVM: undefined. */
+    expiresAt?: Date;
+    /** Chain-specific metadata (e.g. lastValidBlockHeight, nonce). */
+    metadata: Record<string, unknown>;
+    /** EVM nonce (v0.7). EVM only. */
+    nonce?: number;
+}
+/** Transaction simulation result. */
+export interface SimulationResult {
+    /** Whether simulation succeeded. */
+    success: boolean;
+    /** Simulation logs. */
+    logs: string[];
+    /** Compute units consumed (Solana) or gas used (EVM). */
+    unitsConsumed?: bigint;
+    /** Error message if simulation failed. */
+    error?: string;
+}
+/** Transaction submission result. */
+export interface SubmitResult {
+    /** Transaction hash. */
+    txHash: string;
+    /** Current status. */
+    status: 'submitted' | 'confirmed' | 'finalized' | 'failed';
+    /** Number of confirmations. */
+    confirmations?: number;
+    /** Block number of inclusion. */
+    blockNumber?: bigint;
+    /** Actual fee paid. */
+    fee?: bigint;
+}
+/** Balance information for an address. */
+export interface BalanceInfo {
+    /** Queried address. */
+    address: string;
+    /** Balance in smallest unit. */
+    balance: bigint;
+    /** Decimal places. */
+    decimals: number;
+    /** Token symbol. */
+    symbol: string;
+    /** USD value (from price oracle, optional). */
+    usdValue?: number;
+}
+/** Asset information for a token held by an address. */
+export interface AssetInfo {
+    /** Token mint address. 'native' for SOL/ETH. */
+    mint: string;
+    /** Token symbol. 'SOL', 'USDC', etc. */
+    symbol: string;
+    /** Token name. 'Solana', 'USD Coin', etc. Empty string if unknown. */
+    name: string;
+    /** Balance in smallest unit (lamports/wei). */
+    balance: bigint;
+    /** Decimal places. */
+    decimals: number;
+    /** Whether this is the native token. */
+    isNative: boolean;
+    /** USD value if available (from price oracle). */
+    usdValue?: number;
+}
+/** RPC health check result. */
+export interface HealthInfo {
+    /** Whether the RPC endpoint is healthy. */
+    healthy: boolean;
+    /** RPC latency in milliseconds. */
+    latencyMs: number;
+    /** Current block height. */
+    blockHeight?: bigint;
+}
+/** Fee estimation result. */
+export interface FeeEstimate {
+    /** Estimated fee in smallest unit (lamports/wei). */
+    fee: bigint;
+    /** Whether an ATA needs to be created (Solana SPL). */
+    needsAtaCreation?: boolean;
+    /** ATA creation rent cost (Solana SPL). */
+    ataRentCost?: bigint;
+    /** Breakdown details. */
+    details?: Record<string, unknown>;
+}
+/** Token information. */
+export interface TokenInfo {
+    /** Token address (mint for Solana, contract for EVM). */
+    address: string;
+    /** Token symbol. */
+    symbol: string;
+    /** Token name. */
+    name: string;
+    /** Decimal places. */
+    decimals: number;
+    /** Total supply if available. */
+    totalSupply?: bigint;
+    /** Token program (Solana: Token or Token-2022). */
+    programId?: string;
+}
+/** Sweep result (multi-asset withdrawal). */
+export interface SweepResult {
+    /** Total number of assets swept. */
+    total: number;
+    /** Number of successful sweeps. */
+    succeeded: number;
+    /** Number of failed sweeps. */
+    failed: number;
+    /** Individual sweep results. */
+    results: Array<{
+        mint: string;
+        txHash?: string;
+        error?: string;
+        amount: bigint;
+    }>;
+}
+/** Token transfer request for buildTokenTransfer(). */
+export interface TokenTransferParams {
+    from: string;
+    to: string;
+    amount: bigint;
+    token: {
+        address: string;
+        decimals: number;
+        symbol: string;
+    };
+    memo?: string;
+}
+/** Contract call request for buildContractCall(). */
+export interface ContractCallParams {
+    from: string;
+    to: string;
+    calldata?: string;
+    abi?: Record<string, unknown>[];
+    value?: bigint;
+    programId?: string;
+    instructionData?: Uint8Array;
+    accounts?: Array<{
+        pubkey: string;
+        isSigner: boolean;
+        isWritable: boolean;
+    }>;
+}
+/** Approve request for buildApprove(). */
+export interface ApproveParams {
+    from: string;
+    spender: string;
+    token: {
+        address: string;
+        decimals: number;
+        symbol: string;
+    };
+    amount: bigint;
+}
+/** Batch request for buildBatch(). */
+export interface BatchParams {
+    from: string;
+    instructions: Array<TransferRequest | TokenTransferParams | ContractCallParams | ApproveParams>;
+}
+/** Operation type identified from an unsigned transaction. */
+export type ParsedOperationType = 'NATIVE_TRANSFER' | 'TOKEN_TRANSFER' | 'CONTRACT_CALL' | 'APPROVE' | 'UNKNOWN';
+/** A single operation extracted from an unsigned transaction. */
+export interface ParsedOperation {
+    /** Operation type. */
+    type: ParsedOperationType;
+    /** Recipient or target address. */
+    to?: string;
+    /** Transfer/approve amount in smallest unit. */
+    amount?: bigint;
+    /** Token address (mint for Solana, contract for EVM). */
+    token?: string;
+    /** Program/contract address (for CONTRACT_CALL). */
+    programId?: string;
+    /** Method selector or discriminator (hex string). */
+    method?: string;
+}
+/** Result of parsing an unsigned external transaction. */
+export interface ParsedTransaction {
+    /** List of operations in the transaction. */
+    operations: ParsedOperation[];
+    /** Original raw transaction string (base64 for Solana, hex for EVM). */
+    rawTx: string;
+}
+/** Result of signing an external transaction. */
+export interface SignedTransaction {
+    /** Signed transaction (base64 for Solana, hex for EVM). */
+    signedTransaction: string;
+    /** Transaction hash if computable before submission. */
+    txHash?: string;
+}
+//# sourceMappingURL=chain-adapter.types.d.ts.map

package/dist/interfaces/chain-adapter.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-adapter.types.d.ts","sourceRoot":"","sources":["../../src/interfaces/chain-adapter.types.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/chain-adapter.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chain-adapter.types.js.map

package/dist/interfaces/chain-adapter.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-adapter.types.js","sourceRoot":"","sources":["../../src/interfaces/chain-adapter.types.ts"],"names":[],"mappings":""}

package/dist/interfaces/forex-rate.types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Forex Rate types and interfaces (Zod SSoT).
+ *
+ * Defines CurrencyCode, ForexRate, and IForexRateService for the
+ * v1.5.3 display currency subsystem. This is SEPARATE from IPriceOracle
+ * (crypto vs forex concern separation -- tech decision #10).
+ *
+ * IForexRateService.getRate() returns null on failure (graceful fallback).
+ * Caller should display USD when rate is unavailable.
+ */
+import { z } from 'zod';
+/** 43 supported fiat currency codes for display currency. */
+export declare const CurrencyCodeSchema: z.ZodEnum<["USD", "KRW", "JPY", "EUR", "GBP", "CNY", "CAD", "AUD", "CHF", "SGD", "HKD", "INR", "TWD", "THB", "MYR", "IDR", "PHP", "VND", "BRL", "MXN", "CLP", "TRY", "PLN", "CZK", "HUF", "SEK", "NOK", "DKK", "NZD", "ZAR", "ILS", "SAR", "AED", "KWD", "BHD", "NGN", "RUB", "UAH", "PKR", "BDT", "LKR", "MMK", "GEL"]>;
+/** Fiat currency code type. Derived from CurrencyCodeSchema via z.infer. */
+export type CurrencyCode = z.infer<typeof CurrencyCodeSchema>;
+/** Forex rate from USD to a target fiat currency. */
+export declare const ForexRateSchema: z.ZodObject<{
+    /** Source currency (always USD). */
+    from: z.ZodLiteral<"USD">;
+    /** Target currency code. */
+    to: z.ZodEnum<["USD", "KRW", "JPY", "EUR", "GBP", "CNY", "CAD", "AUD", "CHF", "SGD", "HKD", "INR", "TWD", "THB", "MYR", "IDR", "PHP", "VND", "BRL", "MXN", "CLP", "TRY", "PLN", "CZK", "HUF", "SEK", "NOK", "DKK", "NZD", "ZAR", "ILS", "SAR", "AED", "KWD", "BHD", "NGN", "RUB", "UAH", "PKR", "BDT", "LKR", "MMK", "GEL"]>;
+    /** Exchange rate (1 USD = rate target currency). Positive number. */
+    rate: z.ZodNumber;
+    /** Data source: 'coingecko' (fresh from API) or 'cache' (from cache). */
+    source: z.ZodEnum<["coingecko", "cache"]>;
+    /** Unix timestamp (ms) when rate was fetched. */
+    fetchedAt: z.ZodNumber;
+    /** Unix timestamp (ms) when this rate expires. */
+    expiresAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    expiresAt: number;
+    to: "USD" | "KRW" | "JPY" | "EUR" | "GBP" | "CNY" | "CAD" | "AUD" | "CHF" | "SGD" | "HKD" | "INR" | "TWD" | "THB" | "MYR" | "IDR" | "PHP" | "VND" | "BRL" | "MXN" | "CLP" | "TRY" | "PLN" | "CZK" | "HUF" | "SEK" | "NOK" | "DKK" | "NZD" | "ZAR" | "ILS" | "SAR" | "AED" | "KWD" | "BHD" | "NGN" | "RUB" | "UAH" | "PKR" | "BDT" | "LKR" | "MMK" | "GEL";
+    source: "coingecko" | "cache";
+    fetchedAt: number;
+    from: "USD";
+    rate: number;
+}, {
+    expiresAt: number;
+    to: "USD" | "KRW" | "JPY" | "EUR" | "GBP" | "CNY" | "CAD" | "AUD" | "CHF" | "SGD" | "HKD" | "INR" | "TWD" | "THB" | "MYR" | "IDR" | "PHP" | "VND" | "BRL" | "MXN" | "CLP" | "TRY" | "PLN" | "CZK" | "HUF" | "SEK" | "NOK" | "DKK" | "NZD" | "ZAR" | "ILS" | "SAR" | "AED" | "KWD" | "BHD" | "NGN" | "RUB" | "UAH" | "PKR" | "BDT" | "LKR" | "MMK" | "GEL";
+    source: "coingecko" | "cache";
+    fetchedAt: number;
+    from: "USD";
+    rate: number;
+}>;
+/** Forex rate data. Derived from ForexRateSchema via z.infer. */
+export type ForexRate = z.infer<typeof ForexRateSchema>;
+/**
+ * Forex rate service contract.
+ *
+ * Separate from IPriceOracle (crypto prices). Provides USD -> fiat
+ * currency exchange rates for display currency conversion.
+ *
+ * Implementation: ForexRateService (uses CoinGeckoForexProvider + InMemoryPriceCache).
+ *
+ * Graceful fallback: getRate() returns null on failure (caller shows USD).
+ */
+export interface IForexRateService {
+    /** Get exchange rate from USD to target currency. Returns null on failure. */
+    getRate(to: CurrencyCode): Promise<ForexRate | null>;
+    /** Get exchange rates for multiple currencies. Missing rates are omitted. */
+    getRates(currencies: CurrencyCode[]): Promise<Map<CurrencyCode, ForexRate>>;
+}
+//# sourceMappingURL=forex-rate.types.d.ts.map

package/dist/interfaces/forex-rate.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forex-rate.types.d.ts","sourceRoot":"","sources":["../../src/interfaces/forex-rate.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,0TAM7B,CAAC;AAEH,4EAA4E;AAC5E,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D,qDAAqD;AACrD,eAAO,MAAM,eAAe;IAC1B,oCAAoC;;IAEpC,4BAA4B;;IAE5B,qEAAqE;;IAErE,yEAAyE;;IAEzE,iDAAiD;;IAEjD,kDAAkD;;;;;;;;;;;;;;;;EAElD,CAAC;AAEH,iEAAiE;AACjE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACrD,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;CAC7E"}

package/dist/interfaces/forex-rate.types.js

@@ -0,0 +1,41 @@
+/**
+ * Forex Rate types and interfaces (Zod SSoT).
+ *
+ * Defines CurrencyCode, ForexRate, and IForexRateService for the
+ * v1.5.3 display currency subsystem. This is SEPARATE from IPriceOracle
+ * (crypto vs forex concern separation -- tech decision #10).
+ *
+ * IForexRateService.getRate() returns null on failure (graceful fallback).
+ * Caller should display USD when rate is unavailable.
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Zod SSoT: CurrencyCode (43 fiat currencies)
+// ---------------------------------------------------------------------------
+/** 43 supported fiat currency codes for display currency. */
+export const CurrencyCodeSchema = z.enum([
+    'USD', 'KRW', 'JPY', 'EUR', 'GBP', 'CNY', 'CAD', 'AUD', 'CHF', 'SGD',
+    'HKD', 'INR', 'TWD', 'THB', 'MYR', 'IDR', 'PHP', 'VND', 'BRL', 'MXN',
+    'CLP', 'TRY', 'PLN', 'CZK', 'HUF', 'SEK', 'NOK', 'DKK', 'NZD', 'ZAR',
+    'ILS', 'SAR', 'AED', 'KWD', 'BHD', 'NGN', 'RUB', 'UAH', 'PKR', 'BDT',
+    'LKR', 'MMK', 'GEL',
+]);
+// ---------------------------------------------------------------------------
+// Zod SSoT: ForexRate
+// ---------------------------------------------------------------------------
+/** Forex rate from USD to a target fiat currency. */
+export const ForexRateSchema = z.object({
+    /** Source currency (always USD). */
+    from: z.literal('USD'),
+    /** Target currency code. */
+    to: CurrencyCodeSchema,
+    /** Exchange rate (1 USD = rate target currency). Positive number. */
+    rate: z.number().positive(),
+    /** Data source: 'coingecko' (fresh from API) or 'cache' (from cache). */
+    source: z.enum(['coingecko', 'cache']),
+    /** Unix timestamp (ms) when rate was fetched. */
+    fetchedAt: z.number().int().positive(),
+    /** Unix timestamp (ms) when this rate expires. */
+    expiresAt: z.number().int().positive(),
+});
+//# sourceMappingURL=forex-rate.types.js.map

package/dist/interfaces/forex-rate.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forex-rate.types.js","sourceRoot":"","sources":["../../src/interfaces/forex-rate.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;IACpE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;IACpE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;IACpE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;IACpE,KAAK,EAAE,KAAK,EAAE,KAAK;CACpB,CAAC,CAAC;AAKH,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,qDAAqD;AACrD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,oCAAoC;IACpC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,4BAA4B;IAC5B,EAAE,EAAE,kBAAkB;IACtB,qEAAqE;IACrE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,yEAAyE;IACzE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACtC,iDAAiD;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACtC,kDAAkD;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC"}

package/dist/interfaces/index.d.ts

@@ -0,0 +1,15 @@
+export type { TokenAmount, TransferRequest, UnsignedTransaction, SimulationResult, SubmitResult, BalanceInfo, HealthInfo, AssetInfo, FeeEstimate, TokenInfo, SweepResult, TokenTransferParams, ContractCallParams, ApproveParams, BatchParams, ParsedOperationType, ParsedOperation, ParsedTransaction, SignedTransaction, } from './chain-adapter.types.js';
+export type { IChainAdapter } from './IChainAdapter.js';
+export type { ILocalKeyStore } from './ILocalKeyStore.js';
+export type { IPolicyEngine, PolicyEvaluation } from './IPolicyEngine.js';
+export type { INotificationChannel, NotificationPayload } from './INotificationChannel.js';
+export type { TokenRef, PriceInfo, CacheStats, IPriceOracle } from './price-oracle.types.js';
+export { TokenRefSchema, PriceInfoSchema } from './price-oracle.types.js';
+export type { ActionProviderMetadata, ActionDefinition, ActionContext, IActionProvider, } from './action-provider.types.js';
+export { ActionProviderMetadataSchema, ActionDefinitionSchema, ActionContextSchema, } from './action-provider.types.js';
+export type { ForexRate, CurrencyCode, IForexRateService } from './forex-rate.types.js';
+export { ForexRateSchema, CurrencyCodeSchema } from './forex-rate.types.js';
+export type { X402FetchRequest, X402FetchResponse, X402PaymentInfo } from './x402.types.js';
+export type { PaymentRequired, PaymentPayload, PaymentRequirements } from './x402.types.js';
+export { X402FetchRequestSchema, X402FetchResponseSchema, X402PaymentInfoSchema, CAIP2_TO_NETWORK, NETWORK_TO_CAIP2, parseCaip2, resolveX402Network, PaymentRequiredV2Schema, PaymentPayloadV2Schema, PaymentRequirementsV2Schema, } from './x402.types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EAET,WAAW,EACX,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,WAAW,EAEX,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAG3F,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1E,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAGpC,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG5E,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC5F,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC"}

package/dist/interfaces/index.js

@@ -0,0 +1,5 @@
+export { TokenRefSchema, PriceInfoSchema } from './price-oracle.types.js';
+export { ActionProviderMetadataSchema, ActionDefinitionSchema, ActionContextSchema, } from './action-provider.types.js';
+export { ForexRateSchema, CurrencyCodeSchema } from './forex-rate.types.js';
+export { X402FetchRequestSchema, X402FetchResponseSchema, X402PaymentInfoSchema, CAIP2_TO_NETWORK, NETWORK_TO_CAIP2, parseCaip2, resolveX402Network, PaymentRequiredV2Schema, PaymentPayloadV2Schema, PaymentRequirementsV2Schema, } from './x402.types.js';
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAS1E,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAK5E,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC"}

package/dist/interfaces/price-oracle.types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Price Oracle types and interfaces (Zod SSoT).
+ *
+ * Defines TokenRef, PriceInfo, CacheStats, and IPriceOracle for the
+ * v1.5 DeFi price oracle subsystem. Actual oracle implementations
+ * (Pyth, CoinGecko) live in the daemon package.
+ *
+ * Source enum: 'pyth' | 'coingecko' | 'cache' (v1.5 decision: no chainlink/jupiter).
+ */
+import { z } from 'zod';
+import type { ChainType } from '../enums/chain.js';
+/** Reference to a token for price lookup. */
+export declare const TokenRefSchema: z.ZodObject<{
+    /** Token address (mint for Solana, contract for EVM). Min 1 char. */
+    address: z.ZodString;
+    /** Token symbol (optional, for display/logging). */
+    symbol: z.ZodOptional<z.ZodString>;
+    /** Decimal places. SOL=9, ETH=18, USDC=6. Range 0-18. */
+    decimals: z.ZodNumber;
+    /** Target chain. */
+    chain: z.ZodEnum<["solana", "ethereum"]>;
+}, "strip", z.ZodTypeAny, {
+    chain: "solana" | "ethereum";
+    address: string;
+    decimals: number;
+    symbol?: string | undefined;
+}, {
+    chain: "solana" | "ethereum";
+    address: string;
+    decimals: number;
+    symbol?: string | undefined;
+}>;
+/** Token reference for price lookup. Derived from TokenRefSchema via z.infer. */
+export type TokenRef = z.infer<typeof TokenRefSchema>;
+/** Price information returned by an oracle. */
+export declare const PriceInfoSchema: z.ZodObject<{
+    /** USD price (non-negative). */
+    usdPrice: z.ZodNumber;
+    /** Price confidence ratio (0-1). Higher = more confident. Optional. */
+    confidence: z.ZodOptional<z.ZodNumber>;
+    /** Data source. v1.5: pyth (primary), coingecko (fallback), cache (from cache). */
+    source: z.ZodEnum<["pyth", "coingecko", "cache"]>;
+    /** Unix timestamp (ms) when price was fetched. Positive integer. */
+    fetchedAt: z.ZodNumber;
+    /** Unix timestamp (ms) when this price expires. Positive integer. */
+    expiresAt: z.ZodNumber;
+    /**
+     * Whether this price observation is past TTL.
+     * Note: isStale=true means past cache TTL (>5min), NOT classifyPriceAge STALE (>30min).
+     * Defaults to false.
+     */
+    isStale: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    expiresAt: number;
+    usdPrice: number;
+    source: "pyth" | "coingecko" | "cache";
+    fetchedAt: number;
+    isStale: boolean;
+    confidence?: number | undefined;
+}, {
+    expiresAt: number;
+    usdPrice: number;
+    source: "pyth" | "coingecko" | "cache";
+    fetchedAt: number;
+    confidence?: number | undefined;
+    isStale?: boolean | undefined;
+}>;
+/** Price information from an oracle source. Derived from PriceInfoSchema via z.infer. */
+export type PriceInfo = z.infer<typeof PriceInfoSchema>;
+/** Cache statistics for monitoring and diagnostics. */
+export interface CacheStats {
+    /** Number of cache hits. */
+    hits: number;
+    /** Number of cache misses. */
+    misses: number;
+    /** Number of stale cache hits (expired but within staleMax). */
+    staleHits: number;
+    /** Current number of entries in cache. */
+    size: number;
+    /** Number of LRU evictions. */
+    evictions: number;
+}
+/**
+ * Price oracle contract.
+ *
+ * Implementations: PythOracle (primary), CoinGeckoOracle (fallback),
+ * OracleChain (composite with fallback + cross-validation).
+ */
+export interface IPriceOracle {
+    /** Get price for a single token. */
+    getPrice(token: TokenRef): Promise<PriceInfo>;
+    /** Get prices for multiple tokens. Returns Map<cacheKey, PriceInfo>. */
+    getPrices(tokens: TokenRef[]): Promise<Map<string, PriceInfo>>;
+    /** Get native token price (SOL or ETH). */
+    getNativePrice(chain: ChainType): Promise<PriceInfo>;
+    /** Get cache statistics. */
+    getCacheStats(): CacheStats;
+}
+//# sourceMappingURL=price-oracle.types.d.ts.map

package/dist/interfaces/price-oracle.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-oracle.types.d.ts","sourceRoot":"","sources":["../../src/interfaces/price-oracle.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAOnD,6CAA6C;AAC7C,eAAO,MAAM,cAAc;IACzB,qEAAqE;;IAErE,oDAAoD;;IAEpD,yDAAyD;;IAEzD,oBAAoB;;;;;;;;;;;;EAEpB,CAAC;AAEH,iFAAiF;AACjF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAMtD,+CAA+C;AAC/C,eAAO,MAAM,eAAe;IAC1B,gCAAgC;;IAEhC,uEAAuE;;IAEvE,mFAAmF;;IAEnF,oEAAoE;;IAEpE,qEAAqE;;IAErE;;;;OAIG;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,yFAAyF;AACzF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9C,wEAAwE;IACxE,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC/D,2CAA2C;IAC3C,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACrD,4BAA4B;IAC5B,aAAa,IAAI,UAAU,CAAC;CAC7B"}

package/dist/interfaces/price-oracle.types.js

@@ -0,0 +1,48 @@
+/**
+ * Price Oracle types and interfaces (Zod SSoT).
+ *
+ * Defines TokenRef, PriceInfo, CacheStats, and IPriceOracle for the
+ * v1.5 DeFi price oracle subsystem. Actual oracle implementations
+ * (Pyth, CoinGecko) live in the daemon package.
+ *
+ * Source enum: 'pyth' | 'coingecko' | 'cache' (v1.5 decision: no chainlink/jupiter).
+ */
+import { z } from 'zod';
+import { ChainTypeEnum } from '../enums/chain.js';
+// ---------------------------------------------------------------------------
+// Zod SSoT: TokenRef
+// ---------------------------------------------------------------------------
+/** Reference to a token for price lookup. */
+export const TokenRefSchema = z.object({
+    /** Token address (mint for Solana, contract for EVM). Min 1 char. */
+    address: z.string().min(1, 'Token address is required'),
+    /** Token symbol (optional, for display/logging). */
+    symbol: z.string().optional(),
+    /** Decimal places. SOL=9, ETH=18, USDC=6. Range 0-18. */
+    decimals: z.number().int().min(0).max(18),
+    /** Target chain. */
+    chain: ChainTypeEnum,
+});
+// ---------------------------------------------------------------------------
+// Zod SSoT: PriceInfo
+// ---------------------------------------------------------------------------
+/** Price information returned by an oracle. */
+export const PriceInfoSchema = z.object({
+    /** USD price (non-negative). */
+    usdPrice: z.number().nonnegative(),
+    /** Price confidence ratio (0-1). Higher = more confident. Optional. */
+    confidence: z.number().min(0).max(1).optional(),
+    /** Data source. v1.5: pyth (primary), coingecko (fallback), cache (from cache). */
+    source: z.enum(['pyth', 'coingecko', 'cache']),
+    /** Unix timestamp (ms) when price was fetched. Positive integer. */
+    fetchedAt: z.number().int().positive(),
+    /** Unix timestamp (ms) when this price expires. Positive integer. */
+    expiresAt: z.number().int().positive(),
+    /**
+     * Whether this price observation is past TTL.
+     * Note: isStale=true means past cache TTL (>5min), NOT classifyPriceAge STALE (>30min).
+     * Defaults to false.
+     */
+    isStale: z.boolean().default(false),
+});
+//# sourceMappingURL=price-oracle.types.js.map

package/dist/interfaces/price-oracle.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-oracle.types.js","sourceRoot":"","sources":["../../src/interfaces/price-oracle.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,qEAAqE;IACrE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;IACvD,oDAAoD;IACpD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,yDAAyD;IACzD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACzC,oBAAoB;IACpB,KAAK,EAAE,aAAa;CACrB,CAAC,CAAC;AAKH,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,+CAA+C;AAC/C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,gCAAgC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IAClC,uEAAuE;IACvE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/C,mFAAmF;IACnF,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC9C,oEAAoE;IACpE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACtC,qEAAqE;IACrE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACtC;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACpC,CAAC,CAAC"}