@covalenthq/client-sdk 0.7.6 → 0.8.0

package/dist/services/TransactionService.js

@@ -218,12 +218,13 @@ class Param {
     }
 }
 class RecentTransactionsResponse {
-    constructor(data, _debug, _apiKey, _threadCount, _urlParams, _enableRetry) {
+    constructor(data, _debug, _apiKey, _threadCount, _urlParams, _enableRetry, _source) {
         this._debug = _debug;
         this._apiKey = _apiKey;
         this._threadCount = _threadCount;
         this._urlParams = _urlParams;
         this._enableRetry = _enableRetry;
+        this._source = _source;
         this.address = data.address;
         this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.quote_currency = data.quote_currency;
@@ -258,13 +259,13 @@ class RecentTransactionsResponse {
                 response = await LIMIT(() => fetch(`${this.links.prev}?${this._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 LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await LIMIT(() => backoff.backOff(response ? response.url : url, this._source));
                     }
                     catch (error) {
                         success = true;
@@ -279,7 +280,7 @@ class RecentTransactionsResponse {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new RecentTransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry);
+                const dataClass = new RecentTransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -325,13 +326,13 @@ class RecentTransactionsResponse {
                 response = await LIMIT(() => fetch(`${this.links.next}?${this._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 LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await LIMIT(() => backoff.backOff(response ? response.url : url, this._source));
                     }
                     catch (error) {
                         success = true;
@@ -346,7 +347,7 @@ class RecentTransactionsResponse {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new RecentTransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry);
+                const dataClass = new RecentTransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -374,6 +375,155 @@ class PaginationLinks {
         this.next = data.next;
     }
 }
+class TransactionsBlockPageResponse {
+    constructor(data, _debug, _apiKey, _threadCount, _urlParams, _enableRetry, _source) {
+        this._debug = _debug;
+        this._apiKey = _apiKey;
+        this._threadCount = _threadCount;
+        this._urlParams = _urlParams;
+        this._enableRetry = _enableRetry;
+        this._source = _source;
+        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.links = data.links && data.links !== null ? new PaginationLinks(data.links) : null;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new Transaction(itemData)) : null;
+    }
+    async prev() {
+        let success = false;
+        let data;
+        let response;
+        const backoff = new ExponentialBackoff(this._apiKey, this._debug);
+        const LIMIT = pLimit(this._threadCount);
+        while (!success) {
+            try {
+                let startTime;
+                if (this._debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                if (this.links.prev === null) {
+                    success = true;
+                    return {
+                        data: null,
+                        error: true,
+                        error_code: 400,
+                        error_message: "Invalid URL: URL link cannot be null"
+                    };
+                }
+                const url = `${this.links.prev}?${this._urlParams}`;
+                response = await LIMIT(() => fetch(`${this.links.prev}?${this._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 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 TransactionsBlockPageResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
+                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"
+                };
+            }
+        }
+    }
+    async next() {
+        let success = false;
+        let data;
+        let response;
+        const backoff = new ExponentialBackoff(this._apiKey, this._debug);
+        const LIMIT = pLimit(this._threadCount);
+        while (!success) {
+            try {
+                let startTime;
+                if (this._debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                if (this.links.next === null) {
+                    success = true;
+                    return {
+                        data: null,
+                        error: true,
+                        error_code: 400,
+                        error_message: "Invalid URL: URL link cannot be null"
+                    };
+                }
+                const url = `${this.links.next}?${this._urlParams}`;
+                response = await LIMIT(() => fetch(`${this.links.next}?${this._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 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 TransactionsBlockPageResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
+                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"
+                };
+            }
+        }
+    }
+}
 class TransactionsBlockResponse {
     constructor(data) {
         this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
@@ -406,12 +556,13 @@ class TransactionSummary {
     }
 }
 class TransactionsResponse {
-    constructor(data, _debug, _apiKey, _threadCount, _urlParams, _enableRetry) {
+    constructor(data, _debug, _apiKey, _threadCount, _urlParams, _enableRetry, _source) {
         this._debug = _debug;
         this._apiKey = _apiKey;
         this._threadCount = _threadCount;
         this._urlParams = _urlParams;
         this._enableRetry = _enableRetry;
+        this._source = _source;
         this.address = data.address;
         this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.quote_currency = data.quote_currency;
@@ -446,13 +597,13 @@ class TransactionsResponse {
                 response = await LIMIT(() => fetch(`${this.links.prev}?${this._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 LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await LIMIT(() => backoff.backOff(response ? response.url : url, this._source));
                     }
                     catch (error) {
                         success = true;
@@ -467,7 +618,7 @@ class TransactionsResponse {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new TransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry);
+                const dataClass = new TransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -513,13 +664,13 @@ class TransactionsResponse {
                 response = await LIMIT(() => fetch(`${this.links.next}?${this._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 LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await LIMIT(() => backoff.backOff(response ? response.url : url, this._source));
                     }
                     catch (error) {
                         success = true;
@@ -534,7 +685,7 @@ class TransactionsResponse {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new TransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry);
+                const dataClass = new TransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -557,12 +708,13 @@ class TransactionsResponse {
     }
 }
 class TransactionsTimeBucketResponse {
-    constructor(data, _debug, _apiKey, _threadCount, _urlParams, _enableRetry) {
+    constructor(data, _debug, _apiKey, _threadCount, _urlParams, _enableRetry, _source) {
         this._debug = _debug;
         this._apiKey = _apiKey;
         this._threadCount = _threadCount;
         this._urlParams = _urlParams;
         this._enableRetry = _enableRetry;
+        this._source = _source;
         this.address = data.address;
         this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.quote_currency = data.quote_currency;
@@ -598,13 +750,13 @@ class TransactionsTimeBucketResponse {
                 response = await LIMIT(() => fetch(`${this.links.prev}?${this._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 LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await LIMIT(() => backoff.backOff(response ? response.url : url, this._source));
                     }
                     catch (error) {
                         success = true;
@@ -619,7 +771,7 @@ class TransactionsTimeBucketResponse {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new TransactionsTimeBucketResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry);
+                const dataClass = new TransactionsTimeBucketResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -665,13 +817,13 @@ class TransactionsTimeBucketResponse {
                 response = await LIMIT(() => fetch(`${this.links.next}?${this._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 LIMIT(() => backoff.backOff(response ? response.url : url));
+                        data = await LIMIT(() => backoff.backOff(response ? response.url : url, this._source));
                     }
                     catch (error) {
                         success = true;
@@ -686,7 +838,7 @@ class TransactionsTimeBucketResponse {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new TransactionsTimeBucketResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry);
+                const dataClass = new TransactionsTimeBucketResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -712,7 +864,7 @@ class TransactionsTimeBucketResponse {
  * Transactions APIs
  *
  */
-async function* paginateEndpoint(url, apiKey, urlsParams, debug, threadCount, enableRetry) {
+async function* paginateEndpoint(url, apiKey, urlsParams, debug, threadCount, enableRetry, source) {
     let hasNext = true;
     let response;
     let data;
@@ -727,13 +879,13 @@ async function* paginateEndpoint(url, apiKey, urlsParams, debug, threadCount, en
             response = await LIMIT(() => fetch(`${url}?${urlsParams}`, {
                 headers: {
                     "Authorization": `Bearer ${apiKey}`,
-                    "X-Requested-With": userAgent
+                    "X-Requested-With": source ? source + " " + "(" + userAgent + ")" : userAgent
                 }
             }));
             debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
             if ((enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                 try {
-                    data = await LIMIT(() => backoff.backOff(response ? response.url : `${url}?${urlsParams}`));
+                    data = await LIMIT(() => backoff.backOff(response ? response.url : `${url}?${urlsParams}`, this.source));
                 }
                 catch (error) {
                     hasNext = false;
@@ -769,12 +921,13 @@ async function* paginateEndpoint(url, apiKey, urlsParams, debug, threadCount, en
     }
 }
 export class TransactionService {
-    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);
     }
     /**
@@ -834,13 +987,13 @@ export class TransactionService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/transaction_v2/${txHash}/?${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;
@@ -910,7 +1063,7 @@ export class TransactionService {
                 if (queryParamOpts?.withSafe !== undefined) {
                     urlParams.append("with-safe", queryParamOpts?.withSafe.toString());
                 }
-                for await (tx of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transactions_v3/`, this.apiKey, urlParams, this.debug, this.threadCount, this.enableRetry)) {
+                for await (tx of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transactions_v3/`, this.apiKey, urlParams, this.debug, this.threadCount, this.enableRetry, this.source)) {
                     yield tx;
                 }
                 success = true;
@@ -970,13 +1123,13 @@ export class TransactionService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transactions_v3/?${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;
@@ -991,7 +1144,7 @@ export class TransactionService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new RecentTransactionsResponse(data.data, this.debug, this.apiKey, this.threadCount, urlParams, this.enableRetry);
+                const dataClass = new RecentTransactionsResponse(data.data, this.debug, this.apiKey, this.threadCount, urlParams, this.enableRetry, this.source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -1057,13 +1210,13 @@ export class TransactionService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/block/${blockHeight}/transactions_v3/?${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;
@@ -1131,13 +1284,13 @@ export class TransactionService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transactions_summary/?${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;
@@ -1221,13 +1374,13 @@ export class TransactionService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transactions_v3/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;
@@ -1242,7 +1395,7 @@ export class TransactionService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new TransactionsResponse(data.data, this.debug, this.apiKey, this.threadCount, urlParams, this.enableRetry);
+                const dataClass = new TransactionsResponse(data.data, this.debug, this.apiKey, this.threadCount, urlParams, this.enableRetry, this.source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -1307,13 +1460,13 @@ export class TransactionService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/bulk/transactions/${walletAddress}/${timeBucket}/?${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;
@@ -1328,7 +1481,182 @@ export class TransactionService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new TransactionsTimeBucketResponse(data.data, this.debug, this.apiKey, this.threadCount, urlParams, this.enableRetry);
+                const dataClass = new TransactionsTimeBucketResponse(data.data, this.debug, this.apiKey, this.threadCount, urlParams, this.enableRetry, this.source);
+                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 fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} blockHash - The requested block hash.
+     * @param {number} page - The requested 0-indexed page number.
+     * @param {GetTransactionsForBlockHashByPageQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `noLogs`: Omit log events.
+     *   - `withSafe`: Include safe details.
+     *
+     */
+    async getTransactionsForBlockHashByPage(chainName, blockHash, page, 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?.noLogs !== undefined) {
+                    urlParams.append("no-logs", queryParamOpts?.noLogs.toString());
+                }
+                if (queryParamOpts?.withSafe !== undefined) {
+                    urlParams.append("with-safe", queryParamOpts?.withSafe.toString());
+                }
+                const url = `https://api.covalenthq.com/v1/${chainName}/block_hash/${blockHash}/transactions_v3/page/${page}/?${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}/block_hash/${blockHash}/transactions_v3/page/${page}/?${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 TransactionsBlockPageResponse(data.data, this.debug, this.apiKey, this.threadCount, urlParams, this.enableRetry, this.source);
+                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 fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} blockHash - The requested block hash.
+     * @param {GetTransactionsForBlockHashQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `noLogs`: Omit log events.
+     *   - `withSafe`: Include safe details.
+     *
+     */
+    async getTransactionsForBlockHash(chainName, blockHash, 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?.noLogs !== undefined) {
+                    urlParams.append("no-logs", queryParamOpts?.noLogs.toString());
+                }
+                if (queryParamOpts?.withSafe !== undefined) {
+                    urlParams.append("with-safe", queryParamOpts?.withSafe.toString());
+                }
+                const url = `https://api.covalenthq.com/v1/${chainName}/block_hash/${blockHash}/transactions_v3/?${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}/block_hash/${blockHash}/transactions_v3/?${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 TransactionsBlockResponse(data.data);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {