@frak-labs/nexus-sdk 0.0.10 → 0.0.12

package/dist/chunk-5CFD5FM2.js

@@ -0,0 +1,86 @@
+// src/core/actions/watchWalletStatus.ts
+function watchWalletStatus(client, callback) {
+  return client.listenerRequest(
+    {
+      method: "frak_listenToWalletStatus"
+    },
+    callback
+  );
+}
+
+// src/core/utils/computeContentId.ts
+import { keccak256, toHex } from "viem";
+function computeContentId({ domain }) {
+  return keccak256(toHex(domain));
+}
+
+// src/core/actions/sendInteraction.ts
+async function sendInteraction(client, { contentId, interaction, validation }) {
+  const cId = contentId ?? computeContentId(client.config);
+  return await client.request({
+    method: "frak_sendInteraction",
+    params: [cId, interaction, validation]
+  });
+}
+
+// src/core/actions/displayModal.ts
+async function displayModal(client, { steps, metadata }) {
+  return await client.request({
+    method: "frak_displayModal",
+    params: [steps, client.config.metadata.name, metadata]
+  });
+}
+
+// src/core/actions/openSso.ts
+async function openSso(client, args) {
+  const { metadata } = client.config;
+  await client.request({
+    method: "frak_sso",
+    params: [args, metadata.name, metadata.css]
+  });
+}
+
+// src/core/actions/wrapper/siweAuthenticate.ts
+import { generateSiweNonce } from "viem/siwe";
+async function siweAuthenticate(client, { siwe, metadata }) {
+  const realStatement = siwe?.statement ?? `I confirm that I want to use my Nexus wallet on: ${client.config.metadata.name}`;
+  const builtSiwe = {
+    ...siwe,
+    statement: realStatement,
+    nonce: siwe?.nonce ?? generateSiweNonce(),
+    uri: siwe?.uri ?? `https://${client.config.domain}`,
+    version: siwe?.version ?? "1",
+    domain: client.config.domain
+  };
+  const result = await displayModal(client, {
+    metadata,
+    steps: {
+      login: {},
+      siweAuthenticate: {
+        siwe: builtSiwe
+      }
+    }
+  });
+  return result.siweAuthenticate;
+}
+
+// src/core/actions/wrapper/sendTransaction.ts
+async function sendTransaction(client, { tx, metadata }) {
+  const result = await displayModal(client, {
+    metadata,
+    steps: {
+      login: {},
+      sendTransaction: { tx }
+    }
+  });
+  return result.sendTransaction;
+}
+
+export {
+  watchWalletStatus,
+  sendInteraction,
+  displayModal,
+  openSso,
+  siweAuthenticate,
+  sendTransaction
+};

package/dist/chunk-BJ3CCN5P.cjs

