ActionProxy

Implements IPublicAction

Proxy wrapper for user-defined action handlers with automatic error capture.

Wraps all IPublicAction methods with trycatch to prevent user code errors from crashing the system. All errors are logged, sent to errorEmitter, and returned as null (non-breaking).

Key features:

• Automatic error catching and logging for all action methods
• Safe execution of partial user implementations (missing methods return null)
• Consistent error capture across all action lifecycle events
• Non-breaking failure mode (errors logged but execution continues)

Architecture:

• Private constructor enforces factory pattern via fromInstance()
• Each method checks if target implements the method before calling
• Errors caught with fallback handler (warn log + errorEmitter)
• Returns null on error to prevent undefined behavior

Used by:

• ClientAction to wrap user-provided action handlers
• ActionCoreService to safely invoke action callbacks

Constructor

constructor();
Copy

Properties

_target

_target: Partial<IPublicAction>
Copy

Methods

init

init(): Promise<any>;
Copy

Initializes the action handler with error capture.

Wraps the user's init() method in trycatch to prevent initialization errors from crashing the system. If the target doesn't implement init(), this method safely returns undefined.

signal

signal(event: IStrategyTickResult): Promise<any>;
Copy

Handles signal events from all modes with error capture.

Wraps the user's signal() method to catch and log any errors. Called on every tick/candle when strategy is evaluated.

signalLive

signalLive(event: IStrategyTickResult): Promise<any>;
Copy

Handles signal events from live trading only with error capture.

Wraps the user's signalLive() method to catch and log any errors. Called every tick in live mode.

signalBacktest

signalBacktest(event: IStrategyTickResult): Promise<any>;
Copy

Handles signal events from backtest only with error capture.

Wraps the user's signalBacktest() method to catch and log any errors. Called every candle in backtest mode.

breakevenAvailable

breakevenAvailable(event: BreakevenContract): Promise<any>;
Copy

Handles breakeven events with error capture.

Wraps the user's breakevenAvailable() method to catch and log any errors. Called once per signal when stop-loss is moved to entry price.

partialProfitAvailable

partialProfitAvailable(event: PartialProfitContract): Promise<any>;
Copy

Handles partial profit level events with error capture.

Wraps the user's partialProfitAvailable() method to catch and log any errors. Called once per profit level per signal (10%, 20%, 30%, etc).

partialLossAvailable

partialLossAvailable(event: PartialLossContract): Promise<any>;
Copy

Handles partial loss level events with error capture.

Wraps the user's partialLossAvailable() method to catch and log any errors. Called once per loss level per signal (-10%, -20%, -30%, etc).

pingScheduled

pingScheduled(event: SchedulePingContract): Promise<any>;
Copy

Handles scheduled ping events with error capture.

Wraps the user's pingScheduled() method to catch and log any errors. Called every minute while a scheduled signal is waiting for activation.

pingActive

pingActive(event: ActivePingContract): Promise<any>;
Copy

Handles active ping events with error capture.

Wraps the user's pingActive() method to catch and log any errors. Called every minute while a pending signal is active (position open).

riskRejection

riskRejection(event: RiskContract): Promise<any>;
Copy

Handles risk rejection events with error capture.

Wraps the user's riskRejection() method to catch and log any errors. Called only when signal is rejected by risk management validation.

signalSync

signalSync(event: SignalSyncContract): Promise<void>;
Copy

Gate for position open/close via limit order. NOT wrapped in trycatch — exceptions propagate to CREATE_SYNC_FN.

dispose

dispose(): Promise<any>;
Copy

Cleans up resources with error capture.

Wraps the user's dispose() method to catch and log any errors. Called once when strategy execution ends.

fromInstance

static fromInstance(instance: Partial<IPublicAction>): ActionProxy;
Copy

Creates a new ActionProxy instance wrapping a user-provided action handler.

Factory method enforcing the private constructor pattern. Wraps all methods of the provided instance with error capture.