@covalenthq/client-sdk 0.7.5 → 0.8.0

package/dist/services/TransactionService.js

@@ -218,11 +218,13 @@ class Param {
     }
 }
 class RecentTransactionsResponse {
-    constructor(data, _debug, _apiKey, _threadCount, _urlParams) {
+    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;
@@ -253,16 +255,17 @@ class RecentTransactionsResponse {
                         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": userAgent
+                        "X-Requested-With": this._source ? this._source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
-                debugOutput(response.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                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.url));
+                        data = await LIMIT(() => backoff.backOff(response ? response.url : url, this._source));
                     }
                     catch (error) {
                         success = true;
@@ -277,7 +280,7 @@ class RecentTransactionsResponse {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new RecentTransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams);
+                const dataClass = new RecentTransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -292,8 +295,8 @@ class RecentTransactionsResponse {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    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"
                 };
             }
         }
@@ -319,16 +322,17 @@ class RecentTransactionsResponse {
                         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": userAgent
+                        "X-Requested-With": this._source ? this._source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
-                debugOutput(response.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                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.url));
+                        data = await LIMIT(() => backoff.backOff(response ? response.url : url, this._source));
                     }
                     catch (error) {
                         success = true;
@@ -343,7 +347,7 @@ class RecentTransactionsResponse {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new RecentTransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams);
+                const dataClass = new RecentTransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -358,8 +362,8 @@ class RecentTransactionsResponse {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    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"
                 };
             }
         }
@@ -371,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;
@@ -403,11 +556,13 @@ class TransactionSummary {
     }
 }
 class TransactionsResponse {
-    constructor(data, _debug, _apiKey, _threadCount, _urlParams) {
+    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;
@@ -438,16 +593,17 @@ class TransactionsResponse {
                         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": userAgent
+                        "X-Requested-With": this._source ? this._source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
-                debugOutput(response.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                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.url));
+                        data = await LIMIT(() => backoff.backOff(response ? response.url : url, this._source));
                     }
                     catch (error) {
                         success = true;
@@ -462,7 +618,7 @@ class TransactionsResponse {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new TransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams);
+                const dataClass = new TransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -477,8 +633,8 @@ class TransactionsResponse {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    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"
                 };
             }
         }
