@amadeus-protocol/sdk 1.0.1 → 1.0.3

package/dist/constants.d.ts

@@ -23,6 +23,10 @@ export declare const AMA_TOKEN_DECIMALS = 9;
  * Multiplier for converting between atomic units and AMA tokens
  */
 export declare const AMA_TOKEN_DECIMALS_MULTIPLIER: number;
+/**
+ * Minimum transferable amount in AMA (1 atomic unit)
+ */
+export declare const MIN_TRANSFERABLE_AMOUNT: number;
 /**
  * Flat network transfer fee in AMA for standard transfers
  */

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,UAAU,CAAA;AAElC;;GAEG;AACH,eAAO,MAAM,8BAA8B,KAAK,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAA;AAE1C;;GAEG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC;;GAEG;AACH,eAAO,MAAM,6BAA6B,QAA2B,CAAA;AAErE;;GAEG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAA;AAEpC;;GAEG;AACH,eAAO,MAAM,YAAY,6BAA6B,CAAA;AAEtD;;GAEG;AACH,eAAO,MAAM,YAAY,kCAAkC,CAAA;AAE3D;;GAEG;AACH,eAAO,MAAM,eAAe,QAAQ,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,UAAU,CAAA;AAElC;;GAEG;AACH,eAAO,MAAM,8BAA8B,KAAK,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAA;AAE1C;;GAEG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC;;GAEG;AACH,eAAO,MAAM,6BAA6B,QAA2B,CAAA;AAErE;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAoC,CAAA;AAExE;;GAEG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAA;AAEpC;;GAEG;AACH,eAAO,MAAM,YAAY,6BAA6B,CAAA;AAEtD;;GAEG;AACH,eAAO,MAAM,YAAY,kCAAkC,CAAA;AAE3D;;GAEG;AACH,eAAO,MAAM,eAAe,QAAQ,CAAA"}

package/dist/constants.js

@@ -23,6 +23,10 @@ export const AMA_TOKEN_DECIMALS = 9;
  * Multiplier for converting between atomic units and AMA tokens
  */
 export const AMA_TOKEN_DECIMALS_MULTIPLIER = 10 ** AMA_TOKEN_DECIMALS;
+/**
+ * Minimum transferable amount in AMA (1 atomic unit)
+ */
+export const MIN_TRANSFERABLE_AMOUNT = 1 / AMA_TOKEN_DECIMALS_MULTIPLIER;
 /**
  * Flat network transfer fee in AMA for standard transfers
  */

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAA;AAElC;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAA;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAA;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAA;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,IAAI,kBAAkB,CAAA;AAErE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAA;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAA;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,+BAA+B,CAAA;AAE3D;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAA"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAA;AAElC;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAA;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAA;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAA;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,IAAI,kBAAkB,CAAA;AAErE;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,6BAA6B,CAAA;AAExE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAA;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAA;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,+BAA+B,CAAA;AAE3D;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAA"}

package/dist/conversion.d.ts

@@ -20,8 +20,10 @@ export declare function fromAtomicAma(atomicAma: number | string): number;
 /**
  * Convert human-readable AMA amount to atomic units
  *
+ * Uses Math.trunc to avoid floating-point precision issues.
+ *
  * @param ama - Human-readable AMA amount
- * @returns Atomic units
+ * @returns Atomic units (integer)
  *
  * @example
  * ```ts

package/dist/conversion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversion.d.ts","sourceRoot":"","sources":["../src/conversion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAgBhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C"}
+{"version":3,"file":"conversion.d.ts","sourceRoot":"","sources":["../src/conversion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAgBhE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/conversion.js

@@ -36,8 +36,10 @@ export function fromAtomicAma(atomicAma) {
 /**
  * Convert human-readable AMA amount to atomic units
  *
+ * Uses Math.trunc to avoid floating-point precision issues.
+ *
  * @param ama - Human-readable AMA amount
- * @returns Atomic units
+ * @returns Atomic units (integer)
  *
  * @example
  * ```ts
@@ -45,6 +47,6 @@ export function fromAtomicAma(atomicAma) {
  * ```
  */
 export function toAtomicAma(ama) {
-    return ama * AMA_TOKEN_DECIMALS_MULTIPLIER;
+    return Math.trunc(ama * AMA_TOKEN_DECIMALS_MULTIPLIER);
 }
 //# sourceMappingURL=conversion.js.map

