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

package/dist/index.d.cts

@@ -1,5 +1,6 @@
+import { WalletConnectionStatus, ContractAdapter, StellarNetworkConfig, UiKitConfiguration, NetworkServiceForm, FormFieldType, ContractSchema, FieldType, FunctionParameter, ExecutionConfig, TxStatus, TransactionStatusUpdate, ContractFunction, Connector, ExecutionMethodDetail, AvailableUiKit, NativeConfigLoader, EcosystemWalletComponents, EcosystemReactUiProviderProps, EcosystemSpecificReactHooks, RelayerDetails, RelayerDetailsRich, UserRpcProviderConfig, AccessControlService, TypeMappingInfo, EcosystemExport } from '@openzeppelin/ui-types';
+export { ecosystemMetadata } from './metadata.cjs';
 import React from 'react';
-import { WalletConnectionStatus, ContractAdapter, StellarNetworkConfig, UiKitConfiguration, NetworkServiceForm, FormFieldType, ContractSchema, FieldType, FunctionParameter, ExecutionConfig, TxStatus, TransactionStatusUpdate, ContractFunction, Connector, ExecutionMethodDetail, AvailableUiKit, NativeConfigLoader, EcosystemWalletComponents, EcosystemReactUiProviderProps, EcosystemSpecificReactHooks, RelayerDetails, RelayerDetailsRich, UserRpcProviderConfig, AccessControlService, TypeMappingInfo, AdapterConfig } from '@openzeppelin/ui-types';
 
 /**
  * Stellar-specific wallet connection status extending the base interface.
@@ -253,18 +254,6 @@ declare const stellarPublic: StellarNetworkConfig;
 
 declare const stellarTestnet: StellarNetworkConfig;
 
-declare const stellarMainnetNetworks: StellarNetworkConfig[];
-declare const stellarTestnetNetworks: StellarNetworkConfig[];
-declare const stellarNetworks: StellarNetworkConfig[];
+declare const ecosystemDefinition: EcosystemExport;
 
-/**
- * Configuration for the Stellar adapter
- *
- * This file defines the dependencies required by the Stellar adapter
- * when generating exported projects. It follows the AdapterConfig
- * interface to provide a structured approach to dependency management.
- */
-
-declare const stellarAdapterConfig: AdapterConfig;
-
-export { StellarAdapter, type StellarContractArtifacts, isStellarContractArtifacts, stellarAdapterConfig, stellarMainnetNetworks, stellarNetworks, stellarPublic, stellarTestnet, stellarTestnetNetworks };
+export { StellarAdapter, type StellarContractArtifacts, ecosystemDefinition, isStellarContractArtifacts, stellarPublic, stellarTestnet };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
+import { WalletConnectionStatus, ContractAdapter, StellarNetworkConfig, UiKitConfiguration, NetworkServiceForm, FormFieldType, ContractSchema, FieldType, FunctionParameter, ExecutionConfig, TxStatus, TransactionStatusUpdate, ContractFunction, Connector, ExecutionMethodDetail, AvailableUiKit, NativeConfigLoader, EcosystemWalletComponents, EcosystemReactUiProviderProps, EcosystemSpecificReactHooks, RelayerDetails, RelayerDetailsRich, UserRpcProviderConfig, AccessControlService, TypeMappingInfo, EcosystemExport } from '@openzeppelin/ui-types';
+export { ecosystemMetadata } from './metadata.js';
 import React from 'react';
