@openzeppelin/ui-builder-adapter-stellar 0.15.0 → 0.16.0

package/dist/index.cjs

@@ -44,7 +44,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/adapter.ts
-var import_ui_builder_types6 = require("@openzeppelin/ui-builder-types");
+var import_ui_builder_types7 = require("@openzeppelin/ui-builder-types");
 var import_ui_builder_utils38 = require("@openzeppelin/ui-builder-utils");
 
 // src/configuration/rpc.ts
@@ -479,10 +479,17 @@ function extractStructFields(entries, structName) {
       for (const field of fields) {
         const fieldName = field.name().toString();
         const fieldType = extractSorobanTypeFromScSpec(field.type());
-        structFields.push({
+        const fieldParam = {
           name: fieldName,
           type: fieldType
-        });
+        };
+        if (isStructType(entries, fieldType)) {
+          const nestedFields = extractStructFields(entries, fieldType);
+          if (nestedFields && nestedFields.length > 0) {
+            fieldParam.components = nestedFields;
+          }
+        }
+        structFields.push(fieldParam);
       }
       return structFields;
     }
@@ -523,7 +530,7 @@ var import_stellar_sdk9 = require("@stellar/stellar-sdk");
 var import_ui_builder_utils12 = require("@openzeppelin/ui-builder-utils");
 
 // src/transform/parsers/index.ts
-var import_ui_builder_types3 = require("@openzeppelin/ui-builder-types");
+var import_ui_builder_types4 = require("@openzeppelin/ui-builder-types");
 var import_ui_builder_utils10 = require("@openzeppelin/ui-builder-utils");
 
 // src/transform/parsers/generic-parser.ts
@@ -766,6 +773,20 @@ function extractOptionElementType(parameterType) {
   }
   return extractGenericInnerType(parameterType, "Option");
 }
