radix-utils 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Radix Utils Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,283 @@
+# Radix Utils
+
+A comprehensive utility library for Radix DLT blockchain development, providing helper functions for working with validators, staking, and various Radix-specific operations.
+
+## Installation
+
+```bash
+npm install radix-utils
+```
+
+## Features
+
+- **Validator Information**: Fetch comprehensive validator data including staking amounts, fees, and vault information
+- **Resource Checking**: Check fungible resource balances across multiple accounts
+- **Fee Calculations**: Compute validator fee factors with pending changes
+- **Date Utilities**: Calculate unlock dates based on epoch information
+- **Decimal Operations**: Radix-specific decimal operations with proper precision
+- **TypeScript Support**: Full TypeScript definitions included
+
+## Quick Start
+
+```typescript
+import { fetchValidatorInfo, BN, GatewayApiClient } from 'radix-utils';
+
+// Initialize the Gateway API client
+const gatewayApi = GatewayApiClient.initialize({
+  networkId: 1, // Mainnet
+  applicationName: 'Your App Name',
+  applicationVersion: '1.0.0',
+});
+
+// Fetch validator information
+const validatorAddress = 'validator_rdx1sd...';
+const validatorInfo = await fetchValidatorInfo(gatewayApi, validatorAddress);
+
+if (validatorInfo) {
+  console.log('Total Staked XRD:', validatorInfo.totalStakedXrds);
+  console.log('Current Fee:', validatorInfo.fees.current);
+  console.log('Validator Metadata:', validatorInfo.metadata);
+}
+```
+
+## API Reference
+
+### Validator Functions
+
+#### `fetchValidatorInfo(gatewayApi, validatorAddress)`
+
+Fetches comprehensive information about a validator.
+
+**Parameters:**
+
+- `gatewayApi`: GatewayApiClient instance
+- `validatorAddress`: String - The validator address (must start with 'validator\_')
+
+**Returns:** `Promise<ValidatorInfo | undefined>`
+
+**Example:**
+
+```typescript
+const info = await fetchValidatorInfo(gatewayApi, 'validator_rdx1sd...');
+console.log(info?.totalStakedXrds);
+```
+
+#### `checkResourceInUsersFungibleAssets(usersAddresses, fungibleResourceToCheck, gatewayApi, ledgerState?)`
+
+Checks if a specific fungible resource exists in users' accounts.
+
+**Parameters:**
+
+- `usersAddresses`: String[] - Array of account addresses to check
+- `fungibleResourceToCheck`: String - Resource address to look for
+- `gatewayApi`: GatewayApiClient instance
+- `ledgerState?`: LedgerStateSelector (optional)
+
+**Returns:** `Promise<ResourceCheckResult>`
+
+**Example:**
+
+```typescript
+const result = await checkResourceInUsersFungibleAssets(
+  ['account_rdx1...', 'account_rdx2...'],
+  'resource_rdx1...',
+  gatewayApi
+);
+console.log('Total Amount:', result.totalAmount);
+console.log('Users with Resource:', result.usersWithResourceAmount);
+```
+
+#### `computeValidatorFeeFactor(currentFeeFactor, newFeeFactor, currentEpoch)`
+
+Computes validator fee factor information including pending changes.
+
+**Parameters:**
+
+- `currentFeeFactor`: String - Current fee factor as decimal string
+- `newFeeFactor`: NewFeeFactor | null - New fee factor configuration
+- `currentEpoch`: Number - Current epoch number
+
+**Returns:** `FeeFactor`
+
+#### `fetchWalletBalances(gatewayApi, walletAddress, ledgerState?)`
+
+Fetches complete wallet balances including both fungible and non-fungible tokens with automatic pagination.
+
+**Parameters:**
+
+- `gatewayApi`: GatewayApiClient instance
+- `walletAddress`: String - The wallet address to fetch balances for
+- `ledgerState?`: LedgerStateSelector (optional) - For historical data
+
+**Returns:** `Promise<WalletBalances>`
+
+**Example:**
+
+```typescript
+const balances = await fetchWalletBalances(gatewayApi, 'account_rdx1...');
+
+// Access fungible token balances
+Object.entries(balances.fungible).forEach(([address, balance]) => {
+  console.log(`Token ${address}: ${balance.amount}`);
+});
+
+// Access NFT collections
+Object.entries(balances.nonFungible).forEach(([address, collection]) => {
+  console.log(`NFT Collection ${address}: ${collection.ids.length} items`);
+});
+```
+
+### Utility Functions
+
+#### `BN(value)`
+
+Creates a new Decimal instance with Radix-specific precision configuration.
+
+**Parameters:**
+
+- `value`: String | Number - Value to convert to Decimal
+
+**Returns:** `Decimal`
+
+**Example:**
+
+```typescript
+const amount = BN('1000.123456789');
+const result = amount.plus('500.987654321');
+console.log(result.toString());
+```
+
+#### `calculateEstimatedUnlockDate(epochUnlocked, currentEpoch)`
+
+Calculates the estimated unlock date based on epoch information.
+
+**Parameters:**
+
+- `epochUnlocked`: Number - Epoch when stake will be unlocked
+- `currentEpoch`: Number - Current epoch number
+
+**Returns:** `String` - Formatted date string
+
+**Example:**
+
+```typescript
+const unlockDate = calculateEstimatedUnlockDate(1500, 1400);
+console.log('Estimated unlock:', unlockDate);
+```
+
+#### `retryPromiseAll(promises, retries?, delay?)`
+
+Executes Promise.all with retry logic and exponential backoff.
+
+**Parameters:**
+
+- `promises`: Promise<T>[] - Array of promises to execute
+- `retries?`: Number (default: 3) - Number of retry attempts
+- `delay?`: Number (default: 1000) - Initial delay in milliseconds
+
+**Returns:** `Promise<T[]>`
+
+## TypeScript Types
+
+The library exports comprehensive TypeScript types:
+
+```typescript
+import type {
+  ValidatorInfo,
+  ValidatorVaults,
+  UnlockingRewards,
+  FeeFactor,
+  ResourceCheckResult,
+  WalletBalances,
+  FungibleBalances,
+  NonFungibleBalances,
+} from 'radix-utils';
+```
+
+### Key Types
+
+- **ValidatorInfo**: Complete validator information including staking data, fees, and metadata
+- **ValidatorVaults**: Validator vault addresses
+- **UnlockingRewards**: Array of unlocking reward entries
+- **FeeFactor**: Fee factor information with current and pending changes
+- **ResourceCheckResult**: Result of resource balance checks
+- **WalletBalances**: Complete wallet balance information with fungible and non-fungible tokens
+- **FungibleBalances**: Map of fungible token balances by address
+- **NonFungibleBalances**: Map of NFT collections by address
+
+## Contributing
+
+Contributions are welcome! This library is designed to be easily extensible. To add new utility functions:
+
+1. Create new files in the appropriate directory (`src/validators/`, `src/utils/`, etc.)
+2. Export your functions from the relevant index files
+3. Add comprehensive TypeScript types in `src/types/`
+4. Update the main `src/index.ts` to export your new functions
+5. Add tests for your new functionality
+6. Update this README with documentation
+
+### Development Setup
+
+```bash
+# Clone the repository
+git clone <repository-url>
+cd radix-utils
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run tests
+npm test
+
+# Run linting
+npm run lint
+
+# Format code
+npm run format
+```
+
+### Project Structure
+
+```
+src/
+├── types/          # TypeScript type definitions
+├── validators/     # Validator-related utilities
+├── utils/          # General utility functions
+└── index.ts        # Main export file
+```
+
+## Dependencies
+
+- `@radixdlt/babylon-gateway-api-sdk`: Radix Gateway API SDK
+- `decimal.js`: Arbitrary precision decimal calculations
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Support
+
+For issues and feature requests, please use the GitHub issue tracker.
+
+## Changelog
+
+### 1.1.0
+
+- Added `fetchWalletBalances` function for comprehensive wallet balance fetching
+- Added support for both fungible and non-fungible token balance retrieval
+- Added automatic pagination support for large wallets
+- Added new TypeScript types: `WalletBalances`, `FungibleBalances`, `NonFungibleBalances`
+- Added comprehensive test coverage for wallet functionality
+- Updated documentation with wallet balance examples
+
+### 1.0.0
+
+- Initial release
+- Added `fetchValidatorInfo` function
+- Added `checkResourceInUsersFungibleAssets` function
+- Added `computeValidatorFeeFactor` function
+- Added decimal and date utilities
+- Full TypeScript support

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types';
+export { BN, retryPromiseAll } from './utils/decimal';
+export { calculateEstimatedUnlockDate } from './utils/date';
+export { fetchWalletBalances } from './utils/wallet';
+export { fetchValidatorInfo, checkResourceInUsersFungibleAssets, computeValidatorFeeFactor, } from './validators';
+export type { ValidatorInfo, ValidatorVaults, UnlockingRewards, UnlockingReward, NewFeeFactor, FeeFactor, ResourceCheckResult, LedgerStateVersion, WalletBalances, FungibleBalances, NonFungibleBalances, FungibleBalance, NonFungibleBalance, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,EAAE,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EACL,kBAAkB,EAClB,kCAAkC,EAClC,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,33 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+exports.computeValidatorFeeFactor = exports.checkResourceInUsersFungibleAssets = exports.fetchValidatorInfo = exports.fetchWalletBalances = exports.calculateEstimatedUnlockDate = exports.retryPromiseAll = exports.BN = void 0;
+// Export types
+__exportStar(require("./types"), exports);
+// Export utility functions
+var decimal_1 = require("./utils/decimal");
+Object.defineProperty(exports, "BN", { enumerable: true, get: function () { return decimal_1.BN; } });
+Object.defineProperty(exports, "retryPromiseAll", { enumerable: true, get: function () { return decimal_1.retryPromiseAll; } });
+var date_1 = require("./utils/date");
+Object.defineProperty(exports, "calculateEstimatedUnlockDate", { enumerable: true, get: function () { return date_1.calculateEstimatedUnlockDate; } });
+var wallet_1 = require("./utils/wallet");
+Object.defineProperty(exports, "fetchWalletBalances", { enumerable: true, get: function () { return wallet_1.fetchWalletBalances; } });
+// Export validator functions
+var validators_1 = require("./validators");
+Object.defineProperty(exports, "fetchValidatorInfo", { enumerable: true, get: function () { return validators_1.fetchValidatorInfo; } });
+Object.defineProperty(exports, "checkResourceInUsersFungibleAssets", { enumerable: true, get: function () { return validators_1.checkResourceInUsersFungibleAssets; } });
+Object.defineProperty(exports, "computeValidatorFeeFactor", { enumerable: true, get: function () { return validators_1.computeValidatorFeeFactor; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,eAAe;AACf,0CAAwB;AAExB,2BAA2B;AAC3B,2CAAsD;AAA7C,6FAAA,EAAE,OAAA;AAAE,0GAAA,eAAe,OAAA;AAC5B,qCAA4D;AAAnD,oHAAA,4BAA4B,OAAA;AACrC,yCAAqD;AAA5C,6GAAA,mBAAmB,OAAA;AAE5B,6BAA6B;AAC7B,2CAIsB;AAHpB,gHAAA,kBAAkB,OAAA;AAClB,gIAAA,kCAAkC,OAAA;AAClC,uHAAA,yBAAyB,OAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Represents a single unlocking reward entry
+ */
+export interface UnlockingReward {
+    epoch_unlocked: number;
+    stake_unit_amount: string;
+}
+/**
+ * Array of unlocking rewards
+ */
+export type UnlockingRewards = UnlockingReward[];
+/**
+ * New fee factor configuration
+ */
+export interface NewFeeFactor {
+    new_fee_factor: string;
+    epoch_effective: number;
+}
+/**
+ * Fee factor information with current and pending changes
+ */
+export interface FeeFactor {
+    aboutToChange: NewFeeFactor | null;
+    current: string;
+    alert: string;
+}
+/**
+ * Validator vault addresses
+ */
+export interface ValidatorVaults {
+    NODE_CURRENTLY_EARNED_LSU_VAULT_ADDRESS: string;
+    NODE_OWNER_UNLOCKING_LSU_VAULT_ADDRESS: string;
+    NODE_TOTAL_STAKED_XRD_VAULT_ADDRESS: string;
+    NODE_UNSTAKING_XRD_VAULT_ADDRESS: string;
+}
+/**
+ * Complete validator information
+ */
+export interface ValidatorInfo {
+    currentlyEarnedLockedLSUs: string;
+    ownerLSUsInUnlockingProcess: string;
+    totalStakedXrds: string;
+    totalXrdsLeavingOurNode: string;
+    unlockingLSUsBreakdown: UnlockingRewards;
+    epoch: number;
+    unlockedLSUs: string;
+    metadata: Record<string, string>;
+    stakeUnitAddress: string;
+    vaults: ValidatorVaults;
+    validatorAddress: string;
+    fees: FeeFactor;
+}
+/**
+ * Resource check result
+ */
+export interface ResourceCheckResult {
+    usersWithResourceAmount: Record<string, string>;
+    totalAmount: string;
+}
+/**
+ * Ledger state version information
+ */
+export interface LedgerStateVersion {
+    epoch: number;
+    network: string;
+    proposer_round_timestamp: string;
+    round: number;
+    state_version: number;
+}
+/**
+ * Fungible token balance information
+ */
+export interface FungibleBalance {
+    tokenAddress: string;
+    amount: string;
+}
+/**
+ * Non-fungible token collection information
+ */
+export interface NonFungibleBalance {
+    collectionAddress: string;
+    ids: string[];
+}
+/**
+ * Map of fungible balances by token address
+ */
+export type FungibleBalances = Record<string, FungibleBalance>;
+/**
+ * Map of non-fungible balances by collection address
+ */
+export type NonFungibleBalances = Record<string, NonFungibleBalance>;
+/**
+ * Complete wallet balance information
+ */
+export interface WalletBalances {
+    fungible: FungibleBalances;
+    nonFungible: NonFungibleBalances;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,eAAe,EAAE,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC,EAAE,MAAM,CAAC;IAChD,sCAAsC,EAAE,MAAM,CAAC;IAC/C,mCAAmC,EAAE,MAAM,CAAC;IAC5C,gCAAgC,EAAE,MAAM,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB,EAAE,MAAM,CAAC;IAClC,2BAA2B,EAAE,MAAM,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,gBAAgB,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB,EAAE,MAAM,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,WAAW,EAAE,mBAAmB,CAAC;CAClC"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/utils/date.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Calculate estimated unlock date based on epoch information
+ * @param epochUnlocked - The epoch when the stake will be unlocked
+ * @param currentEpoch - The current epoch
+ * @returns Formatted date string
+ */
+export declare const calculateEstimatedUnlockDate: (epochUnlocked: number, currentEpoch: number) => string;
+//# sourceMappingURL=date.d.ts.map

package/dist/utils/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/utils/date.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,eAAe,MAAM,EACrB,cAAc,MAAM,KACnB,MAeF,CAAC"}

package/dist/utils/date.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateEstimatedUnlockDate = void 0;
+/**
+ * Calculate estimated unlock date based on epoch information
+ * @param epochUnlocked - The epoch when the stake will be unlocked
+ * @param currentEpoch - The current epoch
+ * @returns Formatted date string
+ */
+const calculateEstimatedUnlockDate = (epochUnlocked, currentEpoch) => {
+    const minutesPerEpoch = 5;
+    const currentDate = new Date();
+    const unlockDate = new Date(currentDate.getTime() +
+        (epochUnlocked - currentEpoch) * minutesPerEpoch * 60000);
+    return unlockDate.toLocaleString('en-GB', {
+        day: '2-digit',
+        month: '2-digit',
+        year: 'numeric',
+        hour: 'numeric',
+        minute: '2-digit',
+        hour12: true,
+    });
+};
+exports.calculateEstimatedUnlockDate = calculateEstimatedUnlockDate;
+//# sourceMappingURL=date.js.map

package/dist/utils/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/utils/date.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACI,MAAM,4BAA4B,GAAG,CAC1C,aAAqB,EACrB,YAAoB,EACZ,EAAE;IACV,MAAM,eAAe,GAAG,CAAC,CAAC;IAC1B,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAI,IAAI,CACzB,WAAW,CAAC,OAAO,EAAE;QACnB,CAAC,aAAa,GAAG,YAAY,CAAC,GAAG,eAAe,GAAG,KAAK,CAC3D,CAAC;IACF,OAAO,UAAU,CAAC,cAAc,CAAC,OAAO,EAAE;QACxC,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;AACL,CAAC,CAAC;AAlBW,QAAA,4BAA4B,gCAkBvC"}

package/dist/utils/decimal.d.ts

@@ -0,0 +1,16 @@
+import { Decimal } from 'decimal.js';
+/**
+ * Creates a new Decimal instance with Radix-specific configuration
+ * @param value - The value to convert to Decimal
+ * @returns A new Decimal instance
+ */
+export declare const BN: (value: string | number) => Decimal;
+/**
+ * Retry a promise with exponential backoff
+ * @param promises - Array of promises to execute
+ * @param retries - Number of retries (default: 3)
+ * @param delay - Initial delay in milliseconds (default: 1000)
+ * @returns Promise that resolves to the result of Promise.all
+ */
+export declare const retryPromiseAll: <T>(promises: Promise<T>[], retries?: number, delay?: number) => Promise<T[]>;
+//# sourceMappingURL=decimal.d.ts.map

package/dist/utils/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../src/utils/decimal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAQrC;;;;GAIG;AACH,eAAO,MAAM,EAAE,GAAI,OAAO,MAAM,GAAG,MAAM,KAAG,OAA6B,CAAC;AAE1E;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAU,CAAC,EACrC,UAAU,OAAO,CAAC,CAAC,CAAC,EAAE,EACtB,gBAAW,EACX,cAAY,KACX,OAAO,CAAC,CAAC,EAAE,CAYb,CAAC"}

package/dist/utils/decimal.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retryPromiseAll = exports.BN = void 0;
+const decimal_js_1 = require("decimal.js");
+// Configure Decimal for Radix use case
+decimal_js_1.Decimal.config({
+    precision: 28,
+    rounding: decimal_js_1.Decimal.ROUND_HALF_UP,
+});
+/**
+ * Creates a new Decimal instance with Radix-specific configuration
+ * @param value - The value to convert to Decimal
+ * @returns A new Decimal instance
+ */
+const BN = (value) => new decimal_js_1.Decimal(value);
+exports.BN = BN;
+/**
+ * Retry a promise with exponential backoff
+ * @param promises - Array of promises to execute
+ * @param retries - Number of retries (default: 3)
+ * @param delay - Initial delay in milliseconds (default: 1000)
+ * @returns Promise that resolves to the result of Promise.all
+ */
+const retryPromiseAll = async (promises, retries = 3, delay = 1000) => {
+    for (let i = 0; i < retries; i++) {
+        try {
+            return await Promise.all(promises);
+        }
+        catch (error) {
+            if (i === retries - 1)
+                throw error;
+            await new Promise((resolve) => setTimeout(resolve, delay * Math.pow(2, i)));
+        }
+    }
+    throw new Error('All retries exhausted');
+};
+exports.retryPromiseAll = retryPromiseAll;
+//# sourceMappingURL=decimal.js.map

package/dist/utils/decimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.js","sourceRoot":"","sources":["../../src/utils/decimal.ts"],"names":[],"mappings":";;;AAAA,2CAAqC;AAErC,uCAAuC;AACvC,oBAAO,CAAC,MAAM,CAAC;IACb,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE,oBAAO,CAAC,aAAa;CAChC,CAAC,CAAC;AAEH;;;;GAIG;AACI,MAAM,EAAE,GAAG,CAAC,KAAsB,EAAW,EAAE,CAAC,IAAI,oBAAO,CAAC,KAAK,CAAC,CAAC;AAA7D,QAAA,EAAE,MAA2D;AAE1E;;;;;;GAMG;AACI,MAAM,eAAe,GAAG,KAAK,EAClC,QAAsB,EACtB,OAAO,GAAG,CAAC,EACX,KAAK,GAAG,IAAI,EACE,EAAE;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,OAAO,GAAG,CAAC;gBAAE,MAAM,KAAK,CAAC;YACnC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5B,UAAU,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAC5C,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;AAC3C,CAAC,CAAC;AAhBW,QAAA,eAAe,mBAgB1B"}

package/dist/utils/wallet.d.ts

@@ -0,0 +1,11 @@
+import { GatewayApiClient, LedgerStateSelector } from '@radixdlt/babylon-gateway-api-sdk';
+import { WalletBalances } from '../types';
+/**
+ * Fetch complete wallet balances including fungible and non-fungible tokens
+ * @param gatewayApi - Gateway API client instance
+ * @param walletAddress - The wallet address to fetch balances for
+ * @param ledgerState - Optional ledger state selector for historical data
+ * @returns Complete wallet balance information
+ */
+export declare const fetchWalletBalances: (gatewayApi: GatewayApiClient, walletAddress: string, ledgerState?: LedgerStateSelector) => Promise<WalletBalances>;
+//# sourceMappingURL=wallet.d.ts.map

package/dist/utils/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/utils/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAKhB,mBAAmB,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,cAAc,EAGf,MAAM,UAAU,CAAC;AA6ElB;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAY,gBAAgB,EAC5B,eAAe,MAAM,EACrB,cAAc,mBAAmB,KAChC,OAAO,CAAC,cAAc,CA8CxB,CAAC"}

package/dist/utils/wallet.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchWalletBalances = void 0;
+/**
+ * Fetch all fungible resources for a wallet address with pagination
+ * @param gatewayApi - Gateway API client instance
+ * @param walletAddress - The wallet address to fetch fungibles for
+ * @param ledgerState - Optional ledger state selector
+ * @returns Array of all fungible resource collection items
+ */
+const fetchAllFungibles = async (gatewayApi, walletAddress, ledgerState) => {
+    let allFungibleItems = [];
+    let nextCursor = undefined;
+    let response;
+    let stateVersion = undefined;
+    do {
+        response = await gatewayApi.state.innerClient.entityFungiblesPage({
+            stateEntityFungiblesPageRequest: {
+                address: walletAddress,
+                cursor: nextCursor || undefined,
+                aggregation_level: 'Global',
+                at_ledger_state: ledgerState ||
+                    (stateVersion ? { state_version: stateVersion } : undefined),
+            },
+        });
+        allFungibleItems = allFungibleItems.concat(response.items);
+        nextCursor = response.next_cursor;
+        stateVersion = response.ledger_state.state_version;
+    } while (nextCursor);
+    return allFungibleItems;
+};
+/**
+ * Fetch all non-fungible resources for a wallet address with pagination
+ * @param gatewayApi - Gateway API client instance
+ * @param walletAddress - The wallet address to fetch non-fungibles for
+ * @param ledgerState - Optional ledger state selector
+ * @returns Array of all non-fungible resource collection items
+ */
+const fetchAllNonFungibles = async (gatewayApi, walletAddress, ledgerState) => {
+    let allNonFungibleItems = [];
+    let nextCursor = undefined;
+    let response;
+    let stateVersion = undefined;
+    do {
+        response = await gatewayApi.state.innerClient.entityNonFungiblesPage({
+            stateEntityNonFungiblesPageRequest: {
+                address: walletAddress,
+                cursor: nextCursor || undefined,
+                aggregation_level: 'Vault',
+                opt_ins: { non_fungible_include_nfids: true },
+                at_ledger_state: ledgerState ||
+                    (stateVersion ? { state_version: stateVersion } : undefined),
+            },
+        });
+        allNonFungibleItems = allNonFungibleItems.concat(response.items);
+        nextCursor = response.next_cursor;
+        stateVersion = response.ledger_state.state_version;
+    } while (nextCursor);
+    return allNonFungibleItems;
+};
+/**
+ * Fetch complete wallet balances including fungible and non-fungible tokens
+ * @param gatewayApi - Gateway API client instance
+ * @param walletAddress - The wallet address to fetch balances for
+ * @param ledgerState - Optional ledger state selector for historical data
+ * @returns Complete wallet balance information
+ */
+const fetchWalletBalances = async (gatewayApi, walletAddress, ledgerState) => {
+    try {
+        // Fetch both fungible and non-fungible resources in parallel
+        const [fungibleBalances, nonFungibleBalances] = await Promise.all([
+            fetchAllFungibles(gatewayApi, walletAddress, ledgerState),
+            fetchAllNonFungibles(gatewayApi, walletAddress, ledgerState),
+        ]);
+        // Format fungible balances
+        const formattedFungibleBalances = {};
+        fungibleBalances.forEach((balance) => {
+            if (balance.aggregation_level === 'Global') {
+                const amount = balance.amount;
+                const tokenAddress = balance.resource_address;
+                if (+amount > 0) {
+                    formattedFungibleBalances[tokenAddress] = { tokenAddress, amount };
+                }
+            }
+        });
+        // Format non-fungible balances
+        const formattedNonFungibleBalances = {};
+        nonFungibleBalances.forEach((item) => {
+            if (item.aggregation_level === 'Vault' && 'vaults' in item) {
+                const collectionAddress = item.resource_address;
+                const vault = item.vaults.items[0];
+                if (vault && 'items' in vault) {
+                    const ids = vault.items;
+                    if (ids && ids.length > 0) {
+                        formattedNonFungibleBalances[collectionAddress] = {
+                            collectionAddress,
+                            ids,
+                        };
+                    }
+                }
+            }
+        });
+        return {
+            fungible: formattedFungibleBalances,
+            nonFungible: formattedNonFungibleBalances,
+        };
+    }
+    catch (error) {
+        console.error('Error in fetchWalletBalances:', error);
+        throw error;
+    }
+};
+exports.fetchWalletBalances = fetchWalletBalances;
+//# sourceMappingURL=wallet.js.map

package/dist/utils/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../src/utils/wallet.ts"],"names":[],"mappings":"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"}

package/dist/validators/index.d.ts

@@ -0,0 +1,27 @@
+import { GatewayApiClient, LedgerStateSelector } from '@radixdlt/babylon-gateway-api-sdk';
+import { ValidatorInfo, NewFeeFactor, FeeFactor, ResourceCheckResult } from '../types';
+/**
+ * Compute validator fee factor information
+ * @param currentFeeFactor - Current fee factor as string
+ * @param newFeeFactor - New fee factor configuration (if any)
+ * @param currentEpoch - Current epoch number
+ * @returns Fee factor information
+ */
+export declare const computeValidatorFeeFactor: (currentFeeFactor: string, newFeeFactor: NewFeeFactor | null, currentEpoch: number) => FeeFactor;
+/**
+ * Check if a resource exists in users' fungible assets
+ * @param usersAddresses - Array of user addresses to check
+ * @param fungibleResourceToCheck - Resource address to check for
+ * @param gatewayApi - Gateway API client instance
+ * @param ledgerState - Optional ledger state selector
+ * @returns Resource check result with users and total amount
+ */
+export declare const checkResourceInUsersFungibleAssets: (usersAddresses: string[], fungibleResourceToCheck: string, gatewayApi: GatewayApiClient, ledgerState?: LedgerStateSelector) => Promise<ResourceCheckResult>;
+/**
+ * Fetch comprehensive validator information
+ * @param gatewayApi - Gateway API client instance
+ * @param validatorAddress - Validator address to fetch info for
+ * @returns Validator information or undefined if not found/invalid
+ */
+export declare const fetchValidatorInfo: (gatewayApi: GatewayApiClient, validatorAddress: string) => Promise<ValidatorInfo | undefined>;
+//# sourceMappingURL=index.d.ts.map

package/dist/validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAEhB,mBAAmB,EACpB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EACL,aAAa,EAGb,YAAY,EACZ,SAAS,EACT,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAiGlB;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,kBAAkB,MAAM,EACxB,cAAc,YAAY,GAAG,IAAI,EACjC,cAAc,MAAM,KACnB,SA2BF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,GAC7C,gBAAgB,MAAM,EAAE,EACxB,yBAAyB,MAAM,EAC/B,YAAY,gBAAgB,EAC5B,cAAc,mBAAmB,KAChC,OAAO,CAAC,mBAAmB,CAiC7B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,gBAAgB,EAC5B,kBAAkB,MAAM,KACvB,OAAO,CAAC,aAAa,GAAG,SAAS,CAyGnC,CAAC"}

package/dist/validators/index.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchValidatorInfo = exports.checkResourceInUsersFungibleAssets = exports.computeValidatorFeeFactor = void 0;
+const decimal_1 = require("../utils/decimal");
+const date_1 = require("../utils/date");
+/**
+ * Extract metadata from EntityMetadataCollection
+ * @param metadata - The metadata collection to extract from
+ * @returns Extracted metadata as key-value pairs
+ */
+const extractMetadata = (metadata) => {
+    const extractedMetadata = {};
+    metadata.items.forEach((item) => {
+        const valueType = item.value.typed.type;
+        if (valueType === 'String' ||
+            valueType === 'Url' ||
+            valueType === 'GlobalAddress' ||
+            valueType === 'NonFungibleLocalId') {
+            extractedMetadata[item.key] = item.value.typed.value;
+        }
+    });
+    return extractedMetadata;
+};
+/**
+ * Extract vault addresses from validator state
+ * @param state - The validator state object
+ * @returns Validator vault addresses
+ */
+const extractVaultsAddresses = (state) => {
+    let NODE_CURRENTLY_EARNED_LSU_VAULT_ADDRESS = '';
+    let NODE_OWNER_UNLOCKING_LSU_VAULT_ADDRESS = '';
+    let NODE_TOTAL_STAKED_XRD_VAULT_ADDRESS = '';
+    let NODE_UNSTAKING_XRD_VAULT_ADDRESS = '';
+    if ('stake_xrd_vault' in state) {
+        NODE_TOTAL_STAKED_XRD_VAULT_ADDRESS = state.stake_xrd_vault.entity_address;
+    }
+    if ('pending_xrd_withdraw_vault' in state) {
+        NODE_UNSTAKING_XRD_VAULT_ADDRESS = state.pending_xrd_withdraw_vault.entity_address;
+    }
+    if ('locked_owner_stake_unit_vault' in state) {
+        NODE_CURRENTLY_EARNED_LSU_VAULT_ADDRESS = state.locked_owner_stake_unit_vault.entity_address;
+    }
+    if ('pending_owner_stake_unit_unlock_vault' in state) {
+        NODE_OWNER_UNLOCKING_LSU_VAULT_ADDRESS = state.pending_owner_stake_unit_unlock_vault.entity_address;
+    }
+    return {
+        NODE_CURRENTLY_EARNED_LSU_VAULT_ADDRESS,
+        NODE_OWNER_UNLOCKING_LSU_VAULT_ADDRESS,
+        NODE_TOTAL_STAKED_XRD_VAULT_ADDRESS,
+        NODE_UNSTAKING_XRD_VAULT_ADDRESS,
+    };
+};
+/**
+ * Filter pending withdrawals and separate unlocked LSUs
+ * @param pendingWithdrawals - Array of pending withdrawals
+ * @param currentEpoch - Current epoch number
+ * @returns Filtered withdrawals and unlocked amounts
+ */
+const filterPendingWithdrawalsFromUnlockedLSUs = (pendingWithdrawals, currentEpoch) => {
+    let unlockedLSUsAmount = (0, decimal_1.BN)(0);
+    let lsuInUnlockingProcess = (0, decimal_1.BN)(0);
+    const filteredWithdrawals = pendingWithdrawals.filter((withdrawal) => {
+        const isUnlocked = withdrawal.epoch_unlocked <= currentEpoch;
+        if (isUnlocked) {
+            unlockedLSUsAmount = unlockedLSUsAmount.add(withdrawal.stake_unit_amount);
+        }
+        else {
+            lsuInUnlockingProcess = lsuInUnlockingProcess.add(withdrawal.stake_unit_amount);
+        }
+        return !isUnlocked;
+    });
+    return {
+        filteredWithdrawals,
+        unlockedLSUsAmount,
+        lsuInUnlockingProcess,
+    };
+};
+/**
+ * Compute validator fee factor information
+ * @param currentFeeFactor - Current fee factor as string
+ * @param newFeeFactor - New fee factor configuration (if any)
+ * @param currentEpoch - Current epoch number
+ * @returns Fee factor information
+ */
+const computeValidatorFeeFactor = (currentFeeFactor, newFeeFactor, currentEpoch) => {
+    const feeFactor = {
+        aboutToChange: null,
+        current: (+currentFeeFactor * 100).toFixed(2) + '%',
+        alert: '',
+    };
+    if (newFeeFactor) {
+        const newFactorPercentage = (+newFeeFactor.new_fee_factor * 100).toFixed(2) + '%';
+        if (newFeeFactor.epoch_effective <= currentEpoch) {
+            feeFactor.current = newFactorPercentage;
+            feeFactor.aboutToChange = null;
+        }
+        else {
+            feeFactor.aboutToChange = {
+                new_fee_factor: newFactorPercentage,
+                epoch_effective: newFeeFactor.epoch_effective,
+            };
+            feeFactor.alert = `Fee will be changed to ${newFactorPercentage} on ${(0, date_1.calculateEstimatedUnlockDate)(newFeeFactor.epoch_effective, currentEpoch)}`;
+        }
+    }
+    return feeFactor;
+};
+exports.computeValidatorFeeFactor = computeValidatorFeeFactor;
+/**
+ * Check if a resource exists in users' fungible assets
+ * @param usersAddresses - Array of user addresses to check
+ * @param fungibleResourceToCheck - Resource address to check for
+ * @param gatewayApi - Gateway API client instance
+ * @param ledgerState - Optional ledger state selector
+ * @returns Resource check result with users and total amount
+ */
+const checkResourceInUsersFungibleAssets = async (usersAddresses, fungibleResourceToCheck, gatewayApi, ledgerState) => {
+    try {
+        const allPromises = usersAddresses.map((address) => gatewayApi.state.innerClient.entityFungibleResourceVaultPage({
+            stateEntityFungibleResourceVaultsPageRequest: {
+                address,
+                resource_address: fungibleResourceToCheck,
+                at_ledger_state: ledgerState,
+            },
+        }));
+        const allResponses = (await (0, decimal_1.retryPromiseAll)(allPromises)).flat();
+        let totalAmount = (0, decimal_1.BN)(0);
+        const usersWithResourceAmount = {};
+        allResponses.forEach((res) => {
+            res.items.forEach((vault) => {
+                if ((0, decimal_1.BN)(vault.amount).greaterThan(0)) {
+                    usersWithResourceAmount[res.address] = vault.amount;
+                    totalAmount = totalAmount.plus(vault.amount);
+                }
+            });
+        });
+        return {
+            usersWithResourceAmount,
+            totalAmount: totalAmount.toString(),
+        };
+    }
+    catch (error) {
+        console.error('Error in checkResourceInUsersFungibleAssets', error);
+        throw error;
+    }
+};
+exports.checkResourceInUsersFungibleAssets = checkResourceInUsersFungibleAssets;
+/**
+ * Fetch comprehensive validator information
+ * @param gatewayApi - Gateway API client instance
+ * @param validatorAddress - Validator address to fetch info for
+ * @returns Validator information or undefined if not found/invalid
+ */
+const fetchValidatorInfo = async (gatewayApi, validatorAddress) => {
+    if (validatorAddress === '' || !validatorAddress.startsWith('validator_')) {
+        return undefined;
+    }
+    try {
+        const res = await gatewayApi.state.innerClient.stateEntityDetails({
+            stateEntityDetailsRequest: {
+                addresses: [validatorAddress],
+                aggregation_level: 'Vault',
+            },
+        });
+        const validatorInfo = res.items[0];
+        const vaultsBalance = {};
+        let rewardsInUnlockingProcess = [];
+        const epoch = res.ledger_state.epoch;
+        let unlockedLSUs = (0, decimal_1.BN)(0);
+        let ownerLSUsInUnlockingProcess = (0, decimal_1.BN)(0);
+        let stakeUnitAddress = '';
+        let fees = { alert: '', current: '', aboutToChange: null };
+        if (validatorInfo?.details?.type === 'Component' &&
+            validatorInfo?.details?.state) {
+            const metadata = extractMetadata(res.items[0].metadata);
+            const validatorState = validatorInfo.details.state;
+            const vaults = extractVaultsAddresses(validatorState);
+            // Extract vault balances
+            validatorInfo?.fungible_resources?.items.forEach((resource) => {
+                if (resource.aggregation_level === 'Vault') {
+                    resource.vaults.items.forEach((vault) => {
+                        vaultsBalance[vault.vault_address] = vault.amount;
+                    });
+                }
+            });
+            // Process pending withdrawals
+            if ('pending_owner_stake_unit_withdrawals' in validatorState) {
+                const { filteredWithdrawals, unlockedLSUsAmount, lsuInUnlockingProcess, } = filterPendingWithdrawalsFromUnlockedLSUs(validatorState.pending_owner_stake_unit_withdrawals, epoch);
+                rewardsInUnlockingProcess = filteredWithdrawals;
+                unlockedLSUs = unlockedLSUs.add(unlockedLSUsAmount);
+                ownerLSUsInUnlockingProcess = ownerLSUsInUnlockingProcess.add(lsuInUnlockingProcess);
+            }
+            // Add already unlocked amounts
+            if ('already_unlocked_owner_stake_unit_amount' in validatorState) {
+                unlockedLSUs = unlockedLSUs.add(validatorState.already_unlocked_owner_stake_unit_amount);
+            }
+            // Get stake unit address
+            if ('stake_unit_resource_address' in validatorState) {
+                stakeUnitAddress = validatorState.stake_unit_resource_address;
+            }
+            // Compute fees
+            if ('validator_fee_factor' in validatorState &&
+                'validator_fee_change_request' in validatorState) {
+                fees = (0, exports.computeValidatorFeeFactor)(validatorState.validator_fee_factor, validatorState.validator_fee_change_request, epoch);
+            }
+            const info = {
+                currentlyEarnedLockedLSUs: vaultsBalance[vaults.NODE_CURRENTLY_EARNED_LSU_VAULT_ADDRESS] || '0',
+                ownerLSUsInUnlockingProcess: ownerLSUsInUnlockingProcess.toString(),
+                totalStakedXrds: vaultsBalance[vaults.NODE_TOTAL_STAKED_XRD_VAULT_ADDRESS] || '0',
+                totalXrdsLeavingOurNode: vaultsBalance[vaults.NODE_UNSTAKING_XRD_VAULT_ADDRESS] || '0',
+                unlockingLSUsBreakdown: rewardsInUnlockingProcess,
+                epoch,
+                unlockedLSUs: unlockedLSUs.toString(),
+                metadata,
+                stakeUnitAddress,
+                vaults,
+                validatorAddress,
+                fees,
+            };
+            return info;
+        }
+    }
+    catch (error) {
+        console.error('Error in fetchValidatorInfo', error);
+    }
+    return undefined;
+};
+exports.fetchValidatorInfo = fetchValidatorInfo;
+//# sourceMappingURL=index.js.map

package/dist/validators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "radix-utils",
+  "version": "1.1.0",
+  "description": "Utility functions for Radix DLT blockchain development",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts",
+    "prepublishOnly": "npm run build",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "radix",
+    "radixdlt",
+    "blockchain",
+    "crypto",
+    "utilities",
+    "validators",
+    "staking"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "bugs": {
+    "url": ""
+  },
+  "homepage": "",
+  "dependencies": {
+    "@radixdlt/babylon-gateway-api-sdk": "^1.6.0",
+    "decimal.js": "^10.4.3"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.5",
+    "@types/node": "^20.6.0",
+    "@typescript-eslint/eslint-plugin": "^6.7.0",
+    "@typescript-eslint/parser": "^6.7.0",
+    "eslint": "^8.49.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.0.3",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.2.2"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}