-import { WalletConnectionStatus, ContractAdapter, StellarNetworkConfig, UiKitConfiguration, NetworkServiceForm, FormFieldType, ContractSchema, FieldType, FunctionParameter, ExecutionConfig, TxStatus, TransactionStatusUpdate, ContractFunction, Connector, ExecutionMethodDetail, AvailableUiKit, NativeConfigLoader, EcosystemWalletComponents, EcosystemReactUiProviderProps, EcosystemSpecificReactHooks, RelayerDetails, RelayerDetailsRich, UserRpcProviderConfig, AccessControlService, TypeMappingInfo, AdapterConfig } from '@openzeppelin/ui-types';
 
 /**
  * Stellar-specific wallet connection status extending the base interface.
@@ -253,18 +254,6 @@ declare const stellarPublic: StellarNetworkConfig;
 
 declare const stellarTestnet: StellarNetworkConfig;
 
-declare const stellarMainnetNetworks: StellarNetworkConfig[];
-declare const stellarTestnetNetworks: StellarNetworkConfig[];
-declare const stellarNetworks: StellarNetworkConfig[];
+declare const ecosystemDefinition: EcosystemExport;
 
-/**
- * Configuration for the Stellar adapter
- *
- * This file defines the dependencies required by the Stellar adapter
- * when generating exported projects. It follows the AdapterConfig
- * interface to provide a structured approach to dependency management.
- */
-
-declare const stellarAdapterConfig: AdapterConfig;
-
-export { StellarAdapter, type StellarContractArtifacts, isStellarContractArtifacts, stellarAdapterConfig, stellarMainnetNetworks, stellarNetworks, stellarPublic, stellarTestnet, stellarTestnetNetworks };
+export { StellarAdapter, type StellarContractArtifacts, ecosystemDefinition, isStellarContractArtifacts, stellarPublic, stellarTestnet };

package/dist/index.js

