@human.tech/waap-sdk 2.0.0 → 2.1.0-staging-fb27bb

package/dist/initializerContext-0oKHzvQG.d.ts

@@ -0,0 +1,21 @@
+import { M as WaaPSessionProtection, b as CustomConfig, x as ProjectConfig } from "./types-DexmJNke.js";
+import { EventEmitter } from "events";
+//#region src/lib/UIMessageManager.d.ts
+declare enum UI_EVENT_NAMES {
+  show_modal = "show_modal",
+  hide_modal = "hide_modal"
+}
+declare class UIMessageManager extends EventEmitter {
+  constructor();
+}
+//#endregion
+//#region src/lib/initializerContext.d.ts
+type WaaPInitializerOptions = {
+  referralCode?: string;
+  project?: ProjectConfig;
+  config?: CustomConfig;
+  chains?: readonly ('evm' | 'sui' | 'solana')[];
+  sessionProtection?: WaaPSessionProtection;
+};
+//#endregion
+export { UIMessageManager as n, UI_EVENT_NAMES as r, WaaPInitializerOptions as t };

package/dist/initializerContext-C39PUnGi.d.mts

@@ -0,0 +1,21 @@
+import { M as WaaPSessionProtection, b as CustomConfig, x as ProjectConfig } from "./types-DexmJNke.mjs";
+import { EventEmitter } from "events";
+//#region src/lib/UIMessageManager.d.ts
+declare enum UI_EVENT_NAMES {
+  show_modal = "show_modal",
+  hide_modal = "hide_modal"
+}
+declare class UIMessageManager extends EventEmitter {
+  constructor();
+}
+//#endregion
+//#region src/lib/initializerContext.d.ts
+type WaaPInitializerOptions = {
+  referralCode?: string;
+  project?: ProjectConfig;
+  config?: CustomConfig;
+  chains?: readonly ('evm' | 'sui' | 'solana')[];
+  sessionProtection?: WaaPSessionProtection;
+};
+//#endregion
+export { UIMessageManager as n, UI_EVENT_NAMES as r, WaaPInitializerOptions as t };

package/dist/react.d.mts

@@ -0,0 +1,2 @@
+import { a as useWaapTransaction, i as UseWaapTransactionReturn, n as TxState, r as UseWaapTransactionOptions, t as useWaapAuth } from "./useWaapAuth-C5I7QqyW.mjs";
+export { type TxState, type UseWaapTransactionOptions, type UseWaapTransactionReturn, useWaapAuth, useWaapTransaction };

package/dist/react.d.ts

@@ -0,0 +1,2 @@
+import { a as useWaapTransaction, i as UseWaapTransactionReturn, n as TxState, r as UseWaapTransactionOptions, t as useWaapAuth } from "./useWaapAuth-BrqAhAn2.js";
+export { type TxState, type UseWaapTransactionOptions, type UseWaapTransactionReturn, useWaapAuth, useWaapTransaction };

package/dist/react.js

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./useWaapAuth-Z_ONicYr.js");exports.useWaapAuth=e.t,exports.useWaapTransaction=e.n;

package/dist/react.mjs

@@ -0,0 +1 @@
+import{n as e,t}from"./useWaapAuth-DHIeb4yc.mjs";export{t as useWaapAuth,e as useWaapTransaction};

package/dist/register-4Afr2Jx8.js

@@ -0,0 +1 @@
+const e=require("./ui-16QpbEyG.js");let t=require("@mysten/wallet-standard");function n(n,r={}){let i=new e.c(n,r);return(0,t.registerWallet)(i),i}Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return n}});

package/dist/register-CBlzg5ln.d.ts

