@asseteragmbh/wallet-connector 0.1.0

package/dist/index.cjs

@@ -0,0 +1,332 @@
+'use strict';
+
+// src/protocol.ts
+var PROTOCOL_VERSION = 1;
+var CONNECT_PATH = "/connect";
+var MESSAGE_PREFIX = "assetera-wallet:";
+var SUPPORTED_METHODS = [
+  "eth_requestAccounts",
+  "eth_accounts",
+  "eth_chainId",
+  "wallet_switchEthereumChain",
+  "personal_sign",
+  "eth_signTypedData_v4",
+  "eth_sendTransaction"
+];
+function isSupportedMethod(method) {
+  return SUPPORTED_METHODS.includes(method);
+}
+var RpcErrorCode = {
+  /** The client rejected the request in the pop-up. */
+  UserRejected: 4001,
+  /** Not connected yet (no `eth_requestAccounts` approved in this pop-up). */
+  Unauthorized: 4100,
+  /** The method is not in SUPPORTED_METHODS. */
+  UnsupportedMethod: 4200,
+  /** The pop-up closed, or the wallet session ended. */
+  Disconnected: 4900,
+  /** `wallet_switchEthereumChain` to a chain the wallet does not offer. */
+  UnrecognizedChain: 4902,
+  /** Malformed params. */
+  InvalidParams: -32602,
+  /** Anything unexpected inside the wallet. */
+  Internal: -32603
+};
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function hasType(value, suffix) {
+  return isRecord(value) && value.type === `${MESSAGE_PREFIX}${suffix}` && value.v === PROTOCOL_VERSION;
+}
+function isReadyMessage(value) {
+  return hasType(value, "ready");
+}
+function isResponseMessage(value) {
+  return hasType(value, "response") && typeof value.id === "string" && ("result" in value || isRecord(value.error) && typeof value.error.code === "number");
+}
+function isEventMessage(value) {
+  return hasType(value, "event") && (value.event === "accountsChanged" || value.event === "chainChanged" || value.event === "disconnect");
+}
+function isRequestMessage(value) {
+  return hasType(value, "request") && typeof value.id === "string" && typeof value.method === "string";
+}
+function isDisconnectMessage(value) {
+  return hasType(value, "disconnect");
+}
+function connectUrl(walletUrl, partnerOrigin) {
+  const url = new URL(CONNECT_PATH, walletUrl);
+  url.searchParams.set("origin", partnerOrigin);
+  url.searchParams.set("v", String(PROTOCOL_VERSION));
+  return url.toString();
+}
+
+// src/provider.ts
+var ProviderRpcError = class extends Error {
+  code;
+  data;
+  constructor(code, message, data) {
+    super(message);
+    this.name = "ProviderRpcError";
+    this.code = code;
+    this.data = data;
+  }
+};
+var DEFAULT_POPUP_FEATURES = "popup,width=420,height=720";
+var POPUP_NAME = "assetera-wallet";
+var CLOSE_POLL_MS = 500;
+var SIGNING_METHODS = /* @__PURE__ */ new Set([
+  "personal_sign",
+  "eth_signTypedData_v4",
+  "eth_sendTransaction"
+]);
+function createDeferred() {
+  let resolve;
+  let reject;
+  const promise = new Promise((res, rej) => {
+    resolve = res;
+    reject = rej;
+  });
+  void promise.catch(() => {
+  });
+  return { promise, resolve, reject };
+}
+function toHexChainId(chainId) {
+  return `0x${chainId.toString(16)}`;
+}
+function createAsseteraWalletProvider(options) {
+  const { defaultChainId } = options;
+  const walletOrigin = new URL(options.walletUrl).origin;
+  const popupFeatures = options.popupFeatures ?? DEFAULT_POPUP_FEATURES;
+  let popup = null;
+  let ready = createDeferred();
+  let accounts = [];
+  let chainIdHex = null;
+  let walletDisconnected = false;
+  const pending = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Map();
+  let closeTimer = null;
+  function currentChainId() {
+    return chainIdHex ?? toHexChainId(defaultChainId);
+  }
+  function blockedError() {
+    return new ProviderRpcError(
+      RpcErrorCode.Disconnected,
+      "The Assetera Wallet pop-up was blocked by the browser. The pop-up must be opened from a user click (for example a button press) and then the request retried."
+    );
+  }
+  function disconnectedError(message = "The Assetera Wallet pop-up was closed.") {
+    return new ProviderRpcError(RpcErrorCode.Disconnected, message);
+  }
+  function emit(event, ...args) {
+    const set = listeners.get(event);
+    if (!set) return;
+    for (const listener of set) {
+      try {
+        listener(...args);
+      } catch (error) {
+        console.error(`[assetera-wallet] listener for "${event}" threw`, error);
+      }
+    }
+  }
+  function addListener(event, listener) {
+    let set = listeners.get(event);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      listeners.set(event, set);
+    }
+    set.add(listener);
+  }
+  function removeEventListener(event, listener) {
+    listeners.get(event)?.delete(listener);
+  }
+  function stopClosePolling() {
+    if (closeTimer !== null) {
+      clearInterval(closeTimer);
+      closeTimer = null;
+    }
+  }
+  function startClosePolling() {
+    if (closeTimer !== null) return;
+    closeTimer = setInterval(() => {
+      if (popup?.closed) handlePopupClosed();
+    }, CLOSE_POLL_MS);
+  }
+  function rejectAllPending(error) {
+    for (const request2 of pending.values()) request2.reject(error);
+    pending.clear();
+  }
+  function handlePopupClosed() {
+    const hadPending = pending.size > 0;
+    stopClosePolling();
+    const closedPopup = popup;
+    popup = null;
+    const closedReady = ready;
+    ready = createDeferred();
+    const error = disconnectedError();
+    if (closedPopup) closedReady.reject(error);
+    rejectAllPending(error);
+    const shouldEmit = hadPending || walletDisconnected;
+    walletDisconnected = false;
+    if (shouldEmit) emit("disconnect", error);
+  }
+  function openPopup() {
+    if (popup && !popup.closed) {
+      popup.focus();
+      return popup;
+    }
+    if (typeof window === "undefined") return null;
+    const opened = window.open(
+      connectUrl(options.walletUrl, window.location.origin),
+      POPUP_NAME,
+      popupFeatures
+    );
+    if (!opened) return null;
+    popup = opened;
+    ready = createDeferred();
+    walletDisconnected = false;
+    startClosePolling();
+    return opened;
+  }
+  function sendRequest(method, params) {
+    const active = popup;
+    if (!active || active.closed) return Promise.reject(disconnectedError());
+    const id = crypto.randomUUID();
+    const message = {
+      type: `${MESSAGE_PREFIX}request`,
+      v: PROTOCOL_VERSION,
+      id,
+      method,
+      ...params === void 0 ? {} : { params }
+    };
+    return new Promise((resolve, reject) => {
+      pending.set(id, { resolve, reject });
+      active.postMessage(message, walletOrigin);
+    });
+  }
+  function handleResponse(message) {
+    const request2 = pending.get(message.id);
+    if (!request2) return;
+    pending.delete(message.id);
+    if ("error" in message) {
+      request2.reject(new ProviderRpcError(message.error.code, message.error.message, message.error.data));
+    } else {
+      request2.resolve(message.result);
+    }
+  }
+  function handleEventMessage(message) {
+    if (message.event === "accountsChanged") {
+      accounts = [...message.data];
+      emit("accountsChanged", [...accounts]);
+      return;
+    }
+    if (message.event === "chainChanged") {
+      chainIdHex = message.data;
+      emit("chainChanged", chainIdHex);
+      return;
+    }
+    walletDisconnected = true;
+    emit("disconnect", new ProviderRpcError(message.data.code, message.data.message, message.data.data));
+  }
+  function onWindowMessage(event) {
+    if (event.origin !== walletOrigin) return;
+    if (popup === null || event.source !== popup) return;
+    const data = event.data;
+    if (isReadyMessage(data)) {
+      ready.resolve(void 0);
+      return;
+    }
+    if (isResponseMessage(data)) {
+      handleResponse(data);
+      return;
+    }
+    if (isEventMessage(data)) handleEventMessage(data);
+  }
+  if (typeof window !== "undefined") window.addEventListener("message", onWindowMessage);
+  function request({ method, params }) {
+    if (typeof window === "undefined") {
+      return Promise.reject(
+        new ProviderRpcError(
+          RpcErrorCode.Disconnected,
+          "The Assetera Wallet provider can only run in a browser."
+        )
+      );
+    }
+    if (!isSupportedMethod(method)) {
+      return Promise.reject(
+        new ProviderRpcError(
+          RpcErrorCode.UnsupportedMethod,
+          `The Assetera Wallet pop-up does not support the method "${method}".`
+        )
+      );
+    }
+    if (method === "eth_accounts") return Promise.resolve([...accounts]);
+    if (method === "eth_chainId") return Promise.resolve(currentChainId());
+    if (method === "eth_requestAccounts") {
+      const active2 = openPopup();
+      if (!active2) return Promise.reject(blockedError());
+      return ready.promise.then(() => sendRequest("eth_requestAccounts", params)).then((result) => {
+        accounts = Array.isArray(result) ? result : [];
+        emit("accountsChanged", [...accounts]);
+        emit("connect", { chainId: currentChainId() });
+        return [...accounts];
+      });
+    }
+    if (accounts.length === 0) {
+      return Promise.reject(
+        new ProviderRpcError(
+          RpcErrorCode.Unauthorized,
+          "Connect to the Assetera Wallet first (eth_requestAccounts)."
+        )
+      );
+    }
+    const active = openPopup();
+    if (!active) return Promise.reject(blockedError());
+    if (SIGNING_METHODS.has(method)) active.focus();
+    return ready.promise.then(() => sendRequest(method, params));
+  }
+  function disconnect() {
+    const active = popup;
+    if (active && !active.closed) {
+      const message = {
+        type: `${MESSAGE_PREFIX}disconnect`,
+        v: PROTOCOL_VERSION
+      };
+      active.postMessage(message, walletOrigin);
+      active.close();
+    }
+    stopClosePolling();
+    popup = null;
+    const closedReady = ready;
+    ready = createDeferred();
+    closedReady.reject(disconnectedError("Disconnected from the Assetera Wallet."));
+    rejectAllPending(disconnectedError("Disconnected from the Assetera Wallet."));
+    accounts = [];
+    chainIdHex = null;
+    walletDisconnected = false;
+    emit("disconnect", disconnectedError("Disconnected from the Assetera Wallet."));
+  }
+  function on(event, listener) {
+    addListener(event, listener);
+  }
+  function removeListener(event, listener) {
+    removeEventListener(event, listener);
+  }
+  return { request, on, removeListener, disconnect };
+}
+
+exports.CONNECT_PATH = CONNECT_PATH;
+exports.MESSAGE_PREFIX = MESSAGE_PREFIX;
+exports.PROTOCOL_VERSION = PROTOCOL_VERSION;
+exports.ProviderRpcError = ProviderRpcError;
+exports.RpcErrorCode = RpcErrorCode;
+exports.SUPPORTED_METHODS = SUPPORTED_METHODS;
+exports.connectUrl = connectUrl;
+exports.createAsseteraWalletProvider = createAsseteraWalletProvider;
+exports.isDisconnectMessage = isDisconnectMessage;
+exports.isEventMessage = isEventMessage;
+exports.isReadyMessage = isReadyMessage;
+exports.isRequestMessage = isRequestMessage;
+exports.isResponseMessage = isResponseMessage;
+exports.isSupportedMethod = isSupportedMethod;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol.ts","../src/provider.ts"],"names":["request","active"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * The pop-up protocol between a partner page (the opener) and the Assetera Wallet (the pop-up) — ADR-0054 D3/D4.\n *\n * This file is the CONTRACT. The connector in this package speaks the opener side; AsseteraWalletFront's\n * `/connect` page speaks the pop-up side and imports these types from `@asseteragmbh/wallet-connector/protocol`.\n * Change it only in a backwards-compatible way, or bump `PROTOCOL_VERSION` and support both on the wallet side:\n * partner sites upgrade on their own schedule.\n *\n * ## The handshake\n *\n * 1. The partner opens `${walletUrl}${CONNECT_PATH}?origin=<partner origin>&v=<version>` from a user click.\n * 2. The pop-up checks the claimed origin against its allowlist (D4). If listed, it posts `ready` to\n *    `window.opener` with `targetOrigin` = that origin. The browser delivers it ONLY if the opener really is\n *    that origin, so a page cannot claim someone else's origin and still hear the answer.\n * 3. The opener waits for `ready` from the wallet origin, then sends `request`s with `targetOrigin` = the wallet\n *    origin. The pop-up accepts a message only when `event.origin` is the allowed origin from step 2 AND\n *    `event.source === window.opener`, and answers with `targetOrigin` = that origin. Nothing else is accepted.\n *\n * ## Lifetime\n *\n * The pop-up stays open while the partner uses the wallet (ADR-0054, \"the wallet tab must stay open\"). When it is\n * closed, the opener sees `disconnect` (or notices `popup.closed`) and must reconnect from a user click.\n */\n\nexport const PROTOCOL_VERSION = 1 as const;\n\n/** The pop-up route on the wallet origin. */\nexport const CONNECT_PATH = \"/connect\";\n\n/** Every message carries this prefix in `type`, so both sides can ignore unrelated `postMessage` traffic. */\nexport const MESSAGE_PREFIX = \"assetera-wallet:\" as const;\n\n/**\n * The EIP-1193 methods the pop-up answers (ADR-0054 D3). Anything else is refused with 4200. Read-only chain\n * calls (`eth_call`, `eth_getBalance`, …) do not go through the pop-up; wagmi sends them to its own transports.\n */\nexport const SUPPORTED_METHODS = [\n  \"eth_requestAccounts\",\n  \"eth_accounts\",\n  \"eth_chainId\",\n  \"wallet_switchEthereumChain\",\n  \"personal_sign\",\n  \"eth_signTypedData_v4\",\n  \"eth_sendTransaction\",\n] as const;\n\nexport type SupportedMethod = (typeof SUPPORTED_METHODS)[number];\n\nexport function isSupportedMethod(method: string): method is SupportedMethod {\n  return (SUPPORTED_METHODS as readonly string[]).includes(method);\n}\n\n/** EIP-1193 / EIP-1474 error codes the pop-up uses. */\nexport const RpcErrorCode = {\n  /** The client rejected the request in the pop-up. */\n  UserRejected: 4001,\n  /** Not connected yet (no `eth_requestAccounts` approved in this pop-up). */\n  Unauthorized: 4100,\n  /** The method is not in SUPPORTED_METHODS. */\n  UnsupportedMethod: 4200,\n  /** The pop-up closed, or the wallet session ended. */\n  Disconnected: 4900,\n  /** `wallet_switchEthereumChain` to a chain the wallet does not offer. */\n  UnrecognizedChain: 4902,\n  /** Malformed params. */\n  InvalidParams: -32602,\n  /** Anything unexpected inside the wallet. */\n  Internal: -32603,\n} as const;\n\nexport type RpcErrorCode = (typeof RpcErrorCode)[keyof typeof RpcErrorCode];\n\nexport interface RpcError {\n  code: number;\n  message: string;\n  data?: unknown;\n}\n\n// --- pop-up → opener ---------------------------------------------------------------------------------\n\n/** The pop-up is loaded and accepts requests from this opener. */\nexport interface ReadyMessage {\n  type: `${typeof MESSAGE_PREFIX}ready`;\n  v: typeof PROTOCOL_VERSION;\n  /** Shown to the partner for diagnostics only; the partner must not rely on it for anything. */\n  walletVersion?: string;\n}\n\n/** The answer to one `request`, matched by `id`. Exactly one of `result` / `error`. */\nexport type ResponseMessage =\n  | { type: `${typeof MESSAGE_PREFIX}response`; v: typeof PROTOCOL_VERSION; id: string; result: unknown }\n  | { type: `${typeof MESSAGE_PREFIX}response`; v: typeof PROTOCOL_VERSION; id: string; error: RpcError };\n\n/** EIP-1193 provider events, forwarded to the partner. */\nexport type EventMessage =\n  | {\n      type: `${typeof MESSAGE_PREFIX}event`;\n      v: typeof PROTOCOL_VERSION;\n      event: \"accountsChanged\";\n      data: `0x${string}`[];\n    }\n  | {\n      type: `${typeof MESSAGE_PREFIX}event`;\n      v: typeof PROTOCOL_VERSION;\n      event: \"chainChanged\";\n      data: `0x${string}`;\n    }\n  | {\n      type: `${typeof MESSAGE_PREFIX}event`;\n      v: typeof PROTOCOL_VERSION;\n      event: \"disconnect\";\n      data: RpcError;\n    };\n\nexport type WalletToPartnerMessage = ReadyMessage | ResponseMessage | EventMessage;\n\n// --- opener → pop-up ---------------------------------------------------------------------------------\n\nexport interface RequestMessage {\n  type: `${typeof MESSAGE_PREFIX}request`;\n  v: typeof PROTOCOL_VERSION;\n  /** Unique per request within one connection; the response carries it back. */\n  id: string;\n  method: string;\n  params?: unknown[] | Record<string, unknown>;\n}\n\n/** The partner disconnects (for example the user clicked \"Disconnect\" in the partner page). */\nexport interface DisconnectMessage {\n  type: `${typeof MESSAGE_PREFIX}disconnect`;\n  v: typeof PROTOCOL_VERSION;\n}\n\nexport type PartnerToWalletMessage = RequestMessage | DisconnectMessage;\n\n// --- guards ------------------------------------------------------------------------------------------\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction hasType(value: unknown, suffix: string): value is Record<string, unknown> {\n  return isRecord(value) && value.type === `${MESSAGE_PREFIX}${suffix}` && value.v === PROTOCOL_VERSION;\n}\n\nexport function isReadyMessage(value: unknown): value is ReadyMessage {\n  return hasType(value, \"ready\");\n}\n\nexport function isResponseMessage(value: unknown): value is ResponseMessage {\n  return (\n    hasType(value, \"response\") &&\n    typeof value.id === \"string\" &&\n    (\"result\" in value || (isRecord(value.error) && typeof value.error.code === \"number\"))\n  );\n}\n\nexport function isEventMessage(value: unknown): value is EventMessage {\n  return (\n    hasType(value, \"event\") &&\n    (value.event === \"accountsChanged\" || value.event === \"chainChanged\" || value.event === \"disconnect\")\n  );\n}\n\nexport function isRequestMessage(value: unknown): value is RequestMessage {\n  return hasType(value, \"request\") && typeof value.id === \"string\" && typeof value.method === \"string\";\n}\n\nexport function isDisconnectMessage(value: unknown): value is DisconnectMessage {\n  return hasType(value, \"disconnect\");\n}\n\n/** The URL the partner opens. `partnerOrigin` is `window.location.origin` of the partner page. */\nexport function connectUrl(walletUrl: string, partnerOrigin: string): string {\n  const url = new URL(CONNECT_PATH, walletUrl);\n  url.searchParams.set(\"origin\", partnerOrigin);\n  url.searchParams.set(\"v\", String(PROTOCOL_VERSION));\n  return url.toString();\n}\n","/**\n * EIP-1193 provider for the Assetera Wallet pop-up — the opener side of the ADR-0054 D3/D4 protocol.\n *\n * The provider owns a single pop-up (`window.open(connectUrl(...), \"assetera-wallet\", ...)`) and speaks the\n * wire format defined in `./protocol`. It never touches Dynamic, React, wagmi or viem, so a partner can use it\n * on its own or through the wagmi / RainbowKit adapters in this package.\n */\nimport {\n  MESSAGE_PREFIX,\n  PROTOCOL_VERSION,\n  RpcErrorCode,\n  connectUrl,\n  isEventMessage,\n  isReadyMessage,\n  isResponseMessage,\n  isSupportedMethod,\n  type DisconnectMessage,\n  type EventMessage,\n  type RequestMessage,\n  type ResponseMessage,\n} from \"./protocol\";\n\n/** Arguments accepted by `request`, mirroring EIP-1193. */\nexport interface RequestArguments {\n  method: string;\n  params?: unknown[] | Record<string, unknown>;\n}\n\n/** EIP-1193 provider events emitted by the pop-up. */\nexport type ProviderEvent = \"accountsChanged\" | \"chainChanged\" | \"connect\" | \"disconnect\";\n\n/**\n * Listener shape for EIP-1193 provider events. `never[]` accepts a listener with any concrete parameter list\n * (for example wagmi's `(accounts: string[]) => void`), while internal emission stays type-safe via a cast.\n */\nexport type ProviderListener = (...args: never[]) => void;\n\n/** The EIP-1193 surface returned by {@link createAsseteraWalletProvider}. */\nexport interface AsseteraWalletProvider {\n  request(args: RequestArguments): Promise<unknown>;\n  on(event: ProviderEvent, listener: ProviderListener): void;\n  removeListener(event: ProviderEvent, listener: ProviderListener): void;\n  disconnect(): void;\n}\n\n/** Options for {@link createAsseteraWalletProvider}. */\nexport interface AsseteraWalletProviderOptions {\n  /** Base URL of the wallet origin, e.g. `https://wallet.playground.assetera.com`. */\n  walletUrl: string;\n  /** Chain id used before the wallet reports one, and as the local `eth_chainId` fallback. */\n  defaultChainId: number;\n  /** `window.open` feature string. Defaults to `\"popup,width=420,height=720\"`. */\n  popupFeatures?: string;\n}\n\n/**\n * EIP-1193 error carrying a JSON-RPC `code` (and optional `data`). This is what every rejected `request`\n * throws, so wagmi maps the wallet's `4001` / `4100` / `4200` / `4900` correctly.\n */\nexport class ProviderRpcError extends Error {\n  readonly code: number;\n  readonly data?: unknown;\n\n  constructor(code: number, message: string, data?: unknown) {\n    super(message);\n    this.name = \"ProviderRpcError\";\n    this.code = code;\n    this.data = data;\n  }\n}\n\nconst DEFAULT_POPUP_FEATURES = \"popup,width=420,height=720\";\nconst POPUP_NAME = \"assetera-wallet\";\nconst CLOSE_POLL_MS = 500;\n\n/** Methods that show the user a signature / transaction prompt, so the pop-up should be focused first. */\nconst SIGNING_METHODS: ReadonlySet<string> = new Set([\n  \"personal_sign\",\n  \"eth_signTypedData_v4\",\n  \"eth_sendTransaction\",\n]);\n\ninterface PendingRequest {\n  resolve: (value: unknown) => void;\n  reject: (reason: unknown) => void;\n}\n\ninterface Deferred<T> {\n  promise: Promise<T>;\n  resolve: (value: T) => void;\n  reject: (reason: unknown) => void;\n}\n\nfunction createDeferred<T>(): Deferred<T> {\n  let resolve!: (value: T) => void;\n  let reject!: (reason: unknown) => void;\n  const promise = new Promise<T>((res, rej) => {\n    resolve = res;\n    reject = rej;\n  });\n  // The `ready` deferred is rejected when the pop-up closes even if no request is waiting on it; mark the\n  // promise as handled so that rejection is not reported as an unhandled promise rejection.\n  void promise.catch(() => {});\n  return { promise, resolve, reject };\n}\n\nfunction toHexChainId(chainId: number): string {\n  return `0x${chainId.toString(16)}`;\n}\n\n/**\n * Create the EIP-1193 provider that talks to the Assetera Wallet pop-up.\n *\n * Call `request` from a user gesture: `eth_requestAccounts` opens the pop-up synchronously (before any\n * `await`) so the browser treats it as part of the click and does not block it.\n */\nexport function createAsseteraWalletProvider(options: AsseteraWalletProviderOptions): AsseteraWalletProvider {\n  const { defaultChainId } = options;\n  const walletOrigin = new URL(options.walletUrl).origin;\n  const popupFeatures = options.popupFeatures ?? DEFAULT_POPUP_FEATURES;\n\n  let popup: Window | null = null;\n  /** Resolves when the *current* pop-up posts `ready`. Replaced when a new pop-up is opened. */\n  let ready = createDeferred<void>();\n  let accounts: string[] = [];\n  let chainIdHex: string | null = null;\n  /** Set when the wallet itself told us the session ended (as opposed to the user merely closing the tab). */\n  let walletDisconnected = false;\n  const pending = new Map<string, PendingRequest>();\n  const listeners = new Map<ProviderEvent, Set<(...args: unknown[]) => void>>();\n  let closeTimer: ReturnType<typeof setInterval> | null = null;\n\n  function currentChainId(): string {\n    return chainIdHex ?? toHexChainId(defaultChainId);\n  }\n\n  function blockedError(): ProviderRpcError {\n    return new ProviderRpcError(\n      RpcErrorCode.Disconnected,\n      \"The Assetera Wallet pop-up was blocked by the browser. The pop-up must be opened from a user click \" +\n        \"(for example a button press) and then the request retried.\",\n    );\n  }\n\n  function disconnectedError(message = \"The Assetera Wallet pop-up was closed.\"): ProviderRpcError {\n    return new ProviderRpcError(RpcErrorCode.Disconnected, message);\n  }\n\n  function emit(event: ProviderEvent, ...args: unknown[]): void {\n    const set = listeners.get(event);\n    if (!set) return;\n    for (const listener of set) {\n      try {\n        listener(...args);\n      } catch (error) {\n        console.error(`[assetera-wallet] listener for \"${event}\" threw`, error);\n      }\n    }\n  }\n\n  function addListener(event: ProviderEvent, listener: ProviderListener): void {\n    let set = listeners.get(event);\n    if (!set) {\n      set = new Set<(...args: unknown[]) => void>();\n      listeners.set(event, set);\n    }\n    set.add(listener as (...args: unknown[]) => void);\n  }\n\n  function removeEventListener(event: ProviderEvent, listener: ProviderListener): void {\n    listeners.get(event)?.delete(listener as (...args: unknown[]) => void);\n  }\n\n  function stopClosePolling(): void {\n    if (closeTimer !== null) {\n      clearInterval(closeTimer);\n      closeTimer = null;\n    }\n  }\n\n  function startClosePolling(): void {\n    if (closeTimer !== null) return;\n    closeTimer = setInterval(() => {\n      if (popup?.closed) handlePopupClosed();\n    }, CLOSE_POLL_MS);\n  }\n\n  function rejectAllPending(error: ProviderRpcError): void {\n    for (const request of pending.values()) request.reject(error);\n    pending.clear();\n  }\n\n  /**\n   * The pop-up was closed by the user (or the wallet app).\n   *\n   * We deliberately KEEP `accounts` / `chainIdHex` cached: the dApp stays \"connected\" in React state and does\n   * not flicker back to a disconnected UI. Because a pop-up cannot be reopened without a user gesture, the next\n   * signing request reopens it from the caller's click. `disconnect` is only emitted when the close actually\n   * interrupted work (a request was pending) or when the wallet itself announced the disconnect.\n   */\n  function handlePopupClosed(): void {\n    const hadPending = pending.size > 0;\n    stopClosePolling();\n    const closedPopup = popup;\n    popup = null;\n    const closedReady = ready;\n    ready = createDeferred<void>();\n    const error = disconnectedError();\n    if (closedPopup) closedReady.reject(error);\n    rejectAllPending(error);\n    const shouldEmit = hadPending || walletDisconnected;\n    walletDisconnected = false;\n    if (shouldEmit) emit(\"disconnect\", error);\n  }\n\n  /**\n   * Open the pop-up, or focus and reuse it when it is still around. Must stay synchronous (it is called before\n   * any `await` in `request`) so it runs inside the caller's user activation.\n   */\n  function openPopup(): Window | null {\n    if (popup && !popup.closed) {\n      popup.focus();\n      return popup;\n    }\n    if (typeof window === \"undefined\") return null;\n    const opened = window.open(\n      connectUrl(options.walletUrl, window.location.origin),\n      POPUP_NAME,\n      popupFeatures,\n    );\n    if (!opened) return null;\n    popup = opened;\n    ready = createDeferred<void>();\n    walletDisconnected = false;\n    startClosePolling();\n    return opened;\n  }\n\n  function sendRequest(method: string, params?: RequestArguments[\"params\"]): Promise<unknown> {\n    const active = popup;\n    if (!active || active.closed) return Promise.reject(disconnectedError());\n    const id = crypto.randomUUID();\n    const message: RequestMessage = {\n      type: `${MESSAGE_PREFIX}request`,\n      v: PROTOCOL_VERSION,\n      id,\n      method,\n      ...(params === undefined ? {} : { params }),\n    };\n    return new Promise<unknown>((resolve, reject) => {\n      pending.set(id, { resolve, reject });\n      active.postMessage(message, walletOrigin);\n    });\n  }\n\n  function handleResponse(message: ResponseMessage): void {\n    const request = pending.get(message.id);\n    if (!request) return;\n    pending.delete(message.id);\n    if (\"error\" in message) {\n      request.reject(new ProviderRpcError(message.error.code, message.error.message, message.error.data));\n    } else {\n      request.resolve(message.result);\n    }\n  }\n\n  function handleEventMessage(message: EventMessage): void {\n    if (message.event === \"accountsChanged\") {\n      accounts = [...message.data];\n      emit(\"accountsChanged\", [...accounts]);\n      return;\n    }\n    if (message.event === \"chainChanged\") {\n      chainIdHex = message.data;\n      emit(\"chainChanged\", chainIdHex);\n      return;\n    }\n    walletDisconnected = true;\n    emit(\"disconnect\", new ProviderRpcError(message.data.code, message.data.message, message.data.data));\n  }\n\n  function onWindowMessage(event: MessageEvent): void {\n    if (event.origin !== walletOrigin) return;\n    if (popup === null || (event.source as unknown) !== popup) return;\n    const data: unknown = event.data;\n    if (isReadyMessage(data)) {\n      ready.resolve(undefined);\n      return;\n    }\n    if (isResponseMessage(data)) {\n      handleResponse(data);\n      return;\n    }\n    if (isEventMessage(data)) handleEventMessage(data);\n  }\n\n  if (typeof window !== \"undefined\") window.addEventListener(\"message\", onWindowMessage);\n\n  function request({ method, params }: RequestArguments): Promise<unknown> {\n    if (typeof window === \"undefined\") {\n      return Promise.reject(\n        new ProviderRpcError(\n          RpcErrorCode.Disconnected,\n          \"The Assetera Wallet provider can only run in a browser.\",\n        ),\n      );\n    }\n    // Read-only chain calls go through wagmi's own transports; the pop-up refuses everything else.\n    if (!isSupportedMethod(method)) {\n      return Promise.reject(\n        new ProviderRpcError(\n          RpcErrorCode.UnsupportedMethod,\n          `The Assetera Wallet pop-up does not support the method \"${method}\".`,\n        ),\n      );\n    }\n    // Answered locally, without a pop-up, so wagmi can read the connection before the user clicks.\n    if (method === \"eth_accounts\") return Promise.resolve([...accounts]);\n    if (method === \"eth_chainId\") return Promise.resolve(currentChainId());\n\n    // Opening the pop-up MUST happen synchronously, before the first `await`, to stay in the click.\n    if (method === \"eth_requestAccounts\") {\n      const active = openPopup();\n      if (!active) return Promise.reject(blockedError());\n      return ready.promise\n        .then(() => sendRequest(\"eth_requestAccounts\", params))\n        .then((result) => {\n          accounts = Array.isArray(result) ? (result as string[]) : [];\n          emit(\"accountsChanged\", [...accounts]);\n          emit(\"connect\", { chainId: currentChainId() });\n          return [...accounts];\n        });\n    }\n\n    // Every other supported method needs an approved connection.\n    if (accounts.length === 0) {\n      return Promise.reject(\n        new ProviderRpcError(\n          RpcErrorCode.Unauthorized,\n          \"Connect to the Assetera Wallet first (eth_requestAccounts).\",\n        ),\n      );\n    }\n    const active = openPopup();\n    if (!active) return Promise.reject(blockedError());\n    if (SIGNING_METHODS.has(method)) active.focus();\n    return ready.promise.then(() => sendRequest(method, params));\n  }\n\n  function disconnect(): void {\n    const active = popup;\n    if (active && !active.closed) {\n      const message: DisconnectMessage = {\n        type: `${MESSAGE_PREFIX}disconnect`,\n        v: PROTOCOL_VERSION,\n      };\n      active.postMessage(message, walletOrigin);\n      active.close();\n    }\n    stopClosePolling();\n    popup = null;\n    const closedReady = ready;\n    ready = createDeferred<void>();\n    closedReady.reject(disconnectedError(\"Disconnected from the Assetera Wallet.\"));\n    rejectAllPending(disconnectedError(\"Disconnected from the Assetera Wallet.\"));\n    accounts = [];\n    chainIdHex = null;\n    walletDisconnected = false;\n    emit(\"disconnect\", disconnectedError(\"Disconnected from the Assetera Wallet.\"));\n  }\n\n  function on(event: ProviderEvent, listener: ProviderListener): void {\n    addListener(event, listener);\n  }\n\n  function removeListener(event: ProviderEvent, listener: ProviderListener): void {\n    removeEventListener(event, listener);\n  }\n\n  return { request, on, removeListener, disconnect };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+export { CONNECT_PATH, DisconnectMessage, EventMessage, MESSAGE_PREFIX, PROTOCOL_VERSION, PartnerToWalletMessage, ReadyMessage, RequestMessage, ResponseMessage, RpcError, RpcErrorCode, SUPPORTED_METHODS, SupportedMethod, WalletToPartnerMessage, connectUrl, isDisconnectMessage, isEventMessage, isReadyMessage, isRequestMessage, isResponseMessage, isSupportedMethod } from './protocol.cjs';
+export { A as AsseteraWalletProvider, a as AsseteraWalletProviderOptions, P as ProviderEvent, b as ProviderListener, c as ProviderRpcError, R as RequestArguments, d as createAsseteraWalletProvider } from './provider-BEIsX3q_.cjs';

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { CONNECT_PATH, DisconnectMessage, EventMessage, MESSAGE_PREFIX, PROTOCOL_VERSION, PartnerToWalletMessage, ReadyMessage, RequestMessage, ResponseMessage, RpcError, RpcErrorCode, SUPPORTED_METHODS, SupportedMethod, WalletToPartnerMessage, connectUrl, isDisconnectMessage, isEventMessage, isReadyMessage, isRequestMessage, isResponseMessage, isSupportedMethod } from './protocol.js';
+export { A as AsseteraWalletProvider, a as AsseteraWalletProviderOptions, P as ProviderEvent, b as ProviderListener, c as ProviderRpcError, R as RequestArguments, d as createAsseteraWalletProvider } from './provider-BEIsX3q_.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { ProviderRpcError, createAsseteraWalletProvider } from './chunk-QPNIGEP4.js';
+export { CONNECT_PATH, MESSAGE_PREFIX, PROTOCOL_VERSION, RpcErrorCode, SUPPORTED_METHODS, connectUrl, isDisconnectMessage, isEventMessage, isReadyMessage, isRequestMessage, isResponseMessage, isSupportedMethod } from './chunk-N6D53D3G.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/protocol.cjs

