@frak-labs/core-sdk 0.1.0 → 0.1.1-beta.1e44255d

package/dist/bundle.js

@@ -1,13 +1 @@
-import{Deferred as e,FrakRpcError as t,RpcErrorCodes as n,compressJson as r,createRpcClient as a,decompressJson as o}from"@frak-labs/frame-connector";import{createClientCompressionMiddleware as i}from"@frak-labs/frame-connector/middleware";import{OpenPanel as s}from"@openpanel/web";import{bytesToHex as c,concatHex as l,encodeAbiParameters as u,hexToBytes as d,isAddressEqual as f,keccak256 as p,pad as m,toHex as w}from"viem";import{generateSiweNonce as h}from"viem/siwe";let g="nexus-wallet-backup";class y{config;iframe;isSetupDone=!1;lastResponse=null;lastRequest=null;constructor(e,t){this.config=e,this.iframe=t,this.lastRequest=null,this.lastResponse=null}setLastResponse(e,t){this.lastResponse={message:e,response:t,timestamp:Date.now()}}setLastRequest(e){this.lastRequest={event:e,timestamp:Date.now()}}updateSetupStatus(e){this.isSetupDone=e}base64Encode(e){try{return btoa(JSON.stringify(e))}catch(e){return console.warn("Failed to encode debug data",e),btoa("Failed to encode data")}}getIframeStatus(){return this.iframe?{loading:this.iframe.hasAttribute("loading"),url:this.iframe.src,readyState:this.iframe.contentDocument?.readyState?+("complete"===this.iframe.contentDocument.readyState):-1,contentWindow:!!this.iframe.contentWindow,isConnected:this.iframe.isConnected}:null}getNavigatorInfo(){return navigator?{userAgent:navigator.userAgent,language:navigator.language,onLine:navigator.onLine,screenWidth:window.screen.width,screenHeight:window.screen.height,pixelRatio:window.devicePixelRatio}:null}gatherDebugInfo(e){let n=this.getIframeStatus(),r=this.getNavigatorInfo(),a="Unknown";return e instanceof t?a=`FrakRpcError: ${e.code} '${e.message}'`:e instanceof Error?a=e.message:"string"==typeof e&&(a=e),{timestamp:new Date().toISOString(),encodedUrl:btoa(window.location.href),encodedConfig:this.config?this.base64Encode(this.config):"no-config",navigatorInfo:r?this.base64Encode(r):"no-navigator",iframeStatus:n?this.base64Encode(n):"not-iframe",lastRequest:this.lastRequest?this.base64Encode(this.lastRequest):"No Frak request logged",lastResponse:this.lastResponse?this.base64Encode(this.lastResponse):"No Frak response logged",clientStatus:this.isSetupDone?"setup":"not-setup",error:a}}static empty(){return new y}formatDebugInfo(e){let t=this.gatherDebugInfo(e);return`
-  Debug Information:
-  -----------------
-  Timestamp: ${t.timestamp}
-  URL: ${t.encodedUrl}
-  Config: ${t.encodedConfig}
-  Navigator Info: ${t.navigatorInfo}
-  IFrame Status: ${t.iframeStatus}
-  Last Request: ${t.lastRequest}
-  Last Response: ${t.lastResponse}
-  Client Status: ${t.clientStatus}
-  Error: ${t.error}
-  `.trim()}}let k={id:"frak-wallet",name:"frak-wallet",title:"Frak Wallet",allow:"publickey-credentials-get *; clipboard-write; web-share *",style:{width:"0",height:"0",border:"0",position:"absolute",zIndex:2000001,top:"-1000px",left:"-1000px",colorScheme:"auto"}};function b({walletBaseUrl:e,config:t}){let n=document.querySelector("#frak-wallet");n&&n.remove();let r=document.createElement("iframe");return r.id=k.id,r.name=k.name,r.allow=k.allow,r.style.zIndex=k.style.zIndex.toString(),S({iframe:r,isVisible:!1}),document.body.appendChild(r),new Promise(n=>{r?.addEventListener("load",()=>n(r)),r.src=`${t?.walletUrl??e??"https://wallet.frak.id"}/listener`})}function S({iframe:e,isVisible:t}){if(!t){e.style.width="0",e.style.height="0",e.style.border="0",e.style.position="fixed",e.style.top="-1000px",e.style.left="-1000px";return}e.style.position="fixed",e.style.top="0",e.style.left="0",e.style.width="100%",e.style.height="100%",e.style.pointerEvents="auto"}function I({config:r,iframe:o}){let c,l=r?.walletUrl??"https://wallet.frak.id",u=function({iframe:t}){let n=new e;return{handleEvent:async e=>{if(!("iframeLifecycle"in e))return;let{iframeLifecycle:r,data:a}=e;switch(r){case"connected":n.resolve(!0);break;case"do-backup":a.backup?localStorage.setItem(g,a.backup):localStorage.removeItem(g);break;case"remove-backup":localStorage.removeItem(g);break;case"show":case"hide":S({iframe:t,isVisible:"show"===r});break;case"handshake":t.contentWindow?.postMessage({clientLifecycle:"handshake-response",data:{token:a.token,currentUrl:window.location.href}},"*");break;case"redirect":{let e=new URL(a.baseRedirectUrl);e.searchParams.has("u")?(e.searchParams.delete("u"),e.searchParams.append("u",window.location.href),window.location.href=e.toString()):window.location.href=a.baseRedirectUrl}}},isConnected:n.promise}}({iframe:o}),d=new y(r,o);if(!o.contentWindow)throw new t(n.configError,"The iframe does not have a content window");let f=a({emittingTransport:o.contentWindow,listeningTransport:window,targetOrigin:l,middleware:[{async onRequest(e,r){if(!await u.isConnected)throw new t(n.clientNotConnected,"The iframe provider isn't connected yet");return r}},i(),{onRequest:(e,t)=>(d.setLastRequest(e),t),onResponse:(e,t)=>(d.setLastResponse(e,t),t)}],lifecycleHandlers:{iframeLifecycle:async(e,t)=>{await u.handleEvent(e)}}}),p=function(e,t){let n,r,a=()=>e.sendLifecycle({clientLifecycle:"heartbeat"});function o(){n&&clearInterval(n),r&&clearTimeout(r)}return async function(){a(),n=setInterval(a,1e3),r=setTimeout(()=>{o(),console.log("Heartbeat timeout: connection failed")},3e4),await t.isConnected,o()}(),o}(f,u),m=async()=>{p(),f.cleanup(),o.remove()};console.log("[Frak SDK] Initializing OpenPanel"),(c=new s({apiUrl:"https://op-api.gcp.frak.id",clientId:"f305d11d-b93b-487c-80d4-92deb7903e98",trackScreenViews:!0,trackOutgoingLinks:!0,trackAttributes:!1,filter:({type:e,payload:t})=>!("track"===e&&t?.properties)||("sdkVersion"in t.properties||(t.properties={...t.properties,sdkVersion:"0.1.0"}),!0)})).setGlobalProperties({sdkVersion:"0.1.0"}),c.init();let w=v({config:r,rpcClient:f,lifecycleManager:u}).then(()=>d.updateSetupStatus(!0));return{config:r,debugInfo:d,waitForConnection:u.isConnected,waitForSetup:w,request:f.request,listenerRequest:f.listen,destroy:m,openPanel:c}}async function v({config:e,rpcClient:t,lifecycleManager:n}){async function r(){let n=e.customizations?.css;n&&t.sendLifecycle({clientLifecycle:"modal-css",data:{cssLink:n}})}async function a(){let n=e.customizations?.i18n;n&&t.sendLifecycle({clientLifecycle:"modal-i18n",data:{i18n:n}})}async function o(){if("undefined"==typeof window)return;let e=window.localStorage.getItem(g);e&&t.sendLifecycle({clientLifecycle:"restore-backup",data:{backup:e}})}await n.isConnected,function(e,t){if("undefined"==typeof window)return;let n=new URL(window.location.href),r=n.searchParams.get("sso");r&&(t.then(()=>{e.sendLifecycle({clientLifecycle:"sso-redirect-complete",data:{compressed:r}}),console.log("[SSO URL Listener] Forwarded compressed SSO data to iframe")}).catch(e=>{console.error("[SSO URL Listener] Failed to forward SSO data:",e)}),n.searchParams.delete("sso"),window.history.replaceState({},"",n.toString()),console.log("[SSO URL Listener] SSO parameter detected and URL cleaned"))}(t,n.isConnected),await Promise.allSettled([r(),a(),o()])}let R={eur:"fr-FR",usd:"en-US",gbp:"en-GB"};function L(e){return e&&e in R?e:"eur"}async function x({config:e}){let t=function(e){let t=L(e.metadata?.currency);return{...e,metadata:{...e.metadata,currency:t}}}(e),n=await b({config:t});if(!n)return void console.error("Failed to create iframe");let r=I({config:t,iframe:n});return(await r.waitForSetup,await r.waitForConnection)?r:void console.error("Failed to connect to client")}function F(e){return btoa(Array.from(e,e=>String.fromCharCode(e)).join("")).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")}function C(e){let t=e.length%4;return Uint8Array.from(atob(e.replace(/-/g,"+").replace(/_/g,"/").padEnd(e.length+(0===t?0:4-t),"=")),e=>e.charCodeAt(0))}function T(e){return F(r(e))}function E(e){return o(C(e))}let D="fCtx";function P(e){if(e?.r)try{let t=d(e.r);return F(t)}catch(t){console.error("Error compressing Frak context",{e:t,context:e})}}function U(e){if(e&&0!==e.length)try{let t=C(e);return{r:c(t,{size:20})}}catch(t){console.error("Error decompressing Frak context",{e:t,context:e})}}function q({url:e}){if(!e)return null;let t=new URL(e).searchParams.get(D);return t?U(t):null}function A({url:e,context:t}){if(!e)return null;let n=q({url:e}),r=n?{...n,...t}:t;if(!r.r)return null;let a=P(r);if(!a)return null;let o=new URL(e);return o.searchParams.set(D,a),o.toString()}function $(e){let t=new URL(e);return t.searchParams.delete(D),t.toString()}let O={compress:P,decompress:U,parse:q,update:A,remove:$,replaceUrl:function({url:e,context:t}){let n;if(!window.location?.href||"undefined"==typeof window)return void console.error("No window found, can't update context");let r=e??window.location.href;(n=null!==t?A({url:r,context:t}):$(r))&&window.history.replaceState(null,"",n.toString())}};function W(e){return e?R[e]??R.eur:R.eur}function z(e){return e?`${e}Amount`:"eurAmount"}function N(e,t){let n=W(t),r=L(t);return e.toLocaleString(n,{style:"currency",currency:r,minimumFractionDigits:0,maximumFractionDigits:2})}function _(e,t,n={}){if(!e)return void console.debug("[Frak] No client provided, skipping event tracking");try{e.openPanel?.track(t,n)}catch(e){console.debug("[Frak] Failed to track event:",t,e)}}let M={dapp:1,press:2,webshop:3,retail:4,referral:30,purchase:31},V=Object.entries(M).reduce((e,[t,n])=>(e[t]=BigInt(1)<<BigInt(n),e),{}),B={press:{openArticle:"0xc0a24ffb",readArticle:"0xd5bd0fbe"},dapp:{proofVerifiableStorageUpdate:"0x2ab2aeef",callableVerifiableStorageUpdate:"0xa07da986"},webshop:{open:"0xb311798f"},referral:{referred:"0x010cc3b9",createLink:"0xb2c0f17c"},purchase:{started:"0xd87e90c3",completed:"0x8403aeb4",unsafeCompleted:"0x4d5b14e0"},retail:{customerMeeting:"0x74489004"}};function j(t,n){if(!n)return t.request({method:"frak_listenToWalletStatus"}).then(e=>(G(t,e),e));let r=new e,a=!1;return t.listenerRequest({method:"frak_listenToWalletStatus"},e=>{G(t,e),n(e),a||(r.resolve(e),a=!0)}),r.promise}function G(e,t){"undefined"!=typeof window&&(e.openPanel?.setGlobalProperties({wallet:t.wallet??null}),t.interactionToken?window.sessionStorage.setItem("frak-wallet-interaction-token",t.interactionToken):window.sessionStorage.removeItem("frak-wallet-interaction-token"))}async function J(e,{productId:t,interaction:n,validation:r}){let a=t??function({domain:e}){return p(w((e??window.location.host).replace("www.","")))}(e.config);return await e.request({method:"frak_sendInteraction",params:[a,n,r]})}async function H(e,{steps:t,metadata:n}){return await e.request({method:"frak_displayModal",params:[t,n,e.config.metadata]})}async function K(e,t){return await e.request({method:"frak_displayEmbeddedWallet",params:[t,e.config.metadata]})}async function Q(e,t){let{metadata:n,customizations:r}=e.config;return await e.request({method:"frak_sso",params:[t,n.name,r?.css]})??{}}async function X(e){return await e.request({method:"frak_getProductInformation"})}async function Y(e){if("undefined"==typeof window)return void console.warn("[Frak] No window found, can't track purchase");let t=window.sessionStorage.getItem("frak-wallet-interaction-token");if(!t)return void console.warn("[Frak] No frak session found, skipping purchase check");await fetch("https://backend.frak.id/interactions/listenForPurchase",{method:"POST",headers:{Accept:"application/json","Content-Type":"application/json","x-wallet-sdk-auth":t},body:JSON.stringify(e)})}async function Z(e,{siwe:t,metadata:n}){let r=e.config?.domain??window.location.host,a=t?.statement??`I confirm that I want to use my Frak wallet on: ${e.config.metadata.name}`,o={...t,statement:a,nonce:t?.nonce??h(),uri:t?.uri??`https://${r}`,version:t?.version??"1",domain:r};return(await H(e,{metadata:n,steps:{login:{},siweAuthenticate:{siwe:o}}})).siweAuthenticate}async function ee(e,{tx:t,metadata:n}){return(await H(e,{metadata:n,steps:{login:{},sendTransaction:{tx:t}}})).sendTransaction}function et(e,{metadata:t,login:n,openSession:r}){return function e(t,n){async function r(e){return e&&(n.metadata=e(n.metadata??{})),await H(t,n)}return{params:n,sendTx:function(r){return e(t,{...n,steps:{...n.steps,sendTransaction:r}})},reward:function(r){return e(t,{...n,steps:{...n.steps,final:{...r,action:{key:"reward"}}}})},sharing:function(r,a){return e(t,{...n,steps:{...n.steps,final:{...a,action:{key:"sharing",options:r}}}})},display:r}}(e,{steps:{login:n??{},openSession:r??{}},metadata:t})}let en={createLink:()=>({handlerTypeDenominator:w(M.referral),interactionData:B.referral.createLink}),referred({referrer:e}){let t=l([B.referral.referred,m(e,{size:32})]);return{handlerTypeDenominator:w(M.referral),interactionData:t}}};async function er(e,{walletStatus:r,frakContext:a,modalConfig:o,productId:i,options:s}){let c=!1;async function l(){if(!c)return c=!0,eo(e,{modalConfig:{...o,loggedIn:{action:{key:"referred"}}},walletStatus:r})}async function u(t){let n=en.referred({referrer:t});await Promise.allSettled([J(e,{productId:i,interaction:n}),_(e,"user_referred",{properties:{referrer:t}})])}try{let{status:e,currentWallet:t}=await ea({initialWalletStatus:r,getFreshWalletStatus:l,pushReferralInteraction:u,frakContext:a});return O.replaceUrl({url:window.location?.href,context:s?.alwaysAppendUrl?{r:t}:null}),e}catch(e){return console.log("Error processing referral",{error:e}),O.replaceUrl({url:window.location?.href,context:s?.alwaysAppendUrl?{r:r?.wallet}:null}),function(e){if(e instanceof t)switch(e.code){case n.walletNotConnected:return"no-wallet";case n.serverErrorForInteractionDelegation:return"no-session"}return"error"}(e)}}async function ea({initialWalletStatus:e,getFreshWalletStatus:t,pushReferralInteraction:n,frakContext:r}){let a=e?.wallet;return r?.r?(a||(a=await t()),a&&f(r.r,a))?{status:"self-referral",currentWallet:a}:(e?.interactionSession||(a=await t()),await n(r.r),{status:"success",currentWallet:a}):{status:"no-referrer",currentWallet:a}}async function eo(e,{modalConfig:t,walletStatus:n}){if(!n?.interactionSession){let n=await K(e,t??{});return n?.wallet??void 0}return n.wallet??void 0}async function ei(e,{productId:t,modalConfig:n,options:r}={}){let a=O.parse({url:window.location.href}),o=await j(e);try{return await er(e,{walletStatus:o,frakContext:a,modalConfig:n,productId:t,options:r})}catch(e){console.warn("Error processing referral",{error:e})}}let es={openArticle({articleId:e}){let t=l([B.press.openArticle,m(e,{size:32})]);return{handlerTypeDenominator:w(M.press),interactionData:t}},readArticle({articleId:e}){let t=l([B.press.readArticle,m(e,{size:32})]);return{handlerTypeDenominator:w(M.press),interactionData:t}}},ec={startPurchase({purchaseId:e}){let t=l([B.purchase.started,m(e,{size:32})]);return{handlerTypeDenominator:w(M.purchase),interactionData:t}},completedPurchase({purchaseId:e,proof:t}){let n=u([{type:"uint256"},{type:"bytes32[]"}],[BigInt(e),t]),r=l([B.purchase.completed,n]);return{handlerTypeDenominator:w(M.purchase),interactionData:r}},unsafeCompletedPurchase({purchaseId:e}){let t=l([B.purchase.unsafeCompleted,m(e,{size:32})]);return{handlerTypeDenominator:w(M.purchase),interactionData:t}}},el={open:()=>({handlerTypeDenominator:w(M.webshop),interactionData:B.webshop.open})},eu={customerMeeting({agencyId:e}){let t=l([B.retail.customerMeeting,m(e,{size:32})]);return{handlerTypeDenominator:w(M.retail),interactionData:t}}};export{y as DebugInfoGatherer,O as FrakContextManager,es as PressInteractionEncoder,ec as PurchaseInteractionEncoder,en as ReferralInteractionEncoder,eu as RetailInteractionEncoder,el as WebShopInteractionEncoder,C as base64urlDecode,F as base64urlEncode,k as baseIframeProps,T as compressJsonToB64,I as createIFrameFrakClient,b as createIframe,E as decompressJsonFromB64,K as displayEmbeddedWallet,H as displayModal,N as formatAmount,z as getCurrencyAmountKey,X as getProductInformation,L as getSupportedCurrency,W as getSupportedLocale,B as interactionTypes,R as locales,et as modalBuilder,Q as openSso,er as processReferral,M as productTypes,V as productTypesMask,ei as referralInteraction,J as sendInteraction,ee as sendTransaction,x as setupClient,Z as siweAuthenticate,_ as trackEvent,Y as trackPurchaseStatus,j as watchWalletStatus};
+import{a as e,c as t,d as n,f as r,h as i,i as a,l as o,m as s,n as c,o as l,p as u,r as d,s as f,t as p,u as m}from"./trackEvent-M2RLTQ2p.js";import{_ as h,a as g,c as _,d as v,f as y,g as b,h as x,i as S,l as C,m as w,n as T,o as E,p as D,r as O,s as k,t as A,u as j}from"./setupClient-Cfwpu08d.js";import{a as M,c as N,d as P,f as F,i as I,l as L,n as R,o as z,p as B,r as V,s as H,t as U,u as W}from"./siweAuthenticate-BJHbtty4.js";export{b as DEEP_LINK_SCHEME,O as DebugInfoGatherer,e as FrakContextManager,r as base64urlDecode,u as base64urlEncode,S as baseIframeProps,c as clearMerchantIdCache,n as compressJsonToB64,s as computeLegacyProductId,T as createIFrameFrakClient,g as createIframe,h as decompressJsonFromB64,B as displayEmbeddedWallet,F as displayModal,P as ensureIdentity,d as fetchMerchantId,E as findIframeInOpener,_ as formatAmount,m as generateSsoUrl,l as getBackendUrl,i as getClientId,k as getCurrencyAmountKey,W as getMerchantInformation,j as getSupportedCurrency,C as getSupportedLocale,y as isChromiumAndroid,D as isFrakDeepLink,v as locales,V as modalBuilder,f as openSso,L as prepareSso,H as processReferral,z as referralInteraction,a as resolveMerchantId,N as sendInteraction,R as sendTransaction,A as setupClient,U as siweAuthenticate,t as ssoPopupFeatures,o as ssoPopupName,w as toAndroidIntentUrl,p as trackEvent,M as trackPurchaseStatus,x as triggerDeepLinkWithFallback,I as watchWalletStatus};

package/dist/computeLegacyProductId-BkyJ4rEY.d.ts

@@ -0,0 +1,538 @@
+import { F as PrepareSsoParamsType, G as FrakWalletSdkConfig, L as SsoMetadata, W as Currency, a as FrakClient, i as FrakContext, p as TokenAmountType } from "./openSso-DG-_9CED.js";
+import { Address, Hex } from "viem";
+import { RpcMessage, RpcResponse } from "@frak-labs/frame-connector";
+
+//#region src/types/compression.d.ts
+/**
+ * The received encoded data from a client
+ *  -> The encoded should contain a HashProtectedData once decoded
+ *  @ignore
+ */
+type CompressedData = Uint8Array;
+/**
+ * The encoded data to send to a client / received by a client
+ *  @ignore
+ */
+type HashProtectedData<DataType> = Readonly<DataType & {
+  validationHash: string;
+}>;
+/**
+ * Represent a key provider used for the hashed and secure compression
+ *  @ignore
+ */
+type KeyProvider<DataType> = (value: DataType) => string[];
+//#endregion
+//#region src/types/tracking.d.ts
+/**
+ * UTM parameters for marketing attribution
+ * @category Tracking
+ */
+type UtmParams = {
+  source?: string;
+  medium?: string;
+  campaign?: string;
+  term?: string;
+  content?: string;
+};
+/**
+ * Parameters for tracking an arrival event
+ * @category Tracking
+ */
+type TrackArrivalParams = {
+  /**
+   * The referrer wallet address (from fCtx URL param)
+   */
+  referrerWallet?: Address;
+  /**
+   * The landing page URL (defaults to current page)
+   */
+  landingUrl?: string;
+  /**
+   * UTM parameters for marketing attribution
+   */
+  utmParams?: UtmParams;
+};
+/**
+ * Result from tracking an arrival event
+ * @category Tracking
+ */
+type TrackArrivalResult = {
+  success: boolean;
+  identityGroupId?: string;
+  touchpointId?: string;
+  error?: string;
+};
+//#endregion
+//#region src/clients/createIFrameFrakClient.d.ts
+/**
+ * Create a new iframe Frak client
+ * @param args
+ * @param args.config - The configuration to use for the Frak Wallet SDK.
+ *   When `config.domain` is set, it is forwarded to the iframe handshake so the listener resolves the correct merchant in tunneled/proxied environments (e.g. Shopify dev with Cloudflare tunnel).
+ * @param args.iframe - The iframe to use for the communication
+ * @returns The created Frak Client
+ *
+ * @example
+ * const frakConfig: FrakWalletSdkConfig = {
+ *     metadata: {
+ *         name: "My app title",
+ *     },
+ * }
+ * const iframe = await createIframe({ config: frakConfig });
+ * const client = createIFrameFrakClient({ config: frakConfig, iframe });
+ */
+declare function createIFrameFrakClient({
+  config,
+  iframe
+}: {
+  config: FrakWalletSdkConfig;
+  iframe: HTMLIFrameElement;
+}): FrakClient;
+//#endregion
+//#region src/clients/DebugInfo.d.ts
+/** @ignore */
+declare class DebugInfoGatherer {
+  private config?;
+  private iframe?;
+  private isSetupDone;
+  private lastResponse;
+  private lastRequest;
+  constructor(config?: FrakWalletSdkConfig, iframe?: HTMLIFrameElement);
+  setLastResponse(message: RpcMessage, response: RpcResponse): void;
+  setLastRequest(event: RpcMessage): void;
+  updateSetupStatus(status: boolean): void;
+  private base64Encode;
+  /**
+   * Extract information from the iframe status
+   */
+  private getIframeStatus;
+  private getNavigatorInfo;
+  private gatherDebugInfo;
+  static empty(): DebugInfoGatherer;
+  /**
+   * Format Frak debug information
+   */
+  formatDebugInfo(error: Error | unknown | string): string;
+}
+//#endregion
+//#region src/clients/setupClient.d.ts
+/**
+ * Directly setup the Frak client with an iframe
+ * Return when the FrakClient is ready (setup and communication estbalished with the wallet)
+ *
+ * @param config - The configuration to use for the Frak Wallet SDK
+ * @returns a Promise with the Frak Client
+ *
+ * @example
+ * const frakConfig: FrakWalletSdkConfig = {
+ *     metadata: {
+ *         name: "My app title",
+ *     },
+ * }
+ * const client = await setupClient({ config: frakConfig });
+ */
+declare function setupClient({
+  config
+}: {
+  config: FrakWalletSdkConfig;
+}): Promise<FrakClient | undefined>;
+//#endregion
+//#region src/constants/locales.d.ts
+/**
+ * The keys for each locales
+ * @inline
+ */
+type LocalesKey = keyof typeof locales;
+/**
+ * Map the currency to the locale
+ */
+declare const locales: {
+  readonly eur: "fr-FR";
+  readonly usd: "en-US";
+  readonly gbp: "en-GB";
+};
+//#endregion
+//#region src/utils/backendUrl.d.ts
+/**
+ * Get the backend URL for API calls
+ * Tries to derive from SDK config, falls back to production
+ *
+ * @param walletUrl - Optional wallet URL to derive from (overrides global config)
+ */
+declare function getBackendUrl(walletUrl?: string): string;
+//#endregion
+//#region src/utils/clientId.d.ts
+/**
+ * Client ID utilities for anonymous tracking
+ * Generates and persists a UUID fingerprint for referral attribution
+ */
+/**
+ * Get the client ID from localStorage, creating one if it doesn't exist
+ * @returns The client ID (UUID format)
+ */
+declare function getClientId(): string;
+//#endregion
+//#region src/utils/compression/b64.d.ts
+/**
+ * Encode a buffer to a base64url encoded string
+ * @param buffer The buffer to encode
+ * @returns The encoded string
+ */
+declare function base64urlEncode(buffer: Uint8Array): string;
+/**
+ * Decode a base64url encoded string
+ * @param value The value to decode
+ * @returns The decoded value
+ */
+declare function base64urlDecode(value: string): Uint8Array;
+//#endregion
+//#region src/utils/compression/compress.d.ts
+/**
+ * Compress json data
+ * @param data
+ * @ignore
+ */
+declare function compressJsonToB64(data: unknown): string;
+//#endregion
+//#region src/utils/compression/decompress.d.ts
+/**
+ * Decompress json data
+ * @param data
+ * @ignore
+ */
+declare function decompressJsonFromB64<T>(data: string): T | null;
+//#endregion
+//#region src/utils/constants.d.ts
+/**
+ * Deep link scheme for Frak Wallet mobile app
+ */
+declare const DEEP_LINK_SCHEME = "frakwallet://";
+//#endregion
+//#region src/utils/deepLinkWithFallback.d.ts
+/**
+ * Options for deep link with fallback
+ */
+type DeepLinkFallbackOptions = {
+  /** Timeout in ms before triggering fallback (default: 2500ms) */timeout?: number; /** Callback invoked when fallback is triggered (app not installed) */
+  onFallback?: () => void;
+};
+/**
+ * Check if running on a Chromium-based Android browser.
+ *
+ * On Chrome Android, custom scheme deep links (e.g. frakwallet://) trigger
+ * a confirmation bar ("Continue to Frak Wallet?"). Using intent:// URLs
+ * instead bypasses this for Chromium browsers while keeping custom scheme
+ * fallback for non-Chromium browsers (e.g. Firefox) where it works fine.
+ */
+declare function isChromiumAndroid(): boolean;
+/**
+ * Convert a frakwallet:// deep link to an Android intent:// URL.
+ *
+ * Intent URLs let Chromium browsers open the app directly without
+ * showing the "Continue to app?" confirmation bar.
+ *
+ * Note: We intentionally omit the `package` parameter. Including it
+ * causes Chrome to redirect to the Play Store when the app is not
+ * installed, which breaks the visibility-based fallback detection.
+ * Without `package`, Chrome simply does nothing when the app is
+ * missing, allowing the fallback mechanism to fire correctly.
+ *
+ * Format: intent://path#Intent;scheme=frakwallet;end
+ */
+declare function toAndroidIntentUrl(deepLink: string): string;
+/**
+ * Trigger a deep link with visibility-based fallback detection.
+ *
+ * Uses the Page Visibility API to detect if the app opened (page goes hidden).
+ * If the page remains visible after the timeout, assumes app is not installed
+ * and invokes the onFallback callback.
+ *
+ * On Chromium Android, converts custom scheme to intent:// URL to avoid
+ * the "Continue to app?" confirmation bar.
+ *
+ * @param deepLink - The deep link URL to trigger (e.g., "frakwallet://wallet")
+ * @param options - Optional configuration (timeout, onFallback callback)
+ */
+declare function triggerDeepLinkWithFallback(deepLink: string, options?: DeepLinkFallbackOptions): void;
+/**
+ * Check if a URL is a Frak deep link
+ */
+declare function isFrakDeepLink(url: string): boolean;
+//#endregion
+//#region src/utils/FrakContext.d.ts
+/**
+ * Compress the current Frak context
+ * @param context - The context to be compressed
+ * @returns A compressed string containing the Frak context
+ */
+declare function compress(context?: Partial<FrakContext>): string | undefined;
+/**
+ * Decompress the given Frak context
+ * @param context - The raw context to be decompressed into a `FrakContext`
+ * @returns The decompressed Frak context, or undefined if it fails
+ */
+declare function decompress(context?: string): FrakContext | undefined;
+/**
+ * Parse the current URL into a Frak Context
+ * @param args
+ * @param args.url - The url to parse
+ * @returns The parsed Frak context
+ */
+declare function parse({
+  url
+}: {
+  url: string;
+}): FrakContext | null | undefined;
+/**
+ * Populate the current url with the given Frak context
+ * @param args
+ * @param args.url - The url to update
+ * @param args.context - The context to update
+ * @returns The new url with the Frak context
+ */
+declare function update({
+  url,
+  context
+}: {
+  url?: string;
+  context: Partial<FrakContext>;
+}): string | null;
+/**
+ * Remove Frak context from current url
+ * @param url - The url to update
+ * @returns The new url without the Frak context
+ */
+declare function remove(url: string): string;
+/**
+ * Replace the current url with the given Frak context
+ * @param args
+ * @param args.url - The url to update
+ * @param args.context - The context to update
+ */
+declare function replaceUrl({
+  url: baseUrl,
+  context
+}: {
+  url?: string;
+  context: Partial<FrakContext> | null;
+}): void;
+/**
+ * Export our frak context
+ */
+declare const FrakContextManager: {
+  compress: typeof compress;
+  decompress: typeof decompress;
+  parse: typeof parse;
+  update: typeof update;
+  remove: typeof remove;
+  replaceUrl: typeof replaceUrl;
+};
+//#endregion
+//#region src/utils/formatAmount.d.ts
+/**
+ * Format a numeric amount as a localized currency string
+ * @param amount - The raw numeric amount to format
+ * @param currency - Optional currency config; defaults to EUR/fr-FR when omitted
+ * @returns Localized currency string (e.g. "1 500 €", "$1,500")
+ */
+declare function formatAmount(amount: number, currency?: Currency): string;
+//#endregion
+//#region src/utils/getCurrencyAmountKey.d.ts
+/**
+ * Get the currency amount key for a given currency
+ * @param currency - The currency to use
+ * @returns The currency amount key
+ */
+declare function getCurrencyAmountKey(currency?: Currency): keyof TokenAmountType;
+//#endregion
+//#region src/utils/getSupportedCurrency.d.ts
+/**
+ * Get the supported currency for a given currency
+ * @param currency - The currency to use
+ * @returns The supported currency
+ */
+declare function getSupportedCurrency(currency?: Currency): Currency;
+//#endregion
+//#region src/utils/getSupportedLocale.d.ts
+/**
+ * Get the supported locale for a given currency
+ * @param currency - The currency to use
+ * @returns The supported locale
+ */
+declare function getSupportedLocale(currency?: Currency): (typeof locales)[LocalesKey];
+//#endregion
+//#region src/utils/iframeHelper.d.ts
+/**
+ * Base props for the iframe
+ * @ignore
+ */
+declare const baseIframeProps: {
+  id: string;
+  name: string;
+  title: string;
+  allow: string;
+  style: {
+    width: string;
+    height: string;
+    border: string;
+    position: string;
+    zIndex: number;
+    top: string;
+    left: string;
+    colorScheme: string;
+  };
+};
+/**
+ * Create the Frak iframe
+ * @param args
+ * @param args.walletBaseUrl - Use `config.walletUrl` instead. Will be removed in future versions.
+ * @param args.config - The configuration object containing iframe options, including the replacement for `walletBaseUrl`.
+ */
+declare function createIframe({
+  walletBaseUrl,
+  config
+}: {
+  walletBaseUrl?: string;
+  config?: FrakWalletSdkConfig;
+}): Promise<HTMLIFrameElement | undefined>;
+/**
+ * Find an iframe within window.opener by pathname
+ *
+ * When a popup is opened via window.open from an iframe, window.opener points to
+ * the parent window, not the iframe itself. This utility searches through all frames
+ * in window.opener to find an iframe matching the specified pathname.
+ *
+ * @param pathname - The pathname to search for (default: "/listener")
+ * @returns The matching iframe window, or null if not found
+ *
+ * @example
+ * ```typescript
+ * // Find the default /listener iframe
+ * const listenerIframe = findIframeInOpener();
+ *
+ * // Find a custom iframe
+ * const customIframe = findIframeInOpener("/my-custom-iframe");
+ * ```
+ */
+declare function findIframeInOpener(pathname?: string): Window | null;
+//#endregion
+//#region src/utils/merchantId.d.ts
+/**
+ * Merchant ID utilities for auto-fetching from backend
+ */
+/**
+ * Fetch merchantId from backend by domain
+ *
+ * @param domain - The domain to lookup (defaults to current hostname)
+ * @param walletUrl - Optional wallet URL to derive backend URL
+ * @returns The merchantId if found, undefined otherwise
+ *
+ * @example
+ * ```ts
+ * const merchantId = await fetchMerchantId("shop.example.com");
+ * if (merchantId) {
+ *     // Use merchantId for tracking
+ * }
+ * ```
+ */
+declare function fetchMerchantId(domain?: string, walletUrl?: string): Promise<string | undefined>;
+/**
+ * Clear the cached merchantId
+ * Useful for testing or when switching domains
+ */
+declare function clearMerchantIdCache(): void;
+/**
+ * Get merchantId from config or auto-fetch from backend
+ *
+ * @param config - The SDK config that may contain merchantId
+ * @param walletUrl - Optional wallet URL to derive backend URL
+ * @returns The merchantId if available (from config or fetch), undefined otherwise
+ */
+declare function resolveMerchantId(config: {
+  metadata?: {
+    merchantId?: string;
+  };
+}, walletUrl?: string): Promise<string | undefined>;
+//#endregion
+//#region src/utils/sso.d.ts
+type AppSpecificSsoMetadata = SsoMetadata & {
+  name: string;
+  css?: string;
+};
+/**
+ * The full SSO params that will be used for compression
+ */
+type FullSsoParams = Omit<PrepareSsoParamsType, "metadata"> & {
+  metadata: AppSpecificSsoMetadata;
+  merchantId: string;
+  clientId: string;
+};
+/**
+ * Generate SSO URL with compressed parameters
+ * This mirrors the wallet's getOpenSsoLink() function
+ *
+ * @param walletUrl - Base wallet URL (e.g., "https://wallet.frak.id")
+ * @param params - SSO parameters
+ * @param merchantId - Merchant identifier
+ * @param name - Application name
+ * @param clientId - Client identifier for identity tracking
+ * @param css - Optional custom CSS
+ * @returns Complete SSO URL ready to open in popup or redirect
+ *
+ * @example
+ * ```ts
+ * const ssoUrl = generateSsoUrl(
+ *   "https://wallet.frak.id",
+ *   { metadata: { logoUrl: "..." }, directExit: true },
+ *   "0x123...",
+ *   "My App"
+ * );
+ * // Returns: https://wallet.frak.id/sso?p=<compressed_base64>
+ * ```
+ */
+declare function generateSsoUrl(walletUrl: string, params: PrepareSsoParamsType, merchantId: string, name: string, clientId: string, css?: string): string;
+/**
+ * Type of compressed the sso data
+ */
+type CompressedSsoData = {
+  id?: Hex;
+  cId: string;
+  r?: string;
+  d?: boolean;
+  l?: "en" | "fr";
+  m: string;
+  md: {
+    n: string;
+    css?: string;
+    l?: string;
+    h?: string;
+  };
+};
+//#endregion
+//#region src/utils/trackEvent.d.ts
+/**
+ * Analytics event names emitted by the SDK
+ */
+type FrakEvent = "share_button_clicked" | "wallet_button_clicked" | "open_in_app_clicked" | "open_in_app_login_clicked" | "app_not_installed" | "share_modal_error" | "user_referred_started" | "user_referred_completed" | "user_referred_error";
+type EventProps = Record<string, unknown>;
+/**
+ * Track an analytics event via OpenPanel.
+ * Fire-and-forget: silently catches errors.
+ * @param client - The Frak client instance (no-op if undefined)
+ * @param event - The event name to track
+ * @param props - Optional event properties
+ */
+declare function trackEvent(client: FrakClient | undefined, event: FrakEvent, props?: EventProps): void;
+//#endregion
+//#region src/utils/computeLegacyProductId.d.ts
+/**
+ * Compute the legacy product id from a domain
+ * @ignore
+ */
+declare function computeLegacyProductId({
+  domain
+}?: {
+  domain?: string;
+}): `0x${string}`;
+//#endregion
+export { getBackendUrl as A, HashProtectedData as B, triggerDeepLinkWithFallback as C, base64urlDecode as D, compressJsonToB64 as E, createIFrameFrakClient as F, TrackArrivalParams as I, TrackArrivalResult as L, locales as M, setupClient as N, base64urlEncode as O, DebugInfoGatherer as P, UtmParams as R, toAndroidIntentUrl as S, decompressJsonFromB64 as T, KeyProvider as V, formatAmount as _, CompressedSsoData as a, isChromiumAndroid as b, clearMerchantIdCache as c, baseIframeProps as d, createIframe as f, getCurrencyAmountKey as g, getSupportedCurrency as h, AppSpecificSsoMetadata as i, LocalesKey as j, getClientId as k, fetchMerchantId as l, getSupportedLocale as m, FrakEvent as n, FullSsoParams as o, findIframeInOpener as p, trackEvent as r, generateSsoUrl as s, computeLegacyProductId as t, resolveMerchantId as u, FrakContextManager as v, DEEP_LINK_SCHEME as w, isFrakDeepLink as x, DeepLinkFallbackOptions as y, CompressedData as z };