@manifest-network/manifest-mcp-browser 0.1.1 → 0.1.6

package/dist/transactions/staking.js.map

@@ -1 +1 @@
-{"version":3,"file":"staking.js","sourceRoot":"","sources":["../../src/transactions/staking.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"staking.js","sourceRoot":"","sources":["../../src/transactions/staking.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1G,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;AAElF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAA6B,EAC7B,aAAqB,EACrB,UAAkB,EAClB,IAAc,EACd,mBAA4B;IAE5B,kBAAkB,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAEhD,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,mBAAmB,EAAE,QAAQ,CAAC,EAAE,kBAAkB,CAAC,CAAC;YAC1E,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;YAC3C,eAAe,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;YACvD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;YAEjD,MAAM,GAAG,GAAG;gBACV,OAAO,EAAE,qCAAqC;gBAC9C,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC;oBAC7B,gBAAgB,EAAE,aAAa;oBAC/B,gBAAgB;oBAChB,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;iBAC1B,CAAC;aACH,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YAC3E,OAAO,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC;QAC3E,CAAC;QAED,KAAK,QAAQ,CAAC;QACd,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,mBAAmB,EAAE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,CAAC;YACxE,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;YAC3C,eAAe,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;YACvD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;YAEjD,MAAM,GAAG,GAAG;gBACV,OAAO,EAAE,uCAAuC;gBAChD,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC;oBAC/B,gBAAgB,EAAE,aAAa;oBAC/B,gBAAgB;oBAChB,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;iBAC1B,CAAC;aACH,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YAC3E,OAAO,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC;QACzE,CAAC;QAED,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,oBAAoB,CAAC,CAAC;YACzF,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;YACnE,eAAe,CAAC,mBAAmB,EAAE,0BAA0B,CAAC,CAAC;YACjE,eAAe,CAAC,mBAAmB,EAAE,+BAA+B,CAAC,CAAC;YACtE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;YAEjD,MAAM,GAAG,GAAG;gBACV,OAAO,EAAE,4CAA4C;gBACrD,KAAK,EAAE,kBAAkB,CAAC,WAAW,CAAC;oBACpC,gBAAgB,EAAE,aAAa;oBAC/B,mBAAmB,EAAE,mBAAmB;oBACxC,mBAAmB,EAAE,mBAAmB;oBACxC,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;iBAC1B,CAAC;aACH,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YAC3E,OAAO,aAAa,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC;QAC7E,CAAC;QAED;YACE,0BAA0B,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/transactions/utils.d.ts

@@ -2,12 +2,60 @@ import { SigningStargateClient } from '@cosmjs/stargate';
 import { ManifestMCPErrorCode, CosmosTxResult } from '../types.js';
 /** Maximum number of arguments allowed */
 export declare const MAX_ARGS = 100;
+/** Maximum meta hash length in bytes (64 bytes for SHA-512) */
+export declare const MAX_META_HASH_BYTES = 64;
+/**
+ * Result from extracting a flag from args
+ */
+export interface ExtractedFlag {
+    /** The flag value, or undefined if flag not present */
+    value: string | undefined;
+    /** Indices consumed by the flag and its value (for filtering) */
+    consumedIndices: number[];
+}
+/**
+ * Extract a flag value from args array.
+ * Returns { value, consumedIndices } or { value: undefined, consumedIndices: [] } if flag not present.
+ * Throws if flag is present but value is missing or looks like another flag.
+ *
+ * @param args - The arguments array to search
+ * @param flagName - The flag to look for (e.g., '--memo')
+ * @param context - Description for error messages (e.g., 'bank send')
+ */
+export declare function extractFlag(args: string[], flagName: string, context: string): ExtractedFlag;
+/**
+ * Filter args to remove consumed flag indices
+ */
+export declare function filterConsumedArgs(args: string[], consumedIndices: number[]): string[];
 /** Maximum memo length (Cosmos SDK default) */
 export declare const MAX_MEMO_LENGTH = 256;
 /**
- * Validate args array length
+ * Parse a colon-separated pair (e.g., "address:amount", "sku:quantity").
+ * Throws with helpful error if format is invalid.
+ *
+ * @param input - The string to parse (e.g., "manifest1abc:1000umfx")
+ * @param leftName - Name of the left value for error messages (e.g., "address")
+ * @param rightName - Name of the right value for error messages (e.g., "amount")
+ * @param context - Context for error messages (e.g., "multi-send pair")
+ * @returns Tuple of [left, right] values
+ */
+export declare function parseColonPair(input: string, leftName: string, rightName: string, context: string): [string, string];
+/**
+ * Validate args array length (max limit)
  */
 export declare function validateArgsLength(args: string[], context: string): void;
+/**
+ * Validate that required arguments are present.
+ * Provides helpful error messages with received vs expected args.
+ *
+ * @param args - The arguments array to validate
+ * @param minCount - Minimum number of required arguments
+ * @param expectedNames - Names of expected arguments for error messages
+ * @param context - Context for error messages (e.g., 'bank send', 'staking delegate')
+ * @param errorCode - Error code to use (defaults to TX_FAILED)
+ * @throws ManifestMCPError if args.length < minCount
+ */
+export declare function requireArgs(args: string[], minCount: number, expectedNames: string[], context: string, errorCode?: ManifestMCPErrorCode): void;
 /**
  * Validate a bech32 address using @cosmjs/encoding
  */
@@ -16,6 +64,22 @@ export declare function validateAddress(address: string, fieldName: string, expe
  * Validate memo length
  */
 export declare function validateMemo(memo: string): void;
+/**
+ * Parse and validate a hex string into Uint8Array.
+ * Uses @cosmjs/encoding for browser compatibility.
+ *
+ * @param hexString - The hex string to parse
+ * @param fieldName - Name of the field for error messages
+ * @param maxBytes - Maximum allowed byte length
+ * @param errorCode - Error code to use (defaults to TX_FAILED)
+ * @returns Uint8Array of the parsed bytes
+ */
+export declare function parseHexBytes(hexString: string, fieldName: string, maxBytes: number, errorCode?: ManifestMCPErrorCode): Uint8Array;
+/**
+ * Convert Uint8Array to hex string.
+ * Uses @cosmjs/encoding for browser compatibility.
+ */
+export declare function bytesToHex(bytes: Uint8Array): string;
 /**
  * Safely parse a string to BigInt with proper error handling and configurable error code.
  * This is the base implementation used by both transaction and query utilities.

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/transactions/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAoB,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAErF,0CAA0C;AAC1C,eAAO,MAAM,QAAQ,MAAM,CAAC;AAE5B,+CAA+C;AAC/C,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAOxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAyBjG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO/C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,oBAAoB,GAC9B,MAAM,CAiBR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyBhF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC,CAAC,EACtE,mBAAmB,EAAE,OAAO,GAC3B,cAAc,CAkBhB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/transactions/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAoB,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAErF,0CAA0C;AAC1C,eAAO,MAAM,QAAQ,MAAM,CAAC;AAE5B,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,iEAAiE;IACjE,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,aAAa,CAef;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAMtF;AAED,+CAA+C;AAC/C,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBlB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAOxE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EAAE,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,oBAAqD,GAC/D,IAAI,CAoBN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAyBjG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,oBAAqD,GAC/D,UAAU,CAmCZ;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,oBAAoB,GAC9B,MAAM,CAiBR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyBhF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC,CAAC,EACtE,mBAAmB,EAAE,OAAO,GAC3B,cAAc,CAmBhB"}

package/dist/transactions/utils.js

@@ -1,17 +1,98 @@
-import { fromBech32 } from '@cosmjs/encoding';
+import { fromBech32, fromHex, toHex } from '@cosmjs/encoding';
 import { ManifestMCPError, ManifestMCPErrorCode } from '../types.js';
 /** Maximum number of arguments allowed */
 export const MAX_ARGS = 100;
+/** Maximum meta hash length in bytes (64 bytes for SHA-512) */
+export const MAX_META_HASH_BYTES = 64;
+/**
+ * Extract a flag value from args array.
+ * Returns { value, consumedIndices } or { value: undefined, consumedIndices: [] } if flag not present.
+ * Throws if flag is present but value is missing or looks like another flag.
+ *
+ * @param args - The arguments array to search
+ * @param flagName - The flag to look for (e.g., '--memo')
+ * @param context - Description for error messages (e.g., 'bank send')
+ */
+export function extractFlag(args, flagName, context) {
+    const flagIndex = args.indexOf(flagName);
+    if (flagIndex === -1) {
+        return { value: undefined, consumedIndices: [] };
+    }
+    const value = args[flagIndex + 1];
+    if (!value || value.startsWith('--')) {
+        throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `${flagName} flag requires a value in ${context}`);
+    }
+    return { value, consumedIndices: [flagIndex, flagIndex + 1] };
+}
+/**
+ * Filter args to remove consumed flag indices
+ */
+export function filterConsumedArgs(args, consumedIndices) {
+    if (consumedIndices.length === 0) {
+        return args;
+    }
+    const consumedSet = new Set(consumedIndices);
+    return args.filter((_, index) => !consumedSet.has(index));
+}
 /** Maximum memo length (Cosmos SDK default) */
 export const MAX_MEMO_LENGTH = 256;
 /**
- * Validate args array length
+ * Parse a colon-separated pair (e.g., "address:amount", "sku:quantity").
+ * Throws with helpful error if format is invalid.
+ *
+ * @param input - The string to parse (e.g., "manifest1abc:1000umfx")
+ * @param leftName - Name of the left value for error messages (e.g., "address")
+ * @param rightName - Name of the right value for error messages (e.g., "amount")
+ * @param context - Context for error messages (e.g., "multi-send pair")
+ * @returns Tuple of [left, right] values
+ */
+export function parseColonPair(input, leftName, rightName, context) {
+    const colonIndex = input.indexOf(':');
+    if (colonIndex === -1) {
+        throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Invalid ${context} format: "${input}". Missing colon separator. Expected format: ${leftName}:${rightName}`);
+    }
+    if (colonIndex === 0) {
+        throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Invalid ${context} format: "${input}". Missing ${leftName}. Expected format: ${leftName}:${rightName}`);
+    }
+    if (colonIndex === input.length - 1) {
+        throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Invalid ${context} format: "${input}". Missing ${rightName}. Expected format: ${leftName}:${rightName}`);
+    }
+    return [input.slice(0, colonIndex), input.slice(colonIndex + 1)];
+}
+/**
+ * Validate args array length (max limit)
  */
 export function validateArgsLength(args, context) {
     if (args.length > MAX_ARGS) {
         throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Too many arguments for ${context}: ${args.length}. Maximum allowed: ${MAX_ARGS}`);
     }
 }
