@human.tech/waap-sdk 1.3.0 → 2.0.0

package/dist/lib/WalletMessageManager.d.ts

@@ -1,59 +0,0 @@
-/**
- * WalletMessageManager handles messages between the wallet (in the Silk iframe)
- * and the wallet SDK (in the top frame). It is used by EthereumProvider
- * to communicate with the wallet.
- */
-import { SilkRequest, SilkResponse, SILK_METHOD, SilkNotificationData } from '@human.tech/waap-interface-core';
-type PostSilkRequestArgs = {
-    method: keyof typeof SILK_METHOD;
-    params: any[];
-    interactionRequired: boolean;
-    silkOptions?: {
-        async?: boolean;
-    };
-};
-/**
- * Async transaction notification from iframe
- */
-interface AsyncTxNotification {
-    type: string;
-    payload: any;
-}
-/**
- * Listener interface for WalletMessageManager
- */
-interface MessageListenerConfig {
-    handleResponse: (response: SilkResponse) => void;
-    handleRequest: (request: SilkRequest) => void;
-    onReceiveConnectNotif?: () => void;
-    onAccountChanged?: (newAccount: string) => void;
-    onAsyncTxNotification?: (notification: AsyncTxNotification) => void;
-}
-declare class WalletMessageManager {
-    private iframeWindow;
-    private walletOrigin;
-    constructor(iframeWindow: Window, useStaging: boolean);
-    /**
-     * Post a Silk notification to the given iframeWindow
-     */
-    postSilkNotification(data: SilkNotificationData): void;
-    postReadyNotification(): void;
-    postConnectNotification(): void;
-    /**
-     * Post a 'ready' notification to the iframe, and wait
-     * for the iframe to respond with a 'ready' notification.
-     */
-    pingIframe(): Promise<void>;
-    /**
-     * Post a SilkRequest to the iframeWindow. Don't wait for a response.
-     */
-    postSilkRequest(req: PostSilkRequestArgs): Promise<string>;
-    /**
-     * Add a message listener to the window in which this is called (which should be the top frame).
-     * It handles all messages from the Silk iframe posted to the top frame.
-     * @param config - Configuration that includes callbacks for handling specific messages.
-     */
-    addListener(config: MessageListenerConfig): void;
-}
-export { WalletMessageManager, PostSilkRequestArgs };
-export default WalletMessageManager;

package/dist/lib/provider/EthereumProvider.d.ts

