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

package/dist/index.d.cts

@@ -1,8 +1,11 @@
+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, AccessControlService, TypeMappingInfo, EcosystemExport } from '@openzeppelin/ui-types';
+export { ecosystemMetadata } from './metadata.cjs';
 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 React__default from 'react';
+import { T as TypedEvmNetworkConfig, W as WriteContractParameters, E as EvmContractDefinitionProviderKey } from './testnet-kBf1DKlb.cjs';
+export { A as AppInfo, a as EvmContractArtifacts, b as EvmRelayerTransactionOptions, R as RainbowKitConnectButtonProps, c as RainbowKitCustomizations, d as RainbowKitKitConfig, e as RainbowKitProviderProps, f as abiComparisonService, g as arbitrumMainnet, h as arbitrumSepolia, i as avalancheFuji, j as avalancheMainnet, k as baseMainnet, l as baseSepolia, m as bscMainnet, n as bscTestnet, o as ethereumMainnet, p as ethereumSepolia, q as extractRainbowKitCustomizations, r as isEvmContractArtifacts, s as isRainbowKitCustomizations, t as lineaMainnet, u as lineaSepolia, v as optimismMainnet, w as optimismSepolia, x as polygonAmoy, y as polygonMainnet, z as polygonZkEvmCardona, B as polygonZkEvmMainnet, C as scrollMainnet, D as scrollSepolia, F as zkSyncEraMainnet, G as zksyncSepoliaTestnet } from './testnet-kBf1DKlb.cjs';
+import '@openzeppelin/relayer-sdk';
+import '@rainbow-me/rainbowkit';
 
 /**
  * EVM-specific wallet connection status extending the base interface.
@@ -25,6 +28,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 +109,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 +205,7 @@ declare class EvmAdapter implements ContractAdapter {
     /**
      * @inheritdoc
      */
-    getEcosystemReactUiContextProvider(): React.ComponentType<EcosystemReactUiProviderProps> | undefined;
+    getEcosystemReactUiContextProvider(): React__default.ComponentType<EcosystemReactUiProviderProps> | undefined;
     /**
      * @inheritdoc
      */
@@ -275,48 +284,24 @@ 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
      */
     getTypeMappingInfo(): TypeMappingInfo;
 }
 
-declare const ethereumMainnet: TypedEvmNetworkConfig;
-declare const arbitrumMainnet: TypedEvmNetworkConfig;
-declare const polygonMainnet: TypedEvmNetworkConfig;
-declare const polygonZkEvmMainnet: TypedEvmNetworkConfig;
-declare const baseMainnet: TypedEvmNetworkConfig;
-declare const bscMainnet: TypedEvmNetworkConfig;
-declare const optimismMainnet: TypedEvmNetworkConfig;
-declare const avalancheMainnet: TypedEvmNetworkConfig;
-declare const zkSyncEraMainnet: TypedEvmNetworkConfig;
-declare const scrollMainnet: TypedEvmNetworkConfig;
-declare const lineaMainnet: TypedEvmNetworkConfig;
-
-declare const ethereumSepolia: TypedEvmNetworkConfig;
-declare const arbitrumSepolia: TypedEvmNetworkConfig;
-declare const polygonAmoy: TypedEvmNetworkConfig;
-declare const polygonZkEvmCardona: TypedEvmNetworkConfig;
-declare const baseSepolia: TypedEvmNetworkConfig;
-declare const bscTestnet: TypedEvmNetworkConfig;
-declare const optimismSepolia: TypedEvmNetworkConfig;
-declare const avalancheFuji: TypedEvmNetworkConfig;
-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 { EvmAdapter, TypedEvmNetworkConfig, WriteContractParameters, ecosystemDefinition };

package/dist/index.d.ts

@@ -1,8 +1,11 @@
+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, AccessControlService, TypeMappingInfo, EcosystemExport } from '@openzeppelin/ui-types';
+export { ecosystemMetadata } from './metadata.js';
 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 React__default from 'react';
+import { T as TypedEvmNetworkConfig, W as WriteContractParameters, E as EvmContractDefinitionProviderKey } from './testnet-kBf1DKlb.js';
+export { A as AppInfo, a as EvmContractArtifacts, b as EvmRelayerTransactionOptions, R as RainbowKitConnectButtonProps, c as RainbowKitCustomizations, d as RainbowKitKitConfig, e as RainbowKitProviderProps, f as abiComparisonService, g as arbitrumMainnet, h as arbitrumSepolia, i as avalancheFuji, j as avalancheMainnet, k as baseMainnet, l as baseSepolia, m as bscMainnet, n as bscTestnet, o as ethereumMainnet, p as ethereumSepolia, q as extractRainbowKitCustomizations, r as isEvmContractArtifacts, s as isRainbowKitCustomizations, t as lineaMainnet, u as lineaSepolia, v as optimismMainnet, w as optimismSepolia, x as polygonAmoy, y as polygonMainnet, z as polygonZkEvmCardona, B as polygonZkEvmMainnet, C as scrollMainnet, D as scrollSepolia, F as zkSyncEraMainnet, G as zksyncSepoliaTestnet } from './testnet-kBf1DKlb.js';
+import '@openzeppelin/relayer-sdk';
+import '@rainbow-me/rainbowkit';
 
 /**
  * EVM-specific wallet connection status extending the base interface.
@@ -25,6 +28,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 +109,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 +205,7 @@ declare class EvmAdapter implements ContractAdapter {
     /**
      * @inheritdoc
      */
-    getEcosystemReactUiContextProvider(): React.ComponentType<EcosystemReactUiProviderProps> | undefined;
+    getEcosystemReactUiContextProvider(): React__default.ComponentType<EcosystemReactUiProviderProps> | undefined;
     /**
      * @inheritdoc
      */
@@ -275,48 +284,24 @@ 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
      */
     getTypeMappingInfo(): TypeMappingInfo;
 }
 
-declare const ethereumMainnet: TypedEvmNetworkConfig;
-declare const arbitrumMainnet: TypedEvmNetworkConfig;
-declare const polygonMainnet: TypedEvmNetworkConfig;
-declare const polygonZkEvmMainnet: TypedEvmNetworkConfig;
-declare const baseMainnet: TypedEvmNetworkConfig;
-declare const bscMainnet: TypedEvmNetworkConfig;
-declare const optimismMainnet: TypedEvmNetworkConfig;
-declare const avalancheMainnet: TypedEvmNetworkConfig;
-declare const zkSyncEraMainnet: TypedEvmNetworkConfig;
-declare const scrollMainnet: TypedEvmNetworkConfig;
-declare const lineaMainnet: TypedEvmNetworkConfig;
-
-declare const ethereumSepolia: TypedEvmNetworkConfig;
-declare const arbitrumSepolia: TypedEvmNetworkConfig;
-declare const polygonAmoy: TypedEvmNetworkConfig;
-declare const polygonZkEvmCardona: TypedEvmNetworkConfig;
-declare const baseSepolia: TypedEvmNetworkConfig;
-declare const bscTestnet: TypedEvmNetworkConfig;
-declare const optimismSepolia: TypedEvmNetworkConfig;
-declare const avalancheFuji: TypedEvmNetworkConfig;
-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 { EvmAdapter, TypedEvmNetworkConfig, WriteContractParameters, ecosystemDefinition };