+/**
+ * Validate that required arguments are present.
+ * Provides helpful error messages with received vs expected args.
+ *
+ * @param args - The arguments array to validate
+ * @param minCount - Minimum number of required arguments
+ * @param expectedNames - Names of expected arguments for error messages
+ * @param context - Context for error messages (e.g., 'bank send', 'staking delegate')
+ * @param errorCode - Error code to use (defaults to TX_FAILED)
+ * @throws ManifestMCPError if args.length < minCount
+ */
+export function requireArgs(args, minCount, expectedNames, context, errorCode = ManifestMCPErrorCode.TX_FAILED) {
+    if (args.length >= minCount) {
+        return;
+    }
+    const expectedList = expectedNames.slice(0, minCount).join(', ');
+    const receivedList = args.length === 0
+        ? 'none'
+        : args.map(a => `"${a}"`).join(', ');
+    throw new ManifestMCPError(errorCode, `${context} requires ${minCount} argument(s): ${expectedList}. Received ${args.length}: ${receivedList}`, {
+        expectedArgs: expectedNames.slice(0, minCount),
+        receivedArgs: args,
+        receivedCount: args.length,
+        requiredCount: minCount,
+    });
+}
 /**
  * Validate a bech32 address using @cosmjs/encoding
  */
@@ -40,6 +121,45 @@ export function validateMemo(memo) {
         throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Memo too long: ${memo.length} characters. Maximum allowed: ${MAX_MEMO_LENGTH}`);
     }
 }
+/**
+ * Parse and validate a hex string into Uint8Array.
+ * Uses @cosmjs/encoding for browser compatibility.
+ *
+ * @param hexString - The hex string to parse
+ * @param fieldName - Name of the field for error messages
+ * @param maxBytes - Maximum allowed byte length
+ * @param errorCode - Error code to use (defaults to TX_FAILED)
+ * @returns Uint8Array of the parsed bytes
+ */
+export function parseHexBytes(hexString, fieldName, maxBytes, errorCode = ManifestMCPErrorCode.TX_FAILED) {
+    // Check for empty string
+    if (!hexString || hexString.trim() === '') {
+        throw new ManifestMCPError(errorCode, `Invalid ${fieldName}: empty value. Expected a hex string.`);
+    }
+    // Check even length (each byte is 2 hex chars)
+    if (hexString.length % 2 !== 0) {
+        throw new ManifestMCPError(errorCode, `Invalid ${fieldName}: hex string must have even length. Got ${hexString.length} characters.`);
+    }
+    // Check max length
+    const byteLength = hexString.length / 2;
+    if (byteLength > maxBytes) {
+        throw new ManifestMCPError(errorCode, `Invalid ${fieldName}: exceeds maximum ${maxBytes} bytes. Got ${byteLength} bytes (${hexString.length} hex chars).`);
+    }
+    // Use @cosmjs/encoding for browser-compatible hex parsing
+    try {
+        return fromHex(hexString);
+    }
+    catch (error) {
+        throw new ManifestMCPError(errorCode, `Invalid ${fieldName}: "${hexString}". Must contain only hexadecimal characters (0-9, a-f, A-F).`);
+    }
+}
+/**
+ * Convert Uint8Array to hex string.
+ * Uses @cosmjs/encoding for browser compatibility.
+ */
+export function bytesToHex(bytes) {
+    return toHex(bytes);
+}
 /**
  * Safely parse a string to BigInt with proper error handling and configurable error code.
  * This is the base implementation used by both transaction and query utilities.
@@ -104,6 +224,7 @@ export function buildTxResult(module, subcommand, result, waitForConfirmation) {
         rawLog: result.rawLog || undefined,
         gasUsed: String(result.gasUsed),
         gasWanted: String(result.gasWanted),
+        events: result.events,
     };
     if (waitForConfirmation) {
         txResult.confirmed = result.code === 0;

package/dist/transactions/utils.js.map

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

package/dist/transactions/utils.test.js

@@ -1,5 +1,6 @@
 import { describe, it, expect } from 'vitest';
-import { parseAmount, parseBigInt } from './utils.js';
+import { toBech32 } from '@cosmjs/encoding';
+import { parseAmount, parseBigInt, extractFlag, filterConsumedArgs, parseColonPair, validateAddress, validateMemo, validateArgsLength, requireArgs, parseHexBytes, bytesToHex } from './utils.js';
 import { ManifestMCPError, ManifestMCPErrorCode } from '../types.js';
 describe('parseAmount', () => {
     it('should parse valid amount strings', () => {
@@ -118,4 +119,353 @@ describe('parseBigInt', () => {
         }
     });
 });
+describe('extractFlag', () => {
+    it('should extract flag value when present', () => {
+        const result = extractFlag(['--memo', 'hello'], '--memo', 'test');
+        expect(result.value).toBe('hello');
+        expect(result.consumedIndices).toEqual([0, 1]);
+    });
+    it('should return undefined when flag not present', () => {
+        const result = extractFlag(['arg1', 'arg2'], '--memo', 'test');
+        expect(result.value).toBeUndefined();
+        expect(result.consumedIndices).toEqual([]);
+    });
+    it('should handle flag in middle of args', () => {
+        const result = extractFlag(['arg1', '--memo', 'hello', 'arg2'], '--memo', 'test');
+        expect(result.value).toBe('hello');
+        expect(result.consumedIndices).toEqual([1, 2]);
+    });
+    it('should throw when flag has no value', () => {
+        expect(() => extractFlag(['--memo'], '--memo', 'test')).toThrow(ManifestMCPError);
+    });
+    it('should throw when flag value looks like another flag', () => {
+        expect(() => extractFlag(['--memo', '--other'], '--memo', 'test')).toThrow(ManifestMCPError);
+    });
+    it('should include context in error message', () => {
+        try {
+            extractFlag(['--memo'], '--memo', 'bank send');
+        }
+        catch (error) {
+            expect(error.message).toContain('bank send');
+            expect(error.message).toContain('--memo');
+        }
+    });
+});
+describe('filterConsumedArgs', () => {
+    it('should filter out consumed indices', () => {
+        const result = filterConsumedArgs(['a', 'b', 'c', 'd'], [1, 2]);
+        expect(result).toEqual(['a', 'd']);
+    });
+    it('should return original array when no indices consumed', () => {
+        const result = filterConsumedArgs(['a', 'b', 'c'], []);
+        expect(result).toEqual(['a', 'b', 'c']);
+    });
+    it('should handle all indices consumed', () => {
+        const result = filterConsumedArgs(['a', 'b'], [0, 1]);
+        expect(result).toEqual([]);
+    });
+    it('should handle non-contiguous indices', () => {
+        const result = filterConsumedArgs(['a', 'b', 'c', 'd', 'e'], [0, 2, 4]);
+        expect(result).toEqual(['b', 'd']);
+    });
+});
+describe('parseColonPair', () => {
+    it('should parse valid colon-separated pairs', () => {
+        expect(parseColonPair('address:amount', 'address', 'amount', 'test')).toEqual(['address', 'amount']);
+        expect(parseColonPair('key:value', 'key', 'value', 'test')).toEqual(['key', 'value']);
+    });
+    it('should handle values with colons (takes first colon as separator)', () => {
+        const result = parseColonPair('address:100:extra', 'address', 'amount', 'test');
+        expect(result).toEqual(['address', '100:extra']);
+    });
+    it('should throw for missing colon', () => {
+        expect(() => parseColonPair('nodelimiter', 'left', 'right', 'test')).toThrow(ManifestMCPError);
+    });
+    it('should throw for empty left side', () => {
+        expect(() => parseColonPair(':value', 'left', 'right', 'test')).toThrow(ManifestMCPError);
+    });
+    it('should throw for empty right side', () => {
+        expect(() => parseColonPair('key:', 'left', 'right', 'test')).toThrow(ManifestMCPError);
+    });
+    it('should include context and field names in error messages', () => {
+        try {
+            parseColonPair('invalid', 'address', 'amount', 'multi-send');
+        }
+        catch (error) {
+            const message = error.message;
+            expect(message).toContain('multi-send');
+            expect(message).toContain('address');
+            expect(message).toContain('amount');
+        }
+    });
+    it('should provide specific error for missing left value', () => {
+        try {
+            parseColonPair(':value', 'address', 'amount', 'test');
+        }
+        catch (error) {
+            expect(error.message).toContain('Missing address');
+        }
+    });
+    it('should provide specific error for missing right value', () => {
+        try {
+            parseColonPair('key:', 'address', 'amount', 'test');
+        }
+        catch (error) {
+            expect(error.message).toContain('Missing amount');
+        }
+    });
+});
+describe('validateAddress', () => {
+    // Generate valid bech32 addresses programmatically using @cosmjs/encoding
+    // 20 bytes is the standard Cosmos address length
+    const validManifestAddress = toBech32('manifest', new Uint8Array(20));
+    const validCosmosAddress = toBech32('cosmos', new Uint8Array(20));
+    it('should accept valid bech32 addresses', () => {
+        expect(() => validateAddress(validManifestAddress, 'test')).not.toThrow();
+        expect(() => validateAddress(validCosmosAddress, 'test')).not.toThrow();
+    });
+    it('should throw for empty address', () => {
+        expect(() => validateAddress('', 'recipient')).toThrow(ManifestMCPError);
+        expect(() => validateAddress('   ', 'recipient')).toThrow(ManifestMCPError);
+    });
+    it('should throw for invalid bech32 address', () => {
+        expect(() => validateAddress('notanaddress', 'recipient')).toThrow(ManifestMCPError);
+        expect(() => validateAddress('manifest1invalid', 'recipient')).toThrow(ManifestMCPError);
+    });
+    it('should use INVALID_ADDRESS error code', () => {
+        try {
+            validateAddress('invalid', 'recipient');
+        }
+        catch (error) {
+            expect(error.code).toBe(ManifestMCPErrorCode.INVALID_ADDRESS);
+        }
+    });
+    it('should include field name in error message', () => {
+        try {
+            validateAddress('invalid', 'validator address');
+        }
+        catch (error) {
+            expect(error.message).toContain('validator address');
+        }
+    });
+    it('should validate expected prefix when provided', () => {
+        // Should pass when prefix matches
+        expect(() => validateAddress(validManifestAddress, 'test', 'manifest')).not.toThrow();
+        // Should fail when prefix doesn't match
+        expect(() => validateAddress(validManifestAddress, 'test', 'cosmos')).toThrow(ManifestMCPError);
+    });
+    it('should include expected prefix in error message', () => {
+        try {
+            validateAddress(validManifestAddress, 'recipient', 'cosmos');
+        }
+        catch (error) {
+            const message = error.message;
+            expect(message).toContain('cosmos');
+            expect(message).toContain('manifest');
+        }
+    });
+});
+describe('validateMemo', () => {
+    it('should accept memo within limit', () => {
+        expect(() => validateMemo('')).not.toThrow();
+        expect(() => validateMemo('short memo')).not.toThrow();
+        expect(() => validateMemo('a'.repeat(256))).not.toThrow();
+    });
+    it('should throw for memo exceeding 256 characters', () => {
+        expect(() => validateMemo('a'.repeat(257))).toThrow(ManifestMCPError);
+        expect(() => validateMemo('a'.repeat(500))).toThrow(ManifestMCPError);
+    });
+    it('should use TX_FAILED error code', () => {
+        try {
+            validateMemo('a'.repeat(300));
+        }
+        catch (error) {
+            expect(error.code).toBe(ManifestMCPErrorCode.TX_FAILED);
+        }
+    });
+    it('should include length info in error message', () => {
+        try {
+            validateMemo('a'.repeat(300));
+        }
+        catch (error) {
+            const message = error.message;
+            expect(message).toContain('300');
+            expect(message).toContain('256');
+        }
+    });
+});
+describe('validateArgsLength', () => {
+    it('should accept args within limit', () => {
+        expect(() => validateArgsLength([], 'test')).not.toThrow();
+        expect(() => validateArgsLength(['a', 'b', 'c'], 'test')).not.toThrow();
+        expect(() => validateArgsLength(new Array(100).fill('arg'), 'test')).not.toThrow();
+    });
+    it('should throw for args exceeding 100 items', () => {
+        expect(() => validateArgsLength(new Array(101).fill('arg'), 'test')).toThrow(ManifestMCPError);
+        expect(() => validateArgsLength(new Array(200).fill('arg'), 'test')).toThrow(ManifestMCPError);
+    });
+    it('should use TX_FAILED error code', () => {
+        try {
+            validateArgsLength(new Array(150).fill('arg'), 'test');
+        }
+        catch (error) {
+            expect(error.code).toBe(ManifestMCPErrorCode.TX_FAILED);
+        }
+    });
+    it('should include context and count in error message', () => {
+        try {
+            validateArgsLength(new Array(150).fill('arg'), 'bank send');
+        }
+        catch (error) {
+            const message = error.message;
+            expect(message).toContain('bank send');
+            expect(message).toContain('150');
+            expect(message).toContain('100');
+        }
+    });
+});
+describe('requireArgs', () => {
+    it('should pass when args meet minimum count', () => {
+        expect(() => requireArgs(['a', 'b'], 2, ['arg1', 'arg2'], 'test')).not.toThrow();
+        expect(() => requireArgs(['a', 'b', 'c'], 2, ['arg1', 'arg2'], 'test')).not.toThrow();
+    });
+    it('should pass when zero args required', () => {
+        expect(() => requireArgs([], 0, [], 'test')).not.toThrow();
+    });
+    it('should throw when args below minimum count', () => {
+        expect(() => requireArgs(['a'], 2, ['arg1', 'arg2'], 'test')).toThrow(ManifestMCPError);
+        expect(() => requireArgs([], 1, ['arg1'], 'test')).toThrow(ManifestMCPError);
+    });
+    it('should use TX_FAILED error code by default', () => {
+        try {
+            requireArgs([], 1, ['arg1'], 'test');
+        }
+        catch (error) {
+            expect(error.code).toBe(ManifestMCPErrorCode.TX_FAILED);
+        }
+    });
+    it('should include context in error message', () => {
+        try {
+            requireArgs(['a'], 2, ['recipient', 'amount'], 'bank send');
+        }
+        catch (error) {
+            const message = error.message;
+            expect(message).toContain('bank send');
+            expect(message).toContain('recipient');
+            expect(message).toContain('amount');
+        }
+    });
+    it('should include received args in error message', () => {
+        try {
+            requireArgs(['value1'], 2, ['arg1', 'arg2'], 'test');
+        }
+        catch (error) {
+            const message = error.message;
+            expect(message).toContain('"value1"');
+            expect(message).toContain('Received 1');
+        }
+    });
+    it('should show "none" when no args received', () => {
+        try {
+            requireArgs([], 1, ['arg1'], 'test');
+        }
+        catch (error) {
+            const message = error.message;
+            expect(message).toContain('none');
+        }
+    });
+    it('should include details with expected and received args', () => {
+        try {
+            requireArgs(['a'], 2, ['arg1', 'arg2'], 'test');
+        }
+        catch (error) {
+            const details = error.details;
+            expect(details?.expectedArgs).toEqual(['arg1', 'arg2']);
+            expect(details?.receivedArgs).toEqual(['a']);
+            expect(details?.receivedCount).toBe(1);
+            expect(details?.requiredCount).toBe(2);
+        }
+    });
+    it('should accept custom error code', () => {
+        try {
+            requireArgs([], 1, ['arg1'], 'test', ManifestMCPErrorCode.QUERY_FAILED);
+        }
+        catch (error) {
+            expect(error.code).toBe(ManifestMCPErrorCode.QUERY_FAILED);
+        }
+    });
+});
+describe('parseHexBytes', () => {
+    it('should parse valid hex strings', () => {
+        expect(parseHexBytes('deadbeef', 'test', 100)).toEqual(new Uint8Array([0xde, 0xad, 0xbe, 0xef]));
+        expect(parseHexBytes('00', 'test', 100)).toEqual(new Uint8Array([0x00]));
+        expect(parseHexBytes('ff', 'test', 100)).toEqual(new Uint8Array([0xff]));
+        expect(parseHexBytes('0123456789abcdef', 'test', 100)).toEqual(new Uint8Array([0x01, 0x23, 0x45, 0x67, 0x89, 0xab, 0xcd, 0xef]));
+    });
+    it('should be case-insensitive', () => {
+        expect(parseHexBytes('DEADBEEF', 'test', 100)).toEqual(new Uint8Array([0xde, 0xad, 0xbe, 0xef]));
+        expect(parseHexBytes('DeAdBeEf', 'test', 100)).toEqual(new Uint8Array([0xde, 0xad, 0xbe, 0xef]));
+    });
+    it('should throw for empty string', () => {
+        expect(() => parseHexBytes('', 'field', 100)).toThrow(ManifestMCPError);
+        expect(() => parseHexBytes('   ', 'field', 100)).toThrow(ManifestMCPError);
+    });
+    it('should throw for odd-length hex strings', () => {
+        expect(() => parseHexBytes('abc', 'field', 100)).toThrow(ManifestMCPError);
+        expect(() => parseHexBytes('1', 'field', 100)).toThrow(ManifestMCPError);
+        expect(() => parseHexBytes('12345', 'field', 100)).toThrow(ManifestMCPError);
+    });
+    it('should throw for exceeding max bytes', () => {
+        expect(() => parseHexBytes('deadbeef', 'field', 2)).toThrow(ManifestMCPError);
+        expect(() => parseHexBytes('0102030405', 'field', 2)).toThrow(ManifestMCPError);
+    });
+    it('should accept exactly max bytes', () => {
+        expect(parseHexBytes('deadbeef', 'test', 4)).toEqual(new Uint8Array([0xde, 0xad, 0xbe, 0xef]));
+    });
+    it('should throw for invalid hex characters', () => {
+        expect(() => parseHexBytes('ghij', 'field', 100)).toThrow(ManifestMCPError);
+        expect(() => parseHexBytes('12gg', 'field', 100)).toThrow(ManifestMCPError);
+        expect(() => parseHexBytes('xy00', 'field', 100)).toThrow(ManifestMCPError);
+    });
+    it('should use TX_FAILED error code by default', () => {
+        try {
+            parseHexBytes('', 'field', 100);
+        }
+        catch (error) {
+            expect(error.code).toBe(ManifestMCPErrorCode.TX_FAILED);
+        }
+    });
+    it('should accept custom error code', () => {
+        try {
+            parseHexBytes('', 'field', 100, ManifestMCPErrorCode.QUERY_FAILED);
+        }
+        catch (error) {
+            expect(error.code).toBe(ManifestMCPErrorCode.QUERY_FAILED);
+        }
+    });
+    it('should include field name in error message', () => {
+        try {
+            parseHexBytes('', 'my-custom-field', 100);
+        }
+        catch (error) {
+            expect(error.message).toContain('my-custom-field');
+        }
+    });
+});
+describe('bytesToHex', () => {
+    it('should convert bytes to hex string', () => {
+        expect(bytesToHex(new Uint8Array([0xde, 0xad, 0xbe, 0xef]))).toBe('deadbeef');
+        expect(bytesToHex(new Uint8Array([0x00]))).toBe('00');
+        expect(bytesToHex(new Uint8Array([0xff]))).toBe('ff');
+        expect(bytesToHex(new Uint8Array([0x01, 0x23, 0x45, 0x67, 0x89, 0xab, 0xcd, 0xef]))).toBe('0123456789abcdef');
+    });
+    it('should handle empty array', () => {
+        expect(bytesToHex(new Uint8Array([]))).toBe('');
+    });
+    it('should round-trip with parseHexBytes', () => {
+        const original = 'deadbeefcafe1234';
+        const bytes = parseHexBytes(original, 'test', 100);
+        expect(bytesToHex(bytes)).toBe(original);
+    });
+});
 //# sourceMappingURL=utils.test.js.map