@pioneer-platform/eth-network 8.13.13 → 8.13.15

package/lib/etherscan-api.js

@@ -0,0 +1,103 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTokenTransactionHistory = exports.getETHTransactionHistory = exports.getTokenBalance = exports.getGasOracle = void 0;
+const axios_1 = __importDefault(require("axios"));
+const utils_1 = require("./utils");
+const lib_1 = require("@xchainjs/xchain-util/lib");
+const getApiKeyQueryParameter = (apiKey) => (!!apiKey ? `&apiKey=${apiKey}` : '');
+/**
+ * SafeGasPrice, ProposeGasPrice And FastGasPrice returned in string-Gwei
+ *
+ * @see https://etherscan.io/apis#gastracker
+ *
+ * @param {string} baseUrl The etherscan node url.
+ * @param {string} apiKey The etherscan API key. (optional)
+ * @returns {GasOracleResponse} LastBlock, SafeGasPrice, ProposeGasPrice, FastGasPrice
+ */
+const getGasOracle = (baseUrl, apiKey) => {
+    const url = baseUrl + '/api?module=gastracker&action=gasoracle';
+    return axios_1.default.get(url + getApiKeyQueryParameter(apiKey)).then((response) => response.data.result);
+};
+exports.getGasOracle = getGasOracle;
+/**
+ * Get token balance
+ *
+ * @see https://etherscan.io/apis#tokens
+ *
+ * @param {string} baseUrl The etherscan node url.
+ * @param {string} address The address.
+ * @param {string} assetAddress The token contract address.
+ * @param {string} apiKey The etherscan API key. (optional)
+ * @returns {BigNumberish} The token balance
+ */
+const getTokenBalance = ({ baseUrl, address, assetAddress, apiKey, }) => {
+    const url = baseUrl + `/api?module=account&action=tokenbalance&contractaddress=${assetAddress}&address=${address}`;
+    return axios_1.default.get(url + getApiKeyQueryParameter(apiKey)).then((response) => response.data.result);
+};
+exports.getTokenBalance = getTokenBalance;
+/**
+ * Get ETH transaction history
+ *
+ * @see https://etherscan.io/apis#accounts
+ *
+ * @param {string} baseUrl The etherscan node url.
+ * @param {string} address The address.
+ * @param {TransactionHistoryParam} params The search options.
+ * @param {string} apiKey The etherscan API key. (optional)
+ * @returns {Array<ETHTransactionInfo>} The ETH transaction history
+ */
+const getETHTransactionHistory = async ({ baseUrl, address, page, offset, startblock, endblock, apiKey, }) => {
+    let url = baseUrl + `/api?module=account&action=txlist&sort=desc` + getApiKeyQueryParameter(apiKey);
+    if (address)
+        url += `&address=${address}`;
+    if (offset)
+        url += `&offset=${offset}`;
+    if (page)
+        url += `&page=${page}`;
+    if (startblock)
+        url += `&startblock=${startblock}`;
+    if (endblock)
+        url += `&endblock=${endblock}`;
+    const ethTransactions = await axios_1.default.get(url).then((response) => response.data.result);
+    return (0, utils_1.filterSelfTxs)(ethTransactions)
+        .filter((tx) => !(0, lib_1.bn)(tx.value).isZero())
+        .map(utils_1.getTxFromEthTransaction);
+};
+exports.getETHTransactionHistory = getETHTransactionHistory;
+/**
+ * Get token transaction history
+ *
+ * @see https://etherscan.io/apis#accounts
+ *
+ * @param {string} baseUrl The etherscan node url.
+ * @param {string} address The address.
+ * @param {TransactionHistoryParam} params The search options.
+ * @param {string} apiKey The etherscan API key. (optional)
+ * @returns {Array<Txs>} The token transaction history
+ */
+const getTokenTransactionHistory = async ({ baseUrl, address, assetAddress, page, offset, startblock, endblock, apiKey, }) => {
+    let url = baseUrl + `/api?module=account&action=tokentx&sort=desc` + getApiKeyQueryParameter(apiKey);
+    if (address)
+        url += `&address=${address}`;
+    if (assetAddress)
+        url += `&contractaddress=${assetAddress}`;
+    if (offset)
+        url += `&offset=${offset}`;
+    if (page)
+        url += `&page=${page}`;
+    if (startblock)
+        url += `&startblock=${startblock}`;
+    if (endblock)
+        url += `&endblock=${endblock}`;
+    const tokenTransactions = await axios_1.default.get(url).then((response) => response.data.result);
+    return (0, utils_1.filterSelfTxs)(tokenTransactions)
+        .filter((tx) => !(0, lib_1.bn)(tx.value).isZero())
+        .reduce((acc, cur) => {
+        const tx = (0, utils_1.getTxFromTokenTransaction)(cur);
+        return tx ? [...acc, tx] : acc;
+    }, []);
+};
+exports.getTokenTransactionHistory = getTokenTransactionHistory;

package/lib/index.d.ts