@@ -1,108 +0,0 @@
-/**
- * A Ethereum provder API (from EIP 1193) for Silk.
- * https://eips.ethereum.org/EIPS/eip-1193
- */
-/**
- * Resources:
- * - EIP-2255: Wallet Permissions System: https://eips.ethereum.org/EIPS/eip-2255
- */
-import { EventEmitter } from 'events';
-import { CustomConfig, CredentialType, ProjectConfig, RequestPermissionTokenParams } from '@human.tech/waap-interface-core';
-import { EthereumProviderInterface, LoginResponse, RequestArguments, SilkEthereumProviderInterface } from './types.js';
-import { UIMessageManager } from '../UIMessageManager.js';
-import WalletMessageManager from '../WalletMessageManager.js';
-declare class EthereumProvider extends EventEmitter implements SilkEthereumProviderInterface {
-    readonly isSilk = true;
-    readonly isWaaP = true;
-    connected: boolean;
-    walletMessageManager: WalletMessageManager;
-    uiMessageManager: UIMessageManager;
-    config: CustomConfig;
-    private currentAccount;
-    private walletConnectProvider;
-    /**
-     * When true, eth_sendTransaction resolves with the pre-calculated tx hash
-     * after signing. Broadcasting continues in the background with events.
-     */
-    private asyncTxs;
-    /**
-     * When true, sends `asyncSigning: true` in silkOptions instead of `async: true`.
-     * This mimics the v1 SDK protocol for backward compatibility testing.
-     * @internal
-     */
-    private legacyAsyncSigning;
-    private persistedMethods;
-    /**
-     * We use the internalEventEmitter to emit as events
-     * Silk messages posted to the window.
-     */
-    internalEventEmitter: EventEmitter;
-    /**
-     * @param iframeWindow - The contentWindow of the iframe of the Silk website.
-     * @param referralCode - Silk points referral code
-     * @param customConfig - Silk custom UI configuration
-     * @param project - Silk project configuration
-     * @param useStaging - Whether to use the staging environment
-     * @param asyncTxs - When true, eth_sendTransaction resolves with tx hash after signing
-     * @param legacyAsyncSigning - When true, sends asyncSigning in silkOptions (v1 compat)
-     */
-    constructor(iframeWindow: Window, referralCode?: string, customConfig?: CustomConfig, project?: ProjectConfig, useStaging?: boolean, asyncTxs?: boolean, legacyAsyncSigning?: boolean);
-    private initializeWalletConnect;
-    enable(): Promise<unknown>;
-    isConnected(): boolean;
-    request(args: RequestArguments): Promise<unknown>;
-    login(customProvider?: EthereumProviderInterface): Promise<LoginResponse>;
-    logout(): Promise<unknown>;
-    private cleanupInvalidLoginState;
-    /**
-     * Helper method to set up window.waap for WaaP
-     */
-    private setupWaaP;
-    /**
-     * Helper method to set up window.silk for injected wallets (e.g., MetaMask)
-     */
-    private setupInjectedWallet;
-    /**
-     * Helper method to set up window.silk for WalletConnect
-     */
-    private setupWalletConnect;
-    /**
-     * Helper method to set up window.silk for auto-connect with injected wallets
-     */
-    private setupAutoConnectInjected;
-    /**
-     * Helper method to set up window.silk for auto-connect with WalletConnect
-     */
-    private setupAutoConnectWalletConnect;
-    /**
-     * Attempts to auto-connect using previously stored login method
-     * @param method - The RPC method being called
-     * @returns Promise<unknown> if auto-connect succeeds, null if it should fall through to normal flow
-     */
-    private attemptAutoConnect;
-    getLoginMethod(): LoginResponse;
-    toggleDarkMode(): Promise<void>;
-    safe(): Promise<void>;
-    orcid(): Promise<void>;
-    /**
-     * INTERNAL METHOD: Gas tank administration operations
-     * This method is ONLY accessible from the Dev Portal domain
-     * It's not included in the public typing to hide it from regular dApps
-     */
-    portal(feature: 'gastank' | 'customization' | 'project', operation: 'get' | 'update' | 'topup' | 'init', payload?: any): Promise<unknown>;
-    requestEmail(): Promise<unknown>;
-    /**
-     * Request a Permission Token from the user.
-     * Allows pre-authorized transactions without individual confirmations.
-     * @param params - Permission token parameters (allowed addresses, chain, limits, expiry)
-     * @returns Promise<RequestPermissionTokenResult>
-     */
-    requestPermissionToken(params: RequestPermissionTokenParams): Promise<unknown>;
-    /**
-     * Prompt the user to mint a Zeronym SBT.
-     * @returns string or null - The address of the owner of the SBT, or null
-     * if the user already minted the SBT.
-     */
-    requestSBT(type: CredentialType): Promise<unknown>;
-}
-export { EthereumProvider };

package/dist/lib/provider/EthereumProviderExtension.d.ts

@@ -1,26 +0,0 @@
-/**
- * A Ethereum provder API (from EIP 1193) for Silk.
- * https://eips.ethereum.org/EIPS/eip-1193
- */
-/**
- * Resources:
- * - EIP-2255: Wallet Permissions System: https://eips.ethereum.org/EIPS/eip-2255
- */
-import { CredentialType, CustomConfig } from '@human.tech/waap-interface-core';
-import { EventEmitter } from 'events';
-import { EthereumProviderInterface, RequestArguments } from './types.js';
-declare class EthereumProviderExtension extends EventEmitter implements EthereumProviderInterface {
-    readonly isSilk = true;
-    connected: boolean;
-    config: CustomConfig;
-    constructor(customConfig?: CustomConfig);
-    sendToExtension(args: RequestArguments): Promise<unknown>;
-    request(args: RequestArguments): Promise<unknown>;
-    enable(): Promise<unknown>;
-    isConnected(): boolean;
-    login(): Promise<unknown>;
-    requestSBT(type: CredentialType): Promise<unknown>;
-    toggleDarkMode(): Promise<void>;
-    safe(): Promise<unknown>;
-}
-export { EthereumProviderExtension };

package/dist/lib/provider/requests.d.ts

