@cityofzion/blockchain-service 1.17.0 → 1.18.0

package/dist/constants/BSCommonConstants.d.ts

@@ -0,0 +1,3 @@
+export declare class BSCommonConstants {
+    static readonly DORA_URL = "https://dora.coz.io";
+}

package/dist/constants/BSCommonConstants.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BSCommonConstants = void 0;
+class BSCommonConstants {
+}
+exports.BSCommonConstants = BSCommonConstants;
+BSCommonConstants.DORA_URL = 'https://dora.coz.io';

package/dist/functions.d.ts

@@ -25,5 +25,5 @@ type NormalizedHashOptions = {
 export declare function normalizeHash(hash: string, options?: NormalizedHashOptions): string;
 export declare function denormalizeHash(hash: string): string;
 export declare function countDecimals(value: string | number): number;
-export declare function formatNumber(value: string | number, decimals?: number): string;
+export declare function formatNumber(value?: string | number, decimals?: number): string;
 export {};

package/dist/functions.js

@@ -159,6 +159,8 @@ function countDecimals(value) {
 }
 exports.countDecimals = countDecimals;
 function formatNumber(value, decimals = 0) {
+    if (!value)
+        return '0';
     let newValue = typeof value === 'number' ? value.toFixed(decimals) : value;
     newValue = newValue.replace(/,|\.\.|\.,/g, '.');
     if (decimals === 0) {

package/dist/helpers/BSFullTransactionsByAddressHelper.d.ts

@@ -0,0 +1,4 @@
+import { FullTransactionsByAddressParams } from '../interfaces';
+export declare class BSFullTransactionsByAddressHelper {
+    static validateFullTransactionsByAddressParams(params: Omit<FullTransactionsByAddressParams, 'nextCursor'>): void;
+}

package/dist/helpers/BSFullTransactionsByAddressHelper.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BSFullTransactionsByAddressHelper = void 0;
+const date_fns_1 = require("date-fns");
+class BSFullTransactionsByAddressHelper {
+    static validateFullTransactionsByAddressParams(params) {
+        if (!params.dateFrom)
+            throw new Error('Missing dateFrom param');
+        if (!params.dateTo)
+            throw new Error('Missing dateTo param');
+        const dateFrom = (0, date_fns_1.parseISO)(params.dateFrom);
+        const dateTo = (0, date_fns_1.parseISO)(params.dateTo);
+        if (!(0, date_fns_1.isValid)(dateFrom))
+            throw new Error('Invalid dateFrom param');
+        if (!(0, date_fns_1.isValid)(dateTo))
+            throw new Error('Invalid dateTo param');
+        if ((0, date_fns_1.isFuture)(dateFrom) || (0, date_fns_1.isFuture)(dateTo))
+            throw new Error('The dateFrom and/or dateTo are in future');
+        if ((0, date_fns_1.isAfter)(dateFrom, dateTo))
+            throw new Error('Invalid date order because dateFrom is greater than dateTo');
+        if ((0, date_fns_1.differenceInYears)(dateTo, dateFrom) >= 1)
+            throw new Error('Date range greater than one year');
+    }
+}
+exports.BSFullTransactionsByAddressHelper = BSFullTransactionsByAddressHelper;

package/dist/helpers/BSPromisesHelper.d.ts

@@ -0,0 +1,3 @@
+export declare class BSPromisesHelper {
+    static tryCatch<T = any>(callback: () => T | Promise<T>): Promise<[T | null, any]>;
+}

package/dist/helpers/BSPromisesHelper.js

@@ -0,0 +1,26 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BSPromisesHelper = void 0;
+class BSPromisesHelper {
+    static tryCatch(callback) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield callback();
+                return [result, null];
+            }
+            catch (error) {
+                return [null, error];
+            }
+        });
+    }
+}
+exports.BSPromisesHelper = BSPromisesHelper;

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+export * from './constants/BSCommonConstants';
+export * from './helpers/BSFullTransactionsByAddressHelper';
+export * from './helpers/BSPromisesHelper';
 export * from './services/exchange-data/CryptoCompareEDS';
 export * from './services/exchange-data/FlamingoForthewinEDS';
 export * from './BSAggregator';