@@ -0,0 +1,146 @@
+import * as ethers from "ethers";
+import { TieredNode } from './types';
+/**
+ * Initialize the ETH network module
+ */
+export declare const init: (settings: any, redis?: any) => Promise<void>;
+/**
+ * Get registered nodes
+ */
+export declare const getNodes: () => TieredNode[];
+/**
+ * Add a single node
+ */
+export declare const addNode: (node: any) => number;
+/**
+ * Add multiple nodes
+ */
+export declare const addNodes: (nodeList: any) => void;
+/**
+ * Get nonce for address
+ */
+export declare const getNonce: (address: string) => Promise<any>;
+/**
+ * Get transaction count by network
+ */
+export declare const getNonceByNetwork: (networkId: string, address: string) => Promise<number>;
+/**
+ * Get current gas price
+ */
+export declare const getGasPrice: () => Promise<any>;
+/**
+ * Get gas price by network - with retry logic across multiple nodes
+ */
+export declare const getGasPriceByNetwork: (networkId: string) => Promise<import("@ethersproject/bignumber/lib/bignumber").BigNumber>;
+/**
+ * Estimate fee for transaction
+ */
+export declare const estimateFee: (asset: any, params: any) => Promise<any>;
+/**
+ * Get ETH balance for address
+ */
+export declare const getBalance: (address: string) => Promise<string>;
+/**
+ * Get balances for multiple addresses
+ */
+export declare const getBalances: (addresses: string[]) => Promise<string[]>;
+/**
+ * Get ERC20 token balance
+ */
+export declare const getBalanceToken: (address: string, tokenAddress: string) => Promise<string>;
+/**
+ * Get ERC20 allowance
+ */
+export declare const getAllowance: (tokenAddress: string, spender: string, sender: string) => Promise<any>;
+/**
+ * Get symbol from contract address
+ */
+export declare const getSymbolFromContract: (contractAddress: string) => Promise<any>;
+/**
+ * Get transaction by hash
+ */
+export declare const getTransaction: (txid: string) => Promise<{
+    tx: any;
+    receipt: any;
+}>;
+/**
+ * Broadcast signed transaction
+ */
+export declare const broadcast: (tx: string) => Promise<any>;
+/**
+ * Get ERC20 transfer data (for building unsigned transactions)
+ */
+export declare const getTransferData: (toAddress: string, amount: string, contractAddress: string) => string;
+/**
+ * Encode memo data for THORChain/Maya swaps
+ */
+export declare const getMemoEncoded: (swap: any) => Promise<string>;
+/**
+ * Get ETH balance by network - with parallel racing logic
+ */
+export declare const getBalanceAddressByNetwork: (networkId: string, address: string) => Promise<string>;
+/**
+ * Get ERC20 token balance by network
+ */
+export declare const getBalanceTokenByNetwork: (networkId: string, address: string, tokenAddress: string) => Promise<string>;
+/**
+ * Get all ERC20 token balances by network (returns empty array for now - requires token list)
+ */
+export declare const getBalanceTokensByNetwork: (networkId: string, address: string) => Promise<any[]>;
+/**
+ * Get ERC20 token decimals by network - CRITICAL for correct amount calculations
+ */
+export declare const getTokenDecimalsByNetwork: (networkId: string, tokenAddress: string) => Promise<number>;
+/**
+ * Get comprehensive ERC20 token metadata from contract address
+ * Fetches name, symbol, decimals, and can check balance for a user address
+ */
+export declare const getTokenMetadata: (networkId: string, contractAddress: string, userAddress?: string) => Promise<any>;
+/**
+ * Get token metadata by network with balance check
+ * Convenience wrapper for getTokenMetadata
+ */
+export declare const getTokenMetadataByNetwork: (networkId: string, contractAddress: string, userAddress?: string) => Promise<any>;
+/**
+ * Estimate gas by network
+ */
+export declare const estimateGasByNetwork: (networkId: string, transaction: any) => Promise<import("@ethersproject/bignumber/lib/bignumber").BigNumber>;
+/**
+ * Broadcast transaction by network
+ */
+export declare const broadcastByNetwork: (networkId: string, signedTx: string) => Promise<{
+    success: boolean;
+    txid: string;
+    transactionHash: string;
+    from: string;
+    to: string;
+    nonce: number;
+    gasLimit: string;
+    gasPrice: string;
+    chainId: number;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: any;
+    txid?: undefined;
+    transactionHash?: undefined;
+    from?: undefined;
+    to?: undefined;
+    nonce?: undefined;
+    gasLimit?: undefined;
+    gasPrice?: undefined;
+    chainId?: undefined;
+}>;
+/**
+ * Get transaction by network and txid
+ */
+export declare const getTransactionByNetwork: (networkId: string, txid: string) => Promise<{
+    tx: ethers.ethers.providers.TransactionResponse;
+    receipt: ethers.ethers.providers.TransactionReceipt;
+}>;
+/**
+ * Get transaction history by network
+ */
+export declare const getTransactionsByNetwork: (networkId: string, address: string, options?: any) => Promise<any>;
+export declare const getBalanceAddress: (address: string) => Promise<string>;
+export declare const getFees: (asset: any, params: any) => Promise<any>;