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

package/src/access-control/service.ts

@@ -14,6 +14,7 @@ import type {
   EnrichedRoleAssignment,
   EnrichedRoleMember,
   ExecutionConfig,
+  ExpirationMetadata,
   HistoryQueryOptions,
   OperationResult,
   OwnershipInfo,
@@ -236,6 +237,20 @@ export class StellarAccessControlService implements AccessControlService {
       `Reading ownership status for ${contractAddress}`
     );
 
+    // Defense-in-depth: check capabilities before calling get_owner()
+    // Only applies when contract is registered (context available for schema-based detection)
+    const context = this.contractContexts.get(contractAddress);
+    if (context) {
+      const capabilities = detectAccessControlCapabilities(context.contractSchema);
+      if (!capabilities.hasOwnable) {
+        throw new OperationFailed(
+          'Contract does not implement the Ownable interface — no get_owner() function available',
+          contractAddress,
+          'getOwnership'
+        );
+      }
+    }
+
     // T020: Call get_owner() for current owner
     const basicOwnership = await readOwnership(contractAddress, this.networkConfig);
 
@@ -631,6 +646,31 @@ export class StellarAccessControlService implements AccessControlService {
     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: string,
+    _transferType: 'ownership' | 'admin'
+  ): Promise<ExpirationMetadata> {
+    validateContractAddress(contractAddress);
+
+    return {
+      mode: 'required',
+      label: 'Expiration Ledger',
+      unit: 'ledger number',
+    };
+  }
+
   /**
    * Transfers ownership of the contract using two-step transfer
    *
@@ -830,6 +870,20 @@ export class StellarAccessControlService implements AccessControlService {
       `Reading admin status for ${contractAddress}`
     );
 
+    // Defense-in-depth: check capabilities before calling get_admin()
+    // Only applies when contract is registered (context available for schema-based detection)
+    const context = this.contractContexts.get(contractAddress);
+    if (context) {
+      const capabilities = detectAccessControlCapabilities(context.contractSchema);
+      if (!capabilities.hasTwoStepAdmin) {
+        throw new OperationFailed(
+          'Contract does not implement the two-step admin interface — no get_admin() / accept_admin_transfer() functions available',
+          contractAddress,
+          'getAdminInfo'
+        );
+      }
+    }
+
     // Call get_admin() for current admin
     const currentAdmin = await getAdmin(contractAddress, this.networkConfig);
 
@@ -1220,6 +1274,20 @@ export class StellarAccessControlService implements AccessControlService {
       `Reading admin for ${contractAddress}`
     );
 
+    // Defense-in-depth: check capabilities before calling get_admin()
+    // Only applies when contract is registered (context available for schema-based detection)
+    const context = this.contractContexts.get(contractAddress);
+    if (context) {
+      const capabilities = detectAccessControlCapabilities(context.contractSchema);
+      if (!capabilities.hasTwoStepAdmin) {
+        throw new OperationFailed(
+          'Contract does not implement the two-step admin interface — no get_admin() function available',
+          contractAddress,
+          'getAdminAccount'
+        );
+      }
+    }
+
     return getAdmin(contractAddress, this.networkConfig);
   }
 

package/src/config.ts

@@ -26,8 +26,8 @@ export const stellarAdapterConfig: AdapterConfig = {
       // 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',
+      // OpenZeppelin Relayer integration for gasless transactions
+      '@openzeppelin/relayer-sdk': '1.9.0',
 
       // React integration for wallet components
       react: '^19.0.0',

package/src/index.ts

@@ -1,18 +1,23 @@
-// Re-export the main adapter class
+import type { EcosystemExport, StellarNetworkConfig } from '@openzeppelin/ui-types';
+
+import { StellarAdapter } from './adapter';
+import { stellarAdapterConfig } from './config';
+import { ecosystemMetadata } from './metadata';
+import { stellarNetworks } from './networks';
+
+export { ecosystemMetadata } from './metadata';
 export { StellarAdapter } from './adapter';
 
-// Re-export adapter-specific types
+export const ecosystemDefinition: EcosystemExport = {
+  ...ecosystemMetadata,
+  networks: stellarNetworks,
+  createAdapter: (config) => new StellarAdapter(config as StellarNetworkConfig),
+  adapterConfig: stellarAdapterConfig,
+};
+
+// Adapter-specific types
 export type { StellarContractArtifacts } from './types/artifacts';
 export { isStellarContractArtifacts } from './types/artifacts';
 
-export {
-  stellarNetworks,
-  stellarMainnetNetworks,
-  stellarTestnetNetworks,
-  // Individual networks
-  stellarPublic,
-  stellarTestnet,
-} from './networks';
-
-// Export adapter configuration
-export { stellarAdapterConfig } from './config';
+// Individual network exports
+export { stellarPublic, stellarTestnet } from './networks';

package/src/metadata.ts

@@ -0,0 +1,16 @@
+import { NetworkStellar } from '@web3icons/react';
+
+import type { EcosystemMetadata } from '@openzeppelin/ui-types';
+
+export const ecosystemMetadata: 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 },
+};

package/src/networks/mainnet.ts

@@ -16,5 +16,5 @@ export const stellarPublic: StellarNetworkConfig = {
   networkPassphrase: 'Public Global Stellar Network ; September 2015',
   explorerUrl: 'https://stellar.expert/explorer/public',
   iconComponent: NetworkStellar,
-  indexerUri: 'https://openzeppelin-stellar-mainnet.graphql.subquery.network/',
+  accessControlIndexerUrl: 'https://openzeppelin-stellar-mainnet.graphql.subquery.network/',
 };

package/src/networks/testnet.ts

@@ -16,5 +16,5 @@ export const stellarTestnet: StellarNetworkConfig = {
   networkPassphrase: 'Test SDF Network ; September 2015',
   explorerUrl: 'https://stellar.expert/explorer/testnet',
   iconComponent: NetworkStellar,
-  indexerUri: 'https://openzepplin-stellar-testnet.graphql.subquery.network',
+  accessControlIndexerUrl: 'https://openzepplin-stellar-testnet.graphql.subquery.network',
 };