@@ -0,0 +1,76 @@
+'use strict';
+
+// src/protocol.ts
+var PROTOCOL_VERSION = 1;
+var CONNECT_PATH = "/connect";
+var MESSAGE_PREFIX = "assetera-wallet:";
+var SUPPORTED_METHODS = [
+  "eth_requestAccounts",
+  "eth_accounts",
+  "eth_chainId",
+  "wallet_switchEthereumChain",
+  "personal_sign",
+  "eth_signTypedData_v4",
+  "eth_sendTransaction"
+];
+function isSupportedMethod(method) {
+  return SUPPORTED_METHODS.includes(method);
+}
+var RpcErrorCode = {
+  /** The client rejected the request in the pop-up. */
+  UserRejected: 4001,
+  /** Not connected yet (no `eth_requestAccounts` approved in this pop-up). */
+  Unauthorized: 4100,
+  /** The method is not in SUPPORTED_METHODS. */
+  UnsupportedMethod: 4200,
+  /** The pop-up closed, or the wallet session ended. */
+  Disconnected: 4900,
+  /** `wallet_switchEthereumChain` to a chain the wallet does not offer. */
+  UnrecognizedChain: 4902,
+  /** Malformed params. */
+  InvalidParams: -32602,
+  /** Anything unexpected inside the wallet. */
+  Internal: -32603
+};
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function hasType(value, suffix) {
+  return isRecord(value) && value.type === `${MESSAGE_PREFIX}${suffix}` && value.v === PROTOCOL_VERSION;
+}
+function isReadyMessage(value) {
+  return hasType(value, "ready");
+}
+function isResponseMessage(value) {
+  return hasType(value, "response") && typeof value.id === "string" && ("result" in value || isRecord(value.error) && typeof value.error.code === "number");
+}
+function isEventMessage(value) {
+  return hasType(value, "event") && (value.event === "accountsChanged" || value.event === "chainChanged" || value.event === "disconnect");
+}
+function isRequestMessage(value) {
+  return hasType(value, "request") && typeof value.id === "string" && typeof value.method === "string";
+}
+function isDisconnectMessage(value) {
+  return hasType(value, "disconnect");
+}
+function connectUrl(walletUrl, partnerOrigin) {
+  const url = new URL(CONNECT_PATH, walletUrl);
+  url.searchParams.set("origin", partnerOrigin);
+  url.searchParams.set("v", String(PROTOCOL_VERSION));
+  return url.toString();
+}
+
+exports.CONNECT_PATH = CONNECT_PATH;
+exports.MESSAGE_PREFIX = MESSAGE_PREFIX;
+exports.PROTOCOL_VERSION = PROTOCOL_VERSION;
+exports.RpcErrorCode = RpcErrorCode;
+exports.SUPPORTED_METHODS = SUPPORTED_METHODS;
+exports.connectUrl = connectUrl;
+exports.isDisconnectMessage = isDisconnectMessage;
+exports.isEventMessage = isEventMessage;
+exports.isReadyMessage = isReadyMessage;
+exports.isRequestMessage = isRequestMessage;
+exports.isResponseMessage = isResponseMessage;
+exports.isSupportedMethod = isSupportedMethod;
+//# sourceMappingURL=protocol.cjs.map
+//# sourceMappingURL=protocol.cjs.map

