@partylayer/sdk 0.4.1 → 0.6.0

package/dist/index.d.mts

@@ -84,6 +84,19 @@ interface PartyLayerConfig {
     channel?: 'stable' | 'beta';
     /** Default network */
     network: NetworkId;
+    /**
+     * Network-mismatch enforcement policy (default: `'guard'`).
+     *
+     * When a connected wallet's effective network differs from `network`:
+     * - `'off'`    — detect + emit `session:networkMismatch` only; never block.
+     * - `'guard'`  — (default) block wrong-network TRANSACTIONS (signMessage,
+     *   signTransaction, submitTransaction, ledgerApi); connect still succeeds.
+     * - `'strict'` — also block CONNECT (throws `NetworkMismatchError`).
+     *
+     * BEHAVIOR CHANGE: prior to this, wrong-network transactions always
+     * proceeded. Set `'off'` to restore that.
+     */
+    networkEnforcement?: 'off' | 'guard' | 'strict';
     /**
      * Wallet adapters to register (OPTIONAL)
      *
@@ -165,6 +178,12 @@ interface ConnectOptions {
     requiredCapabilities?: string[];
     /** Timeout in milliseconds */
     timeoutMs?: number;
+    /**
+     * Called with a pairing/display URI (e.g. a WalletConnect `wc:` URI) the
+     * moment the adapter produces one, before approval. Used by the connect UI
+     * to render a QR / deep-link. Adapters without such a URI never call it.
+     */
+    onDisplayUri?: (uri: string) => void;
 }
 /**
  * Wallet filter options
@@ -226,6 +245,21 @@ interface SessionExpiredEvent {
     type: 'session:expired';
     sessionId: SessionId;
 }
+/**
+ * Network mismatch event — the connected wallet's effective network differs
+ * from the dApp's configured network. Emitted under ALL policies (informational);
+ * `enforced` is true when the active policy ('guard' | 'strict') will block.
+ */
+interface SessionNetworkMismatchEvent {
+    type: 'session:networkMismatch';
+    sessionId: SessionId;
+    /** dApp-configured (expected) network, CAIP-2 normalized. */
+    expected: string;
+    /** Wallet-reported (actual) network, CAIP-2 normalized. */
+    actual: string;
+    /** Whether the active policy will block (guard|strict) vs. detect-only (off). */
+    enforced: boolean;
+}
 /**
  * Transaction status event
  */
