@openfort/react-native 0.1.21 → 0.1.23

package/dist/types/types/wallet.d.ts

@@ -1,25 +1,105 @@
-import type { ChainTypeEnum } from '@openfort/openfort-js';
+import type { AccountTypeEnum, ChainTypeEnum, EmbeddedAccount, RecoveryParams } from '@openfort/openfort-js';
+import type { Hex } from './hex';
+import type { OpenfortHookOptions } from './hookOption';
+import type { OpenfortError } from './openfortError';
 /**
- * Ethereum wallet provider interface for EIP-1193 compatible operations
+ * JSON-RPC request arguments following EIP-1193 spec
+ */
+export type EIP1193RequestArguments = {
+    readonly method: string;
+    readonly params?: readonly unknown[] | object;
+};
+/**
+ * EIP-1193 event names
+ */
+export type EIP1193EventName = 'accountsChanged' | 'chainChanged' | 'connect' | 'disconnect' | 'message';
+/**
+ * EIP-1193 provider event handler
+ */
+export type EIP1193EventHandler = (...args: unknown[]) => void;
+/**
+ * Ethereum wallet provider interface following EIP-1193 spec
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1193
  */
 export interface OpenfortEmbeddedEthereumWalletProvider {
-    request: (args: {
-        method: string;
-        params?: any[];
-    }) => Promise<any>;
-    on: (event: string, handler: (...args: any[]) => void) => void;
-    removeListener: (event: string, handler: (...args: any[]) => void) => void;
-    [key: string]: any;
+    /**
+     * Submit a JSON-RPC request to the provider
+     */
+    request(args: EIP1193RequestArguments): Promise<unknown>;
+    /**
+     * Subscribe to provider events
+     */
+    on(event: EIP1193EventName | string, handler: EIP1193EventHandler): void;
+    /**
+     * Unsubscribe from provider events
+     */
+    removeListener(event: EIP1193EventName | string, handler: EIP1193EventHandler): void;
 }
+/**
+ * Represents a Solana transaction that can be signed.
+ * Supports multiple formats:
+ * - @solana/web3.js Transaction (has serializeMessage method)
+ * - @solana/kit compiled transaction (has messageBytes property)
+ * - Raw Uint8Array
+ */
+export type SolanaTransaction = {
+    messageBytes: Uint8Array;
+} | {
+    serializeMessage(): Uint8Array;
+} | Uint8Array;
+/**
+ * Result of signing a Solana transaction
+ */
+export type SignedSolanaTransaction = {
+    signature: string;
+    publicKey: string;
+};
+/**
+ * Solana provider request arguments
+ */
+export type SolanaSignMessageRequest = {
+    method: 'signMessage';
+    params: {
+        message: string;
+    };
+};
+export type SolanaSignTransactionRequest = {
+    method: 'signTransaction';
+    params: {
+        transaction: SolanaTransaction;
+    };
+};
+export type SolanaRequestArguments = SolanaSignMessageRequest | SolanaSignTransactionRequest;
 /**
  * Solana wallet provider interface
  */
 export interface OpenfortEmbeddedSolanaWalletProvider {
-    signMessage: (message: string) => Promise<string>;
-    signTransaction: (transaction: any) => Promise<any>;
-    signAllTransactions: (transactions: any[]) => Promise<any[]>;
-    publicKey: string;
-    [key: string]: any;
+    /**
+     * The public key (address) of the wallet
+     */
+    readonly publicKey: string;
+    /**
+     * Sign a message and return the signature
+     */
+    signMessage(message: string): Promise<string>;
+    /**
+     * Sign a single transaction
+     */
+    signTransaction(transaction: SolanaTransaction): Promise<SignedSolanaTransaction>;
+    /**
+     * Sign multiple transactions
+     */
+    signAllTransactions(transactions: SolanaTransaction[]): Promise<SignedSolanaTransaction[]>;
+    /**
+     * Request-based API (similar to EIP-1193 pattern)
+     */
+    request(args: SolanaSignMessageRequest): Promise<{
+        signature: string;
+    }>;
+    request(args: SolanaSignTransactionRequest): Promise<{
+        signedTransaction: SignedSolanaTransaction;
+    }>;
 }
 /**
  * Connected Ethereum wallet
@@ -41,6 +121,52 @@ export type ConnectedEmbeddedSolanaWallet = {
     walletIndex: number;
     getProvider: () => Promise<OpenfortEmbeddedSolanaWalletProvider>;
 };
+/**
+ * Result of creating an Ethereum wallet
+ */
+export type CreateEthereumWalletResult = {
+    error?: OpenfortError;
+    account?: EmbeddedAccount;
+    provider?: OpenfortEmbeddedEthereumWalletProvider;
+};
+/**
+ * Options for creating an Ethereum wallet
+ */
+export type CreateEthereumWalletOptions = {
+    chainId?: number;
+    recoveryPassword?: string;
+    accountType?: AccountTypeEnum;
+    policyId?: string;
+} & OpenfortHookOptions<CreateEthereumWalletResult>;
+/**
+ * Result of setting active Ethereum wallet
+ */
+export type SetActiveEthereumWalletResult = {
+    error?: OpenfortError;
+    wallet?: ConnectedEmbeddedEthereumWallet;
+    provider?: OpenfortEmbeddedEthereumWalletProvider;
+};
+/**
+ * Options for setting active Ethereum wallet
+ */
+export type SetActiveEthereumWalletOptions = {
+    address: Hex;
+    chainId?: number;
+    recoveryPassword?: string;
+} & OpenfortHookOptions<SetActiveEthereumWalletResult>;
+/**
+ * Result of setting recovery method
+ */
+export type SetRecoveryResult = {
+    error?: OpenfortError;
+};
+/**
+ * Options for setting recovery method
+ */
+export type SetRecoveryOptions = {
+    previousRecovery: RecoveryParams;
+    newRecovery: RecoveryParams;
+} & OpenfortHookOptions<SetRecoveryResult>;
 /**
  * Simplified Solana wallet creation options
  */