package/dist/protocol.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol.ts"],"names":[],"mappings":";;;AAwBO,IAAM,gBAAA,GAAmB;AAGzB,IAAM,YAAA,GAAe;AAGrB,IAAM,cAAA,GAAiB;AAMvB,IAAM,iBAAA,GAAoB;AAAA,EAC/B,qBAAA;AAAA,EACA,cAAA;AAAA,EACA,aAAA;AAAA,EACA,4BAAA;AAAA,EACA,eAAA;AAAA,EACA,sBAAA;AAAA,EACA;AACF;AAIO,SAAS,kBAAkB,MAAA,EAA2C;AAC3E,EAAA,OAAQ,iBAAA,CAAwC,SAAS,MAAM,CAAA;AACjE;AAGO,IAAM,YAAA,GAAe;AAAA;AAAA,EAE1B,YAAA,EAAc,IAAA;AAAA;AAAA,EAEd,YAAA,EAAc,IAAA;AAAA;AAAA,EAEd,iBAAA,EAAmB,IAAA;AAAA;AAAA,EAEnB,YAAA,EAAc,IAAA;AAAA;AAAA,EAEd,iBAAA,EAAmB,IAAA;AAAA;AAAA,EAEnB,aAAA,EAAe,MAAA;AAAA;AAAA,EAEf,QAAA,EAAU;AACZ;AAqEA,SAAS,SAAS,KAAA,EAAkD;AAClE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA;AAChD;AAEA,SAAS,OAAA,CAAQ,OAAgB,MAAA,EAAkD;AACjF,EAAA,OAAO,QAAA,CAAS,KAAK,CAAA,IAAK,KAAA,CAAM,IAAA,KAAS,CAAA,EAAG,cAAc,CAAA,EAAG,MAAM,CAAA,CAAA,IAAM,KAAA,CAAM,CAAA,KAAM,gBAAA;AACvF;AAEO,SAAS,eAAe,KAAA,EAAuC;AACpE,EAAA,OAAO,OAAA,CAAQ,OAAO,OAAO,CAAA;AAC/B;AAEO,SAAS,kBAAkB,KAAA,EAA0C;AAC1E,EAAA,OACE,QAAQ,KAAA,EAAO,UAAU,CAAA,IACzB,OAAO,MAAM,EAAA,KAAO,QAAA,KACnB,QAAA,IAAY,KAAA,IAAU,SAAS,KAAA,CAAM,KAAK,KAAK,OAAO,KAAA,CAAM,MAAM,IAAA,KAAS,QAAA,CAAA;AAEhF;AAEO,SAAS,eAAe,KAAA,EAAuC;AACpE,EAAA,OACE,OAAA,CAAQ,KAAA,EAAO,OAAO,CAAA,KACrB,KAAA,CAAM,KAAA,KAAU,iBAAA,IAAqB,KAAA,CAAM,KAAA,KAAU,cAAA,IAAkB,KAAA,CAAM,KAAA,KAAU,YAAA,CAAA;AAE5F;AAEO,SAAS,iBAAiB,KAAA,EAAyC;AACxE,EAAA,OAAO,OAAA,CAAQ,KAAA,EAAO,SAAS,CAAA,IAAK,OAAO,MAAM,EAAA,KAAO,QAAA,IAAY,OAAO,KAAA,CAAM,MAAA,KAAW,QAAA;AAC9F;AAEO,SAAS,oBAAoB,KAAA,EAA4C;AAC9E,EAAA,OAAO,OAAA,CAAQ,OAAO,YAAY,CAAA;AACpC;AAGO,SAAS,UAAA,CAAW,WAAmB,aAAA,EAA+B;AAC3E,EAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,YAAA,EAAc,SAAS,CAAA;AAC3C,EAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,QAAA,EAAU,aAAa,CAAA;AAC5C,EAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,GAAA,EAAK,MAAA,CAAO,gBAAgB,CAAC,CAAA;AAClD,EAAA,OAAO,IAAI,QAAA,EAAS;AACtB","file":"protocol.cjs","sourcesContent":["/**\n * The pop-up protocol between a partner page (the opener) and the Assetera Wallet (the pop-up) — ADR-0054 D3/D4.\n *\n * This file is the CONTRACT. The connector in this package speaks the opener side; AsseteraWalletFront's\n * `/connect` page speaks the pop-up side and imports these types from `@asseteragmbh/wallet-connector/protocol`.\n * Change it only in a backwards-compatible way, or bump `PROTOCOL_VERSION` and support both on the wallet side:\n * partner sites upgrade on their own schedule.\n *\n * ## The handshake\n *\n * 1. The partner opens `${walletUrl}${CONNECT_PATH}?origin=<partner origin>&v=<version>` from a user click.\n * 2. The pop-up checks the claimed origin against its allowlist (D4). If listed, it posts `ready` to\n *    `window.opener` with `targetOrigin` = that origin. The browser delivers it ONLY if the opener really is\n *    that origin, so a page cannot claim someone else's origin and still hear the answer.\n * 3. The opener waits for `ready` from the wallet origin, then sends `request`s with `targetOrigin` = the wallet\n *    origin. The pop-up accepts a message only when `event.origin` is the allowed origin from step 2 AND\n *    `event.source === window.opener`, and answers with `targetOrigin` = that origin. Nothing else is accepted.\n *\n * ## Lifetime\n *\n * The pop-up stays open while the partner uses the wallet (ADR-0054, \"the wallet tab must stay open\"). When it is\n * closed, the opener sees `disconnect` (or notices `popup.closed`) and must reconnect from a user click.\n */\n\nexport const PROTOCOL_VERSION = 1 as const;\n\n/** The pop-up route on the wallet origin. */\nexport const CONNECT_PATH = \"/connect\";\n\n/** Every message carries this prefix in `type`, so both sides can ignore unrelated `postMessage` traffic. */\nexport const MESSAGE_PREFIX = \"assetera-wallet:\" as const;\n\n/**\n * The EIP-1193 methods the pop-up answers (ADR-0054 D3). Anything else is refused with 4200. Read-only chain\n * calls (`eth_call`, `eth_getBalance`, …) do not go through the pop-up; wagmi sends them to its own transports.\n */\nexport const SUPPORTED_METHODS = [\n  \"eth_requestAccounts\",\n  \"eth_accounts\",\n  \"eth_chainId\",\n  \"wallet_switchEthereumChain\",\n  \"personal_sign\",\n  \"eth_signTypedData_v4\",\n  \"eth_sendTransaction\",\n] as const;\n\nexport type SupportedMethod = (typeof SUPPORTED_METHODS)[number];\n\nexport function isSupportedMethod(method: string): method is SupportedMethod {\n  return (SUPPORTED_METHODS as readonly string[]).includes(method);\n}\n\n/** EIP-1193 / EIP-1474 error codes the pop-up uses. */\nexport const RpcErrorCode = {\n  /** The client rejected the request in the pop-up. */\n  UserRejected: 4001,\n  /** Not connected yet (no `eth_requestAccounts` approved in this pop-up). */\n  Unauthorized: 4100,\n  /** The method is not in SUPPORTED_METHODS. */\n  UnsupportedMethod: 4200,\n  /** The pop-up closed, or the wallet session ended. */\n  Disconnected: 4900,\n  /** `wallet_switchEthereumChain` to a chain the wallet does not offer. */\n  UnrecognizedChain: 4902,\n  /** Malformed params. */\n  InvalidParams: -32602,\n  /** Anything unexpected inside the wallet. */\n  Internal: -32603,\n} as const;\n\nexport type RpcErrorCode = (typeof RpcErrorCode)[keyof typeof RpcErrorCode];\n\nexport interface RpcError {\n  code: number;\n  message: string;\n  data?: unknown;\n}\n\n// --- pop-up → opener ---------------------------------------------------------------------------------\n\n/** The pop-up is loaded and accepts requests from this opener. */\nexport interface ReadyMessage {\n  type: `${typeof MESSAGE_PREFIX}ready`;\n  v: typeof PROTOCOL_VERSION;\n  /** Shown to the partner for diagnostics only; the partner must not rely on it for anything. */\n  walletVersion?: string;\n}\n\n/** The answer to one `request`, matched by `id`. Exactly one of `result` / `error`. */\nexport type ResponseMessage =\n  | { type: `${typeof MESSAGE_PREFIX}response`; v: typeof PROTOCOL_VERSION; id: string; result: unknown }\n  | { type: `${typeof MESSAGE_PREFIX}response`; v: typeof PROTOCOL_VERSION; id: string; error: RpcError };\n\n/** EIP-1193 provider events, forwarded to the partner. */\nexport type EventMessage =\n  | {\n      type: `${typeof MESSAGE_PREFIX}event`;\n      v: typeof PROTOCOL_VERSION;\n      event: \"accountsChanged\";\n      data: `0x${string}`[];\n    }\n  | {\n      type: `${typeof MESSAGE_PREFIX}event`;\n      v: typeof PROTOCOL_VERSION;\n      event: \"chainChanged\";\n      data: `0x${string}`;\n    }\n  | {\n      type: `${typeof MESSAGE_PREFIX}event`;\n      v: typeof PROTOCOL_VERSION;\n      event: \"disconnect\";\n      data: RpcError;\n    };\n\nexport type WalletToPartnerMessage = ReadyMessage | ResponseMessage | EventMessage;\n\n// --- opener → pop-up ---------------------------------------------------------------------------------\n\nexport interface RequestMessage {\n  type: `${typeof MESSAGE_PREFIX}request`;\n  v: typeof PROTOCOL_VERSION;\n  /** Unique per request within one connection; the response carries it back. */\n  id: string;\n  method: string;\n  params?: unknown[] | Record<string, unknown>;\n}\n\n/** The partner disconnects (for example the user clicked \"Disconnect\" in the partner page). */\nexport interface DisconnectMessage {\n  type: `${typeof MESSAGE_PREFIX}disconnect`;\n  v: typeof PROTOCOL_VERSION;\n}\n\nexport type PartnerToWalletMessage = RequestMessage | DisconnectMessage;\n\n// --- guards ------------------------------------------------------------------------------------------\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction hasType(value: unknown, suffix: string): value is Record<string, unknown> {\n  return isRecord(value) && value.type === `${MESSAGE_PREFIX}${suffix}` && value.v === PROTOCOL_VERSION;\n}\n\nexport function isReadyMessage(value: unknown): value is ReadyMessage {\n  return hasType(value, \"ready\");\n}\n\nexport function isResponseMessage(value: unknown): value is ResponseMessage {\n  return (\n    hasType(value, \"response\") &&\n    typeof value.id === \"string\" &&\n    (\"result\" in value || (isRecord(value.error) && typeof value.error.code === \"number\"))\n  );\n}\n\nexport function isEventMessage(value: unknown): value is EventMessage {\n  return (\n    hasType(value, \"event\") &&\n    (value.event === \"accountsChanged\" || value.event === \"chainChanged\" || value.event === \"disconnect\")\n  );\n}\n\nexport function isRequestMessage(value: unknown): value is RequestMessage {\n  return hasType(value, \"request\") && typeof value.id === \"string\" && typeof value.method === \"string\";\n}\n\nexport function isDisconnectMessage(value: unknown): value is DisconnectMessage {\n  return hasType(value, \"disconnect\");\n}\n\n/** The URL the partner opens. `partnerOrigin` is `window.location.origin` of the partner page. */\nexport function connectUrl(walletUrl: string, partnerOrigin: string): string {\n  const url = new URL(CONNECT_PATH, walletUrl);\n  url.searchParams.set(\"origin\", partnerOrigin);\n  url.searchParams.set(\"v\", String(PROTOCOL_VERSION));\n  return url.toString();\n}\n"]}

