@openzeppelin/ui-builder-adapter-stellar 0.12.0 → 0.14.0

package/dist/vite-config.cjs

@@ -0,0 +1,52 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/vite-config.ts
+var vite_config_exports = {};
+__export(vite_config_exports, {
+  getStellarViteConfig: () => getStellarViteConfig
+});
+module.exports = __toCommonJS(vite_config_exports);
+function getStellarViteConfig() {
+  return {
+    // Currently no Stellar-specific plugins required
+    plugins: [],
+    resolve: {
+      // Module Deduplication
+      // Ensure singleton instances of shared dependencies
+      dedupe: [
+        // Stellar-specific dependencies that may need deduplication
+        "@stellar/stellar-sdk",
+        "@creit.tech/stellar-wallets-kit"
+      ]
+    },
+    optimizeDeps: {
+      // Force Pre-Bundling (CommonJS → ESM conversion)
+      // Stellar dependencies are typically already ESM, but we include them here
+      // for consistency and to ensure proper module resolution
+      include: [],
+      exclude: []
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getStellarViteConfig
+});
+//# sourceMappingURL=vite-config.cjs.map

package/dist/vite-config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite-config.ts"],"sourcesContent":["/**\n * Stellar Adapter: Vite Configuration Export\n *\n * This module exports Vite configuration fragments for the Stellar adapter.\n * Currently minimal, but provides a consistent interface for adapter-specific\n * build requirements.\n *\n * USAGE:\n * 1. In the main builder app: Import and merge into packages/builder/vite.config.ts\n * 2. In exported apps: The export system injects these configs when Stellar is used\n *\n * See: docs/ADAPTER_ARCHITECTURE.md § \"Build-Time Requirements\"\n */\n\nimport type { UserConfig } from 'vite';\n\n/**\n * Returns the Vite configuration required for Stellar adapter compatibility\n *\n * @returns Vite configuration object to be merged with your main vite.config\n *\n * @example\n * ```typescript\n * // vite.config.ts\n * import { getStellarViteConfig } from '@openzeppelin/ui-builder-adapter-stellar/vite-config';\n *\n * export default defineConfig(({ mode }) => {\n *   const stellarConfig = getStellarViteConfig();\n *\n *   return {\n *     plugins: [\n *       react(),\n *       ...stellarConfig.plugins,\n *     ],\n *     resolve: {\n *       dedupe: [\n *         ...stellarConfig.resolve.dedupe,\n *       ],\n *     },\n *   };\n * });\n * ```\n */\nexport function getStellarViteConfig(): UserConfig {\n  return {\n    // Currently no Stellar-specific plugins required\n    plugins: [],\n\n    resolve: {\n      // Module Deduplication\n      // Ensure singleton instances of shared dependencies\n      dedupe: [\n        // Stellar-specific dependencies that may need deduplication\n        '@stellar/stellar-sdk',\n        '@creit.tech/stellar-wallets-kit',\n      ],\n    },\n\n    optimizeDeps: {\n      // Force Pre-Bundling (CommonJS → ESM conversion)\n      // Stellar dependencies are typically already ESM, but we include them here\n      // for consistency and to ensure proper module resolution\n      include: [],\n      exclude: [],\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA2CO,SAAS,uBAAmC;AACjD,SAAO;AAAA;AAAA,IAEL,SAAS,CAAC;AAAA,IAEV,SAAS;AAAA;AAAA;AAAA,MAGP,QAAQ;AAAA;AAAA,QAEN;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,IAEA,cAAc;AAAA;AAAA;AAAA;AAAA,MAIZ,SAAS,CAAC;AAAA,MACV,SAAS,CAAC;AAAA,IACZ;AAAA,EACF;AACF;","names":[]}

package/dist/vite-config.d.cts

@@ -0,0 +1,46 @@
+import { UserConfig } from 'vite';
+
+/**
+ * Stellar Adapter: Vite Configuration Export
+ *
+ * This module exports Vite configuration fragments for the Stellar adapter.
+ * Currently minimal, but provides a consistent interface for adapter-specific
+ * build requirements.
+ *
+ * USAGE:
+ * 1. In the main builder app: Import and merge into packages/builder/vite.config.ts
+ * 2. In exported apps: The export system injects these configs when Stellar is used
+ *
+ * See: docs/ADAPTER_ARCHITECTURE.md § "Build-Time Requirements"
+ */
+
+/**
+ * Returns the Vite configuration required for Stellar adapter compatibility
+ *
+ * @returns Vite configuration object to be merged with your main vite.config
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { getStellarViteConfig } from '@openzeppelin/ui-builder-adapter-stellar/vite-config';
+ *
+ * export default defineConfig(({ mode }) => {
+ *   const stellarConfig = getStellarViteConfig();
+ *
+ *   return {
+ *     plugins: [
+ *       react(),
+ *       ...stellarConfig.plugins,
+ *     ],
+ *     resolve: {
+ *       dedupe: [
+ *         ...stellarConfig.resolve.dedupe,
+ *       ],
+ *     },
+ *   };
+ * });
+ * ```
+ */
+declare function getStellarViteConfig(): UserConfig;
+
+export { getStellarViteConfig };

package/dist/vite-config.d.ts

@@ -0,0 +1,46 @@
+import { UserConfig } from 'vite';
+
+/**
+ * Stellar Adapter: Vite Configuration Export
+ *
+ * This module exports Vite configuration fragments for the Stellar adapter.
+ * Currently minimal, but provides a consistent interface for adapter-specific
+ * build requirements.
+ *
+ * USAGE:
+ * 1. In the main builder app: Import and merge into packages/builder/vite.config.ts
+ * 2. In exported apps: The export system injects these configs when Stellar is used
+ *
+ * See: docs/ADAPTER_ARCHITECTURE.md § "Build-Time Requirements"
+ */
+
+/**
+ * Returns the Vite configuration required for Stellar adapter compatibility
+ *
+ * @returns Vite configuration object to be merged with your main vite.config
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { getStellarViteConfig } from '@openzeppelin/ui-builder-adapter-stellar/vite-config';
+ *
+ * export default defineConfig(({ mode }) => {
+ *   const stellarConfig = getStellarViteConfig();
+ *
+ *   return {
+ *     plugins: [
+ *       react(),
+ *       ...stellarConfig.plugins,
+ *     ],
+ *     resolve: {
+ *       dedupe: [
+ *         ...stellarConfig.resolve.dedupe,
+ *       ],
+ *     },
+ *   };
+ * });
+ * ```
+ */
+declare function getStellarViteConfig(): UserConfig;
+
+export { getStellarViteConfig };

package/dist/vite-config.js

@@ -0,0 +1,27 @@
+// src/vite-config.ts
+function getStellarViteConfig() {
+  return {
+    // Currently no Stellar-specific plugins required
+    plugins: [],
+    resolve: {
+      // Module Deduplication
+      // Ensure singleton instances of shared dependencies
+      dedupe: [
+        // Stellar-specific dependencies that may need deduplication
+        "@stellar/stellar-sdk",
+        "@creit.tech/stellar-wallets-kit"
+      ]
+    },
+    optimizeDeps: {
+      // Force Pre-Bundling (CommonJS → ESM conversion)
+      // Stellar dependencies are typically already ESM, but we include them here
+      // for consistency and to ensure proper module resolution
+      include: [],
+      exclude: []
+    }
+  };
+}
+export {
+  getStellarViteConfig
+};
+//# sourceMappingURL=vite-config.js.map

package/dist/vite-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite-config.ts"],"sourcesContent":["/**\n * Stellar Adapter: Vite Configuration Export\n *\n * This module exports Vite configuration fragments for the Stellar adapter.\n * Currently minimal, but provides a consistent interface for adapter-specific\n * build requirements.\n *\n * USAGE:\n * 1. In the main builder app: Import and merge into packages/builder/vite.config.ts\n * 2. In exported apps: The export system injects these configs when Stellar is used\n *\n * See: docs/ADAPTER_ARCHITECTURE.md § \"Build-Time Requirements\"\n */\n\nimport type { UserConfig } from 'vite';\n\n/**\n * Returns the Vite configuration required for Stellar adapter compatibility\n *\n * @returns Vite configuration object to be merged with your main vite.config\n *\n * @example\n * ```typescript\n * // vite.config.ts\n * import { getStellarViteConfig } from '@openzeppelin/ui-builder-adapter-stellar/vite-config';\n *\n * export default defineConfig(({ mode }) => {\n *   const stellarConfig = getStellarViteConfig();\n *\n *   return {\n *     plugins: [\n *       react(),\n *       ...stellarConfig.plugins,\n *     ],\n *     resolve: {\n *       dedupe: [\n *         ...stellarConfig.resolve.dedupe,\n *       ],\n *     },\n *   };\n * });\n * ```\n */\nexport function getStellarViteConfig(): UserConfig {\n  return {\n    // Currently no Stellar-specific plugins required\n    plugins: [],\n\n    resolve: {\n      // Module Deduplication\n      // Ensure singleton instances of shared dependencies\n      dedupe: [\n        // Stellar-specific dependencies that may need deduplication\n        '@stellar/stellar-sdk',\n        '@creit.tech/stellar-wallets-kit',\n      ],\n    },\n\n    optimizeDeps: {\n      // Force Pre-Bundling (CommonJS → ESM conversion)\n      // Stellar dependencies are typically already ESM, but we include them here\n      // for consistency and to ensure proper module resolution\n      include: [],\n      exclude: [],\n    },\n  };\n}\n"],"mappings":";AA2CO,SAAS,uBAAmC;AACjD,SAAO;AAAA;AAAA,IAEL,SAAS,CAAC;AAAA,IAEV,SAAS;AAAA;AAAA;AAAA,MAGP,QAAQ;AAAA;AAAA,QAEN;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,IAEA,cAAc;AAAA;AAAA;AAAA;AAAA,MAIZ,SAAS,CAAC;AAAA,MACV,SAAS,CAAC;AAAA,IACZ;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openzeppelin/ui-builder-adapter-stellar",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Stellar Adapter for UI Builder",
   "keywords": [
     "openzeppelin",
@@ -42,9 +42,9 @@
     "lossless-json": "^4.0.2",
     "lucide-react": "^0.510.0",
     "react-hook-form": "^7.62.0",
-    "@openzeppelin/ui-builder-types": "0.12.0",
-    "@openzeppelin/ui-builder-ui": "0.12.0",
-    "@openzeppelin/ui-builder-utils": "^0.12.0"
+    "@openzeppelin/ui-builder-types": "0.14.0",
+    "@openzeppelin/ui-builder-ui": "0.14.0",
+    "@openzeppelin/ui-builder-utils": "^0.14.0"
   },
   "devDependencies": {
     "@types/lodash": "^4.17.20",
@@ -65,6 +65,11 @@
       "types": "./dist/config.d.ts",
       "import": "./dist/config.js",
       "require": "./dist/config.cjs"
+    },
+    "./vite-config": {
+      "types": "./dist/vite-config.d.ts",
+      "import": "./dist/vite-config.js",
+      "require": "./dist/vite-config.cjs"
     }
   },
   "scripts": {

package/src/adapter.ts

@@ -15,6 +15,7 @@ import type {
   FormFieldType,
   FunctionParameter,
   NativeConfigLoader,
+  NetworkServiceForm,
   RelayerDetails,
   RelayerDetailsRich,
   StellarNetworkConfig,
@@ -27,6 +28,11 @@ import type {
 import { isStellarNetworkConfig } from '@openzeppelin/ui-builder-types';
 import { logger } from '@openzeppelin/ui-builder-utils';
 
+import {
+  getStellarNetworkServiceForms,
+  testStellarNetworkServiceConnection,
+  validateStellarNetworkServiceConfig,
+} from './configuration/network-services';
 // Import functions from modules
 import { loadStellarContract, loadStellarContractWithMetadata } from './contract/loader';
 import { StellarRelayerOptions } from './transaction/components';
@@ -73,8 +79,6 @@ import {
 
 /**
  * Stellar-specific adapter implementation using explicit method delegation.
- *
- * NOTE: Contains placeholder implementations for most functionalities.
  */
 export class StellarAdapter implements ContractAdapter {
   readonly networkConfig: StellarNetworkConfig;
@@ -117,7 +121,33 @@ export class StellarAdapter implements ContractAdapter {
     );
   }
 
-  // --- Contract Loading --- //
+  /**
+   * @inheritdoc
+   */
+  public getNetworkServiceForms(): NetworkServiceForm[] {
+    return getStellarNetworkServiceForms();
+  }
+
+  /**
+   * @inheritdoc
+   */
+  public async validateNetworkServiceConfig(
+    serviceId: string,
+    values: Record<string, unknown>
+  ): Promise<boolean> {
+    return validateStellarNetworkServiceConfig(serviceId, values);
+  }
+
+  /**
+   * @inheritdoc
+   */
+  public async testNetworkServiceConnection(
+    serviceId: string,
+    values: Record<string, unknown>
+  ): Promise<{ success: boolean; latency?: number; error?: string }> {
+    return testStellarNetworkServiceConnection(serviceId, values);
+  }
+
   /**
    * NOTE about artifact inputs (single input with auto-detection):
    *
@@ -142,6 +172,9 @@ export class StellarAdapter implements ContractAdapter {
    *   manual contract definition exactly like the EVM/Midnight flows.
    * - Provide clear UI hints about supported formats (JSON spec or Wasm binary).
    */
+  /**
+   * @inheritdoc
+   */
   public getContractDefinitionInputs(): FormFieldType[] {
     return [
       {
@@ -197,11 +230,16 @@ export class StellarAdapter implements ContractAdapter {
     }
   }
 
+  /**
+   * @inheritdoc
+   */
   getWritableFunctions(contractSchema: ContractSchema): ContractSchema['functions'] {
     return getStellarWritableFunctions(contractSchema);
   }
 
-  // --- Type Mapping & Field Generation --- //
+  /**
+   * @inheritdoc
+   */
   mapParameterTypeToFieldType(parameterType: string): FieldType {
     return mapStellarParameterTypeToFieldType(parameterType);
   }
@@ -215,7 +253,9 @@ export class StellarAdapter implements ContractAdapter {
     return generateStellarDefaultField(parameter, contractSchema);
   }
 
-  // --- Transaction Formatting & Execution --- //
+  /**
+   * @inheritdoc
+   */
   public formatTransactionData(
     contractSchema: ContractSchema,
     functionId: string,
@@ -239,17 +279,16 @@ export class StellarAdapter implements ContractAdapter {
     );
   }
 
-  // NOTE: waitForTransactionConfirmation? is optional in the interface.
-  // Since the imported function is currently undefined, we omit the method here.
-  // If implemented in ./transaction/sender.ts later, add the method back:
-  // async waitForTransactionConfirmation?(...) { ... }
-
-  // --- View Function Querying --- //
+  /**
+   * @inheritdoc
+   */
   isViewFunction(functionDetails: ContractFunction): boolean {
     return isStellarViewFunction(functionDetails);
   }
 
-  // Implement queryViewFunction with the correct signature from ContractAdapter
+  /**
+   * @inheritdoc
+   */
   async queryViewFunction(
     contractAddress: string,
     functionId: string,
@@ -266,25 +305,46 @@ export class StellarAdapter implements ContractAdapter {
     );
   }
 
+  /**
+   * @inheritdoc
+   */
   formatFunctionResult(decodedValue: unknown, functionDetails: ContractFunction): string {
     return formatStellarFunctionResult(decodedValue, functionDetails);
   }
 
-  // --- Wallet Interaction --- //
+  /**
+   * @inheritdoc
+   */
   supportsWalletConnection(): boolean {
     return supportsStellarWalletConnection();
   }
+
+  /**
+   * @inheritdoc
+   */
   async getAvailableConnectors(): Promise<Connector[]> {
     return getStellarAvailableConnectors();
   }
+
+  /**
+   * @inheritdoc
+   */
   async connectWallet(
     connectorId: string
   ): Promise<{ connected: boolean; address?: string; error?: string }> {
     return connectStellarWallet(connectorId);
   }
+
+  /**
+   * @inheritdoc
+   */
   async disconnectWallet(): Promise<{ disconnected: boolean; error?: string }> {
     return disconnectStellarWallet();
   }
+
+  /**
+   * @inheritdoc
+   */
   getWalletConnectionStatus(): StellarWalletConnectionStatus {
     const impl = getInitializedStellarWalletImplementation();
     if (!impl) {
@@ -326,21 +386,31 @@ export class StellarAdapter implements ContractAdapter {
     );
   }
 
-  // --- Configuration & Metadata --- //
+  /**
+   * @inheritdoc
+   */
   async getSupportedExecutionMethods(): Promise<ExecutionMethodDetail[]> {
     return getStellarSupportedExecutionMethods();
   }
+
+  /**
+   * @inheritdoc
+   */
   async validateExecutionConfig(config: ExecutionConfig): Promise<true | string> {
     const walletStatus = this.getWalletConnectionStatus();
     return validateStellarExecutionConfig(config, walletStatus);
   }
 
-  // Implement getExplorerUrl with the correct signature from ContractAdapter
+  /**
+   * @inheritdoc
+   */
   getExplorerUrl(address: string): string | null {
     return getStellarExplorerAddressUrl(address, this.networkConfig);
   }
 
-  // Implement getExplorerTxUrl with the correct signature from ContractAdapter
+  /**
+   * @inheritdoc
+   */
   getExplorerTxUrl?(txHash: string): string | null {
     if (getStellarExplorerTxUrl) {
       return getStellarExplorerTxUrl(txHash, this.networkConfig);
@@ -348,11 +418,16 @@ export class StellarAdapter implements ContractAdapter {
     return null;
   }
 
-  // --- Validation --- //
+  /**
+   * @inheritdoc
+   */
   isValidAddress(address: string, addressType?: string): boolean {
     return isStellarValidAddress(address, addressType as StellarAddressType);
   }
 
+  /**
+   * @inheritdoc
+   */
   public async getAvailableUiKits(): Promise<AvailableUiKit[]> {
     return [
       {
@@ -449,6 +524,9 @@ export class StellarAdapter implements ContractAdapter {
     return stellarFacadeHooks;
   }
 
+  /**
+   * @inheritdoc
+   */
   public async getRelayers(serviceUrl: string, accessToken: string): Promise<RelayerDetails[]> {
     const relayerStrategy = new RelayerExecutionStrategy();
     try {
@@ -459,6 +537,9 @@ export class StellarAdapter implements ContractAdapter {
     }
   }
 
+  /**
+   * @inheritdoc
+   */
   public async getRelayer(
     serviceUrl: string,
     accessToken: string,
@@ -479,8 +560,7 @@ export class StellarAdapter implements ContractAdapter {
   }
 
   /**
-   * Returns a React component for configuring Stellar-specific relayer transaction options.
-   * @returns The Stellar relayer options component
+   * @inheritdoc
    */
   public getRelayerOptionsComponent():
     | React.ComponentType<{

package/src/configuration/__tests__/rpc.test.ts

@@ -22,7 +22,6 @@ const createMockConfig = (
   sorobanRpcUrl: sorobanRpcUrl || '', // Allow undefined or empty for testing error cases
   networkPassphrase: `Test ${id} Network`,
   explorerUrl: `https://stellar.expert/explorer/${id}`,
-  icon: 'stellar',
 });
 
 // Mock the appConfigService from the correct package

package/src/configuration/index.ts

@@ -1,4 +1,5 @@
 // Barrel file for configuration modules
 export * from './execution';
 export * from './explorer';
+export * from './network-services';
 export * from './rpc';

package/src/configuration/network-services.ts

@@ -0,0 +1,51 @@
+import type { NetworkServiceForm, UserRpcProviderConfig } from '@openzeppelin/ui-builder-types';
+
+import { testStellarRpcConnection, validateStellarRpcEndpoint } from './rpc';
+
+/**
+ * Returns the network service forms for Stellar networks.
+ * Defines the UI configuration for the RPC service.
+ */
+export function getStellarNetworkServiceForms(): NetworkServiceForm[] {
+  return [
+    {
+      id: 'rpc',
+      label: 'RPC Provider',
+      fields: [
+        {
+          id: 'stellar-rpc-url',
+          name: 'sorobanRpcUrl',
+          type: 'text',
+          label: 'Soroban RPC URL',
+          placeholder: 'https://soroban.stellar.org',
+          validation: { required: true, pattern: '^https?://.+' },
+          width: 'full',
+        },
+      ],
+    },
+  ];
+}
+
+/**
+ * Validates a network service configuration for Stellar networks.
+ */
+export async function validateStellarNetworkServiceConfig(
+  serviceId: string,
+  values: Record<string, unknown>
+): Promise<boolean> {
+  if (serviceId !== 'rpc') return true;
+  const cfg = { url: String(values.sorobanRpcUrl || ''), isCustom: true } as UserRpcProviderConfig;
+  return validateStellarRpcEndpoint(cfg);
+}
+
+/**
+ * Tests a network service connection for Stellar networks.
+ */
+export async function testStellarNetworkServiceConnection(
+  serviceId: string,
+  values: Record<string, unknown>
+): Promise<{ success: boolean; latency?: number; error?: string }> {
+  if (serviceId !== 'rpc') return { success: true };
+  const cfg = { url: String(values.sorobanRpcUrl || ''), isCustom: true } as UserRpcProviderConfig;
+  return testStellarRpcConnection(cfg);
+}

package/src/mapping/constants.ts

@@ -3,6 +3,12 @@ import type { FieldType } from '@openzeppelin/ui-builder-types';
 /**
  * Stellar/Soroban-specific type mapping to default form field types.
  * Based on Soroban type system: https://developers.stellar.org/docs/learn/fundamentals/contract-development/types
+ *
+ * Note: Large integer types (U64, U128, U256, I64, I128, I256) are mapped to 'bigint'
+ * instead of 'number' to avoid JavaScript's Number precision limitations.
+ * JavaScript's Number type can only safely represent integers up to 2^53 - 1,
+ * but these types can hold much larger values. The BigIntField component stores values
+ * as strings and the Stellar adapter handles conversion automatically.
  */
 export const STELLAR_TYPE_TO_FIELD_TYPE: Record<string, FieldType> = {
   // Address types
@@ -15,15 +21,15 @@ export const STELLAR_TYPE_TO_FIELD_TYPE: Record<string, FieldType> = {
 
   // Numeric types - unsigned integers
   U32: 'number',
-  U64: 'number',
-  U128: 'number',
-  U256: 'number',
+  U64: 'bigint',
+  U128: 'bigint',
+  U256: 'bigint',
 
   // Numeric types - signed integers
   I32: 'number',
-  I64: 'number',
-  I128: 'number',
-  I256: 'number',
+  I64: 'bigint',
+  I128: 'bigint',
+  I256: 'bigint',
 
   // Boolean type
   Bool: 'checkbox',

package/src/mapping/type-mapper.ts

@@ -133,15 +133,15 @@ export function getStellarCompatibleFieldTypes(parameterType: string): FieldType
 
     // Unsigned integers
     U32: ['number', 'amount', 'text'],
-    U64: ['number', 'amount', 'text'],
-    U128: ['number', 'amount', 'text'],
-    U256: ['number', 'amount', 'text'],
+    U64: ['bigint', 'number', 'amount', 'text'],
+    U128: ['bigint', 'number', 'amount', 'text'],
+    U256: ['bigint', 'number', 'amount', 'text'],
 
     // Signed integers
     I32: ['number', 'amount', 'text'],
-    I64: ['number', 'amount', 'text'],
-    I128: ['number', 'amount', 'text'],
-    I256: ['number', 'amount', 'text'],
+    I64: ['bigint', 'number', 'text'],
+    I128: ['bigint', 'number', 'text'],
+    I256: ['bigint', 'number', 'text'],
 
     // Boolean
     Bool: ['checkbox', 'select', 'radio', 'text'],

package/src/networks/README.md

@@ -67,7 +67,7 @@ export const stellarCustom: StellarNetworkConfig = {
   sorobanRpcUrl: 'https://soroban.custom.example',
   networkPassphrase: 'Custom Network Passphrase',
   explorerUrl: 'https://stellar.expert/explorer/custom',
-  icon: 'stellar',
+  iconComponent: NetworkStellarCustom,
 };
 ```
 

package/src/vite-config.ts

@@ -0,0 +1,67 @@
+/**
+ * Stellar Adapter: Vite Configuration Export
+ *
+ * This module exports Vite configuration fragments for the Stellar adapter.
+ * Currently minimal, but provides a consistent interface for adapter-specific
+ * build requirements.
+ *
+ * USAGE:
+ * 1. In the main builder app: Import and merge into packages/builder/vite.config.ts
+ * 2. In exported apps: The export system injects these configs when Stellar is used
+ *
+ * See: docs/ADAPTER_ARCHITECTURE.md § "Build-Time Requirements"
+ */
+
+import type { UserConfig } from 'vite';
+
+/**
+ * Returns the Vite configuration required for Stellar adapter compatibility
+ *
+ * @returns Vite configuration object to be merged with your main vite.config
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { getStellarViteConfig } from '@openzeppelin/ui-builder-adapter-stellar/vite-config';
+ *
+ * export default defineConfig(({ mode }) => {
+ *   const stellarConfig = getStellarViteConfig();
+ *
+ *   return {
+ *     plugins: [
+ *       react(),
+ *       ...stellarConfig.plugins,
+ *     ],
+ *     resolve: {
+ *       dedupe: [
+ *         ...stellarConfig.resolve.dedupe,
+ *       ],
+ *     },
+ *   };
+ * });
+ * ```
+ */
+export function getStellarViteConfig(): UserConfig {
+  return {
+    // Currently no Stellar-specific plugins required
+    plugins: [],
+
+    resolve: {
+      // Module Deduplication
+      // Ensure singleton instances of shared dependencies
+      dedupe: [
+        // Stellar-specific dependencies that may need deduplication
+        '@stellar/stellar-sdk',
+        '@creit.tech/stellar-wallets-kit',
+      ],
+    },
+
+    optimizeDeps: {
+      // Force Pre-Bundling (CommonJS → ESM conversion)
+      // Stellar dependencies are typically already ESM, but we include them here
+      // for consistency and to ensure proper module resolution
+      include: [],
+      exclude: [],
+    },
+  };
+}