@@ -1,17 +0,0 @@
-import { EventEmitter } from 'events';
-import { rpcMethodRequiresUI } from '@human.tech/waap-constants';
-import WalletMessageManager from '../WalletMessageManager.js';
-import { RequestArguments } from './types.js';
-/**
- * Options passed to iframe for transaction behavior
- */
-interface SilkOptions {
-    async?: boolean;
-    withPT?: boolean;
-}
-/**
- * Send request to wallet in iframe, and upon receiving the wallet's response
- * or error, hide modal and return wallet's response or throw wallet's error.
- */
-declare function handleWalletRequestAndResponse(args: RequestArguments, interactionRequired: boolean, walletMessageManager: WalletMessageManager, internalProviderEventEmitter: EventEmitter, silkOptions?: SilkOptions): Promise<unknown>;
-export { rpcMethodRequiresUI, handleWalletRequestAndResponse };

package/dist/lib/provider/types.d.ts

@@ -1,49 +0,0 @@
-import { CustomConfig, ProjectConfig, CredentialType, RequestPermissionTokenParams } from '@human.tech/waap-interface-core';
-export type ArrayOneOrMore<T> = {
-    0: T;
-} & Array<T>;
-export interface RequestArguments {
-    method: string;
-    params?: unknown[] | object;
-    async?: boolean;
-    withPT?: boolean;
-}
-export interface EthereumProviderInterface {
-    enable(): Promise<unknown>;
-    isConnected(): boolean;
-    request(args: RequestArguments): Promise<unknown>;
-    on(event: string, listener: (...args: any[]) => void): this;
-    removeListener(event: string, listener: (...args: any[]) => void): this;
-}
-export type LoginResponse = 'waap' | 'human' | 'injected' | 'walletconnect' | null;
-export interface SilkEthereumProviderInterface extends EthereumProviderInterface {
-    isSilk: boolean;
-    connected: boolean;
-    login(customProvider?: any): Promise<LoginResponse>;
-    logout(): Promise<unknown>;
-    getLoginMethod(): LoginResponse;
-    requestEmail(): Promise<unknown>;
-    requestSBT(type: CredentialType): Promise<unknown>;
-    requestPermissionToken(params: RequestPermissionTokenParams): Promise<unknown>;
-    toggleDarkMode(): Promise<void>;
-}
-export interface InitSilkOptions {
-    referralCode?: string;
-    project?: ProjectConfig;
-    config?: CustomConfig;
-    useStaging?: boolean;
-    walletConnectProjectId?: string;
-    /**
-     * When true, eth_sendTransaction resolves with the pre-calculated tx hash
-     * immediately after signing. Broadcasting and confirmation continue in the
-     * background with events (waap_sign_complete, waap_tx_pending, waap_tx_confirmed, waap_tx_failed).
-     * Other signing methods (personal_sign, eth_signTypedData_v4, eth_signTransaction)
-     * are unaffected — they always resolve with the signature directly.
-     * Applies to ALL eth_sendTransaction calls for this SDK instance.
-     * Default: false
-     */
-    asyncTxs?: boolean;
-    /** @deprecated Use `asyncTxs` instead. */
-    asyncSigning?: boolean;
-}
-export type SilkProvider = SilkEthereumProviderInterface;

package/dist/lib/provider/utils.d.ts

@@ -1,4 +0,0 @@
-import { CustomConfig } from '@human.tech/waap-interface-core';
-export declare function isMetaMask(provider: any): boolean;
-export declare function isSafeTransaction(params?: unknown[] | object): boolean;
-export declare const defaultConfig: CustomConfig;

package/dist/lib/sui/SuiWallet.d.ts

