@partylayer/core 0.2.7 → 0.3.1

package/dist/index.d.mts

@@ -57,6 +57,62 @@ interface AdapterMetadata {
     /** Version range (semver) */
     versionRange: string;
 }
+/**
+ * Provider matcher: a single rule used by `ProviderDetection.matchers`.
+ *
+ * Three match modes are defined; OR-combined inside a `ProviderDetection`.
+ * Exact and prefix work on string fields directly; domain interprets the
+ * field as a URL and tests its hostname against the registrable domain
+ * (with subdomain support).
+ */
+type ProviderMatcher = {
+    field: 'kernel.url' | 'kernel.userUrl';
+    match: 'domain';
+    /** Hostname or registrable domain. Subdomains are accepted. */
+    value: string;
+} | {
+    field: 'kernel.id' | 'kernel.url' | 'kernel.userUrl' | 'kernel.clientType' | 'provider.id';
+    match: 'exact';
+    /** One or more exact values; ANY match returns true. */
+    values: string[];
+} | {
+    field: 'kernel.id' | 'kernel.url' | 'kernel.userUrl';
+    match: 'prefix';
+    value: string;
+};
+/**
+ * Standards-first runtime detection of a CIP-0103 wallet.
+ *
+ * The registry stores these rules so that any current or future wallet
+ * implementing `window.canton` can be identified without code changes —
+ * a registry JSON update is enough.
+ */
+interface ProviderDetection {
+    /** Transport mechanism. Currently only 'window.canton' is supported. */
+    transport: 'window.canton';
+    /** OR-list of matchers. Provider matches if ANY matcher returns true. */
+    matchers: ProviderMatcher[];
+}
+/**
+ * Canonical CIP-0103 support marker.
+ *
+ * When `native: true`, the wallet is treated as a first-class CIP-0103
+ * provider in the picker — it always appears in the "CIP-0103 NATIVE"
+ * section regardless of install state, with a per-wallet readiness
+ * indicator that reflects whether the wallet's `providerDetection` rules
+ * matched the currently-injected `window.canton` provider.
+ *
+ * The field is optional; wallets that don't claim CIP-0103 support omit
+ * it and continue to appear in the "AVAILABLE" section as before.
+ */
+interface Cip0103Support {
+    /** True if this wallet has confirmed CIP-0103 dApp API support. */
+    native: boolean;
+    /** Public evidence link (npm package, blog post, official statement). */
+    evidence?: string;
+    /** ISO date when CIP-0103 support was confirmed (informational). */
+    since?: string;
+}
 /**
  * Wallet information from registry
  */
@@ -91,7 +147,29 @@ interface WalletInfo {
     channel: 'stable' | 'beta';
     /** Additional metadata (e.g., originAllowlist) */
     metadata?: Record<string, string>;
+    /**
+     * Optional CIP-0103 runtime detection rules. When present, the picker can
+     * decide whether this wallet is the currently-injected `window.canton`
+     * provider and route it into the "CIP-0103 Native" section without any
+     * hardcoded wallet IDs. Wallets that aren't CIP-0103-injected (e.g. Bron,
+     * Cantor8 deeplink) leave this unset.
+     */
+    providerDetection?: ProviderDetection;
+    /**
+     * Canonical CIP-0103 support marker. When set with `native: true`, the
+     * picker always lists the wallet in the "CIP-0103 NATIVE" section
+     * regardless of install state.
+     */
+    cip0103?: Cip0103Support;
 }
+/**
+ * Returns true if the wallet has been canonically marked as CIP-0103
+ * native via its registry entry. The check is structural so it works on
+ * both raw `RegistryWalletEntry` shapes and converted `WalletInfo`.
+ */
+declare function isCip0103Native(entry: {
+    cip0103?: Cip0103Support;
+}): boolean;
 /**
  * Session information
  * Sessions are origin-bound and encrypted in storage
@@ -616,6 +694,62 @@ declare function isSessionExpired(session: Session): boolean;
  */
 declare function createSession(walletId: string, partyId: string, network: string, origin: string, capabilities?: string[], expiresInMs?: number): Session;
 
