@openzeppelin/ui-builder-adapter-stellar 1.4.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) {
@@ -3663,11 +3671,12 @@ var StellarIndexerClient = class {
       }
       const grantMap = /* @__PURE__ */ new Map();
       for (const entry of result.data.accessControlEvents.nodes) {
-        if (!grantMap.has(entry.account)) {
-          grantMap.set(entry.account, {
+        const account = entry.account || "";
+        if (account && !grantMap.has(account)) {
+          grantMap.set(account, {
             timestamp: entry.timestamp,
             txId: entry.txHash,
-            ledger: parseInt(entry.blockHeight, 10)
+            ledger: parseInt(entry.blockNumber, 10)
           });
         }
       }
@@ -3784,10 +3793,17 @@ var StellarIndexerClient = class {
         logger19.debug(LOG_SYSTEM3, `Ownership transfer was completed for ${contractAddress}`);
         return null;
       }
-      if (!latestInitiation.admin) {
+      if (!latestInitiation.previousOwner) {
         logger19.warn(
           LOG_SYSTEM3,
-          `Indexer returned OWNERSHIP_TRANSFER_STARTED event without admin field for ${contractAddress}. This indicates incomplete indexer data. Treating as no valid pending transfer.`
+          `Indexer returned OWNERSHIP_TRANSFER_STARTED event without previousOwner field for ${contractAddress}. This indicates incomplete indexer data. Treating as no valid pending transfer.`
+        );
+        return null;
+      }
+      if (!latestInitiation.newOwner) {
+        logger19.warn(
+          LOG_SYSTEM3,
+          `Indexer returned OWNERSHIP_TRANSFER_STARTED event without newOwner field for ${contractAddress}. This indicates incomplete indexer data. Treating as no valid pending transfer.`
         );
         return null;
       }
@@ -3800,14 +3816,14 @@ var StellarIndexerClient = class {
       }
       logger19.info(
         LOG_SYSTEM3,
-        `Found pending ownership transfer for ${contractAddress}: pending owner=${latestInitiation.account}, expires at ledger ${latestInitiation.liveUntilLedger}`
+        `Found pending ownership transfer for ${contractAddress}: pending owner=${latestInitiation.newOwner}, expires at ledger ${latestInitiation.liveUntilLedger}`
       );
       return {
-        previousOwner: latestInitiation.admin,
-        pendingOwner: latestInitiation.account,
+        previousOwner: latestInitiation.previousOwner,
+        pendingOwner: latestInitiation.newOwner,
         txHash: latestInitiation.txHash,
         timestamp: latestInitiation.timestamp,
-        ledger: parseInt(latestInitiation.ledger || latestInitiation.blockHeight, 10),
+        ledger: parseInt(latestInitiation.blockNumber, 10),
         liveUntilLedger: latestInitiation.liveUntilLedger
       };
     } catch (error) {
@@ -3925,10 +3941,17 @@ var StellarIndexerClient = class {
         logger19.debug(LOG_SYSTEM3, `Admin transfer was completed for ${contractAddress}`);
         return null;
       }
-      if (!latestInitiation.admin) {
+      if (!latestInitiation.previousAdmin) {
         logger19.warn(
           LOG_SYSTEM3,
-          `Indexer returned ADMIN_TRANSFER_INITIATED event without admin field for ${contractAddress}. This indicates incomplete indexer data. Treating as no valid pending transfer.`
+          `Indexer returned ADMIN_TRANSFER_INITIATED event without previousAdmin field for ${contractAddress}. This indicates incomplete indexer data. Treating as no valid pending transfer.`
+        );
+        return null;
+      }
+      if (!latestInitiation.newAdmin) {
+        logger19.warn(
+          LOG_SYSTEM3,
+          `Indexer returned ADMIN_TRANSFER_INITIATED event without newAdmin field for ${contractAddress}. This indicates incomplete indexer data. Treating as no valid pending transfer.`
         );
         return null;
       }
@@ -3941,14 +3964,14 @@ var StellarIndexerClient = class {
       }
       logger19.info(
         LOG_SYSTEM3,
-        `Found pending admin transfer for ${contractAddress}: pending admin=${latestInitiation.account}, expires at ledger ${latestInitiation.liveUntilLedger}`
+        `Found pending admin transfer for ${contractAddress}: pending admin=${latestInitiation.newAdmin}, expires at ledger ${latestInitiation.liveUntilLedger}`
       );
       return {
-        previousAdmin: latestInitiation.admin,
-        pendingAdmin: latestInitiation.account,
+        previousAdmin: latestInitiation.previousAdmin,
+        pendingAdmin: latestInitiation.newAdmin,
         txHash: latestInitiation.txHash,
         timestamp: latestInitiation.timestamp,
-        ledger: parseInt(latestInitiation.ledger || latestInitiation.blockHeight, 10),
+        ledger: parseInt(latestInitiation.blockNumber, 10),
         liveUntilLedger: latestInitiation.liveUntilLedger
       };
     } catch (error) {
@@ -3972,11 +3995,6 @@ var StellarIndexerClient = class {
    * Note: The OpenZeppelin Stellar contract emits `ownership_transfer` event
    * which is indexed as `OWNERSHIP_TRANSFER_STARTED`.
    *
-   * Schema mapping:
-   * - `account`: pending new owner
-   * - `admin`: current owner who initiated the transfer
-   * - `ledger`: block height of the event
-   * - `liveUntilLedger`: expiration ledger for the pending transfer
    */
   buildOwnershipTransferStartedQuery() {
     return `
@@ -3984,19 +4002,18 @@ var StellarIndexerClient = class {
         accessControlEvents(
           filter: {
             contract: { equalTo: $contract }
-            type: { equalTo: OWNERSHIP_TRANSFER_STARTED }
+            eventType: { equalTo: OWNERSHIP_TRANSFER_STARTED }
           }
           orderBy: TIMESTAMP_DESC
           first: 1
         ) {
           nodes {
             id
-            account
-            admin
+            previousOwner
+            newOwner
             txHash
             timestamp
-            ledger
-            blockHeight
+            blockNumber
             liveUntilLedger
           }
         }
@@ -4012,7 +4029,7 @@ var StellarIndexerClient = class {
         accessControlEvents(
           filter: {
             contract: { equalTo: $contract }
-            type: { equalTo: OWNERSHIP_TRANSFER_COMPLETED }
+            eventType: { equalTo: OWNERSHIP_TRANSFER_COMPLETED }
             timestamp: { greaterThan: $afterTimestamp }
           }
           orderBy: TIMESTAMP_DESC
@@ -4032,12 +4049,6 @@ var StellarIndexerClient = class {
    *
    * Note: The OpenZeppelin Stellar contract emits `admin_transfer_initiated` event
    * which is indexed as `ADMIN_TRANSFER_INITIATED`.
-   *
-   * Schema mapping:
-   * - `account`: pending new admin
-   * - `admin`: current admin who initiated the transfer
-   * - `ledger`: block height of the event
-   * - `liveUntilLedger`: expiration ledger for the pending transfer
    */
   buildAdminTransferInitiatedQuery() {
     return `
@@ -4045,19 +4056,18 @@ var StellarIndexerClient = class {
         accessControlEvents(
           filter: {
             contract: { equalTo: $contract }
-            type: { equalTo: ADMIN_TRANSFER_INITIATED }
+            eventType: { equalTo: ADMIN_TRANSFER_INITIATED }
           }
           orderBy: TIMESTAMP_DESC
           first: 1
         ) {
           nodes {
             id
-            account
-            admin
+            previousAdmin
+            newAdmin
             txHash
             timestamp
-            ledger
-            blockHeight
+            blockNumber
             liveUntilLedger
           }
         }
@@ -4073,7 +4083,7 @@ var StellarIndexerClient = class {
         accessControlEvents(
           filter: {
             contract: { equalTo: $contract }
-            type: { equalTo: ADMIN_TRANSFER_COMPLETED }
+            eventType: { equalTo: ADMIN_TRANSFER_COMPLETED }
             timestamp: { greaterThan: $afterTimestamp }
           }
           orderBy: TIMESTAMP_DESC
@@ -4145,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}`
@@ -4170,17 +4181,24 @@ var StellarIndexerClient = class {
   }
   /**
    * Maps internal changeType to GraphQL EventType enum
-   * GraphQL enum values: ROLE_GRANTED, ROLE_REVOKED, OWNERSHIP_TRANSFER_STARTED,
-   * OWNERSHIP_TRANSFER_COMPLETED, ADMIN_TRANSFER_INITIATED, ADMIN_TRANSFER_COMPLETED
    */
   mapChangeTypeToGraphQLEnum(changeType) {
     const mapping = {
       GRANTED: "ROLE_GRANTED",
       REVOKED: "ROLE_REVOKED",
+      ROLE_ADMIN_CHANGED: "ROLE_ADMIN_CHANGED",
       OWNERSHIP_TRANSFER_STARTED: "OWNERSHIP_TRANSFER_STARTED",
       OWNERSHIP_TRANSFER_COMPLETED: "OWNERSHIP_TRANSFER_COMPLETED",
+      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];
@@ -4191,7 +4209,7 @@ var StellarIndexerClient = class {
   buildHistoryQuery(_contractAddress, options) {
     const roleFilter = options?.roleId ? ", role: { equalTo: $role }" : "";
     const accountFilter = options?.account ? ", account: { equalTo: $account }" : "";
-    const typeFilter = options?.changeType ? `, type: { equalTo: ${this.mapChangeTypeToGraphQLEnum(options.changeType)} }` : "";
+    const typeFilter = options?.changeType ? `, eventType: { equalTo: ${this.mapChangeTypeToGraphQLEnum(options.changeType)} }` : "";
     const txFilter = options?.txId ? ", txHash: { equalTo: $txHash }" : "";
     const timestampConditions = [];
     if (options?.timestampFrom) {
@@ -4201,7 +4219,7 @@ var StellarIndexerClient = class {
       timestampConditions.push("lessThanOrEqualTo: $timestampTo");
     }
     const timestampFilter = timestampConditions.length > 0 ? `, timestamp: { ${timestampConditions.join(", ")} }` : "";
-    const ledgerFilter = options?.ledger ? ", blockHeight: { equalTo: $blockHeight }" : "";
+    const ledgerFilter = options?.ledger ? ", blockNumber: { equalTo: $blockNumber }" : "";
     const limitClause = options?.limit ? ", first: $limit" : "";
     const cursorClause = options?.cursor ? ", after: $cursor" : "";
     const varDeclarations = [
@@ -4211,7 +4229,7 @@ var StellarIndexerClient = class {
       options?.txId ? "$txHash: String" : "",
       options?.timestampFrom ? "$timestampFrom: Datetime" : "",
       options?.timestampTo ? "$timestampTo: Datetime" : "",
-      options?.ledger ? "$blockHeight: BigFloat" : "",
+      options?.ledger ? "$blockNumber: BigFloat" : "",
       options?.limit ? "$limit: Int" : "",
       options?.cursor ? "$cursor: Cursor" : ""
     ].filter(Boolean).join(", ");
@@ -4227,10 +4245,14 @@ var StellarIndexerClient = class {
             id
             role
             account
-            type
+            eventType
             txHash
             timestamp
-            blockHeight
+            blockNumber
+            previousOwner
+            newOwner
+            previousAdmin
+            newAdmin
           }
           pageInfo {
             hasNextPage
@@ -4263,7 +4285,7 @@ var StellarIndexerClient = class {
       variables.timestampTo = options.timestampTo;
     }
     if (options?.ledger) {
-      variables.blockHeight = String(options.ledger);
+      variables.blockNumber = String(options.ledger);
     }
     if (options?.limit) {
       variables.limit = options.limit;
@@ -4284,7 +4306,7 @@ var StellarIndexerClient = class {
         accessControlEvents(
           filter: {
             contract: { equalTo: $contract }
-            type: { in: [ROLE_GRANTED, ROLE_REVOKED] }
+            eventType: { in: [ROLE_GRANTED, ROLE_REVOKED] }
           }
         ) {
           nodes {
@@ -4307,7 +4329,7 @@ var StellarIndexerClient = class {
             contract: { equalTo: $contract }
             role: { equalTo: $role }
             account: { in: $accounts }
-            type: { equalTo: ROLE_GRANTED }
+            eventType: { equalTo: ROLE_GRANTED }
           }
           orderBy: TIMESTAMP_DESC
         ) {
@@ -4315,12 +4337,32 @@ var StellarIndexerClient = class {
             account
             txHash
             timestamp
-            blockHeight
+            blockNumber
           }
         }
       }
     `;
   }
+  /**
+   * Normalize account from indexer entry
+   *
+   * Multi-chain schema uses different fields for different event types:
+   * - Role events: `account` field
+   * - Ownership events: `newOwner` field (pending/new owner)
+   * - Admin events: `newAdmin` field (pending/new admin)
+   */
+  normalizeAccount(entry) {
+    if (entry.eventType === "ROLE_GRANTED" || entry.eventType === "ROLE_REVOKED" || entry.eventType === "ROLE_ADMIN_CHANGED") {
+      return entry.account || "";
+    }
+    if (entry.eventType === "OWNERSHIP_TRANSFER_STARTED" || entry.eventType === "OWNERSHIP_TRANSFER_COMPLETED" || entry.eventType === "OWNERSHIP_RENOUNCED") {
+      return entry.newOwner || "";
+    }
+    if (entry.eventType === "ADMIN_TRANSFER_INITIATED" || entry.eventType === "ADMIN_TRANSFER_COMPLETED" || entry.eventType === "ADMIN_RENOUNCED") {
+      return entry.newAdmin || "";
+    }
+    return entry.account || "";
+  }
   /**
    * Transform indexer entries to standard HistoryEntry format
    */
@@ -4331,39 +4373,48 @@ var StellarIndexerClient = class {
         // Map ownership events to special role
       };
       let changeType;
-      switch (entry.type) {
+      switch (entry.eventType) {
         case "ROLE_GRANTED":
           changeType = "GRANTED";
           break;
         case "ROLE_REVOKED":
           changeType = "REVOKED";
           break;
+        case "ROLE_ADMIN_CHANGED":
+          changeType = "ROLE_ADMIN_CHANGED";
+          break;
         case "OWNERSHIP_TRANSFER_STARTED":
           changeType = "OWNERSHIP_TRANSFER_STARTED";
           break;
         case "OWNERSHIP_TRANSFER_COMPLETED":
           changeType = "OWNERSHIP_TRANSFER_COMPLETED";
           break;
+        case "OWNERSHIP_RENOUNCED":
+          changeType = "OWNERSHIP_RENOUNCED";
+          break;
         case "ADMIN_TRANSFER_INITIATED":
           changeType = "ADMIN_TRANSFER_INITIATED";
           break;
         case "ADMIN_TRANSFER_COMPLETED":
           changeType = "ADMIN_TRANSFER_COMPLETED";
           break;
+        case "ADMIN_RENOUNCED":
+          changeType = "ADMIN_RENOUNCED";
+          break;
         default:
           logger19.warn(
             LOG_SYSTEM3,
-            `Unknown event type: ${entry.type}, assigning changeType to UNKNOWN`
+            `Unknown event type: ${entry.eventType}, assigning changeType to UNKNOWN`
           );
           changeType = "UNKNOWN";
       }
       return {
         role,
-        account: entry.account,
+        account: this.normalizeAccount(entry),
         changeType,
         txId: entry.txHash,
         timestamp: entry.timestamp,
-        ledger: parseInt(entry.blockHeight, 10)
+        ledger: parseInt(entry.blockNumber, 10)
       };
     });
   }
@@ -4699,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(
@@ -4991,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
    *
@@ -5144,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(
@@ -5439,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);
   }
   /**
@@ -8424,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",
@@ -8438,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",
@@ -8456,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
@@ -8468,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 (optional, for gasless transactions)
-      "@openzeppelin/relayer-sdk": "1.1.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