@@ -1,203 +0,0 @@
-/**
- * WaaP Sui Wallet - Implements Sui Wallet Standard.
- *
- * This wallet adapter allows dApps using @mysten/dapp-kit to discover
- * and interact with WaaP wallet for Sui blockchain operations.
- *
- * @see https://docs.sui.io/standards/wallet-standard
- */
-import { UIMessageManager } from '../UIMessageManager.js';
-import type { SuiAccount, SuiChain, SuiConnectInput, SuiConnectOutput, SuiSignPersonalMessageInput, SuiSignPersonalMessageOutput, SuiSignAndExecuteTransactionInput, SuiSignAndExecuteTransactionOutput, SuiSignTransactionBlockInput, SuiSignTransactionBlockOutput, SuiSignAndExecuteTransactionBlockInput, SuiSignAndExecuteTransactionBlockOutput, SuiWalletEventListener, WaaPSuiWalletInterface, WalletIcon, InitWaaPSuiOptions } from './types.js';
-/**
- * WaaP Sui Wallet implementation.
- *
- * Implements the Sui Wallet Standard to allow dApps to:
- * - Connect/disconnect
- * - Sign personal messages
- * - (Future) Sign and execute transactions
- */
-export declare class WaaPSuiWallet implements WaaPSuiWalletInterface {
-    readonly name = "WaaP";
-    readonly version = "1.0.0";
-    readonly icon: WalletIcon;
-    private _accounts;
-    private _chains;
-    private walletMessageManager;
-    private uiMessageManager;
-    private internalEventEmitter;
-    private changeListeners;
-    /**
-     * Creates a new WaaPSuiWallet instance.
-     *
-     * @param iframeWindow - The contentWindow of the WaaP iframe
-     * @param options - Initialization options
-     */
-    constructor(iframeWindow: Window, options?: InitWaaPSuiOptions);
-    /**
-     * 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;
-    /**
-     * Connect to the wallet.
-     */
-    connect(input?: SuiConnectInput): Promise<SuiConnectOutput>;
-    /**
-     * 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;
-    }): 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.
-     *
-     * @param event - Event name (currently only 'change')
-     * @param listener - Event listener callback
-     * @returns Unsubscribe function
-     */
-    on(event: 'change', listener: SuiWalletEventListener): () => 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;
-        };
-        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;
-            }) => 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: import('./types.js').RequestPermissionTokenParams): Promise<import('./types.js').RequestPermissionTokenResult>;
-    /**
-     * 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;
-}

package/dist/lib/sui/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Sui Wallet Standard integration for WaaP.
- */
-export { WaaPSuiWallet } from './SuiWallet.js';
-export { initWaaPSui } from './init.js';
-export { registerWaaPSuiWallet } from './register.js';
-export type { SuiAccount, SuiChain, SuiConnectInput, SuiConnectOutput, SuiSignPersonalMessageInput, SuiSignPersonalMessageOutput, SuiSignTransactionInput, SuiSignTransactionOutput, SuiWalletChangeProperties, SuiWalletEventListener, WaaPSuiWalletInterface, WaaPSuiWalletFeatures, InitWaaPSuiOptions, WalletIcon, RequestPermissionTokenParams, RequestPermissionTokenResult } from './types.js';

package/dist/lib/sui/init.d.ts

@@ -1,30 +0,0 @@
-/**
- * Initialization function for WaaP Sui Wallet.
- */
-import type { InitWaaPSuiOptions, WaaPSuiWalletInterface } from './types.js';
-/**
- * Initialize WaaP Sui Wallet.
- *
- * This creates the WaaP iframe (if needed) and returns a SuiWallet instance
- * that implements the Sui Wallet Standard.
- *
- * @param options - Initialization options
- * @returns WaaPSuiWallet instance
- *
- * @example
- * ```typescript
- * import { initWaaPSui } from '@silk-wallet/silk-wallet-sdk'
- *
- * const suiWallet = initWaaPSui()
- *
- * // Connect to get accounts
- * const { accounts } = await suiWallet.connect()
- *
- * // Sign a message
- * const result = await suiWallet.signPersonalMessage({
- *   message: new TextEncoder().encode('Hello, Sui!'),
- *   account: accounts[0]
- * })
- * ```
- */
-export declare function initWaaPSui(options?: InitWaaPSuiOptions): WaaPSuiWalletInterface;

package/dist/lib/sui/register.d.ts

@@ -1,39 +0,0 @@
-/**
- * WaaP Sui Wallet Registration
- *
- * Registers the WaaP Sui wallet with the Wallet Standard registry,
- * making it discoverable by dApps using @mysten/dapp-kit.
- *
- * @see https://docs.sui.io/standards/wallet-standard
- */
-import type { InitWaaPSuiOptions, WaaPSuiWalletInterface } from './types.js';
-/**
- * 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 '@silk-wallet/silk-wallet-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
- * ```
- */
-export declare function registerWaaPSuiWallet(iframeWindow: Window, options?: InitWaaPSuiOptions): WaaPSuiWalletInterface;
-/**
- * Unregister callback type returned by registerWallet.
- * Can be called to remove the wallet from the registry.
- */
-export type UnregisterWallet = () => void;