@partylayer/provider 0.1.7 → 0.2.1

package/README.md

@@ -42,12 +42,15 @@ npm install @partylayer/provider
 ```typescript
 import { PartyLayerProvider, discoverProviders } from '@partylayer/provider';
 
-// Discover injected CIP-0103 wallet providers
-const wallets = discoverProviders();
+// Discover CIP-0103 wallets: the synchronous window.canton scan PLUS the
+// canton:announceProvider handshake (async), merged + deduped by provider id.
+const wallets = await discoverProviders();
 
 // Create provider with first discovered wallet
 const provider = new PartyLayerProvider({ walletProvider: wallets[0] });
 
+// (For the synchronous window.canton-only scan, use discoverInjectedProviders().)
+
 // Connect
 const result = await provider.request({ method: 'connect' });
 

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { CIP0103Provider, CIP0103RequestPayload, CIP0103EventListener, PartyLayerError, CIP0103ConnectResult, CIP0103TxChangedEvent, CIP0103Network, CIP0103RequestParams } from '@partylayer/core';
-export { CIP0103Account, CIP0103AccountStatus, CIP0103ConnectResult, CIP0103Event, CIP0103EventListener, CIP0103LedgerApiRequest, CIP0103LedgerApiResponse, CIP0103Method, CIP0103Network, CIP0103Provider, CIP0103ProviderInfo, CIP0103ProviderRpcError, CIP0103ProviderType, CIP0103RequestParams, CIP0103RequestPayload, CIP0103SignMessageRequest, CIP0103StatusEvent, CIP0103TxChangedEvent, CIP0103TxExecutedPayload, CIP0103TxFailedPayload, CIP0103TxPendingPayload, CIP0103TxSignedPayload, CIP0103TxStatus, CIP0103_EVENTS, CIP0103_MANDATORY_METHODS, CIP0103_METHODS } from '@partylayer/core';
+import { CIP0103Provider, CIP0103RequestPayload, CIP0103EventListener, PartyLayerError, CIP0103ConnectResult, CIP0103TxChangedEvent, CIP0103RequestParams } from '@partylayer/core';
+export { CANTON_NETWORKS, CIP0103Account, CIP0103AccountStatus, CIP0103ConnectResult, CIP0103Event, CIP0103EventListener, CIP0103LedgerApiRequest, CIP0103LedgerApiResponse, CIP0103Method, CIP0103Network, CIP0103Provider, CIP0103ProviderInfo, CIP0103ProviderRpcError, CIP0103ProviderType, CIP0103RequestParams, CIP0103RequestPayload, CIP0103SignMessageRequest, CIP0103StatusEvent, CIP0103TxChangedEvent, CIP0103TxExecutedPayload, CIP0103TxFailedPayload, CIP0103TxPendingPayload, CIP0103TxSignedPayload, CIP0103TxStatus, CIP0103_EVENTS, CIP0103_MANDATORY_METHODS, CIP0103_METHODS, fromCAIP2Network, isValidCAIP2, toCAIP2Network } from '@partylayer/core';
 
 /**
  * CIP-0103 Wallet Discovery
@@ -21,6 +21,8 @@ interface DiscoveredProvider {
     isAsync?: boolean;
     /** Display name (if discoverable from status) */
     name?: string;
+    /** Icon (data: URI or URL) — populated for announce-discovered wallets. */
+    icon?: string;
 }
 /**
  * Check if an object implements the CIP-0103 Provider interface.
@@ -47,6 +49,54 @@ declare function discoverInjectedProviders(): DiscoveredProvider[];
  * @param timeoutMs - Maximum wait time (default 3000ms)
  */
 declare function waitForProvider(id: string, timeoutMs?: number): Promise<DiscoveredProvider | null>;
+/** Metadata carried by a `canton:announceProvider` event. */
+interface AnnouncedWallet {
+    /** Stable provider id (extension id), e.g. "ldmoh…" for Send. */
+    id: string;
+    /** Display name. */
+    name?: string;
+    /** Icon (data: URI or URL). */
+    icon?: string;
+    /** Routing key for the extension postMessage channel. */
+    target?: string;
+}
+interface AnnounceDiscoveryOptions {
+    /** How long to collect announce replies after the request (ms). Default 300. */
+    timeoutMs?: number;
+    /**
+     * Build a CIP-0103 provider from an announced wallet. Defaults to the
+     * self-contained `createExtensionChannelProvider` (splice postMessage over
+     * the `target` channel). Injectable so apps can substitute the official
+     * `@canton-network/dapp-sdk` `ExtensionAdapter`, and tests a mock.
+     */
+    createProvider?: (announced: AnnouncedWallet) => CIP0103Provider | Promise<CIP0103Provider>;
+}
+/**
+ * Discover wallets that advertise via `canton:announceProvider` (EIP-6963-style).
+ *
+ * Works regardless of who owns `window.canton` — this is how Send (and
+ * Console-via-announce) are found. Each result is a working CIP-0103 provider.
+ * Announce replies are deduped by id within a single call.
+ */
+declare function discoverAnnouncedProviders(options?: AnnounceDiscoveryOptions): Promise<DiscoveredProvider[]>;
+/**
+ * Discover ALL CIP-0103 wallets: the synchronous `window.canton` scan PLUS the
+ * `canton:announceProvider` handshake, MERGED and deduped by stable provider id.
+ *
+ * Dedup keys:
+ *   - INJECTED entries: resolved via {@link resolveInjectedKey} (sync id →
+ *     capped read-only status() probe → path id). Resolved in PARALLEL.
+ *   - ANNOUNCE entries: their `d.id` (== announce id == target == the wallet's
+ *     `provider.id`). NOT status-probed — an offline announce wallet (e.g. Send)
+ *     would otherwise hang up to the channel timeout.
+ *
+ * INJECTED entries are processed FIRST so the direct `window.canton` provider
+ * wins over the announce postMessage shim for a wallet reachable both ways
+ * (e.g. Console announces AND owns `window.canton` → appears exactly once).
+ *
+ * Backward-compatible superset of `discoverInjectedProviders()` (left unchanged).
+ */
+declare function discoverProviders(options?: AnnounceDiscoveryOptions): Promise<DiscoveredProvider[]>;
 
 /**
  * PartyLayerProvider — CIP-0103 Native Provider Implementation
@@ -261,6 +311,38 @@ declare function toProviderRpcError(err: unknown): ProviderRpcError;
  */
 declare function toPartyLayerError(err: ProviderRpcError): PartyLayerError;
 
+/**
+ * Extension target-channel CIP-0103 provider.
+ *
+ * Builds a working CIP-0103 provider for a wallet discovered via
+ * `canton:announceProvider` (see discovery.ts). Announce wallets route requests
+ * over the splice-wallet postMessage protocol — the dApp posts a
+ * `SPLICE_WALLET_REQUEST` on `window` and the extension replies with a
+ * `SPLICE_WALLET_RESPONSE`, correlated by JSON-RPC id and routed by `target`.
+ *
+ * This is a self-contained, dependency-free implementation of that wire
+ * protocol. We deliberately do NOT depend on `@canton-network/dapp-sdk`'s
+ * `ExtensionAdapter`: its single bundled entry statically imports
+ * `@walletconnect/sign-client` (an optional peer used only by its
+ * WalletConnectAdapter), which is not installed and breaks every downstream
+ * webpack/Next build that pulls `@partylayer/provider` into its graph
+ * (confirmed against the live demo's `next build`). The protocol constants and
+ * message shapes below mirror `@canton-network/core-types` (`WalletEvent`,
+ * `SpliceMessage`) verbatim, so behaviour matches the official adapter.
+ */
+
+interface ExtensionChannelOptions {
+    /** Routing key (announce `target`) included on every request message. */
+    target?: string;
+    /** Per-request timeout in ms. Default 30000. */
+    timeoutMs?: number;
+}
+/**
+ * Create a CIP-0103 provider that talks the splice-wallet postMessage protocol
+ * over the page `window`, routed by `target`.
+ */
+declare function createExtensionChannelProvider(options?: ExtensionChannelOptions): CIP0103Provider;
+
 /**
  * Async Wallet Handling
  *
@@ -302,37 +384,6 @@ declare function handleAsyncConnect(walletProvider: CIP0103Provider, connectResu
  */
 declare function handleAsyncPrepareExecute(walletProvider: CIP0103Provider, commandId: string, userUrl: string | undefined, options?: AsyncPrepareExecuteOptions): Promise<CIP0103TxChangedEvent>;
 
-/**
- * CAIP-2 Network Identity Utilities
- *
- * All CIP-0103 network identifiers use CAIP-2 format: "namespace:reference"
- * e.g. "canton:da-mainnet", "canton:da-devnet"
- *
- * Reference: https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md
- */
-
-declare const CANTON_NETWORKS: Record<string, string>;
-/**
- * Convert a legacy PartyLayer NetworkId (e.g. "devnet") or already-CAIP-2
- * string to a CIP-0103 Network object.
- *
- * @throws {Error} if the resulting network ID is not valid CAIP-2
- */
-declare function toCAIP2Network(networkId: string): CIP0103Network;
-/**
- * Extract the short network name from a CAIP-2 ID.
- * Returns the original string if no reverse mapping exists.
- */
-declare function fromCAIP2Network(caip2: string): string;
-/**
- * Validate that a string conforms to CAIP-2 format.
- *
- * CAIP-2 format: namespace:reference
- * - namespace: [-a-z0-9]{3,8}
- * - reference: [-_a-zA-Z0-9]{1,32}
- */
-declare function isValidCAIP2(networkId: string): boolean;
-
 /**
  * CIP-0103 Event Bus
  *
@@ -386,4 +437,4 @@ declare class MethodRouter {
     private registerDefaults;
 }
 
-export { type AsyncConnectOptions, type AsyncPrepareExecuteOptions, CANTON_NETWORKS, CIP0103EventBus, type DiscoveredProvider, JSON_RPC_ERRORS, type MethodHandler, MethodRouter, PartyLayerProvider, type PartyLayerProviderOptions, ProviderRpcError, RPC_ERRORS, chainDisconnected, createProviderBridge, disconnected, discoverInjectedProviders, fromCAIP2Network, handleAsyncConnect, handleAsyncPrepareExecute, internalError, invalidParams, isCIP0103Provider, isValidCAIP2, methodNotFound, resourceNotFound, resourceUnavailable, toCAIP2Network, toPartyLayerError, toProviderRpcError, transactionRejected, unauthorized, unsupportedMethod, userRejected, waitForProvider };
+export { type AnnounceDiscoveryOptions, type AnnouncedWallet, type AsyncConnectOptions, type AsyncPrepareExecuteOptions, type BridgeableClient, CIP0103EventBus, type DiscoveredProvider, type ExtensionChannelOptions, JSON_RPC_ERRORS, type MethodHandler, MethodRouter, PartyLayerProvider, type PartyLayerProviderOptions, ProviderRpcError, RPC_ERRORS, chainDisconnected, createExtensionChannelProvider, createProviderBridge, disconnected, discoverAnnouncedProviders, discoverInjectedProviders, discoverProviders, handleAsyncConnect, handleAsyncPrepareExecute, internalError, invalidParams, isCIP0103Provider, methodNotFound, resourceNotFound, resourceUnavailable, toPartyLayerError, toProviderRpcError, transactionRejected, unauthorized, unsupportedMethod, userRejected, waitForProvider };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { CIP0103Provider, CIP0103RequestPayload, CIP0103EventListener, PartyLayerError, CIP0103ConnectResult, CIP0103TxChangedEvent, CIP0103Network, CIP0103RequestParams } from '@partylayer/core';
-export { CIP0103Account, CIP0103AccountStatus, CIP0103ConnectResult, CIP0103Event, CIP0103EventListener, CIP0103LedgerApiRequest, CIP0103LedgerApiResponse, CIP0103Method, CIP0103Network, CIP0103Provider, CIP0103ProviderInfo, CIP0103ProviderRpcError, CIP0103ProviderType, CIP0103RequestParams, CIP0103RequestPayload, CIP0103SignMessageRequest, CIP0103StatusEvent, CIP0103TxChangedEvent, CIP0103TxExecutedPayload, CIP0103TxFailedPayload, CIP0103TxPendingPayload, CIP0103TxSignedPayload, CIP0103TxStatus, CIP0103_EVENTS, CIP0103_MANDATORY_METHODS, CIP0103_METHODS } from '@partylayer/core';
+import { CIP0103Provider, CIP0103RequestPayload, CIP0103EventListener, PartyLayerError, CIP0103ConnectResult, CIP0103TxChangedEvent, CIP0103RequestParams } from '@partylayer/core';
+export { CANTON_NETWORKS, CIP0103Account, CIP0103AccountStatus, CIP0103ConnectResult, CIP0103Event, CIP0103EventListener, CIP0103LedgerApiRequest, CIP0103LedgerApiResponse, CIP0103Method, CIP0103Network, CIP0103Provider, CIP0103ProviderInfo, CIP0103ProviderRpcError, CIP0103ProviderType, CIP0103RequestParams, CIP0103RequestPayload, CIP0103SignMessageRequest, CIP0103StatusEvent, CIP0103TxChangedEvent, CIP0103TxExecutedPayload, CIP0103TxFailedPayload, CIP0103TxPendingPayload, CIP0103TxSignedPayload, CIP0103TxStatus, CIP0103_EVENTS, CIP0103_MANDATORY_METHODS, CIP0103_METHODS, fromCAIP2Network, isValidCAIP2, toCAIP2Network } from '@partylayer/core';
 
 /**
  * CIP-0103 Wallet Discovery
@@ -21,6 +21,8 @@ interface DiscoveredProvider {
     isAsync?: boolean;
     /** Display name (if discoverable from status) */
     name?: string;
+    /** Icon (data: URI or URL) — populated for announce-discovered wallets. */
+    icon?: string;
 }
 /**
  * Check if an object implements the CIP-0103 Provider interface.
@@ -47,6 +49,54 @@ declare function discoverInjectedProviders(): DiscoveredProvider[];
  * @param timeoutMs - Maximum wait time (default 3000ms)
  */
 declare function waitForProvider(id: string, timeoutMs?: number): Promise<DiscoveredProvider | null>;
+/** Metadata carried by a `canton:announceProvider` event. */
+interface AnnouncedWallet {
+    /** Stable provider id (extension id), e.g. "ldmoh…" for Send. */
+    id: string;
+    /** Display name. */
+    name?: string;
+    /** Icon (data: URI or URL). */
+    icon?: string;
+    /** Routing key for the extension postMessage channel. */
+    target?: string;
+}
+interface AnnounceDiscoveryOptions {
+    /** How long to collect announce replies after the request (ms). Default 300. */
+    timeoutMs?: number;
+    /**
+     * Build a CIP-0103 provider from an announced wallet. Defaults to the
+     * self-contained `createExtensionChannelProvider` (splice postMessage over
+     * the `target` channel). Injectable so apps can substitute the official
+     * `@canton-network/dapp-sdk` `ExtensionAdapter`, and tests a mock.
+     */
+    createProvider?: (announced: AnnouncedWallet) => CIP0103Provider | Promise<CIP0103Provider>;
+}
+/**
+ * Discover wallets that advertise via `canton:announceProvider` (EIP-6963-style).
+ *
+ * Works regardless of who owns `window.canton` — this is how Send (and
+ * Console-via-announce) are found. Each result is a working CIP-0103 provider.
+ * Announce replies are deduped by id within a single call.
+ */
+declare function discoverAnnouncedProviders(options?: AnnounceDiscoveryOptions): Promise<DiscoveredProvider[]>;
+/**
+ * Discover ALL CIP-0103 wallets: the synchronous `window.canton` scan PLUS the
+ * `canton:announceProvider` handshake, MERGED and deduped by stable provider id.
+ *
+ * Dedup keys:
+ *   - INJECTED entries: resolved via {@link resolveInjectedKey} (sync id →
+ *     capped read-only status() probe → path id). Resolved in PARALLEL.
+ *   - ANNOUNCE entries: their `d.id` (== announce id == target == the wallet's
+ *     `provider.id`). NOT status-probed — an offline announce wallet (e.g. Send)
+ *     would otherwise hang up to the channel timeout.
+ *
+ * INJECTED entries are processed FIRST so the direct `window.canton` provider
+ * wins over the announce postMessage shim for a wallet reachable both ways
+ * (e.g. Console announces AND owns `window.canton` → appears exactly once).
+ *
+ * Backward-compatible superset of `discoverInjectedProviders()` (left unchanged).
+ */
+declare function discoverProviders(options?: AnnounceDiscoveryOptions): Promise<DiscoveredProvider[]>;
 
 /**
  * PartyLayerProvider — CIP-0103 Native Provider Implementation
@@ -261,6 +311,38 @@ declare function toProviderRpcError(err: unknown): ProviderRpcError;
  */
 declare function toPartyLayerError(err: ProviderRpcError): PartyLayerError;
 
+/**
+ * Extension target-channel CIP-0103 provider.
+ *
+ * Builds a working CIP-0103 provider for a wallet discovered via
+ * `canton:announceProvider` (see discovery.ts). Announce wallets route requests
+ * over the splice-wallet postMessage protocol — the dApp posts a
+ * `SPLICE_WALLET_REQUEST` on `window` and the extension replies with a
+ * `SPLICE_WALLET_RESPONSE`, correlated by JSON-RPC id and routed by `target`.
+ *
+ * This is a self-contained, dependency-free implementation of that wire
+ * protocol. We deliberately do NOT depend on `@canton-network/dapp-sdk`'s
+ * `ExtensionAdapter`: its single bundled entry statically imports
+ * `@walletconnect/sign-client` (an optional peer used only by its
+ * WalletConnectAdapter), which is not installed and breaks every downstream
+ * webpack/Next build that pulls `@partylayer/provider` into its graph
+ * (confirmed against the live demo's `next build`). The protocol constants and
+ * message shapes below mirror `@canton-network/core-types` (`WalletEvent`,
+ * `SpliceMessage`) verbatim, so behaviour matches the official adapter.
+ */
+
+interface ExtensionChannelOptions {
+    /** Routing key (announce `target`) included on every request message. */
+    target?: string;
+    /** Per-request timeout in ms. Default 30000. */
+    timeoutMs?: number;
+}
+/**
+ * Create a CIP-0103 provider that talks the splice-wallet postMessage protocol
+ * over the page `window`, routed by `target`.
+ */
+declare function createExtensionChannelProvider(options?: ExtensionChannelOptions): CIP0103Provider;
+
 /**
  * Async Wallet Handling
  *
@@ -302,37 +384,6 @@ declare function handleAsyncConnect(walletProvider: CIP0103Provider, connectResu
  */
 declare function handleAsyncPrepareExecute(walletProvider: CIP0103Provider, commandId: string, userUrl: string | undefined, options?: AsyncPrepareExecuteOptions): Promise<CIP0103TxChangedEvent>;
 
-/**
- * CAIP-2 Network Identity Utilities
- *
- * All CIP-0103 network identifiers use CAIP-2 format: "namespace:reference"
- * e.g. "canton:da-mainnet", "canton:da-devnet"
- *
- * Reference: https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md
- */
-
-declare const CANTON_NETWORKS: Record<string, string>;
-/**
- * Convert a legacy PartyLayer NetworkId (e.g. "devnet") or already-CAIP-2
- * string to a CIP-0103 Network object.
- *
- * @throws {Error} if the resulting network ID is not valid CAIP-2
- */
-declare function toCAIP2Network(networkId: string): CIP0103Network;
-/**
- * Extract the short network name from a CAIP-2 ID.
- * Returns the original string if no reverse mapping exists.
- */
-declare function fromCAIP2Network(caip2: string): string;
-/**
- * Validate that a string conforms to CAIP-2 format.
- *
- * CAIP-2 format: namespace:reference
- * - namespace: [-a-z0-9]{3,8}
- * - reference: [-_a-zA-Z0-9]{1,32}
- */
-declare function isValidCAIP2(networkId: string): boolean;
-
 /**
  * CIP-0103 Event Bus
  *
@@ -386,4 +437,4 @@ declare class MethodRouter {
     private registerDefaults;
 }
 
-export { type AsyncConnectOptions, type AsyncPrepareExecuteOptions, CANTON_NETWORKS, CIP0103EventBus, type DiscoveredProvider, JSON_RPC_ERRORS, type MethodHandler, MethodRouter, PartyLayerProvider, type PartyLayerProviderOptions, ProviderRpcError, RPC_ERRORS, chainDisconnected, createProviderBridge, disconnected, discoverInjectedProviders, fromCAIP2Network, handleAsyncConnect, handleAsyncPrepareExecute, internalError, invalidParams, isCIP0103Provider, isValidCAIP2, methodNotFound, resourceNotFound, resourceUnavailable, toCAIP2Network, toPartyLayerError, toProviderRpcError, transactionRejected, unauthorized, unsupportedMethod, userRejected, waitForProvider };
+export { type AnnounceDiscoveryOptions, type AnnouncedWallet, type AsyncConnectOptions, type AsyncPrepareExecuteOptions, type BridgeableClient, CIP0103EventBus, type DiscoveredProvider, type ExtensionChannelOptions, JSON_RPC_ERRORS, type MethodHandler, MethodRouter, PartyLayerProvider, type PartyLayerProviderOptions, ProviderRpcError, RPC_ERRORS, chainDisconnected, createExtensionChannelProvider, createProviderBridge, disconnected, discoverAnnouncedProviders, discoverInjectedProviders, discoverProviders, handleAsyncConnect, handleAsyncPrepareExecute, internalError, invalidParams, isCIP0103Provider, methodNotFound, resourceNotFound, resourceUnavailable, toPartyLayerError, toProviderRpcError, transactionRejected, unauthorized, unsupportedMethod, userRejected, waitForProvider };

package/dist/index.js

@@ -165,6 +165,7 @@ var ERROR_CODE_TO_RPC = {
   REGISTRY_VERIFICATION_FAILED: JSON_RPC_ERRORS.INTERNAL_ERROR,
   REGISTRY_SCHEMA_INVALID: JSON_RPC_ERRORS.INTERNAL_ERROR,
   INTERNAL_ERROR: JSON_RPC_ERRORS.INTERNAL_ERROR,
+  NETWORK_MISMATCH: JSON_RPC_ERRORS.INVALID_INPUT,
   TIMEOUT: JSON_RPC_ERRORS.INVALID_INPUT
 };
 var RPC_TO_ERROR_CODE = {
@@ -504,43 +505,8 @@ var PartyLayerProvider = class {
   }
 };
 
-// src/network.ts
-var CANTON_NETWORKS = {
-  mainnet: "canton:da-mainnet",
-  testnet: "canton:da-testnet",
-  devnet: "canton:da-devnet",
-  local: "canton:da-local"
-};
-var CAIP2_TO_SHORT = Object.fromEntries(
-  Object.entries(CANTON_NETWORKS).map(([short, full]) => [full, short])
-);
-function toCAIP2Network(networkId) {
-  let result;
-  if (networkId.includes(":")) {
-    result = networkId;
-  } else {
-    const caip2 = CANTON_NETWORKS[networkId];
-    result = caip2 ?? `canton:${networkId}`;
-  }
-  if (!isValidCAIP2(result)) {
-    throw new Error(
-      `Invalid CAIP-2 network identifier: "${result}". Expected format: "namespace:reference"`
-    );
-  }
-  return { networkId: result };
-}
-function fromCAIP2Network(caip2) {
-  const short = CAIP2_TO_SHORT[caip2];
-  if (short) return short;
-  const colonIndex = caip2.indexOf(":");
-  return colonIndex >= 0 ? caip2.slice(colonIndex + 1) : caip2;
-}
-function isValidCAIP2(networkId) {
-  return /^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$/.test(networkId);
-}
-
 // src/bridge.ts
-var PROVIDER_VERSION = "0.1.7" ;
+var PROVIDER_VERSION = "0.2.1" ;
 function createProviderBridge(client) {
   const eventBus = new CIP0103EventBus();
   const pendingEmitted = /* @__PURE__ */ new Set();
@@ -596,7 +562,7 @@ async function handleRequest(client, args, eventBus, pendingEmitted) {
             version: PROVIDER_VERSION,
             providerType: "browser"
           },
-          network: session ? toCAIP2Network(session.network) : void 0,
+          network: session ? core.toCAIP2Network(session.network) : void 0,
           session: session ? {
             accessToken: "",
             userId: String(session.partyId)
@@ -605,7 +571,7 @@ async function handleRequest(client, args, eventBus, pendingEmitted) {
       }
       case "getActiveNetwork": {
         const session = await client.getActiveSession();
-        return toCAIP2Network(
+        return core.toCAIP2Network(
           session?.network ?? "devnet"
         );
       }
@@ -715,7 +681,7 @@ function wireEvents(client, eventBus, pendingEmitted) {
         version: PROVIDER_VERSION,
         providerType: "browser"
       },
-      network: toCAIP2Network(session.network),
+      network: core.toCAIP2Network(session.network),
       session: {
         accessToken: "",
         userId: String(session.partyId)
@@ -729,7 +695,7 @@ function wireEvents(client, eventBus, pendingEmitted) {
         hint: "",
         publicKey: "",
         namespace: "",
-        networkId: toCAIP2Network(session.network).networkId,
+        networkId: core.toCAIP2Network(session.network).networkId,
         signingProviderId: ""
       }
     ]);
@@ -814,11 +780,101 @@ function sessionToAccount(session) {
     hint: "",
     publicKey: "",
     namespace: "",
-    networkId: toCAIP2Network(session.network).networkId,
+    networkId: core.toCAIP2Network(session.network).networkId,
     signingProviderId: ""
   };
 }
 
+// src/extension-channel.ts
+var SPLICE_WALLET_REQUEST = "SPLICE_WALLET_REQUEST";
+var SPLICE_WALLET_RESPONSE = "SPLICE_WALLET_RESPONSE";
+var channelSeq = 0;
+function createExtensionChannelProvider(options = {}) {
+  const target = options.target;
+  const timeoutMs = options.timeoutMs ?? 3e4;
+  const eventBus = new CIP0103EventBus();
+  const channelId = `pl-${++channelSeq}-${target ?? "ext"}`;
+  let requestSeq = 0;
+  const pending = /* @__PURE__ */ new Map();
+  function onMessage(event) {
+    if (event.source !== window) return;
+    const selfOrigin = typeof window !== "undefined" ? window.location?.origin : void 0;
+    if (selfOrigin && selfOrigin !== "null" && event.origin !== selfOrigin) return;
+    const data = event.data;
+    if (!data || data.type !== SPLICE_WALLET_RESPONSE || !data.response) return;
+    const { id, result, error } = data.response;
+    if (id === void 0 || id === null) return;
+    const entry = pending.get(String(id));
+    if (!entry) return;
+    pending.delete(String(id));
+    clearTimeout(entry.timer);
+    if (error) {
+      entry.reject(
+        new ProviderRpcError(
+          error.message || "Wallet request failed",
+          typeof error.code === "number" ? error.code : JSON_RPC_ERRORS.INTERNAL_ERROR,
+          error.data
+        )
+      );
+    } else {
+      entry.resolve(result);
+    }
+  }
+  if (typeof window !== "undefined") {
+    window.addEventListener("message", onMessage);
+  }
+  function postTargetOrigin() {
+    const origin = typeof window !== "undefined" ? window.location?.origin : void 0;
+    return origin && origin !== "null" ? origin : "*";
+  }
+  const provider = {
+    request(args) {
+      if (typeof window === "undefined") {
+        return Promise.reject(
+          new ProviderRpcError("No window: extension channel unavailable", JSON_RPC_ERRORS.INTERNAL_ERROR)
+        );
+      }
+      const id = `${channelId}-${++requestSeq}`;
+      return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+          pending.delete(id);
+          reject(
+            new ProviderRpcError(
+              `Wallet request "${args.method}" timed out after ${timeoutMs}ms`,
+              JSON_RPC_ERRORS.INTERNAL_ERROR
+            )
+          );
+        }, timeoutMs);
+        pending.set(id, { resolve, reject, timer });
+        const message = {
+          type: SPLICE_WALLET_REQUEST,
+          request: {
+            jsonrpc: "2.0",
+            id,
+            method: args.method,
+            ...args.params !== void 0 ? { params: args.params } : {}
+          },
+          ...target ? { target } : {}
+        };
+        window.postMessage(message, postTargetOrigin());
+      });
+    },
+    on(event, listener) {
+      eventBus.on(event, listener);
+      return provider;
+    },
+    emit(event, ...args) {
+      return eventBus.emit(event, ...args);
+    },
+    removeListener(event, listener) {
+      eventBus.removeListener(event, listener);
+      return provider;
+    }
+  };
+  eventBus.setOwner(provider);
+  return provider;
+}
+
 // src/discovery.ts
 var KNOWN_INJECTION_PATHS = [
   "canton",
@@ -892,7 +948,108 @@ function findById(id) {
     (p) => p.id === id || p.id.endsWith(`.${id}`)
   );
 }
+var CANTON_REQUEST_PROVIDER_EVENT = "canton:requestProvider";
+var CANTON_ANNOUNCE_PROVIDER_EVENT = "canton:announceProvider";
+function defaultAnnounceProvider(announced) {
+  return createExtensionChannelProvider({ target: announced.target });
+}
+async function discoverAnnouncedProviders(options = {}) {
+  if (typeof window === "undefined") return [];
+  const timeoutMs = options.timeoutMs ?? 300;
+  const make = options.createProvider ?? defaultAnnounceProvider;
+  const announced = /* @__PURE__ */ new Map();
+  const onAnnounce = (event) => {
+    const detail = event.detail;
+    if (!detail) return;
+    const rawId = detail.providerId ?? detail.id;
+    if (typeof rawId !== "string" || rawId.length === 0) return;
+    if (announced.has(rawId)) return;
+    announced.set(rawId, {
+      id: rawId,
+      name: typeof detail.name === "string" ? detail.name : void 0,
+      icon: typeof detail.icon === "string" ? detail.icon : void 0,
+      target: typeof detail.target === "string" ? detail.target : void 0
+    });
+  };
+  window.addEventListener(
+    CANTON_ANNOUNCE_PROVIDER_EVENT,
+    onAnnounce
+  );
+  try {
+    window.dispatchEvent(new CustomEvent(CANTON_REQUEST_PROVIDER_EVENT));
+    await new Promise((resolve) => setTimeout(resolve, timeoutMs));
+  } finally {
+    window.removeEventListener(
+      CANTON_ANNOUNCE_PROVIDER_EVENT,
+      onAnnounce
+    );
+  }
+  const results = [];
+  for (const wallet of announced.values()) {
+    let provider;
+    try {
+      provider = await make(wallet);
+    } catch {
+      continue;
+    }
+    if (!isCIP0103Provider(provider)) continue;
+    results.push({
+      id: wallet.id,
+      provider,
+      source: "injected",
+      name: wallet.name,
+      icon: wallet.icon
+    });
+  }
+  return results;
+}
+var INJECTED_ID_PROBE_TIMEOUT_MS = 1500;
+function raceTimeout(promise, ms) {
+  return Promise.race([
+    promise,
+    new Promise(
+      (_, reject) => setTimeout(() => reject(new Error("id-probe timeout")), ms)
+    )
+  ]);
+}
+async function resolveInjectedKey(d) {
+  const sync = d.provider.id;
+  if (typeof sync === "string" && sync.length > 0) return sync;
+  try {
+    const status = await raceTimeout(
+      d.provider.request({ method: "status" }),
+      INJECTED_ID_PROBE_TIMEOUT_MS
+    );
+    const pid = status?.provider?.id;
+    if (typeof pid === "string" && pid.length > 0) return pid;
+  } catch {
+  }
+  return d.id;
+}
+async function discoverProviders(options = {}) {
+  const injected = discoverInjectedProviders();
+  const announcedResults = await discoverAnnouncedProviders(options);
+  const injectedKeys = await Promise.all(injected.map(resolveInjectedKey));
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  injected.forEach((d, i) => {
+    const key = injectedKeys[i];
+    if (seen.has(key)) return;
+    seen.add(key);
+    out.push(d);
+  });
+  for (const d of announcedResults) {
+    if (seen.has(d.id)) continue;
+    seen.add(d.id);
+    out.push(d);
+  }
+  return out;
+}
 
+Object.defineProperty(exports, "CANTON_NETWORKS", {
+  enumerable: true,
+  get: function () { return core.CANTON_NETWORKS; }
+});
 Object.defineProperty(exports, "CIP0103_EVENTS", {
   enumerable: true,
   get: function () { return core.CIP0103_EVENTS; }
@@ -905,7 +1062,18 @@ Object.defineProperty(exports, "CIP0103_METHODS", {
   enumerable: true,
   get: function () { return core.CIP0103_METHODS; }
 });
-exports.CANTON_NETWORKS = CANTON_NETWORKS;
+Object.defineProperty(exports, "fromCAIP2Network", {
+  enumerable: true,
+  get: function () { return core.fromCAIP2Network; }
+});
+Object.defineProperty(exports, "isValidCAIP2", {
+  enumerable: true,
+  get: function () { return core.isValidCAIP2; }
+});
+Object.defineProperty(exports, "toCAIP2Network", {
+  enumerable: true,
+  get: function () { return core.toCAIP2Network; }
+});
 exports.CIP0103EventBus = CIP0103EventBus;
 exports.JSON_RPC_ERRORS = JSON_RPC_ERRORS;
 exports.MethodRouter = MethodRouter;
@@ -913,20 +1081,20 @@ exports.PartyLayerProvider = PartyLayerProvider;
 exports.ProviderRpcError = ProviderRpcError;
 exports.RPC_ERRORS = RPC_ERRORS;
 exports.chainDisconnected = chainDisconnected;
+exports.createExtensionChannelProvider = createExtensionChannelProvider;
 exports.createProviderBridge = createProviderBridge;
 exports.disconnected = disconnected;
+exports.discoverAnnouncedProviders = discoverAnnouncedProviders;
 exports.discoverInjectedProviders = discoverInjectedProviders;
-exports.fromCAIP2Network = fromCAIP2Network;
+exports.discoverProviders = discoverProviders;
 exports.handleAsyncConnect = handleAsyncConnect;
 exports.handleAsyncPrepareExecute = handleAsyncPrepareExecute;
 exports.internalError = internalError;
 exports.invalidParams = invalidParams;
 exports.isCIP0103Provider = isCIP0103Provider;
-exports.isValidCAIP2 = isValidCAIP2;
 exports.methodNotFound = methodNotFound;
 exports.resourceNotFound = resourceNotFound;
 exports.resourceUnavailable = resourceUnavailable;
-exports.toCAIP2Network = toCAIP2Network;
 exports.toPartyLayerError = toPartyLayerError;
 exports.toProviderRpcError = toProviderRpcError;
 exports.transactionRejected = transactionRejected;