@openzeppelin/ui-builder-adapter-evm 1.5.0 → 1.6.0

package/dist/index.d.cts

@@ -1,8 +1,230 @@
-import { TransactionReceipt } from 'viem';
-import React from 'react';
-import { TypedEvmNetworkConfig, WriteContractParameters, EvmContractDefinitionProviderKey } from '@openzeppelin/ui-builder-adapter-evm-core';
-export { AppInfo, EvmContractArtifacts, EvmRelayerTransactionOptions, RainbowKitConnectButtonProps, RainbowKitCustomizations, RainbowKitKitConfig, RainbowKitProviderProps, TypedEvmNetworkConfig, WriteContractParameters, abiComparisonService, extractRainbowKitCustomizations, isEvmContractArtifacts, isRainbowKitCustomizations } from '@openzeppelin/ui-builder-adapter-evm-core';
-import { WalletConnectionStatus, ContractAdapter, UiKitConfiguration, NetworkServiceForm, ContractSchema, ProxyInfo, FieldType, FunctionParameter, FormFieldType, ExecutionConfig, TxStatus, TransactionStatusUpdate, RelayerDetails, RelayerDetailsRich, ExecutionMethodDetail, ContractFunction, Connector, NativeConfigLoader, EcosystemReactUiProviderProps, EcosystemSpecificReactHooks, EcosystemWalletComponents, AvailableUiKit, UserRpcProviderConfig, UserExplorerConfig, TypeMappingInfo, AdapterConfig } from '@openzeppelin/ui-types';
+import { EvmNetworkConfig, WalletConnectionStatus, ContractAdapter, UiKitConfiguration, NetworkServiceForm, ContractSchema, ProxyInfo, FieldType, FunctionParameter, FormFieldType, ExecutionConfig, TxStatus, TransactionStatusUpdate, RelayerDetails, RelayerDetailsRich, ExecutionMethodDetail, ContractFunction, Connector, NativeConfigLoader, EcosystemReactUiProviderProps, EcosystemSpecificReactHooks, EcosystemWalletComponents, AvailableUiKit, UserRpcProviderConfig, UserExplorerConfig, AccessControlService, TypeMappingInfo, EcosystemExport } from '@openzeppelin/ui-types';
+export { ecosystemMetadata } from './metadata.cjs';
+import { Chain, Abi, TransactionReceipt } from 'viem';
+import React__default from 'react';
+import { Speed } from '@openzeppelin/relayer-sdk';
+import { RainbowKitProvider, ConnectButton } from '@rainbow-me/rainbowkit';
+
+/**
+ * Defines the structure for parameters required to execute a contract write operation via viem.
+ */
+interface WriteContractParameters {
+    address: `0x${string}`;
+    abi: Abi;
+    functionName: string;
+    args: unknown[];
+    value?: bigint;
+}
+/**
+ * EVM-specific network configuration with strict `ecosystem: 'evm'` constraint
+ * and strongly-typed viem `Chain` (narrowed from `unknown` in `EvmNetworkConfig`).
+ *
+ * Use this type in EVM-only contexts where you want strict ecosystem typing.
+ * For function signatures that should accept configs from multiple adapters
+ * (EVM, Polkadot, etc.), use `EvmCompatibleNetworkConfig` instead.
+ */
+interface TypedEvmNetworkConfig extends EvmNetworkConfig {
+    viemChain?: Chain;
+}
+
+/**
+ * EVM Contract Definition Provider keys and ordering
+ * Avoid magic strings by using typed constants and a union type.
+ */
+declare const EvmProviderKeys: {
+    readonly Etherscan: "etherscan";
+    readonly Sourcify: "sourcify";
+};
+type EvmContractDefinitionProviderKey = (typeof EvmProviderKeys)[keyof typeof EvmProviderKeys];
+
+/**
+ * EVM-specific contract artifacts interface
+ * Defines the structure of data needed to load EVM contracts
+ */
+
+interface EvmContractArtifacts {
+    /** The deployed contract address (required) */
+    contractAddress: string;
+    /** Optional manual ABI JSON string (for unverified contracts) */
+    contractDefinition?: string;
+    /** Optional proxy detection configuration */
+    __proxyDetectionOptions?: {
+        /** Skip automatic proxy detection */
+        skipProxyDetection?: boolean;
+    };
+    /** Optional forced provider for this load attempt (session-scoped override) */
+    __forcedProvider?: EvmContractDefinitionProviderKey;
+}
+/**
+ * Type guard to check if an object matches EvmContractArtifacts structure
+ */
+declare function isEvmContractArtifacts(obj: unknown): obj is EvmContractArtifacts;
+
+/**
+ * EVM-specific ABI types for comparison and validation
+ * Uses viem's Abi type as the foundation for type safety
+ */
+
+/**
+ * Result of comparing two ABIs
+ */
+interface AbiComparisonResult {
+    /** Whether the ABIs are identical after normalization */
+    identical: boolean;
+    /** List of differences found between the ABIs */
+    differences: AbiDifference[];
+    /** Overall severity of the changes */
+    severity: 'none' | 'minor' | 'major' | 'breaking';
+    /** Human-readable summary of the comparison */
+    summary: string;
+}
+/**
+ * Represents a single difference between two ABIs
+ */
+interface AbiDifference {
+    /** Type of change */
+    type: 'added' | 'removed' | 'modified';
+    /** Which section of the ABI was affected */
+    section: 'function' | 'event' | 'constructor' | 'error' | 'fallback' | 'receive';
+    /** Name of the affected item (or type if no name) */
+    name: string;
+    /** Detailed description of the change */
+    details: string;
+    /** Impact level of this change */
+    impact: 'low' | 'medium' | 'high';
+    /** Signature before the change (for removed/modified) */
+    oldSignature?: string;
+    /** Signature after the change (for added/modified) */
+    newSignature?: string;
+}
+/**
+ * Result of validating an ABI structure
+ */
+interface AbiValidationResult {
+    /** Whether the ABI is structurally valid */
+    valid: boolean;
+    /** List of validation errors found */
+    errors: string[];
+    /** List of validation warnings */
+    warnings: string[];
+    /** Normalized ABI if validation passed */
+    normalizedAbi?: Abi;
+}
+
+/**
+ * ABI comparison service for EVM contracts
+ * Provides detailed analysis of differences between ABIs
+ */
+
+/**
+ * Service for comparing and validating EVM ABIs
+ */
+declare class AbiComparisonService {
+    /**
+     * Compares two ABIs and returns detailed difference analysis
+     */
+    compareAbis(abi1: string, abi2: string): AbiComparisonResult;
+    /**
+     * Validates ABI structure and format
+     */
+    validateAbi(abiString: string): AbiValidationResult;
+    /**
+     * Creates deterministic hash of ABI for quick comparison
+     */
+    hashAbi(abiString: string): string;
+    /**
+     * Normalizes ABI for consistent comparison
+     */
+    private normalizeAbi;
+    /**
+     * Finds detailed differences between two normalized ABIs
+     */
+    private findDifferences;
+    private createAbiMap;
+    private generateItemKey;
+    private generateSignature;
+    private itemsEqual;
+    private calculateImpact;
+    private calculateSeverity;
+    private generateSummary;
+}
+declare const abiComparisonService: AbiComparisonService;
+
+/**
+ * Relayer Execution Strategy
+ *
+ * Implements transaction execution through the OpenZeppelin Relayer service.
+ * This strategy sends transactions to a relayer for gas sponsorship and broadcasting.
+ */
+
+/**
+ * EVM-specific transaction options for the OpenZeppelin Relayer.
+ * These options map directly to the EvmTransactionRequest parameters in the SDK.
+ */
+interface EvmRelayerTransactionOptions {
+    speed?: Speed;
+    gasLimit?: number;
+    gasPrice?: number;
+    maxFeePerGas?: number;
+    maxPriorityFeePerGas?: number;
+    validUntil?: string;
+}
+
+/**
+ * Custom RainbowKit configuration types for enhanced UI control
+ */
+/**
+ * Re-export RainbowKit's native types for ConnectButton props
+ * This ensures we use the exact same types that RainbowKit expects,
+ * reducing maintenance burden and letting RainbowKit handle type validation
+ */
+
+/**
+ * Extract the `AppInfo` type from the RainbowKitProvider's props.
+ * This is the canonical way to get the type for the `appInfo` object.
+ */
+type AppInfo = React.ComponentProps<typeof RainbowKitProvider>['appInfo'];
+/**
+ * Extract the props type from RainbowKit's ConnectButton component
+ * This gives us the exact same types that RainbowKit uses internally
+ */
+type RainbowKitConnectButtonProps$1 = React.ComponentProps<typeof ConnectButton>;
+/**
+ * Represents the props expected by the RainbowKitProvider component.
+ * It uses a nested `appInfo` object.
+ */
+interface RainbowKitProviderProps {
+    appInfo?: AppInfo;
+    [key: string]: unknown;
+}
+/**
+ * Represents the shape of the `kitConfig` object we use internally when the
+ * selected kit is RainbowKit. It has a flat structure for `appName` and `learnMoreUrl`
+ * for easier handling in our builder app, and can also contain pre-existing providerProps.
+ */
+type RainbowKitKitConfig = Partial<AppInfo> & {
+    providerProps?: RainbowKitProviderProps;
+    [key: string]: unknown;
+};
+/**
+ * Custom UI configuration that uses RainbowKit's native types
+ * This extends our configuration system while leveraging RainbowKit's own type definitions
+ */
+interface RainbowKitCustomizations {
+    /**
+     * Configuration for the RainbowKit ConnectButton component
+     * Uses RainbowKit's native prop types for type safety and compatibility
+     */
+    connectButton?: Partial<RainbowKitConnectButtonProps$1>;
+}
+/**
+ * Type guard to check if an object contains RainbowKit customizations
+ */
+declare function isRainbowKitCustomizations(obj: unknown): obj is RainbowKitCustomizations;
+/**
+ * Utility to extract RainbowKit customizations from a kit config
+ */
+declare function extractRainbowKitCustomizations(kitConfig: Record<string, unknown> | undefined): RainbowKitCustomizations | undefined;
 
 /**
  * EVM-specific wallet connection status extending the base interface.
@@ -25,6 +247,12 @@ interface EvmWalletConnectionStatus extends WalletConnectionStatus {
 declare class EvmAdapter implements ContractAdapter {
     readonly networkConfig: TypedEvmNetworkConfig;
     readonly initialAppServiceKitName: UiKitConfiguration['kitName'];
+    /**
+     * Lazily initialized access control service (NFR-004).
+     * Created on the first call to `getAccessControlService()` to avoid
+     * unnecessary initialization overhead when access control is not used.
+     */
+    private accessControlService;
     constructor(networkConfig: TypedEvmNetworkConfig);
     /**
      * @inheritdoc
@@ -100,7 +328,7 @@ declare class EvmAdapter implements ContractAdapter {
      * Returns a React component for configuring EVM-specific relayer transaction options.
      * @returns The EVM relayer options component
      */