@@ -3272,6 +3272,10 @@ function detectAccessControlCapabilities(contractSchema, indexerAvailable = fals
   if (!hasOwnable && !hasAccessControl) {
     notes.push("No OpenZeppelin access control interfaces detected");
   }
+  const hasRenounceOwnership = hasOwnable && functionNames.has("renounce_ownership");
+  const hasRenounceRole = false;
+  const hasCancelAdminTransfer = false;
+  const hasAdminDelayManagement = false;
   return {
     hasOwnable,
     hasTwoStepOwnable,
@@ -3280,7 +3284,11 @@ function detectAccessControlCapabilities(contractSchema, indexerAvailable = fals
     hasEnumerableRoles,
     supportsHistory,
     verifiedAgainstOZInterfaces,
-    notes: notes.length > 0 ? notes : void 0
+    notes: notes.length > 0 ? notes : void 0,
+    hasRenounceOwnership,
+    hasRenounceRole,
+    hasCancelAdminTransfer,
+    hasAdminDelayManagement
   };
 }
 function verifyOZInterface(functionNames, hasOwnable, hasAccessControl, hasTwoStepOwnable = false, hasTwoStepAdmin = false) {
@@ -4147,8 +4155,9 @@ var StellarIndexerClient = class {
       this.resolvedEndpoints = endpoints;
       return endpoints;
     }
-    if (this.networkConfig.indexerUri) {
-      endpoints.http = this.networkConfig.indexerUri;
+    const defaultHttpUrl = this.networkConfig.accessControlIndexerUrl ?? this.networkConfig.indexerUri;
+    if (defaultHttpUrl) {
+      endpoints.http = defaultHttpUrl;
       logger19.info(
         LOG_SYSTEM3,
         `Using network config indexer URI for ${networkId}: ${endpoints.http}`
@@ -4183,7 +4192,13 @@ var StellarIndexerClient = class {
       OWNERSHIP_RENOUNCED: "OWNERSHIP_RENOUNCED",
       ADMIN_TRANSFER_INITIATED: "ADMIN_TRANSFER_INITIATED",
       ADMIN_TRANSFER_COMPLETED: "ADMIN_TRANSFER_COMPLETED",
+      ADMIN_TRANSFER_CANCELED: "UNKNOWN",
+      // EVM-only event, not applicable to Stellar
       ADMIN_RENOUNCED: "ADMIN_RENOUNCED",
+      ADMIN_DELAY_CHANGE_SCHEDULED: "UNKNOWN",
+      // EVM-only event, not applicable to Stellar
+      ADMIN_DELAY_CHANGE_CANCELED: "UNKNOWN",
+      // EVM-only event, not applicable to Stellar
       UNKNOWN: "UNKNOWN"
     };
     return mapping[changeType];
@@ -4735,6 +4750,17 @@ var StellarAccessControlService = class {
       "StellarAccessControlService.getOwnership",
       `Reading ownership status for ${contractAddress}`
     );
+    const context = this.contractContexts.get(contractAddress);
+    if (context) {
+      const capabilities = detectAccessControlCapabilities(context.contractSchema);
+      if (!capabilities.hasOwnable) {
+        throw new OperationFailed3(
+          "Contract does not implement the Ownable interface \u2014 no get_owner() function available",
+          contractAddress,
+          "getOwnership"
+        );
+      }
+    }
     const basicOwnership = await readOwnership(contractAddress, this.networkConfig);
     if (basicOwnership.owner === null) {
       logger20.debug(
@@ -5027,6 +5053,25 @@ var StellarAccessControlService = class {
     logger20.info("StellarAccessControlService.revokeRole", `Role revoked. TxHash: ${result.txHash}`);
     return { id: result.txHash };
   }
+  // ── Expiration Metadata ────────────────────────────────────────────────
+  /**
+   * Get expiration metadata for a transfer type.
+   *
+   * Stellar semantics: Both ownership and admin transfers require a user-provided
+   * expiration ledger number.
+   *
+   * @param contractAddress - Contract address (validated but not used for Stellar)
+   * @param _transferType - 'ownership' or 'admin' (same semantics for both on Stellar)
+   * @returns Expiration metadata indicating required ledger number input
+   */
+  async getExpirationMetadata(contractAddress, _transferType) {
+    validateContractAddress(contractAddress);
+    return {
+      mode: "required",
+      label: "Expiration Ledger",
+      unit: "ledger number"
+    };
+  }
   /**
    * Transfers ownership of the contract using two-step transfer
    *
@@ -5180,6 +5225,17 @@ var StellarAccessControlService = class {
       "StellarAccessControlService.getAdminInfo",
       `Reading admin status for ${contractAddress}`
     );
+    const context = this.contractContexts.get(contractAddress);
+    if (context) {
+      const capabilities = detectAccessControlCapabilities(context.contractSchema);
+      if (!capabilities.hasTwoStepAdmin) {
+        throw new OperationFailed3(
+          "Contract does not implement the two-step admin interface \u2014 no get_admin() / accept_admin_transfer() functions available",
+          contractAddress,
+          "getAdminInfo"
+        );
+      }
+    }
     const currentAdmin = await getAdmin(contractAddress, this.networkConfig);
     if (currentAdmin === null) {
       logger20.debug(
@@ -5475,6 +5531,17 @@ var StellarAccessControlService = class {
       "StellarAccessControlService.getAdminAccount",
       `Reading admin for ${contractAddress}`
     );
+    const context = this.contractContexts.get(contractAddress);
+    if (context) {
+      const capabilities = detectAccessControlCapabilities(context.contractSchema);
+      if (!capabilities.hasTwoStepAdmin) {
+        throw new OperationFailed3(
+          "Contract does not implement the two-step admin interface \u2014 no get_admin() function available",
+          contractAddress,
+          "getAdminAccount"
+        );
+      }
+    }
     return getAdmin(contractAddress, this.networkConfig);
   }
   /**
@@ -8460,8 +8527,53 @@ var StellarAdapter = class {
   }
 };
 
-// src/networks/mainnet.ts
+// src/config.ts
+var stellarAdapterConfig = {
+  /**
+   * Dependencies required by the Stellar adapter
+   * These will be included in exported projects that use this adapter
+   */
+  dependencies: {
+    // Runtime dependencies
+    runtime: {
+      // Core Stellar libraries
+      "@stellar/stellar-sdk": "^14.1.1",
+      // SAC (Stellar Asset Contract) support - dynamically loaded from CDN
+      // These are needed for XDR encoding when working with SAC contracts
+      "@stellar/stellar-xdr-json": "^23.0.0",
+      "lossless-json": "^4.0.2",
+      // Wallet connection and integration
+      "@creit.tech/stellar-wallets-kit": "^1.9.5",
+      // OpenZeppelin Relayer integration for gasless transactions
+      "@openzeppelin/relayer-sdk": "1.9.0",
+      // React integration for wallet components
+      react: "^19.0.0",
+      "react-dom": "^19.0.0"
+    },
+    // Development dependencies
+    dev: {
+      "@types/react": "^19.0.0",
+      "@types/react-dom": "^19.0.0"
+    }
+  }
+};
+
+// src/metadata.ts
 import { NetworkStellar } from "@web3icons/react";
+var ecosystemMetadata = {
+  id: "stellar",
+  name: "Stellar",
+  description: "Stellar is a fast, energy-efficient blockchain network designed for real-world financial applications. It enables near-instant global payments at low cost, connects digital assets to traditional finance, and supports smart contracts through Soroban.",
+  explorerGuidance: "contract IDs on Stellar Expert",
+  addressExample: "GCKFBEIYV2U22IO2BJ4KVJOIP7XPWQGQFKKWXR6DOSJBV7STMAQSMTGG",
+  iconComponent: NetworkStellar,
+  bgColorClass: "bg-sky-100",
+  textColorClass: "text-sky-900",
+  defaultFeatureConfig: { enabled: true, showInUI: true }
+};
+
+// src/networks/mainnet.ts
+import { NetworkStellar as NetworkStellar2 } from "@web3icons/react";
 var stellarPublic = {
   id: "stellar-public",
   exportConstName: "stellarPublic",
@@ -8474,12 +8586,12 @@ var stellarPublic = {
   sorobanRpcUrl: "https://mainnet.sorobanrpc.com",
   networkPassphrase: "Public Global Stellar Network ; September 2015",
   explorerUrl: "https://stellar.expert/explorer/public",
-  iconComponent: NetworkStellar,
-  indexerUri: "https://openzeppelin-stellar-mainnet.graphql.subquery.network/"
+  iconComponent: NetworkStellar2,
+  accessControlIndexerUrl: "https://openzeppelin-stellar-mainnet.graphql.subquery.network/"
 };
 
 // src/networks/testnet.ts
-import { NetworkStellar as NetworkStellar2 } from "@web3icons/react";
+import { NetworkStellar as NetworkStellar3 } from "@web3icons/react";
 var stellarTestnet = {
   id: "stellar-testnet",
   exportConstName: "stellarTestnet",
@@ -8492,8 +8604,8 @@ var stellarTestnet = {
   sorobanRpcUrl: "https://soroban-testnet.stellar.org",
   networkPassphrase: "Test SDF Network ; September 2015",
   explorerUrl: "https://stellar.expert/explorer/testnet",
-  iconComponent: NetworkStellar2,
-  indexerUri: "https://openzepplin-stellar-testnet.graphql.subquery.network"
+  iconComponent: NetworkStellar3,
+  accessControlIndexerUrl: "https://openzepplin-stellar-testnet.graphql.subquery.network"
 };
 
 // src/networks/index.ts
@@ -8504,44 +8616,19 @@ var stellarNetworks = [
   ...stellarTestnetNetworks
 ];
 
-// src/config.ts
-var stellarAdapterConfig = {
-  /**
-   * Dependencies required by the Stellar adapter
-   * These will be included in exported projects that use this adapter
-   */
-  dependencies: {
-    // Runtime dependencies
-    runtime: {
-      // Core Stellar libraries
-      "@stellar/stellar-sdk": "^14.1.1",
-      // SAC (Stellar Asset Contract) support - dynamically loaded from CDN
-      // These are needed for XDR encoding when working with SAC contracts
-      "@stellar/stellar-xdr-json": "^23.0.0",
-      "lossless-json": "^4.0.2",
-      // Wallet connection and integration
-      "@creit.tech/stellar-wallets-kit": "^1.9.5",
-      // OpenZeppelin Relayer integration for gasless transactions
-      "@openzeppelin/relayer-sdk": "1.9.0",
-      // React integration for wallet components
-      react: "^19.0.0",
-      "react-dom": "^19.0.0"
-    },
-    // Development dependencies
-    dev: {
-      "@types/react": "^19.0.0",
-      "@types/react-dom": "^19.0.0"
-    }
-  }
+// src/index.ts
+var ecosystemDefinition = {
+  ...ecosystemMetadata,
+  networks: stellarNetworks,
+  createAdapter: (config) => new StellarAdapter(config),
+  adapterConfig: stellarAdapterConfig
 };
 export {
   StellarAdapter,
+  ecosystemDefinition,
+  ecosystemMetadata,
   isStellarContractArtifacts,
-  stellarAdapterConfig,
-  stellarMainnetNetworks,
-  stellarNetworks,
   stellarPublic,
-  stellarTestnet,
-  stellarTestnetNetworks
+  stellarTestnet
 };
 //# sourceMappingURL=index.js.map