@pythnetwork/price-pusher 9.1.0 → 9.3.0

package/README.md

@@ -114,6 +114,7 @@ pnpm run start injective --grpc-endpoint https://grpc-endpoint.com \
     --network testnet \
     [--gas-price 160000000] \
     [--gas-multiplier 1.1] \
+    [--priceIds-process-chunk-size 100] \
     [--pushing-frequency 10] \
     [--polling-frequency 5]
 
@@ -259,3 +260,117 @@ pushed twice and you won't pay additional costs most of the time.** However, the
 conditions in the RPCs because they are often behind a load balancer which can sometimes cause rejected
 transactions to land on-chain. You can reduce the chances of additional cost overhead by reducing the
 pushing frequency.
+
+## Prometheus Metrics
+
+The price_pusher now supports Prometheus metrics to monitor the health and performance of the price update service. Metrics are exposed via an HTTP endpoint that can be scraped by Prometheus.
+
+### Available Metrics
+
+The following metrics are available:
+
+- **pyth_price_last_published_time** (Gauge): The last published time of a price feed in unix timestamp, labeled by price_id and alias
+- **pyth_price_update_attempts_total** (Counter): Total number of price update attempts with their trigger condition and status, labeled by price_id, alias, trigger, and status
+- **pyth_price_feeds_total** (Gauge): Total number of price feeds being monitored
+- **pyth_wallet_balance** (Gauge): Current wallet balance of the price pusher in native token units, labeled by wallet_address and network
+
+### Configuration
+
+Metrics are enabled by default and can be configured using the following command-line options:
+
+- `--enable-metrics`: Enable or disable the Prometheus metrics server (default: true)
+- `--metrics-port`: Port for the Prometheus metrics server (default: 9090)
+
+Example:
+
+```bash
+pnpm run dev evm --config config.evm.mainnet.json --metrics-port 9091
+```
+
+### Running Locally with Docker
+
+You can run the monitoring stack (Prometheus and Grafana) using the provided docker-compose configuration:
+
+1. Use the sample docker-compose file for metrics:
+
+```bash
+docker-compose -f docker-compose.metrics.sample.yaml up
+```
+
+This will start:
+- Prometheus server on port 9090 with the alerts configured in alerts.sample.yml
+- Grafana server on port 3000 with default credentials (admin/admin)
+
+The docker-compose.metrics.sample.yaml file includes a pre-configured Grafana dashboard (see the [Dashboard](#dashboard) section below) that displays all the metrics mentioned above. This dashboard provides monitoring of your price pusher operations with panels for configured feeds, active feeds, wallet balance, update statistics, and error tracking. The dashboard is automatically provisioned when you start the stack with docker-compose.
+
+### Example Grafana Queries
+
+Here are some example Grafana queries to monitor your price feeds:
+
+1. Last published time for each price feed:
+
+```
+pyth_price_last_published_time
+```
+
+2. Number of price updates in the last hour:
+
+```
+sum(increase(pyth_price_update_attempts_total{status="success"}[1h]))
+```
+
+3. Price feeds not updated in the last hour:
+
+```
+time() - pyth_price_last_published_time > 3600
+```
+
+4. Distribution of update conditions:
+
+```
+sum by (condition) (increase(pyth_update_conditions_total[$__range]))
+```
+
+5. Monitor wallet balances:
+
+```
+pyth_wallet_balance
+```
+
+6. Detect low wallet balances (below 0.1 tokens):
+
+```
+pyth_wallet_balance < 0.1
+```
+
+### Dashboard
+
+The docker-compose setup includes a pre-configured Grafana dashboard (`grafana-dashboard.sample.json`) that provides monitoring of your price pusher operations. The dashboard includes the following panels:
+
+- **Configured Price Feeds**: Shows the number of price feeds configured in your price-config file.
+- **Active Price Feeds**: Displays the number of price feeds currently being actively monitored.
+- **Time Since Last Update**: Shows how long it's been since the last successful price update was published on-chain.
+- **Price Feeds List**: A table listing all configured price feeds with their details.
+- **Successful Updates (Current Range)**: Graph showing the number of successful price updates over the current range with timeline.
+- **Update Conditions Distribution**: Pie chart showing the distribution of update conditions (YES/NO/EARLY) over the selected time range.
+- **Wallet Balance**: Current balance of your wallet in native token units.
+- **Wallet Balance Over Time**: Graph tracking your wallet balance over time to monitor consumption.
+- **Failed Updates (Current Range)**: Graph showing the number of failed price updates over the current range with timeline.
+
+When you first start the monitoring stack, the dashboard may show "No data" in the panels until the price pusher has been running for some time and has collected sufficient metrics.
+
+This dashboard is automatically provisioned when you start the docker-compose stack and provides visibility into the health and performance of your price pusher deployment.
+
+### Alerting
+
+The price pusher includes pre-configured Prometheus alerting rules in the `alerts.sample.yml` file. These rules monitor various aspects of the price pusher's operation, including:
+
+- Price feeds not being updated for an extended period (>1 hour)
+- High error rates in price update attempts
+- No successful price updates across all feeds in the last 30 minutes
+- Service availability monitoring
+- Low wallet balances with two severity levels:
+  - Warning: Balance below 0.1 native tokens
+  - Critical: Balance below 0.01 native tokens (transactions may fail soon)
+
+When using the docker-compose setup, these alerts are automatically loaded into Prometheus and can be viewed in the Alerting section of Grafana after setting up the Prometheus data source.

package/lib/aptos/balance-tracker.d.ts

@@ -0,0 +1,46 @@
+import { BaseBalanceTracker, BaseBalanceTrackerConfig, IBalanceTracker } from "../interface";
+import { DurationInSeconds } from "../utils";
+import { PricePusherMetrics } from "../metrics";
+import { Logger } from "pino";
+/**
+ * Aptos-specific configuration for balance tracker
+ */
+export interface AptosBalanceTrackerConfig extends BaseBalanceTrackerConfig {
+    /** Aptos node endpoint URL */
+    endpoint: string;
+    /** Aptos account address */
+    address: string;
+    /** Optional decimal places for APT token (default: 8) */
+    decimals?: number;
+}
+/**
+ * Aptos-specific implementation of the balance tracker
+ */
+export declare class AptosBalanceTracker extends BaseBalanceTracker {
+    private client;
+    private aptosAddress;
+    private decimals;
+    constructor(config: AptosBalanceTrackerConfig);
+    /**
+     * Aptos-specific implementation of balance update
+     * Fetches the native APT balance for the configured address
+     */
+    protected updateBalance(): Promise<void>;
+}
+/**
+ * Parameters for creating an Aptos balance tracker
+ */
+export interface CreateAptosBalanceTrackerParams {
+    endpoint: string;
+    address: string;
+    network: string;
+    updateInterval: DurationInSeconds;
+    metrics: PricePusherMetrics;
+    logger: Logger;
+    decimals?: number;
+}
+/**
+ * Factory function to create a balance tracker for Aptos chain
+ */
+export declare function createAptosBalanceTracker(params: CreateAptosBalanceTrackerParams): IBalanceTracker;
+//# sourceMappingURL=balance-tracker.d.ts.map

package/lib/aptos/balance-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance-tracker.d.ts","sourceRoot":"","sources":["../../src/aptos/balance-tracker.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,wBAAwB;IACzE,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,kBAAkB;IACzD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,yBAAyB;IAY7C;;;OAGG;cACa,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAkC/C;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,iBAAiB,CAAC;IAClC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,+BAA+B,GACtC,eAAe,CAUjB"}

package/lib/aptos/balance-tracker.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AptosBalanceTracker = void 0;
+exports.createAptosBalanceTracker = createAptosBalanceTracker;
+const aptos_1 = require("aptos");
+const interface_1 = require("../interface");
+/**
+ * Aptos-specific implementation of the balance tracker
+ */
+class AptosBalanceTracker extends interface_1.BaseBalanceTracker {
+    client;
+    aptosAddress;
+    decimals;
+    constructor(config) {
+        super({
+            ...config,
+            logger: config.logger.child({ module: "AptosBalanceTracker" }),
+        });
+        this.client = new aptos_1.AptosClient(config.endpoint);
+        this.aptosAddress = config.address;
+        // APT has 8 decimal places by default
+        this.decimals = config.decimals ?? 8;
+    }
+    /**
+     * Aptos-specific implementation of balance update
+     * Fetches the native APT balance for the configured address
+     */
+    async updateBalance() {
+        try {
+            // Get account resource to check the balance
+            const accountResource = await this.client.getAccountResource(this.aptosAddress, "0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>");
+            // Extract the balance value from the account resource
+            const rawBalance = accountResource.data.coin.value;
+            // Convert the balance to a bigint
+            const balance = BigInt(rawBalance);
+            // Calculate the normalized balance for display
+            const normalizedBalance = Number(balance) / Math.pow(10, this.decimals);
+            // Update metrics with the new balance
+            this.metrics.updateWalletBalance(this.address, this.network, normalizedBalance);
+            this.logger.debug(`Updated Aptos wallet balance: ${this.address} = ${normalizedBalance.toString()} APT (raw: ${balance.toString()})`);
+        }
+        catch (error) {
+            this.logger.error({ error }, "Error fetching Aptos wallet balance for metrics");
+        }
+    }
+}
+exports.AptosBalanceTracker = AptosBalanceTracker;
+/**
+ * Factory function to create a balance tracker for Aptos chain
+ */
+function createAptosBalanceTracker(params) {
+    return new AptosBalanceTracker({
+        endpoint: params.endpoint,
+        address: params.address,
+        network: params.network,
+        updateInterval: params.updateInterval,
+        metrics: params.metrics,
+        logger: params.logger,
+        decimals: params.decimals,
+    });
+}

package/lib/aptos/command.d.ts

@@ -3,6 +3,8 @@ declare const _default: {
     command: string;
     describe: string;
     builder: {
+        "metrics-port": Options;
+        "enable-metrics": Options;
         "controller-log-level": Options;
         "log-level": Options;
         "pushing-frequency": Options;

package/lib/aptos/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/aptos/command.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;;;;;;;;;;;;;kBAoBvB,OAAO;yCAOP,OAAO;;oBAUiB,GAAG;;AA5BpC,wBAyGE"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/aptos/command.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;;;;;;;;;;;;;;;kBAuBvB,OAAO;yCAOP,OAAO;;oBAYiB,GAAG;;AA9BpC,wBAuIE"}

package/lib/aptos/command.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -36,6 +46,8 @@ const aptos_1 = require("./aptos");
 const aptos_2 = require("aptos");
 const pino_1 = __importDefault(require("pino"));
 const utils_1 = require("../utils");
+const metrics_1 = require("../metrics");
+const balance_tracker_1 = require("./balance-tracker");
 exports.default = {
     command: "aptos",
     describe: "run price pusher for aptos",
@@ -61,13 +73,22 @@ exports.default = {
         ...options.pushingFrequency,
         ...options.logLevel,
         ...options.controllerLogLevel,
+        ...options.enableMetrics,
+        ...options.metricsPort,
     },
     handler: async function (argv) {
         // FIXME: type checks for this
-        const { endpoint, priceConfigFile, priceServiceEndpoint, mnemonicFile, pythContractAddress, pushingFrequency, pollingFrequency, overrideGasPriceMultiplier, logLevel, controllerLogLevel, } = argv;
+        const { endpoint, priceConfigFile, priceServiceEndpoint, mnemonicFile, pythContractAddress, pushingFrequency, pollingFrequency, overrideGasPriceMultiplier, logLevel, controllerLogLevel, enableMetrics, metricsPort, } = argv;
         const logger = (0, pino_1.default)({ level: logLevel });
         const priceConfigs = (0, price_config_1.readPriceConfigFile)(priceConfigFile);
         const hermesClient = new hermes_client_1.HermesClient(priceServiceEndpoint);
+        // Initialize metrics if enabled
+        let metrics;
+        if (enableMetrics) {
+            metrics = new metrics_1.PricePusherMetrics(logger.child({ module: "Metrics" }));
+            metrics.start(metricsPort);
+            logger.info(`Metrics server started on port ${metricsPort}`);
+        }
         const mnemonic = fs_1.default.readFileSync(mnemonicFile, "utf-8").trim();
         const account = aptos_2.AptosAccount.fromDerivePath(aptos_1.APTOS_ACCOUNT_HD_PATH, mnemonic);
         logger.info(`Pushing from account address: ${account.address()}`);
@@ -83,7 +104,23 @@ exports.default = {
         const pythListener = new pyth_price_listener_1.PythPriceListener(hermesClient, priceItems, logger.child({ module: "PythPriceListener" }));
         const aptosListener = new aptos_1.AptosPriceListener(pythContractAddress, endpoint, priceItems, logger.child({ module: "AptosPriceListener" }), { pollingFrequency });
         const aptosPusher = new aptos_1.AptosPricePusher(hermesClient, logger.child({ module: "AptosPricePusher" }), pythContractAddress, endpoint, mnemonic, overrideGasPriceMultiplier);
-        const controller = new controller_1.Controller(priceConfigs, pythListener, aptosListener, aptosPusher, logger.child({ module: "Controller" }, { level: controllerLogLevel }), { pushingFrequency });
+        const controller = new controller_1.Controller(priceConfigs, pythListener, aptosListener, aptosPusher, logger.child({ module: "Controller" }, { level: controllerLogLevel }), {
+            pushingFrequency,
+            metrics,
+        });
+        // Create and start the balance tracker if metrics are enabled
+        if (metrics) {
+            const balanceTracker = (0, balance_tracker_1.createAptosBalanceTracker)({
+                address: account.address().toString(),
+                endpoint,
+                network: "aptos",
+                updateInterval: pushingFrequency,
+                metrics,
+                logger: logger.child({ module: "AptosBalanceTracker" }),
+            });
+            // Start the balance tracker
+            await balanceTracker.start();
+        }
         controller.start();
     },
 };

package/lib/controller.d.ts

@@ -2,6 +2,7 @@ import { DurationInSeconds } from "./utils";
 import { IPriceListener, IPricePusher } from "./interface";
 import { PriceConfig } from "./price-config";
 import { Logger } from "pino";
+import { PricePusherMetrics } from "./metrics";
 export declare class Controller {
     private priceConfigs;
     private sourcePriceListener;
@@ -9,8 +10,10 @@ export declare class Controller {
     private targetChainPricePusher;
     private logger;
     private pushingFrequency;
+    private metrics?;
     constructor(priceConfigs: PriceConfig[], sourcePriceListener: IPriceListener, targetPriceListener: IPriceListener, targetChainPricePusher: IPricePusher, logger: Logger, config: {
         pushingFrequency: DurationInSeconds;
+        metrics?: PricePusherMetrics;
     });
     start(): Promise<void>;
 }

package/lib/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAS,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAiC,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,qBAAa,UAAU;IAGnB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,sBAAsB;IAC9B,OAAO,CAAC,MAAM;IANhB,OAAO,CAAC,gBAAgB,CAAoB;gBAElC,YAAY,EAAE,WAAW,EAAE,EAC3B,mBAAmB,EAAE,cAAc,EACnC,mBAAmB,EAAE,cAAc,EACnC,sBAAsB,EAAE,YAAY,EACpC,MAAM,EAAE,MAAM,EACtB,MAAM,EAAE;QACN,gBAAgB,EAAE,iBAAiB,CAAC;KACrC;IAKG,KAAK;CAgEZ"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAS,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAiC,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,qBAAa,UAAU;IAKnB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,sBAAsB;IAC9B,OAAO,CAAC,MAAM;IARhB,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,OAAO,CAAC,CAAqB;gBAG3B,YAAY,EAAE,WAAW,EAAE,EAC3B,mBAAmB,EAAE,cAAc,EACnC,mBAAmB,EAAE,cAAc,EACnC,sBAAsB,EAAE,YAAY,EACpC,MAAM,EAAE,MAAM,EACtB,MAAM,EAAE;QACN,gBAAgB,EAAE,iBAAiB,CAAC;QACpC,OAAO,CAAC,EAAE,kBAAkB,CAAC;KAC9B;IASG,KAAK;CAqIZ"}

package/lib/controller.js

@@ -10,6 +10,7 @@ class Controller {
     targetChainPricePusher;
     logger;
     pushingFrequency;
+    metrics;
     constructor(priceConfigs, sourcePriceListener, targetPriceListener, targetChainPricePusher, logger, config) {
         this.priceConfigs = priceConfigs;
         this.sourcePriceListener = sourcePriceListener;
@@ -17,6 +18,9 @@ class Controller {
         this.targetChainPricePusher = targetChainPricePusher;
         this.logger = logger;
         this.pushingFrequency = config.pushingFrequency;
+        this.metrics = config.metrics;
+        // Set the number of price feeds if metrics are enabled
+        this.metrics?.setPriceFeedsTotal(this.priceConfigs.length);
     }
     async start() {
         // start the listeners
@@ -34,9 +38,18 @@ class Controller {
             const pubTimesToPush = [];
             for (const priceConfig of this.priceConfigs) {
                 const priceId = priceConfig.id;
+                const alias = priceConfig.alias;
                 const targetLatestPrice = this.targetPriceListener.getLatestPriceInfo(priceId);
                 const sourceLatestPrice = this.sourcePriceListener.getLatestPriceInfo(priceId);
+                // Update metrics for the last published time if available
+                if (this.metrics && targetLatestPrice) {
+                    this.metrics.updateLastPublishedTime(priceId, alias, targetLatestPrice);
+                }
                 const priceShouldUpdate = (0, price_config_1.shouldUpdate)(priceConfig, sourceLatestPrice, targetLatestPrice, this.logger);
+                // Record update condition in metrics
+                if (this.metrics) {
+                    this.metrics.recordUpdateCondition(priceId, alias, priceShouldUpdate);
+                }
                 if (priceShouldUpdate == price_config_1.UpdateCondition.YES) {
                     pushThresholdMet = true;
                 }
@@ -55,7 +68,30 @@ class Controller {
                 }, "Some of the checks triggered pushing update. Will push the updates for some feeds.");
                 // note that the priceIds are without leading "0x"
                 const priceIds = pricesToPush.map((priceConfig) => priceConfig.id);
-                this.targetChainPricePusher.updatePriceFeed(priceIds, pubTimesToPush);
+                try {
+                    await this.targetChainPricePusher.updatePriceFeed(priceIds, pubTimesToPush);
+                    // Record successful updates
+                    if (this.metrics) {
+                        for (const config of pricesToPush) {
+                            const triggerValue = (0, price_config_1.shouldUpdate)(config, this.sourcePriceListener.getLatestPriceInfo(config.id), this.targetPriceListener.getLatestPriceInfo(config.id), this.logger) === price_config_1.UpdateCondition.YES
+                                ? "yes"
+                                : "early";
+                            this.metrics.recordPriceUpdate(config.id, config.alias, triggerValue);
+                        }
+                    }
+                }
+                catch (error) {
+                    this.logger.error({ error, priceIds }, "Error pushing price updates to chain");
+                    // Record errors in metrics
+                    if (this.metrics) {
+                        for (const config of pricesToPush) {
+                            const triggerValue = (0, price_config_1.shouldUpdate)(config, this.sourcePriceListener.getLatestPriceInfo(config.id), this.targetPriceListener.getLatestPriceInfo(config.id), this.logger) === price_config_1.UpdateCondition.YES
+                                ? "yes"
+                                : "early";
+                            this.metrics.recordPriceUpdateError(config.id, config.alias, triggerValue);
+                        }
+                    }
+                }
             }
             else {
                 this.logger.info("None of the checks were triggered. No push needed.");

package/lib/evm/balance-tracker.d.ts

@@ -0,0 +1,42 @@
+import { SuperWalletClient } from "./super-wallet";
+import { BaseBalanceTracker, BaseBalanceTrackerConfig, IBalanceTracker } from "../interface";
+import { DurationInSeconds } from "../utils";
+import { PricePusherMetrics } from "../metrics";
+import { Logger } from "pino";
+/**
+ * EVM-specific configuration for balance tracker
+ */
+export interface EvmBalanceTrackerConfig extends BaseBalanceTrackerConfig {
+    /** EVM wallet client */
+    client: SuperWalletClient;
+    /** EVM address with 0x prefix */
+    address: `0x${string}`;
+}
+/**
+ * EVM-specific implementation of the balance tracker
+ */
+export declare class EvmBalanceTracker extends BaseBalanceTracker {
+    private client;
+    private evmAddress;
+    constructor(config: EvmBalanceTrackerConfig);
+    /**
+     * EVM-specific implementation of balance update
+     */
+    protected updateBalance(): Promise<void>;
+}
+/**
+ * Parameters for creating an EVM balance tracker
+ */
+export interface CreateEvmBalanceTrackerParams {
+    client: SuperWalletClient;
+    address: `0x${string}`;
+    network: string;
+    updateInterval: DurationInSeconds;
+    metrics: PricePusherMetrics;
+    logger: Logger;
+}
+/**
+ * Factory function to create a balance tracker for EVM chains
+ */
+export declare function createEvmBalanceTracker(params: CreateEvmBalanceTrackerParams): IBalanceTracker;
+//# sourceMappingURL=balance-tracker.d.ts.map

package/lib/evm/balance-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance-tracker.d.ts","sourceRoot":"","sources":["../../src/evm/balance-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,wBAAwB;IACxB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iCAAiC;IACjC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,kBAAkB;IACvD,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,UAAU,CAAgB;gBAEtB,MAAM,EAAE,uBAAuB;IAU3C;;OAEG;cACa,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAiB/C;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,iBAAiB,CAAC;IAClC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,6BAA6B,GACpC,eAAe,CASjB"}

package/lib/evm/balance-tracker.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvmBalanceTracker = void 0;
+exports.createEvmBalanceTracker = createEvmBalanceTracker;
+const interface_1 = require("../interface");
+/**
+ * EVM-specific implementation of the balance tracker
+ */
+class EvmBalanceTracker extends interface_1.BaseBalanceTracker {
+    client;
+    evmAddress;
+    constructor(config) {
+        super({
+            ...config,
+            logger: config.logger.child({ module: "EvmBalanceTracker" }),
+        });
+        this.client = config.client;
+        this.evmAddress = config.address;
+    }
+    /**
+     * EVM-specific implementation of balance update
+     */
+    async updateBalance() {
+        try {
+            const balance = await this.client.getBalance({
+                address: this.evmAddress,
+            });
+            this.metrics.updateWalletBalance(this.address, this.network, balance);
+            this.logger.debug(`Updated EVM wallet balance: ${this.address} = ${balance.toString()}`);
+        }
+        catch (error) {
+            this.logger.error({ error }, "Error fetching EVM wallet balance for metrics");
+        }
+    }
+}
+exports.EvmBalanceTracker = EvmBalanceTracker;
+/**
+ * Factory function to create a balance tracker for EVM chains
+ */
+function createEvmBalanceTracker(params) {
+    return new EvmBalanceTracker({
+        client: params.client,
+        address: params.address,
+        network: params.network,
+        updateInterval: params.updateInterval,
+        metrics: params.metrics,
+        logger: params.logger,
+    });
+}

package/lib/evm/command.d.ts

@@ -3,6 +3,8 @@ declare const _default: {
     command: string;
     describe: string;
     builder: {
+        "metrics-port": Options;
+        "enable-metrics": Options;
         "controller-log-level": Options;
         "log-level": Options;
         "pushing-frequency": Options;

package/lib/evm/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/evm/command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;;;;;;;;;;;;;kBAyBvB,OAAO;8BAMP,OAAO;oBAMP,OAAO;yCAUP,OAAO;6CAQP,OAAO;qBAKP,OAAO;qBAKP,OAAO;iCASP,OAAO;;oBAUiB,GAAG;;AAxEpC,wBAgLE"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/evm/command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;;;;;;;;;;;;;;;kBA2BvB,OAAO;8BAMP,OAAO;oBAMP,OAAO;yCAUP,OAAO;6CAQP,OAAO;qBAKP,OAAO;qBAKP,OAAO;iCASP,OAAO;;oBAYiB,GAAG;;AA1EpC,wBA8ME"}

package/lib/evm/command.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -38,6 +48,8 @@ const pino_1 = __importDefault(require("pino"));
 const super_wallet_1 = require("./super-wallet");
 const pyth_contract_1 = require("./pyth-contract");
 const utils_1 = require("../utils");
+const metrics_1 = require("../metrics");
+const balance_tracker_1 = require("./balance-tracker");
 exports.default = {
     command: "evm",
     describe: "run price pusher for evm",
@@ -103,10 +115,12 @@ exports.default = {
         ...options.pushingFrequency,
         ...options.logLevel,
         ...options.controllerLogLevel,
+        ...options.enableMetrics,
+        ...options.metricsPort,
     },
     handler: async function (argv) {
         // FIXME: type checks for this
-        const { endpoint, priceConfigFile, priceServiceEndpoint, mnemonicFile, pythContractAddress, pushingFrequency, pollingFrequency, customGasStation, txSpeed, overrideGasPriceMultiplier, overrideGasPriceMultiplierCap, gasLimit, gasPrice, updateFeeMultiplier, logLevel, controllerLogLevel, } = argv;
+        const { endpoint, priceConfigFile, priceServiceEndpoint, mnemonicFile, pythContractAddress, pushingFrequency, pollingFrequency, customGasStation, txSpeed, overrideGasPriceMultiplier, overrideGasPriceMultiplierCap, gasLimit, gasPrice, updateFeeMultiplier, logLevel, controllerLogLevel, enableMetrics, metricsPort, } = argv;
         console.log("***** priceServiceEndpoint *****", priceServiceEndpoint);
         const logger = (0, pino_1.default)({
             level: logLevel,
@@ -123,6 +137,13 @@ exports.default = {
                 .join(", ")}`);
         }
         priceItems = existingPriceItems;
+        // Initialize metrics if enabled
+        let metrics;
+        if (enableMetrics) {
+            metrics = new metrics_1.PricePusherMetrics(logger.child({ module: "Metrics" }));
+            metrics.start(metricsPort);
+            logger.info(`Metrics server started on port ${metricsPort}`);
+        }
         const pythListener = new pyth_price_listener_1.PythPriceListener(hermesClient, priceItems, logger.child({ module: "PythPriceListener" }));
         const client = await (0, super_wallet_1.createClient)(endpoint, mnemonic);
         const pythContract = (0, pyth_contract_1.createPythContract)(client, pythContractAddress);
@@ -136,7 +157,23 @@ exports.default = {
         });
         const gasStation = (0, custom_gas_station_1.getCustomGasStation)(logger.child({ module: "CustomGasStation" }), customGasStation, txSpeed);
         const evmPusher = new evm_1.EvmPricePusher(hermesClient, client, pythContract, logger.child({ module: "EvmPricePusher" }), overrideGasPriceMultiplier, overrideGasPriceMultiplierCap, updateFeeMultiplier, gasLimit, gasStation, gasPrice);
-        const controller = new controller_1.Controller(priceConfigs, pythListener, evmListener, evmPusher, logger.child({ module: "Controller" }, { level: controllerLogLevel }), { pushingFrequency });
-        controller.start();
+        const controller = new controller_1.Controller(priceConfigs, pythListener, evmListener, evmPusher, logger.child({ module: "Controller" }, { level: controllerLogLevel }), {
+            pushingFrequency,
+            metrics,
+        });
+        // Create and start the balance tracker if metrics are enabled
+        if (metrics) {
+            const balanceTracker = (0, balance_tracker_1.createEvmBalanceTracker)({
+                client,
+                address: client.account.address,
+                network: await client.getChainId().then((id) => id.toString()),
+                updateInterval: pushingFrequency,
+                metrics,
+                logger,
+            });
+            // Start the balance tracker
+            await balanceTracker.start();
+        }
+        await controller.start();
     },
 };

package/lib/evm/pyth-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pyth-contract.d.ts","sourceRoot":"","sources":["../../src/evm/pyth-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,OAAO,EAAE,qBAAqB,EAAE,MAAM,MAAM,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,YAAY,GAAG,qBAAqB,CAC9C,OAAO,OAAO,EACd,iBAAiB,CAClB,CAAC;AAEF,eAAO,MAAM,kBAAkB,WACrB,iBAAiB,WAChB,OAAO,KACf,YAKC,CAAC"}
+{"version":3,"file":"pyth-contract.d.ts","sourceRoot":"","sources":["../../src/evm/pyth-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,OAAO,EAAE,qBAAqB,EAAE,MAAM,MAAM,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,YAAY,GAAG,qBAAqB,CAC9C,OAAO,OAAO,EACd,iBAAiB,CAClB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,iBAAiB,EACzB,SAAS,OAAO,KACf,YAKC,CAAC"}

package/lib/evm/super-wallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"super-wallet.d.ts","sourceRoot":"","sources":["../../src/evm/super-wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,OAAO,EACP,KAAK,EAEL,MAAM,EACN,SAAS,EACT,aAAa,EACb,aAAa,EAGb,SAAS,EACV,MAAM,MAAM,CAAC;AAmBd,MAAM,MAAM,iBAAiB,GAAG,MAAM,CACpC,SAAS,EACT,KAAK,EACL,OAAO,EACP,SAAS,EACT,aAAa,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CACzE,CAAC;AAcF,eAAO,MAAM,YAAY,aACb,MAAM,YACN,MAAM,KACf,OAAO,CAAC,iBAAiB,CAY3B,CAAC"}
+{"version":3,"file":"super-wallet.d.ts","sourceRoot":"","sources":["../../src/evm/super-wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,OAAO,EACP,KAAK,EAEL,MAAM,EACN,SAAS,EACT,aAAa,EACb,aAAa,EAGb,SAAS,EACV,MAAM,MAAM,CAAC;AAmBd,MAAM,MAAM,iBAAiB,GAAG,MAAM,CACpC,SAAS,EACT,KAAK,EACL,OAAO,EACP,SAAS,EACT,aAAa,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CACzE,CAAC;AAcF,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,OAAO,CAAC,iBAAiB,CAY3B,CAAC"}