Client MFA, faucet, and session types

Input and result shapes for login-time MFA, faucet, and settled-session operations.

These shapes are part of the documented Para SDK surface.

Import

import type { VerifyMfaParams, EnrollMfaParams, TwoFactorEnrollResponse, VerifyMfaResult, RequestFaucetParams } from "@getpara/web-sdk";

Login-time MFA

type VerifyMfaParams = { code: string };
type EnrollMfaParams = { method?: "totp" };
type TwoFactorEnrollResponse =
  | { method: "totp"; uri: string; backupCodes: string[] }
  | { method: "passkey"; challenge: string }
  | { method: "passkey" | "password" | "pin"; ok: true; factorId: string };
type VerifyMfaResult = { ok: true } | { ok: false; attemptsRemaining?: number };

This page shows the TOTP member of EnrollMfaParams. Its passkey, password, and PIN members enroll credential second factors, which is why TwoFactorEnrollResponse is keyed on method. Check method === "totp" before reading uri, an otpauth URI for an authenticator app. Show backupCodes exactly once at enrollment.

Faucet and session export

interface RequestFaucetParams { walletId: string; chain?: string; }
interface RequestFaucetResponse {
  transactionHash: string; amount: string; chain: string; walletId: string; address: string;
}
type WaitAndExportSessionParams = { excludeSigners?: boolean };
type WaitAndExportSessionResponse = string;