@@ -0,0 +1,107 @@
+import { C as RequestPermissionTokenResult, S as RequestPermissionTokenParams, a as PermissionTokenQuery, d as WaaPAccountStatus, i as PermissionTokenClearResult, o as PermissionTokenStatus, p as WaaPSessionExtension, r as LoginResponse, u as WaaPAccountMode } from "./types-DexmJNke.js";
+import { A as SolanaSignTransactionInput, B as WaaPSolanaWalletFeatures, C as SolanaChain, D as SolanaSignAndSendTransactionOutput, E as SolanaSignAndSendTransactionInput, O as SolanaSignMessageInput, R as SolanaWalletEventListener, S as SolanaAccount, T as SolanaConnectOutput, j as SolanaSignTransactionOutput, k as SolanaSignMessageOutput, w as SolanaConnectInput, x as InitWaaPSolanaOptions, z as WaaPSolanaProviderInterface } from "./index-CMSufeMa.js";
+import { n as UIMessageManager, t as WaaPInitializerOptions } from "./initializerContext-0oKHzvQG.js";
+//#region src/lib/solana/SolanaProvider.d.ts
+declare class WaaPSolanaProvider implements WaaPSolanaProviderInterface {
+  /**
+   * Last conversion state the wallet actually reported. The synchronous status
+   * accessor cannot await the iframe, and previously answered `complete` for any
+   * logged-in user — a definite claim it had no basis for. `pending` here means
+   * "not yet resolved", which is the truth until `getCanonicalAccountStatus`
+   * runs.
+   */
+  private lastKnownConversion;
+  readonly name = "WaaP";
+  readonly version = "1.0.0";
+  readonly icon = "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA2NCA2NCI+PHJlY3Qgd2lkdGg9IjY0IiBoZWlnaHQ9IjY0IiByeD0iMTYiIGZpbGw9IiMxMTE4MmMiLz48cGF0aCBkPSJNMTYgNDhoMzJMMzIgMTZ6IiBmaWxsPSIjN2NkNGZmIi8+PC9zdmc+";
+  private _accounts;
+  private accountMode;
+  private loginMethod;
+  private _chains;
+  private walletMessageManager;
+  private uiMessageManager;
+  private internalEventEmitter;
+  private changeListeners;
+  private ensureIframe?;
+  private iframeMounted;
+  private initializerOptions;
+  private initializerPromise;
+  private initializedIframeWindow;
+  constructor(iframeWindow: Window | null, options?: InitWaaPSolanaOptions, ensureIframe?: () => Window | null, initializerOptions?: WaaPInitializerOptions);
+  /** Release listeners owned by this Solana facade. */
+  destroy(): void;
+  private ensureIframeMounted;
+  /** Warm the iframe after the host app's LCP without opening wallet UI. */
+  preload(): Promise<void>;
+  private ensureInitialized;
+  get chains(): readonly SolanaChain[];
+  get accounts(): readonly SolanaAccount[];
+  /**
+   * Solana Wallet Standard capabilities. The standard methods are variadic;
+   * WaaP handles them sequentially so each request retains its own approval
+   * and iframe interaction rather than racing multiple approval dialogs.
+   */
+  get features(): WaaPSolanaWalletFeatures;
+  get ui(): UIMessageManager;
+  getAccountStatus(): WaaPAccountStatus;
+  get session(): WaaPSessionExtension;
+  getCanonicalAccountStatus(): Promise<WaaPAccountStatus>;
+  /** @internal Initializers set this once; applications select a mode by initializer. */
+  setAccountMode(mode: WaaPAccountMode): void;
+  /** @internal Tell the iframe which initializer family owns this facade. */
+  selectAccountMode(mode: WaaPAccountMode, options?: WaaPInitializerOptions): Promise<void>;
+  /** @internal Shared multichain initializers propagate their EVM login here. */
+  setLoginMethod(loginMethod: LoginResponse): void;
+  getLoginMethod(): LoginResponse;
+  login(): Promise<LoginResponse>;
+  logout(): Promise<void>;
+  private refreshAccounts;
+  /**
+   * The iframe posts publicKey as a number[] (postMessage can't carry a
+   * Uint8Array reliably across all bridges). Normalize back to Uint8Array.
+   */
+  private normalizeAccounts;
+  connect(input?: SolanaConnectInput): Promise<SolanaConnectOutput>;
+  /** Read an existing iframe session without opening the wallet modal. */
+  private restoreSession;
+  /** Keep the local Wallet Standard facade aligned with the iframe session. */
+  private syncLoginMethodFromCanonicalStatus;
+  disconnect(): Promise<void>;
+  signMessage(input: SolanaSignMessageInput): Promise<SolanaSignMessageOutput>;
+  signTransaction(input: SolanaSignTransactionInput): Promise<SolanaSignTransactionOutput>;
+  signAndSendTransaction(input: SolanaSignAndSendTransactionInput): Promise<SolanaSignAndSendTransactionOutput>;
+  private signStandardMessages;
+  private signStandardTransactions;
+  private signAndSendStandardTransactions;
+  private asSupportedChain;
+  private broadcastOptions;
+  requestPermissionToken(params: RequestPermissionTokenParams): Promise<RequestPermissionTokenResult>;
+  getPermissionTokenStatus(query: PermissionTokenQuery): Promise<PermissionTokenStatus>;
+  clearPermissionToken(query: PermissionTokenQuery): Promise<PermissionTokenClearResult>;
+  /**
+   * Accept either raw bytes or a `@solana/web3.js` (Versioned)Transaction with
+   * a `.serialize()` method. Object serialization runs in the dApp context
+   * where the tx library is available.
+   */
+  private resolveTransactionBytes;
+  on(event: 'change', listener: SolanaWalletEventListener): () => void;
+  on(event: string, listener: (...args: any[]) => void): () => void;
+  /**
+   * Remove a previously registered `connect` / `accountsChanged` listener.
+   * (`change` listeners are removed via the unsubscribe fn returned by `on`.)
+   */
+  removeListener(event: string, listener: (...args: any[]) => void): void;
+  private postRequestAndWait;
+  private notifyChange;
+}
+//#endregion
+//#region src/lib/solana/register.d.ts
+/**
+ * Register a WaaP Solana Wallet Standard instance for discovery by compatible
+ * dapps. `initWaaP({ chain: 'solana' })` is the recommended
+ * standalone initializer; use this
+ * explicit form when the host application owns Wallet Standard discovery.
+ */
+declare function registerWaaPSolanaWallet(iframeWindow: Window, options?: InitWaaPSolanaOptions): WaaPSolanaProviderInterface;
+//#endregion
+export { WaaPSolanaProvider as n, registerWaaPSolanaWallet as t };

