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

package/dist/index.cjs

@@ -33,13 +33,11 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 var index_exports = {};
 __export(index_exports, {
   StellarAdapter: () => StellarAdapter,
+  ecosystemDefinition: () => ecosystemDefinition,
+  ecosystemMetadata: () => ecosystemMetadata,
   isStellarContractArtifacts: () => isStellarContractArtifacts,
-  stellarAdapterConfig: () => stellarAdapterConfig,
-  stellarMainnetNetworks: () => stellarMainnetNetworks,
-  stellarNetworks: () => stellarNetworks,
   stellarPublic: () => stellarPublic,
-  stellarTestnet: () => stellarTestnet,
-  stellarTestnetNetworks: () => stellarTestnetNetworks
+  stellarTestnet: () => stellarTestnet
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -3286,6 +3284,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,
@@ -3294,7 +3296,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) {
@@ -4156,8 +4162,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;
       import_ui_utils20.logger.info(
         LOG_SYSTEM3,
         `Using network config indexer URI for ${networkId}: ${endpoints.http}`
@@ -4192,7 +4199,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];
@@ -4744,6 +4757,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 import_ui_types9.OperationFailed(
+          "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) {
       import_ui_utils22.logger.debug(
@@ -5036,6 +5060,25 @@ var StellarAccessControlService = class {
     import_ui_utils22.logger.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
    *
@@ -5189,6 +5232,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 import_ui_types9.OperationFailed(
+          "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) {
       import_ui_utils22.logger.debug(
@@ -5484,6 +5538,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 import_ui_types9.OperationFailed(
+          "Contract does not implement the two-step admin interface \u2014 no get_admin() function available",
+          contractAddress,
+          "getAdminAccount"
+        );
+      }
+    }
     return getAdmin(contractAddress, this.networkConfig);
   }
   /**
@@ -8458,8 +8523,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
 var import_react11 = require("@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: import_react11.NetworkStellar,
+  bgColorClass: "bg-sky-100",
+  textColorClass: "text-sky-900",
+  defaultFeatureConfig: { enabled: true, showInUI: true }
+};
+
+// src/networks/mainnet.ts
+var import_react12 = require("@web3icons/react");
 var stellarPublic = {
   id: "stellar-public",
   exportConstName: "stellarPublic",
@@ -8472,12 +8582,12 @@ var stellarPublic = {
   sorobanRpcUrl: "https://mainnet.sorobanrpc.com",
   networkPassphrase: "Public Global Stellar Network ; September 2015",
   explorerUrl: "https://stellar.expert/explorer/public",
-  iconComponent: import_react11.NetworkStellar,
-  indexerUri: "https://openzeppelin-stellar-mainnet.graphql.subquery.network/"
+  iconComponent: import_react12.NetworkStellar,
+  accessControlIndexerUrl: "https://openzeppelin-stellar-mainnet.graphql.subquery.network/"
 };
 
 // src/networks/testnet.ts
-var import_react12 = require("@web3icons/react");
+var import_react13 = require("@web3icons/react");
 var stellarTestnet = {
   id: "stellar-testnet",
   exportConstName: "stellarTestnet",
@@ -8490,8 +8600,8 @@ var stellarTestnet = {
   sorobanRpcUrl: "https://soroban-testnet.stellar.org",
   networkPassphrase: "Test SDF Network ; September 2015",
   explorerUrl: "https://stellar.expert/explorer/testnet",
-  iconComponent: import_react12.NetworkStellar,
-  indexerUri: "https://openzepplin-stellar-testnet.graphql.subquery.network"
+  iconComponent: import_react13.NetworkStellar,
+  accessControlIndexerUrl: "https://openzepplin-stellar-testnet.graphql.subquery.network"
 };
 
 // src/networks/index.ts
@@ -8502,45 +8612,20 @@ 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
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   StellarAdapter,
+  ecosystemDefinition,
+  ecosystemMetadata,
   isStellarContractArtifacts,
-  stellarAdapterConfig,
-  stellarMainnetNetworks,
-  stellarNetworks,
   stellarPublic,
-  stellarTestnet,
-  stellarTestnetNetworks
+  stellarTestnet
 });
 //# sourceMappingURL=index.cjs.map