@@ -0,0 +1,424 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunkETV4XYOVcjs = require('./chunk-ETV4XYOV.cjs');
+
+// src/core/types/rpc/error.ts
+var FrakRpcError = class extends Error {
+  constructor(code, message, data) {
+    super(message);
+    this.code = code;
+    this.data = data;
+  }
+};
+var InternalError = class extends FrakRpcError {
+  constructor(message) {
+    super(RpcErrorCodes.internalError, message);
+  }
+};
+var ClientNotFound = class extends FrakRpcError {
+  constructor() {
+    super(RpcErrorCodes.clientNotConnected, "Client not found");
+  }
+};
+var RpcErrorCodes = {
+  // Standard JSON-RPC 2.0 errors
+  parseError: -32700,
+  invalidRequest: -32600,
+  methodNotFound: -32601,
+  invalidParams: -32602,
+  internalError: -32603,
+  serverError: -32e3,
+  // Frak specific errors (from -32001 to -32099)
+  clientNotConnected: -32001,
+  configError: -32002,
+  corruptedResponse: -32003,
+  clientAborted: -32004,
+  walletNotConnected: -32005,
+  noInteractionSession: -32006
+};
+
+// src/core/utils/Deferred.ts
+var Deferred = class {
+  constructor() {
+    _chunkETV4XYOVcjs.__publicField.call(void 0, this, "_promise");
+    _chunkETV4XYOVcjs.__publicField.call(void 0, this, "_resolve");
+    _chunkETV4XYOVcjs.__publicField.call(void 0, this, "_reject");
+    _chunkETV4XYOVcjs.__publicField.call(void 0, this, "resolve", (value) => {
+      _optionalChain([this, 'access', _2 => _2._resolve, 'optionalCall', _3 => _3(value)]);
+    });
+    _chunkETV4XYOVcjs.__publicField.call(void 0, this, "reject", (reason) => {
+      _optionalChain([this, 'access', _4 => _4._reject, 'optionalCall', _5 => _5(reason)]);
+    });
+    this._promise = new Promise((resolve, reject) => {
+      this._resolve = resolve;
+      this._reject = reject;
+    });
+  }
+  get promise() {
+    return this._promise;
+  }
+};
+
+// src/core/utils/compression/compress.ts
+var _asynclzstring = require('async-lz-string');
+var _jssha256 = require('js-sha256');
+async function hashAndCompressData(data) {
+  const validationHash = _jssha256.sha256.call(void 0, JSON.stringify(data));
+  const hashProtectedData = {
+    ...data,
+    validationHash
+  };
+  const compressed = await compressJson(hashProtectedData);
+  const compressedHash = _jssha256.sha256.call(void 0, compressed);
+  return {
+    compressed,
+    compressedHash
+  };
+}
+async function compressJson(data) {
+  return _asynclzstring.compressToBase64.call(void 0, JSON.stringify(data));
+}
+
+// src/core/utils/compression/decompress.ts
+
+
+async function decompressDataAndCheckHash(compressedData) {
+  if (!(_optionalChain([compressedData, 'optionalAccess', _6 => _6.compressed]) && _optionalChain([compressedData, 'optionalAccess', _7 => _7.compressedHash]))) {
+    throw new FrakRpcError(
+      RpcErrorCodes.corruptedResponse,
+      "Missing compressed data"
+    );
+  }
+  const parsedData = await decompressJson(
+    compressedData.compressed
+  );
+  if (!parsedData) {
+    throw new FrakRpcError(
+      RpcErrorCodes.corruptedResponse,
+      "Invalid compressed data"
+    );
+  }
+  if (!_optionalChain([parsedData, 'optionalAccess', _8 => _8.validationHash])) {
+    throw new FrakRpcError(
+      RpcErrorCodes.corruptedResponse,
+      "Missing validation hash"
+    );
+  }
+  const expectedCompressedHash = _jssha256.sha256.call(void 0, compressedData.compressed);
+  if (expectedCompressedHash !== compressedData.compressedHash) {
+    throw new FrakRpcError(
+      RpcErrorCodes.corruptedResponse,
+      "Invalid compressed hash"
+    );
+  }
+  const { validationHash: _, ...rawResultData } = parsedData;
+  const expectedValidationHash = _jssha256.sha256.call(void 0, JSON.stringify(rawResultData));
+  if (expectedValidationHash !== parsedData.validationHash) {
+    throw new FrakRpcError(
+      RpcErrorCodes.corruptedResponse,
+      "Invalid data validation hash"
+    );
+  }
+  return parsedData;
+}
+async function decompressJson(data) {
+  const decompressed = await _asynclzstring.decompressFromBase64.call(void 0, data);
+  try {
+    return JSON.parse(decompressed);
+  } catch (e) {
+    console.error("Invalid compressed data", e);
+    return null;
+  }
+}
+
+// src/core/utils/constants.ts
+var BACKUP_KEY = "nexus-wallet-backup";
+
+// src/core/clients/transports/iframeChannelManager.ts
+function createIFrameChannelManager() {
+  const channels = /* @__PURE__ */ new Map();
+  return {
+    // TODO: Better id system?? uid stuff?
+    createChannel: (resolver) => {
+      const id = Math.random().toString(36).substring(7);
+      channels.set(id, resolver);
+      return id;
+    },
+    getRpcResolver: (id) => channels.get(id),
+    removeChannel: (id) => channels.delete(id),
+    destroy: () => channels.clear()
+  };
+}
+
+// src/core/utils/iframeHelper.ts
+var baseIframeProps = {
+  id: "nexus-wallet",
+  name: "nexus-wallet",
+  allow: "publickey-credentials-get *; clipboard-write; web-share *",
+  style: {
+    width: "0",
+    height: "0",
+    border: "0",
+    position: "absolute",
+    zIndex: 1e3,
+    top: "-1000px",
+    left: "-1000px"
+  }
+};
+function createIframe({
+  walletBaseUrl
+}) {
+  const alreadyCreatedIFrame = document.querySelector("#nexus-wallet");
+  if (alreadyCreatedIFrame) {
+    return Promise.resolve(void 0);
+  }
+  const iframe = document.createElement("iframe");
+  iframe.id = baseIframeProps.id;
+  iframe.name = baseIframeProps.name;
+  iframe.allow = baseIframeProps.allow;
+  iframe.style.zIndex = baseIframeProps.style.zIndex.toString();
+  changeIframeVisibility({ iframe, isVisible: false });
+  document.body.appendChild(iframe);
+  return new Promise((resolve) => {
+    _optionalChain([iframe, 'optionalAccess', _9 => _9.addEventListener, 'call', _10 => _10("load", () => resolve(iframe))]);
+    iframe.src = `${walletBaseUrl}/listener`;
+  });
+}
+function changeIframeVisibility({
+  iframe,
+  isVisible
+}) {
+  if (!isVisible) {
+    iframe.style.width = "0";
+    iframe.style.height = "0";
+    iframe.style.border = "0";
+    iframe.style.position = "fixed";
+    iframe.style.top = "-1000px";
+    iframe.style.left = "-1000px";
+    return;
+  }
+  iframe.style.position = "fixed";
+  iframe.style.top = "0";
+  iframe.style.left = "0";
+  iframe.style.width = "100%";
+  iframe.style.height = "100%";
+  iframe.style.pointerEvents = "auto";
+}
+
+// src/core/clients/transports/iframeLifecycleManager.ts
+function createIFrameLifecycleManager({
+  iframe
+}) {
+  const isConnectedDeferred = new Deferred();
+  const handler = async (messageEvent) => {
+    switch (messageEvent.iframeLifecycle) {
+      case "connected":
+        isConnectedDeferred.resolve(true);
+        break;
+      case "do-backup":
+        if (messageEvent.data.backup) {
+          localStorage.setItem(BACKUP_KEY, messageEvent.data.backup);
+        } else {
+          localStorage.removeItem(BACKUP_KEY);
+        }
+        break;
+      case "show":
+      case "hide":
+        changeIframeVisibility({
+          iframe,
+          isVisible: messageEvent.iframeLifecycle === "show"
+        });
+        break;
+    }
+  };
+  return {
+    handleEvent: handler,
+    isConnected: isConnectedDeferred.promise
+  };
+}
+
+// src/core/clients/transports/iframeMessageHandler.ts
+function createIFrameMessageHandler({
+  nexusWalletUrl,
+  iframe,
+  channelManager,
+  iframeLifecycleManager
+}) {
+  if (typeof window === "undefined") {
+    throw new FrakRpcError(
+      RpcErrorCodes.configError,
+      "iframe client should be used in the browser"
+    );
+  }
+  if (!iframe.contentWindow) {
+    throw new FrakRpcError(
+      RpcErrorCodes.configError,
+      "The iframe does not have a content window"
+    );
+  }
+  const contentWindow = iframe.contentWindow;
+  const msgHandler = async (event) => {
+    if (!event.origin) {
+      return;
+    }
+    if (new URL(event.origin).origin.toLowerCase() !== new URL(nexusWalletUrl).origin.toLowerCase()) {
+      return;
+    }
+    if ("iframeLifecycle" in event.data) {
+      await iframeLifecycleManager.handleEvent(event.data);
+      return;
+    }
+    if ("clientLifecycle" in event.data) {
+      console.error(
+        "Client lifecycle event received on the client side, dismissing it"
+      );
+      return;
+    }
+    const channel = event.data.id;
+    const resolver = channelManager.getRpcResolver(channel);
+    if (!resolver) {
+      return;
+    }
+    await resolver(event.data);
+  };
+  window.addEventListener("message", msgHandler);
+  const sendEvent = (message) => {
+    contentWindow.postMessage(message, {
+      targetOrigin: nexusWalletUrl
+    });
+  };
+  const cleanup = () => {
+    window.removeEventListener("message", msgHandler);
+  };
+  return {
+    sendEvent,
+    cleanup
+  };
+}
+
+// src/core/clients/createIFrameNexusClient.ts
+function createIFrameNexusClient({
+  config,
+  iframe
+}) {
+  const channelManager = createIFrameChannelManager();
+  const lifecycleManager = createIFrameLifecycleManager({ iframe });
+  const messageHandler = createIFrameMessageHandler({
+    nexusWalletUrl: config.walletUrl,
+    iframe,
+    channelManager,
+    iframeLifecycleManager: lifecycleManager
+  });
+  const request = async (args) => {
+    const isConnected = await lifecycleManager.isConnected;
+    if (!isConnected) {
+      throw new FrakRpcError(
+        RpcErrorCodes.clientNotConnected,
+        "The iframe provider isn't connected yet"
+      );
+    }
+    const result = new Deferred();
+    const channelId = channelManager.createChannel(async (message) => {
+      const decompressed = await decompressDataAndCheckHash(message.data);
+      if (decompressed.error) {
+        result.reject(
+          new FrakRpcError(
+            decompressed.error.code,
+            decompressed.error.message,
+            _optionalChain([decompressed, 'access', _11 => _11.error, 'optionalAccess', _12 => _12.data])
+          )
+        );
+      } else {
+        result.resolve(decompressed.result);
+      }
+      channelManager.removeChannel(channelId);
+    });
+    const compressedMessage = await hashAndCompressData(args);
+    messageHandler.sendEvent({
+      id: channelId,
+      topic: args.method,
+      data: compressedMessage
+    });
+    return result.promise;
+  };
+  const listenerRequest = async (args, callback) => {
+    const isConnected = await lifecycleManager.isConnected;
+    if (!isConnected) {
+      throw new FrakRpcError(
+        RpcErrorCodes.clientNotConnected,
+        "The iframe provider isn't connected yet"
+      );
+    }
+    const channelId = channelManager.createChannel(async (message) => {
+      const decompressed = await decompressDataAndCheckHash(message.data);
+      if (decompressed.result) {
+        callback(decompressed.result);
+      } else {
+        throw new InternalError("No valid result in the response");
+      }
+    });
+    const compressedMessage = await hashAndCompressData(args);
+    messageHandler.sendEvent({
+      id: channelId,
+      topic: args.method,
+      data: compressedMessage
+    });
+  };
+  const destroy = async () => {
+    channelManager.destroy();
+    messageHandler.cleanup();
+    iframe.remove();
+  };
+  const waitForSetup = postConnectionSetup({
+    config,
+    messageHandler,
+    lifecycleManager
+  });
+  return {
+    config,
+    waitForConnection: lifecycleManager.isConnected,
+    waitForSetup,
+    request,
+    listenerRequest,
+    destroy
+  };
+}
+async function postConnectionSetup({
+  config,
+  messageHandler,
+  lifecycleManager
+}) {
+  await lifecycleManager.isConnected;
+  const pushCss = async () => {
+    const cssLink = config.metadata.css;
+    if (!cssLink) return;
+    messageHandler.sendEvent({
+      clientLifecycle: "modal-css",
+      data: { cssLink }
+    });
+  };
+  const pushBackup = async () => {
+    if (typeof window === "undefined") return;
+    const backup = window.localStorage.getItem(BACKUP_KEY);
+    if (!backup) return;
+    messageHandler.sendEvent({
+      clientLifecycle: "restore-backup",
+      data: { backup }
+    });
+  };
+  await Promise.all([pushCss(), pushBackup()]);
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.FrakRpcError = FrakRpcError; exports.ClientNotFound = ClientNotFound; exports.RpcErrorCodes = RpcErrorCodes; exports.Deferred = Deferred; exports.hashAndCompressData = hashAndCompressData; exports.compressJson = compressJson; exports.decompressDataAndCheckHash = decompressDataAndCheckHash; exports.decompressJson = decompressJson; exports.baseIframeProps = baseIframeProps; exports.createIframe = createIframe; exports.createIFrameNexusClient = createIFrameNexusClient;

package/dist/{chunk-72IEHEQX.js → chunk-GUDT2W6I.js}

@@ -3,8 +3,7 @@ import { concatHex, pad } from "viem";
 var PressTypeSelector = "0x02";
 var PressActionsSelector = {
   OpenArticle: "0xc0a24ffb",
-  ReadArticle: "0xd5bd0fbe",
-  Referred: "0x3d1508ad"
+  ReadArticle: "0xd5bd0fbe"
 };
 function openArticle({ articleId }) {
   const interactionData = concatHex([
@@ -26,23 +25,46 @@ function readArticle({ articleId }) {
     interactionData
   };
 }
+var PressInteractionEncoder = {
+  openArticle,
+  readArticle
+};
+
+// src/core/interactions/referralEncoder.ts
+import { concatHex as concatHex2, pad as pad2 } from "viem";
+var ReferralTypeSelector = "0x1E";
+var ReferralActionsSelector = {
+  CreateLink: "0xb2c0f17c",
+  Referred: "0x010cc3b9"
+};
+function createLink() {
+  const interactionData = concatHex2([
+    ReferralActionsSelector.CreateLink,
+    "0x"
+  ]);
+  return {
+    handlerTypeDenominator: ReferralTypeSelector,
+    interactionData
+  };
+}
 function referred({ referrer }) {
-  const interactionData = concatHex([
-    PressActionsSelector.Referred,
-    pad(referrer, { size: 32 })
+  const interactionData = concatHex2([
+    ReferralActionsSelector.Referred,
+    pad2(referrer, { size: 32 })
   ]);
   return {
-    handlerTypeDenominator: PressTypeSelector,
+    handlerTypeDenominator: ReferralTypeSelector,
     interactionData
   };
 }
-var PressInteractionEncoder = {
-  openArticle,
-  readArticle,
+var ReferralInteractionEncoder = {
+  createLink,
   referred
 };
 
 export {
   PressActionsSelector,
-  PressInteractionEncoder
+  PressInteractionEncoder,
+  ReferralActionsSelector,
+  ReferralInteractionEncoder
 };