+/**
+ * Standards-first CIP-0103 wallet detection.
+ *
+ * The registry stores `providerDetection` rules per wallet entry. At
+ * runtime the picker calls `window.canton.request({method:'status'})`,
+ * receives the wallet's self-reported identity (kernel.id / kernel.url /
+ * kernel.userUrl / kernel.clientType), and asks `findMatchingWallet`
+ * which registry entry — if any — claims this provider.
+ *
+ * The architecture deliberately avoids hardcoding wallet IDs anywhere
+ * outside the registry. Adding a new CIP-0103 wallet to the ecosystem
+ * is a registry JSON update; no SDK release is required.
+ */
+
+/**
+ * The shape of a CIP-0103 status response that detection cares about.
+ *
+ * Mirrors what `window.canton.request({ method: 'status' })` returns —
+ * declared structurally so adapter packages can reuse this without
+ * reaching into the wallet-specific types.
+ */
+interface Cip0103StatusForDetection {
+    kernel?: {
+        id?: string;
+        url?: string;
+        userUrl?: string;
+        clientType?: string;
+    };
+}
+/** Returns true if the runtime status matches any of the detection's matchers. */
+declare function matchesProviderDetection(status: Cip0103StatusForDetection | null | undefined, detection: ProviderDetection | undefined): boolean;
+/**
+ * Find the first registry entry whose `providerDetection` matches the
+ * runtime status. Entries without `providerDetection` are skipped.
+ *
+ * Accepts either the raw `RegistryWalletEntry[]` shape (registry-client's
+ * native input) or the converted `WalletInfo[]` shape that flows through
+ * the SDK / React layer — the only field read is `providerDetection`,
+ * which both shapes carry post-conversion.
+ */
+declare function findMatchingWallet<T extends {
+    providerDetection?: ProviderDetection;
+}>(status: Cip0103StatusForDetection | null | undefined, registry: readonly T[]): T | undefined;
+/**
+ * Type-guard convenience for the WalletInfo shape, since the SDK exposes
+ * `WalletInfo[]` to React consumers.
+ */
+declare function findMatchingWalletInfo(status: Cip0103StatusForDetection | null | undefined, wallets: readonly WalletInfo[]): WalletInfo | undefined;
+/**
+ * Best-effort display name for an unrecognised CIP-0103 provider. Reads
+ * the wallet's self-declared `kernel.userUrl` (the human-facing URL
+ * surfaced by Sigilry-style wallets) and falls back to `kernel.id` or
+ * a generic label.
+ */
+declare function deriveGenericWalletName(status: Cip0103StatusForDetection | null | undefined): string;
+
 /**
  * Transport layer types for wallet communication
  *
@@ -1220,4 +1354,4 @@ interface Transport {
     disconnect(): Promise<void>;
 }
 
-export { type AdapterConnectResult, type AdapterContext, type AdapterDetectResult, type AdapterEventName, type AdapterMetadata, type CIP0103Account, type CIP0103AccountStatus, type CIP0103ConnectResult, type CIP0103Event, type CIP0103EventListener, type CIP0103LedgerApiRequest, type CIP0103LedgerApiResponse, type CIP0103Method, type CIP0103Network, type CIP0103Provider, type CIP0103ProviderInfo, type CIP0103ProviderRpcError, type CIP0103ProviderType, type CIP0103RequestParams, type CIP0103RequestPayload, type CIP0103SignMessageRequest, type CIP0103StatusEvent, type CIP0103TxChangedEvent, type CIP0103TxExecutedPayload, type CIP0103TxFailedPayload, type CIP0103TxPendingPayload, type CIP0103TxSignedPayload, type CIP0103TxStatus, CIP0103_EVENTS, CIP0103_MANDATORY_METHODS, CIP0103_METHODS, type CapabilityKey, CapabilityNotSupportedError, type ConnectRequest, type ConnectResponse, type CryptoAdapter, DeepLinkTransport, ENABLEMENT_METRICS, ERROR_METRICS, type ErrorCode, type ErrorMappingContext, type InstallHints, InternalError, type JobStatus, type LedgerApiParams, type LedgerApiResult, type LoggerAdapter, METRICS, type MetricName, type MetricsPayload, MockTransport, type NetworkId, OriginNotAllowedError, type PartyId, PartyLayerError, type PersistedSession, PopupTransport, PostMessageTransport, REGISTRY_METRICS, type RegistryClientAdapter, RegistryFetchFailedError, RegistrySchemaInvalidError, RegistryVerificationFailedError, type Session, SessionExpiredError, type SessionId, type SignMessageParams, type SignRequest, type SignResponse, type SignTransactionParams, type Signature, type SignedMessage, type SignedTransaction, type StorageAdapter, type SubmitTransactionParams, type TelemetryAdapter, TimeoutError, type TransactionHash, type TransactionStatus, type Transport, TransportError, type TransportOptions, type TransportType, type TxReceipt, type TxStatusUpdate, UserRejectedError, type WalletAdapter, type WalletId, type WalletInfo, WalletNotFoundError, WalletNotInstalledError, capabilityGuard, createMetricsPayload, createSession, errorMetricName, generateSessionId, hashForPrivacy, installGuard, isSessionExpired, mapUnknownErrorToPartyLayerError, toPartyId, toSessionId, toSignature, toTransactionHash, toWalletId, validatePayload, validateSession };
+export { type AdapterConnectResult, type AdapterContext, type AdapterDetectResult, type AdapterEventName, type AdapterMetadata, type CIP0103Account, type CIP0103AccountStatus, type CIP0103ConnectResult, type CIP0103Event, type CIP0103EventListener, type CIP0103LedgerApiRequest, type CIP0103LedgerApiResponse, type CIP0103Method, type CIP0103Network, type CIP0103Provider, type CIP0103ProviderInfo, type CIP0103ProviderRpcError, type CIP0103ProviderType, type CIP0103RequestParams, type CIP0103RequestPayload, type CIP0103SignMessageRequest, type CIP0103StatusEvent, type CIP0103TxChangedEvent, type CIP0103TxExecutedPayload, type CIP0103TxFailedPayload, type CIP0103TxPendingPayload, type CIP0103TxSignedPayload, type CIP0103TxStatus, CIP0103_EVENTS, CIP0103_MANDATORY_METHODS, CIP0103_METHODS, type CapabilityKey, CapabilityNotSupportedError, type Cip0103StatusForDetection, type Cip0103Support, type ConnectRequest, type ConnectResponse, type CryptoAdapter, DeepLinkTransport, ENABLEMENT_METRICS, ERROR_METRICS, type ErrorCode, type ErrorMappingContext, type InstallHints, InternalError, type JobStatus, type LedgerApiParams, type LedgerApiResult, type LoggerAdapter, METRICS, type MetricName, type MetricsPayload, MockTransport, type NetworkId, OriginNotAllowedError, type PartyId, PartyLayerError, type PersistedSession, PopupTransport, PostMessageTransport, type ProviderDetection, type ProviderMatcher, REGISTRY_METRICS, type RegistryClientAdapter, RegistryFetchFailedError, RegistrySchemaInvalidError, RegistryVerificationFailedError, type Session, SessionExpiredError, type SessionId, type SignMessageParams, type SignRequest, type SignResponse, type SignTransactionParams, type Signature, type SignedMessage, type SignedTransaction, type StorageAdapter, type SubmitTransactionParams, type TelemetryAdapter, TimeoutError, type TransactionHash, type TransactionStatus, type Transport, TransportError, type TransportOptions, type TransportType, type TxReceipt, type TxStatusUpdate, UserRejectedError, type WalletAdapter, type WalletId, type WalletInfo, WalletNotFoundError, WalletNotInstalledError, capabilityGuard, createMetricsPayload, createSession, deriveGenericWalletName, errorMetricName, findMatchingWallet, findMatchingWalletInfo, generateSessionId, hashForPrivacy, installGuard, isCip0103Native, isSessionExpired, mapUnknownErrorToPartyLayerError, matchesProviderDetection, toPartyId, toSessionId, toSignature, toTransactionHash, toWalletId, validatePayload, validateSession };

package/dist/index.d.ts

@@ -57,6 +57,62 @@ interface AdapterMetadata {
     /** Version range (semver) */
     versionRange: string;
 }