@@ -246,7 +280,7 @@ interface ErrorEvent {
 /**
  * All event types
  */
-type PartyLayerEvent = RegistryUpdatedEvent | RegistryStatusEvent | SessionConnectedEvent | SessionDisconnectedEvent | SessionExpiredEvent | TxStatusEvent | ErrorEvent;
+type PartyLayerEvent = RegistryUpdatedEvent | RegistryStatusEvent | SessionConnectedEvent | SessionDisconnectedEvent | SessionExpiredEvent | SessionNetworkMismatchEvent | TxStatusEvent | ErrorEvent;
 /**
  * Event handler type
  */
@@ -297,6 +331,20 @@ declare class PartyLayerClient {
      * List available wallets
      */
     listWallets(filter?: WalletFilter): Promise<WalletInfo[]>;
+    /** Active network-enforcement policy (default 'guard'). */
+    private get enforcement();
+    /**
+     * Detect a confident network mismatch between the dApp's configured network
+     * and the session's (wallet-reported) network. Returns null when they match
+     * or the comparison isn't confident (conservative — never a false positive).
+     */
+    private networkMismatch;
+    /**
+     * Guard a transaction-class operation: throw `NetworkMismatchError` when the
+     * session is on the wrong network AND the policy enforces it ('guard' |
+     * 'strict'). Also protects restored sessions and mid-session network switches.
+     */
+    private assertNetworkOk;
     /**
      * Connect to a wallet
      */

package/dist/index.d.ts

@@ -84,6 +84,19 @@ interface PartyLayerConfig {
     channel?: 'stable' | 'beta';
     /** Default network */
     network: NetworkId;
+    /**
+     * Network-mismatch enforcement policy (default: `'guard'`).
+     *
+     * When a connected wallet's effective network differs from `network`:
+     * - `'off'`    — detect + emit `session:networkMismatch` only; never block.
+     * - `'guard'`  — (default) block wrong-network TRANSACTIONS (signMessage,
+     *   signTransaction, submitTransaction, ledgerApi); connect still succeeds.
+     * - `'strict'` — also block CONNECT (throws `NetworkMismatchError`).
+     *
+     * BEHAVIOR CHANGE: prior to this, wrong-network transactions always
+     * proceeded. Set `'off'` to restore that.
+     */
+    networkEnforcement?: 'off' | 'guard' | 'strict';
     /**
      * Wallet adapters to register (OPTIONAL)
      *
@@ -165,6 +178,12 @@ interface ConnectOptions {
     requiredCapabilities?: string[];
     /** Timeout in milliseconds */
     timeoutMs?: number;
+    /**
+     * Called with a pairing/display URI (e.g. a WalletConnect `wc:` URI) the
+     * moment the adapter produces one, before approval. Used by the connect UI
+     * to render a QR / deep-link. Adapters without such a URI never call it.
+     */
+    onDisplayUri?: (uri: string) => void;
 }
 /**
  * Wallet filter options
@@ -226,6 +245,21 @@ interface SessionExpiredEvent {
     type: 'session:expired';
     sessionId: SessionId;
 }
+/**
+ * Network mismatch event — the connected wallet's effective network differs
+ * from the dApp's configured network. Emitted under ALL policies (informational);
+ * `enforced` is true when the active policy ('guard' | 'strict') will block.
+ */
+interface SessionNetworkMismatchEvent {
+    type: 'session:networkMismatch';
+    sessionId: SessionId;
+    /** dApp-configured (expected) network, CAIP-2 normalized. */
+    expected: string;
+    /** Wallet-reported (actual) network, CAIP-2 normalized. */
+    actual: string;
+    /** Whether the active policy will block (guard|strict) vs. detect-only (off). */
+    enforced: boolean;
+}
 /**
  * Transaction status event
  */
@@ -246,7 +280,7 @@ interface ErrorEvent {
 /**
  * All event types
  */
-type PartyLayerEvent = RegistryUpdatedEvent | RegistryStatusEvent | SessionConnectedEvent | SessionDisconnectedEvent | SessionExpiredEvent | TxStatusEvent | ErrorEvent;
+type PartyLayerEvent = RegistryUpdatedEvent | RegistryStatusEvent | SessionConnectedEvent | SessionDisconnectedEvent | SessionExpiredEvent | SessionNetworkMismatchEvent | TxStatusEvent | ErrorEvent;
 /**
  * Event handler type
  */
@@ -297,6 +331,20 @@ declare class PartyLayerClient {
      * List available wallets
      */
     listWallets(filter?: WalletFilter): Promise<WalletInfo[]>;
+    /** Active network-enforcement policy (default 'guard'). */
+    private get enforcement();
+    /**
+     * Detect a confident network mismatch between the dApp's configured network
+     * and the session's (wallet-reported) network. Returns null when they match
+     * or the comparison isn't confident (conservative — never a false positive).
+     */
+    private networkMismatch;
+    /**
+     * Guard a transaction-class operation: throw `NetworkMismatchError` when the
+     * session is on the wrong network AND the policy enforces it ('guard' |
+     * 'strict'). Also protects restored sessions and mid-session network switches.
+     */
+    private assertNetworkOk;
     /**
      * Connect to a wallet
      */

package/dist/index.js

@@ -2,20 +2,15 @@
 
 var core = require('@partylayer/core');
 var registryClient = require('@partylayer/registry-client');
+var provider = require('@partylayer/provider');
 var adapterConsole = require('@partylayer/adapter-console');
 var adapterLoop = require('@partylayer/adapter-loop');
 var adapterCantor8 = require('@partylayer/adapter-cantor8');
 var adapterNightly = require('@partylayer/adapter-nightly');
 var adapterSend = require('@partylayer/adapter-send');
 var adapterBron = require('@partylayer/adapter-bron');
-var provider = require('@partylayer/provider');
 
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
+// src/client.ts
 
 // src/config.ts
 var DEFAULT_REGISTRY_URL = "https://registry.partylayer.xyz";
@@ -494,6 +489,29 @@ var PartyLayerClient = class {
     }
     return registryWallets;
   }
+  /** Active network-enforcement policy (default 'guard'). */
+  get enforcement() {
+    return this.config.networkEnforcement ?? "guard";
+  }
+  /**
+   * Detect a confident network mismatch between the dApp's configured network
+   * and the session's (wallet-reported) network. Returns null when they match
+   * or the comparison isn't confident (conservative — never a false positive).
+   */
+  networkMismatch(session) {
+    return core.detectNetworkMismatch(this.config.network, session.network);
+  }
+  /**
+   * Guard a transaction-class operation: throw `NetworkMismatchError` when the
+   * session is on the wrong network AND the policy enforces it ('guard' |
+   * 'strict'). Also protects restored sessions and mid-session network switches.
+   */
+  assertNetworkOk(session) {
+    const mm = this.networkMismatch(session);
+    if (mm && this.enforcement !== "off") {
+      throw new core.NetworkMismatchError(mm.expected, mm.actual);
+    }
+  }
   /**
    * Connect to a wallet
    */
@@ -574,7 +592,8 @@ var PartyLayerClient = class {
       const connectPromise = adapter.connect(ctx, {
         timeoutMs,
         partyId: void 0,
-        preferInstalled: options?.preferInstalled
+        preferInstalled: options?.preferInstalled,
+        onDisplayUri: options?.onDisplayUri
       });
       const timeoutPromise = new Promise((_, reject) => {
         setTimeout(() => {
@@ -586,13 +605,31 @@ var PartyLayerClient = class {
         sessionId: core.toSessionId(`session_${Date.now()}_${Math.random().toString(36).substring(2, 15)}`),
         walletId: selectedWallet.walletId,
         partyId: result.partyId,
-        network: this.config.network,
+        // The wallet's reported network (adapters that read the live wallet —
+        // e.g. Console via getActiveNetwork — surface the actual network here;
+        // echo-only adapters report ctx.network === config.network). Used for
+        // mismatch detection; falls back to the configured network.
+        network: result.session.network ?? this.config.network,
         createdAt: Date.now(),
         expiresAt: result.session.expiresAt,
         origin: this.origin,
         capabilitiesSnapshot: result.capabilities,
         metadata: result.session.metadata
       };
+      const mismatch = this.networkMismatch(session);
+      if (mismatch) {
+        session.networkMismatch = mismatch;
+        this.emit("session:networkMismatch", {
+          type: "session:networkMismatch",
+          sessionId: session.sessionId,
+          expected: mismatch.expected,
+          actual: mismatch.actual,
+          enforced: this.enforcement !== "off"
+        });
+        if (this.enforcement === "strict") {
+          throw new core.NetworkMismatchError(mismatch.expected, mismatch.actual);
+        }
+      }
       await this.persistSession(session);
       this.activeSession = session;
       this.updateRegistryStatus();
@@ -676,6 +713,7 @@ var PartyLayerClient = class {
       );
     }
     try {
+      this.assertNetworkOk(session);
       const ctx = this.createAdapterContext();
       return await adapter.signMessage(ctx, session, params);
     } catch (err) {
@@ -703,6 +741,7 @@ var PartyLayerClient = class {
       );
     }
     try {
+      this.assertNetworkOk(session);
       const ctx = this.createAdapterContext();
       const result = await adapter.signTransaction(ctx, session, params);
       this.emit("tx:status", {
@@ -738,6 +777,7 @@ var PartyLayerClient = class {
       );
     }
     try {
+      this.assertNetworkOk(session);
       const ctx = this.createAdapterContext();
       const result = await adapter.submitTransaction(ctx, session, params);
       this.emit("tx:status", {
@@ -773,6 +813,7 @@ var PartyLayerClient = class {
       );
     }
     try {
+      this.assertNetworkOk(session);
       const ctx = this.createAdapterContext();
       return await adapter.ledgerApi(ctx, session, params);
     } catch (err) {
@@ -822,8 +863,7 @@ var PartyLayerClient = class {
    * @returns CIP-0103 compliant Provider
    */
   asProvider() {
-    const { createProviderBridge: createProviderBridge2 } = __require("@partylayer/provider");
-    return createProviderBridge2(this);
+    return provider.createProviderBridge(this);
   }
   /**
    * Destroy client and cleanup
@@ -1096,30 +1136,6 @@ Object.defineProperty(exports, "matchesProviderDetection", {
   enumerable: true,
   get: function () { return registryClient.matchesProviderDetection; }
 });
-Object.defineProperty(exports, "ConsoleAdapter", {
-  enumerable: true,
-  get: function () { return adapterConsole.ConsoleAdapter; }
-});
-Object.defineProperty(exports, "LoopAdapter", {
-  enumerable: true,
-  get: function () { return adapterLoop.LoopAdapter; }
-});
-Object.defineProperty(exports, "Cantor8Adapter", {
-  enumerable: true,
-  get: function () { return adapterCantor8.Cantor8Adapter; }
-});
-Object.defineProperty(exports, "NightlyAdapter", {
-  enumerable: true,
-  get: function () { return adapterNightly.NightlyAdapter; }
-});
-Object.defineProperty(exports, "SendAdapter", {
-  enumerable: true,
-  get: function () { return adapterSend.SendAdapter; }
-});
-Object.defineProperty(exports, "BronAdapter", {
-  enumerable: true,
-  get: function () { return adapterBron.BronAdapter; }
-});
 Object.defineProperty(exports, "CANTON_NETWORKS", {
   enumerable: true,
   get: function () { return provider.CANTON_NETWORKS; }
@@ -1184,6 +1200,30 @@ Object.defineProperty(exports, "waitForProvider", {
   enumerable: true,
   get: function () { return provider.waitForProvider; }
 });
+Object.defineProperty(exports, "ConsoleAdapter", {
+  enumerable: true,
+  get: function () { return adapterConsole.ConsoleAdapter; }
+});
+Object.defineProperty(exports, "LoopAdapter", {
+  enumerable: true,
+  get: function () { return adapterLoop.LoopAdapter; }
+});
+Object.defineProperty(exports, "Cantor8Adapter", {
+  enumerable: true,
+  get: function () { return adapterCantor8.Cantor8Adapter; }
+});
+Object.defineProperty(exports, "NightlyAdapter", {
+  enumerable: true,
+  get: function () { return adapterNightly.NightlyAdapter; }
+});
+Object.defineProperty(exports, "SendAdapter", {
+  enumerable: true,
+  get: function () { return adapterSend.SendAdapter; }
+});
+Object.defineProperty(exports, "BronAdapter", {
+  enumerable: true,
+  get: function () { return adapterBron.BronAdapter; }
+});
 exports.CantonConnectClient = PartyLayerClient;
 exports.DEFAULT_REGISTRY_URL = DEFAULT_REGISTRY_URL;
 exports.MetricsTelemetryAdapter = MetricsTelemetryAdapter;