@@ -55,112 +181,125 @@ export type CreateSolanaEmbeddedWalletOpts = {
      */
     createAdditional?: boolean;
 };
+/**
+ * Result of creating a Solana wallet
+ */
+export type CreateSolanaWalletResult = {
+    error?: OpenfortError;
+    account?: EmbeddedAccount;
+    provider?: OpenfortEmbeddedSolanaWalletProvider;
+};
+/**
+ * Options for creating a Solana wallet
+ */
+export type CreateSolanaWalletOptions = CreateSolanaEmbeddedWalletOpts & OpenfortHookOptions<CreateSolanaWalletResult>;
+/**
+ * Result of setting active Solana wallet
+ */
+export type SetActiveSolanaWalletResult = {
+    error?: OpenfortError;
+    wallet?: ConnectedEmbeddedSolanaWallet;
+    provider?: OpenfortEmbeddedSolanaWalletProvider;
+};
+/**
+ * Options for setting active Solana wallet
+ */
+export type SetActiveSolanaWalletOptions = {
+    address: string;
+    recoveryPassword?: string;
+} & OpenfortHookOptions<SetActiveSolanaWalletResult>;
+/**
+ * Common actions available on all Ethereum wallet states
+ */
+export interface EthereumWalletActions {
+    /**
+     * Create a new embedded Ethereum wallet
+     */
+    create(options?: CreateEthereumWalletOptions): Promise<EmbeddedAccount>;
+    /**
+     * List of available wallets
+     */
+    wallets: ConnectedEmbeddedEthereumWallet[];
+    /**
+     * Set a wallet as active (recover/connect to it)
+     */
+    setActive(options: SetActiveEthereumWalletOptions): Promise<void>;
+    /**
+     * Update the recovery method for the wallet
+     */
+    setRecovery(options: SetRecoveryOptions): Promise<void>;
+    /**
+     * Export the private key of the active wallet
+     */
+    exportPrivateKey(): Promise<string>;
+}
+/**
+ * Common actions available on all Solana wallet states
+ */
+export interface SolanaWalletActions {
+    /**
+     * Create a new embedded Solana wallet
+     */
+    create(options?: CreateSolanaWalletOptions): Promise<EmbeddedAccount>;
+    /**
+     * List of available wallets
+     */
+    wallets: ConnectedEmbeddedSolanaWallet[];
+    /**
+     * Set a wallet as active (recover/connect to it)
+     */
+    setActive(options: SetActiveSolanaWalletOptions): Promise<void>;
+}
 /**
  * Ethereum wallet hook return type - discriminated union based on status
  */