+/**
+ * Provider matcher: a single rule used by `ProviderDetection.matchers`.
+ *
+ * Three match modes are defined; OR-combined inside a `ProviderDetection`.
+ * Exact and prefix work on string fields directly; domain interprets the
+ * field as a URL and tests its hostname against the registrable domain
+ * (with subdomain support).
+ */
+type ProviderMatcher = {
+    field: 'kernel.url' | 'kernel.userUrl';
+    match: 'domain';
+    /** Hostname or registrable domain. Subdomains are accepted. */
+    value: string;
+} | {
+    field: 'kernel.id' | 'kernel.url' | 'kernel.userUrl' | 'kernel.clientType' | 'provider.id';
+    match: 'exact';
+    /** One or more exact values; ANY match returns true. */
+    values: string[];
+} | {
+    field: 'kernel.id' | 'kernel.url' | 'kernel.userUrl';
+    match: 'prefix';
+    value: string;
+};
+/**
+ * Standards-first runtime detection of a CIP-0103 wallet.
+ *
+ * The registry stores these rules so that any current or future wallet
+ * implementing `window.canton` can be identified without code changes —
+ * a registry JSON update is enough.
+ */
+interface ProviderDetection {
+    /** Transport mechanism. Currently only 'window.canton' is supported. */
+    transport: 'window.canton';
+    /** OR-list of matchers. Provider matches if ANY matcher returns true. */
+    matchers: ProviderMatcher[];
+}
+/**
+ * Canonical CIP-0103 support marker.
+ *
+ * When `native: true`, the wallet is treated as a first-class CIP-0103
+ * provider in the picker — it always appears in the "CIP-0103 NATIVE"
+ * section regardless of install state, with a per-wallet readiness
+ * indicator that reflects whether the wallet's `providerDetection` rules
+ * matched the currently-injected `window.canton` provider.
+ *
+ * The field is optional; wallets that don't claim CIP-0103 support omit
+ * it and continue to appear in the "AVAILABLE" section as before.
+ */
+interface Cip0103Support {
+    /** True if this wallet has confirmed CIP-0103 dApp API support. */
+    native: boolean;
+    /** Public evidence link (npm package, blog post, official statement). */
+    evidence?: string;
+    /** ISO date when CIP-0103 support was confirmed (informational). */
+    since?: string;
+}
 /**
  * Wallet information from registry
  */
