@cavos/kit 0.0.2 → 0.0.4

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { BackupSigner, Cavos, CavosAuth, CavosSolana, DEVICE_ACCOUNT_CLASS_HASH, DEVICE_ACCOUNT_PROGRAM_ID, HttpRecoveryClient, HttpWalletRegistry, InMemoryWalletRegistry, SECP256R1_PROGRAM_ID, SOLANA_NETWORKS, STARKNET_NETWORKS, SolanaAdapter, SolanaRelayer, StarknetAdapter, StarknetDeviceSigner, UDC_ADDRESS, WebCryptoSigner, anchorDiscriminator, bigIntTo32Bytes, buildSecp256r1Instruction, bytesToBigInt, bytesToHex, compressedPubkey, deriveAddressSeed, deriveAddressSeedSolana, deriveBackupKey, encodeLowSSignature, generateRecoveryCode, hexToBytes, recoverYParity, serializeInstructions, signatureToFelts, u256ToFelts } from './chunk-PEUQQZB5.mjs';
+export { BackupSigner, Cavos, CavosAuth, CavosSolana, CavosStellar, DEVICE_ACCOUNT_CLASS_HASH, DEVICE_ACCOUNT_PROGRAM_ID, DEVICE_ACCOUNT_WASM_HASH, FACTORY_CONTRACT_ID, HttpRecoveryClient, HttpWalletRegistry, InMemoryWalletRegistry, NATIVE_SAC_ID, PasskeySigner, SECP256R1_PROGRAM_ID, SOLANA_NETWORKS, STARKNET_NETWORKS, STELLAR_NETWORKS, SolanaAdapter, SolanaRelayer, StarknetAdapter, StarknetDeviceSigner, StellarAdapter, StellarRelayer, UDC_ADDRESS, WebCryptoSigner, anchorDiscriminator, approveDeviceEverywhere, base64urlEncode, batchChallenge, bigIntTo32Bytes, buildSecp256r1Instruction, bytesToBigInt, bytesToHex, compressedPubkey, deriveAddressSeed, deriveAddressSeedSolana, deriveAddressSeedStellar, deriveBackupKey, deviceSignatureScVal, encodeLowSSignature, encodeLowSSignature2 as encodeStellarLowSSignature, generateRecoveryCode, hexToBytes, lowS, recoverCandidatePublicKeys, recoverYParity, sec1Pubkey, serializeInstructions, signatureToFelts, u256ToFelts, webauthnDigest } from './chunk-F2J25XSL.mjs';
 
 // src/auth/AuthProvider.ts
 var StaticIdentity = class {

package/dist/react/index.d.mts

@@ -1,8 +1,9 @@
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
-import { i as Chain, N as NetworkEnv, h as CavosWallet, e as ChainCall } from '../Cavos-C2KHZxxu.mjs';
+import { k as Chain, u as NetworkEnv, j as CavosWallet, e as ChainCall, x as PasskeySigner, w as PasskeyEnrollParams } from '../Cavos-x9qFpOvJ.mjs';
 import 'starknet';
 import '@solana/web3.js';
+import '@stellar/stellar-sdk';
 
 interface CavosConfig {
     /** Cavos App ID from the dashboard. */
@@ -43,6 +44,12 @@ interface WalletStatus {
     awaitingApproval: boolean;
     /** The pending device-addition request id, when awaitingApproval. */
     pendingRequestId: string | null;
+    /** True if the account already has a passkey enrolled as an approver, so the
+     * modal can offer passkey approval over email on the new-device path. */
+    hasPasskey: boolean;
+    /** True right after a brand-new account is created (first sign-up), so the UI
+     * can offer a one-time "secure your account" step. Cleared once handled. */
+    isNewAccount: boolean;
 }
 interface UserInfo {
     userId: string;
@@ -55,12 +62,12 @@ interface CavosContextValue {
     closeModal: () => void;
     isAuthenticated: boolean;
     user: UserInfo | null;
-    /** The active chain ('starknet' | 'solana'). */
+    /** The active chain ('starknet' | 'solana' | 'stellar'). */
     chain: Chain;
     /**
-     * The raw connected wallet, discriminated by `wallet.chain`. Use this for
-     * chain-native calls (e.g. Solana `wallet.execute(amount, dest)`); narrow on
-     * `wallet.chain` first. Null until connected.
+     * The connected wallet, discriminated by `wallet.chain`. Narrow on
+     * `wallet.chain` before chain-native calls (e.g. Solana `wallet.execute(amount,
+     * dest)`). Null until connected.
      */
     wallet: CavosWallet | null;
     address: string | null;
@@ -81,7 +88,7 @@ interface CavosContextValue {
     verifyOtp: (email: string, code: string) => Promise<void>;
     /** Resolve identity from an OAuth callback (?auth_data=…) and deploy. */
     handleCallback: (authData: string) => Promise<void>;
-    /** Execute a sponsored (gasless) multicall, signed by the device key. */
+    /** Execute a sponsored (gasless) multicall, signed by the device key (Starknet). */
     execute: (calls: ChainCall[]) => Promise<{
         transactionHash: string;
     }>;
@@ -95,34 +102,59 @@ interface CavosContextValue {
     /** Re-request the device-approval email for the current pending request. */
     resendDeviceApproval: () => Promise<void>;
     /**
-     * Register a backup signer derived from `code` on the current account
-     * (gasless). The code is generated by the kit and shown to the user once.
-     * Resolves with the code so the caller can display it.
+     * Enroll a passkey as an approver (2FA-style step-up). Requires a ready device;
+     * returns the passkey's public key.
+     */
+    enrollPasskey: (passkey: PasskeySigner, params: PasskeyEnrollParams) => Promise<{
+        publicKey: {
+            x: bigint;
+            y: bigint;
+        };
+        transactionHash?: string;
+    }>;
+    /** Whether this device can use a platform passkey (Face ID / Touch ID / PIN). */
+    passkeySupported: boolean;
+    /**
+     * Modal-friendly wrapper: enroll a synced passkey as an approver using the
+     * signed-in user's identity + the app name. Requires a ready device.
+     */
+    enrollPasskeyDefault: () => Promise<void>;
+    /**
+     * Modal-friendly wrapper for the new-device flow: prompt the user's synced
+     * passkey to approve THIS device, then refresh to a ready state. Sponsored by
+     * the default paymaster/relayer.
+     */
+    approveDeviceWithPasskey: () => Promise<void>;
+    /**
+     * Register a backup signer derived from a generated recovery code (gasless).
+     * Resolves with the code so the caller can display it once.
      */
     setupRecovery: () => Promise<string>;
     /**
-     * Recover access after losing every device. Requires the recovery code. Runs
-     * the full Cavos.recover flow and brings the provider to a ready state.
+     * Recover access after losing every device. Requires the recovery code. Brings
+     * the provider to a ready state.
      */
     recover: (code: string) => Promise<void>;
     logout: () => void;
 }
 interface CavosProviderProps {
+    /** A single chain config. The provider manages exactly one chain. */
     config: CavosConfig;
     modal?: CavosModalConfig;
     children: ReactNode;
 }
 /**
- * Drop-in Cavos provider. Wrap your app once; descendants call `useCavos()`.
+ * Drop-in Cavos provider for ONE chain. Wrap your app once; descendants call
+ * `useCavos()`.
  *
- *   <CavosProvider config={{ network: 'sepolia', appSalt, paymasterApiKey }}
- *                  modal={{ appName: 'My App', theme: 'dark', emailMode: 'otp' }}>
+ *   <CavosProvider config={{ chain: 'solana', network: 'testnet', appId, appSalt }}
+ *                  modal={{ appName: 'My App', theme: 'dark' }}>
  *     <App />
  *   </CavosProvider>
  *
  * Behind the scenes: login (social / email) resolves a stable identity, the kit
- * deploys a device-signer smart account gaslessly, and `execute()` submits
- * gasless multicalls signed silently by the browser's device key.
+ * deploys a device-signer smart account gaslessly, and the wallet handle submits
+ * gasless transactions signed silently by the browser's device key.
  */
 declare function CavosProvider({ config, modal, children }: CavosProviderProps): react.JSX.Element;
 declare function useCavos(): CavosContextValue;

package/dist/react/index.d.ts

@@ -1,8 +1,9 @@
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
-import { i as Chain, N as NetworkEnv, h as CavosWallet, e as ChainCall } from '../Cavos-C2KHZxxu.js';
+import { k as Chain, u as NetworkEnv, j as CavosWallet, e as ChainCall, x as PasskeySigner, w as PasskeyEnrollParams } from '../Cavos-x9qFpOvJ.js';
 import 'starknet';
 import '@solana/web3.js';
+import '@stellar/stellar-sdk';
 
 interface CavosConfig {
     /** Cavos App ID from the dashboard. */
@@ -43,6 +44,12 @@ interface WalletStatus {
     awaitingApproval: boolean;
     /** The pending device-addition request id, when awaitingApproval. */
     pendingRequestId: string | null;
+    /** True if the account already has a passkey enrolled as an approver, so the
+     * modal can offer passkey approval over email on the new-device path. */
+    hasPasskey: boolean;
+    /** True right after a brand-new account is created (first sign-up), so the UI
+     * can offer a one-time "secure your account" step. Cleared once handled. */
+    isNewAccount: boolean;
 }
 interface UserInfo {
     userId: string;
@@ -55,12 +62,12 @@ interface CavosContextValue {
     closeModal: () => void;
     isAuthenticated: boolean;
     user: UserInfo | null;
-    /** The active chain ('starknet' | 'solana'). */
+    /** The active chain ('starknet' | 'solana' | 'stellar'). */
     chain: Chain;
     /**
-     * The raw connected wallet, discriminated by `wallet.chain`. Use this for
-     * chain-native calls (e.g. Solana `wallet.execute(amount, dest)`); narrow on
-     * `wallet.chain` first. Null until connected.
+     * The connected wallet, discriminated by `wallet.chain`. Narrow on
+     * `wallet.chain` before chain-native calls (e.g. Solana `wallet.execute(amount,
+     * dest)`). Null until connected.
      */
     wallet: CavosWallet | null;
     address: string | null;
@@ -81,7 +88,7 @@ interface CavosContextValue {
     verifyOtp: (email: string, code: string) => Promise<void>;
     /** Resolve identity from an OAuth callback (?auth_data=…) and deploy. */
     handleCallback: (authData: string) => Promise<void>;
-    /** Execute a sponsored (gasless) multicall, signed by the device key. */
+    /** Execute a sponsored (gasless) multicall, signed by the device key (Starknet). */
     execute: (calls: ChainCall[]) => Promise<{
         transactionHash: string;
     }>;
@@ -95,34 +102,59 @@ interface CavosContextValue {
     /** Re-request the device-approval email for the current pending request. */
     resendDeviceApproval: () => Promise<void>;
     /**
-     * Register a backup signer derived from `code` on the current account
-     * (gasless). The code is generated by the kit and shown to the user once.
-     * Resolves with the code so the caller can display it.
+     * Enroll a passkey as an approver (2FA-style step-up). Requires a ready device;
+     * returns the passkey's public key.
+     */
+    enrollPasskey: (passkey: PasskeySigner, params: PasskeyEnrollParams) => Promise<{
+        publicKey: {
+            x: bigint;
+            y: bigint;
+        };
+        transactionHash?: string;
+    }>;
+    /** Whether this device can use a platform passkey (Face ID / Touch ID / PIN). */
+    passkeySupported: boolean;
+    /**
+     * Modal-friendly wrapper: enroll a synced passkey as an approver using the
+     * signed-in user's identity + the app name. Requires a ready device.
+     */
+    enrollPasskeyDefault: () => Promise<void>;
+    /**
+     * Modal-friendly wrapper for the new-device flow: prompt the user's synced
+     * passkey to approve THIS device, then refresh to a ready state. Sponsored by
+     * the default paymaster/relayer.
+     */
+    approveDeviceWithPasskey: () => Promise<void>;
+    /**
+     * Register a backup signer derived from a generated recovery code (gasless).
+     * Resolves with the code so the caller can display it once.
      */
     setupRecovery: () => Promise<string>;
     /**
-     * Recover access after losing every device. Requires the recovery code. Runs
-     * the full Cavos.recover flow and brings the provider to a ready state.
+     * Recover access after losing every device. Requires the recovery code. Brings
+     * the provider to a ready state.
      */
     recover: (code: string) => Promise<void>;
     logout: () => void;
 }
 interface CavosProviderProps {
+    /** A single chain config. The provider manages exactly one chain. */
     config: CavosConfig;
     modal?: CavosModalConfig;
     children: ReactNode;
 }
 /**
- * Drop-in Cavos provider. Wrap your app once; descendants call `useCavos()`.
+ * Drop-in Cavos provider for ONE chain. Wrap your app once; descendants call
+ * `useCavos()`.
  *
- *   <CavosProvider config={{ network: 'sepolia', appSalt, paymasterApiKey }}
- *                  modal={{ appName: 'My App', theme: 'dark', emailMode: 'otp' }}>
+ *   <CavosProvider config={{ chain: 'solana', network: 'testnet', appId, appSalt }}
+ *                  modal={{ appName: 'My App', theme: 'dark' }}>
  *     <App />
  *   </CavosProvider>
  *
  * Behind the scenes: login (social / email) resolves a stable identity, the kit
- * deploys a device-signer smart account gaslessly, and `execute()` submits
- * gasless multicalls signed silently by the browser's device key.
+ * deploys a device-signer smart account gaslessly, and the wallet handle submits
+ * gasless transactions signed silently by the browser's device key.
  */
 declare function CavosProvider({ config, modal, children }: CavosProviderProps): react.JSX.Element;
 declare function useCavos(): CavosContextValue;