-export type EmbeddedEthereumWalletState = {
+export type EmbeddedEthereumWalletState = (EthereumWalletActions & {
     status: 'disconnected';
     activeWallet: null;
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedEthereumWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-    setRecovery: (...args: any[]) => Promise<void>;
-    exportPrivateKey: (...args: any[]) => Promise<any>;
-} | {
+}) | (EthereumWalletActions & {
     status: 'connecting';
     activeWallet: ConnectedEmbeddedEthereumWallet;
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedEthereumWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-    setRecovery: (...args: any[]) => Promise<void>;
-    exportPrivateKey: (...args: any[]) => Promise<any>;
-} | {
+}) | (EthereumWalletActions & {
     status: 'reconnecting';
     activeWallet: ConnectedEmbeddedEthereumWallet;
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedEthereumWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-    setRecovery: (...args: any[]) => Promise<void>;
-    exportPrivateKey: (...args: any[]) => Promise<any>;
-} | {
+}) | (EthereumWalletActions & {
     status: 'creating';
     activeWallet: null;
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedEthereumWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-    setRecovery: (...args: any[]) => Promise<void>;
-    exportPrivateKey: (...args: any[]) => Promise<any>;
-} | {
+}) | (EthereumWalletActions & {
     status: 'needs-recovery';
     activeWallet: ConnectedEmbeddedEthereumWallet;
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedEthereumWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-    setRecovery: (...args: any[]) => Promise<void>;
-    exportPrivateKey: (...args: any[]) => Promise<any>;
-} | {
+}) | (EthereumWalletActions & {
     status: 'connected';
     activeWallet: ConnectedEmbeddedEthereumWallet;
     provider: OpenfortEmbeddedEthereumWalletProvider;
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedEthereumWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-    setRecovery: (...args: any[]) => Promise<void>;
-    exportPrivateKey: (...args: any[]) => Promise<any>;
-} | {
+}) | (EthereumWalletActions & {
     status: 'error';
     activeWallet: ConnectedEmbeddedEthereumWallet | null;
     error: string;
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedEthereumWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-    setRecovery: (...args: any[]) => Promise<void>;
-    exportPrivateKey: (...args: any[]) => Promise<any>;
-};
+});
 /**
  * Solana wallet hook return type - discriminated union based on status
  */
-export type EmbeddedSolanaWalletState = {
+export type EmbeddedSolanaWalletState = (SolanaWalletActions & {
     status: 'disconnected';
     activeWallet: null;
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedSolanaWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-} | {
+}) | (SolanaWalletActions & {
     status: 'connecting';
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedSolanaWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-} | {
+}) | (SolanaWalletActions & {
     status: 'reconnecting';
     activeWallet: ConnectedEmbeddedSolanaWallet;
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedSolanaWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-} | {
+}) | (SolanaWalletActions & {
     status: 'creating';
     activeWallet: null;
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedSolanaWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-} | {
+}) | (SolanaWalletActions & {
     status: 'needs-recovery';
     activeWallet: ConnectedEmbeddedSolanaWallet;
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedSolanaWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-} | {
+}) | (SolanaWalletActions & {
     status: 'connected';
     activeWallet: ConnectedEmbeddedSolanaWallet;
     provider: OpenfortEmbeddedSolanaWalletProvider;
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedSolanaWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-} | {
+}) | (SolanaWalletActions & {
     status: 'error';
     activeWallet: ConnectedEmbeddedSolanaWallet | null;
     error: string;
-    create: (...args: any[]) => Promise<any>;
-    wallets: ConnectedEmbeddedSolanaWallet[];
-    setActive: (...args: any[]) => Promise<void>;
-};
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openfort/react-native",
   "main": "dist/index.js",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "license": "MIT",
   "description": "React Native SDK for Openfort platform integration",
   "types": "dist/types/index.d.ts",