@@ -91,7 +147,29 @@ interface WalletInfo {
     channel: 'stable' | 'beta';
     /** Additional metadata (e.g., originAllowlist) */
     metadata?: Record<string, string>;
+    /**
+     * Optional CIP-0103 runtime detection rules. When present, the picker can
+     * decide whether this wallet is the currently-injected `window.canton`
+     * provider and route it into the "CIP-0103 Native" section without any
+     * hardcoded wallet IDs. Wallets that aren't CIP-0103-injected (e.g. Bron,
+     * Cantor8 deeplink) leave this unset.
+     */
+    providerDetection?: ProviderDetection;
+    /**
+     * Canonical CIP-0103 support marker. When set with `native: true`, the
+     * picker always lists the wallet in the "CIP-0103 NATIVE" section
+     * regardless of install state.
+     */
+    cip0103?: Cip0103Support;
 }
+/**
+ * Returns true if the wallet has been canonically marked as CIP-0103
+ * native via its registry entry. The check is structural so it works on
+ * both raw `RegistryWalletEntry` shapes and converted `WalletInfo`.
+ */
+declare function isCip0103Native(entry: {
+    cip0103?: Cip0103Support;
+}): boolean;
 /**
  * Session information
  * Sessions are origin-bound and encrypted in storage
@@ -616,6 +694,62 @@ declare function isSessionExpired(session: Session): boolean;
  */
 declare function createSession(walletId: string, partyId: string, network: string, origin: string, capabilities?: string[], expiresInMs?: number): Session;
 