@@ -504,16 +660,17 @@ class TransactionsResponse {
                         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": userAgent
+                        "X-Requested-With": this._source ? this._source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
-                debugOutput(response.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                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.url));
+                        data = await LIMIT(() => backoff.backOff(response ? response.url : url, this._source));
                     }
                     catch (error) {
                         success = true;
@@ -528,7 +685,7 @@ class TransactionsResponse {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new TransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams);
+                const dataClass = new TransactionsResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -543,19 +700,21 @@ class TransactionsResponse {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    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 TransactionsTimeBucketResponse {
-    constructor(data, _debug, _apiKey, _threadCount, _urlParams) {
+    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;
@@ -587,16 +746,17 @@ class TransactionsTimeBucketResponse {
                         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": userAgent
+                        "X-Requested-With": this._source ? this._source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
-                debugOutput(response.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                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.url));
+                        data = await LIMIT(() => backoff.backOff(response ? response.url : url, this._source));
                     }
                     catch (error) {
                         success = true;
@@ -611,7 +771,7 @@ class TransactionsTimeBucketResponse {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new TransactionsTimeBucketResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams);
+                const dataClass = new TransactionsTimeBucketResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -626,8 +786,8 @@ class TransactionsTimeBucketResponse {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    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"
                 };
             }
         }
@@ -653,16 +813,17 @@ class TransactionsTimeBucketResponse {
                         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": userAgent
+                        "X-Requested-With": this._source ? this._source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
-                debugOutput(response.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                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.url));
+                        data = await LIMIT(() => backoff.backOff(response ? response.url : url, this._source));
                     }
                     catch (error) {
                         success = true;
@@ -677,7 +838,7 @@ class TransactionsTimeBucketResponse {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new TransactionsTimeBucketResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams);
+                const dataClass = new TransactionsTimeBucketResponse(data.data, this._debug, this._apiKey, this._threadCount, this._urlParams, this._enableRetry, this._source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -692,8 +853,8 @@ class TransactionsTimeBucketResponse {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    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"
                 };
             }
         }
@@ -703,7 +864,7 @@ class TransactionsTimeBucketResponse {
  * Transactions APIs
  *
  */
-async function* paginateEndpoint(url, apiKey, urlsParams, debug, threadCount) {
+async function* paginateEndpoint(url, apiKey, urlsParams, debug, threadCount, enableRetry, source) {
     let hasNext = true;
     let response;
     let data;
@@ -718,17 +879,17 @@ async function* paginateEndpoint(url, apiKey, urlsParams, debug, threadCount) {
             response = await LIMIT(() => fetch(`${url}?${urlsParams}`, {
                 headers: {
                     "Authorization": `Bearer ${apiKey}`,
-                    "X-Requested-With": userAgent
+                    "X-Requested-With": source ? source + " " + "(" + userAgent + ")" : userAgent
                 }
             }));
-            debugOutput(response.url, response.status ?? 429, startTime);
-            if (response.status === null || response.status === 429) {
+            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.url));
+                    data = await LIMIT(() => backoff.backOff(response ? response.url : `${url}?${urlsParams}`, this.source));
                 }
                 catch (error) {
                     hasNext = false;
-                    throw new Error(`An error occurred ${response.status}: ${error.message}`);
+                    throw new Error(`An error occurred ${response ? response.status : 429}: ${error.message}`);
                 }
             }
             else {
@@ -760,11 +921,13 @@ async function* paginateEndpoint(url, apiKey, urlsParams, debug, threadCount) {
     }
 }
 export class TransactionService {
-    constructor(apiKey, debug = false, threadCount = 3, is_key_valid) {
+    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);
     }
     /**
@@ -820,16 +983,17 @@ export class TransactionService {
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
                 }
+                const url = `https://api.covalenthq.com/v1/${chainName}/transaction_v2/${txHash}/?${urlParams}`;
                 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.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                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.url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -859,8 +1023,8 @@ export class TransactionService {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    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"
                 };
             }
         }
@@ -899,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)) {
+                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;
@@ -955,16 +1119,17 @@ export class TransactionService {
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
                 }
+                const url = `https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transactions_v3/?${urlParams}`;
                 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.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                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.url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -979,7 +1144,7 @@ export class TransactionService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new RecentTransactionsResponse(data.data, this.debug, this.apiKey, this.threadCount, urlParams);
+                const dataClass = new RecentTransactionsResponse(data.data, this.debug, this.apiKey, this.threadCount, urlParams, this.enableRetry, this.source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -994,8 +1159,8 @@ export class TransactionService {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    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"
                 };
             }
         }
@@ -1041,16 +1206,17 @@ export class TransactionService {
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
                 }
+                const url = `https://api.covalenthq.com/v1/${chainName}/block/${blockHeight}/transactions_v3/?${urlParams}`;
                 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.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                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.url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -1080,8 +1246,8 @@ export class TransactionService {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    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"
                 };
             }
         }
@@ -1114,16 +1280,17 @@ export class TransactionService {
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
                 }
+                const url = `https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transactions_summary/?${urlParams}`;
                 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.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                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.url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -1153,8 +1320,8 @@ export class TransactionService {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    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"
                 };
             }
         }
@@ -1203,16 +1370,17 @@ export class TransactionService {
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
                 }
+                const url = `https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transactions_v3/page/${page}/?${urlParams}`;
                 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.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                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.url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -1227,7 +1395,7 @@ export class TransactionService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new TransactionsResponse(data.data, this.debug, this.apiKey, this.threadCount, urlParams);
+                const dataClass = new TransactionsResponse(data.data, this.debug, this.apiKey, this.threadCount, urlParams, this.enableRetry, this.source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -1242,8 +1410,8 @@ export class TransactionService {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    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"
                 };
             }
         }
@@ -1288,16 +1456,105 @@ export class TransactionService {
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
                 }
+                const url = `https://api.covalenthq.com/v1/${chainName}/bulk/transactions/${walletAddress}/${timeBucket}/?${urlParams}`;
                 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, 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 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.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                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.url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -1312,7 +1569,7 @@ export class TransactionService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new TransactionsTimeBucketResponse(data.data, this.debug, this.apiKey, this.threadCount, urlParams);
+                const dataClass = new TransactionsBlockPageResponse(data.data, this.debug, this.apiKey, this.threadCount, urlParams, this.enableRetry, this.source);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -1327,10 +1584,97 @@ export class TransactionService {
                 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 {
+                    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"
+                };
+            }
         }
     }
 }