@pythnetwork/price-pusher 10.3.1 → 10.4.0

package/dist/options.cjs

@@ -15,6 +15,9 @@ _export(exports, {
     get enableMetrics () {
         return enableMetrics;
     },
+    get hermesAccessToken () {
+        return hermesAccessToken;
+    },
     get logLevel () {
         return logLevel;
     },
@@ -43,90 +46,97 @@ _export(exports, {
 const priceServiceEndpoint = {
     "price-service-endpoint": {
         description: "Endpoint URL for the hermes client. e.g: https://endpoint/example",
-        type: "string",
-        required: true
+        required: true,
+        type: "string"
+    }
+};
+const hermesAccessToken = {
+    "hermes-access-token": {
+        description: "Access token to authenticate with Hermes. Sent as a Bearer token in the Authorization header.",
+        required: false,
+        type: "string"
     }
 };
 const pythContractAddress = {
     "pyth-contract-address": {
         description: "Pyth contract address. Provide the network name on which Pyth is deployed " + "or the Pyth contract address if you use a local network.",
-        type: "string",
-        required: true
+        required: true,
+        type: "string"
     }
 };
 const priceConfigFile = {
     "price-config-file": {
         description: "Path to price configuration YAML file.",
-        type: "string",
-        required: true
+        required: true,
+        type: "string"
     }
 };
 const pollingFrequency = {
     "polling-frequency": {
+        default: 5,
         description: "The frequency to poll price info data from the network if the RPC is not a websocket.",
-        type: "number",
         required: false,
-        default: 5
+        type: "number"
     }
 };
 const pushingFrequency = {
     "pushing-frequency": {
+        default: 10,
         description: "The frequency to push prices to the RPC. " + "It is better that the value be greater than the block time of the network, so this program confirms " + "it is updated and does not push it twice.",
-        type: "number",
         required: false,
-        default: 10
+        type: "number"
     }
 };
 const mnemonicFile = {
     "mnemonic-file": {
         description: "Path to payer mnemonic (private key) file.",
-        type: "string",
-        required: true
+        required: true,
+        type: "string"
     }
 };
 const logLevel = {
     "log-level": {
-        description: "Log level",
-        type: "string",
-        required: false,
-        default: "info",
         choices: [
             "trace",
             "debug",
             "info",
             "warn",
             "error"
-        ]
+        ],
+        default: "info",
+        description: "Log level",
+        required: false,
+        type: "string"
     }
 };
 const controllerLogLevel = {
     "controller-log-level": {
-        description: "Log level for the controller.",
-        type: "string",
-        required: false,
-        default: "info",
         choices: [
             "trace",
             "debug",
             "info",
             "warn",
             "error"
-        ]
+        ],
+        default: "info",
+        description: "Log level for the controller.",
+        required: false,
+        type: "string"
     }
 };
 const enableMetrics = {
     "enable-metrics": {
+        default: true,
         description: "Enable Prometheus metrics server",
-        type: "boolean",
         required: false,
-        default: true
+        type: "boolean"
     }
 };
 const metricsPort = {
     "metrics-port": {
+        default: 9090,
         description: "Port for the Prometheus metrics server",
-        type: "number",
         required: false,
-        default: 9090
+        type: "number"
     }
 };

package/dist/options.d.ts

@@ -2,6 +2,9 @@ import type { Options } from "yargs";
 export declare const priceServiceEndpoint: {
     "price-service-endpoint": Options;
 };
+export declare const hermesAccessToken: {
+    "hermes-access-token": Options;
+};
 export declare const pythContractAddress: {
     "pyth-contract-address": Options;
 };

package/dist/price-config.cjs

@@ -30,15 +30,15 @@ function _interop_require_default(obj) {
 }
 const PriceConfigFileSchema = _joi.default.array().items(_joi.default.object({
     alias: _joi.default.string().required(),
-    id: _joi.default.string().regex(/^(0x)?[a-f0-9]{64}$/).required(),
-    time_difference: _joi.default.number().required(),
-    price_deviation: _joi.default.number().required(),
     confidence_ratio: _joi.default.number().required(),
     early_update: _joi.default.object({
-        time_difference: _joi.default.number().optional(),
+        confidence_ratio: _joi.default.number().optional(),
         price_deviation: _joi.default.number().optional(),
-        confidence_ratio: _joi.default.number().optional()
-    }).optional()
+        time_difference: _joi.default.number().optional()
+    }).optional(),
+    id: _joi.default.string().regex(/^(0x)?[a-f0-9]{64}$/).required(),
+    price_deviation: _joi.default.number().required(),
+    time_difference: _joi.default.number().required()
 })).unique("id").unique("alias").required();
 function readPriceConfigFile(path) {
     const priceConfigs = _yaml.default.parse(_nodefs.default.readFileSync(path, "utf8"));
@@ -49,14 +49,14 @@ function readPriceConfigFile(path) {
     return priceConfigs.map((priceConfigRaw)=>{
         const priceConfig = {
             alias: priceConfigRaw.alias,
-            id: (0, _utils.removeLeading0x)(priceConfigRaw.id),
-            timeDifference: priceConfigRaw.time_difference,
-            priceDeviation: priceConfigRaw.price_deviation,
             confidenceRatio: priceConfigRaw.confidence_ratio,
             customEarlyUpdate: priceConfigRaw.early_update !== undefined,
-            earlyUpdateTimeDifference: priceConfigRaw.early_update?.time_difference,
+            earlyUpdateConfidenceRatio: priceConfigRaw.early_update?.confidence_ratio,
             earlyUpdatePriceDeviation: priceConfigRaw.early_update?.price_deviation,
-            earlyUpdateConfidenceRatio: priceConfigRaw.early_update?.confidence_ratio
+            earlyUpdateTimeDifference: priceConfigRaw.early_update?.time_difference,
+            id: (0, _utils.removeLeading0x)(priceConfigRaw.id),
+            priceDeviation: priceConfigRaw.price_deviation,
+            timeDifference: priceConfigRaw.time_difference
         };
         return priceConfig;
     });
@@ -91,8 +91,8 @@ function shouldUpdate(priceConfig, sourceLatestPrice, targetLatestPrice, logger)
     const confidenceRatioPct = Math.abs(Number(sourceLatestPrice.conf) / Number(sourceLatestPrice.price) * 100);
     logger.info({
         sourcePrice: sourceLatestPrice,
-        targetPrice: targetLatestPrice,
-        symbol: priceConfig.alias
+        symbol: priceConfig.alias,
+        targetPrice: targetLatestPrice
     }, `Analyzing price ${priceConfig.alias} (${priceId}). ` + `Time difference: ${timeDifference} (< ${priceConfig.timeDifference}? / early: < ${priceConfig.earlyUpdateTimeDifference}) OR ` + `Price deviation: ${priceDeviationPct.toFixed(5)}% (< ${priceConfig.priceDeviation}%? / early: < ${priceConfig.earlyUpdatePriceDeviation}%?) OR ` + `Confidence ratio: ${confidenceRatioPct.toFixed(5)}% (< ${priceConfig.confidenceRatio}%? / early: < ${priceConfig.earlyUpdateConfidenceRatio}%?)`);
     if (timeDifference >= priceConfig.timeDifference || priceDeviationPct >= priceConfig.priceDeviation || confidenceRatioPct >= priceConfig.confidenceRatio) {
         return 0;

package/dist/pyth-price-listener.cjs

@@ -41,8 +41,8 @@ class PythPriceListener {
     async startListening() {
         this.logger.info(`Starting to listen for price updates from Hermes for ${this.priceIds.length} price feeds.`);
         const eventSource = await this.hermesClient.getPriceUpdatesStream(this.priceIds, {
-            parsed: true,
-            ignoreInvalidPriceIds: true
+            ignoreInvalidPriceIds: true,
+            parsed: true
         });
         eventSource.onmessage = (event)=>{
             const priceUpdates = JSON.parse(event.data);

package/dist/pyth-price-listener.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 { PriceInfo, IPriceListener, PriceItem } from "./interface.js";
+import type { IPriceListener, PriceInfo, PriceItem } from "./interface.js";
 export declare class PythPriceListener implements IPriceListener {
     private hermesClient;
     private priceIds;

package/dist/solana/balance-tracker.cjs

@@ -49,12 +49,12 @@ class SolanaBalanceTracker extends _interface.BaseBalanceTracker {
 }
 function createSolanaBalanceTracker(params) {
     return new SolanaBalanceTracker({
-        connection: params.connection,
-        publicKey: params.publicKey,
         address: params.publicKey.toString(),
-        network: params.network,
-        updateInterval: params.updateInterval,
+        connection: params.connection,
+        logger: params.logger,
         metrics: params.metrics,
-        logger: params.logger
+        network: params.network,
+        publicKey: params.publicKey,
+        updateInterval: params.updateInterval
     });
 }

package/dist/solana/balance-tracker.d.ts

@@ -1,8 +1,8 @@
-import { Connection, PublicKey } from "@solana/web3.js";
+import type { Connection, PublicKey } from "@solana/web3.js";
 import type { Logger } from "pino";
 import type { BaseBalanceTrackerConfig, IBalanceTracker } from "../interface.js";
 import { BaseBalanceTracker } from "../interface.js";
-import { PricePusherMetrics } from "../metrics.js";
+import type { PricePusherMetrics } from "../metrics.js";
 import type { DurationInSeconds } from "../utils.js";
 /**
  * Solana-specific configuration for balance tracker

package/dist/solana/command.cjs

@@ -23,14 +23,14 @@ const _pythsolanareceiver = require("@pythnetwork/pyth-solana-receiver");
 const _web3 = require("@solana/web3.js");
 const _searcher = require("jito-ts/dist/sdk/block-engine/searcher");
 const _pino = require("pino");
+const _controller = require("../controller.cjs");
+const _metrics = require("../metrics.cjs");
 const _options = /*#__PURE__*/ _interop_require_wildcard(require("../options.cjs"));
 const _priceconfig = require("../price-config.cjs");
 const _pythpricelistener = require("../pyth-price-listener.cjs");
-const _solana = require("./solana.cjs");
-const _controller = require("../controller.cjs");
-const _metrics = require("../metrics.cjs");
 const _utils = require("../utils.cjs");
 const _balancetracker = require("./balance-tracker.cjs");
+const _solana = require("./solana.cjs");
 function _interop_require_default(obj) {
     return obj && obj.__esModule ? obj : {
         default: obj
@@ -78,76 +78,85 @@ function _interop_require_wildcard(obj, nodeInterop) {
     return newObj;
 }
 const _default = {
-    command: "solana",
-    describe: "run price pusher for solana",
     builder: {
-        endpoint: {
-            description: "Solana RPC API endpoint",
-            type: "string",
-            required: true
-        },
-        "keypair-file": {
-            description: "Path to a keypair file",
-            type: "string",
-            required: true
-        },
-        "shard-id": {
-            description: "Shard ID",
-            type: "number",
-            required: true
+        "address-lookup-table-account": {
+            description: "The pubkey of the ALT to use when updating price feeds",
+            optional: true,
+            type: "string"
         },
         "compute-unit-price-micro-lamports": {
+            default: 50_000,
             description: "Priority fee per compute unit",
-            type: "number",
-            default: 50_000
+            type: "number"
+        },
+        "dynamic-jito-tips": {
+            default: false,
+            description: "Use dynamic jito tips",
+            type: "boolean"
+        },
+        endpoint: {
+            description: "Solana RPC API endpoint",
+            required: true,
+            type: "string"
+        },
+        "jito-bundle-size": {
+            default: 5,
+            description: "Number of transactions in each Jito bundle",
+            type: "number"
         },
         "jito-endpoints": {
             description: "Jito endpoint(s) - comma-separated list of endpoints",
-            type: "string",
-            optional: true
+            optional: true,
+            type: "string"
         },
         "jito-keypair-file": {
             description: "Path to the jito keypair file (need for grpc authentication)",
-            type: "string",
-            optional: true
+            optional: true,
+            type: "string"
         },
         "jito-tip-lamports": {
             description: "Lamports to tip the jito builder",
-            type: "number",
-            optional: true
+            optional: true,
+            type: "number"
         },
-        "dynamic-jito-tips": {
-            description: "Use dynamic jito tips",
-            type: "boolean",
-            default: false
+        "keypair-file": {
+            description: "Path to a keypair file",
+            required: true,
+            type: "string"
         },
         "max-jito-tip-lamports": {
+            default: _web3.LAMPORTS_PER_SOL / 100,
             description: "Maximum jito tip lamports",
-            type: "number",
-            default: _web3.LAMPORTS_PER_SOL / 100
+            type: "number"
         },
-        "jito-bundle-size": {
-            description: "Number of transactions in each Jito bundle",
-            type: "number",
-            default: 5
+        "pyth-receiver-program-id": {
+            description: "The Pyth receiver program ID to use",
+            optional: true,
+            type: "string"
         },
-        "updates-per-jito-bundle": {
-            description: "Number of price updates in each Jito bundle",
-            type: "number",
-            default: 6
-        },
-        "address-lookup-table-account": {
-            description: "The pubkey of the ALT to use when updating price feeds",
-            type: "string",
-            optional: true
+        "shard-id": {
+            description: "Shard ID",
+            required: true,
+            type: "number"
         },
         "treasury-id": {
             description: "The treasuryId to use. Useful when the corresponding treasury account is indexed in the ALT passed to --address-lookup-table-account. This is a tx size optimization and is optional; if not set, a random treasury account will be used.",
-            type: "number",
-            optional: true
+            optional: true,
+            type: "number"
+        },
+        "updates-per-jito-bundle": {
+            default: 6,
+            description: "Number of price updates in each Jito bundle",
+            type: "number"
+        },
+        "wormhole-program-id": {
+            description: "The Wormhole program ID to use",
+            optional: true,
+            type: "string"
         },
         ..._options.priceConfigFile,
         ..._options.priceServiceEndpoint,
+        ..._options.hermesAccessToken,
         ..._options.pythContractAddress,
         ..._options.pollingFrequency,
         ..._options.pushingFrequency,
@@ -156,13 +165,17 @@ const _default = {
         ..._options.enableMetrics,
         ..._options.metricsPort
     },
+    command: "solana",
+    describe: "run price pusher for solana",
     handler: async function(argv) {
-        const { endpoint, keypairFile, shardId, computeUnitPriceMicroLamports, priceConfigFile, priceServiceEndpoint, pythContractAddress, pushingFrequency, pollingFrequency, jitoEndpoints, jitoKeypairFile, jitoTipLamports, dynamicJitoTips, maxJitoTipLamports, updatesPerJitoBundle, addressLookupTableAccount, treasuryId, logLevel, controllerLogLevel, enableMetrics, metricsPort } = argv;
+        const { endpoint, keypairFile, shardId, computeUnitPriceMicroLamports, priceConfigFile, priceServiceEndpoint, hermesAccessToken, pythContractAddress, pushingFrequency, pollingFrequency, jitoEndpoints, jitoKeypairFile, jitoTipLamports, dynamicJitoTips, maxJitoTipLamports, updatesPerJitoBundle, addressLookupTableAccount, treasuryId, logLevel, controllerLogLevel, enableMetrics, metricsPort, pythReceiverProgramId, wormholeProgramId } = 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
+        });
         // Initialize metrics if enabled
         let metrics;
         if (enableMetrics) {
@@ -173,8 +186,8 @@ const _default = {
             logger.info(`Metrics server started on port ${metricsPort}`);
         }
         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);
@@ -190,19 +203,21 @@ const _default = {
         const connection = new _web3.Connection(endpoint, "processed");
         const pythSolanaReceiver = new _pythsolanareceiver.PythSolanaReceiver({
             connection,
-            wallet,
             pushOracleProgramId: new _web3.PublicKey(pythContractAddress),
-            treasuryId: treasuryId
+            receiverProgramId: pythReceiverProgramId ? new _web3.PublicKey(pythReceiverProgramId) : undefined,
+            treasuryId: treasuryId,
+            wallet,
+            wormholeProgramId: wormholeProgramId ? new _web3.PublicKey(wormholeProgramId) : undefined
         });
         // Create and start the balance tracker if metrics are enabled
         if (metrics) {
             const balanceTracker = (0, _balancetracker.createSolanaBalanceTracker)({
                 connection,
-                publicKey: keypair.publicKey,
-                network: "solana",
-                updateInterval: 60,
+                logger,
                 metrics,
-                logger
+                network: "solana",
+                publicKey: keypair.publicKey,
+                updateInterval: 60
             });
             // Start the balance tracker
             await balanceTracker.start();
@@ -241,8 +256,8 @@ const _default = {
         }, {
             level: controllerLogLevel
         }), {
-            pushingFrequency,
-            metrics: metrics
+            metrics: metrics,
+            pushingFrequency
         });
         void controller.start();
     }

package/dist/solana/command.d.ts

@@ -1,9 +1,7 @@
-import { SearcherClient } from "jito-ts/dist/sdk/block-engine/searcher";
+import type { SearcherClient } from "jito-ts/dist/sdk/block-engine/searcher";
 import type { Logger } from "pino";
 import type { Options } from "yargs";
 declare const _default: {
-    command: string;
-    describe: string;
     builder: {
         "metrics-port": Options;
         "enable-metrics": Options;
@@ -12,22 +10,27 @@ declare const _default: {
         "pushing-frequency": Options;
         "polling-frequency": Options;
         "pyth-contract-address": Options;
+        "hermes-access-token": Options;
         "price-service-endpoint": Options;
         "price-config-file": Options;
-        endpoint: Options;
-        "keypair-file": Options;
-        "shard-id": Options;
+        "address-lookup-table-account": Options;
         "compute-unit-price-micro-lamports": Options;
+        "dynamic-jito-tips": Options;
+        endpoint: Options;
+        "jito-bundle-size": Options;
         "jito-endpoints": Options;
         "jito-keypair-file": Options;
         "jito-tip-lamports": Options;
-        "dynamic-jito-tips": Options;
+        "keypair-file": Options;
         "max-jito-tip-lamports": Options;
-        "jito-bundle-size": Options;
-        "updates-per-jito-bundle": Options;
-        "address-lookup-table-account": Options;
+        "pyth-receiver-program-id": Options;
+        "shard-id": Options;
         "treasury-id": Options;
+        "updates-per-jito-bundle": Options;
+        "wormhole-program-id": Options;
     };
+    command: string;
+    describe: string;
     handler: (argv: any) => Promise<void>;
 };
 export default _default;

package/dist/solana/solana.d.ts

@@ -1,7 +1,7 @@
-import { HermesClient } from "@pythnetwork/hermes-client";
-import { PythSolanaReceiver } from "@pythnetwork/pyth-solana-receiver";
-import { AddressLookupTableAccount } from "@solana/web3.js";
-import { SearcherClient } from "jito-ts/dist/sdk/block-engine/searcher";
+import type { HermesClient } from "@pythnetwork/hermes-client";
+import type { PythSolanaReceiver } from "@pythnetwork/pyth-solana-receiver";
+import type { AddressLookupTableAccount } from "@solana/web3.js";
+import type { SearcherClient } from "jito-ts/dist/sdk/block-engine/searcher";
 import type { Logger } from "pino";
 import type { IPricePusher, PriceInfo, PriceItem } from "../interface.js";
 import { ChainPriceListener } from "../interface.js";

package/dist/sui/balance-tracker.cjs

@@ -48,11 +48,11 @@ class SuiBalanceTracker extends _interface.BaseBalanceTracker {
 }
 function createSuiBalanceTracker(params) {
     return new SuiBalanceTracker({
-        client: params.client,
         address: params.address,
-        network: params.network,
-        updateInterval: params.updateInterval,
+        client: params.client,
+        logger: params.logger,
         metrics: params.metrics,
-        logger: params.logger
+        network: params.network,
+        updateInterval: params.updateInterval
     });
 }

package/dist/sui/balance-tracker.d.ts

@@ -1,8 +1,8 @@
-import { SuiClient } from "@mysten/sui/client";
+import type { SuiClient } from "@mysten/sui/client";
 import type { Logger } from "pino";
 import type { BaseBalanceTrackerConfig, IBalanceTracker } from "../interface.js";
 import { BaseBalanceTracker } from "../interface.js";
-import { PricePusherMetrics } from "../metrics.js";
+import type { PricePusherMetrics } from "../metrics.js";
 import type { DurationInSeconds } from "../utils.js";
 /**
  * Sui-specific configuration for balance tracker