@galaxy-kj/core-stellar-sdk 2.0.0

package/dist/utils/encryption.utils.js

@@ -0,0 +1,44 @@
+import crypto from 'crypto';
+const ALGO = 'aes-256-gcm';
+const IV_LENGTH = 12;
+/**
+ * Encrypts text using AES-256-GCM with a password
+ */
+export function encryptPrivateKey(privateKey, password) {
+    const salt = crypto.randomBytes(16);
+    const iv = crypto.randomBytes(IV_LENGTH);
+    // Derive 256-bit key from password using PBKDF2
+    const key = crypto.pbkdf2Sync(password, salt, 100000, 32, 'sha256');
+    const cipher = crypto.createCipheriv(ALGO, key, iv);
+    const encrypted = Buffer.concat([
+        cipher.update(privateKey, 'utf8'),
+        cipher.final(),
+    ]);
+    const authTag = cipher.getAuthTag();
+    // Format: salt:iv:authTag:ciphertext (Base64)
+    return [
+        salt.toString('base64'),
+        iv.toString('base64'),
+        authTag.toString('base64'),
+        encrypted.toString('base64'),
+    ].join(':');
+}
+/**
+ * Decrypts AES-256-GCM encrypted private key
+ */
+export function decryptPrivateKey(encryptedData, password) {
+    const [saltB64, ivB64, authTagB64, encryptedB64] = encryptedData.split(':');
+    const salt = Buffer.from(saltB64, 'base64');
+    const iv = Buffer.from(ivB64, 'base64');
+    const authTag = Buffer.from(authTagB64, 'base64');
+    const encrypted = Buffer.from(encryptedB64, 'base64');
+    const key = crypto.pbkdf2Sync(password, salt, 100000, 32, 'sha256');
+    const decipher = crypto.createDecipheriv(ALGO, key, iv);
+    decipher.setAuthTag(authTag);
+    const decrypted = Buffer.concat([
+        decipher.update(encrypted),
+        decipher.final(),
+    ]);
+    return decrypted.toString('utf8');
+}
+//# sourceMappingURL=encryption.utils.js.map

package/dist/utils/encryption.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.utils.js","sourceRoot":"","sources":["../../src/utils/encryption.utils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,IAAI,GAAG,aAAa,CAAC;AAC3B,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,QAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAEzC,gDAAgD;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IAEpE,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC;QACjC,MAAM,CAAC,KAAK,EAAE;KACf,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAEpC,8CAA8C;IAC9C,OAAO;QACL,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACvB,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC1B,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;KAC7B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,aAAqB,EACrB,QAAgB;IAEhB,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE5E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAEtD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IAEpE,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACxD,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAE7B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;QAC9B,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE;KACjB,CAAC,CAAC;IACH,OAAO,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/utils/network-utils.d.ts

