@thru/wallet 0.2.25 → 0.2.28

package/dist/native.d.ts

@@ -56,6 +56,34 @@ interface ThruTransactionReviewPayload {
     simulation?: ThruTransactionReviewSimulation;
     abiReflection?: ThruTransactionReviewAbiReflection;
 }
+type ThruSigningSessionTimestamp = Date | number | bigint | string;
+interface ThruSigningSessionCreateOptions {
+    walletAddress?: string;
+    durationSeconds?: number;
+    expiresAt?: ThruSigningSessionTimestamp;
+    review?: ThruTransactionReviewPayload;
+}
+interface ThruSigningSessionInstructionCreateOptions extends Omit<ThruSigningSessionCreateOptions, "review"> {
+    walletAccountIdx: number;
+}
+interface ThruSigningSessionDescriptor {
+    id: string;
+    walletAddress: string;
+    publicKey: string;
+    authIdx: number;
+    expiresAt: number;
+    createdAt: number;
+}
+interface ThruSigningSession extends ThruSigningSessionDescriptor {
+    signTransaction(transaction: ThruTransactionIntent): Promise<string>;
+    revoke(): Promise<void>;
+    toJSON(): ThruSigningSessionDescriptor;
+}
+interface ThruSigningSessionInstruction {
+    session: ThruSigningSession;
+    programAddress: string;
+    instructionData: Uint8Array;
+}
 interface ThruTransactionIntent {
     walletAddress?: string;
     programAddress: string;
@@ -63,6 +91,19 @@ interface ThruTransactionIntent {
     readWriteAddresses?: string[];
     readOnlyAddresses?: string[];
     review?: ThruTransactionReviewPayload;
+    /** @internal Used by ThruSigningSession handles. */
+    signingSessionId?: string;
+}
+interface ThruPasskeyChallengeIntent {
+    /** base64url-encoded passkey-manager challenge bytes. */
+    challenge: string;
+    walletAddress?: string;
+}
+interface ThruPasskeyChallengeSignature {
+    signatureR: string;
+    signatureS: string;
+    authenticatorData: string;
+    clientDataJSON: string;
 }
 interface SignMessageParams {
     message: string | Uint8Array;
@@ -105,18 +146,51 @@ interface IThruChain {
      * account ordering, headers, nonces, and final wire layout.
      */
     signTransaction(transaction: ThruTransactionIntent): Promise<string>;
+    /**
+     * Sign a backend-prepared passkey-manager challenge with the wallet-owned
+     * selected passkey and return submit-ready signature fields.
+     */
+    signPasskeyChallenge(challenge: ThruPasskeyChallengeIntent): Promise<ThruPasskeyChallengeSignature>;
+    /**
+     * Create a temporary wallet-owned signing session. The SDK stores the
+     * returned descriptor in app-local storage; the wallet stores the private key.
+     */
+    createSigningSession(options: ThruSigningSessionCreateOptions): Promise<ThruSigningSession>;
+    /**
+     * Prepare a temporary signing-session authority instruction without asking
+     * for passkey approval. The returned instruction must be included in a
+     * later passkey-approved transaction before the session can sign.
+     */
+    createSigningSessionInstruction(options: ThruSigningSessionInstructionCreateOptions): Promise<ThruSigningSessionInstruction>;
+    /**
+     * Confirm that a prepared signing-session instruction landed on-chain and
+     * publish the resulting session descriptor into SDK storage.
+     */
+    confirmSigningSession(id: string): Promise<ThruSigningSession>;
+    /** Return a locally known signing session by id. */
+    getSigningSession(id: string): Promise<ThruSigningSession | null>;
+    /** Return locally known signing sessions for this SDK app scope only. */
+    getSigningSessions(): Promise<ThruSigningSession[]>;
+    /** Delete a locally known session and ask the wallet to delete its key. */
+    revokeSigningSession(id: string): Promise<void>;
 }
 
 declare const POST_MESSAGE_REQUEST_TYPES: {
     readonly CONNECT: "connect";
+    readonly CREATE_ACCOUNT: "createAccount";
     readonly DISCONNECT: "disconnect";
     readonly SIGN_MESSAGE: "signMessage";
     readonly SIGN_TRANSACTION: "signTransaction";
+    readonly SIGN_PASSKEY_CHALLENGE: "signPasskeyChallenge";
     readonly GET_ACCOUNTS: "getAccounts";
     readonly GET_CONNECTION_STATE: "getConnectionState";
     readonly GET_SIGNING_CONTEXT: "getSigningContext";
     readonly SELECT_ACCOUNT: "selectAccount";
     readonly MANAGE_ACCOUNTS: "manageAccounts";
+    readonly CREATE_SIGNING_SESSION: "createSigningSession";
+    readonly CREATE_SIGNING_SESSION_INSTRUCTION: "createSigningSessionInstruction";
+    readonly CONFIRM_SIGNING_SESSION: "confirmSigningSession";
+    readonly REVOKE_SIGNING_SESSION: "revokeSigningSession";
 };
 declare const EMBEDDED_PROVIDER_EVENTS: {
     readonly CONNECT_START: "connect_start";
@@ -128,6 +202,15 @@ declare const EMBEDDED_PROVIDER_EVENTS: {
     readonly UI_SHOW: "ui_show";
     readonly ACCOUNT_CHANGED: "account_changed";
 };
+interface CreateAccountResult {
+    account: WalletAccount;
+    accounts: WalletAccount[];
+    selectedAccount: WalletAccount;
+    signature: string | null;
+    vmError: string | null;
+    userErrorCode: string | null;
+    executionResult: string | null;
+}
 interface GetConnectionStateResult {
     isAuthorized: boolean;
     isConnected: boolean;
@@ -175,6 +258,7 @@ interface WebViewMessageEventLike {
 }
 
 type IosWebViewMode = "direct" | "shell-iframe";
+type NativeWalletExperience = "standard" | "transparent";
 type WalletAvailability = {
     status: "checking";
     isAuthorized: false;
@@ -211,9 +295,14 @@ type WalletAvailability = {
 };
 interface NativeSDKConfig {
     walletUrl?: string;
+    /** Wallet presentation loaded in the native WebView. Transparent mode
+        signs in without opening the native wallet sheet. */
+    walletExperience?: NativeWalletExperience;
     /** Stamped on every postMessage so wallet's ConnectedAppsStorage can
         scope per-host. Default: 'thru-mobile://app'. */
     origin?: string;
+    /** Default app metadata used for connection and transparent hydration. */
+    metadata?: ConnectMetadataInput;
     rpcUrl?: string;
     addressTypes?: AddressType[];
     /** iOS-only host mode. Shell iframe is the default; direct is kept
@@ -226,6 +315,8 @@ interface NativeSDKConfig {
     storageKey?: string;
     /** Override the key used to remember the app-local selected account. */
     selectedAccountStorageKey?: string;
+    /** Override the key used for app-local signing session descriptors. */
+    signingSessionStorageKey?: string;
 }
 interface SignInOptions {
     app_id: string;
@@ -239,6 +330,10 @@ interface ConnectOptions {
     preferredAccountAddress?: string;
     intent?: ConnectRequestPayload["intent"];
 }
+interface CreateAccountOptions {
+    accountName?: string;
+    metadata?: ConnectMetadataInput;
+}
 interface RestoreConnectionOptions {
     hydrate?: boolean;
 }
@@ -273,6 +368,8 @@ declare class NativeSDK {
     private readonly storageKey;
     private readonly selectedAccountStorageKey;
     private readonly iosWebViewMode;
+    private readonly walletExperience;
+    private readonly defaultMetadata?;
     constructor(config?: NativeSDKConfig);
     /** Hand the WebView ref to the underlying provider/bridge. */
     attachWebView(ref: WebViewRefLike): void;
@@ -294,6 +391,7 @@ declare class NativeSDK {
     initialize(): Promise<void>;
     connect(options?: ConnectOptions): Promise<ConnectResult>;
     signIn(options: SignInOptions): Promise<ConnectResult>;
+    createAccount(options?: CreateAccountOptions): Promise<CreateAccountResult>;
     disconnect(): Promise<void>;
     isConnected(): boolean;
     getWalletAvailability(): WalletAvailability;
@@ -326,4 +424,10 @@ declare class NativeSDK {
     private readSelectedAccountAddress;
 }
 
-export { AddressType, type AppMetadata, type ConnectMetadataInput, type ConnectOptions, type ConnectResult, EMBEDDED_PROVIDER_EVENTS, ErrorCode, type EventCallback, type GetConnectionStateResult, type IThruChain, type IosWebViewMode, type ManageAccountsResult, NativeSDK, type NativeSDKConfig, type NativeSDKStorage, type NativeSDKUiHandlers, POST_MESSAGE_REQUEST_TYPES, type RestoreConnectionOptions, type SDKEvent, type SignInOptions, type SignMessageParams, type SignMessageResult, type ThruSigningContext, ThruTransactionEncoding, type ThruTransactionIntent, type WalletAccount, type WalletAvailability };
+interface SigningSessionStorage {
+    getItem: (key: string) => string | null | Promise<string | null>;
+    setItem: (key: string, value: string) => void | Promise<void>;
+    removeItem: (key: string) => void | Promise<void>;
+}
+
+export { AddressType, type AppMetadata, type ConnectMetadataInput, type ConnectOptions, type ConnectResult, type CreateAccountOptions, type CreateAccountResult, EMBEDDED_PROVIDER_EVENTS, ErrorCode, type EventCallback, type GetConnectionStateResult, type IThruChain, type IosWebViewMode, type ManageAccountsResult, NativeSDK, type NativeSDKConfig, type NativeSDKStorage, type NativeSDKUiHandlers, type NativeWalletExperience, POST_MESSAGE_REQUEST_TYPES, type RestoreConnectionOptions, type SDKEvent, type SignInOptions, type SignMessageParams, type SignMessageResult, type SigningSessionStorage, type ThruPasskeyChallengeIntent, type ThruPasskeyChallengeSignature, type ThruSigningContext, type ThruSigningSession, type ThruSigningSessionCreateOptions, type ThruSigningSessionDescriptor, type ThruSigningSessionInstruction, type ThruSigningSessionInstructionCreateOptions, type ThruSigningSessionTimestamp, ThruTransactionEncoding, type ThruTransactionIntent, type WalletAccount, type WalletAvailability };