@covalenthq/client-sdk 0.7.6 → 0.8.1

package/dist/services/XykService.js

@@ -285,6 +285,75 @@ class TokenV2Volume {
         this.total_volume_24h_quote = data.total_volume_24h_quote;
     }
 }
+class NetworkExchangeTokenViewResponse {
+    constructor(data) {
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
+        this.chain_id = data.chain_id;
+        this.chain_name = data.chain_name;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new TokenV2VolumeWithChartData(itemData)) : null;
+        this.pagination = data.pagination && data.pagination !== null ? new Pagination(data.pagination) : null;
+    }
+}
+class TokenV2VolumeWithChartData {
+    constructor(data) {
+        this.chain_name = data.chain_name;
+        this.chain_id = data.chain_id;
+        this.dex_name = data.dex_name;
+        this.contract_address = data.contract_address;
+        this.contract_name = data.contract_name;
+        this.total_liquidity = data.total_liquidity;
+        this.total_volume_24h = data.total_volume_24h;
+        this.logo_url = data.logo_url;
+        this.contract_ticker_symbol = data.contract_ticker_symbol;
+        this.contract_decimals = data.contract_decimals;
+        this.swap_count_24h = data.swap_count_24h;
+        this.quote_rate = data.quote_rate;
+        this.quote_rate_24h = data.quote_rate_24h;
+        this.pretty_quote_rate = data.pretty_quote_rate;
+        this.pretty_quote_rate_24h = data.pretty_quote_rate_24h;
+        this.pretty_total_liquidity_quote = data.pretty_total_liquidity_quote;
+        this.pretty_total_volume_24h_quote = data.pretty_total_volume_24h_quote;
+        this.total_liquidity_quote = data.total_liquidity_quote;
+        this.total_volume_24h_quote = data.total_volume_24h_quote;
+        this.transactions_24h = data.transactions_24h;
+        this.volume_timeseries_7d = data.volume_timeseries_7d && data.volume_timeseries_7d !== null ? data.volume_timeseries_7d.map((itemData) => new VolumeTokenTimeseries(itemData)) : null;
+        this.volume_timeseries_30d = data.volume_timeseries_30d && data.volume_timeseries_30d !== null ? data.volume_timeseries_30d.map((itemData) => new VolumeTokenTimeseries(itemData)) : null;
+        this.liquidity_timeseries_7d = data.liquidity_timeseries_7d && data.liquidity_timeseries_7d !== null ? data.liquidity_timeseries_7d.map((itemData) => new LiquidityTokenTimeseries(itemData)) : null;
+        this.liquidity_timeseries_30d = data.liquidity_timeseries_30d && data.liquidity_timeseries_30d !== null ? data.liquidity_timeseries_30d.map((itemData) => new LiquidityTokenTimeseries(itemData)) : null;
+        this.price_timeseries_7d = data.price_timeseries_7d && data.price_timeseries_7d !== null ? data.price_timeseries_7d.map((itemData) => new PriceTokenTimeseries(itemData)) : null;
+        this.price_timeseries_30d = data.price_timeseries_30d && data.price_timeseries_30d !== null ? data.price_timeseries_30d.map((itemData) => new PriceTokenTimeseries(itemData)) : null;
+    }
+}
+class VolumeTokenTimeseries {
+    constructor(data) {
+        this.dex_name = data.dex_name;
+        this.chain_id = data.chain_id;
+        this.dt = data.dt;
+        this.total_volume = data.total_volume;
+        this.volume_quote = data.volume_quote;
+        this.pretty_volume_quote = data.pretty_volume_quote;
+    }
+}
+class LiquidityTokenTimeseries {
+    constructor(data) {
+        this.dex_name = data.dex_name;
+        this.chain_id = data.chain_id;
+        this.dt = data.dt;
+        this.total_liquidity = data.total_liquidity;
+        this.liquidity_quote = data.liquidity_quote;
+        this.pretty_liquidity_quote = data.pretty_liquidity_quote;
+    }
+}
+class PriceTokenTimeseries {
+    constructor(data) {
+        this.dex_name = data.dex_name;
+        this.chain_id = data.chain_id;
+        this.dt = data.dt;
+        this.quote_currency = data.quote_currency;
+        this.quote_rate = data.quote_rate;
+        this.pretty_quote_rate = data.pretty_quote_rate;
+    }
+}
 class SupportedDexesResponse {
     constructor(data) {
         this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
@@ -383,6 +452,15 @@ class TransactionsForExchangeResponse {
         this.pagination = data.pagination && data.pagination !== null ? new Pagination(data.pagination) : null;
     }
 }
+class NetworkTransactionsResponse {
+    constructor(data) {
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
+        this.chain_id = data.chain_id;
+        this.chain_name = data.chain_name;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new ExchangeTransaction(itemData)) : null;
+        this.pagination = data.pagination && data.pagination !== null ? new Pagination(data.pagination) : null;
+    }
+}
 class EcosystemChartDataResponse {
     constructor(data) {
         this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
@@ -452,12 +530,13 @@ class HealthData {
  *
  */
 export class XykService {
-    constructor(apiKey, debug = false, threadCount = 3, is_key_valid, enableRetry = true) {
+    constructor(apiKey, debug = false, threadCount = 3, is_key_valid, enableRetry = true, source) {
         this.apiKey = apiKey;
         this.debug = debug;
         this.threadCount = threadCount;
         this.is_key_valid = is_key_valid;
         this.enableRetry = enableRetry;
+        this.source = source;
         this.LIMIT = pLimit(this.threadCount);
     }
     /**
@@ -466,9 +545,12 @@ export class XykService {
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} dexName - The DEX name eg: `uniswap_v2`.
+     * @param {GetPoolsQueryParamOpts} queryParamOpts
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
      *
      */
-    async getPools(chainName, dexName) {
+    async getPools(chainName, dexName, queryParamOpts) {
         let success = false;
         let data;
         let response;
@@ -476,6 +558,12 @@ export class XykService {
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
+                if (queryParamOpts?.pageSize !== undefined) {
+                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
+                }
+                if (queryParamOpts?.pageNumber !== undefined) {
+                    urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
+                }
                 const url = `https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/pools/?${urlParams}`;
                 if (!this.is_key_valid) {
                     return {
@@ -492,13 +580,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/pools/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -566,13 +654,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/address/${poolAddress}/dex_name/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -641,13 +729,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/pools/address/${poolAddress}/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -692,6 +780,8 @@ export class XykService {
      * @param {number} page - The requested 0-indexed page number.
      * @param {GetPoolsForTokenAddressQueryParamOpts} queryParamOpts
      *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `dexName`: The DEX name eg: `uniswap_v2`.
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
      *
      */
     async getPoolsForTokenAddress(chainName, tokenAddress, page, queryParamOpts) {
@@ -716,6 +806,9 @@ export class XykService {
                 if (queryParamOpts?.dexName !== undefined) {
                     urlParams.append("dex-name", queryParamOpts?.dexName.toString());
                 }
+                if (queryParamOpts?.pageSize !== undefined) {
+                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
+                }
                 const url = `https://api.covalenthq.com/v1/${chainName}/xy=k/tokens/address/${tokenAddress}/pools/page/${page}/?${urlParams}`;
                 let startTime;
                 if (this.debug) {
@@ -724,13 +817,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/tokens/address/${tokenAddress}/pools/page/${page}/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -799,13 +892,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/address/${accountAddress}/balances/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -851,6 +944,8 @@ export class XykService {
      * @param {GetPoolsForWalletAddressQueryParamOpts} queryParamOpts
      *   - `tokenAddress`: The token contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
      *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `dexName`: The DEX name eg: `uniswap_v2`.
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
      *
      */
     async getPoolsForWalletAddress(chainName, walletAddress, page, queryParamOpts) {
@@ -878,6 +973,9 @@ export class XykService {
                 if (queryParamOpts?.dexName !== undefined) {
                     urlParams.append("dex-name", queryParamOpts?.dexName.toString());
                 }
+                if (queryParamOpts?.pageSize !== undefined) {
+                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
+                }
                 const url = `https://api.covalenthq.com/v1/${chainName}/xy=k/address/${walletAddress}/pools/page/${page}/?${urlParams}`;
                 let startTime;
                 if (this.debug) {
@@ -886,13 +984,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/address/${walletAddress}/pools/page/${page}/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -934,9 +1032,12 @@ export class XykService {
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} dexName - The DEX name eg: `uniswap_v2`.
+     * @param {GetNetworkExchangeTokensQueryParamOpts} queryParamOpts
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
      *
      */
-    async getNetworkExchangeTokens(chainName, dexName) {
+    async getNetworkExchangeTokens(chainName, dexName, queryParamOpts) {
         let success = false;
         let data;
         let response;
@@ -944,6 +1045,12 @@ export class XykService {
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
+                if (queryParamOpts?.pageSize !== undefined) {
+                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
+                }
+                if (queryParamOpts?.pageNumber !== undefined) {
+                    urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
+                }
                 if (!this.is_key_valid) {
                     return {
                         data: null,
@@ -960,13 +1067,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/tokens/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -1002,6 +1109,86 @@ export class XykService {
             }
         }
     }
+    /**
+     *
+     * Commonly used to get a detailed view for a single liquidity pool token. Includes time series data.
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} dexName - The DEX name eg: `uniswap_v2`.
+     * @param {string} tokenAddress - The token contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetLpTokenViewQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *
+     */
+    async getLpTokenView(chainName, dexName, tokenAddress, queryParamOpts) {
+        let success = false;
+        let data;
+        let response;
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
+        while (!success) {
+            try {
+                const urlParams = new URLSearchParams();
+                if (!this.is_key_valid) {
+                    return {
+                        data: null,
+                        error: true,
+                        error_code: 401,
+                        error_message: ApiKeyValidator.INVALID_API_KEY_MESSAGE
+                    };
+                }
+                if (queryParamOpts?.quoteCurrency !== undefined) {
+                    urlParams.append("quote-currency", queryParamOpts?.quoteCurrency.toString());
+                }
+                const url = `https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/tokens/address/${tokenAddress}/view/?${urlParams}`;
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/tokens/address/${tokenAddress}/view/?${urlParams}`, {
+                    headers: {
+                        "Authorization": `Bearer ${this.apiKey}`,
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
+                    }
+                }));
+                debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
+                if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
+                    try {
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
+                    }
+                    catch (error) {
+                        success = true;
+                        return {
+                            data: null,
+                            error: true,
+                            error_code: response.status ?? 429,
+                            error_message: error.message
+                        };
+                    }
+                }
+                else {
+                    data = await response.json();
+                }
+                const dataClass = new NetworkExchangeTokenViewResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
+            }
+            catch (error) {
+                success = true;
+                return {
+                    data: null,
+                    error: true,
+                    error_code: error.cause ? error.cause.code : data ? data.error_code : response ? response.status : "Unknown Error Code",
+                    error_message: error.cause ? error.cause.message : data ? data.error_message : response && response.status === 500 ? "Internal server error" : !response ? "Unknown Error" : "401 Authorization Required"
+                };
+            }
+        }
+    }
     /**
      *
      * Commonly used to get all the supported DEXs available for the xy=k endpoints, along with the swap fees and factory addresses.
@@ -1032,13 +1219,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/xy=k/supported_dexes/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -1081,9 +1268,12 @@ export class XykService {
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} dexName - The DEX name eg: `uniswap_v2`.
      * @param {string} tokenAddress - The token contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetSingleNetworkExchangeTokenQueryParamOpts} queryParamOpts
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
      *
      */
-    async getSingleNetworkExchangeToken(chainName, dexName, tokenAddress) {
+    async getSingleNetworkExchangeToken(chainName, dexName, tokenAddress, queryParamOpts) {
         let success = false;
         let data;
         let response;
@@ -1091,6 +1281,12 @@ export class XykService {
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
+                if (queryParamOpts?.pageSize !== undefined) {
+                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
+                }
+                if (queryParamOpts?.pageNumber !== undefined) {
+                    urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
+                }
                 if (!this.is_key_valid) {
                     return {
                         data: null,
@@ -1107,13 +1303,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/tokens/address/${tokenAddress}/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -1182,13 +1378,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/address/${accountAddress}/transactions/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -1231,9 +1427,12 @@ export class XykService {
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} dexName - The DEX name eg: `uniswap_v2`.
      * @param {string} tokenAddress - The token contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetTransactionsForTokenAddressQueryParamOpts} queryParamOpts
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
      *
      */
-    async getTransactionsForTokenAddress(chainName, dexName, tokenAddress) {
+    async getTransactionsForTokenAddress(chainName, dexName, tokenAddress, queryParamOpts) {
         let success = false;
         let data;
         let response;
@@ -1249,6 +1448,12 @@ export class XykService {
                         error_message: ApiKeyValidator.INVALID_API_KEY_MESSAGE
                     };
                 }
+                if (queryParamOpts?.pageSize !== undefined) {
+                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
+                }
+                if (queryParamOpts?.pageNumber !== undefined) {
+                    urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
+                }
                 const url = `https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/tokens/address/${tokenAddress}/transactions/?${urlParams}`;
                 let startTime;
                 if (this.debug) {
@@ -1257,13 +1462,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/tokens/address/${tokenAddress}/transactions/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -1306,9 +1511,12 @@ export class XykService {
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} dexName - The DEX name eg: `uniswap_v2`.
      * @param {string} poolAddress - The pool contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetTransactionsForExchangeQueryParamOpts} queryParamOpts
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
      *
      */
-    async getTransactionsForExchange(chainName, dexName, poolAddress) {
+    async getTransactionsForExchange(chainName, dexName, poolAddress, queryParamOpts) {
         let success = false;
         let data;
         let response;
@@ -1324,6 +1532,12 @@ export class XykService {
                         error_message: ApiKeyValidator.INVALID_API_KEY_MESSAGE
                     };
                 }
+                if (queryParamOpts?.pageSize !== undefined) {
+                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
+                }
+                if (queryParamOpts?.pageNumber !== undefined) {
+                    urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
+                }
                 const url = `https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/pools/address/${poolAddress}/transactions/?${urlParams}`;
                 let startTime;
                 if (this.debug) {
@@ -1332,13 +1546,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/pools/address/${poolAddress}/transactions/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -1374,6 +1588,93 @@ export class XykService {
             }
         }
     }
+    /**
+     *
+     * Commonly used to get all the the transactions for a given DEX. Useful for building DEX activity views.
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} dexName - The DEX name eg: `uniswap_v2`.
+     * @param {GetTransactionsForDexQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
+     *
+     */
+    async getTransactionsForDex(chainName, dexName, queryParamOpts) {
+        let success = false;
+        let data;
+        let response;
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
+        while (!success) {
+            try {
+                const urlParams = new URLSearchParams();
+                if (!this.is_key_valid) {
+                    return {
+                        data: null,
+                        error: true,
+                        error_code: 401,
+                        error_message: ApiKeyValidator.INVALID_API_KEY_MESSAGE
+                    };
+                }
+                if (queryParamOpts?.quoteCurrency !== undefined) {
+                    urlParams.append("quote-currency", queryParamOpts?.quoteCurrency.toString());
+                }
+                if (queryParamOpts?.pageSize !== undefined) {
+                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
+                }
+                if (queryParamOpts?.pageNumber !== undefined) {
+                    urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
+                }
+                const url = `https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/transactions/?${urlParams}`;
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/transactions/?${urlParams}`, {
+                    headers: {
+                        "Authorization": `Bearer ${this.apiKey}`,
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
+                    }
+                }));
+                debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
+                if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
+                    try {
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
+                    }
+                    catch (error) {
+                        success = true;
+                        return {
+                            data: null,
+                            error: true,
+                            error_code: response.status ?? 429,
+                            error_message: error.message
+                        };
+                    }
+                }
+                else {
+                    data = await response.json();
+                }
+                const dataClass = new NetworkTransactionsResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
+            }
+            catch (error) {
+                success = true;
+                return {
+                    data: null,
+                    error: true,
+                    error_code: error.cause ? error.cause.code : data ? data.error_code : response ? response.status : "Unknown Error Code",
+                    error_message: error.cause ? error.cause.message : data ? data.error_message : response && response.status === 500 ? "Internal server error" : !response ? "Unknown Error" : "401 Authorization Required"
+                };
+            }
+        }
+    }
     /**
      *
      * Commonly used to get a 7d and 30d time-series chart of DEX activity. Includes volume and swap count.
@@ -1406,13 +1707,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/ecosystem/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -1480,13 +1781,13 @@ export class XykService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/xy=k/${dexName}/health/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
                 debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
                 if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;