@@ -0,0 +1,138 @@
+/**
+ * @fileoverview Network utilities for Stellar operations
+ * @description Helper functions for network-related operations
+ * @author Galaxy DevKit Team
+ * @version 1.0.0
+ * @since 2024-12-01
+ */
+import { NetworkConfig } from '../types/stellar-types';
+/**
+ * Network utility class
+ * @class NetworkUtils
+ * @description Provides helper methods for network operations
+ */
+export declare class NetworkUtils {
+    /**
+     * Predefined network configurations
+     */
+    static readonly NETWORKS: {
+        PUBLIC: NetworkConfig;
+        TESTNET: NetworkConfig;
+    };
+    /**
+     * Validates if a string is a valid Stellar public key
+     * @param publicKey - Public key to validate
+     * @returns boolean
+     */
+    isValidPublicKey(publicKey: string): boolean;
+    /**
+     * Validates if a string is a valid Stellar secret key
+     * @param secretKey - Secret key to validate
+     * @returns boolean
+     */
+    isValidSecretKey(secretKey: string): boolean;
+    /**
+     * Gets network configuration by name
+     * @param networkName - Network name ('public' or 'testnet')
+     * @returns NetworkConfig
+     */
+    getNetworkConfig(networkName: 'public' | 'testnet'): NetworkConfig;
+    /**
+     * Creates a custom network configuration
+     * @param horizonUrl - Horizon server URL
+     * @param passphrase - Network passphrase
+     * @param name - Network name
+     * @returns NetworkConfig
+     */
+    createCustomNetwork(horizonUrl: string, passphrase: string, network?: 'testnet' | 'mainnet'): NetworkConfig;
+    /**
+     * Determines if the network is testnet based on passphrase
+     * @param passphrase - Network passphrase
+     * @returns boolean
+     */
+    static isTestnet(passphrase: string): boolean;
+    /**
+     * Determines if the network is public based on passphrase
+     * @param passphrase - Network passphrase
+     * @returns boolean
+     */
+    isPublic(passphrase: string): boolean;
+    /**
+     * Gets the appropriate friendbot URL for testnet funding
+     * @returns string
+     */
+    getFriendbotUrl(): string;
+    /**
+     * Funds a testnet account using Friendbot
+     * @param publicKey - Public key to fund
+     * @returns Promise<boolean>
+     */
+    fundTestnetAccount(publicKey: string): Promise<boolean>;
+    /**
+     * Encodes raw public key bytes to Stellar format
+     * @param rawPublicKey - Raw public key bytes
+     * @returns string
+     */
+    encodePublicKey(rawPublicKey: Buffer): string;
+    /**
+     * Encodes raw secret key bytes to Stellar format
+     * @param rawSecretKey - Raw secret key bytes
+     * @returns string
+     */
+    encodeSecretKey(rawSecretKey: Buffer): string;
+    /**
+     * Decodes a Stellar public key to raw bytes
+     * @param publicKey - Stellar public key
+     * @returns Buffer
+     */
+    decodePublicKey(publicKey: string): Buffer;
+    /**
+     * Decodes a Stellar secret key to raw bytes
+     * @param secretKey - Stellar secret key
+     * @returns Buffer
+     */
+    decodeSecretKey(secretKey: string): Buffer;
+    /**
+     * Validates a Stellar address (account ID)
+     * @param address - Address to validate
+     * @returns boolean
+     */
+    isValidAddress(address: string): boolean;
+    /**
+     * Validates a muxed account address
+     * @param address - Muxed address to validate
+     * @returns boolean
+     */
+    isValidMuxedAccount(address: string): boolean;
+    /**
+     * Gets explorer URL for a transaction
+     * @param txHash - Transaction hash
+     * @param network - Network type
+     * @returns string
+     */
+    getExplorerUrl(txHash: string, network?: 'public' | 'testnet'): string;
+    /**
+     * Gets explorer URL for an account
+     * @param publicKey - Account public key
+     * @param network - Network type
+     * @returns string
+     */
+    getAccountExplorerUrl(publicKey: string, network?: 'public' | 'testnet'): string;
+    /**
+     * Checks network connectivity
+     * @param horizonUrl - Horizon server URL
+     * @returns Promise<boolean>
+     */
+    checkNetworkConnectivity(horizonUrl: string): Promise<boolean>;
+    /**
+     * Gets network health status
+     * @param horizonUrl - Horizon server URL
+     * @returns Promise<object>
+     */
+    getNetworkHealth(horizonUrl: string): Promise<{
+        isHealthy: boolean;
+        latency?: number;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=network-utils.d.ts.map

package/dist/utils/network-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-utils.d.ts","sourceRoot":"","sources":["../../src/utils/network-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;GAIG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ;gBAMjB,aAAa;iBAMb,aAAa;MAClB;IAEF;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAQ5C;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAQ5C;;;;OAIG;IACH,gBAAgB,CAAC,WAAW,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa;IAMlE;;;;;;OAMG;IACH,mBAAmB,CACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,SAAS,GAAG,SAAqB,GACzC,aAAa;IAQhB;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI7C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIrC;;;OAGG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;OAIG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuB7D;;;;OAIG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAI7C;;;;OAIG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAI7C;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI1C;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI1C;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIxC;;;;OAIG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAQ7C;;;;;OAKG;IACH,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,QAAQ,GAAG,SAAoB,GACvC,MAAM;IAQT;;;;;OAKG;IACH,qBAAqB,CACnB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,QAAQ,GAAG,SAAoB,GACvC,MAAM;IAQT;;;;OAIG;IACG,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASpE;;;;OAIG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAClD,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CAiBH"}

package/dist/utils/network-utils.js

@@ -0,0 +1,240 @@
+/**
+ * @fileoverview Network utilities for Stellar operations
+ * @description Helper functions for network-related operations
+ * @author Galaxy DevKit Team
+ * @version 1.0.0
+ * @since 2024-12-01
+ */
+import { Networks, StrKey } from '@stellar/stellar-sdk';
+/**
+ * Network utility class
+ * @class NetworkUtils
+ * @description Provides helper methods for network operations
+ */
+export class NetworkUtils {
+    /**
+     * Validates if a string is a valid Stellar public key
+     * @param publicKey - Public key to validate
+     * @returns boolean
+     */
+    isValidPublicKey(publicKey) {
+        try {
+            return StrKey.isValidEd25519PublicKey(publicKey);
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Validates if a string is a valid Stellar secret key
+     * @param secretKey - Secret key to validate
+     * @returns boolean
+     */
+    isValidSecretKey(secretKey) {
+        try {
+            return StrKey.isValidEd25519SecretSeed(secretKey);
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Gets network configuration by name
+     * @param networkName - Network name ('public' or 'testnet')
+     * @returns NetworkConfig
+     */
+    getNetworkConfig(networkName) {
+        return networkName === 'public'
+            ? NetworkUtils.NETWORKS.PUBLIC
+            : NetworkUtils.NETWORKS.TESTNET;
+    }
+    /**
+     * Creates a custom network configuration
+     * @param horizonUrl - Horizon server URL
+     * @param passphrase - Network passphrase
+     * @param name - Network name
+     * @returns NetworkConfig
+     */
+    createCustomNetwork(horizonUrl, passphrase, network = 'testnet') {
+        return {
+            horizonUrl,
+            passphrase,
+            network,
+        };
+    }
+    /**
+     * Determines if the network is testnet based on passphrase
+     * @param passphrase - Network passphrase
+     * @returns boolean
+     */
+    static isTestnet(passphrase) {
+        return passphrase === Networks.TESTNET;
+    }
+    /**
+     * Determines if the network is public based on passphrase
+     * @param passphrase - Network passphrase
+     * @returns boolean
+     */
+    isPublic(passphrase) {
+        return passphrase === Networks.PUBLIC;
+    }
+    /**
+     * Gets the appropriate friendbot URL for testnet funding
+     * @returns string
+     */
+    getFriendbotUrl() {
+        return 'https://friendbot.stellar.org';
+    }
+    /**
+     * Funds a testnet account using Friendbot
+     * @param publicKey - Public key to fund
+     * @returns Promise<boolean>
+     */
+    async fundTestnetAccount(publicKey) {
+        try {
+            if (!this.isValidPublicKey(publicKey)) {
+                throw new Error('Invalid public key');
+            }
+            const friendbotUrl = this.getFriendbotUrl();
+            const response = await fetch(`${friendbotUrl}?addr=${encodeURIComponent(publicKey)}`);
+            if (!response.ok) {
+                throw new Error(`Friendbot request failed: ${response.statusText}`);
+            }
+            return true;
+        }
+        catch (error) {
+            throw new Error(`Failed to fund testnet account: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Encodes raw public key bytes to Stellar format
+     * @param rawPublicKey - Raw public key bytes
+     * @returns string
+     */
+    encodePublicKey(rawPublicKey) {
+        return StrKey.encodeEd25519PublicKey(rawPublicKey);
+    }
+    /**
+     * Encodes raw secret key bytes to Stellar format
+     * @param rawSecretKey - Raw secret key bytes
+     * @returns string
+     */
+    encodeSecretKey(rawSecretKey) {
+        return StrKey.encodeEd25519SecretSeed(rawSecretKey);
+    }
+    /**
+     * Decodes a Stellar public key to raw bytes
+     * @param publicKey - Stellar public key
+     * @returns Buffer
+     */
+    decodePublicKey(publicKey) {
+        return StrKey.decodeEd25519PublicKey(publicKey);
+    }
+    /**
+     * Decodes a Stellar secret key to raw bytes
+     * @param secretKey - Stellar secret key
+     * @returns Buffer
+     */
+    decodeSecretKey(secretKey) {
+        return StrKey.decodeEd25519SecretSeed(secretKey);
+    }
+    /**
+     * Validates a Stellar address (account ID)
+     * @param address - Address to validate
+     * @returns boolean
+     */
+    isValidAddress(address) {
+        return this.isValidPublicKey(address);
+    }
+    /**
+     * Validates a muxed account address
+     * @param address - Muxed address to validate
+     * @returns boolean
+     */
+    isValidMuxedAccount(address) {
+        try {
+            return StrKey.isValidMed25519PublicKey(address);
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Gets explorer URL for a transaction
+     * @param txHash - Transaction hash
+     * @param network - Network type
+     * @returns string
+     */
+    getExplorerUrl(txHash, network = 'public') {
+        const baseUrl = network === 'public'
+            ? 'https://stellar.expert/explorer/public'
+            : 'https://stellar.expert/explorer/testnet';
+        return `${baseUrl}/tx/${txHash}`;
+    }
+    /**
+     * Gets explorer URL for an account
+     * @param publicKey - Account public key
+     * @param network - Network type
+     * @returns string
+     */
+    getAccountExplorerUrl(publicKey, network = 'public') {
+        const baseUrl = network === 'public'
+            ? 'https://stellar.expert/explorer/public'
+            : 'https://stellar.expert/explorer/testnet';
+        return `${baseUrl}/account/${publicKey}`;
+    }
+    /**
+     * Checks network connectivity
+     * @param horizonUrl - Horizon server URL
+     * @returns Promise<boolean>
+     */
+    async checkNetworkConnectivity(horizonUrl) {
+        try {
+            const response = await fetch(horizonUrl);
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Gets network health status
+     * @param horizonUrl - Horizon server URL
+     * @returns Promise<object>
+     */
+    async getNetworkHealth(horizonUrl) {
+        const startTime = Date.now();
+        try {
+            const response = await fetch(horizonUrl);
+            const latency = Date.now() - startTime;
+            return {
+                isHealthy: response.ok,
+                latency,
+            };
+        }
+        catch (error) {
+            return {
+                isHealthy: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+}
+/**
+ * Predefined network configurations
+ */
+NetworkUtils.NETWORKS = {
+    PUBLIC: {
+        name: 'mainnet',
+        horizonUrl: 'https://horizon.stellar.org',
+        passphrase: Networks.PUBLIC,
+        network: 'mainnet',
+    },
+    TESTNET: {
+        name: 'testnet',
+        horizonUrl: 'https://horizon-testnet.stellar.org',
+        passphrase: Networks.TESTNET,
+        network: 'testnet',
+    },
+};
+//# sourceMappingURL=network-utils.js.map

package/dist/utils/network-utils.js.map

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

package/dist/utils/stellar-utils.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @fileoverview Utility functions for Stellar operations
+ * @description Contains helper functions and utilities for Stellar operations
+ * @author Galaxy DevKit Team
+ * @version 1.0.0
+ * @since 2024-12-01
+ */
+/**
+ * Validates a Stellar public key
+ * @param publicKey - The public key to validate
+ * @returns boolean
+ */
+export declare const isValidPublicKey: (publicKey: string) => boolean;
+/**
+ * Validates a Stellar secret key
+ * @param secretKey - The secret key to validate
+ * @returns boolean
+ */
+export declare const isValidSecretKey: (secretKey: string) => boolean;
+/**
+ * Generates a random Stellar keypair
+ * @returns Object with publicKey and secretKey
+ */
+export declare const generateKeypair: () => {
+    publicKey: string;
+    secretKey: string;
+};
+/**
+ * Converts Stellar amount to stroops (smallest unit)
+ * @param amount - Amount in XLM
+ * @returns number of stroops
+ */
+export declare const toStroops: (amount: string | number) => number;
+/**
+ * Converts stroops to XLM amount
+ * @param stroops - Amount in stroops
+ * @returns string representation of XLM amount
+ */
+export declare const fromStroops: (stroops: number) => string;
+/**
+ * Formats a Stellar address for display
+ * @param address - Stellar address
+ * @param startChars - Number of characters to show at start
+ * @param endChars - Number of characters to show at end
+ * @returns formatted address
+ */
+export declare const formatAddress: (address: string, startChars?: number, endChars?: number) => string;
+/**
+ * Validates a Stellar memo
+ * @param memo - Memo to validate
+ * @returns boolean
+ */
+export declare const isValidMemo: (memo: string) => boolean;
+/**
+ * Converts network name to passphrase
+ * @param network - Network name
+ * @returns network passphrase
+ */
+export declare const getNetworkPassphrase: (network: "testnet" | "mainnet") => string;
+/**
+ * Gets Horizon server URL for network
+ * @param network - Network name
+ * @returns Horizon server URL
+ */
+export declare const getHorizonUrl: (network: "testnet" | "mainnet") => string;
+/**
+ * Validates if an amount is positive
+ * @param amount - Amount to validate
+ * @returns boolean
+ */
+export declare const isValidAmount: (amount: string | number) => boolean;
+/**
+ * Formats balance for display
+ * @param balance - Balance amount
+ * @param decimals - Number of decimal places
+ * @returns formatted balance string
+ */
+export declare const formatBalance: (balance: string | number, decimals?: number) => string;
+/**
+ * Checks if two addresses are the same
+ * @param address1 - First address
+ * @param address2 - Second address
+ * @returns boolean
+ */
+export declare const isSameAddress: (address1: string, address2: string) => boolean;
+/**
+ * Generates a transaction memo
+ * @param text - Memo text
+ * @returns memo object
+ */
+export declare const createMemo: (text: string) => {
+    type: string;
+    value: string;
+};
+/**
+ * Calculates transaction fee based on operations
+ * @param operationCount - Number of operations
+ * @param baseFee - Base fee per operation
+ * @returns total fee
+ */
+export declare const calculateFee: (operationCount: number, baseFee?: number) => number;
+/**
+ * Validates asset code format
+ * @param assetCode - Asset code to validate
+ * @returns boolean
+ */
+export declare const isValidAssetCode: (assetCode: string) => boolean;
+/**
+ * Validates a Stellar wallet memo.
+ * @param memo - Memo to validate
+ * @throws Error if memo is invalid
+ */
+export declare function validateMemo(memo: string): void;
+//# sourceMappingURL=stellar-utils.d.ts.map

package/dist/utils/stellar-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stellar-utils.d.ts","sourceRoot":"","sources":["../../src/utils/stellar-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,KAAG,OAOpD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,KAAG,OAOpD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe;;;CAM3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,GAAG,MAAM,KAAG,MAGnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,MAE7C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,MAAM,EACf,aAAY,MAAU,EACtB,WAAU,MAAU,KACnB,MAKF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,OAE1C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,SAAS,GAAG,SAAS,KAC7B,MAIF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,SAAS,GAAG,SAAS,KAAG,MAI9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,GAAG,MAAM,KAAG,OAGvD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,MAAM,GAAG,MAAM,EACxB,WAAU,MAAU,KACnB,MAIF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,UAAU,MAAM,KAAG,OAElE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM;;;CAKtC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GACvB,gBAAgB,MAAM,EACtB,UAAS,MAAY,KACpB,MAEF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,KAAG,OAGpD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAoB/C"}