Midnight v1 – 01 Wallet

.changeset/file-upload-field-component.md

@@ -0,0 +1,21 @@
+---
+'@openzeppelin/ui-builder-ui': minor
+'@openzeppelin/ui-builder-types': patch
+'@openzeppelin/ui-builder-renderer': patch
+---
+
+Add FileUploadField component with drag-and-drop support
+
+- Add new FileUploadField component to UI package with comprehensive file upload functionality
+- Implement drag-and-drop file upload with visual feedback states
+- Add file size validation with customizable limits
+- Add file type validation via accept prop
+- Include optional base64 conversion for storage
+- Provide visual feedback for upload states (idle, processing, success, error)
+- Full accessibility support with ARIA attributes and keyboard navigation
+- Integration with React Hook Form for validation
+- Add file-upload field type to types package
+- Register FileUploadField in renderer field registry
+
+Usage: Designed primarily for uploading contract artifacts (ZIP files) in Midnight adapter, but suitable for any file upload needs across the application.
+

.changeset/midnight-contract-ingestion.md

@@ -0,0 +1,14 @@
+---
+'@openzeppelin/ui-builder-adapter-midnight': minor
+'@openzeppelin/ui-builder-app': patch
+'@openzeppelin/ui-builder-storage': patch
+'@openzeppelin/ui-builder-utils': patch
+'@openzeppelin/ui-builder-ui': patch
+---
+
+Midnight adapter contract ingestion and shared gating
+
+- Midnight: move loading to contract/loader; return contractDefinitionArtifacts; keep adapter thin.
+- Builder: replace local required-field gating with shared utils (getMissingRequiredContractInputs); remove redundant helper.
+- Utils: add contractInputs shared helpers and tests.
+- Storage/App/UI: persist and rehydrate contractDefinitionArtifacts; auto-save triggers on artifact changes.

.changeset/midnight-refactor-bytes-size.md

@@ -0,0 +1,5 @@
+---
+'@openzeppelin/ui-builder-adapter-midnight': patch
+---
+
+Refactor to use shared `getBytesSize` function from `@openzeppelin/ui-builder-utils` instead of local implementation. This ensures consistent bytes size parsing across all adapters and reduces code duplication.

.changeset/midnight-wallet-event-driven-architecture.md

@@ -0,0 +1,36 @@
+---
+'@openzeppelin/ui-builder-adapter-midnight': minor
+---
+
+# Refactor Midnight wallet management to event-driven architecture with polling-based event emulation
+
+**Architecture Changes:**
+
+- Refactored wallet implementation to mirror Stellar adapter structure
+- Introduced `LaceWalletImplementation` class for core wallet logic
+- Added `midnightWalletImplementationManager` singleton pattern
+- Created `MidnightWalletUiRoot` as the primary provider component
+- Removed unnecessary `MidnightWalletProvider` wrapper for consistency
+- Implemented facade functions in `connection.ts` for high-level wallet operations
+
+**Event Emulation:**
+
+- Lace Midnight DAppConnectorWalletAPI lacks native `onAccountChange` events
+- Implemented polling-based event emulation via `api.state()` with exponential backoff
+- Adaptive polling intervals: 2s initial, 5s when connected, up to 15s on errors
+- Polling pauses when document is hidden (tab inactive) to reduce intrusive popups
+- Polling starts only when listeners subscribe, stops when all unsubscribe
+
+**UX Improvements:**
+
+- Fixed repeated wallet popup issue by preventing multiple `enable()` calls
+- Added `connectInFlight` guard against React Strict Mode double-effects and rapid clicks
+- Implemented focus/blur heuristics to detect user dismissal of unlock popup
+- 60s fallback timeout prevents infinite loading state in edge cases
+- Auto-reconnect on page load for seamless UX with already-enabled wallets
+
+**Documentation:**
+
+- Added comprehensive inline comments explaining design decisions and limitations
+- Created wallet module README documenting architecture and implementation details
+- Documented all workarounds needed due to Lace API limitations

.changeset/midnight-wallet-tests-and-config.md

@@ -0,0 +1,5 @@
+---
+'@openzeppelin/ui-builder-adapter-midnight': patch
+---
+
+Add wallet connection unit tests and Vitest configuration; fix adapter imports to use local configuration barrel. Remove temporary test seam to align with other adapters.

.changeset/runtime-secret-feature.md