package/dist/protocol.d.cts

@@ -0,0 +1,118 @@
+/**
+ * The pop-up protocol between a partner page (the opener) and the Assetera Wallet (the pop-up) — ADR-0054 D3/D4.
+ *
+ * This file is the CONTRACT. The connector in this package speaks the opener side; AsseteraWalletFront's
+ * `/connect` page speaks the pop-up side and imports these types from `@asseteragmbh/wallet-connector/protocol`.
+ * Change it only in a backwards-compatible way, or bump `PROTOCOL_VERSION` and support both on the wallet side:
+ * partner sites upgrade on their own schedule.
+ *
+ * ## The handshake
+ *
+ * 1. The partner opens `${walletUrl}${CONNECT_PATH}?origin=<partner origin>&v=<version>` from a user click.
+ * 2. The pop-up checks the claimed origin against its allowlist (D4). If listed, it posts `ready` to
+ *    `window.opener` with `targetOrigin` = that origin. The browser delivers it ONLY if the opener really is
+ *    that origin, so a page cannot claim someone else's origin and still hear the answer.
+ * 3. The opener waits for `ready` from the wallet origin, then sends `request`s with `targetOrigin` = the wallet
+ *    origin. The pop-up accepts a message only when `event.origin` is the allowed origin from step 2 AND
+ *    `event.source === window.opener`, and answers with `targetOrigin` = that origin. Nothing else is accepted.
+ *
+ * ## Lifetime
+ *
+ * The pop-up stays open while the partner uses the wallet (ADR-0054, "the wallet tab must stay open"). When it is
+ * closed, the opener sees `disconnect` (or notices `popup.closed`) and must reconnect from a user click.
+ */
+declare const PROTOCOL_VERSION: 1;
+/** The pop-up route on the wallet origin. */
+declare const CONNECT_PATH = "/connect";
+/** Every message carries this prefix in `type`, so both sides can ignore unrelated `postMessage` traffic. */
+declare const MESSAGE_PREFIX: "assetera-wallet:";
+/**
+ * The EIP-1193 methods the pop-up answers (ADR-0054 D3). Anything else is refused with 4200. Read-only chain
+ * calls (`eth_call`, `eth_getBalance`, …) do not go through the pop-up; wagmi sends them to its own transports.
+ */
+declare const SUPPORTED_METHODS: readonly ["eth_requestAccounts", "eth_accounts", "eth_chainId", "wallet_switchEthereumChain", "personal_sign", "eth_signTypedData_v4", "eth_sendTransaction"];
+type SupportedMethod = (typeof SUPPORTED_METHODS)[number];
+declare function isSupportedMethod(method: string): method is SupportedMethod;
+/** EIP-1193 / EIP-1474 error codes the pop-up uses. */
+declare const RpcErrorCode: {
+    /** The client rejected the request in the pop-up. */
+    readonly UserRejected: 4001;
+    /** Not connected yet (no `eth_requestAccounts` approved in this pop-up). */
+    readonly Unauthorized: 4100;
+    /** The method is not in SUPPORTED_METHODS. */
+    readonly UnsupportedMethod: 4200;
+    /** The pop-up closed, or the wallet session ended. */
+    readonly Disconnected: 4900;
+    /** `wallet_switchEthereumChain` to a chain the wallet does not offer. */
+    readonly UnrecognizedChain: 4902;
+    /** Malformed params. */
+    readonly InvalidParams: -32602;
+    /** Anything unexpected inside the wallet. */
+    readonly Internal: -32603;
+};
+type RpcErrorCode = (typeof RpcErrorCode)[keyof typeof RpcErrorCode];
+interface RpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/** The pop-up is loaded and accepts requests from this opener. */
+interface ReadyMessage {
+    type: `${typeof MESSAGE_PREFIX}ready`;
+    v: typeof PROTOCOL_VERSION;
+    /** Shown to the partner for diagnostics only; the partner must not rely on it for anything. */
+    walletVersion?: string;
+}
+/** The answer to one `request`, matched by `id`. Exactly one of `result` / `error`. */
+type ResponseMessage = {
+    type: `${typeof MESSAGE_PREFIX}response`;
+    v: typeof PROTOCOL_VERSION;
+    id: string;
+    result: unknown;
+} | {
+    type: `${typeof MESSAGE_PREFIX}response`;
+    v: typeof PROTOCOL_VERSION;
+    id: string;
+    error: RpcError;
+};
+/** EIP-1193 provider events, forwarded to the partner. */
+type EventMessage = {
+    type: `${typeof MESSAGE_PREFIX}event`;
+    v: typeof PROTOCOL_VERSION;
+    event: "accountsChanged";
+    data: `0x${string}`[];
+} | {
+    type: `${typeof MESSAGE_PREFIX}event`;
+    v: typeof PROTOCOL_VERSION;
+    event: "chainChanged";
+    data: `0x${string}`;
+} | {
+    type: `${typeof MESSAGE_PREFIX}event`;
+    v: typeof PROTOCOL_VERSION;
+    event: "disconnect";
+    data: RpcError;
+};
+type WalletToPartnerMessage = ReadyMessage | ResponseMessage | EventMessage;
+interface RequestMessage {
+    type: `${typeof MESSAGE_PREFIX}request`;
+    v: typeof PROTOCOL_VERSION;
+    /** Unique per request within one connection; the response carries it back. */
+    id: string;
+    method: string;
+    params?: unknown[] | Record<string, unknown>;
+}
+/** The partner disconnects (for example the user clicked "Disconnect" in the partner page). */
+interface DisconnectMessage {
+    type: `${typeof MESSAGE_PREFIX}disconnect`;
+    v: typeof PROTOCOL_VERSION;
+}
+type PartnerToWalletMessage = RequestMessage | DisconnectMessage;
+declare function isReadyMessage(value: unknown): value is ReadyMessage;
+declare function isResponseMessage(value: unknown): value is ResponseMessage;
+declare function isEventMessage(value: unknown): value is EventMessage;
+declare function isRequestMessage(value: unknown): value is RequestMessage;
+declare function isDisconnectMessage(value: unknown): value is DisconnectMessage;
+/** The URL the partner opens. `partnerOrigin` is `window.location.origin` of the partner page. */
+declare function connectUrl(walletUrl: string, partnerOrigin: string): string;
+
+export { CONNECT_PATH, type DisconnectMessage, type EventMessage, MESSAGE_PREFIX, PROTOCOL_VERSION, type PartnerToWalletMessage, type ReadyMessage, type RequestMessage, type ResponseMessage, type RpcError, RpcErrorCode, SUPPORTED_METHODS, type SupportedMethod, type WalletToPartnerMessage, connectUrl, isDisconnectMessage, isEventMessage, isReadyMessage, isRequestMessage, isResponseMessage, isSupportedMethod };