package/dist/register-CNgjA0yl.mjs

@@ -0,0 +1 @@
+import{s as e}from"./ui-BAYRtDQg.mjs";import{registerWallet as t}from"@wallet-standard/wallet";function n(n,r={}){let i=new e(n,r);return i.setAccountMode(`tap`),i.selectAccountMode(`tap`).catch(()=>void 0),t(i),i}export{n as t};

package/dist/register-CxsUwgKJ.d.ts

@@ -0,0 +1,282 @@
+import { C as RequestPermissionTokenResult, S as RequestPermissionTokenParams, a as PermissionTokenQuery, d as WaaPAccountStatus, i as PermissionTokenClearResult, o as PermissionTokenStatus, p as WaaPSessionExtension, r as LoginResponse, u as WaaPAccountMode } from "./types-DexmJNke.js";
+import { $ as SuiSignTransactionBlockOutput, G as SuiConnectOutput, H as SuiAccount, J as SuiSignAndExecuteTransactionInput, K as SuiSignAndExecuteTransactionBlockInput, Q as SuiSignTransactionBlockInput, U as SuiChain, V as InitWaaPSuiOptions, W as SuiConnectInput, X as SuiSignPersonalMessageInput, Y as SuiSignAndExecuteTransactionOutput, Z as SuiSignPersonalMessageOutput, at as WaaPSuiWalletInterface, ot as WalletIcon, q as SuiSignAndExecuteTransactionBlockOutput, rt as SuiWalletEventListener } from "./index-CMSufeMa.js";
+import { n as UIMessageManager, t as WaaPInitializerOptions } from "./initializerContext-0oKHzvQG.js";
+//#region src/lib/sui/SuiWallet.d.ts
+/**
+ * WaaP Sui Wallet implementation.
+ *
+ * Implements the Sui Wallet Standard to allow dApps to:
+ * - Connect/disconnect
+ * - Sign personal messages
+ * - (Future) Sign and execute transactions
+ */
+declare class WaaPSuiWallet implements WaaPSuiWalletInterface {
+  /**
+   * Last conversion state the wallet actually reported. The synchronous status
+   * accessor cannot await the iframe, and previously answered `complete` for any
+   * logged-in user — a definite claim it had no basis for. `pending` here means
+   * "not yet resolved", which is the truth until `getCanonicalAccountStatus`
+   * runs.
+   */
+  private lastKnownConversion;
+  readonly name = "WaaP";
+  readonly version = "1.0.0";
+  readonly icon: WalletIcon;
+  private _accounts;
+  private accountMode;
+  private loginMethod;
+  private _chains;
+  private walletMessageManager;
+  private uiMessageManager;
+  private internalEventEmitter;
+  private changeListeners;
+  private ensureIframe?;
+  private iframeMounted;
+  private initializerOptions;
+  private initializerPromise;
+  private initializedIframeWindow;
+  /**
+   * Creates a new WaaPSuiWallet instance.
+   *
+   * @param iframeWindow - The contentWindow of the WaaP iframe
+   * @param options - Initialization options
+   */
+  constructor(iframeWindow: Window | null, options?: InitWaaPSuiOptions, ensureIframe?: () => Window | null, initializerOptions?: WaaPInitializerOptions);
+  /** Release listeners owned by this Sui facade. */
+  destroy(): void;
+  private ensureIframeMounted;
+  /** Warm the iframe after the host app's LCP without opening wallet UI. */
+  preload(): Promise<void>;
+  private ensureInitialized;
+  /**
+   * Refresh accounts by making a silent connect request.
+   * Used internally when account changes are detected.
+   */
+  private refreshAccounts;
+  /**
+   * Supported chains.
+   */
+  get chains(): readonly SuiChain[];
+  /**
+   * Connected accounts.
+   */
+  get accounts(): readonly SuiAccount[];
+  /**
+   * UI message manager for showing/hiding modal.
+   */
+  get ui(): UIMessageManager;
+  getAccountStatus(): WaaPAccountStatus;
+  get session(): WaaPSessionExtension;
+  getCanonicalAccountStatus(): Promise<WaaPAccountStatus>;
+  /** @internal Initializers set this once; applications select a mode by initializer. */
+  setAccountMode(mode: WaaPAccountMode): void;
+  /** @internal Tell the iframe which initializer family owns this facade. */
+  selectAccountMode(mode: WaaPAccountMode, options?: WaaPInitializerOptions): Promise<void>;
+  /** @internal Shared multichain initializers propagate their EVM login here. */
+  setLoginMethod(loginMethod: LoginResponse): void;
+  getLoginMethod(): LoginResponse;
+  login(): Promise<LoginResponse>;
+  logout(): Promise<void>;
+  /**
+   * Connect to the wallet.
+   */
+  connect(input?: SuiConnectInput): Promise<SuiConnectOutput>;
+  /** Read an existing iframe session without opening the wallet modal. */
+  private restoreSession;
+  /** Keep the local Wallet Standard facade aligned with the iframe session. */
+  private syncLoginMethodFromCanonicalStatus;
+  /**
+   * Disconnect from the wallet.
+   */
+  disconnect(): Promise<void>;
+  /**
+   * Sign a personal message.
+   *
+   * @param input - Sign personal message input
+   * @returns Signed message result with bytes and signature
+   */
+  signPersonalMessage(input: SuiSignPersonalMessageInput): Promise<SuiSignPersonalMessageOutput>;
+  /**
+   * Extract the destination addresses from BCS-serialized Sui transaction bytes.
+   *
+   * Unlike EVM transactions where `to` is a top-level field, Sui transaction
+   * destinations are embedded in BCS-encoded programmable transaction blocks.
+   * We deserialize with Transaction.from() and inspect TransferObjects commands.
+   *
+   * Only TransferObjects destinations are extracted — MoveCall package addresses
+   * are not user-facing recipients and should not be validated against a PT's
+   * allowedAddresses list.
+   *
+   * Returns an empty array if no TransferObjects are found or deserialization fails.
+   */
+  private extractTransferAddresses;
+  /**
+   * Helper to resolve transaction bytes from various input formats.
+   * If the input is a Transaction/TransactionBlock object, it builds it.
+   */
+  private resolveTransactionBytes;
+  /**
+   * Sign a transaction.
+   *
+   * @param input - Sign transaction input with transaction
+   * @returns Signed transaction result with bytes and signature
+   */
+  signTransaction(input: {
+    transaction: unknown;
+    account: SuiAccount;
+    chain?: SuiChain;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+  }): Promise<{
+    bytes: string;
+    signature: string;
+  }>;
+  /**
+   * Sign and execute a transaction.
+   *
+   * @param input - Sign and execute transaction input
+   */
+  signAndExecuteTransaction(input: SuiSignAndExecuteTransactionInput): Promise<SuiSignAndExecuteTransactionOutput>;
+  /**
+   * Switch the active chain.
+   */
+  switchChain(input: {
+    chain: SuiChain;
+  }): Promise<void>;
+  /**
+   * Subscribe to wallet change events.
+   *
+   * Supports the Wallet-Standard `change` event, plus EVM-style `connect` /
+   * `accountsChanged` events so cross-chain hooks (e.g. `useWaapAuth`) can
+   * subscribe to any facade uniformly.
+   *
+   * @param event - `'change'` | `'connect'` | `'accountsChanged'`
+   * @param listener - Event listener callback
+   * @returns Unsubscribe function
+   */
+  on(event: 'change', listener: SuiWalletEventListener): () => void;
+  on(event: string, listener: (...args: any[]) => void): () => void;
+  /**
+   * Remove a previously registered `connect` / `accountsChanged` listener.
+   * (`change` listeners are removed via the unsubscribe fn returned by `on`.)
+   */
+  removeListener(event: string, listener: (...args: any[]) => void): void;
+  /**
+   * Wallet Standard features property.
+   * Required by @mysten/wallet-standard registerWallet.
+   */
+  get features(): {
+    readonly 'standard:connect': {
+      readonly version: "1.0.0";
+      readonly connect: (input?: SuiConnectInput) => Promise<SuiConnectOutput>;
+    };
+    readonly 'standard:disconnect': {
+      readonly version: "1.0.0";
+      readonly disconnect: () => Promise<void>;
+    };
+    readonly 'standard:events': {
+      readonly version: "1.0.0";
+      readonly on: {
+        (event: "change", listener: SuiWalletEventListener): () => void;
+        (event: string, listener: (...args: any[]) => void): () => void;
+      };
+    };
+    readonly 'sui:signPersonalMessage': {
+      readonly version: "1.1.0";
+      readonly signPersonalMessage: (input: SuiSignPersonalMessageInput) => Promise<SuiSignPersonalMessageOutput>;
+    };
+    readonly 'sui:signTransaction': {
+      readonly version: "2.0.0";
+      readonly signTransaction: (input: {
+        transaction: unknown;
+        account: SuiAccount;
+        chain?: SuiChain;
+        signal?: AbortSignal;
+        timeoutMs?: number;
+      }) => Promise<{
+        bytes: string;
+        signature: string;
+      }>;
+    };
+    readonly 'sui:signAndExecuteTransaction': {
+      readonly version: "1.0.0";
+      readonly signAndExecuteTransaction: (input: SuiSignAndExecuteTransactionInput) => Promise<SuiSignAndExecuteTransactionOutput>;
+    };
+    readonly 'sui:signTransactionBlock': {
+      readonly version: "2.0.0";
+      readonly signTransactionBlock: (input: SuiSignTransactionBlockInput) => Promise<SuiSignTransactionBlockOutput>;
+    };
+    readonly 'sui:signAndExecuteTransactionBlock': {
+      readonly version: "1.0.0";
+      readonly signAndExecuteTransactionBlock: (input: SuiSignAndExecuteTransactionBlockInput) => Promise<SuiSignAndExecuteTransactionBlockOutput>;
+    };
+    readonly 'sui:switchChain': {
+      readonly version: "1.0.0";
+      readonly switchChain: (input: {
+        chain: SuiChain;
+      }) => Promise<void>;
+    };
+  };
+  /**
+   * Legacy method for signing a transaction block.
+   * Maps to signTransaction.
+   */
+  signTransactionBlock(input: SuiSignTransactionBlockInput): Promise<SuiSignTransactionBlockOutput>;
+  /**
+   * Legacy method for signing and executing a transaction block.
+   * Maps to signAndExecuteTransaction.
+   */
+  signAndExecuteTransactionBlock(input: SuiSignAndExecuteTransactionBlockInput): Promise<SuiSignAndExecuteTransactionBlockOutput>;
+  /**
+   * Request a Permission Token from the user.
+   * Allows pre-authorised batches of Sui transactions without individual confirmations.
+   *
+   * @param params - Allowed addresses, chainId (e.g. "sui:mainnet"), spend limit, expiry
+   */
+  requestPermissionToken(params: RequestPermissionTokenParams): Promise<RequestPermissionTokenResult>;
+  getPermissionTokenStatus(query: PermissionTokenQuery): Promise<PermissionTokenStatus>;
+  clearPermissionToken(query: PermissionTokenQuery): Promise<PermissionTokenClearResult>;
+  /**
+   * Request the user's email address.
+   *
+   * @returns Promise resolving to the user's email address
+   */
+  requestEmail(): Promise<string>;
+  /**
+   * Post a request to the iframe and wait for response.
+   */
+  private postRequestAndWait;
+  /**
+   * Notify all change listeners.
+   */
+  private notifyChange;
+}
+//#endregion
+//#region src/lib/sui/register.d.ts
+/**
+ * Register WaaP Sui Wallet with the Wallet Standard.
+ *
+ * This makes the wallet discoverable by dApps using @mysten/dapp-kit.
+ * The wallet will appear in the wallet selection UI of any dApp
+ * that uses the Sui Wallet Standard.
+ *
+ * @param iframeWindow - The contentWindow of the WaaP iframe
+ * @param options - Initialization options
+ * @returns The registered WaaPSuiWallet instance
+ *
+ * @example
+ * ```typescript
+ * import { registerWaaPSuiWallet } from '@human.tech/waap-sdk'
+ *
+ * // Get the iframe element
+ * const iframe = document.getElementById('waap-wallet-iframe') as HTMLIFrameElement
+ *
+ * // Register the wallet (makes it discoverable by dApps)
+ * const wallet = registerWaaPSuiWallet(iframe.contentWindow!, { useStaging: false })
+ *
+ * // The wallet is now available in dapp-kit's wallet list
+ * ```
+ */
+declare function registerWaaPSuiWallet(iframeWindow: Window, options?: InitWaaPSuiOptions): WaaPSuiWalletInterface;
+//#endregion
+export { WaaPSuiWallet as n, registerWaaPSuiWallet as t };

package/dist/register-DIZnKDHF.mjs

@@ -0,0 +1 @@
+import{c as e}from"./ui-BAYRtDQg.mjs";import{registerWallet as t}from"@mysten/wallet-standard";function n(n,r={}){let i=new e(n,r);return t(i),i}export{n as t};