package/dist/conversion.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversion.js","sourceRoot":"","sources":["../src/conversion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAE3D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,SAA0B;IACvD,MAAM,eAAe,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAEzF,IAAI,KAAK,CAAC,eAAe,CAAC,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,CAAA;IACT,CAAC;IACD,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IAC9C,CAAC;IACD,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;IACxC,CAAC;IACD,IAAI,eAAe,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,eAAe,GAAG,6BAA6B,CAAA;AACvD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACtC,OAAO,GAAG,GAAG,6BAA6B,CAAA;AAC3C,CAAC"}
+{"version":3,"file":"conversion.js","sourceRoot":"","sources":["../src/conversion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAE3D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,SAA0B;IACvD,MAAM,eAAe,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAEzF,IAAI,KAAK,CAAC,eAAe,CAAC,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,CAAA;IACT,CAAC;IACD,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IAC9C,CAAC;IACD,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;IACxC,CAAC;IACD,IAAI,eAAe,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,eAAe,GAAG,6BAA6B,CAAA;AACvD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,6BAA6B,CAAC,CAAA;AACvD,CAAC"}

package/dist/explorer.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Explorer URL Utilities
+ *
+ * This module provides utilities for generating Amadeus explorer URLs.
+ */
+/**
+ * Types of explorer links
+ */
+export declare enum ExplorerType {
+    TRANSACTION = "tx",
+    ADDRESS = "address",
+    TIP = "tip"
+}
+/**
+ * Constructs an explorer URL for a given type and ID
+ *
+ * @param type - The type of entity (transaction, address, tip)
+ * @param id - The ID/hash/address of the entity
+ * @param baseUrl - Optional base explorer URL (defaults to mainnet explorer URL)
+ * @returns The full explorer URL
+ *
+ * @example
+ * ```ts
+ * makeExplorerUrl(ExplorerType.TRANSACTION, 'abc123')
+ * // Returns: "https://explorer.ama.one/network/tx/abc123"
+ *
+ * makeExplorerUrl(ExplorerType.ADDRESS, 'xyz789', 'https://testnet.explorer.ama.one')
+ * // Returns: "https://testnet.explorer.ama.one/network/address/xyz789"
+ * ```
+ */
+export declare function makeExplorerUrl(type: ExplorerType, id: string, baseUrl?: string): string;
+/**
+ * Create a transaction explorer URL
+ *
+ * @param txHash - Transaction hash
+ * @param baseUrl - Optional base explorer URL
+ * @returns Transaction explorer URL
+ */
+export declare function makeTransactionUrl(txHash: string, baseUrl?: string): string;
+/**
+ * Create an address explorer URL
+ *
+ * @param address - Wallet address
+ * @param baseUrl - Optional base explorer URL
+ * @returns Address explorer URL
+ */
+export declare function makeAddressUrl(address: string, baseUrl?: string): string;
+//# sourceMappingURL=explorer.d.ts.map

package/dist/explorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer.d.ts","sourceRoot":"","sources":["../src/explorer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,oBAAY,YAAY;IACvB,WAAW,OAAO;IAClB,OAAO,YAAY;IACnB,GAAG,QAAQ;CACX;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAExE"}

package/dist/explorer.js

@@ -0,0 +1,57 @@
+/**
+ * Explorer URL Utilities
+ *
+ * This module provides utilities for generating Amadeus explorer URLs.
+ */
+import { NETWORK_EXPLORER_URLS, NetworkType } from './networks';
+/**
+ * Types of explorer links
+ */
+export var ExplorerType;
+(function (ExplorerType) {
+    ExplorerType["TRANSACTION"] = "tx";
+    ExplorerType["ADDRESS"] = "address";
+    ExplorerType["TIP"] = "tip";
+})(ExplorerType || (ExplorerType = {}));
+/**
+ * Constructs an explorer URL for a given type and ID
+ *
+ * @param type - The type of entity (transaction, address, tip)
+ * @param id - The ID/hash/address of the entity
+ * @param baseUrl - Optional base explorer URL (defaults to mainnet explorer URL)
+ * @returns The full explorer URL
+ *
+ * @example
+ * ```ts
+ * makeExplorerUrl(ExplorerType.TRANSACTION, 'abc123')
+ * // Returns: "https://explorer.ama.one/network/tx/abc123"
+ *
+ * makeExplorerUrl(ExplorerType.ADDRESS, 'xyz789', 'https://testnet.explorer.ama.one')
+ * // Returns: "https://testnet.explorer.ama.one/network/address/xyz789"
+ * ```
+ */
+export function makeExplorerUrl(type, id, baseUrl) {
+    const explorerBase = baseUrl || NETWORK_EXPLORER_URLS[NetworkType.MAINNET];
+    return `${explorerBase}/network/${type}/${id}`;
+}
+/**
+ * Create a transaction explorer URL
+ *
+ * @param txHash - Transaction hash
+ * @param baseUrl - Optional base explorer URL
+ * @returns Transaction explorer URL
+ */
+export function makeTransactionUrl(txHash, baseUrl) {
+    return makeExplorerUrl(ExplorerType.TRANSACTION, txHash, baseUrl);
+}
+/**
+ * Create an address explorer URL
+ *
+ * @param address - Wallet address
+ * @param baseUrl - Optional base explorer URL
+ * @returns Address explorer URL
+ */
+export function makeAddressUrl(address, baseUrl) {
+    return makeExplorerUrl(ExplorerType.ADDRESS, address, baseUrl);
+}
+//# sourceMappingURL=explorer.js.map

package/dist/explorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer.js","sourceRoot":"","sources":["../src/explorer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE/D;;GAEG;AACH,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACvB,kCAAkB,CAAA;IAClB,mCAAmB,CAAA;IACnB,2BAAW,CAAA;AACZ,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB,EAAE,EAAU,EAAE,OAAgB;IAC/E,MAAM,YAAY,GAAG,OAAO,IAAI,qBAAqB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IAC1E,OAAO,GAAG,YAAY,YAAY,IAAI,IAAI,EAAE,EAAE,CAAA;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,OAAgB;IAClE,OAAO,eAAe,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;AAClE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,OAAgB;IAC/D,OAAO,eAAe,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AAC/D,CAAC"}

package/dist/formatters.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Formatting Utilities
+ *
+ * This module provides common formatting functions for amounts, addresses, and dates.
+ */
+/**
+ * Format a number with locale-aware commas and specified decimal places
+ *
+ * @param num - The number to format
+ * @param digits - Maximum fraction digits (default: 8)
+ * @returns Formatted number string
+ *
+ * @example
+ * ```ts
+ * formatNumber(1234567.89) // "1,234,567.89"
+ * formatNumber(1.123456789, 4) // "1.1235"
+ * ```
+ */
+export declare function formatNumber(num: number, digits?: number): string;
+/**
+ * Format an amount with the AMA suffix
+ *
+ * @param amount - The amount to format
+ * @returns Formatted string like "1,234.56 AMA"
+ */
+export declare function formatAMAAmount(amount: number): string;
+/**
+ * Format a balance value with proper AMA token decimals
+ *
+ * @param amount - The balance amount (string, number, or undefined)
+ * @returns Formatted balance string
+ */
+export declare function formatBalance(amount: string | number | undefined): string;
+/**
+ * Format balance with privacy mode support
+ *
+ * @param amount - The balance amount
+ * @param hideBalances - Whether to hide the balance
+ * @returns Formatted balance or masked string
+ */
+export declare function formatBalanceWithPrivacy(amount: string | number | undefined, hideBalances: boolean): string;
+/**
+ * Truncate an address for display (e.g., "abc123...xyz789")
+ *
+ * @param address - The full address
+ * @param chars - Number of characters to show on each side (default: 6)
+ * @returns Truncated address string
+ *
+ * @example
+ * ```ts
+ * formatShortAddress("abcdefghijklmnopqrstuvwxyz") // "abcdef...uvwxyz"
+ * formatShortAddress("abcdefghijklmnopqrstuvwxyz", 4) // "abcd...wxyz"
+ * ```
+ */
+export declare function formatShortAddress(address: string, chars?: number): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAYzE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACvC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACnC,YAAY,EAAE,OAAO,GACnB,MAAM,CAGR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAGrE"}

package/dist/formatters.js

@@ -0,0 +1,80 @@
+/**
+ * Formatting Utilities
+ *
+ * This module provides common formatting functions for amounts, addresses, and dates.
+ */
+import { AMA_TOKEN_DECIMALS } from './constants';
+/**
+ * Format a number with locale-aware commas and specified decimal places
+ *
+ * @param num - The number to format
+ * @param digits - Maximum fraction digits (default: 8)
+ * @returns Formatted number string
+ *
+ * @example
+ * ```ts
+ * formatNumber(1234567.89) // "1,234,567.89"
+ * formatNumber(1.123456789, 4) // "1.1235"
+ * ```
+ */
+export function formatNumber(num, digits = 8) {
+    return num.toLocaleString(undefined, { maximumFractionDigits: digits });
+}
+/**
+ * Format an amount with the AMA suffix
+ *
+ * @param amount - The amount to format
+ * @returns Formatted string like "1,234.56 AMA"
+ */
+export function formatAMAAmount(amount) {
+    return `${formatNumber(amount)} AMA`;
+}
+/**
+ * Format a balance value with proper AMA token decimals
+ *
+ * @param amount - The balance amount (string, number, or undefined)
+ * @returns Formatted balance string
+ */
+export function formatBalance(amount) {
+    if (amount === undefined)
+        return '0';
+    const num = Number(amount);
+    if (!Number.isNaN(num)) {
+        return num.toLocaleString(undefined, {
+            minimumFractionDigits: 0,
+            maximumFractionDigits: AMA_TOKEN_DECIMALS
+        });
+    }
+    return String(amount);
+}
+/**
+ * Format balance with privacy mode support
+ *
+ * @param amount - The balance amount
+ * @param hideBalances - Whether to hide the balance
+ * @returns Formatted balance or masked string
+ */
+export function formatBalanceWithPrivacy(amount, hideBalances) {
+    if (hideBalances)
+        return '******';
+    return formatBalance(amount);
+}
+/**
+ * Truncate an address for display (e.g., "abc123...xyz789")
+ *
+ * @param address - The full address
+ * @param chars - Number of characters to show on each side (default: 6)
+ * @returns Truncated address string
+ *
+ * @example
+ * ```ts
+ * formatShortAddress("abcdefghijklmnopqrstuvwxyz") // "abcdef...uvwxyz"
+ * formatShortAddress("abcdefghijklmnopqrstuvwxyz", 4) // "abcd...wxyz"
+ * ```
+ */
+export function formatShortAddress(address, chars = 6) {
+    if (!address || address.length <= chars * 2)
+        return address || '';
+    return `${address.substring(0, chars)}...${address.substring(address.length - chars)}`;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,MAAM,GAAG,CAAC;IACnD,OAAO,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,EAAE,qBAAqB,EAAE,MAAM,EAAE,CAAC,CAAA;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC7C,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAA;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAmC;IAChE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,GAAG,CAAA;IAEpC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE;YACpC,qBAAqB,EAAE,CAAC;YACxB,qBAAqB,EAAE,kBAAkB;SACzC,CAAC,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,CAAA;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACvC,MAAmC,EACnC,YAAqB;IAErB,IAAI,YAAY;QAAE,OAAO,QAAQ,CAAA;IACjC,OAAO,aAAa,CAAC,MAAM,CAAC,CAAA;AAC7B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,KAAK,GAAG,CAAC;IAC5D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,OAAO,IAAI,EAAE,CAAA;IACjE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE,CAAA;AACvF,CAAC"}

package/dist/index.d.ts

@@ -35,11 +35,16 @@
  */
 export * from './types';
 export * from './constants';
+export * from './networks';
 export * from './serialization';
 export * from './crypto';
 export * from './conversion';
 export * from './encoding';
 export * from './encryption';
+export * from './validation';
+export * from './formatters';
+export * from './explorer';
+export * from './transaction-errors';
 export * from './transaction-builder';
 export * from './client';
 export * from './api';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA"}

package/dist/index.js

@@ -35,11 +35,16 @@
  */
 export * from './types';
 export * from './constants';
+export * from './networks';
 export * from './serialization';
 export * from './crypto';
 export * from './conversion';
 export * from './encoding';
 export * from './encryption';
+export * from './validation';
+export * from './formatters';
+export * from './explorer';
+export * from './transaction-errors';
 export * from './transaction-builder';
 export * from './client';
 export * from './api';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA"}

package/dist/networks.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Network Configuration
+ *
+ * This module provides network configuration for Amadeus Protocol networks.
+ */
+/**
+ * Network types enum
+ */
+export declare enum NetworkType {
+    MAINNET = "mainnet",
+    TESTNET = "testnet",
+    CUSTOM = "custom"
+}
+/**
+ * Network configuration interface
+ */
+export interface NetworkConfig {
+    rpcUrl: string;
+    explorerUrl: string;
+}
+/**
+ * Network API URLs
+ */
+export declare const NETWORK_URLS: {
+    [key in Exclude<NetworkType, NetworkType.CUSTOM>]: string;
+};
+/**
+ * Network Explorer URLs
+ */
+export declare const NETWORK_EXPLORER_URLS: {
+    [key in Exclude<NetworkType, NetworkType.CUSTOM>]: string;
+};
+/**
+ * Network configurations (RPC + Explorer)
+ */
+export declare const NETWORK_CONFIGS: {
+    [key in Exclude<NetworkType, NetworkType.CUSTOM>]: NetworkConfig;
+};
+/**
+ * Testnet Faucet URL
+ */
+export declare const TESTNET_FAUCET_URL = "https://mcp.ama.one/testnet-faucet";
+//# sourceMappingURL=networks.d.ts.map

package/dist/networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,WAAW;IACtB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,MAAM,WAAW;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE;KAAG,GAAG,IAAI,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM;CAGrF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE;KAAG,GAAG,IAAI,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM;CAG9F,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE;KAAG,GAAG,IAAI,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,aAAa;CAU9F,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,uCAAuC,CAAA"}

package/dist/networks.js

@@ -0,0 +1,46 @@
+/**
+ * Network Configuration
+ *
+ * This module provides network configuration for Amadeus Protocol networks.
+ */
+/**
+ * Network types enum
+ */
+export var NetworkType;
+(function (NetworkType) {
+    NetworkType["MAINNET"] = "mainnet";
+    NetworkType["TESTNET"] = "testnet";
+    NetworkType["CUSTOM"] = "custom";
+})(NetworkType || (NetworkType = {}));
+/**
+ * Network API URLs
+ */
+export const NETWORK_URLS = {
+    [NetworkType.MAINNET]: 'https://nodes.amadeus.bot',
+    [NetworkType.TESTNET]: 'https://testnet-rpc.ama.one'
+};
+/**
+ * Network Explorer URLs
+ */
+export const NETWORK_EXPLORER_URLS = {
+    [NetworkType.MAINNET]: 'https://explorer.ama.one',
+    [NetworkType.TESTNET]: 'https://testnet.explorer.ama.one'
+};
+/**
+ * Network configurations (RPC + Explorer)
+ */
+export const NETWORK_CONFIGS = {
+    [NetworkType.MAINNET]: {
+        rpcUrl: NETWORK_URLS[NetworkType.MAINNET],
+        explorerUrl: NETWORK_EXPLORER_URLS[NetworkType.MAINNET]
+    },
+    [NetworkType.TESTNET]: {
+        rpcUrl: NETWORK_URLS[NetworkType.TESTNET],
+        explorerUrl: NETWORK_EXPLORER_URLS[NetworkType.TESTNET]
+    }
+};
+/**
+ * Testnet Faucet URL
+ */
+export const TESTNET_FAUCET_URL = 'https://mcp.ama.one/testnet-faucet';
+//# sourceMappingURL=networks.js.map

package/dist/networks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.js","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACtB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,gCAAiB,CAAA;AAClB,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAUD;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAkE;IAC1F,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,2BAA2B;IAClD,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,6BAA6B;CACpD,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAkE;IACnG,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,0BAA0B;IACjD,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,kCAAkC;CACzD,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAC3B;IACC,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE;QACtB,MAAM,EAAE,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC;QACzC,WAAW,EAAE,qBAAqB,CAAC,WAAW,CAAC,OAAO,CAAC;KACvD;IACD,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE;QACtB,MAAM,EAAE,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC;QACzC,WAAW,EAAE,qBAAqB,CAAC,WAAW,CAAC,OAAO,CAAC;KACvD;CACD,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,oCAAoC,CAAA"}

package/dist/transaction-errors.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Transaction Error Messages
+ *
+ * This module provides human-readable error messages for transaction validation
+ * and execution errors.
+ */
+import { TransactionExecutionError, TransactionValidationError } from './types';
+/**
+ * Human-readable messages for transaction validation errors
+ */
+export declare const TRANSACTION_VALIDATION_ERROR_MESSAGES: Record<TransactionValidationError, string>;
+/**
+ * Human-readable messages for transaction execution errors
+ */
+export declare const TRANSACTION_EXECUTION_ERROR_MESSAGES: Record<TransactionExecutionError, string>;
+/**
+ * Get a human-readable message for a transaction validation error
+ *
+ * @param error - The validation error code
+ * @returns Human-readable error message
+ */
+export declare function getValidationErrorMessage(error: TransactionValidationError | string): string;
+/**
+ * Get a human-readable message for a transaction execution error
+ *
+ * @param error - The execution error code
+ * @returns Human-readable error message
+ */
+export declare function getExecutionErrorMessage(error: TransactionExecutionError | string): string;
+/**
+ * Get a human-readable message for any transaction error (validation or execution)
+ *
+ * @param error - The error code (validation or execution)
+ * @returns Human-readable error message
+ */
+export declare function getTransactionErrorMessage(error: TransactionValidationError | TransactionExecutionError | string): string;
+//# sourceMappingURL=transaction-errors.d.ts.map

package/dist/transaction-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-errors.d.ts","sourceRoot":"","sources":["../src/transaction-errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAE/E;;GAEG;AACH,eAAO,MAAM,qCAAqC,EAAE,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAuB5F,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,oCAAoC,EAAE,MAAM,CAAC,yBAAyB,EAAE,MAAM,CAqH1F,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,GAAG,MAAM,CAK5F;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,GAAG,MAAM,CAK1F;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,0BAA0B,GAAG,yBAAyB,GAAG,MAAM,GACpE,MAAM,CAWR"}