@partylayer/provider 0.2.0 → 0.2.2

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
@@ -23,6 +23,24 @@ interface DiscoveredProvider {
     name?: string;
     /** Icon (data: URI or URL) — populated for announce-discovered wallets. */
     icon?: string;
+    /**
+     * Whether this entry's STABLE IDENTITY was resolved (additive; A2.1).
+     *
+     * - announce-discovered entries: always `true` — the announce `id` IS the
+     *   wallet's real extension id (canonical provider.md: announce is the
+     *   discovery path).
+     * - injected (`window.canton` scan) entries: `true` only when a sync
+     *   `provider.id` or a `status().provider.id` probe yielded a real id;
+     *   `false` when discovery fell back to the path id (an identity-LESS bare
+     *   slot, e.g. Console's `{request,on,emit,removeListener,source}` with no id).
+     *
+     * LIVE INCIDENT (partylayer.xyz post-A2): an identity-less bare slot resolved
+     * to the path id `'canton'`; downstream that synthesized a phantom "Canton
+     * Wallet" (`browser:ext:canton`) picker entry whose provider was the slot
+     * itself. Consumers MUST drop unresolved injected entries rather than list
+     * them — correctness must not depend on probe timing.
+     */
+    identityResolved?: boolean;
 }
 /**
  * Check if an object implements the CIP-0103 Provider interface.
@@ -384,37 +402,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
  *
@@ -468,4 +455,4 @@ declare class MethodRouter {
     private registerDefaults;
 }
 
-export { type AnnounceDiscoveryOptions, type AnnouncedWallet, type AsyncConnectOptions, type AsyncPrepareExecuteOptions, type BridgeableClient, CANTON_NETWORKS, CIP0103EventBus, type DiscoveredProvider, type ExtensionChannelOptions, JSON_RPC_ERRORS, type MethodHandler, MethodRouter, PartyLayerProvider, type PartyLayerProviderOptions, ProviderRpcError, RPC_ERRORS, chainDisconnected, createExtensionChannelProvider, createProviderBridge, disconnected, discoverAnnouncedProviders, discoverInjectedProviders, discoverProviders, 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
@@ -23,6 +23,24 @@ interface DiscoveredProvider {
     name?: string;
     /** Icon (data: URI or URL) — populated for announce-discovered wallets. */
     icon?: string;
+    /**
+     * Whether this entry's STABLE IDENTITY was resolved (additive; A2.1).
+     *
+     * - announce-discovered entries: always `true` — the announce `id` IS the
+     *   wallet's real extension id (canonical provider.md: announce is the
+     *   discovery path).
+     * - injected (`window.canton` scan) entries: `true` only when a sync
+     *   `provider.id` or a `status().provider.id` probe yielded a real id;
+     *   `false` when discovery fell back to the path id (an identity-LESS bare
+     *   slot, e.g. Console's `{request,on,emit,removeListener,source}` with no id).
+     *
+     * LIVE INCIDENT (partylayer.xyz post-A2): an identity-less bare slot resolved
+     * to the path id `'canton'`; downstream that synthesized a phantom "Canton
+     * Wallet" (`browser:ext:canton`) picker entry whose provider was the slot
+     * itself. Consumers MUST drop unresolved injected entries rather than list
+     * them — correctness must not depend on probe timing.
+     */
+    identityResolved?: boolean;
 }
 /**
  * Check if an object implements the CIP-0103 Provider interface.
@@ -384,37 +402,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
  *
@@ -468,4 +455,4 @@ declare class MethodRouter {
     private registerDefaults;
 }
 
-export { type AnnounceDiscoveryOptions, type AnnouncedWallet, type AsyncConnectOptions, type AsyncPrepareExecuteOptions, type BridgeableClient, CANTON_NETWORKS, CIP0103EventBus, type DiscoveredProvider, type ExtensionChannelOptions, JSON_RPC_ERRORS, type MethodHandler, MethodRouter, PartyLayerProvider, type PartyLayerProviderOptions, ProviderRpcError, RPC_ERRORS, chainDisconnected, createExtensionChannelProvider, createProviderBridge, disconnected, discoverAnnouncedProviders, discoverInjectedProviders, discoverProviders, 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.2.0" ;
+var PROVIDER_VERSION = "0.2.2" ;
 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,7 +780,7 @@ function sessionToAccount(session) {
     hint: "",
     publicKey: "",
     namespace: "",
-    networkId: toCAIP2Network(session.network).networkId,
+    networkId: core.toCAIP2Network(session.network).networkId,
     signingProviderId: ""
   };
 }
@@ -985,7 +951,7 @@ function findById(id) {
 var CANTON_REQUEST_PROVIDER_EVENT = "canton:requestProvider";
 var CANTON_ANNOUNCE_PROVIDER_EVENT = "canton:announceProvider";
 function defaultAnnounceProvider(announced) {
-  return createExtensionChannelProvider({ target: announced.target });
+  return createExtensionChannelProvider({ target: announced.target ?? announced.id });
 }
 async function discoverAnnouncedProviders(options = {}) {
   if (typeof window === "undefined") return [];
@@ -1048,17 +1014,17 @@ function raceTimeout(promise, ms) {
 }
 async function resolveInjectedKey(d) {
   const sync = d.provider.id;
-  if (typeof sync === "string" && sync.length > 0) return sync;
+  if (typeof sync === "string" && sync.length > 0) return { key: sync, resolved: true };
   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;
+    if (typeof pid === "string" && pid.length > 0) return { key: pid, resolved: true };
   } catch {
   }
-  return d.id;
+  return { key: d.id, resolved: false };
 }
 async function discoverProviders(options = {}) {
   const injected = discoverInjectedProviders();
@@ -1067,19 +1033,23 @@ async function discoverProviders(options = {}) {
   const out = [];
   const seen = /* @__PURE__ */ new Set();
   injected.forEach((d, i) => {
-    const key = injectedKeys[i];
+    const { key, resolved } = injectedKeys[i];
     if (seen.has(key)) return;
     seen.add(key);
-    out.push(d);
+    out.push({ ...d, id: resolved ? key : d.id, identityResolved: resolved });
   });
   for (const d of announcedResults) {
     if (seen.has(d.id)) continue;
     seen.add(d.id);
-    out.push(d);
+    out.push({ ...d, identityResolved: true });
   }
   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; }
@@ -1092,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;
@@ -1106,17 +1087,14 @@ exports.disconnected = disconnected;
 exports.discoverAnnouncedProviders = discoverAnnouncedProviders;
 exports.discoverInjectedProviders = discoverInjectedProviders;
 exports.discoverProviders = discoverProviders;
-exports.fromCAIP2Network = fromCAIP2Network;
 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;