+/**
+ * Standards-first CIP-0103 wallet detection.
+ *
+ * The registry stores `providerDetection` rules per wallet entry. At
+ * runtime the picker calls `window.canton.request({method:'status'})`,
+ * receives the wallet's self-reported identity (kernel.id / kernel.url /
+ * kernel.userUrl / kernel.clientType), and asks `findMatchingWallet`
+ * which registry entry — if any — claims this provider.
+ *
+ * The architecture deliberately avoids hardcoding wallet IDs anywhere
+ * outside the registry. Adding a new CIP-0103 wallet to the ecosystem
+ * is a registry JSON update; no SDK release is required.
+ */
+
+/**
+ * The shape of a CIP-0103 status response that detection cares about.
+ *
+ * Mirrors what `window.canton.request({ method: 'status' })` returns —
+ * declared structurally so adapter packages can reuse this without
+ * reaching into the wallet-specific types.
+ */
+interface Cip0103StatusForDetection {
+    kernel?: {
+        id?: string;
+        url?: string;
+        userUrl?: string;
+        clientType?: string;
+    };
+}
+/** Returns true if the runtime status matches any of the detection's matchers. */
+declare function matchesProviderDetection(status: Cip0103StatusForDetection | null | undefined, detection: ProviderDetection | undefined): boolean;
+/**
+ * Find the first registry entry whose `providerDetection` matches the
+ * runtime status. Entries without `providerDetection` are skipped.
+ *
+ * Accepts either the raw `RegistryWalletEntry[]` shape (registry-client's
+ * native input) or the converted `WalletInfo[]` shape that flows through
+ * the SDK / React layer — the only field read is `providerDetection`,
+ * which both shapes carry post-conversion.
+ */
+declare function findMatchingWallet<T extends {
+    providerDetection?: ProviderDetection;
+}>(status: Cip0103StatusForDetection | null | undefined, registry: readonly T[]): T | undefined;
+/**
+ * Type-guard convenience for the WalletInfo shape, since the SDK exposes
+ * `WalletInfo[]` to React consumers.
+ */
+declare function findMatchingWalletInfo(status: Cip0103StatusForDetection | null | undefined, wallets: readonly WalletInfo[]): WalletInfo | undefined;
+/**
+ * Best-effort display name for an unrecognised CIP-0103 provider. Reads
+ * the wallet's self-declared `kernel.userUrl` (the human-facing URL
+ * surfaced by Sigilry-style wallets) and falls back to `kernel.id` or
+ * a generic label.
+ */
+declare function deriveGenericWalletName(status: Cip0103StatusForDetection | null | undefined): string;
+
 /**
  * Transport layer types for wallet communication
  *
@@ -1220,4 +1354,4 @@ interface Transport {
     disconnect(): Promise<void>;
 }
 
-export { type AdapterConnectResult, type AdapterContext, type AdapterDetectResult, type AdapterEventName, type AdapterMetadata, type CIP0103Account, type CIP0103AccountStatus, type CIP0103ConnectResult, type CIP0103Event, type CIP0103EventListener, type CIP0103LedgerApiRequest, type CIP0103LedgerApiResponse, type CIP0103Method, type CIP0103Network, type CIP0103Provider, type CIP0103ProviderInfo, type CIP0103ProviderRpcError, type CIP0103ProviderType, type CIP0103RequestParams, type CIP0103RequestPayload, type CIP0103SignMessageRequest, type CIP0103StatusEvent, type CIP0103TxChangedEvent, type CIP0103TxExecutedPayload, type CIP0103TxFailedPayload, type CIP0103TxPendingPayload, type CIP0103TxSignedPayload, type CIP0103TxStatus, CIP0103_EVENTS, CIP0103_MANDATORY_METHODS, CIP0103_METHODS, type CapabilityKey, CapabilityNotSupportedError, type ConnectRequest, type ConnectResponse, type CryptoAdapter, DeepLinkTransport, ENABLEMENT_METRICS, ERROR_METRICS, type ErrorCode, type ErrorMappingContext, type InstallHints, InternalError, type JobStatus, type LedgerApiParams, type LedgerApiResult, type LoggerAdapter, METRICS, type MetricName, type MetricsPayload, MockTransport, type NetworkId, OriginNotAllowedError, type PartyId, PartyLayerError, type PersistedSession, PopupTransport, PostMessageTransport, REGISTRY_METRICS, type RegistryClientAdapter, RegistryFetchFailedError, RegistrySchemaInvalidError, RegistryVerificationFailedError, type Session, SessionExpiredError, type SessionId, type SignMessageParams, type SignRequest, type SignResponse, type SignTransactionParams, type Signature, type SignedMessage, type SignedTransaction, type StorageAdapter, type SubmitTransactionParams, type TelemetryAdapter, TimeoutError, type TransactionHash, type TransactionStatus, type Transport, TransportError, type TransportOptions, type TransportType, type TxReceipt, type TxStatusUpdate, UserRejectedError, type WalletAdapter, type WalletId, type WalletInfo, WalletNotFoundError, WalletNotInstalledError, capabilityGuard, createMetricsPayload, createSession, errorMetricName, generateSessionId, hashForPrivacy, installGuard, isSessionExpired, mapUnknownErrorToPartyLayerError, toPartyId, toSessionId, toSignature, toTransactionHash, toWalletId, validatePayload, validateSession };
+export { type AdapterConnectResult, type AdapterContext, type AdapterDetectResult, type AdapterEventName, type AdapterMetadata, type CIP0103Account, type CIP0103AccountStatus, type CIP0103ConnectResult, type CIP0103Event, type CIP0103EventListener, type CIP0103LedgerApiRequest, type CIP0103LedgerApiResponse, type CIP0103Method, type CIP0103Network, type CIP0103Provider, type CIP0103ProviderInfo, type CIP0103ProviderRpcError, type CIP0103ProviderType, type CIP0103RequestParams, type CIP0103RequestPayload, type CIP0103SignMessageRequest, type CIP0103StatusEvent, type CIP0103TxChangedEvent, type CIP0103TxExecutedPayload, type CIP0103TxFailedPayload, type CIP0103TxPendingPayload, type CIP0103TxSignedPayload, type CIP0103TxStatus, CIP0103_EVENTS, CIP0103_MANDATORY_METHODS, CIP0103_METHODS, type CapabilityKey, CapabilityNotSupportedError, type Cip0103StatusForDetection, type Cip0103Support, type ConnectRequest, type ConnectResponse, type CryptoAdapter, DeepLinkTransport, ENABLEMENT_METRICS, ERROR_METRICS, type ErrorCode, type ErrorMappingContext, type InstallHints, InternalError, type JobStatus, type LedgerApiParams, type LedgerApiResult, type LoggerAdapter, METRICS, type MetricName, type MetricsPayload, MockTransport, type NetworkId, OriginNotAllowedError, type PartyId, PartyLayerError, type PersistedSession, PopupTransport, PostMessageTransport, type ProviderDetection, type ProviderMatcher, REGISTRY_METRICS, type RegistryClientAdapter, RegistryFetchFailedError, RegistrySchemaInvalidError, RegistryVerificationFailedError, type Session, SessionExpiredError, type SessionId, type SignMessageParams, type SignRequest, type SignResponse, type SignTransactionParams, type Signature, type SignedMessage, type SignedTransaction, type StorageAdapter, type SubmitTransactionParams, type TelemetryAdapter, TimeoutError, type TransactionHash, type TransactionStatus, type Transport, TransportError, type TransportOptions, type TransportType, type TxReceipt, type TxStatusUpdate, UserRejectedError, type WalletAdapter, type WalletId, type WalletInfo, WalletNotFoundError, WalletNotInstalledError, capabilityGuard, createMetricsPayload, createSession, deriveGenericWalletName, errorMetricName, findMatchingWallet, findMatchingWalletInfo, generateSessionId, hashForPrivacy, installGuard, isCip0103Native, isSessionExpired, mapUnknownErrorToPartyLayerError, matchesProviderDetection, toPartyId, toSessionId, toSignature, toTransactionHash, toWalletId, validatePayload, validateSession };

package/dist/index.js

@@ -1,6 +1,9 @@
 'use strict';
 
 // src/types.ts
+function isCip0103Native(entry) {
+  return entry?.cip0103?.native === true;
+}
 function toWalletId(id) {
   return id;
 }
@@ -275,6 +278,74 @@ function createSession(walletId, partyId, network, origin, capabilities = [], ex
   };
 }
 
+// src/detection.ts
+function matchesProviderDetection(status, detection) {
+  if (!status || !detection || !detection.matchers || detection.matchers.length === 0) {
+    return false;
+  }
+  return detection.matchers.some((m) => matchesSingle(status, m));
+}
+function matchesSingle(status, matcher) {
+  const fieldValue = readField(status, matcher.field);
+  if (typeof fieldValue !== "string" || fieldValue.length === 0) return false;
+  switch (matcher.match) {
+    case "exact":
+      return matcher.values.includes(fieldValue);
+    case "prefix":
+      return fieldValue.startsWith(matcher.value);
+    case "domain":
+      return matchesDomain(fieldValue, matcher.value);
+    default:
+      return false;
+  }
+}
+function readField(status, field) {
+  if (!status || typeof status !== "object") return void 0;
+  const dot = field.indexOf(".");
+  if (dot < 0) return void 0;
+  const root = field.slice(0, dot);
+  const key = field.slice(dot + 1);
+  const subject = status[root];
+  if (!subject || typeof subject !== "object") return void 0;
+  const value = subject[key];
+  return typeof value === "string" ? value : void 0;
+}
+function matchesDomain(url, domain) {
+  try {
+    const hostname = new URL(url).hostname.toLowerCase();
+    const target = domain.toLowerCase();
+    return hostname === target || hostname.endsWith("." + target);
+  } catch {
+    return false;
+  }
+}
+function findMatchingWallet(status, registry) {
+  if (!status) return void 0;
+  for (const entry of registry) {
+    if (matchesProviderDetection(status, entry.providerDetection)) {
+      return entry;
+    }
+  }
+  return void 0;
+}
+function findMatchingWalletInfo(status, wallets) {
+  return findMatchingWallet(status, wallets);
+}
+function deriveGenericWalletName(status) {
+  const userUrl = status?.kernel?.userUrl;
+  if (typeof userUrl === "string" && userUrl.length > 0) {
+    try {
+      return new URL(userUrl).hostname.replace(/^www\./, "");
+    } catch {
+    }
+  }
+  const id = status?.kernel?.id;
+  if (typeof id === "string" && id.length > 0) {
+    return `CIP-0103 wallet (${id.slice(0, 8)}\u2026)`;
+  }
+  return "CIP-0103 wallet";
+}
+
 // src/metrics.ts
 var ENABLEMENT_METRICS = {
   /** Total wallet connect() calls made */
@@ -927,12 +998,17 @@ exports.WalletNotInstalledError = WalletNotInstalledError;
 exports.capabilityGuard = capabilityGuard;
 exports.createMetricsPayload = createMetricsPayload;
 exports.createSession = createSession;
+exports.deriveGenericWalletName = deriveGenericWalletName;
 exports.errorMetricName = errorMetricName;
+exports.findMatchingWallet = findMatchingWallet;
+exports.findMatchingWalletInfo = findMatchingWalletInfo;
 exports.generateSessionId = generateSessionId;
 exports.hashForPrivacy = hashForPrivacy;
 exports.installGuard = installGuard;
+exports.isCip0103Native = isCip0103Native;
 exports.isSessionExpired = isSessionExpired;
 exports.mapUnknownErrorToPartyLayerError = mapUnknownErrorToPartyLayerError;
+exports.matchesProviderDetection = matchesProviderDetection;
 exports.toPartyId = toPartyId;
 exports.toSessionId = toSessionId;
 exports.toSignature = toSignature;