@pythnetwork/price-pusher 10.3.1 → 11.3.0

package/dist/fuel/command.d.ts

@@ -1,18 +1,19 @@
 import type { Options } from "yargs";
 declare const _default: {
-    command: string;
-    describe: string;
     builder: {
         "controller-log-level": Options;
         "log-level": Options;
         "polling-frequency": Options;
         "pushing-frequency": Options;
+        "hermes-access-token": Options;
         "price-service-endpoint": Options;
         "price-config-file": Options;
         endpoint: Options;
         "private-key-file": Options;
         "pyth-contract-address": Options;
     };
+    command: string;
+    describe: string;
     handler: (argv: any) => Promise<void>;
 };
 export default _default;

package/dist/fuel/fuel.d.ts

@@ -1,5 +1,5 @@
-import { HermesClient } from "@pythnetwork/hermes-client";
-import { Provider, Wallet } from "fuels";
+import type { HermesClient } from "@pythnetwork/hermes-client";
+import type { Provider, Wallet } from "fuels";
 import type { Logger } from "pino";
 import type { IPricePusher, PriceInfo, PriceItem } from "../interface.js";
 import { ChainPriceListener } from "../interface.js";

package/dist/injective/command.cjs

@@ -12,12 +12,12 @@ const _nodefs = /*#__PURE__*/ _interop_require_default(require("node:fs"));
 const _networks = require("@injectivelabs/networks");
 const _hermesclient = require("@pythnetwork/hermes-client");
 const _pino = require("pino");
+const _controller = require("../controller.cjs");
 const _options = /*#__PURE__*/ _interop_require_wildcard(require("../options.cjs"));
 const _priceconfig = require("../price-config.cjs");
-const _injective = require("./injective.cjs");
-const _controller = require("../controller.cjs");
 const _pythpricelistener = require("../pyth-price-listener.cjs");
 const _utils = require("../utils.cjs");