+function extractTupleTypes(parameterType) {
+  if (!isValidTypeString(parameterType) || !parameterType.startsWith("Tuple<")) {
+    return null;
+  }
+  const innerContent = extractGenericInnerType(parameterType, "Tuple");
+  if (!innerContent) {
+    return null;
+  }
+  const parts = splitTopLevelTypes(innerContent);
+  if (parts.length === 0) {
+    return null;
+  }
+  return parts;
+}
 function extractGenericInnerType(parameterType, genericName) {
   const prefix = `${genericName}<`;
   if (!parameterType.startsWith(prefix) || !parameterType.endsWith(">")) {
@@ -839,6 +860,30 @@ function hasInvalidCharacters(str) {
   }
   return !/^[A-Za-z0-9<>,\s_]+$/.test(str);
 }
+function splitTopLevelTypes(content) {
+  const types = [];
+  let start = 0;
+  let level = 0;
+  for (let i = 0; i < content.length; i += 1) {
+    const char = content[i];
+    if (char === "<") {
+      level += 1;
+    } else if (char === ">") {
+      level -= 1;
+    } else if (char === "," && level === 0) {
+      const segment = content.slice(start, i).trim();
+      if (segment) {
+        types.push(segment);
+      }
+      start = i + 1;
+    }
+  }
+  const lastSegment = content.slice(start).trim();
+  if (lastSegment) {
+    types.push(lastSegment);
+  }
+  return types;
+}
 
 // src/utils/formatting.ts
 function stringifyWithBigInt(value, space) {
@@ -913,6 +958,34 @@ function convertStellarTypeToScValType(stellarType) {
 // src/utils/input-parsing.ts
 var import_stellar_sdk4 = require("@stellar/stellar-sdk");
 var import_ui_builder_utils7 = require("@openzeppelin/ui-builder-utils");
+
+// src/utils/xdr-ordering.ts
+function compareScValsByXdr(a, b) {
+  const aBytes = getBytes(a);
+  const bBytes = getBytes(b);
+  const minLength = Math.min(aBytes.length, bBytes.length);
+  for (let index = 0; index < minLength; index += 1) {
+    const diff = aBytes[index] - bBytes[index];
+    if (diff !== 0) {
+      return diff;
+    }
+  }
+  return aBytes.length - bBytes.length;
+}
+function getBytes(scVal) {
+  const xdrValue = scVal.toXDR();
+  if (xdrValue instanceof Uint8Array) {
+    return xdrValue;
+  }
+  const arrayLike = xdrValue;
+  const result = new Uint8Array(arrayLike.length);
+  for (let index = 0; index < arrayLike.length; index += 1) {
+    result[index] = arrayLike[index];
+  }
+  return result;
+}
+
+// src/utils/input-parsing.ts
 var SYSTEM_LOG_TAG4 = "StellarInputParsingUtils";
 function isMapArray(argValue) {
   try {
@@ -996,19 +1069,34 @@ function convertEnumToScVal(obj, scVals) {
 }
 function convertObjectToMap(mapArray) {
   try {
-    const mapVal = mapArray.reduce((acc, pair) => {
-      const key = pair["0"].value;
+    const sortedEntries = [...mapArray].sort((a, b) => {
+      const aKey = getScValFromPrimitive(a["0"]);
+      const bKey = getScValFromPrimitive(b["0"]);
+      return compareScValsByXdr(aKey, bKey);
+    });
+    const mapVal = sortedEntries.reduce((acc, pair) => {
+      const key = String(pair["0"].value);
       if (Array.isArray(pair["1"])) {
         const valueScVal = getScValFromArg(pair["1"], []);
         acc[key] = valueScVal;
       } else {
         const value = pair["1"].value;
-        acc[key] = pair["1"].type === "bool" ? value === "true" : value;
+        if (pair["1"].type === "bool") {
+          if (typeof value === "boolean") {
+            acc[key] = value;
+          } else if (typeof value === "string") {
+            acc[key] = value === "true";
+          } else {
+            acc[key] = Boolean(value);
+          }
+        } else {
+          acc[key] = value;
+        }
       }
       return acc;
     }, {});
-    const mapType = mapArray.reduce((acc, pair) => {
-      const key = pair["0"].value;
+    const mapType = sortedEntries.reduce((acc, pair) => {
+      const key = String(pair["0"].value);
       const keyTypeHint = convertStellarTypeToScValType(pair["0"].type);
       const valueTypeHint = convertStellarTypeToScValType(pair["1"].type);
       acc[key] = [
@@ -1026,12 +1114,43 @@ function convertObjectToMap(mapArray) {
 
 // src/transform/parsers/scval-converter.ts
 var import_stellar_sdk7 = require("@stellar/stellar-sdk");
-var import_ui_builder_types2 = require("@openzeppelin/ui-builder-types");
+var import_ui_builder_types3 = require("@openzeppelin/ui-builder-types");
+
+// src/utils/stellar-types.ts
+var PRIMITIVE_STELLAR_TYPES = /* @__PURE__ */ new Set([
+  "Bool",
+  "ScString",
+  "ScSymbol",
+  "Address",
+  "Bytes",
+  "U8",
+  "U16",
+  "U32",
+  "U64",
+  "U128",
+  "U256",
+  "I8",
+  "I16",
+  "I32",
+  "I64",
+  "I128",
+  "I256"
+]);
+function isPrimitiveParamType(type) {
+  return PRIMITIVE_STELLAR_TYPES.has(type);
+}
 
 // src/transform/parsers/struct-parser.ts
 var import_stellar_sdk6 = require("@stellar/stellar-sdk");
+var import_ui_builder_types2 = require("@openzeppelin/ui-builder-types");
 var import_ui_builder_utils9 = require("@openzeppelin/ui-builder-utils");
 var SYSTEM_LOG_TAG5 = "StructParser";
+function isTupleStructSchema(schema) {
+  if (!schema?.components || schema.components.length === 0) {
+    return false;
+  }
+  return schema.components.every((component, index) => component.name === index.toString());
+}
 function needsParsing(value, fieldType) {
   if ((fieldType === "Bytes" || fieldType.startsWith("BytesN<")) && value instanceof Uint8Array) {
     return false;
@@ -1056,7 +1175,23 @@ function needsParsing(value, fieldType) {
   }
   return false;
 }
-function convertStructToScVal(structObj, parameterType, paramSchema, parseInnerValue) {
+function convertStructToScVal(structObj, parameterType, paramSchema, parseInnerValue, convertToScVal) {
+  if (isTupleStructSchema(paramSchema) && paramSchema && convertToScVal) {
+    const tupleValues = paramSchema.components.map((component, index) => {
+      const key = component.name ?? index.toString();
+      let elementValue = structObj[key];
+      if (typeof elementValue === "undefined") {
+        throw new Error(
+          `Missing tuple value for "${key}" in struct type "${parameterType}". Received: ${JSON.stringify(structObj)}`
+        );
+      }
+      if (typeof elementValue === "string" && isLikelyEnumType(component.type)) {
+        elementValue = { tag: elementValue };
+      }
+      return convertToScVal(elementValue, component.type, component, parseInnerValue);
+    });
+    return import_stellar_sdk6.xdr.ScVal.scvVec(tupleValues);
+  }
   const convertedValue = {};
   const typeHints = {};
   for (const [fieldName, fieldValue] of Object.entries(structObj)) {
@@ -1074,6 +1209,9 @@ function convertStructToScVal(structObj, parameterType, paramSchema, parseInnerV
       } else {
         parsedValue = fieldValue;
       }
+      if (typeof parsedValue === "string" && isLikelyEnumType(fieldType)) {
+        parsedValue = { tag: parsedValue };
+      }
       if (fieldType.startsWith("Map<") && Array.isArray(parsedValue)) {
         const mapTypeMatch = fieldType.match(/Map<(.+),\s*(.+)>$/);
         const mapKeyType = mapTypeMatch ? mapTypeMatch[1] : "ScSymbol";
@@ -1095,10 +1233,21 @@ function convertStructToScVal(structObj, parameterType, paramSchema, parseInnerV
         convertedValue[fieldName] = mapObject;
         typeHints[fieldName] = ["symbol", mapTypeHints];
       } else {
-        convertedValue[fieldName] = parsedValue;
-        const scValType = convertStellarTypeToScValType(fieldType);
-        if (scValType !== "map-special") {
-          typeHints[fieldName] = ["symbol", Array.isArray(scValType) ? scValType[0] : scValType];
+        if (convertToScVal && (fieldType.startsWith("Vec<") || (0, import_ui_builder_types2.isEnumValue)(parsedValue))) {
+          const fieldSchema = paramSchema?.components?.find((c) => c.name === fieldName);
+          convertedValue[fieldName] = convertToScVal(
+            parsedValue,
+            fieldType,
+            fieldSchema,
+            parseInnerValue
+          );
+          typeHints[fieldName] = ["symbol", "scval"];
+        } else {
+          convertedValue[fieldName] = parsedValue;
+          const scValType = convertStellarTypeToScValType(fieldType);
+          if (scValType !== "map-special") {
+            typeHints[fieldName] = ["symbol", Array.isArray(scValType) ? scValType[0] : scValType];
+          }
         }
       }
     } else {
@@ -1112,7 +1261,40 @@ function convertStructToScVal(structObj, parameterType, paramSchema, parseInnerV
     convertedValue,
     typeHints
   });
-  const scVal = (0, import_stellar_sdk6.nativeToScVal)(convertedValue, { type: typeHints });
+  const hasEnumFields = paramSchema?.components?.some((comp) => {
+    const fieldValue = convertedValue[comp.name];
+    return (0, import_ui_builder_types2.isEnumValue)(fieldValue);
+  });
+  let scVal;
+  if (hasEnumFields && convertToScVal && paramSchema?.components) {
+    const mapEntries = [];
+    for (const fieldSchema of paramSchema.components) {
+      const fieldName = fieldSchema.name;
+      const fieldValue = convertedValue[fieldName];
+      const keyScVal = (0, import_stellar_sdk6.nativeToScVal)(fieldName, { type: "symbol" });
+      let valueScVal;
+      if ((0, import_ui_builder_types2.isEnumValue)(fieldValue)) {
+        valueScVal = convertToScVal(fieldValue, fieldSchema.type, fieldSchema, parseInnerValue);
+      } else {
+        const fieldTypeHint = typeHints[fieldName];
+        if (fieldTypeHint && Array.isArray(fieldTypeHint) && fieldTypeHint.length > 1) {
+          valueScVal = (0, import_stellar_sdk6.nativeToScVal)(fieldValue, { type: fieldTypeHint[1] });
+        } else {
+          valueScVal = (0, import_stellar_sdk6.nativeToScVal)(fieldValue);
+        }
+      }
+      mapEntries.push(
+        new import_stellar_sdk6.xdr.ScMapEntry({
+          key: keyScVal,
+          val: valueScVal
+        })
+      );
+    }
+    const sortedMapEntries = mapEntries.sort((a, b) => compareScValsByXdr(a.key(), b.key()));
+    scVal = import_stellar_sdk6.xdr.ScVal.scvMap(sortedMapEntries);
+  } else {
+    scVal = (0, import_stellar_sdk6.nativeToScVal)(convertedValue, { type: typeHints });
+  }
   import_ui_builder_utils9.logger.debug(SYSTEM_LOG_TAG5, "convertStructToScVal generated ScVal:", {
     parameterType,
     scValType: scVal.switch().name,
@@ -1139,16 +1321,95 @@ function isStructType2(value, parameterType) {
 function valueToScVal(value, parameterType, paramSchema, parseInnerValue) {
   const parseValue = parseInnerValue || ((val) => val);
   const genericInfo = parseGenericType(parameterType);
+  const isTypedWrapper = (v) => !!v && typeof v === "object" && "type" in v && "value" in v;
+  const enumMetadata = paramSchema?.enumMetadata;
+  const possibleEnumValue = typeof value === "string" && (enumMetadata || isLikelyEnumType(parameterType)) ? { tag: value } : value;
   if (!genericInfo) {
-    if ((0, import_ui_builder_types2.isEnumValue)(value) || typeof value === "object" && value !== null && "enum" in value) {
-      return convertEnumToScVal(value);
+    if (enumMetadata && enumMetadata.variants.every((v) => v.type === "integer")) {
+      let numericValue;
+      if (typeof value === "string") {
+        const byName = enumMetadata.variants.find((v) => v.name === value);
+        numericValue = byName?.value ?? Number(value);
+      } else if (typeof value === "number") {
+        numericValue = value;
+      } else if ((0, import_ui_builder_types3.isEnumValue)(value)) {
+        const byTag = enumMetadata.variants.find((v) => v.name === value.tag);
+        numericValue = byTag?.value;
+      }
+      if (numericValue === void 0 || Number.isNaN(numericValue)) {
+        const validNames = enumMetadata.variants.map((v) => v.name).join(", ");
+        throw new Error(
+          `Invalid integer enum value for ${parameterType}: ${String(value)}. Expected one of: ${validNames}`
+        );
+      }
+      return (0, import_stellar_sdk7.nativeToScVal)(numericValue, { type: "u32" });
+    }
+    if (isTypedWrapper(possibleEnumValue)) {
+      const wrapped = possibleEnumValue;
+      const parsed = parsePrimitive(wrapped.value, wrapped.type);
+      const finalVal = parsed !== null ? parsed : wrapped.value;
+      const scValType2 = convertStellarTypeToScValType(wrapped.type);
+      const typeHint2 = Array.isArray(scValType2) ? scValType2[0] : scValType2;
+      return (0, import_stellar_sdk7.nativeToScVal)(finalVal, { type: typeHint2 });
+    }
+    if ((0, import_ui_builder_types3.isEnumValue)(possibleEnumValue) || typeof possibleEnumValue === "object" && possibleEnumValue !== null && "enum" in possibleEnumValue) {
+      const enumValue = possibleEnumValue;
+      if ("enum" in enumValue && typeof enumValue.enum === "number") {
+        return (0, import_stellar_sdk7.nativeToScVal)(enumValue.enum, { type: "u32" });
+      }
+      const tagSymbol = (0, import_stellar_sdk7.nativeToScVal)(enumValue.tag, { type: "symbol" });
+      if (!enumValue.values || enumValue.values.length === 0) {
+        return import_stellar_sdk7.xdr.ScVal.scvVec([tagSymbol]);
+      }
+      const payloadValues = enumValue.values;
+      let payloadScVals;
+      let variant;
+      if (enumMetadata) {
+        variant = enumMetadata.variants.find((variantEntry) => variantEntry.name === enumValue.tag);
+        if (!variant || !variant.payloadTypes) {
+          return convertEnumToScVal(enumValue);
+        }
+        const payloadTypes = variant.payloadTypes;
+        const payloadComponents = variant.payloadComponents;
+        payloadScVals = payloadTypes.map((payloadType, index) => {
+          const payloadSchema = payloadComponents?.[index] ? {
+            name: `payload_${index}`,
+            type: payloadType,
+            components: payloadComponents[index]
+          } : { name: `payload_${index}`, type: payloadType };
+          const val = payloadValues[index];
+          return valueToScVal(val, payloadType, payloadSchema, parseValue);
+        });
+      } else {
+        return convertEnumToScVal(enumValue);
+      }
+      if (variant?.isSingleTuplePayload) {
+        const tuplePayloadVec = import_stellar_sdk7.xdr.ScVal.scvVec(payloadScVals);
+        return import_stellar_sdk7.xdr.ScVal.scvVec([tagSymbol, tuplePayloadVec]);
+      }
+      return import_stellar_sdk7.xdr.ScVal.scvVec([tagSymbol, ...payloadScVals]);
+    }
+    if (Array.isArray(possibleEnumValue) && paramSchema?.components && paramSchema.components.length) {
+      if (possibleEnumValue.length !== paramSchema.components.length) {
+        throw new Error(
+          `Tuple-struct value length (${possibleEnumValue.length}) does not match schema components (${paramSchema.components.length}) for type ${parameterType}`
+        );
+      }
+      return convertStructToScVal(
+        possibleEnumValue,
+        parameterType,
+        paramSchema,
+        parseValue,
+        (innerValue, innerType, innerSchema) => valueToScVal(innerValue, innerType, innerSchema, parseInnerValue)
+      );
     }
-    if (isStructType2(value, parameterType)) {
+    if (!isPrimitiveParamType(parameterType) && isStructType2(value, parameterType)) {
       return convertStructToScVal(
         value,
         parameterType,
         paramSchema,
-        parseValue
+        parseValue,
+        (innerValue, innerType, innerSchema) => valueToScVal(innerValue, innerType, innerSchema, parseInnerValue)
       );
     }
     if (parameterType === "Bool" || parameterType === "Bytes") {
@@ -1178,15 +1439,30 @@ function valueToScVal(value, parameterType, paramSchema, parseInnerValue) {
     case "Vec": {
       const innerType = parameters[0];
       if (Array.isArray(value)) {
-        const convertedElements = value.map((element) => valueToScVal(element, innerType));
+        let elementSchema;
+        if (enumMetadata) {
+          elementSchema = {
+            name: "element",
+            type: innerType,
+            enumMetadata
+          };
+        } else if (paramSchema?.components) {
+          elementSchema = {
+            name: "element",
+            type: innerType,
+            components: paramSchema.components
+          };
+        }
+        const convertedElements = value.map(
+          (element) => valueToScVal(element, innerType, elementSchema, parseValue)
+        );
         return (0, import_stellar_sdk7.nativeToScVal)(convertedElements);
       }
       return (0, import_stellar_sdk7.nativeToScVal)(value);
     }
     case "Map": {
       if (Array.isArray(value)) {
-        const convertedValue = {};
-        const typeHints = {};
+        const mapEntries = [];
         value.forEach(
           (entry) => {
             if (typeof entry !== "object" || entry === null || !entry[0] || !entry[1] || typeof entry[0].value === "undefined" || typeof entry[1].value === "undefined") {
@@ -1202,26 +1478,74 @@ function valueToScVal(value, parameterType, paramSchema, parseInnerValue) {
             if (valuePrimitive !== null) {
               processedValue = valuePrimitive;
             }
-            const keyString = typeof processedKey === "string" ? processedKey : String(processedKey);
-            convertedValue[keyString] = processedValue;
             const keyScValType = convertStellarTypeToScValType(entry[0].type);
+            const keyTypeHint = Array.isArray(keyScValType) ? keyScValType[0] : keyScValType;
+            const keyScVal = (0, import_stellar_sdk7.nativeToScVal)(processedKey, { type: keyTypeHint });
             const valueScValType = convertStellarTypeToScValType(entry[1].type);
-            typeHints[keyString] = [
-              Array.isArray(keyScValType) ? keyScValType[0] : keyScValType,
-              Array.isArray(valueScValType) ? valueScValType[0] : valueScValType
-            ];
+            const valueTypeHint = Array.isArray(valueScValType) ? valueScValType[0] : valueScValType;
+            const valueScVal = (0, import_stellar_sdk7.nativeToScVal)(processedValue, { type: valueTypeHint });
+            mapEntries.push(
+              new import_stellar_sdk7.xdr.ScMapEntry({
+                key: keyScVal,
+                val: valueScVal
+              })
+            );
           }
         );
-        return (0, import_stellar_sdk7.nativeToScVal)(convertedValue, { type: typeHints });
+        const sortedMapEntries = mapEntries.sort((a, b) => compareScValsByXdr(a.key(), b.key()));
+        return import_stellar_sdk7.xdr.ScVal.scvMap(sortedMapEntries);
       }
       return (0, import_stellar_sdk7.nativeToScVal)(value);
     }
+    case "Tuple": {
+      if (!paramSchema?.components || paramSchema.components.length === 0) {
+        throw new Error(
+          `Tuple parameter "${paramSchema?.name ?? "unknown"}" is missing component metadata`
+        );
+      }
+      const tupleComponents = paramSchema.components;
+      const tupleValues = [];
+      tupleComponents.forEach((component, index) => {
+        const key = component.name ?? `item_${index}`;
+        let elementValue;
+        if (Array.isArray(value)) {
+          elementValue = value[index];
+        } else if (value && typeof value === "object") {
+          elementValue = value[key];
+        }
+        if (typeof elementValue === "undefined") {
+          const expectedTypes = tupleComponents.map((c) => c.type).join(", ");
+          throw new Error(
+            `Missing tuple value for "${key}" in parameter "${paramSchema.name ?? "unknown"}". Expected ${tupleComponents.length} values of types [${expectedTypes}] but received: ${JSON.stringify(value)}`
+          );
+        }
+        if (typeof elementValue === "string" && isLikelyEnumType(component.type)) {
+          elementValue = { tag: elementValue };
+        }
+        tupleValues.push(valueToScVal(elementValue, component.type, component, parseInnerValue));
+      });
+      return import_stellar_sdk7.xdr.ScVal.scvVec(tupleValues);
+    }
     case "Option": {
       const innerType = parameters[0];
       if (value === null || value === void 0) {
         return (0, import_stellar_sdk7.nativeToScVal)(null);
       } else {
-        return valueToScVal(value, innerType);
+        let innerSchema;
+        if (enumMetadata) {
+          innerSchema = {
+            name: "inner",
+            type: innerType,
+            ...{ enumMetadata }
+          };
+        } else if (paramSchema?.components) {
+          innerSchema = {
+            name: "inner",
+            type: innerType,
+            components: paramSchema.components
+          };
+        }
+        return valueToScVal(value, innerType, innerSchema, parseInnerValue);
       }
     }
     case "Result": {
@@ -1264,12 +1588,15 @@ function parseStellarInput(value, parameterType) {
       const result = parseGeneric(value, parameterType, parseStellarInput);
       return result;
     }
-    if ((0, import_ui_builder_types3.isEnumValue)(value) && isLikelyEnumType(parameterType)) {
+    if ((0, import_ui_builder_types4.isEnumValue)(value) && isLikelyEnumType(parameterType)) {
       return value;
     }
     if ((0, import_ui_builder_utils10.isPlainObject)(value)) {
       return value;
     }
+    if (Array.isArray(value)) {
+      return value;
+    }
     if (typeof value === "string" || typeof value === "number") {
       return value;
     }
@@ -3700,6 +4027,60 @@ var import_ui_builder_utils26 = require("@openzeppelin/ui-builder-utils");
 // src/mapping/enum-metadata.ts
 var import_stellar_sdk13 = require("@stellar/stellar-sdk");
 var import_ui_builder_utils25 = require("@openzeppelin/ui-builder-utils");
+
+// src/mapping/tuple-components.ts
+function buildTupleComponents(parameterType, specEntries) {
+  const tupleElements = extractTupleTypes(parameterType);
+  if (!tupleElements || tupleElements.length === 0) {
+    return null;
+  }
+  return tupleElements.map((elementType, index) => {
+    let nestedComponents;
+    if (specEntries && isStructType(specEntries, elementType)) {
+      const structFields = extractStructFields(specEntries, elementType);
+      if (structFields && structFields.length > 0) {
+        nestedComponents = structFields;
+      }
+    } else if (elementType.startsWith("Tuple<")) {
+      const tupleStruct = buildTupleComponents(elementType, specEntries);
+      if (tupleStruct && tupleStruct.length > 0) {
+        nestedComponents = tupleStruct;
+      }
+    }
+    return {
+      name: `item_${index}`,
+      type: elementType,
+      displayName: `Value ${index + 1} (${elementType})`,
+      ...nestedComponents && { components: nestedComponents }
+    };
+  });
+}
+
+// src/mapping/enum-metadata.ts
+function flattenPayloadType(payloadType, entries, flattenedTypes, flattenedComponents) {
+  if (payloadType.startsWith("Tuple<")) {
+    const tupleComponents = buildTupleComponents(payloadType, entries);
+    if (tupleComponents && tupleComponents.length > 0) {
+      tupleComponents.forEach((component) => {
+        flattenedTypes.push(component.type);
+        if (isStructType(entries, component.type)) {
+          flattenedComponents.push(extractStructFields(entries, component.type) ?? void 0);
+        } else {
+          flattenedComponents.push(component.components);
+        }
+      });
+    } else {
+      flattenedTypes.push(payloadType);
+      flattenedComponents.push(void 0);
+    }
+  } else if (isStructType(entries, payloadType)) {
+    flattenedTypes.push(payloadType);
+    flattenedComponents.push(extractStructFields(entries, payloadType) ?? void 0);
+  } else {
+    flattenedTypes.push(payloadType);
+    flattenedComponents.push(void 0);
+  }
+}
 function extractEnumVariants(entries, enumName) {
   try {
     const entry = entries.find((e) => {
@@ -3728,11 +4109,29 @@ function extractEnumVariants(entries, enumName) {
           });
         } else if (caseKind.value === import_stellar_sdk13.xdr.ScSpecUdtUnionCaseV0Kind.scSpecUdtUnionCaseTupleV0().value) {
           const tupleCase = caseEntry.tupleCase();
-          const payloadTypes = tupleCase.type().map((typeDef) => extractSorobanTypeFromScSpec(typeDef));
+          const rawPayloadTypes = tupleCase.type().map((typeDef) => extractSorobanTypeFromScSpec(typeDef));
+          const isSingleTuplePayload = rawPayloadTypes.length === 1 && rawPayloadTypes[0].startsWith("Tuple<");
+          const flattenedPayloadTypes = [];
+          const flattenedPayloadComponents = [];
+          for (const payloadType of rawPayloadTypes) {
+            flattenPayloadType(
+              payloadType,
+              entries,
+              flattenedPayloadTypes,
+              flattenedPayloadComponents
+            );
+          }
           variants.push({
             name: tupleCase.name().toString(),
             type: "tuple",
-            payloadTypes
+            payloadTypes: flattenedPayloadTypes,
+            ...flattenedPayloadComponents.some(
+              (components) => components && components.length > 0
+            ) && {
+              payloadComponents: flattenedPayloadComponents
+            },
+            // Store metadata about whether this needs tuple wrapping during serialization
+            ...isSingleTuplePayload && { isSingleTuplePayload: true }
           });
           isUnitOnly = false;
         }
@@ -3793,6 +4192,14 @@ function isEnumType(entries, typeName) {
 function getDefaultValidationForType() {
   return { required: true };
 }
+var STELLAR_NUMERIC_BOUNDS = {
+  U8: { min: 0, max: 255 },
+  U16: { min: 0, max: 65535 },
+  U32: { min: 0, max: 4294967295 },
+  I8: { min: -128, max: 127 },
+  I16: { min: -32768, max: 32767 },
+  I32: { min: -2147483648, max: 2147483647 }
+};
 function generateStellarDefaultField(parameter, contractSchema) {
   const specEntries = contractSchema?.metadata?.specEntries;
   const fieldType = mapStellarParameterTypeToFieldType(parameter.type);
@@ -3806,8 +4213,10 @@ function generateStellarDefaultField(parameter, contractSchema) {
   let structComponents = null;
   let finalFieldType = fieldType;
   let options;
-  if (isLikelyEnumType(parameter.type)) {
-    if (specEntries && isEnumType(specEntries, parameter.type)) {
+  const enumDetectedBySpec = !!(specEntries && isEnumType(specEntries, parameter.type));
+  const enumDetectedHeuristic = isLikelyEnumType(parameter.type);
+  if (enumDetectedBySpec || enumDetectedHeuristic) {
+    if (enumDetectedBySpec) {
       enumMetadata = extractEnumVariants(specEntries, parameter.type);
       if (enumMetadata) {
         if (enumMetadata.isUnitOnly) {
@@ -3836,6 +4245,12 @@ function generateStellarDefaultField(parameter, contractSchema) {
       structComponents = structFields;
     }
   }
+  if (!structComponents) {
+    const tupleComponents = buildTupleComponents(parameter.type, specEntries);
+    if (tupleComponents && tupleComponents.length > 0) {
+      structComponents = tupleComponents;
+    }
+  }
   const baseField = {
     id: `field-${Math.random().toString(36).substring(2, 9)}`,
     name: parameter.name || parameter.type,
@@ -3849,6 +4264,11 @@ function generateStellarDefaultField(parameter, contractSchema) {
     width: "full",
     options
   };
+  baseField.validation = (0, import_ui_builder_utils26.enhanceNumericValidation)(
+    baseField.validation,
+    parameter.type,
+    STELLAR_NUMERIC_BOUNDS
+  );
   if (isBytesNType(parameter.type)) {
     const sizeMatch = parameter.type.match(/^BytesN<(\d+)>$/);
     const maxBytes = sizeMatch ? Number.parseInt(sizeMatch[1], 10) : void 0;
@@ -3859,17 +4279,50 @@ function generateStellarDefaultField(parameter, contractSchema) {
       };
     }
   }
-  if (fieldType === "array") {
+  if (fieldType === "array" || fieldType === "array-object") {
     const elementType = extractVecElementType(parameter.type);
     if (elementType) {
       const elementFieldType = mapStellarParameterTypeToFieldType(elementType);
+      let elementEnumMetadata;
+      let elementComponents;
+      let finalElementFieldType = elementFieldType;
+      if (isLikelyEnumType(elementType)) {
+        if (specEntries && isEnumType(specEntries, elementType)) {
+          elementEnumMetadata = extractEnumVariants(specEntries, elementType) ?? void 0;
+          if (elementEnumMetadata) {
+            finalElementFieldType = elementEnumMetadata.isUnitOnly ? "select" : "enum";
+          }
+        }
+      }
+      if (specEntries && isStructType(specEntries, elementType)) {
+        const structFields = extractStructFields(specEntries, elementType);
+        if (structFields && structFields.length > 0) {
+          elementComponents = structFields;
+          finalElementFieldType = "object";
+        }
+      }
+      if (fieldType === "array-object" && parameter.components) {
+        elementComponents = parameter.components;
+        finalElementFieldType = "object";
+      }
+      let elementValidation = { required: true };
+      elementValidation = (0, import_ui_builder_utils26.enhanceNumericValidation)(
+        elementValidation,
+        elementType,
+        STELLAR_NUMERIC_BOUNDS
+      );
       const arrayField = {
         ...baseField,
-        elementType: elementFieldType,
+        type: "array",
+        // Always use 'array' as the field type
+        elementType: finalElementFieldType,
         elementFieldConfig: {
-          type: elementFieldType,
-          validation: { required: true },
-          placeholder: `Enter ${elementType}`
+          type: finalElementFieldType,
+          validation: elementValidation,
+          placeholder: `Enter ${elementType}`,
+          originalParameterType: elementType,
+          ...elementEnumMetadata && { enumMetadata: elementEnumMetadata },
+          ...elementComponents && { components: elementComponents }
         }
       };
       return arrayField;
@@ -3887,13 +4340,21 @@ function generateStellarDefaultField(parameter, contractSchema) {
           valueType: valueFieldType,
           keyFieldConfig: {
             type: keyFieldType,
-            validation: { required: true },
+            validation: (0, import_ui_builder_utils26.enhanceNumericValidation)(
+              { required: true },
+              mapTypes.keyType,
+              STELLAR_NUMERIC_BOUNDS
+            ),
             placeholder: `Enter ${mapTypes.keyType}`,
             originalParameterType: mapTypes.keyType
           },
           valueFieldConfig: {
             type: valueFieldType,
-            validation: { required: true },
+            validation: (0, import_ui_builder_utils26.enhanceNumericValidation)(
+              { required: true },
+              mapTypes.valueType,
+              STELLAR_NUMERIC_BOUNDS
+            ),
             placeholder: `Enter ${mapTypes.valueType}`,
             originalParameterType: mapTypes.valueType
           }
@@ -3929,8 +4390,36 @@ function generateStellarDefaultField(parameter, contractSchema) {
 
 // src/transaction/formatter.ts
 var import_stellar_sdk14 = require("@stellar/stellar-sdk");
-var import_ui_builder_types4 = require("@openzeppelin/ui-builder-types");
+var import_ui_builder_types5 = require("@openzeppelin/ui-builder-types");
 var import_ui_builder_utils27 = require("@openzeppelin/ui-builder-utils");
+function enrichParameterWithEnumMetadata(param, specEntries) {
+  if (!specEntries) {
+    return param;
+  }
+  const enriched = { ...param };
+  if (isLikelyEnumType(param.type) && isEnumType(specEntries, param.type)) {
+    const enumMetadata = extractEnumVariants(specEntries, param.type);
+    if (enumMetadata) {
+      enriched.enumMetadata = enumMetadata;
+    }
+  }
+  const vecMatch = param.type.match(/^Vec<([^>]+)>$/);
+  if (vecMatch) {
+    const elementType = vecMatch[1];
+    if (isLikelyEnumType(elementType) && isEnumType(specEntries, elementType)) {
+      const enumMetadata = extractEnumVariants(specEntries, elementType);
+      if (enumMetadata) {
+        enriched.enumMetadata = enumMetadata;
+      }
+    }
+  }
+  if (enriched.components && enriched.components.length > 0) {
+    enriched.components = enriched.components.map(
+      (component) => enrichParameterWithEnumMetadata(component, specEntries)
+    );
+  }
+  return enriched;
+}
 function formatStellarTransactionData(contractSchema, functionId, submittedInputs, fields) {
   import_ui_builder_utils27.logger.info(
     "formatStellarTransactionData",
@@ -3970,10 +4459,10 @@ function formatStellarTransactionData(contractSchema, functionId, submittedInput
   }
   const transformedArgs = expectedArgs.map((param, index) => {
     let valueToParse = orderedRawValues[index];
-    if ((0, import_ui_builder_types4.isEnumValue)(valueToParse)) {
-      const specEntries = contractSchema.metadata?.specEntries;
-      if (specEntries && isEnumType(specEntries, param.type)) {
-        const enumMetadata = extractEnumVariants(specEntries, param.type);
+    if ((0, import_ui_builder_types5.isEnumValue)(valueToParse)) {
+      const specEntries2 = contractSchema.metadata?.specEntries;
+      if (specEntries2 && isEnumType(specEntries2, param.type)) {
+        const enumMetadata = extractEnumVariants(specEntries2, param.type);
         const enumValue = valueToParse;
         if (enumMetadata && enumValue.values) {
           const selectedVariant = enumMetadata.variants.find((v) => v.name === enumValue.tag);
@@ -3981,14 +4470,15 @@ function formatStellarTransactionData(contractSchema, functionId, submittedInput
             const processedValues = enumValue.values.map(
               (rawValue, payloadIndex) => {
                 const expectedType = selectedVariant.payloadTypes[payloadIndex];
-                if (expectedType) {
-                  const processedValue = parseStellarInput(rawValue, expectedType);
-                  return {
-                    type: expectedType,
-                    value: processedValue
-                  };
+                if (!expectedType) {
+                  return rawValue;
                 }
-                return rawValue;
+                const processedValue = parseStellarInput(rawValue, expectedType);
+                const isPrimitivePayload = isPrimitiveParamType(expectedType) || isBytesNType(expectedType);
+                if (isPrimitivePayload) {
+                  return { type: expectedType, value: processedValue };
+                }
+                return processedValue;
               }
             );
             valueToParse = { ...enumValue, values: processedValues };
@@ -4009,14 +4499,64 @@ function formatStellarTransactionData(contractSchema, functionId, submittedInput
   } catch {
     throw new Error("Contract address is missing or invalid in the provided schema.");
   }
+  const fieldByName = /* @__PURE__ */ new Map();
+  fields.forEach((field) => fieldByName.set(field.name, field));
+  const specEntries = contractSchema.metadata?.specEntries;
+  const argSchemaWithComponents = functionDetails.inputs.map((param) => {
+    const field = fieldByName.get(param.name);
+    const enhanced = { ...param };
+    if (param.components && param.components.length > 0) {
+      enhanced.components = param.components;
+    } else if (field?.components && field.components.length > 0) {
+      enhanced.components = field.components;
+    }
+    if (field?.enumMetadata) {
+      enhanced.enumMetadata = field.enumMetadata;
+    }
+    if (param.type.startsWith("Vec<") && field?.elementFieldConfig) {
+      if (field.elementFieldConfig.enumMetadata) {
+        enhanced.enumMetadata = field.elementFieldConfig.enumMetadata;
+      }
+      if (field.elementFieldConfig.components) {
+        enhanced.components = field.elementFieldConfig.components;
+      }
+    }
+    if (enhanced.components && enhanced.components.length > 0) {
+      enhanced.components = enhanced.components.map((component) => {
+        const nestedFieldName = `${param.name}.${component.name}`;
+        const nestedField = fieldByName.get(nestedFieldName);
+        if (nestedField) {
+          const enrichedComponent = { ...component };
+          if (nestedField.enumMetadata) {
+            enrichedComponent.enumMetadata = nestedField.enumMetadata;
+          }
+          if (nestedField.components) {
+            enrichedComponent.components = nestedField.components;
+          }
+          if (component.type.startsWith("Vec<") && nestedField.elementFieldConfig) {
+            if (nestedField.elementFieldConfig.enumMetadata) {
+              enrichedComponent.enumMetadata = nestedField.elementFieldConfig.enumMetadata;
+            }
+            if (nestedField.elementFieldConfig.components) {
+              enrichedComponent.components = nestedField.elementFieldConfig.components;
+            }
+          }
+          return enrichedComponent;
+        }
+        return component;
+      });
+    }
+    const finalEnhanced = enrichParameterWithEnumMetadata(enhanced, specEntries);
+    return finalEnhanced;
+  });
   const stellarTransactionData = {
     contractAddress: contractSchema.address,
     functionName: functionDetails.name,
     args: transformedArgs,
     argTypes: functionDetails.inputs.map((param) => param.type),
     // Include parameter types for ScVal conversion
-    argSchema: functionDetails.inputs,
-    // Include full parameter schema with struct field definitions
+    argSchema: argSchemaWithComponents,
+    // Include full parameter schema with struct/tuple field definitions
     transactionOptions: {
       // Add any Stellar-specific transaction options here
       // For example: fee, timeout, memo, etc.
@@ -4616,7 +5156,7 @@ var CustomAccountDisplay = ({ className }) => {
 };
 
 // src/wallet/utils/filterWalletComponents.ts
-var import_ui_builder_types5 = require("@openzeppelin/ui-builder-types");
+var import_ui_builder_types6 = require("@openzeppelin/ui-builder-types");
 var import_ui_builder_utils35 = require("@openzeppelin/ui-builder-utils");
 function filterWalletComponents(allPossibleComponents, exclusions, kitName = "custom") {
   import_ui_builder_utils35.logger.debug(
@@ -4662,7 +5202,7 @@ function getComponentExclusionsFromConfig(kitConfig) {
     const componentsCfg = kitConfig.components;
     if (componentsCfg && typeof componentsCfg === "object" && "exclude" in componentsCfg && Array.isArray(componentsCfg.exclude)) {
       return componentsCfg.exclude.filter(
-        (key) => typeof key === "string" && import_ui_builder_types5.ECOSYSTEM_WALLET_COMPONENT_KEYS.includes(key)
+        (key) => typeof key === "string" && import_ui_builder_types6.ECOSYSTEM_WALLET_COMPONENT_KEYS.includes(key)
       );
     }
   }
@@ -4758,7 +5298,7 @@ var StellarAdapter = class {
   constructor(networkConfig) {
     __publicField(this, "networkConfig");
     __publicField(this, "initialAppServiceKitName");
-    if (!(0, import_ui_builder_types6.isStellarNetworkConfig)(networkConfig)) {
+    if (!(0, import_ui_builder_types7.isStellarNetworkConfig)(networkConfig)) {
       throw new Error("StellarAdapter requires a valid Stellar network configuration.");
     }
     this.networkConfig = networkConfig;