-    getRelayerOptionsComponent(): React.ComponentType<{
+    getRelayerOptionsComponent(): React__default.ComponentType<{
         options: Record<string, unknown>;
         onChange: (options: Record<string, unknown>) => void;
     }> | undefined;
@@ -196,7 +424,7 @@ declare class EvmAdapter implements ContractAdapter {
     /**
      * @inheritdoc
      */
-    getEcosystemReactUiContextProvider(): React.ComponentType<EcosystemReactUiProviderProps> | undefined;
+    getEcosystemReactUiContextProvider(): React__default.ComponentType<EcosystemReactUiProviderProps> | undefined;
     /**
      * @inheritdoc
      */
@@ -275,6 +503,18 @@ declare class EvmAdapter implements ContractAdapter {
      * @inheritdoc
      */
     hashContractDefinition(definition: string): string;
+    /**
+     * @inheritdoc
+     *
+     * Returns a lazily initialized `EvmAccessControlService` instance.
+     * The service is created on first call with an `executeTransaction` callback
+     * that wraps `signAndBroadcast`, decoupling the access control module from
+     * wallet/signing infrastructure.
+     *
+     * @returns The AccessControlService for this adapter's network
+     * @see research.md §R9 — Service Lifecycle and Transaction Execution
+     */
+    getAccessControlService(): AccessControlService;
     /**
      * @inheritdoc
      */
@@ -305,18 +545,6 @@ declare const zksyncSepoliaTestnet: TypedEvmNetworkConfig;
 declare const scrollSepolia: TypedEvmNetworkConfig;
 declare const lineaSepolia: TypedEvmNetworkConfig;
 
-declare const evmMainnetNetworks: TypedEvmNetworkConfig[];
-declare const evmTestnetNetworks: TypedEvmNetworkConfig[];
-declare const evmNetworks: TypedEvmNetworkConfig[];
-
-/**
- * Configuration for the EVM adapter
- *
- * This file defines the dependencies required by the EVM adapter
- * when generating exported projects. It follows the AdapterConfig
- * interface to provide a structured approach to dependency management.
- */
-
-declare const evmAdapterConfig: AdapterConfig;
+declare const ecosystemDefinition: EcosystemExport;
 
-export { EvmAdapter, arbitrumMainnet, arbitrumSepolia, avalancheFuji, avalancheMainnet, baseMainnet, baseSepolia, bscMainnet, bscTestnet, ethereumMainnet, ethereumSepolia, evmAdapterConfig, evmMainnetNetworks, evmNetworks, evmTestnetNetworks, lineaMainnet, lineaSepolia, optimismMainnet, optimismSepolia, polygonAmoy, polygonMainnet, polygonZkEvmCardona, polygonZkEvmMainnet, scrollMainnet, scrollSepolia, zkSyncEraMainnet, zksyncSepoliaTestnet };
+export { type AppInfo, EvmAdapter, type EvmContractArtifacts, type EvmRelayerTransactionOptions, type RainbowKitConnectButtonProps$1 as RainbowKitConnectButtonProps, type RainbowKitCustomizations, type RainbowKitKitConfig, type RainbowKitProviderProps, type TypedEvmNetworkConfig, type WriteContractParameters, abiComparisonService, arbitrumMainnet, arbitrumSepolia, avalancheFuji, avalancheMainnet, baseMainnet, baseSepolia, bscMainnet, bscTestnet, ecosystemDefinition, ethereumMainnet, ethereumSepolia, extractRainbowKitCustomizations, isEvmContractArtifacts, isRainbowKitCustomizations, lineaMainnet, lineaSepolia, optimismMainnet, optimismSepolia, polygonAmoy, polygonMainnet, polygonZkEvmCardona, polygonZkEvmMainnet, scrollMainnet, scrollSepolia, zkSyncEraMainnet, zksyncSepoliaTestnet };

package/dist/index.d.ts

@@ -1,8 +1,230 @@
-import { TransactionReceipt } from 'viem';
-import React from 'react';
-import { TypedEvmNetworkConfig, WriteContractParameters, EvmContractDefinitionProviderKey } from '@openzeppelin/ui-builder-adapter-evm-core';
-export { AppInfo, EvmContractArtifacts, EvmRelayerTransactionOptions, RainbowKitConnectButtonProps, RainbowKitCustomizations, RainbowKitKitConfig, RainbowKitProviderProps, TypedEvmNetworkConfig, WriteContractParameters, abiComparisonService, extractRainbowKitCustomizations, isEvmContractArtifacts, isRainbowKitCustomizations } from '@openzeppelin/ui-builder-adapter-evm-core';
-import { WalletConnectionStatus, ContractAdapter, UiKitConfiguration, NetworkServiceForm, ContractSchema, ProxyInfo, FieldType, FunctionParameter, FormFieldType, ExecutionConfig, TxStatus, TransactionStatusUpdate, RelayerDetails, RelayerDetailsRich, ExecutionMethodDetail, ContractFunction, Connector, NativeConfigLoader, EcosystemReactUiProviderProps, EcosystemSpecificReactHooks, EcosystemWalletComponents, AvailableUiKit, UserRpcProviderConfig, UserExplorerConfig, TypeMappingInfo, AdapterConfig } from '@openzeppelin/ui-types';
+import { EvmNetworkConfig, WalletConnectionStatus, ContractAdapter, UiKitConfiguration, NetworkServiceForm, ContractSchema, ProxyInfo, FieldType, FunctionParameter, FormFieldType, ExecutionConfig, TxStatus, TransactionStatusUpdate, RelayerDetails, RelayerDetailsRich, ExecutionMethodDetail, ContractFunction, Connector, NativeConfigLoader, EcosystemReactUiProviderProps, EcosystemSpecificReactHooks, EcosystemWalletComponents, AvailableUiKit, UserRpcProviderConfig, UserExplorerConfig, AccessControlService, TypeMappingInfo, EcosystemExport } from '@openzeppelin/ui-types';
+export { ecosystemMetadata } from './metadata.js';
+import { Chain, Abi, TransactionReceipt } from 'viem';
+import React__default from 'react';
+import { Speed } from '@openzeppelin/relayer-sdk';
+import { RainbowKitProvider, ConnectButton } from '@rainbow-me/rainbowkit';
+
+/**
+ * Defines the structure for parameters required to execute a contract write operation via viem.
+ */
+interface WriteContractParameters {
+    address: `0x${string}`;
+    abi: Abi;
+    functionName: string;
+    args: unknown[];
+    value?: bigint;
+}
+/**
+ * EVM-specific network configuration with strict `ecosystem: 'evm'` constraint
+ * and strongly-typed viem `Chain` (narrowed from `unknown` in `EvmNetworkConfig`).
+ *
+ * Use this type in EVM-only contexts where you want strict ecosystem typing.
+ * For function signatures that should accept configs from multiple adapters
+ * (EVM, Polkadot, etc.), use `EvmCompatibleNetworkConfig` instead.
+ */
+interface TypedEvmNetworkConfig extends EvmNetworkConfig {
+    viemChain?: Chain;
+}
+
+/**
+ * EVM Contract Definition Provider keys and ordering
+ * Avoid magic strings by using typed constants and a union type.
+ */
+declare const EvmProviderKeys: {
+    readonly Etherscan: "etherscan";
+    readonly Sourcify: "sourcify";
+};
+type EvmContractDefinitionProviderKey = (typeof EvmProviderKeys)[keyof typeof EvmProviderKeys];
+
+/**
+ * EVM-specific contract artifacts interface
+ * Defines the structure of data needed to load EVM contracts
+ */
+
+interface EvmContractArtifacts {
+    /** The deployed contract address (required) */
+    contractAddress: string;
+    /** Optional manual ABI JSON string (for unverified contracts) */
+    contractDefinition?: string;
+    /** Optional proxy detection configuration */
+    __proxyDetectionOptions?: {
+        /** Skip automatic proxy detection */
+        skipProxyDetection?: boolean;
+    };
+    /** Optional forced provider for this load attempt (session-scoped override) */
+    __forcedProvider?: EvmContractDefinitionProviderKey;
+}
+/**
+ * Type guard to check if an object matches EvmContractArtifacts structure
+ */
+declare function isEvmContractArtifacts(obj: unknown): obj is EvmContractArtifacts;
+
+/**
+ * EVM-specific ABI types for comparison and validation
+ * Uses viem's Abi type as the foundation for type safety
+ */
+
+/**
+ * Result of comparing two ABIs
+ */
+interface AbiComparisonResult {
+    /** Whether the ABIs are identical after normalization */
+    identical: boolean;
+    /** List of differences found between the ABIs */
+    differences: AbiDifference[];
+    /** Overall severity of the changes */
+    severity: 'none' | 'minor' | 'major' | 'breaking';
+    /** Human-readable summary of the comparison */
+    summary: string;
+}
+/**
+ * Represents a single difference between two ABIs
+ */
+interface AbiDifference {
+    /** Type of change */
+    type: 'added' | 'removed' | 'modified';
+    /** Which section of the ABI was affected */
+    section: 'function' | 'event' | 'constructor' | 'error' | 'fallback' | 'receive';
+    /** Name of the affected item (or type if no name) */
+    name: string;
+    /** Detailed description of the change */
+    details: string;
+    /** Impact level of this change */
+    impact: 'low' | 'medium' | 'high';
+    /** Signature before the change (for removed/modified) */
+    oldSignature?: string;
+    /** Signature after the change (for added/modified) */
+    newSignature?: string;
+}
+/**
+ * Result of validating an ABI structure
+ */
+interface AbiValidationResult {
+    /** Whether the ABI is structurally valid */
+    valid: boolean;
+    /** List of validation errors found */
+    errors: string[];
+    /** List of validation warnings */
+    warnings: string[];
+    /** Normalized ABI if validation passed */
+    normalizedAbi?: Abi;
+}
+
+/**
+ * ABI comparison service for EVM contracts
+ * Provides detailed analysis of differences between ABIs
+ */
+
+/**
+ * Service for comparing and validating EVM ABIs
+ */
+declare class AbiComparisonService {
+    /**
+     * Compares two ABIs and returns detailed difference analysis
+     */
+    compareAbis(abi1: string, abi2: string): AbiComparisonResult;
+    /**
+     * Validates ABI structure and format
+     */
+    validateAbi(abiString: string): AbiValidationResult;
+    /**
+     * Creates deterministic hash of ABI for quick comparison
+     */
+    hashAbi(abiString: string): string;
+    /**
+     * Normalizes ABI for consistent comparison
+     */
+    private normalizeAbi;
+    /**
+     * Finds detailed differences between two normalized ABIs
+     */
+    private findDifferences;
+    private createAbiMap;
+    private generateItemKey;
+    private generateSignature;
+    private itemsEqual;
+    private calculateImpact;
+    private calculateSeverity;
+    private generateSummary;
+}
+declare const abiComparisonService: AbiComparisonService;
+
+/**
+ * Relayer Execution Strategy
+ *
+ * Implements transaction execution through the OpenZeppelin Relayer service.
+ * This strategy sends transactions to a relayer for gas sponsorship and broadcasting.
+ */
+
+/**
+ * EVM-specific transaction options for the OpenZeppelin Relayer.
+ * These options map directly to the EvmTransactionRequest parameters in the SDK.
+ */
+interface EvmRelayerTransactionOptions {
+    speed?: Speed;
+    gasLimit?: number;
+    gasPrice?: number;
+    maxFeePerGas?: number;
+    maxPriorityFeePerGas?: number;
+    validUntil?: string;
+}
+
+/**
+ * Custom RainbowKit configuration types for enhanced UI control
+ */
+/**
+ * Re-export RainbowKit's native types for ConnectButton props
+ * This ensures we use the exact same types that RainbowKit expects,
+ * reducing maintenance burden and letting RainbowKit handle type validation
+ */
+
+/**
+ * Extract the `AppInfo` type from the RainbowKitProvider's props.
+ * This is the canonical way to get the type for the `appInfo` object.
+ */
+type AppInfo = React.ComponentProps<typeof RainbowKitProvider>['appInfo'];
+/**
+ * Extract the props type from RainbowKit's ConnectButton component
+ * This gives us the exact same types that RainbowKit uses internally
+ */
+type RainbowKitConnectButtonProps$1 = React.ComponentProps<typeof ConnectButton>;
+/**
+ * Represents the props expected by the RainbowKitProvider component.
+ * It uses a nested `appInfo` object.
+ */
+interface RainbowKitProviderProps {
+    appInfo?: AppInfo;
+    [key: string]: unknown;
+}
+/**
+ * Represents the shape of the `kitConfig` object we use internally when the
+ * selected kit is RainbowKit. It has a flat structure for `appName` and `learnMoreUrl`
+ * for easier handling in our builder app, and can also contain pre-existing providerProps.
+ */
+type RainbowKitKitConfig = Partial<AppInfo> & {
+    providerProps?: RainbowKitProviderProps;
+    [key: string]: unknown;
+};
+/**
+ * Custom UI configuration that uses RainbowKit's native types
+ * This extends our configuration system while leveraging RainbowKit's own type definitions
+ */
+interface RainbowKitCustomizations {
+    /**
+     * Configuration for the RainbowKit ConnectButton component
+     * Uses RainbowKit's native prop types for type safety and compatibility
+     */
+    connectButton?: Partial<RainbowKitConnectButtonProps$1>;
+}
+/**
+ * Type guard to check if an object contains RainbowKit customizations
+ */
+declare function isRainbowKitCustomizations(obj: unknown): obj is RainbowKitCustomizations;
+/**
+ * Utility to extract RainbowKit customizations from a kit config
+ */
+declare function extractRainbowKitCustomizations(kitConfig: Record<string, unknown> | undefined): RainbowKitCustomizations | undefined;
 
 /**
  * EVM-specific wallet connection status extending the base interface.
@@ -25,6 +247,12 @@ interface EvmWalletConnectionStatus extends WalletConnectionStatus {
 declare class EvmAdapter implements ContractAdapter {
     readonly networkConfig: TypedEvmNetworkConfig;
     readonly initialAppServiceKitName: UiKitConfiguration['kitName'];
+    /**
+     * Lazily initialized access control service (NFR-004).
+     * Created on the first call to `getAccessControlService()` to avoid
+     * unnecessary initialization overhead when access control is not used.
+     */
+    private accessControlService;
     constructor(networkConfig: TypedEvmNetworkConfig);
     /**
      * @inheritdoc
@@ -100,7 +328,7 @@ declare class EvmAdapter implements ContractAdapter {
      * Returns a React component for configuring EVM-specific relayer transaction options.
      * @returns The EVM relayer options component
      */
-    getRelayerOptionsComponent(): React.ComponentType<{
+    getRelayerOptionsComponent(): React__default.ComponentType<{
         options: Record<string, unknown>;
         onChange: (options: Record<string, unknown>) => void;
     }> | undefined;
@@ -196,7 +424,7 @@ declare class EvmAdapter implements ContractAdapter {
     /**
      * @inheritdoc
      */
-    getEcosystemReactUiContextProvider(): React.ComponentType<EcosystemReactUiProviderProps> | undefined;
+    getEcosystemReactUiContextProvider(): React__default.ComponentType<EcosystemReactUiProviderProps> | undefined;
     /**
      * @inheritdoc
      */
@@ -275,6 +503,18 @@ declare class EvmAdapter implements ContractAdapter {
      * @inheritdoc
      */
     hashContractDefinition(definition: string): string;
+    /**
+     * @inheritdoc
+     *
+     * Returns a lazily initialized `EvmAccessControlService` instance.
+     * The service is created on first call with an `executeTransaction` callback
+     * that wraps `signAndBroadcast`, decoupling the access control module from
+     * wallet/signing infrastructure.
+     *
+     * @returns The AccessControlService for this adapter's network
+     * @see research.md §R9 — Service Lifecycle and Transaction Execution
+     */
+    getAccessControlService(): AccessControlService;
     /**
      * @inheritdoc
      */
@@ -305,18 +545,6 @@ declare const zksyncSepoliaTestnet: TypedEvmNetworkConfig;
 declare const scrollSepolia: TypedEvmNetworkConfig;
 declare const lineaSepolia: TypedEvmNetworkConfig;
 
-declare const evmMainnetNetworks: TypedEvmNetworkConfig[];
-declare const evmTestnetNetworks: TypedEvmNetworkConfig[];
-declare const evmNetworks: TypedEvmNetworkConfig[];
-
-/**
- * Configuration for the EVM adapter
- *
- * This file defines the dependencies required by the EVM adapter
- * when generating exported projects. It follows the AdapterConfig
- * interface to provide a structured approach to dependency management.
- */
-
-declare const evmAdapterConfig: AdapterConfig;
+declare const ecosystemDefinition: EcosystemExport;
 
-export { EvmAdapter, arbitrumMainnet, arbitrumSepolia, avalancheFuji, avalancheMainnet, baseMainnet, baseSepolia, bscMainnet, bscTestnet, ethereumMainnet, ethereumSepolia, evmAdapterConfig, evmMainnetNetworks, evmNetworks, evmTestnetNetworks, lineaMainnet, lineaSepolia, optimismMainnet, optimismSepolia, polygonAmoy, polygonMainnet, polygonZkEvmCardona, polygonZkEvmMainnet, scrollMainnet, scrollSepolia, zkSyncEraMainnet, zksyncSepoliaTestnet };
+export { type AppInfo, EvmAdapter, type EvmContractArtifacts, type EvmRelayerTransactionOptions, type RainbowKitConnectButtonProps$1 as RainbowKitConnectButtonProps, type RainbowKitCustomizations, type RainbowKitKitConfig, type RainbowKitProviderProps, type TypedEvmNetworkConfig, type WriteContractParameters, abiComparisonService, arbitrumMainnet, arbitrumSepolia, avalancheFuji, avalancheMainnet, baseMainnet, baseSepolia, bscMainnet, bscTestnet, ecosystemDefinition, ethereumMainnet, ethereumSepolia, extractRainbowKitCustomizations, isEvmContractArtifacts, isRainbowKitCustomizations, lineaMainnet, lineaSepolia, optimismMainnet, optimismSepolia, polygonAmoy, polygonMainnet, polygonZkEvmCardona, polygonZkEvmMainnet, scrollMainnet, scrollSepolia, zkSyncEraMainnet, zksyncSepoliaTestnet };