@phantom/embedded-provider-core 0.1.10 → 1.0.0-beta.1

package/README.md

@@ -57,7 +57,7 @@ import {
 // 1. Define your configuration
 const config: EmbeddedProviderConfig = {
   apiBaseUrl: "https://api.phantom.app",
-  organizationId: "your-org-id",
+  appId: "your-app-id",
   embeddedWalletType: "user-wallet", // or 'app-wallet'
   addressTypes: ["solana", "ethereum"],
   solanaProvider: "web3js",
@@ -271,7 +271,7 @@ try {
 interface EmbeddedProviderConfig {
   // Required
   apiBaseUrl: string; // Phantom API base URL
-  organizationId: string; // Your organization ID
+  appId: string;
   embeddedWalletType: "app-wallet" | "user-wallet";
   addressTypes: [AddressType, ...AddressType[]]; // Supported blockchain addresses
 
@@ -290,7 +290,6 @@ interface EmbeddedProviderConfig {
 interface Session {
   sessionId: string; // Unique session identifier
   walletId: string; // Phantom wallet ID
-  organizationId: string; // Organization ID
   keypair: {
     // Cryptographic keypair
     publicKey: string;

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;
@@ -17,6 +18,7 @@ interface Session {
     sessionId: string;
     walletId: string;
     organizationId: string;
+    appId: string;
     stamperInfo: StamperInfo;
     keypair?: Keypair;
     authProvider?: string;
@@ -65,21 +67,19 @@ interface AuthResult {
 interface PhantomConnectOptions {
     organizationId: string;
     parentOrganizationId: string;
+    appId: string;
     provider?: "google" | "apple";
     redirectUrl?: string;
     customAuthData?: Record<string, any>;
     authUrl?: string;
     sessionId: string;
-    appName?: string;
-    appLogo?: string;
 }
 interface JWTAuthOptions {
+    appId: string;
     organizationId: string;
     parentOrganizationId: string;
     jwtToken: string;
     customAuthData?: Record<string, any>;
-    appName?: string;
-    appLogo?: string;
 }
 interface AuthProvider {
     authenticate(options: PhantomConnectOptions | JWTAuthOptions): Promise<void | AuthResult>;
@@ -128,6 +128,7 @@ interface AuthOptions {
 }
 interface EmbeddedProviderConfig {
     apiBaseUrl: string;
+    appId: string;
     organizationId: string;
     authOptions?: {
         authUrl?: string;
@@ -136,11 +137,9 @@ interface EmbeddedProviderConfig {
     embeddedWalletType: "app-wallet" | "user-wallet" | (string & Record<never, never>);
     addressTypes: [AddressType, ...AddressType[]];
     solanaProvider: "web3js" | "kit" | (string & Record<never, never>);
-    appName?: string;
-    appLogo?: string;
 }
 
-type EmbeddedProviderEvent = 'connect' | 'connect_start' | 'connect_error' | 'disconnect' | 'error';
+type EmbeddedProviderEvent = "connect" | "connect_start" | "connect_error" | "disconnect" | "error";
 type EventCallback = (data?: any) => void;
 declare class EmbeddedProvider {
     private config;
@@ -154,6 +153,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;
@@ -189,6 +190,79 @@ 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 that is wallet adapter compliant
+ */
+declare class EmbeddedSolanaChain implements ISolanaChain {
+    private provider;
+    private currentNetworkId;
+    private _connected;
+    private _publicKey;
+    private eventEmitter;
+    constructor(provider: EmbeddedProvider);
+    get connected(): boolean;
+    get publicKey(): string | null;
+    private ensureConnected;
+    signMessage(message: string | Uint8Array): Promise<{
+        signature: Uint8Array;
+        publicKey: string;
+    }>;
+    signTransaction<T>(_transaction: T): Promise<T>;
+    signAndSendTransaction<T>(transaction: T): Promise<{
+        signature: string;
+    }>;
+    signAllTransactions<T>(transactions: T[]): Promise<T[]>;
+    connect(_options?: {
+        onlyIfTrusted?: boolean;
+    }): Promise<{
+        publicKey: string;
+    }>;
+    disconnect(): Promise<void>;
+    switchNetwork(network: "mainnet" | "devnet"): Promise<void>;
+    getPublicKey(): Promise<string | null>;
+    isConnected(): boolean;
+    private setupEventListeners;
+    private syncInitialState;
+    private updateConnectionState;
+    on(event: string, listener: (...args: any[]) => void): void;
+    off(event: string, listener: (...args: any[]) => void): void;
+}
+
+/**
+ * Embedded Ethereum chain implementation that is EIP-1193 compliant
+ */
+declare class EmbeddedEthereumChain implements IEthereumChain {
+    private provider;
+    private currentNetworkId;
+    private _connected;
+    private _accounts;
+    private eventEmitter;
+    constructor(provider: EmbeddedProvider);
+    get connected(): boolean;
+    get chainId(): string;
+    get accounts(): string[];
+    private ensureConnected;
+    request<T = any>(args: {
+        method: string;
+        params?: unknown[];
+    }): Promise<T>;
+    connect(): Promise<string[]>;
+    disconnect(): Promise<void>;
+    signPersonalMessage(message: string, address: string): Promise<string>;
+    signTypedData(typedData: any, address: string): Promise<string>;
+    sendTransaction(transaction: EthTransactionRequest): Promise<string>;
+    switchChain(chainId: number): Promise<void>;
+    getChainId(): Promise<number>;
+    getAccounts(): Promise<string[]>;
+    isConnected(): boolean;
+    private setupEventListeners;
+    private syncInitialState;
+    private updateConnectionState;
+    private handleEmbeddedRequest;
+    on(event: string, listener: (...args: any[]) => void): void;
+    off(event: string, listener: (...args: any[]) => void): void;
+}
+
 /**
  * Constants for authenticator lifecycle management
  */
@@ -205,4 +279,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;
@@ -17,6 +18,7 @@ interface Session {
     sessionId: string;
     walletId: string;
     organizationId: string;
+    appId: string;
     stamperInfo: StamperInfo;
     keypair?: Keypair;
     authProvider?: string;
@@ -65,21 +67,19 @@ interface AuthResult {
 interface PhantomConnectOptions {
     organizationId: string;
     parentOrganizationId: string;
+    appId: string;
     provider?: "google" | "apple";
     redirectUrl?: string;
     customAuthData?: Record<string, any>;
     authUrl?: string;
     sessionId: string;
-    appName?: string;
-    appLogo?: string;
 }
 interface JWTAuthOptions {
+    appId: string;
     organizationId: string;
     parentOrganizationId: string;
     jwtToken: string;
     customAuthData?: Record<string, any>;
-    appName?: string;
-    appLogo?: string;
 }
 interface AuthProvider {
     authenticate(options: PhantomConnectOptions | JWTAuthOptions): Promise<void | AuthResult>;
@@ -128,6 +128,7 @@ interface AuthOptions {
 }
 interface EmbeddedProviderConfig {
     apiBaseUrl: string;
+    appId: string;
     organizationId: string;
     authOptions?: {
         authUrl?: string;
@@ -136,11 +137,9 @@ interface EmbeddedProviderConfig {
     embeddedWalletType: "app-wallet" | "user-wallet" | (string & Record<never, never>);
     addressTypes: [AddressType, ...AddressType[]];
     solanaProvider: "web3js" | "kit" | (string & Record<never, never>);
-    appName?: string;
-    appLogo?: string;
 }
 
-type EmbeddedProviderEvent = 'connect' | 'connect_start' | 'connect_error' | 'disconnect' | 'error';
+type EmbeddedProviderEvent = "connect" | "connect_start" | "connect_error" | "disconnect" | "error";
 type EventCallback = (data?: any) => void;
 declare class EmbeddedProvider {
     private config;
@@ -154,6 +153,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;
@@ -189,6 +190,79 @@ 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 that is wallet adapter compliant
+ */
+declare class EmbeddedSolanaChain implements ISolanaChain {
+    private provider;
+    private currentNetworkId;
+    private _connected;
+    private _publicKey;
+    private eventEmitter;
+    constructor(provider: EmbeddedProvider);
+    get connected(): boolean;
+    get publicKey(): string | null;
+    private ensureConnected;
+    signMessage(message: string | Uint8Array): Promise<{
+        signature: Uint8Array;
+        publicKey: string;
+    }>;
+    signTransaction<T>(_transaction: T): Promise<T>;
+    signAndSendTransaction<T>(transaction: T): Promise<{
+        signature: string;
+    }>;
+    signAllTransactions<T>(transactions: T[]): Promise<T[]>;
+    connect(_options?: {
+        onlyIfTrusted?: boolean;
+    }): Promise<{
+        publicKey: string;
+    }>;
+    disconnect(): Promise<void>;
+    switchNetwork(network: "mainnet" | "devnet"): Promise<void>;
+    getPublicKey(): Promise<string | null>;
+    isConnected(): boolean;
+    private setupEventListeners;
+    private syncInitialState;
+    private updateConnectionState;
+    on(event: string, listener: (...args: any[]) => void): void;
+    off(event: string, listener: (...args: any[]) => void): void;
+}
+
+/**
+ * Embedded Ethereum chain implementation that is EIP-1193 compliant
+ */
+declare class EmbeddedEthereumChain implements IEthereumChain {
+    private provider;
+    private currentNetworkId;
+    private _connected;
+    private _accounts;
+    private eventEmitter;
+    constructor(provider: EmbeddedProvider);
+    get connected(): boolean;
+    get chainId(): string;
+    get accounts(): string[];
+    private ensureConnected;
+    request<T = any>(args: {
+        method: string;
+        params?: unknown[];
+    }): Promise<T>;
+    connect(): Promise<string[]>;
+    disconnect(): Promise<void>;
+    signPersonalMessage(message: string, address: string): Promise<string>;
+    signTypedData(typedData: any, address: string): Promise<string>;
+    sendTransaction(transaction: EthTransactionRequest): Promise<string>;
+    switchChain(chainId: number): Promise<void>;
+    getChainId(): Promise<number>;
+    getAccounts(): Promise<string[]>;
+    isConnected(): boolean;
+    private setupEventListeners;
+    private syncInitialState;
+    private updateConnectionState;
+    private handleEmbeddedRequest;
+    on(event: string, listener: (...args: any[]) => void): void;
+    off(event: string, listener: (...args: any[]) => void): void;
+}
+
 /**
  * Constants for authenticator lifecycle management
  */
@@ -205,4 +279,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 };