@pythnetwork/price-pusher 10.3.1 → 11.3.0

package/dist/near/near.cjs

@@ -85,7 +85,8 @@ class NearPricePusher {
                 const outcome = await this.account.updatePriceFeeds(data, updateFee);
                 const failureMessages = [];
                 const is_success = Object.values(outcome.receipts_outcome).reduce((is_success, receipt)=>{
-                    if (Object.prototype.hasOwnProperty.call(receipt.outcome.status, "Failure")) {
+                    if (// biome-ignore lint/suspicious/noPrototypeBuiltins: receipt.outcome.status is ExecutionStatus | ExecutionStatusBasic (string union), which Object.hasOwn rejects at the type level
+                    Object.prototype.hasOwnProperty.call(receipt.outcome.status, "Failure")) {
                         failureMessages.push(receipt.outcome.status);
                         return false;
                     }
@@ -123,31 +124,31 @@ class NearAccount {
     }
     async getPriceUnsafe(priceId) {
         return await this.account.viewFunction({
-            contractId: this.pythAccountId,
-            methodName: "get_price_unsafe",
             args: {
                 price_identifier: priceId
-            }
+            },
+            contractId: this.pythAccountId,
+            methodName: "get_price_unsafe"
         });
     }
     async getUpdateFeeEstimate(data) {
         return await this.account.viewFunction({
-            contractId: this.pythAccountId,
-            methodName: "get_update_fee_estimate",
             args: {
                 data
-            }
+            },
+            contractId: this.pythAccountId,
+            methodName: "get_update_fee_estimate"
         });
     }
     async updatePriceFeeds(data, updateFee) {
         return await this.account.functionCall({
-            contractId: this.pythAccountId,
-            methodName: "update_price_feeds",
             args: {
                 data
             },
+            attachedDeposit: updateFee,
+            contractId: this.pythAccountId,
             gas: "300000000000000",
-            attachedDeposit: updateFee
+            methodName: "update_price_feeds"
         });
     }
     getConnection(network, accountId, nodeUrl, privateKeyPath) {
@@ -163,18 +164,18 @@ class NearAccount {
             const keyStore = new _key_stores.InMemoryKeyStore();
             void keyStore.setKey(network, accountInfo.account_id, keyPair);
             return _nearapijs.Connection.fromConfig({
+                jsvmAccountId: `jsvm.${network}`,
                 networkId: network,
                 provider: {
-                    type: "JsonRpcProvider",
                     args: {
                         url: nodeUrl
-                    }
+                    },
+                    type: "JsonRpcProvider"
                 },
                 signer: {
-                    type: "InMemorySigner",
-                    keyStore
-                },
-                jsvmAccountId: `jsvm.${network}`
+                    keyStore,
+                    type: "InMemorySigner"
+                }
             });
         } else {
             throw new Error("Invalid key file!");

package/dist/near/near.d.ts

@@ -1,4 +1,4 @@
-import { HermesClient } from "@pythnetwork/hermes-client";
+import type { HermesClient } from "@pythnetwork/hermes-client";
 import type { FinalExecutionOutcome } from "near-api-js/lib/providers/provider";
 import type { Logger } from "pino";
 import type { IPricePusher, PriceInfo, PriceItem } from "../interface.js";

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;
     });
@@ -74,12 +74,12 @@ function shouldUpdate(priceConfig, sourceLatestPrice, targetLatestPrice, logger)
     const priceId = priceConfig.id;
     // There is no price to update the target with. So we should not update it.
     if (sourceLatestPrice === undefined) {
-        logger.info(`${priceConfig.alias} (${priceId}) is not available on the source network. Ignoring it.`);
+        logger.warn(`${priceConfig.alias} (${priceId}) is not available on the source network. Ignoring it.`);
         return 2;
     }
     // It means that price never existed there. So we should push the latest price feed.
     if (targetLatestPrice === undefined) {
-        logger.info(`${priceConfig.alias} (${priceId}) is not available on the target network. Pushing the price.`);
+        logger.debug(`${priceConfig.alias} (${priceId}) is not available on the target network. Pushing the price.`);
         return 0;
     }
     // The current price is not newer than the price onchain
@@ -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);
@@ -64,7 +64,9 @@ class PythPriceListener {
             }
         };
         eventSource.onerror = async (error)=>{
-            console.error("Error receiving updates from Hermes:", error);
+            this.logger.error({
+                err: error
+            }, "Error receiving updates from Hermes");
             eventSource.close();
             await (0, _utils.sleep)(5000); // Wait a bit before trying to reconnect
             void this.startListening(); // Attempt to restart the listener

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;