@waiaas/core 2.11.0-rc.7 → 2.11.0

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

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

package/dist/interfaces/IChainSubscriber.d.ts

@@ -6,7 +6,7 @@ import type { IncomingTransaction } from './chain-subscriber.types.js';
  * Unlike IChainAdapter (stateless RPC calls), IChainSubscriber maintains
  * persistent connections (WebSocket or polling) for real-time detection.
  *
- * v27.1 scope: 6 methods (subscribe/unsubscribe + query + lifecycle).
+ * v32.4: 9 methods (6 base + 3 optional polling/confirmation).
  */
 export interface IChainSubscriber {
     readonly chain: ChainType;
@@ -41,5 +41,23 @@ export interface IChainSubscriber {
      * and release resources. Safe to call multiple times.
      */
     destroy(): Promise<void>;
+    /**
+     * Poll all subscribed wallets for new incoming transactions.
+     * Called by BackgroundWorkers on a configurable interval.
+     * Implemented by both EVM and Solana subscribers.
+     */
+    pollAll?(): Promise<void>;
+    /**
+     * Check whether a transaction has reached finalized confirmation status.
+     * Chain-specific: implemented by SolanaIncomingSubscriber only.
+     * Used by the Solana confirmation worker to update pending TX status.
+     */
+    checkFinalized?(txHash: string): Promise<boolean>;
+    /**
+     * Get the current block number from the chain.
+     * Chain-specific: implemented by EvmIncomingSubscriber only.
+     * Used by the EVM confirmation worker to check block confirmations.
+     */
+    getBlockNumber?(): Promise<bigint>;
 }
 //# sourceMappingURL=IChainSubscriber.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"IChainSubscriber.d.ts","sourceRoot":"","sources":["../../src/interfaces/IChainSubscriber.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAI1B;;;;OAIG;IACH,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,CAAC,EAAE,EAAE,mBAAmB,KAAK,IAAI,GAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAI7C;;;OAGG;IACH,iBAAiB,IAAI,MAAM,EAAE,CAAC;IAI9B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}
+{"version":3,"file":"IChainSubscriber.d.ts","sourceRoot":"","sources":["../../src/interfaces/IChainSubscriber.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAI1B;;;;OAIG;IACH,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,CAAC,EAAE,EAAE,mBAAmB,KAAK,IAAI,GAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAI7C;;;OAGG;IACH,iBAAiB,IAAI,MAAM,EAAE,CAAC;IAI9B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAIzB;;;;OAIG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;;OAIG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElD;;;;OAIG;IACH,cAAc,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACpC"}

package/dist/interfaces/INotificationChannel.d.ts

@@ -29,7 +29,7 @@ export interface NotificationPayload {
 }
 /**
  * Notification channel interface.
- * All notification channels (Telegram, Discord, ntfy.sh) implement this interface.
+ * All notification channels (Telegram, Discord, Slack) implement this interface.
  *
  * Design reference: 35-notification-architecture.md
  */

package/dist/interfaces/action-provider.types.d.ts

@@ -25,6 +25,8 @@ export interface ActionProviderTrackingResult {
 export declare const ActionProviderMetadataSchema: z.ZodObject<{
     /** Provider name: lowercase alphanumeric + underscore, 3-50 chars. */
     name: z.ZodString;
+    /** Human-readable display name for UI/notifications (e.g., "Jupiter Swap", "LI.FI"). */
+    displayName: z.ZodOptional<z.ZodString>;
     /** Human-readable description, 10-500 chars. */
     description: z.ZodString;
     /** SemVer version string. */
@@ -35,8 +37,14 @@ export declare const ActionProviderMetadataSchema: z.ZodObject<{
     mcpExpose: z.ZodDefault<z.ZodBoolean>;
     /** Whether this provider requires an API key. Defaults to false. */
     requiresApiKey: z.ZodDefault<z.ZodBoolean>;
+    /** URL where users can obtain an API key for this provider. */
+    apiKeyUrl: z.ZodOptional<z.ZodString>;
     /** List of required external API identifiers. Defaults to []. */
     requiredApis: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    /** Provider category for grouping (e.g. 'Swap', 'Bridge', 'Staking', 'Lending', 'Yield', 'Perp'). */
+    category: z.ZodOptional<z.ZodString>;
+    /** Settings key override for enable/disable toggle (e.g. 'hyperliquid' for all 3 hyperliquid providers). */
+    enabledKey: z.ZodOptional<z.ZodString>;
     /**
      * Whether this provider requires the wallet's decrypted private key
      * to be injected into ActionContext before resolve().
@@ -54,18 +62,31 @@ export declare const ActionProviderMetadataSchema: z.ZodObject<{
     requiresApiKey: boolean;
     requiredApis: string[];
     requiresSigningKey: boolean;
+    category?: string | undefined;
+    displayName?: string | undefined;
+    apiKeyUrl?: string | undefined;
+    enabledKey?: string | undefined;
 }, {
     name: string;
     version: string;
     description: string;
     chains: ("solana" | "ethereum")[];
+    category?: string | undefined;
+    displayName?: string | undefined;
     mcpExpose?: boolean | undefined;
     requiresApiKey?: boolean | undefined;
+    apiKeyUrl?: string | undefined;
     requiredApis?: string[] | undefined;
+    enabledKey?: string | undefined;
     requiresSigningKey?: boolean | undefined;
 }>;
 /** Action Provider metadata. Derived from ActionProviderMetadataSchema via z.infer. */
 export type ActionProviderMetadata = z.infer<typeof ActionProviderMetadataSchema>;
+/**
+ * Convert snake_case provider name to human-readable Title Case.
+ * e.g., 'jupiter_swap' -> 'Jupiter Swap', 'aave_v3' -> 'Aave V3'
+ */
+export declare function snakeCaseToDisplayName(name: string): string;
 /** Definition of a single action within a provider. */
 export declare const ActionDefinitionSchema: z.ZodObject<{
     /** Action name: lowercase alphanumeric + underscore, 3-50 chars. */

package/dist/interfaces/action-provider.types.d.ts.map

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

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

@@ -17,6 +17,8 @@ import { ChainTypeEnum } from '../enums/chain.js';
 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 display name for UI/notifications (e.g., "Jupiter Swap", "LI.FI"). */
+    displayName: z.string().min(1).max(100).optional(),
     /** Human-readable description, 10-500 chars. */
     description: z.string().min(10).max(500),
     /** SemVer version string. */
@@ -27,8 +29,14 @@ export const ActionProviderMetadataSchema = z.object({
     mcpExpose: z.boolean().default(false),
     /** Whether this provider requires an API key. Defaults to false. */
     requiresApiKey: z.boolean().default(false),
+    /** URL where users can obtain an API key for this provider. */
+    apiKeyUrl: z.string().url().optional(),
     /** List of required external API identifiers. Defaults to []. */
     requiredApis: z.array(z.string()).optional().default([]),
+    /** Provider category for grouping (e.g. 'Swap', 'Bridge', 'Staking', 'Lending', 'Yield', 'Perp'). */
+    category: z.string().min(1).max(50).optional(),
+    /** Settings key override for enable/disable toggle (e.g. 'hyperliquid' for all 3 hyperliquid providers). */
+    enabledKey: z.string().regex(/^[a-z][a-z0-9_]*$/).optional(),
     /**
      * Whether this provider requires the wallet's decrypted private key
      * to be injected into ActionContext before resolve().
@@ -38,6 +46,16 @@ export const ActionProviderMetadataSchema = z.object({
      */
     requiresSigningKey: z.boolean().default(false),
 });
+/**
+ * Convert snake_case provider name to human-readable Title Case.
+ * e.g., 'jupiter_swap' -> 'Jupiter Swap', 'aave_v3' -> 'Aave V3'
+ */
+export function snakeCaseToDisplayName(name) {
+    return name
+        .split('_')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
 // ---------------------------------------------------------------------------
 // Zod SSoT: ActionDefinition
 // ---------------------------------------------------------------------------

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

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

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

@@ -179,6 +179,25 @@ export interface ContractCallParams {
             isWritable: boolean;
         }>;
     }>;
+    /**
+     * Solana-only: Additional instructions to append after the main instruction.
+     * Used for cleanup operations (e.g., Jupiter cleanupInstruction).
+     */
+    postInstructions?: Array<{
+        programId: string;
+        data: Uint8Array;
+        accounts: Array<{
+            pubkey: string;
+            isSigner: boolean;
+            isWritable: boolean;
+        }>;
+    }>;
+    /**
+     * Solana-only: Address Lookup Table (ALT) addresses for v0 transactions.
+     * When provided, the transaction message will be compressed using these lookup tables,
+     * allowing more accounts to fit in a single transaction.
+     */
+    addressLookupTableAddresses?: string[];
 }
 /** Approve request for buildApprove(). */
 export interface ApproveParams {

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

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

@@ -1 +1 @@
-{"version":3,"file":"connection-state.d.ts","sourceRoot":"","sources":["../../src/interfaces/connection-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAMtC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAO/E;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE;IAAE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,EAC5E,MAAM,EAAE,eAAe,EACvB,aAAa,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,EAC/C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CA4Cf"}
+{"version":3,"file":"connection-state.d.ts","sourceRoot":"","sources":["../../src/interfaces/connection-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAMtC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAO/E;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE;IAAE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,EAC5E,MAAM,EAAE,eAAe,EACvB,aAAa,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,EAC/C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/interfaces/connection-state.js

@@ -39,10 +39,7 @@ export function calculateDelay(attempt, config) {
     const jitter = baseDelay * config.jitterFactor * (2 * Math.random() - 1);
     return Math.max(100, Math.floor(baseDelay + jitter));
 }
-/** Internal sleep helper. */
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
+import { sleep } from '../utils/sleep.js';
 /**
  * Reconnection loop that manages the 3-state connection machine.
  *

package/dist/interfaces/connection-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection-state.js","sourceRoot":"","sources":["../../src/interfaces/connection-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoBH;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,QAAQ;IACrB,YAAY,EAAE,GAAG;IACjB,wBAAwB,EAAE,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,MAAuB;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAC5C,MAAM,CAAC,UAAU,CAClB,CAAC;IACF,MAAM,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,6BAA6B;AAC7B,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAA4E,EAC5E,MAAuB,EACvB,aAA+C,EAC/C,MAAoB;IAEpB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB;+FAC2F;IAC3F,MAAM,sBAAsB,GAAG,KAAK,CAAC;IAErC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,aAAa,CAAC,cAAc,CAAC,CAAC;YAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;YAC3B,aAAa,CAAC,WAAW,CAAC,CAAC;YAC3B,MAAM,UAAU,CAAC,iBAAiB,EAAE,CAAC;YAErC,oEAAoE;YACpE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC;YACzC,IAAI,OAAO,IAAI,sBAAsB,EAAE,CAAC;gBACtC,0DAA0D;gBAC1D,OAAO,GAAG,CAAC,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,2EAA2E;gBAC3E,4DAA4D;gBAC5D,OAAO,EAAE,CAAC;gBACV,IAAI,OAAO,IAAI,MAAM,CAAC,wBAAwB,EAAE,CAAC;oBAC/C,aAAa,CAAC,kBAAkB,CAAC,CAAC;gBACpC,CAAC;gBACD,IAAI,OAAO,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;oBAClC,OAAO;gBACT,CAAC;gBACD,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;gBAClD,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;YACV,IAAI,OAAO,IAAI,MAAM,CAAC,wBAAwB,EAAE,CAAC;gBAC/C,aAAa,CAAC,kBAAkB,CAAC,CAAC;YACpC,CAAC;YACD,IAAI,OAAO,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBAClC,OAAO,CAAC,UAAU;YACpB,CAAC;YACD,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"connection-state.js","sourceRoot":"","sources":["../../src/interfaces/connection-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoBH;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,QAAQ;IACrB,YAAY,EAAE,GAAG;IACjB,wBAAwB,EAAE,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,MAAuB;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAC5C,MAAM,CAAC,UAAU,CAClB,CAAC;IACF,MAAM,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAA4E,EAC5E,MAAuB,EACvB,aAA+C,EAC/C,MAAoB;IAEpB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB;+FAC2F;IAC3F,MAAM,sBAAsB,GAAG,KAAK,CAAC;IAErC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,aAAa,CAAC,cAAc,CAAC,CAAC;YAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;YAC3B,aAAa,CAAC,WAAW,CAAC,CAAC;YAC3B,MAAM,UAAU,CAAC,iBAAiB,EAAE,CAAC;YAErC,oEAAoE;YACpE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC;YACzC,IAAI,OAAO,IAAI,sBAAsB,EAAE,CAAC;gBACtC,0DAA0D;gBAC1D,OAAO,GAAG,CAAC,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,2EAA2E;gBAC3E,4DAA4D;gBAC5D,OAAO,EAAE,CAAC;gBACV,IAAI,OAAO,IAAI,MAAM,CAAC,wBAAwB,EAAE,CAAC;oBAC/C,aAAa,CAAC,kBAAkB,CAAC,CAAC;gBACpC,CAAC;gBACD,IAAI,OAAO,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;oBAClC,OAAO;gBACT,CAAC;gBACD,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;gBAClD,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;YACV,IAAI,OAAO,IAAI,MAAM,CAAC,wBAAwB,EAAE,CAAC;gBAC/C,aAAa,CAAC,kBAAkB,CAAC,CAAC;YACpC,CAAC;YACD,IAAI,OAAO,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBAClC,OAAO,CAAC,UAAU;YACpB,CAAC;YACD,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/interfaces/index.d.ts

@@ -1,3 +1,5 @@
+export type { ILogger } from './logger.js';
+export { ConsoleLogger } from './logger.js';
 export type { TokenAmount, TransferRequest, UnsignedTransaction, SimulationResult, SubmitResult, BalanceInfo, HealthInfo, AssetInfo, FeeEstimate, TokenInfo, SweepResult, TokenTransferParams, ContractCallParams, ApproveParams, BatchParams, ParsedOperationType, ParsedOperation, ParsedTransaction, SignedTransaction, NftTransferParams, NftApproveParams, } from './chain-adapter.types.js';
 export type { IChainAdapter, INftApprovalQuery } from './IChainAdapter.js';
 export { hasNftApprovalQuery } from './IChainAdapter.js';
@@ -7,7 +9,7 @@ export type { INotificationChannel, NotificationPayload } from './INotificationC
 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, ApiDirectResult, ActionProviderTrackingResult, } from './action-provider.types.js';
-export { ActionProviderMetadataSchema, ActionDefinitionSchema, ActionContextSchema, isApiDirectResult, } from './action-provider.types.js';
+export { ActionProviderMetadataSchema, ActionDefinitionSchema, ActionContextSchema, isApiDirectResult, snakeCaseToDisplayName, } 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 { IncomingTransaction } from './chain-subscriber.types.js';
@@ -16,10 +18,10 @@ export { type ConnectionState, type ReconnectConfig, calculateDelay, DEFAULT_REC
 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';
-export { Caip2Schema, type Caip2, type Caip2Params, formatCaip2, CAIP19_REGEX, Caip19AssetTypeSchema, Caip19Schema, type Caip19AssetType, type Caip19, type Caip19Params, formatCaip19, parseCaip19, networkToCaip2, caip2ToNetwork, nativeAssetId, tokenAssetId, isNativeAsset, nftAssetId, isNftAsset, } from '../caip/index.js';
+export { Caip2Schema, type Caip2, type Caip2Params, formatCaip2, CAIP19_REGEX, Caip19AssetTypeSchema, Caip19Schema, type Caip19AssetType, type Caip19, type Caip19Params, formatCaip19, parseCaip19, networkToCaip2, caip2ToNetwork, nativeAssetId, tokenAssetId, isNativeAsset, nftAssetId, isNftAsset, parseAssetId, extractNetworkFromAssetId, type ParsedAssetId, enrichBalance, enrichAsset, enrichNft, enrichTransaction, enrichIncomingTx, } from '../caip/index.js';
 export type { LendingPositionSummary, HealthFactor, MarketInfo, ILendingProvider, } from './lending-provider.types.js';
 export { LendingPositionSummarySchema, HealthFactorSchema, MarketInfoSchema, } from './lending-provider.types.js';
-export type { PositionUpdate, IPositionProvider } from './position-provider.types.js';
+export type { PositionUpdate, PositionQueryContext, IPositionProvider } from './position-provider.types.js';
 export type { IDeFiMonitor, MonitorSeverity, MonitorEvaluation } from './defi-monitor.types.js';
 export type { YieldMarketInfo, YieldPositionSummary, YieldForecast, IYieldProvider, } from './yield-provider.types.js';
 export { YieldMarketInfoSchema, YieldPositionSummarySchema, YieldForecastSchema, } from './yield-provider.types.js';

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

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

package/dist/interfaces/index.js

@@ -1,14 +1,17 @@
+export { ConsoleLogger } from './logger.js';
 export { hasNftApprovalQuery } from './IChainAdapter.js';
 export { TokenRefSchema, PriceInfoSchema } from './price-oracle.types.js';
 export { ActionProviderMetadataSchema, ActionDefinitionSchema, ActionContextSchema, 
 // v31.4: type guard for API-direct results
-isApiDirectResult, } from './action-provider.types.js';
+isApiDirectResult, 
+// v32.0: snake_case to display name conversion
+snakeCaseToDisplayName, } from './action-provider.types.js';
 export { ForexRateSchema, CurrencyCodeSchema } from './forex-rate.types.js';
 // v27.1 connection state machine (reconnection infrastructure)
 export { calculateDelay, DEFAULT_RECONNECT_CONFIG, reconnectLoop, } from './connection-state.js';
 export { X402FetchRequestSchema, X402FetchResponseSchema, X402PaymentInfoSchema, CAIP2_TO_NETWORK, NETWORK_TO_CAIP2, parseCaip2, resolveX402Network, PaymentRequiredV2Schema, PaymentPayloadV2Schema, PaymentRequirementsV2Schema, } from './x402.types.js';
 // v27.2 CAIP-2/19 module (Zod schemas, parsers, formatters, network map, asset helpers)
-export { Caip2Schema, formatCaip2, CAIP19_REGEX, Caip19AssetTypeSchema, Caip19Schema, formatCaip19, parseCaip19, networkToCaip2, caip2ToNetwork, nativeAssetId, tokenAssetId, isNativeAsset, nftAssetId, isNftAsset, } from '../caip/index.js';
+export { Caip2Schema, formatCaip2, CAIP19_REGEX, Caip19AssetTypeSchema, Caip19Schema, formatCaip19, parseCaip19, networkToCaip2, caip2ToNetwork, nativeAssetId, tokenAssetId, isNativeAsset, nftAssetId, isNftAsset, parseAssetId, extractNetworkFromAssetId, enrichBalance, enrichAsset, enrichNft, enrichTransaction, enrichIncomingTx, } from '../caip/index.js';
 export { LendingPositionSummarySchema, HealthFactorSchema, MarketInfoSchema, } from './lending-provider.types.js';
 export { YieldMarketInfoSchema, YieldPositionSummarySchema, YieldForecastSchema, } from './yield-provider.types.js';
 export { PerpPositionSummarySchema, MarginInfoSchema, PerpMarketInfoSchema, } from './perp-provider.types.js';

package/dist/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAOzD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAa1E,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB;AACnB,2CAA2C;AAC3C,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAM5E,+DAA+D;AAC/D,OAAO,EAGL,cAAc,EACd,wBAAwB,EACxB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAK/B,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;AAEzB,wFAAwF;AACxF,OAAO,EACL,WAAW,EAGX,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,YAAY,EAIZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,UAAU,GACX,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAerC,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AASnC,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAWlC,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAOzD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAa1E,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB;AACnB,2CAA2C;AAC3C,iBAAiB;AACjB,+CAA+C;AAC/C,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAM5E,+DAA+D;AAC/D,OAAO,EAGL,cAAc,EACd,wBAAwB,EACxB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAK/B,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;AAEzB,wFAAwF;AACxF,OAAO,EACL,WAAW,EAGX,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,YAAY,EAIZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,UAAU,EACV,YAAY,EACZ,yBAAyB,EAEzB,aAAa,EACb,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAerC,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AASnC,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAWlC,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}

package/dist/interfaces/logger.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Logging abstraction interface.
+ * Console-based default implementation provided.
+ * Future: swap with structured logger (pino/winston) without changing call sites.
+ */
+export interface ILogger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+/**
+ * Default console-based logger implementation.
+ * Formats context as JSON suffix when provided.
+ */
+export declare class ConsoleLogger implements ILogger {
+    private readonly prefix?;
+    constructor(prefix?: string | undefined);
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    private format;
+}
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/interfaces/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACjE;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,OAAO;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAP,MAAM,CAAC,EAAE,MAAM,YAAA;IAE5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,OAAO,CAAC,MAAM;CAKf"}

package/dist/interfaces/logger.js

@@ -0,0 +1,28 @@
+/**
+ * Default console-based logger implementation.
+ * Formats context as JSON suffix when provided.
+ */
+export class ConsoleLogger {
+    prefix;
+    constructor(prefix) {
+        this.prefix = prefix;
+    }
+    debug(message, context) {
+        console.debug(this.format(message, context));
+    }
+    info(message, context) {
+        console.info(this.format(message, context));
+    }
+    warn(message, context) {
+        console.warn(this.format(message, context));
+    }
+    error(message, context) {
+        console.error(this.format(message, context));
+    }
+    format(message, context) {
+        const prefix = this.prefix ? `[${this.prefix}] ` : '';
+        const suffix = context ? ` ${JSON.stringify(context)}` : '';
+        return `${prefix}${message}${suffix}`;
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/interfaces/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/interfaces/logger.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,MAAe;QAAf,WAAM,GAAN,MAAM,CAAS;IAAG,CAAC;IAEhD,KAAK,CAAC,OAAe,EAAE,OAAiC;QACtD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,OAAiC;QACrD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,OAAiC;QACrD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,KAAK,CAAC,OAAe,EAAE,OAAiC;QACtD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;IAEO,MAAM,CAAC,OAAe,EAAE,OAAiC;QAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;IACxC,CAAC;CACF"}

package/dist/interfaces/nft-indexer.types.d.ts

@@ -56,8 +56,8 @@ export declare const NftItemSchema: z.ZodObject<{
     standard: "ERC-721" | "ERC-1155" | "METAPLEX";
     contractAddress: string;
     name?: string | undefined;
-    amount?: string | undefined;
     assetId?: string | undefined;
+    amount?: string | undefined;
     description?: string | undefined;
     image?: string | undefined;
     collection?: {
@@ -135,8 +135,8 @@ export declare const NftMetadataSchema: z.ZodObject<{
     standard: "ERC-721" | "ERC-1155" | "METAPLEX";
     contractAddress: string;
     name?: string | undefined;
-    amount?: string | undefined;
     assetId?: string | undefined;
+    amount?: string | undefined;
     description?: string | undefined;
     image?: string | undefined;
     collection?: {
@@ -244,8 +244,8 @@ export declare const NftListResultSchema: z.ZodObject<{
         standard: "ERC-721" | "ERC-1155" | "METAPLEX";
         contractAddress: string;
         name?: string | undefined;
-        amount?: string | undefined;
         assetId?: string | undefined;
+        amount?: string | undefined;
         description?: string | undefined;
         image?: string | undefined;
         collection?: {
@@ -280,8 +280,8 @@ export declare const NftListResultSchema: z.ZodObject<{
         standard: "ERC-721" | "ERC-1155" | "METAPLEX";
         contractAddress: string;
         name?: string | undefined;
-        amount?: string | undefined;
         assetId?: string | undefined;
+        amount?: string | undefined;
         description?: string | undefined;
         image?: string | undefined;
         collection?: {

package/dist/interfaces/perp-provider.types.d.ts

@@ -19,8 +19,8 @@ export declare const PerpPositionSummarySchema: z.ZodObject<{
     margin: z.ZodNullable<z.ZodNumber>;
     liquidationPrice: z.ZodNullable<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    leverage: number;
     market: string;
+    leverage: number;
     size: string;
     direction: "LONG" | "SHORT";
     entryPrice: number | null;
@@ -28,8 +28,8 @@ export declare const PerpPositionSummarySchema: z.ZodObject<{
     margin: number | null;
     liquidationPrice: number | null;
 }, {
-    leverage: number;
     market: string;
+    leverage: number;
     size: string;
     direction: "LONG" | "SHORT";
     entryPrice: number | null;
@@ -66,16 +66,16 @@ export declare const PerpMarketInfoSchema: z.ZodObject<{
     openInterest: z.ZodNullable<z.ZodNumber>;
     oraclePrice: z.ZodNullable<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    maxLeverage: number;
     market: string;
     baseAsset: string;
-    maxLeverage: number;
     fundingRate: number | null;
     openInterest: number | null;
     oraclePrice: number | null;
 }, {
+    maxLeverage: number;
     market: string;
     baseAsset: string;
-    maxLeverage: number;
     fundingRate: number | null;
     openInterest: number | null;
     oraclePrice: number | null;

package/dist/interfaces/position-provider.types.d.ts

@@ -7,6 +7,7 @@
  * Design source: m29-00 design doc section 6.1.
  */
 import type { PositionCategory, PositionStatus } from '../enums/defi.js';
+import type { ChainType, NetworkType, EnvironmentType } from '../enums/chain.js';
 /**
  * Position update data for batch upsert into defi_positions table.
  * Matches defi_positions column structure for direct DB insertion.
@@ -24,6 +25,22 @@ export interface PositionUpdate {
     status: PositionStatus;
     openedAt: number;
     closedAt?: number | null;
+    environment?: string;
+}
+/**
+ * Context passed to IPositionProvider.getPositions() containing wallet
+ * chain/network/environment information needed for multi-chain position queries.
+ *
+ * Constructed by PositionTracker from wallet metadata + RPC config.
+ * @see INTF-01
+ */
+export interface PositionQueryContext {
+    walletId: string;
+    walletAddress: string;
+    chain: ChainType;
+    networks: readonly NetworkType[];
+    environment: EnvironmentType;
+    rpcUrls: Record<string, string>;
 }
 /**
  * Read-only position data source for PositionTracker.
@@ -33,7 +50,7 @@ export interface PositionUpdate {
  * both IActionProvider and IPositionProvider.
  */
 export interface IPositionProvider {
-    getPositions(walletId: string): Promise<PositionUpdate[]>;
+    getPositions(ctx: PositionQueryContext): Promise<PositionUpdate[]>;
     getProviderName(): string;
     getSupportedCategories(): PositionCategory[];
 }

package/dist/interfaces/position-provider.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"position-provider.types.d.ts","sourceRoot":"","sources":["../../src/interfaces/position-provider.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC1D,eAAe,IAAI,MAAM,CAAC;IAC1B,sBAAsB,IAAI,gBAAgB,EAAE,CAAC;CAC9C"}
+{"version":3,"file":"position-provider.types.d.ts","sourceRoot":"","sources":["../../src/interfaces/position-provider.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEjF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,WAAW,EAAE,eAAe,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACnE,eAAe,IAAI,MAAM,CAAC;IAC1B,sBAAsB,IAAI,gBAAgB,EAAE,CAAC;CAC9C"}

package/dist/schemas/incoming-transaction.schema.d.ts

@@ -21,11 +21,11 @@ export declare const IncomingTransactionSchema: z.ZodObject<{
     confirmedAt: z.ZodNullable<z.ZodNumber>;
     isSuspicious: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
+    network: string;
     status: "CONFIRMED" | "DETECTED";
     id: string;
     chain: "solana" | "ethereum";
     walletId: string;
-    network: string;
     fromAddress: string;
     amount: string;
     txHash: string;
@@ -35,11 +35,11 @@ export declare const IncomingTransactionSchema: z.ZodObject<{
     confirmedAt: number | null;
     isSuspicious?: boolean | undefined;
 }, {
+    network: string;
     status: "CONFIRMED" | "DETECTED";
     id: string;
     chain: "solana" | "ethereum";
     walletId: string;
-    network: string;
     fromAddress: string;
     amount: string;
     txHash: string;

package/dist/schemas/index.d.ts

@@ -1,7 +1,7 @@
 export { WalletSchema, type Wallet, CreateWalletRequestSchema, type CreateWalletRequest } from './wallet.schema.js';
 export { SessionSchema, type Session, CreateSessionRequestSchema, type CreateSessionRequest } from './session.schema.js';
 export { TransactionSchema, type Transaction, SendTransactionRequestSchema, type SendTransactionRequest, GasConditionSchema, type GasCondition, TransactionRequestSchema, type TransactionRequest, TransferRequestSchema, type TransferRequestInput, TokenTransferRequestSchema, type TokenTransferRequest, ContractCallRequestSchema, type ContractCallRequest, ApproveRequestSchema, type ApproveRequest, BatchRequestSchema, type BatchRequest, ContractDeployRequestSchema, type ContractDeployRequest, NftTransferRequestSchema, type NftTransferRequest, NftStandardEnum, type NftStandard, NftTokenInfoSchema, type NftTokenInfo, SignMessageRequestSchema, type SignMessageRequest, Eip712TypedDataSchema, type Eip712TypedData, SignTypeEnum, type SignType, } from './transaction.schema.js';
-export { PolicySchema, type Policy, CreatePolicyRequestSchema, type CreatePolicyRequest, UpdatePolicyRequestSchema, type UpdatePolicyRequest, TokenLimitSchema, type TokenLimit, SpendingLimitRulesSchema, type SpendingLimitRules, WhitelistRulesSchema, type WhitelistRules, RateLimitRulesSchema, type RateLimitRules, TimeRestrictionRulesSchema, type TimeRestrictionRules, X402AllowedDomainsRulesSchema, type X402AllowedDomainsRules, } from './policy.schema.js';
+export { PolicySchema, type Policy, CreatePolicyRequestSchema, type CreatePolicyRequest, UpdatePolicyRequestSchema, type UpdatePolicyRequest, TokenLimitSchema, type TokenLimit, SpendingLimitRulesSchema, type SpendingLimitRules, WhitelistRulesSchema, type WhitelistRules, RateLimitRulesSchema, type RateLimitRules, TimeRestrictionRulesSchema, type TimeRestrictionRules, X402AllowedDomainsRulesSchema, type X402AllowedDomainsRules, ReputationThresholdRulesSchema, type ReputationThresholdRules, POLICY_RULES_SCHEMAS, AllowedTokensRulesSchema, type AllowedTokensRules, ContractWhitelistRulesSchema, type ContractWhitelistRules, MethodWhitelistRulesSchema, type MethodWhitelistRules, ApprovedSpendersRulesSchema, type ApprovedSpendersRules, ApproveAmountLimitRulesSchema, type ApproveAmountLimitRules, ApproveTierOverrideRulesSchema, type ApproveTierOverrideRules, AllowedNetworksRulesSchema, type AllowedNetworksRules, LendingAssetWhitelistRulesSchema, type LendingAssetWhitelistRules, LendingLtvLimitRulesSchema, type LendingLtvLimitRules, PerpMaxLeverageRulesSchema, type PerpMaxLeverageRules, PerpMaxPositionUsdRulesSchema, type PerpMaxPositionUsdRules, PerpAllowedMarketsRulesSchema, type PerpAllowedMarketsRules, VenueWhitelistRulesSchema, type VenueWhitelistRules, ActionCategoryLimitRulesSchema, type ActionCategoryLimitRules, } from './policy.schema.js';
 export { ConfigSchema, type Config } from './config.schema.js';
 export { UserOperationV07Schema, UserOpBuildRequestSchema, UserOpBuildResponseSchema, UserOpSignRequestSchema, UserOpSignResponseSchema, type UserOperationV07, type UserOpBuildRequest, type UserOpBuildResponse, type UserOpSignRequest, type UserOpSignResponse, } from './userop.schema.js';
 export { AssetInfoSchema, type AssetInfoDto } from './asset.schema.js';
@@ -9,6 +9,6 @@ export { IncomingTransactionSchema, type IncomingTransaction as IncomingTransact
 export { AuditEventTypeSchema, AuditSeveritySchema, AUDIT_EVENT_TYPES, AUDIT_SEVERITIES, AuditLogItemSchema, AuditLogResponseSchema, AuditLogQuerySchema, type AuditEventType, type AuditSeverity, type AuditLogItem, type AuditLogResponse, type AuditLogQuery, } from './audit.schema.js';
 export { WEBHOOK_EVENT_TYPES, WebhookEventTypeSchema, CreateWebhookRequestSchema, WebhookResponseSchema, CreateWebhookResponseSchema, WEBHOOK_LOG_STATUSES, WebhookLogSchema, WebhookLogQuerySchema, type WebhookEventType, type CreateWebhookRequest, type WebhookResponse, type CreateWebhookResponse, type WebhookLog, type WebhookLogQuery, } from './webhook.schema.js';
 export { AdminStatsTransactionsSchema, AdminStatsSessionsSchema, AdminStatsWalletsSchema, AdminStatsRpcSchema, AdminStatsAutoStopSchema, AdminStatsNotificationsSchema, AdminStatsSystemSchema, AdminStatsResponseSchema, AutoStopRuleInfoSchema, AutoStopRulesResponseSchema, UpdateAutoStopRuleRequestSchema, type AdminStatsResponse, type AutoStopRuleInfo, type AutoStopRulesResponse, type UpdateAutoStopRuleRequest, } from './admin-stats.schema.js';
-export { DryRunSimulationResultSchema, SimulationWarningCodeEnum, PolicyResultSchema, FeeEstimateResultSchema, BalanceChangeSchema, SimulationWarningSchema, SimulationDetailSchema, SimulationMetaSchema, type DryRunSimulationResult, type SimulationWarningCode, type PolicyResult, type FeeEstimateResult, type BalanceChange, type SimulationWarning, type SimulationDetail, type SimulationMeta, } from './simulation.schema.js';
+export { DryRunSimulationResultSchema, SimulationWarningCodeEnum, PolicyResultSchema, FeeEstimateResultSchema, BalanceChangeSchema, SimulationWarningSchema, SimulationDetailSchema, SimulationMetaSchema, GasConditionResultSchema, type GasConditionResult, type DryRunSimulationResult, type SimulationWarningCode, type PolicyResult, type FeeEstimateResult, type BalanceChange, type SimulationWarning, type SimulationDetail, type SimulationMeta, } from './simulation.schema.js';
 export { CredentialTypeEnum, CREDENTIAL_TYPES, CreateCredentialParamsSchema, CredentialMetadataSchema, DecryptedCredentialSchema, type CredentialType, type CreateCredentialParams, type CredentialMetadata, type DecryptedCredential, } from './credential.schema.js';
 //# sourceMappingURL=index.d.ts.map