@phantom/embedded-provider-core 0.1.9 → 1.0.0-beta.0

package/dist/index.d.mts

@@ -2,6 +2,7 @@ import { StamperWithKeyManagement } from '@phantom/sdk-types';
 import { AddressType } from '@phantom/client';
 import { NetworkId } from '@phantom/constants';
 import { ParsedSignatureResult, ParsedTransactionResult } from '@phantom/parsers';
+import { ISolanaChain, IEthereumChain, EthTransactionRequest } from '@phantom/chains';
 
 interface Keypair {
     publicKey: string;
@@ -28,6 +29,7 @@ interface Session {
     authenticatorExpiresAt: number;
     lastRenewalAttempt?: number;
     username: string;
+    accountDerivationIndex?: number;
 }
 interface EmbeddedStorage {
     getSession(): Promise<Session | null>;
@@ -59,6 +61,7 @@ interface AuthResult {
     walletId: string;
     provider?: string;
     userInfo?: Record<string, any>;
+    accountDerivationIndex?: number;
 }
 interface PhantomConnectOptions {
     organizationId: string;
@@ -152,6 +155,8 @@ declare class EmbeddedProvider {
     private walletId;
     private addresses;
     private jwtAuth;
+    readonly solana: ISolanaChain;
+    readonly ethereum: IEthereumChain;
     private eventListeners;
     constructor(config: EmbeddedProviderConfig, platform: PlatformAdapter, logger: DebugLogger);
     on(event: EmbeddedProviderEvent, callback: EventCallback): void;
@@ -187,6 +192,50 @@ declare function generateSessionId(): string;
 
 declare function retryWithBackoff<T>(operation: () => Promise<T>, operationName: string, logger: DebugLogger, maxRetries?: number, baseDelay?: number): Promise<T>;
 
+/**
+ * Embedded Solana chain implementation for React Native and web embedded providers
+ */
+declare class EmbeddedSolanaChain implements ISolanaChain {
+    private provider;
+    private currentNetworkId;
+    constructor(provider: EmbeddedProvider);
+    private ensureConnected;
+    signMessage(message: string): Promise<ParsedSignatureResult>;
+    signTransaction<T>(_transaction: T): Promise<T>;
+    signAndSendTransaction<T>(transaction: T): Promise<ParsedTransactionResult>;
+    connect(_options?: {
+        onlyIfTrusted?: boolean;
+    }): Promise<{
+        publicKey: string;
+    }>;
+    disconnect(): Promise<void>;
+    switchNetwork(network: 'mainnet' | 'devnet'): Promise<void>;
+    getPublicKey(): Promise<string | null>;
+    isConnected(): boolean;
+}
+
+/**
+ * Embedded Ethereum chain implementation for React Native and web embedded providers
+ */
+declare class EmbeddedEthereumChain implements IEthereumChain {
+    private provider;
+    private currentNetworkId;
+    constructor(provider: EmbeddedProvider);
+    private ensureConnected;
+    request<T = any>(args: {
+        method: string;
+        params?: unknown[];
+    }): Promise<T>;
+    signPersonalMessage(message: string, address: string): Promise<ParsedSignatureResult>;
+    signTypedData(typedData: any, address: string): Promise<ParsedSignatureResult>;
+    sendTransaction(transaction: EthTransactionRequest): Promise<ParsedTransactionResult>;
+    switchChain(chainId: number): Promise<void>;
+    getChainId(): Promise<number>;
+    getAccounts(): Promise<string[]>;
+    isConnected(): boolean;
+    private handleEmbeddedRequest;
+}
+
 /**
  * Constants for authenticator lifecycle management
  */
@@ -203,4 +252,4 @@ declare const AUTHENTICATOR_EXPIRATION_TIME_MS: number;
  */
 declare const AUTHENTICATOR_RENEWAL_WINDOW_MS: number;
 
-export { AUTHENTICATOR_EXPIRATION_TIME_MS, AUTHENTICATOR_RENEWAL_WINDOW_MS, AuthOptions, AuthProvider, AuthResult, ConnectResult, DebugLogger, EmbeddedProvider, EmbeddedProviderConfig, EmbeddedProviderEvent, EmbeddedStorage, EventCallback, JWTAuth, JWTAuthOptions, Keypair, PhantomConnectOptions, PlatformAdapter, Session, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignedTransaction, StamperInfo, URLParamsAccessor, WalletAddress, generateSessionId, retryWithBackoff };
+export { AUTHENTICATOR_EXPIRATION_TIME_MS, AUTHENTICATOR_RENEWAL_WINDOW_MS, AuthOptions, AuthProvider, AuthResult, ConnectResult, DebugLogger, EmbeddedEthereumChain, EmbeddedProvider, EmbeddedProviderConfig, EmbeddedProviderEvent, EmbeddedSolanaChain, EmbeddedStorage, EventCallback, JWTAuth, JWTAuthOptions, Keypair, PhantomConnectOptions, PlatformAdapter, Session, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignedTransaction, StamperInfo, URLParamsAccessor, WalletAddress, generateSessionId, retryWithBackoff };

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { StamperWithKeyManagement } from '@phantom/sdk-types';
 import { AddressType } from '@phantom/client';
 import { NetworkId } from '@phantom/constants';
 import { ParsedSignatureResult, ParsedTransactionResult } from '@phantom/parsers';
+import { ISolanaChain, IEthereumChain, EthTransactionRequest } from '@phantom/chains';
 
 interface Keypair {
     publicKey: string;
@@ -28,6 +29,7 @@ interface Session {
     authenticatorExpiresAt: number;
     lastRenewalAttempt?: number;
     username: string;
+    accountDerivationIndex?: number;
 }
 interface EmbeddedStorage {
     getSession(): Promise<Session | null>;
@@ -59,6 +61,7 @@ interface AuthResult {
     walletId: string;
     provider?: string;
     userInfo?: Record<string, any>;
+    accountDerivationIndex?: number;
 }
 interface PhantomConnectOptions {
     organizationId: string;
@@ -152,6 +155,8 @@ declare class EmbeddedProvider {
     private walletId;
     private addresses;
     private jwtAuth;
+    readonly solana: ISolanaChain;
+    readonly ethereum: IEthereumChain;
     private eventListeners;
     constructor(config: EmbeddedProviderConfig, platform: PlatformAdapter, logger: DebugLogger);
     on(event: EmbeddedProviderEvent, callback: EventCallback): void;
@@ -187,6 +192,50 @@ declare function generateSessionId(): string;
 
 declare function retryWithBackoff<T>(operation: () => Promise<T>, operationName: string, logger: DebugLogger, maxRetries?: number, baseDelay?: number): Promise<T>;
 
+/**
+ * Embedded Solana chain implementation for React Native and web embedded providers
+ */
+declare class EmbeddedSolanaChain implements ISolanaChain {
+    private provider;
+    private currentNetworkId;
+    constructor(provider: EmbeddedProvider);
+    private ensureConnected;
+    signMessage(message: string): Promise<ParsedSignatureResult>;
+    signTransaction<T>(_transaction: T): Promise<T>;
+    signAndSendTransaction<T>(transaction: T): Promise<ParsedTransactionResult>;
+    connect(_options?: {
+        onlyIfTrusted?: boolean;
+    }): Promise<{
+        publicKey: string;
+    }>;
+    disconnect(): Promise<void>;
+    switchNetwork(network: 'mainnet' | 'devnet'): Promise<void>;
+    getPublicKey(): Promise<string | null>;
+    isConnected(): boolean;
+}
+
+/**
+ * Embedded Ethereum chain implementation for React Native and web embedded providers
+ */
+declare class EmbeddedEthereumChain implements IEthereumChain {
+    private provider;
+    private currentNetworkId;
+    constructor(provider: EmbeddedProvider);
+    private ensureConnected;
+    request<T = any>(args: {
+        method: string;
+        params?: unknown[];
+    }): Promise<T>;
+    signPersonalMessage(message: string, address: string): Promise<ParsedSignatureResult>;
+    signTypedData(typedData: any, address: string): Promise<ParsedSignatureResult>;
+    sendTransaction(transaction: EthTransactionRequest): Promise<ParsedTransactionResult>;
+    switchChain(chainId: number): Promise<void>;
+    getChainId(): Promise<number>;
+    getAccounts(): Promise<string[]>;
+    isConnected(): boolean;
+    private handleEmbeddedRequest;
+}
+
 /**
  * Constants for authenticator lifecycle management
  */
@@ -203,4 +252,4 @@ declare const AUTHENTICATOR_EXPIRATION_TIME_MS: number;
  */
 declare const AUTHENTICATOR_RENEWAL_WINDOW_MS: number;
 
-export { AUTHENTICATOR_EXPIRATION_TIME_MS, AUTHENTICATOR_RENEWAL_WINDOW_MS, AuthOptions, AuthProvider, AuthResult, ConnectResult, DebugLogger, EmbeddedProvider, EmbeddedProviderConfig, EmbeddedProviderEvent, EmbeddedStorage, EventCallback, JWTAuth, JWTAuthOptions, Keypair, PhantomConnectOptions, PlatformAdapter, Session, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignedTransaction, StamperInfo, URLParamsAccessor, WalletAddress, generateSessionId, retryWithBackoff };
+export { AUTHENTICATOR_EXPIRATION_TIME_MS, AUTHENTICATOR_RENEWAL_WINDOW_MS, AuthOptions, AuthProvider, AuthResult, ConnectResult, DebugLogger, EmbeddedEthereumChain, EmbeddedProvider, EmbeddedProviderConfig, EmbeddedProviderEvent, EmbeddedSolanaChain, EmbeddedStorage, EventCallback, JWTAuth, JWTAuthOptions, Keypair, PhantomConnectOptions, PlatformAdapter, Session, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignedTransaction, StamperInfo, URLParamsAccessor, WalletAddress, generateSessionId, retryWithBackoff };

package/dist/index.js

@@ -32,7 +32,9 @@ var src_exports = {};
 __export(src_exports, {
   AUTHENTICATOR_EXPIRATION_TIME_MS: () => AUTHENTICATOR_EXPIRATION_TIME_MS,
   AUTHENTICATOR_RENEWAL_WINDOW_MS: () => AUTHENTICATOR_RENEWAL_WINDOW_MS,
+  EmbeddedEthereumChain: () => EmbeddedEthereumChain,
   EmbeddedProvider: () => EmbeddedProvider,
+  EmbeddedSolanaChain: () => EmbeddedSolanaChain,
   JWTAuth: () => JWTAuth,
   generateSessionId: () => generateSessionId,
   retryWithBackoff: () => retryWithBackoff
@@ -43,7 +45,7 @@ module.exports = __toCommonJS(src_exports);
 var import_client = require("@phantom/client");
 var import_base64url = require("@phantom/base64url");
 var import_bs58 = __toESM(require("bs58"));
-var import_parsers = require("@phantom/parsers");
+var import_parsers3 = require("@phantom/parsers");
 
 // src/constants.ts
 var AUTHENTICATOR_EXPIRATION_TIME_MS = 7 * 24 * 60 * 60 * 1e3;
@@ -165,6 +167,170 @@ async function retryWithBackoff(operation, operationName, logger, maxRetries = 3
   throw lastError;
 }
 
+// src/chains/SolanaChain.ts
+var import_constants = require("@phantom/constants");
+var import_parsers = require("@phantom/parsers");
+var EmbeddedSolanaChain = class {
+  constructor(provider) {
+    this.provider = provider;
+    this.currentNetworkId = import_constants.NetworkId.SOLANA_MAINNET;
+  }
+  ensureConnected() {
+    if (!this.provider.isConnected()) {
+      throw new Error("Solana chain not available. Ensure SDK is connected.");
+    }
+  }
+  async signMessage(message) {
+    this.ensureConnected();
+    const result = await this.provider.signMessage({
+      message,
+      networkId: this.currentNetworkId
+    });
+    return (0, import_parsers.parseSignMessageResponse)(result.signature, this.currentNetworkId);
+  }
+  signTransaction(_transaction) {
+    this.ensureConnected();
+    throw new Error("signTransaction not yet implemented for embedded provider");
+  }
+  async signAndSendTransaction(transaction) {
+    this.ensureConnected();
+    const result = await this.provider.signAndSendTransaction({
+      transaction,
+      networkId: this.currentNetworkId
+    });
+    return (0, import_parsers.parseTransactionResponse)(result.rawTransaction, this.currentNetworkId, result.hash);
+  }
+  connect(_options) {
+    const addresses = this.provider.getAddresses();
+    const solanaAddr = addresses.find((a) => a.addressType === "Solana");
+    if (!solanaAddr)
+      throw new Error("No Solana address found");
+    return Promise.resolve({ publicKey: solanaAddr.address });
+  }
+  async disconnect() {
+    return this.provider.disconnect();
+  }
+  switchNetwork(network) {
+    this.currentNetworkId = network === "mainnet" ? import_constants.NetworkId.SOLANA_MAINNET : import_constants.NetworkId.SOLANA_DEVNET;
+    return Promise.resolve();
+  }
+  getPublicKey() {
+    if (!this.provider.isConnected())
+      return Promise.resolve(null);
+    const addresses = this.provider.getAddresses();
+    const solanaAddr = addresses.find((a) => a.addressType === "Solana");
+    return Promise.resolve(solanaAddr?.address || null);
+  }
+  isConnected() {
+    return this.provider.isConnected();
+  }
+};
+
+// src/chains/EthereumChain.ts
+var import_constants2 = require("@phantom/constants");
+var import_parsers2 = require("@phantom/parsers");
+var EmbeddedEthereumChain = class {
+  constructor(provider) {
+    this.provider = provider;
+    this.currentNetworkId = import_constants2.NetworkId.ETHEREUM_MAINNET;
+  }
+  ensureConnected() {
+    if (!this.provider.isConnected()) {
+      throw new Error("Ethereum chain not available. Ensure SDK is connected.");
+    }
+  }
+  async request(args) {
+    this.ensureConnected();
+    return this.handleEmbeddedRequest(args);
+  }
+  async signPersonalMessage(message, address) {
+    const signature = await this.request({
+      method: "personal_sign",
+      params: [message, address]
+    });
+    return (0, import_parsers2.parseSignMessageResponse)(signature, this.currentNetworkId);
+  }
+  async signTypedData(typedData, address) {
+    const signature = await this.request({
+      method: "eth_signTypedData_v4",
+      params: [address, JSON.stringify(typedData)]
+    });
+    return (0, import_parsers2.parseSignMessageResponse)(signature, this.currentNetworkId);
+  }
+  async sendTransaction(transaction) {
+    const result = await this.provider.signAndSendTransaction({
+      transaction,
+      networkId: this.currentNetworkId
+    });
+    return (0, import_parsers2.parseTransactionResponse)(result.rawTransaction, this.currentNetworkId, result.hash);
+  }
+  switchChain(chainId) {
+    const networkId = (0, import_constants2.chainIdToNetworkId)(chainId);
+    if (!networkId) {
+      return Promise.reject(new Error(`Unsupported chainId: ${chainId}`));
+    }
+    this.currentNetworkId = networkId;
+    return Promise.resolve();
+  }
+  getChainId() {
+    const chainId = (0, import_constants2.networkIdToChainId)(this.currentNetworkId);
+    return Promise.resolve(chainId || 1);
+  }
+  async getAccounts() {
+    return this.request({ method: "eth_accounts" });
+  }
+  isConnected() {
+    return this.provider.isConnected();
+  }
+  async handleEmbeddedRequest(args) {
+    switch (args.method) {
+      case "personal_sign": {
+        const [message, _address] = args.params;
+        const result = await this.provider.signMessage({
+          message,
+          networkId: this.currentNetworkId
+        });
+        return (0, import_parsers2.parseSignMessageResponse)(result.signature, this.currentNetworkId).signature;
+      }
+      case "eth_signTypedData_v4": {
+        const [_typedDataAddress, typedDataStr] = args.params;
+        const _typedData = JSON.parse(typedDataStr);
+        const typedDataResult = await this.provider.signMessage({
+          message: typedDataStr,
+          // Pass the stringified typed data as message
+          networkId: this.currentNetworkId
+        });
+        return (0, import_parsers2.parseSignMessageResponse)(typedDataResult.signature, this.currentNetworkId).signature;
+      }
+      case "eth_sendTransaction": {
+        const [transaction] = args.params;
+        const networkIdFromTx = transaction.chainId ? (0, import_constants2.chainIdToNetworkId)(typeof transaction.chainId === "number" ? transaction.chainId : parseInt(transaction.chainId, 16)) : null;
+        const sendResult = await this.provider.signAndSendTransaction({
+          transaction,
+          networkId: networkIdFromTx || this.currentNetworkId
+        });
+        return (0, import_parsers2.parseTransactionResponse)(sendResult.rawTransaction, this.currentNetworkId, sendResult.hash).hash;
+      }
+      case "eth_accounts": {
+        const addresses = this.provider.getAddresses();
+        const ethAddr = addresses.find((a) => a.addressType === "Ethereum");
+        return ethAddr ? [ethAddr.address] : [];
+      }
+      case "eth_chainId": {
+        return `0x${((0, import_constants2.networkIdToChainId)(this.currentNetworkId) || 1).toString(16)}`;
+      }
+      case "wallet_switchEthereumChain": {
+        const [{ chainId }] = args.params;
+        const numericChainId = parseInt(chainId, 16);
+        await this.switchChain(numericChainId);
+        return void 0;
+      }
+      default:
+        throw new Error(`Embedded provider doesn't support method: ${args.method}`);
+    }
+  }
+};
+
 // src/embedded-provider.ts
 var EmbeddedProvider = class {
   constructor(config, platform, logger) {
@@ -182,6 +348,8 @@ var EmbeddedProvider = class {
     this.stamper = platform.stamper;
     this.jwtAuth = new JWTAuth();
     config.solanaProvider;
+    this.solana = new EmbeddedSolanaChain(this);
+    this.ethereum = new EmbeddedEthereumChain(this);
     this.logger.info("EMBEDDED_PROVIDER", "EmbeddedProvider initialized");
   }
   /*
@@ -215,14 +383,17 @@ var EmbeddedProvider = class {
     }
   }
   async getAndFilterWalletAddresses(walletId) {
+    const session = await this.storage.getSession();
+    const derivationIndex = session?.accountDerivationIndex ?? 0;
     const addresses = await retryWithBackoff(
-      () => this.client.getWalletAddresses(walletId),
+      () => this.client.getWalletAddresses(walletId, void 0, derivationIndex),
       "getWalletAddresses",
       this.logger
     ).catch(async (error) => {
       this.logger.error("EMBEDDED_PROVIDER", "getWalletAddresses failed after retries, disconnecting", {
         walletId,
-        error: error.message
+        error: error.message,
+        derivationIndex
       });
       await this.storage.clearSession();
       this.client = null;
@@ -572,17 +743,20 @@ var EmbeddedProvider = class {
       walletId: this.walletId,
       message: params.message
     });
-    const parsedMessage = (0, import_parsers.parseMessage)(params.message);
+    const parsedMessage = (0, import_parsers3.parseMessage)(params.message);
+    const session = await this.storage.getSession();
+    const derivationIndex = session?.accountDerivationIndex ?? 0;
     const rawResponse = await this.client.signMessage({
       walletId: this.walletId,
       message: parsedMessage.base64url,
-      networkId: params.networkId
+      networkId: params.networkId,
+      derivationIndex
     });
     this.logger.info("EMBEDDED_PROVIDER", "Message signed successfully", {
       walletId: this.walletId,
       message: params.message
     });
-    return (0, import_parsers.parseSignMessageResponse)(rawResponse, params.networkId);
+    return (0, import_parsers3.parseSignMessageResponse)(rawResponse, params.networkId);
   }
   async signAndSendTransaction(params) {
     if (!this.client || !this.walletId) {
@@ -593,15 +767,19 @@ var EmbeddedProvider = class {
       walletId: this.walletId,
       networkId: params.networkId
     });
-    const parsedTransaction = await (0, import_parsers.parseTransaction)(params.transaction, params.networkId);
+    const parsedTransaction = await (0, import_parsers3.parseTransactionToBase64Url)(params.transaction, params.networkId);
+    const session = await this.storage.getSession();
+    const derivationIndex = session?.accountDerivationIndex ?? 0;
     this.logger.log("EMBEDDED_PROVIDER", "Parsed transaction for signing", {
       walletId: this.walletId,
-      transaction: parsedTransaction
+      transaction: parsedTransaction,
+      derivationIndex
     });
     const rawResponse = await this.client.signAndSendTransaction({
       walletId: this.walletId,
       transaction: parsedTransaction.base64url,
-      networkId: params.networkId
+      networkId: params.networkId,
+      derivationIndex
     });
     this.logger.info("EMBEDDED_PROVIDER", "Transaction signed and sent successfully", {
       walletId: this.walletId,
@@ -609,7 +787,7 @@ var EmbeddedProvider = class {
       hash: rawResponse.hash,
       rawTransaction: rawResponse.rawTransaction
     });
-    return await (0, import_parsers.parseTransactionResponse)(rawResponse.rawTransaction, params.networkId, rawResponse.hash);
+    return await (0, import_parsers3.parseTransactionResponse)(rawResponse.rawTransaction, params.networkId, rawResponse.hash);
   }
   getAddresses() {
     return this.addresses;
@@ -658,6 +836,8 @@ var EmbeddedProvider = class {
         stamperInfo,
         authProvider: "app-wallet",
         userInfo: { embeddedWalletType: this.config.embeddedWalletType },
+        accountDerivationIndex: 0,
+        // App wallets default to index 0
         status: "completed",
         createdAt: now,
         lastUsed: now,
@@ -698,6 +878,7 @@ var EmbeddedProvider = class {
       stamperInfo,
       authProvider: authResult.provider,
       userInfo: authResult.userInfo,
+      accountDerivationIndex: authResult.accountDerivationIndex,
       status: "completed",
       createdAt: now,
       lastUsed: now,
@@ -731,6 +912,8 @@ var EmbeddedProvider = class {
       stamperInfo,
       authProvider: "phantom-connect",
       userInfo: { provider: authOptions?.provider },
+      accountDerivationIndex: void 0,
+      // Will be set when redirect completes
       status: "pending",
       createdAt: now,
       lastUsed: now,
@@ -769,6 +952,7 @@ var EmbeddedProvider = class {
       });
       tempSession.walletId = authResult.walletId;
       tempSession.authProvider = authResult.provider || tempSession.authProvider;
+      tempSession.accountDerivationIndex = authResult.accountDerivationIndex;
       tempSession.status = "completed";
       tempSession.lastUsed = Date.now();
       await this.storage.saveSession(tempSession);
@@ -784,6 +968,7 @@ var EmbeddedProvider = class {
     }
     session.walletId = authResult.walletId;
     session.authProvider = authResult.provider || session.authProvider;
+    session.accountDerivationIndex = authResult.accountDerivationIndex;
     session.status = "completed";
     session.lastUsed = Date.now();
     await this.storage.saveSession(session);
@@ -923,7 +1108,9 @@ var EmbeddedProvider = class {
 0 && (module.exports = {
   AUTHENTICATOR_EXPIRATION_TIME_MS,
   AUTHENTICATOR_RENEWAL_WINDOW_MS,
+  EmbeddedEthereumChain,
   EmbeddedProvider,
+  EmbeddedSolanaChain,
   JWTAuth,
   generateSessionId,
   retryWithBackoff