@amadeus-protocol/sdk 1.0.1 → 1.0.3

package/dist/validation.js

@@ -1,9 +1,12 @@
 /**
  * Validation Utilities
  *
- * Helper functions for validating values using Effect Schemas
+ * Helper functions for validating values using Effect Schemas and
+ * standalone validation functions for Amadeus Protocol data types.
  */
 import { Schema } from 'effect';
+import { AMA_TOKEN_DECIMALS, AMA_TOKEN_DECIMALS_MULTIPLIER, AMADEUS_PUBLIC_KEY_BYTE_LENGTH, AMADEUS_SEED_BYTE_LENGTH, MIN_TRANSFERABLE_AMOUNT } from './constants';
+import { fromBase58 } from './encoding';
 import { AmadeusSDKError } from './types';
 /**
  * Helper function to extract error message from Effect Schema ParseError
@@ -36,4 +39,177 @@ export function validate(schema, value) {
         throw new AmadeusSDKError(getErrorMessage(error));
     }
 }
+/**
+ * Validate an Amadeus address (Base58-encoded 48-byte public key)
+ *
+ * @param address - The address to validate
+ * @returns Validation result with error message if invalid
+ *
+ * @example
+ * ```ts
+ * const result = validateAddress('abc123...')
+ * if (!result.valid) {
+ *   console.error(result.error)
+ * }
+ * ```
+ */
+export function validateAddress(address) {
+    if (!address || typeof address !== 'string') {
+        return { valid: false, error: 'Address is required' };
+    }
+    try {
+        const decoded = fromBase58(address);
+        if (decoded.length !== AMADEUS_PUBLIC_KEY_BYTE_LENGTH) {
+            return {
+                valid: false,
+                error: `Invalid address length: expected ${AMADEUS_PUBLIC_KEY_BYTE_LENGTH} bytes, got ${decoded.length}`
+            };
+        }
+        return { valid: true };
+    }
+    catch {
+        return { valid: false, error: 'Invalid Base58 encoding' };
+    }
+}
+/**
+ * Check if an address is valid (simple boolean version)
+ *
+ * @param address - The address to check
+ * @returns true if valid, false otherwise
+ */
+export function isValidAddress(address) {
+    return validateAddress(address).valid;
+}
+/**
+ * Validate an Amadeus seed (Base58-encoded 64-byte seed)
+ *
+ * @param seed - The seed to validate
+ * @returns Validation result with error message if invalid
+ */
+export function validateSeed(seed) {
+    if (!seed || typeof seed !== 'string') {
+        return { valid: false, error: 'Seed is required' };
+    }
+    try {
+        const decoded = fromBase58(seed);
+        if (decoded.length !== AMADEUS_SEED_BYTE_LENGTH) {
+            return {
+                valid: false,
+                error: `Invalid seed length: expected ${AMADEUS_SEED_BYTE_LENGTH} bytes, got ${decoded.length}`
+            };
+        }
+        return { valid: true };
+    }
+    catch {
+        return { valid: false, error: 'Invalid Base58 encoding' };
+    }
+}
+/**
+ * Check if a seed is valid (simple boolean version)
+ *
+ * @param seed - The seed to check
+ * @returns true if valid, false otherwise
+ */
+export function isValidSeed(seed) {
+    return validateSeed(seed).valid;
+}
+/**
+ * Validate a transfer amount
+ *
+ * @param amount - The amount as a string (user input)
+ * @returns Validation result with error message if invalid
+ */
+export function validateAmount(amount) {
+    if (!amount || typeof amount !== 'string') {
+        return { valid: false, error: 'Amount is required' };
+    }
+    // Check format: must be a valid number
+    if (!/^\d+(\.\d+)?$/.test(amount)) {
+        return { valid: false, error: 'Amount must be a valid number' };
+    }
+    // Check decimal places
+    const decimalPart = amount.split('.')[1];
+    if (decimalPart && decimalPart.length > AMA_TOKEN_DECIMALS) {
+        return {
+            valid: false,
+            error: `Amount cannot have more than ${AMA_TOKEN_DECIMALS} decimal places`
+        };
+    }
+    // Check value is positive
+    const num = Number.parseFloat(amount);
+    if (Number.isNaN(num) || num <= 0) {
+        return { valid: false, error: 'Amount must be greater than 0' };
+    }
+    // Check minimum transferable amount
+    if (num * AMA_TOKEN_DECIMALS_MULTIPLIER < 1) {
+        return {
+            valid: false,
+            error: `Amount is below the minimum transferable value (${MIN_TRANSFERABLE_AMOUNT})`
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Check if an amount is valid (simple boolean version)
+ *
+ * @param amount - The amount to check
+ * @returns true if valid, false otherwise
+ */
+export function isValidAmount(amount) {
+    return validateAmount(amount).valid;
+}
+/**
+ * Validate a password for wallet encryption
+ *
+ * @param password - The password to validate
+ * @param options - Validation options
+ * @returns Validation result with error message if invalid
+ */
+export function validatePassword(password, options = {}) {
+    const { minLength = 8, maxLength = 128, requireLowercase = true, requireUppercase = true, requireNumber = true, requireSpecial = true } = options;
+    if (!password || typeof password !== 'string') {
+        return { valid: false, error: 'Password is required' };
+    }
+    if (password.length < minLength) {
+        return { valid: false, error: `Password must be at least ${minLength} characters` };
+    }
+    if (password.length > maxLength) {
+        return { valid: false, error: `Password must be at most ${maxLength} characters` };
+    }
+    if (requireLowercase && !/[a-z]/.test(password)) {
+        return { valid: false, error: 'Password must contain at least one lowercase letter' };
+    }
+    if (requireUppercase && !/[A-Z]/.test(password)) {
+        return { valid: false, error: 'Password must contain at least one uppercase letter' };
+    }
+    if (requireNumber && !/[0-9]/.test(password)) {
+        return { valid: false, error: 'Password must contain at least one number' };
+    }
+    if (requireSpecial && !/[^a-zA-Z0-9]/.test(password)) {
+        return { valid: false, error: 'Password must contain at least one special character' };
+    }
+    return { valid: true };
+}
+/**
+ * Validate a token symbol
+ *
+ * @param symbol - The symbol to validate
+ * @returns Validation result with error message if invalid
+ */
+export function validateTokenSymbol(symbol) {
+    if (!symbol || typeof symbol !== 'string') {
+        return { valid: false, error: 'Token symbol is required' };
+    }
+    if (symbol.length < 1) {
+        return { valid: false, error: 'Token symbol is too short' };
+    }
+    if (symbol.length > 10) {
+        return { valid: false, error: 'Token symbol is too long' };
+    }
+    // Only allow alphanumeric characters
+    if (!/^[A-Z0-9]+$/.test(symbol)) {
+        return { valid: false, error: 'Token symbol must contain only uppercase letters and numbers' };
+    }
+    return { valid: true };
+}
 //# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAEzC;;GAEG;AACH,SAAS,eAAe,CAAC,KAAc;IACtC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,OAAO,CAAA;IACrB,CAAC;IACD,IACC,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,SAAS,IAAI,KAAK;QAClB,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAChC,CAAC;QACF,OAAO,KAAK,CAAC,OAAO,CAAA;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAI,MAAwB,EAAE,KAAc;IACnE,IAAI,CAAC;QACJ,OAAO,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAA;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,sDAAsD;QACtD,MAAM,IAAI,eAAe,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;IAClD,CAAC;AACF,CAAC"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@amadeus-protocol/sdk",
-	"version": "1.0.1",
+	"version": "1.0.3",
 	"description": "Official TypeScript/JavaScript SDK for Amadeus Protocol - Core utilities for serialization, cryptography, transaction building, and API client",
 	"repository": {
 		"type": "git",