+const _injective = require("./injective.cjs");
 function _interop_require_default(obj) {
     return obj && obj.__esModule ? obj : {
         default: obj
@@ -65,34 +65,33 @@ function _interop_require_wildcard(obj, nodeInterop) {
     return newObj;
 }
 const _default = {
-    command: "injective",
-    describe: "run price pusher for injective",
     builder: {
-        "grpc-endpoint": {
-            description: "gRPC endpoint URL for injective. The pusher will periodically" + "poll for updates. The polling interval is configurable via the " + "`polling-frequency` command-line argument.",
-            type: "string",
-            required: true
-        },
-        network: {
-            description: "testnet or mainnet",
-            type: "string",
-            required: true
+        "gas-multiplier": {
+            description: "Gas multiplier to be used for each transaction",
+            type: "number"
         },
         "gas-price": {
             description: "Gas price to be used for each transaction",
             type: "number"
         },
-        "gas-multiplier": {
-            description: "Gas multiplier to be used for each transaction",
-            type: "number"
+        "grpc-endpoint": {
+            description: "gRPC endpoint URL for injective. The pusher will periodically" + "poll for updates. The polling interval is configurable via the " + "`polling-frequency` command-line argument.",
+            required: true,
+            type: "string"
+        },
+        network: {
+            description: "testnet or mainnet",
+            required: true,
+            type: "string"
         },
         "price-ids-process-chunk-size": {
             description: "Set in case we wanna split price feeds updates into chunks to have smaller transactions. Set to -1 to disable chunking.",
-            type: "number",
-            required: false
+            required: false,
+            type: "number"
         },
         ..._options.priceConfigFile,
         ..._options.priceServiceEndpoint,
+        ..._options.hermesAccessToken,
         ..._options.mnemonicFile,
         ..._options.pythContractAddress,
         ..._options.pollingFrequency,
@@ -100,9 +99,11 @@ const _default = {
         ..._options.logLevel,
         ..._options.controllerLogLevel
     },
+    command: "injective",
+    describe: "run price pusher for injective",
     handler: async function(argv) {
         // FIXME: type checks for this
-        const { network, logLevel, gasPrice, grpcEndpoint, mnemonicFile, gasMultiplier, priceConfigFile, pollingFrequency, pushingFrequency, controllerLogLevel, pythContractAddress, priceServiceEndpoint, priceIdsProcessChunkSize } = argv;
+        const { network, logLevel, gasPrice, grpcEndpoint, mnemonicFile, gasMultiplier, priceConfigFile, pollingFrequency, pushingFrequency, controllerLogLevel, pythContractAddress, priceServiceEndpoint, hermesAccessToken, priceIdsProcessChunkSize } = argv;
         const logger = (0, _pino.pino)({
             level: logLevel
         });
@@ -110,11 +111,13 @@ const _default = {
             throw new Error("Please specify network. One of [testnet, mainnet]");
         }
         const priceConfigs = (0, _priceconfig.readPriceConfigFile)(priceConfigFile);
-        const hermesClient = new _hermesclient.HermesClient(priceServiceEndpoint);
+        const hermesClient = new _hermesclient.HermesClient(priceServiceEndpoint, {
+            accessToken: hermesAccessToken
+        });
         const mnemonic = _nodefs.default.readFileSync(mnemonicFile, "utf8").trim();
         let priceItems = priceConfigs.map(({ id, alias })=>({
-                id,
-                alias
+                alias,
+                id
             }));
         // Better to filter out invalid price items before creating the pyth listener
         const { existingPriceItems, invalidPriceItems } = await (0, _utils.filterInvalidPriceItems)(hermesClient, priceItems);
@@ -134,8 +137,8 @@ const _default = {
             module: "InjectivePricePusher"
         }), mnemonic, {
             chainId: (0, _networks.getNetworkInfo)(network).chainId,
-            gasPrice,
             gasMultiplier,
+            gasPrice,
             priceIdsProcessChunkSize
         });
         const controller = new _controller.Controller(priceConfigs, pythListener, injectiveListener, injectivePusher, logger.child({

package/dist/injective/command.d.ts

@@ -1,7 +1,5 @@
 import type { Options } from "yargs";
 declare const _default: {
-    command: string;
-    describe: string;
     builder: {
         "controller-log-level": Options;
         "log-level": Options;
@@ -9,14 +7,17 @@ declare const _default: {
         "polling-frequency": Options;
         "pyth-contract-address": Options;
         "mnemonic-file": Options;
+        "hermes-access-token": Options;
         "price-service-endpoint": Options;
         "price-config-file": Options;
+        "gas-multiplier": Options;
+        "gas-price": Options;
         "grpc-endpoint": Options;
         network: Options;
-        "gas-price": Options;
-        "gas-multiplier": Options;
         "price-ids-process-chunk-size": Options;
     };
+    command: string;
+    describe: string;
     handler: (argv: any) => Promise<void>;
 };
 export default _default;

package/dist/injective/injective.cjs

@@ -85,12 +85,12 @@ class InjectivePricePusher {
         const account = this.accounts[injectiveAddress];
         try {
             const { signBytes, txRaw } = (0, _sdkts.createTransactionFromMsg)({
-                sequence: account.baseAccount.sequence,
                 accountNumber: account.baseAccount.accountNumber,
-                message: msg,
                 chainId: this.chainConfig.chainId,
                 fee: await this.getStdFee(msg, index),
-                pubKey: wallet.toPublicKey().toBase64()
+                message: msg,
+                pubKey: wallet.toPublicKey().toBase64(),
+                sequence: account.baseAccount.sequence
             });
             // eslint-disable-next-line @typescript-eslint/await-thenable
             const sig = await wallet.sign(Buffer.from(signBytes));
@@ -128,12 +128,12 @@ class InjectivePricePusher {
             const updateFeeQueryResponse = await this.getUpdateFee(priceFeedUpdateObject.update_price_feeds.data);
             const wallet = this.getWallet(chunkIndex);
             const msg = _sdkts.MsgExecuteContract.fromJSON({
-                sender: wallet.toAddress().toBech32(),
                 contractAddress: this.pythContractAddress,
-                msg: priceFeedUpdateObject,
                 funds: [
                     updateFeeQueryResponse
-                ]
+                ],
+                msg: priceFeedUpdateObject,
+                sender: wallet.toAddress().toBech32()
             });
             const rs = await this.signAndBroadcastMsg(msg, chunkIndex);
             this.logger.info({
@@ -164,11 +164,11 @@ class InjectivePricePusher {
             throw new Error("Account not found");
         }
         const { txRaw: simulateTxRaw } = (0, _sdkts.createTransactionFromMsg)({
-            sequence: account.baseAccount.sequence,
             accountNumber: account.baseAccount.accountNumber,
-            message: msg,
             chainId: this.chainConfig.chainId,
-            pubKey: wallet.toPublicKey().toBase64()
+            message: msg,
+            pubKey: wallet.toPublicKey().toBase64(),
+            sequence: account.baseAccount.sequence
         });
         try {
             const result = await new _sdkts.TxGrpcApi(this.grpcEndpoint).simulate(simulateTxRaw);
@@ -176,8 +176,8 @@ class InjectivePricePusher {
             const fee = {
                 amount: [
                     {
-                        denom: "inj",
-                        amount: (Number(gas) * this.chainConfig.gasPrice).toFixed(0)
+                        amount: (Number(gas) * this.chainConfig.gasPrice).toFixed(0),
+                        denom: "inj"
                     }
                 ],
                 gas

package/dist/injective/injective.d.ts

@@ -1,7 +1,6 @@
-import type { HexString } from "@pythnetwork/hermes-client";
-import { HermesClient } from "@pythnetwork/hermes-client";
+import type { HermesClient, HexString } from "@pythnetwork/hermes-client";
 import type { Logger } from "pino";
-import type { PriceItem, PriceInfo, IPricePusher } from "../interface.js";
+import type { IPricePusher, PriceInfo, PriceItem } from "../interface.js";
 import { ChainPriceListener } from "../interface.js";
 import type { DurationInSeconds } from "../utils.js";
 type InjectiveConfig = {

package/dist/interface.d.ts

@@ -1,6 +1,6 @@
 import type { HexString, UnixTimestamp } from "@pythnetwork/hermes-client";
 import type { Logger } from "pino";
-import { PricePusherMetrics } from "./metrics.js";
+import type { PricePusherMetrics } from "./metrics.js";
 import type { DurationInSeconds } from "./utils.js";
 export type PriceItem = {
     id: HexString;

package/dist/metrics.cjs

@@ -30,6 +30,11 @@ class PricePusherMetrics {
     targetPriceValue;
     // Wallet metrics
     walletBalance;
+    // Liveness heartbeat
+    loopIterations;
+    // Liveness state for the /live endpoint (threshold set by the controller)
+    lastLoopIterationAt;
+    livenessThresholdMs = 60_000;
     constructor(logger){
         this.logger = logger;
         this.registry = new _promclient.Registry();
@@ -40,88 +45,91 @@ class PricePusherMetrics {
         });
         // Create metrics
         this.lastPublishedTime = new _promclient.Gauge({
-            name: "pyth_price_last_published_time",
             help: "The last published time of a price feed in unix timestamp",
             labelNames: [
-                "price_id",
                 "alias"
             ],
+            name: "pyth_price_last_published_time",
             registers: [
                 this.registry
             ]
         });
         this.priceUpdateAttempts = new _promclient.Counter({
-            name: "pyth_price_update_attempts_total",
             help: "Total number of price update attempts with their trigger condition and status",
             labelNames: [
-                "price_id",
                 "alias",
                 "trigger",
                 "status"
             ],
+            name: "pyth_price_update_attempts_total",
             registers: [
                 this.registry
             ]
         });
         this.priceFeedsTotal = new _promclient.Gauge({
-            name: "pyth_price_feeds_total",
             help: "Total number of price feeds being monitored",
+            name: "pyth_price_feeds_total",
             registers: [
                 this.registry
             ]
         });
         this.sourceTimestamp = new _promclient.Gauge({
-            name: "pyth_source_timestamp",
             help: "Latest source chain price publish timestamp",
             labelNames: [
-                "price_id",
                 "alias"
             ],
+            name: "pyth_source_timestamp",
             registers: [
                 this.registry
             ]
         });
         this.configuredTimeDifference = new _promclient.Gauge({
-            name: "pyth_configured_time_difference",
             help: "Configured time difference threshold between source and target chains",
             labelNames: [
-                "price_id",
                 "alias"
             ],
+            name: "pyth_configured_time_difference",
             registers: [
                 this.registry
             ]
         });
         this.sourcePriceValue = new _promclient.Gauge({
-            name: "pyth_source_price",
             help: "Latest price value from Pyth source",
             labelNames: [
-                "price_id",
                 "alias"
             ],
+            name: "pyth_source_price",
             registers: [
                 this.registry
             ]
         });
         this.targetPriceValue = new _promclient.Gauge({
-            name: "pyth_target_price",
             help: "Latest price value from target chain",
             labelNames: [
-                "price_id",
                 "alias"
             ],
+            name: "pyth_target_price",
             registers: [
                 this.registry
             ]
         });
         // Wallet balance metric
         this.walletBalance = new _promclient.Gauge({
-            name: "pyth_wallet_balance",
             help: "Current wallet balance of the price pusher in native token units",
             labelNames: [
                 "wallet_address",
                 "network"
             ],
+            name: "pyth_wallet_balance",
+            registers: [
+                this.registry
+            ]
+        });
+        // Liveness heartbeat: increments once per controller loop iteration so a
+        // hung (but not crashed) process is detectable via the metric going flat.
+        this.loopIterations = new _promclient.Counter({
+            help: "Total number of controller loop iterations completed (liveness heartbeat)",
+            name: "pyth_pusher_loop_iterations_total",
             registers: [
                 this.registry
             ]
@@ -131,6 +139,18 @@ class PricePusherMetrics {
             res.set("Content-Type", this.registry.contentType);
             res.end(await this.registry.metrics());
         });
+        // Liveness endpoint for the k8s livenessProbe: 200 while the control loop is
+        // progressing, 503 once no iteration has completed within the threshold (hung),
+        // so Kubernetes restarts a hung-but-not-crashed pod.
+        this.server.get("/live", (_, res)=>{
+            const last = this.lastLoopIterationAt;
+            const healthy = last !== undefined && Date.now() - last <= this.livenessThresholdMs;
+            res.status(healthy ? 200 : 503).json({
+                lastLoopIterationAt: last ?? null,
+                status: healthy ? "ok" : "stale",
+                thresholdMs: this.livenessThresholdMs
+            });
+        });
     }
     // Start the metrics server
     start(port) {
@@ -139,68 +159,70 @@ class PricePusherMetrics {
         });
     }
     // Record a successful price update
-    recordPriceUpdate(priceId, alias, trigger = "yes") {
+    recordPriceUpdate(alias, trigger = "yes") {
         this.priceUpdateAttempts.inc({
-            price_id: priceId,
             alias,
-            trigger: trigger.toLowerCase(),
-            status: "success"
+            status: "success",
+            trigger: trigger.toLowerCase()
         });
     }
     // Record update condition status (YES/NO/EARLY)
-    recordUpdateCondition(priceId, alias, condition) {
+    recordUpdateCondition(alias, condition) {
         const triggerLabel = _priceconfig.UpdateCondition[condition].toLowerCase();
         // Only record as 'skipped' when the condition is NO
         if (condition === _priceconfig.UpdateCondition.NO) {
             this.priceUpdateAttempts.inc({
-                price_id: priceId,
                 alias,
-                trigger: triggerLabel,
-                status: "skipped"
+                status: "skipped",
+                trigger: triggerLabel
             });
         }
     // YES and EARLY don't increment the counter here - they'll be counted
     // when recordPriceUpdate or recordPriceUpdateError is called
     }
     // Record a price update error
-    recordPriceUpdateError(priceId, alias, trigger = "yes") {
+    recordPriceUpdateError(alias, trigger = "yes") {
         this.priceUpdateAttempts.inc({
-            price_id: priceId,
             alias,
-            trigger: trigger.toLowerCase(),
-            status: "error"
+            status: "error",
+            trigger: trigger.toLowerCase()
         });
     }
     // Set the number of price feeds
     setPriceFeedsTotal(count) {
         this.priceFeedsTotal.set(count);
     }
+    // Record a completed controller loop iteration (liveness heartbeat)
+    recordLoopIteration() {
+        this.lastLoopIterationAt = Date.now();
+        this.loopIterations.inc();
+    }
+    // Configure how long without a completed loop iteration before /live reports
+    // unhealthy (used by the k8s livenessProbe to restart a hung pod).
+    setLivenessThresholdSeconds(seconds) {
+        this.livenessThresholdMs = seconds * 1000;
+    }
     // Update source, target and configured time difference timestamps
-    updateTimestamps(priceId, alias, targetLatestPricePublishTime, sourceLatestPricePublishTime, priceConfigTimeDifference) {
+    updateTimestamps(alias, targetLatestPricePublishTime, sourceLatestPricePublishTime, priceConfigTimeDifference) {
         this.sourceTimestamp.set({
-            price_id: priceId,
             alias
         }, sourceLatestPricePublishTime);
         this.lastPublishedTime.set({
-            price_id: priceId,
             alias
         }, targetLatestPricePublishTime);
         this.configuredTimeDifference.set({
-            price_id: priceId,
             alias
         }, priceConfigTimeDifference);
     }
     // Update price values
-    updatePriceValues(priceId, alias, sourcePrice, targetPrice) {
+    updatePriceValues(alias, sourcePrice, targetPrice) {
         if (sourcePrice !== undefined) {
             this.sourcePriceValue.set({
-                price_id: priceId,
                 alias
             }, Number(sourcePrice));
         }
         if (targetPrice !== undefined) {
             this.targetPriceValue.set({
-                price_id: priceId,
                 alias
             }, Number(targetPrice));
         }
@@ -210,8 +232,8 @@ class PricePusherMetrics {
         // Convert to number for compatibility with prometheus
         const balanceNum = typeof balance === "bigint" ? Number(balance) / 1e18 : balance;
         this.walletBalance.set({
-            wallet_address: walletAddress,
-            network
+            network,
+            wallet_address: walletAddress
         }, balanceNum);
         this.logger.debug(`Updated wallet balance metric: ${walletAddress} = ${balanceNum}`);
     }

package/dist/metrics.d.ts

@@ -13,13 +13,18 @@ export declare class PricePusherMetrics {
     sourcePriceValue: Gauge;
     targetPriceValue: Gauge;
     walletBalance: Gauge;
+    loopIterations: Counter;
+    private lastLoopIterationAt;
+    private livenessThresholdMs;
     constructor(logger: Logger);
     start(port: number): void;
-    recordPriceUpdate(priceId: string, alias: string, trigger?: string): void;
-    recordUpdateCondition(priceId: string, alias: string, condition: UpdateCondition): void;
-    recordPriceUpdateError(priceId: string, alias: string, trigger?: string): void;
+    recordPriceUpdate(alias: string, trigger?: string): void;
+    recordUpdateCondition(alias: string, condition: UpdateCondition): void;
+    recordPriceUpdateError(alias: string, trigger?: string): void;
     setPriceFeedsTotal(count: number): void;
-    updateTimestamps(priceId: string, alias: string, targetLatestPricePublishTime: number, sourceLatestPricePublishTime: number, priceConfigTimeDifference: number): void;
-    updatePriceValues(priceId: string, alias: string, sourcePrice: string | undefined, targetPrice: string | undefined): void;
+    recordLoopIteration(): void;
+    setLivenessThresholdSeconds(seconds: number): void;
+    updateTimestamps(alias: string, targetLatestPricePublishTime: number, sourceLatestPricePublishTime: number, priceConfigTimeDifference: number): void;
+    updatePriceValues(alias: string, sourcePrice: string | undefined, targetPrice: string | undefined): void;
     updateWalletBalance(walletAddress: string, network: string, balance: bigint | number): void;
 }

package/dist/near/command.cjs

@@ -14,8 +14,8 @@ const _controller = require("../controller.cjs");
 const _options = /*#__PURE__*/ _interop_require_wildcard(require("../options.cjs"));
 const _priceconfig = require("../price-config.cjs");
 const _pythpricelistener = require("../pyth-price-listener.cjs");
-const _near = require("./near.cjs");
 const _utils = require("../utils.cjs");
+const _near = require("./near.cjs");
 function _getRequireWildcardCache(nodeInterop) {
     if (typeof WeakMap !== "function") return null;
     var cacheBabelInterop = new WeakMap();
@@ -58,48 +58,51 @@ function _interop_require_wildcard(obj, nodeInterop) {
     return newObj;
 }
 const _default = {
-    command: "near",
-    describe: "run price pusher for near",
     builder: {
-        "node-url": {
-            description: "NEAR RPC API url. used to make JSON RPC calls to interact with NEAR.",
-            type: "string",
-            required: true
+        "account-id": {
+            description: "payer account identifier.",
+            required: true,
+            type: "string"
         },
         network: {
             description: "testnet or mainnet.",
-            type: "string",
-            required: true
+            required: true,
+            type: "string"
         },
-        "account-id": {
-            description: "payer account identifier.",
-            type: "string",
-            required: true
+        "node-url": {
+            description: "NEAR RPC API url. used to make JSON RPC calls to interact with NEAR.",
+            required: true,
+            type: "string"
         },
         "private-key-path": {
             description: "path to payer private key file.",
-            type: "string",
-            required: false
+            required: false,
+            type: "string"
         },
         ..._options.priceConfigFile,
         ..._options.priceServiceEndpoint,
+        ..._options.hermesAccessToken,
         ..._options.pythContractAddress,
         ..._options.pollingFrequency,
         ..._options.pushingFrequency,
         ..._options.logLevel,
         ..._options.controllerLogLevel
     },
+    command: "near",
+    describe: "run price pusher for near",
     handler: async function(argv) {
         // FIXME: type checks for this
-        const { nodeUrl, network, accountId, privateKeyPath, priceConfigFile, priceServiceEndpoint, pythContractAddress, pushingFrequency, pollingFrequency, logLevel, controllerLogLevel } = argv;
+        const { nodeUrl, network, accountId, privateKeyPath, priceConfigFile, priceServiceEndpoint, hermesAccessToken, pythContractAddress, pushingFrequency, pollingFrequency, logLevel, controllerLogLevel } = argv;
         const logger = (0, _pino.pino)({
             level: logLevel
         });
         const priceConfigs = (0, _priceconfig.readPriceConfigFile)(priceConfigFile);
-        const hermesClient = new _hermesclient.HermesClient(priceServiceEndpoint);
+        const hermesClient = new _hermesclient.HermesClient(priceServiceEndpoint, {
+            accessToken: hermesAccessToken
+        });
         let priceItems = priceConfigs.map(({ id, alias })=>({
-                id,
-                alias
+                alias,
+                id
             }));
         // Better to filter out invalid price items before creating the pyth listener
         const { existingPriceItems, invalidPriceItems } = await (0, _utils.filterInvalidPriceItems)(hermesClient, priceItems);

package/dist/near/command.d.ts

@@ -1,20 +1,21 @@
 import type { Options } from "yargs";
 declare const _default: {
-    command: string;
-    describe: string;
     builder: {
         "controller-log-level": Options;
         "log-level": Options;
         "pushing-frequency": Options;
         "polling-frequency": Options;
         "pyth-contract-address": Options;
+        "hermes-access-token": Options;
         "price-service-endpoint": Options;
         "price-config-file": Options;
-        "node-url": Options;
-        network: Options;
         "account-id": Options;
+        network: Options;
+        "node-url": Options;
         "private-key-path": Options;
     };
+    command: string;
+    describe: string;
     handler: (argv: any) => Promise<void>;
 };
 export default _default;