@@ -0,0 +1,28 @@
+---
+'@openzeppelin/ui-builder-types': minor
+'@openzeppelin/ui-builder-ui': minor
+'@openzeppelin/ui-builder-builder': minor
+'@openzeppelin/ui-builder-renderer': minor
+'@openzeppelin/ui-builder-adapter-midnight': minor
+---
+
+Implement runtime-only secret field support with dual-credential execution
+
+- Add FunctionBadge, FunctionDecoration, and FunctionDecorationsMap types to types/adapters/ui-enhancements.ts
+- Extend ContractAdapter.signAndBroadcast to accept optional runtimeApiKey and runtimeSecret parameters
+- Add adapterBinding field to FormFieldType for adapter-specific credential binding
+- Implement Banner component for reusable notification/warning display in ui package
+- Add runtimeSecret field type with adapter-driven UI rendering in builder:
+  - Hide "Field Type" dropdown for runtime secret fields
+  - Hide "Required Field" toggle for runtime secret fields
+  - Make "Field Label" span full width when Field Type is hidden
+  - Add security warning banner when hardcoded values are used
+- Extract runtime secret display logic into separate components (RuntimeSecretFieldDisplay, ParameterFieldDisplay)
+- Extract field header (icon, label, delete button) into FieldHeader component
+- Implement reusable hooks for function notes (useGetFunctionNote) and execution validation (useExecutionValidation)
+- Create FunctionNoteSection and RuntimeSecretButton components for modular form customization
+- Add runtimeSecretExtractor utility for clean credential handling during transaction execution
+- Support hardcoded readonly runtime secrets with proper field extraction
+- Implement FunctionDecorationsService in adapter-midnight for organizer-only circuit detection
+- Fix private state overlay to handle provider storage misses gracefully
+- Update transaction execution flow to pass both relayer API keys and adapter-specific secrets

.changeset/utils-bytes-size-helper.md

@@ -0,0 +1,5 @@
+---
+'@openzeppelin/ui-builder-utils': minor
+---
+
+Add `getBytesSize` utility function to extract size from `Bytes<N>` type strings. This function parses type strings like "Bytes<32>" and returns the size as a number, or undefined for dynamic types like "Uint8Array". Useful for validating fixed-size byte arrays in adapters.

.eslint/rules/no-extra-adapter-methods.cjs

@@ -37,6 +37,9 @@ module.exports = {
     const interfaceMethods = [
       'networkConfig',
       'initialAppServiceKitName',
+      'getNetworkServiceForms',
+      'validateNetworkServiceConfig',
+      'testNetworkServiceConnection',
       'loadContract',
       'loadContractWithMetadata',
       'getWritableFunctions',
@@ -70,6 +73,8 @@ module.exports = {
       'getExportableWalletConfigFiles',
       'getSupportedContractDefinitionProviders',
       'getContractDefinitionInputs',
+      'getRuntimeFieldBinding',
+      'getFunctionDecorations',
       'getRelayers',
       'getRelayer',
       'getRelayerOptionsComponent',
@@ -80,6 +85,9 @@ module.exports = {
       'compareContractDefinitions',
       'validateContractDefinition',
       'hashContractDefinition',
+      'getExportBootstrapFiles',
+      'getArtifactPersistencePolicy',
+      'prepareArtifactsForFunction',
     ];
 
     // Common standard methods and properties that are allowed

.eslintignore

@@ -0,0 +1,16 @@
+node_modules/
+dist/
+build/
+out/
+coverage/
+*.min.js
+.next/
+.nuxt/
+.output/
+.cache/
+.turbo/
+.vercel/
+.netlify/
+exports/
+packages/builder/test-results/
+

.gitignore

@@ -10,6 +10,8 @@ yarn.lock
 # pnpm-lock.yaml - uncomment if using npm or yarn instead of pnpm
 # pnpm-lock.yaml
 .pnpm-debug.log*
+.pnpm-store/
+.packed-packages/
 
 # Build outputs
 dist/
@@ -27,6 +29,11 @@ packages/builder/test-results/
 # Test exports
 exports/
 
+# Generated patches in packages
+# Source of truth is root patches/ directory
+# These are generated by scripts/sync-patches-to-adapters.js
+packages/*/patches/
+
 # Environment variables
 .env
 .env.local

.prettierignore

@@ -1,3 +1,19 @@
+node_modules/
+dist/
+build/
+out/
+coverage/
+exports/
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+.next/
+.nuxt/
+.output/
+.cache/
+.turbo/
+.vercel/
+.netlify/
 # Build outputs
 dist/
 build/

Dockerfile

@@ -49,10 +49,10 @@ RUN pnpm install --frozen-lockfile || (echo "Install failed, clearing caches and
 RUN --mount=type=secret,id=etherscan_api_key \
     sh -c 'if [ -f /run/secrets/etherscan_api_key ]; then \
         export VITE_APP_CFG_SERVICE_ETHERSCANV2_API_KEY=$(cat /run/secrets/etherscan_api_key) && \
-        NODE_OPTIONS="--max-old-space-size=8192" pnpm -r build; \
+        pnpm build; \
     else \
         echo "Warning: Building without Etherscan API key" && \
-        NODE_OPTIONS="--max-old-space-size=8192" pnpm -r build; \
+        pnpm build; \
     fi'
 
 # Runtime stage - using a slim image for a smaller footprint