package/dist/index.js

@@ -14,6 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants/BSCommonConstants"), exports);
+__exportStar(require("./helpers/BSFullTransactionsByAddressHelper"), exports);
+__exportStar(require("./helpers/BSPromisesHelper"), exports);
 __exportStar(require("./services/exchange-data/CryptoCompareEDS"), exports);
 __exportStar(require("./services/exchange-data/FlamingoForthewinEDS"), exports);
 __exportStar(require("./BSAggregator"), exports);

package/dist/interfaces.d.ts

@@ -118,6 +118,63 @@ export type TransactionsByAddressParams = {
     address: string;
     nextPageParams?: any;
 };
+export type FullTransactionsByAddressParams = {
+    address: string;
+    dateFrom: string;
+    dateTo: string;
+    pageSize?: number;
+    nextCursor?: string;
+};
+export type ExportTransactionsByAddressParams = {
+    address: string;
+    dateFrom: string;
+    dateTo: string;
+};
+export type FullTransactionNftEvent = {
+    eventType: 'nft';
+    amount: string;
+    methodName: string;
+    hash: string;
+    hashUrl?: string;
+    to?: string;
+    toUrl?: string;
+    from?: string;
+    fromUrl?: string;
+    tokenType: 'generic' | (string & NonNullable<unknown>);
+    tokenId?: string;
+    nftImageUrl?: string;
+    nftUrl?: string;
+    name?: string;
+    collectionName?: string;
+};
+export type FullTransactionAssetEvent = {
+    eventType: 'token';
+    amount: string;
+    methodName: string;
+    hash: string;
+    hashUrl?: string;
+    to?: string;
+    toUrl?: string;
+    from?: string;
+    fromUrl?: string;
+    token?: Token;
+    tokenType: 'generic' | (string & NonNullable<unknown>);
+};
+export type FullTransactionsItem = {
+    txId: string;
+    txIdUrl?: string;
+    block: number;
+    date: string;
+    invocationCount: number;
+    notificationCount: number;
+    networkFeeAmount: string;
+    systemFeeAmount: string;
+    events: (FullTransactionAssetEvent | FullTransactionNftEvent)[];
+};
+export type FullTransactionsByAddressResponse = {
+    nextCursor?: string;
+    data: FullTransactionsItem[];
+};
 export type ContractMethod = {
     name: string;
     parameters: ContractParameter[];
@@ -140,6 +197,8 @@ export interface BlockchainDataService {
     maxTimeToConfirmTransactionInMs: number;
     getTransaction(txid: string): Promise<TransactionResponse>;
     getTransactionsByAddress(params: TransactionsByAddressParams): Promise<TransactionsByAddressResponse>;
+    getFullTransactionsByAddress(params: FullTransactionsByAddressParams): Promise<FullTransactionsByAddressResponse>;
+    exportFullTransactionsByAddress(params: ExportTransactionsByAddressParams): Promise<string>;
     getContract(contractHash: string): Promise<ContractResponse>;
     getTokenInfo(tokenHash: string): Promise<Token>;
     getBalance(address: string): Promise<BalanceResponse[]>;
@@ -219,6 +278,8 @@ export interface ExplorerService {
     buildNftUrl(params: BuildNftUrlParams): string;
     getAddressTemplateUrl(): string | undefined;
     getTxTemplateUrl(): string | undefined;
+    getNftTemplateUrl(): string | undefined;
+    getContractTemplateUrl(): string | undefined;
 }
 export type LedgerServiceEmitter = TypedEmitter<{
     getSignatureStart(): void | Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cityofzion/blockchain-service",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": "https://github.com/CityOfZion/blockchain-services",
@@ -20,7 +20,8 @@
   },
   "dependencies": {
     "@ledgerhq/hw-transport": "~6.30.5",
-    "axios": "1.5.1"
+    "axios": "1.8.2",
+    "date-fns": "~4.1.0"
   },
   "scripts": {
     "build": "tsc",