@seams/wallet 0.6.2 → 0.7.1

package/dist/types/wallet/src/core/signingEngine/useCases/lifecycle.d.ts

@@ -1,758 +0,0 @@
-import type { CredentialIdB64u, EcdsaProvisioningState, EcdsaRoleLocalReadyRecord, EmailOtpWorkerIssuedSessionHandle, RelayerKeyId } from '../../platform';
-import type { AccountId } from '../../types/accountIds';
-import type { EvmEip155ChainTarget, TempoChainTarget, ThresholdEcdsaChainTarget, WalletId } from '../interfaces/ecdsaChainTarget';
-import type { NearDelegateActionPayload, NearDelegateActionResult, NearNep413Payload, NearNep413Result, NearTransactionWithActionsPayload, NearTransactionWithActionsResult } from '../interfaces/near';
-import type { EvmAddress, EvmSigningRequest, Hex } from '../chains/evm/evmSigning.types';
-import type { TempoSigningRequest } from '../chains/tempo/tempoSigning.types';
-import type { EmailOtpAuthSubjectId } from '../session/identity/emailOtpEcdsaDerivationIdentity';
-import type { RpId } from '../session/identity/evmFamilyEcdsaIdentity';
-import type { EmailOtpChallengeId, SigningOperationId, ThresholdSessionId } from '../session/operationState/types';
-import type { MpcWalletSigningQuotaId, WalletSessionId } from '../../../../../shared-ts/src/authorization/capabilityKinds';
-export type NonEmptyReadonlyArray<T> = readonly [T, ...T[]];
-export type PositiveInt = number & {
-    readonly __brand: 'PositiveInt';
-};
-export type UnixTimeMs = number & {
-    readonly __brand: 'UnixTimeMs';
-};
-export type IdempotencyKey = string & {
-    readonly __brand: 'IdempotencyKey';
-};
-export type RestoreAttemptId = string & {
-    readonly __brand: 'RestoreAttemptId';
-};
-export type Ed25519RelayerKeyId = RelayerKeyId & {
-    readonly __curve: 'ed25519';
-};
-export type EcdsaRelayerKeyId = RelayerKeyId & {
-    readonly __curve: 'ecdsa';
-};
-export type WarmSessionRemainingUses = number & {
-    readonly __brand: 'WarmSessionRemainingUses';
-};
-export type UseCaseFailureSource = 'authenticator' | 'email_otp' | 'signer_crypto' | 'storage' | 'relayer' | 'http' | 'budget' | 'presign_pool' | 'clock' | 'random' | 'domain';
-export type UseCaseFailure<Code extends string> = {
-    ok: false;
-    code: Code;
-    source: UseCaseFailureSource;
-    message: string;
-    retryable: boolean;
-    cause?: unknown;
-    value?: never;
-};
-export declare function useCaseFailure<Code extends string>(input: {
-    code: Code;
-    source: UseCaseFailureSource;
-    message: string;
-    retryable: boolean;
-    cause?: unknown;
-}): UseCaseFailure<Code>;
-export declare function assertNeverUseCase(value: never): never;
-export type LifecycleTransitionTable<StateKind extends string> = {
-    readonly [Kind in StateKind]: readonly StateKind[];
-};
-export type LifecycleTransitionFromTable<T extends Record<string, readonly string[]>> = {
-    readonly [From in keyof T & string]: T[From][number] extends infer To ? To extends string ? {
-        readonly from: From;
-        readonly to: To;
-    } : never : never;
-}[keyof T & string];
-export type ConfiguredEcdsaTargets = {
-    kind: 'configured';
-    targets?: never;
-};
-export type ExplicitEcdsaTargets = {
-    kind: 'explicit';
-    targets: NonEmptyReadonlyArray<ThresholdEcdsaChainTarget>;
-};
-export type EcdsaTargetSelection = ConfiguredEcdsaTargets | ExplicitEcdsaTargets;
-export type ReadyEd25519Lane = {
-    kind: 'ed25519_ready_lane_v1';
-    walletId: WalletId;
-    rpId: RpId;
-    thresholdSessionId: ThresholdSessionId;
-    walletSessionId: WalletSessionId;
-    quotaId: MpcWalletSigningQuotaId;
-    relayerKeyId: Ed25519RelayerKeyId;
-    remainingUses: WarmSessionRemainingUses;
-    expiresAtMs: UnixTimeMs;
-    chainTarget?: never;
-    readyRecord?: never;
-};
-export type EcdsaUseCaseReadyLane = {
-    kind: 'ecdsa_ready_lane_v1';
-    walletId: WalletId;
-    evmFamilySigningKeySlotId?: never;
-    rpId: RpId;
-    chainTarget: ThresholdEcdsaChainTarget;
-    readyRecord: EcdsaRoleLocalReadyRecord;
-    relayerKeyId: EcdsaRelayerKeyId;
-    thresholdSessionId: ThresholdSessionId;
-    walletSessionId: WalletSessionId;
-    quotaId: MpcWalletSigningQuotaId;
-    remainingUses: WarmSessionRemainingUses;
-    expiresAtMs: UnixTimeMs;
-};
-export type ReauthRequiredLane = {
-    kind: 'ed25519_reauth_required_v1';
-    walletId: WalletId;
-    rpId: RpId;
-    reason: 'missing_auth' | 'expired_session' | 'stale_sealed_session' | 'malformed_record';
-    chainTarget?: never;
-} | {
-    kind: 'ecdsa_reauth_required_v1';
-    walletId: WalletId;
-    rpId: RpId;
-    chainTarget: ThresholdEcdsaChainTarget;
-    reason: 'missing_auth' | 'expired_session' | 'stale_sealed_session' | 'malformed_record' | 'missing_ready_material';
-};
-export type UseCaseWalletSessionReadiness = {
-    kind: 'ready';
-    walletId: WalletId;
-    ed25519: NonEmptyReadonlyArray<ReadyEd25519Lane>;
-    ecdsa: readonly EcdsaUseCaseReadyLane[];
-    reauthRequired?: never;
-} | {
-    kind: 'partial';
-    walletId: WalletId;
-    ed25519: readonly ReadyEd25519Lane[];
-    ecdsa: readonly EcdsaUseCaseReadyLane[];
-    reauthRequired: NonEmptyReadonlyArray<ReauthRequiredLane>;
-} | {
-    kind: 'reauth_required';
-    walletId: WalletId;
-    ed25519: readonly [];
-    ecdsa: readonly [];
-    reauthRequired: NonEmptyReadonlyArray<ReauthRequiredLane>;
-};
-export type ReadyWalletSessionReadiness = Extract<UseCaseWalletSessionReadiness, {
-    kind: 'ready';
-}>;
-export type WalletPreferenceWrite = {
-    kind: 'wallet_preference_write_v1';
-    walletId: WalletId;
-    rpId: RpId;
-};
-export type WalletSignerWrite = {
-    kind: 'ed25519_wallet_signer_write_v1';
-    lane: ReadyEd25519Lane;
-    ecdsa?: never;
-} | {
-    kind: 'ecdsa_wallet_signer_write_v1';
-    lane: EcdsaUseCaseReadyLane;
-    ed25519?: never;
-};
-export type WarmSessionBudgetSpend = {
-    kind: 'warm_session_budget_spend_v1';
-    walletId: WalletId;
-    walletSessionId: WalletSessionId;
-    quotaId: MpcWalletSigningQuotaId;
-    thresholdSessionId: ThresholdSessionId;
-    uses: PositiveInt;
-    remainingUses: WarmSessionRemainingUses;
-};
-export type AuthenticatorCreateRequest = {
-    kind: 'authenticator_create_request_v1';
-    challengeB64u: string;
-    userHandleB64u: string;
-};
-export type AuthenticatorGetRequest = {
-    kind: 'authenticator_get_request_v1';
-    challengeB64u: string;
-    credentialIdB64u: CredentialIdB64u;
-};
-export type WebAuthnUserHandle = string & {
-    readonly __brand: 'WebAuthnUserHandle';
-};
-export type WebAuthnCredentialId = CredentialIdB64u;
-export type EmailAddress = string & {
-    readonly __brand: 'EmailAddress';
-};
-export type EmailOtpCode = string & {
-    readonly __brand: 'EmailOtpCode';
-};
-export type RegisterWalletAuth = {
-    kind: 'passkey_registration';
-    credentialCreation: AuthenticatorCreateRequest;
-    userHandle: WebAuthnUserHandle;
-    email?: never;
-    otp?: never;
-} | {
-    kind: 'email_otp_registration';
-    email: EmailAddress;
-    challengeId: EmailOtpChallengeId;
-    otp: EmailOtpCode;
-    credentialCreation?: never;
-    userHandle?: never;
-};
-export type RegisterWalletInput = {
-    walletId: WalletId;
-    rpId: RpId;
-    auth: RegisterWalletAuth;
-    ecdsaTargets: EcdsaTargetSelection;
-    idempotencyKey: IdempotencyKey;
-};
-export type RegistrationReadyLanes = {
-    ed25519: ReadyEd25519Lane;
-    ecdsa: readonly EcdsaUseCaseReadyLane[];
-};
-export type RegisterWalletSuccess = {
-    ok: true;
-    walletId: WalletId;
-    readiness: ReadyWalletSessionReadiness;
-    lanes: RegistrationReadyLanes;
-    sealedWrites: NonEmptyReadonlyArray<SigningSessionSealWriteInput>;
-    walletPreferenceWrite: WalletPreferenceWrite;
-    walletSignerWrites: NonEmptyReadonlyArray<WalletSignerWrite>;
-    code?: never;
-    message?: never;
-    retryable?: never;
-};
-export type RegisterWalletFailureCode = 'authenticator_failed' | 'email_otp_failed' | 'wallet_id_collision' | 'registration_incomplete' | 'stale_identity_mapping' | 'signer_crypto_command_failed' | 'signer_crypto_invocation_failed' | 'relayer_failed' | 'storage_failed' | 'invalid_state';
-export type RegisterWalletResult = RegisterWalletSuccess | UseCaseFailure<RegisterWalletFailureCode>;
-export type RegisterWalletLifecycleState = ({
-    kind: 'received_input';
-} & RegisterWalletInput) | {
-    kind: 'authenticating';
-    walletId: WalletId;
-    rpId: RpId;
-    auth: RegisterWalletAuth;
-    ecdsaTargets: EcdsaTargetSelection;
-    idempotencyKey: IdempotencyKey;
-} | {
-    kind: 'provisioning_ed25519';
-    walletId: WalletId;
-    rpId: RpId;
-    auth: RegisterWalletAuth;
-    ecdsaTargets: EcdsaTargetSelection;
-    idempotencyKey: IdempotencyKey;
-} | {
-    kind: 'provisioning_ecdsa';
-    walletId: WalletId;
-    rpId: RpId;
-    auth: RegisterWalletAuth;
-    ecdsaTargets: EcdsaTargetSelection;
-    ed25519: ReadyEd25519Lane;
-    idempotencyKey: IdempotencyKey;
-} | {
-    kind: 'sealing_sessions';
-    walletId: WalletId;
-    rpId: RpId;
-    lanes: RegistrationReadyLanes;
-    idempotencyKey: IdempotencyKey;
-} | {
-    kind: 'persisting_wallet';
-    walletId: WalletId;
-    readiness: ReadyWalletSessionReadiness;
-    lanes: RegistrationReadyLanes;
-    sealedWrites: NonEmptyReadonlyArray<SigningSessionSealWriteInput>;
-    idempotencyKey: IdempotencyKey;
-} | ({
-    kind: 'ready';
-} & RegisterWalletSuccess) | ({
-    kind: 'failed';
-    value?: never;
-} & UseCaseFailure<RegisterWalletFailureCode>);
-export type UnlockWalletAuth = {
-    kind: 'passkey_unlock';
-    credentialId: WebAuthnCredentialId;
-    assertionRequest: AuthenticatorGetRequest;
-    challengeId?: never;
-    otp?: never;
-} | {
-    kind: 'email_otp_unlock';
-    challengeId: EmailOtpChallengeId;
-    otp: EmailOtpCode;
-    credentialId?: never;
-    assertionRequest?: never;
-};
-export type UnlockWalletInput = {
-    walletId: WalletId;
-    rpId: RpId;
-    auth: UnlockWalletAuth;
-    ecdsaTargets: EcdsaTargetSelection;
-    idempotencyKey: IdempotencyKey;
-};
-export type UnlockWalletSuccess = {
-    ok: true;
-    walletId: WalletId;
-    readiness: UseCaseWalletSessionReadiness;
-    restored: readonly (ReadyEd25519Lane | EcdsaUseCaseReadyLane)[];
-    provisioned: readonly EcdsaUseCaseReadyLane[];
-    sealedWrites: NonEmptyReadonlyArray<SigningSessionSealWriteInput>;
-    code?: never;
-    message?: never;
-    retryable?: never;
-};
-export type UnlockWalletFailureCode = 'missing_auth' | 'authenticator_failed' | 'email_otp_failed' | 'session_expired' | 'stale_sealed_session' | 'storage_cleanup_failed' | 'signer_crypto_command_failed' | 'signer_crypto_invocation_failed' | 'relayer_failed' | 'budget_exhausted' | 'invalid_state';
-export type UnlockWalletResult = UnlockWalletSuccess | UseCaseFailure<UnlockWalletFailureCode>;
-export type UnlockWalletLifecycleState = ({
-    kind: 'received_input';
-} & UnlockWalletInput) | {
-    kind: 'authenticating';
-    walletId: WalletId;
-    rpId: RpId;
-    auth: UnlockWalletAuth;
-    ecdsaTargets: EcdsaTargetSelection;
-    idempotencyKey: IdempotencyKey;
-} | {
-    kind: 'restoring_sessions';
-    walletId: WalletId;
-    rpId: RpId;
-    auth: UnlockWalletAuth;
-    ecdsaTargets: EcdsaTargetSelection;
-    idempotencyKey: IdempotencyKey;
-} | {
-    kind: 'provisioning_missing_ecdsa';
-    walletId: WalletId;
-    rpId: RpId;
-    restored: readonly (ReadyEd25519Lane | EcdsaUseCaseReadyLane)[];
-    ecdsaTargets: EcdsaTargetSelection;
-    idempotencyKey: IdempotencyKey;
-} | {
-    kind: 'sealing_sessions';
-    walletId: WalletId;
-    restored: readonly (ReadyEd25519Lane | EcdsaUseCaseReadyLane)[];
-    provisioned: readonly EcdsaUseCaseReadyLane[];
-    idempotencyKey: IdempotencyKey;
-} | {
-    kind: 'ready';
-    result: UnlockWalletSuccess;
-    failed?: never;
-} | ({
-    kind: 'failed';
-    result?: never;
-} & UseCaseFailure<UnlockWalletFailureCode>);
-export type SigningSessionActivationPasskeyAuth = {
-    kind: 'passkey';
-    walletId: WalletId;
-    rpId: RpId;
-    credentialIdB64u: CredentialIdB64u;
-    authSubjectId?: never;
-    workerHandle?: never;
-};
-export type SigningSessionActivationEmailOtpEd25519Auth = {
-    kind: 'email_otp';
-    walletId: WalletId;
-    rpId: RpId;
-    authSubjectId: EmailOtpAuthSubjectId;
-    workerHandle: Extract<EmailOtpWorkerIssuedSessionHandle, {
-        action: 'threshold_ed25519_session';
-    }>;
-    credentialIdB64u?: never;
-    evmFamilySigningKeySlotId?: never;
-};
-export type SigningSessionActivationEmailOtpEcdsaAuth = {
-    kind: 'email_otp';
-    walletId: WalletId;
-    evmFamilySigningKeySlotId?: never;
-    authSubjectId: EmailOtpAuthSubjectId;
-    workerHandle: Extract<EmailOtpWorkerIssuedSessionHandle, {
-        action: 'threshold_ecdsa_bootstrap';
-    }>;
-    rpId?: never;
-    credentialIdB64u?: never;
-};
-export type SigningSessionActivationEmailOtpAuth = SigningSessionActivationEmailOtpEd25519Auth | SigningSessionActivationEmailOtpEcdsaAuth;
-export type SigningSessionActivationAuth = SigningSessionActivationPasskeyAuth | SigningSessionActivationEmailOtpAuth;
-export type SigningSessionActivationMaterial = {
-    kind: 'ed25519_session';
-    thresholdSessionId: ThresholdSessionId;
-    relayerKeyId: Ed25519RelayerKeyId;
-    record?: never;
-} | {
-    kind: 'ecdsa_session';
-    thresholdSessionId: ThresholdSessionId;
-    record: EcdsaRoleLocalReadyRecord;
-    relayerKeyId?: never;
-};
-export type SigningSessionSealWriteInput = {
-    kind: 'passkey_ed25519_seal_write_v1';
-    auth: SigningSessionActivationPasskeyAuth;
-    material: Extract<SigningSessionActivationMaterial, {
-        kind: 'ed25519_session';
-    }>;
-    expiresAtMs: UnixTimeMs;
-    remainingUses: WarmSessionRemainingUses;
-} | {
-    kind: 'passkey_ecdsa_seal_write_v1';
-    auth: SigningSessionActivationPasskeyAuth;
-    material: Extract<SigningSessionActivationMaterial, {
-        kind: 'ecdsa_session';
-    }>;
-    expiresAtMs: UnixTimeMs;
-    remainingUses: WarmSessionRemainingUses;
-} | {
-    kind: 'email_otp_ed25519_seal_write_v1';
-    auth: SigningSessionActivationEmailOtpEd25519Auth;
-    material: Extract<SigningSessionActivationMaterial, {
-        kind: 'ed25519_session';
-    }>;
-    expiresAtMs: UnixTimeMs;
-    remainingUses: WarmSessionRemainingUses;
-} | {
-    kind: 'email_otp_ecdsa_seal_write_v1';
-    auth: SigningSessionActivationEmailOtpEcdsaAuth;
-    material: Extract<SigningSessionActivationMaterial, {
-        kind: 'ecdsa_session';
-    }>;
-    expiresAtMs: UnixTimeMs;
-    remainingUses: WarmSessionRemainingUses;
-};
-export type SignEvmFamilyAuthPolicy = {
-    kind: 'warm_session_only';
-    auth?: never;
-} | {
-    kind: 'warm_session_or_same_method_step_up';
-    auth: SigningSessionActivationAuth;
-};
-export type SignEvmFamilyInput = {
-    kind: 'evm_transaction';
-    operationId: SigningOperationId;
-    walletId: WalletId;
-    rpId: RpId;
-    chainTarget: EvmEip155ChainTarget;
-    request: EvmSigningRequest;
-    authPolicy: SignEvmFamilyAuthPolicy;
-} | {
-    kind: 'tempo_transaction';
-    operationId: SigningOperationId;
-    walletId: WalletId;
-    rpId: RpId;
-    chainTarget: TempoChainTarget;
-    request: TempoSigningRequest;
-    authPolicy: SignEvmFamilyAuthPolicy;
-};
-export type EvmSignature = {
-    kind: 'ecdsa_secp256k1_signature_v1';
-    signatureHex: Hex;
-};
-export type TempoTransactionHash = Hex & {
-    readonly __brand: 'TempoTransactionHash';
-};
-type SignEvmFamilySuccessBase = {
-    ok: true;
-    walletId: WalletId;
-    usedAuth: 'warm_session' | 'same_method_step_up';
-    signerLane: EcdsaUseCaseReadyLane;
-    budgetSpend: WarmSessionBudgetSpend;
-    code?: never;
-    message?: never;
-    retryable?: never;
-};
-export type SignEvmFamilySuccess = (SignEvmFamilySuccessBase & {
-    kind: 'evm_transaction';
-    chainTarget: EvmEip155ChainTarget;
-    result: {
-        kind: 'evm_signature';
-        signature: EvmSignature;
-        nonceSender: EvmAddress;
-    };
-}) | (SignEvmFamilySuccessBase & {
-    kind: 'tempo_transaction';
-    chainTarget: TempoChainTarget;
-    result: {
-        kind: 'tempo_submission';
-        signature: EvmSignature;
-        nonceSender: EvmAddress;
-        transactionHash: TempoTransactionHash;
-    };
-});
-export type SignEvmFamilyFailureCode = 'missing_ready_ecdsa_material' | 'auth_mismatch' | 'budget_exhausted' | 'relayer_failed' | 'signer_failed' | 'ambiguous_signer_selection' | 'nonce_sender_unavailable' | 'chain_target_mismatch' | 'invalid_state';
-export type SignEvmFamilyResult = SignEvmFamilySuccess | UseCaseFailure<SignEvmFamilyFailureCode>;
-export type SignEvmFamilyLifecycleState = {
-    kind: 'received_input';
-    input: SignEvmFamilyInput;
-} | {
-    kind: 'resolving_ready_lane';
-    input: SignEvmFamilyInput;
-} | {
-    kind: 'activating_same_method_session';
-    input: SignEvmFamilyInput;
-    staleLane: EcdsaUseCaseReadyLane | ReauthRequiredLane;
-} | {
-    kind: 'reserving_budget';
-    input: SignEvmFamilyInput;
-    lane: EcdsaUseCaseReadyLane;
-} | {
-    kind: 'signing';
-    input: SignEvmFamilyInput;
-    lane: EcdsaUseCaseReadyLane;
-    budgetSpend: WarmSessionBudgetSpend;
-} | {
-    kind: 'signed';
-    result: SignEvmFamilySuccess;
-    failed?: never;
-} | ({
-    kind: 'failed';
-    result?: never;
-} & UseCaseFailure<SignEvmFamilyFailureCode>);
-export type NearTransactionDigest = string & {
-    readonly __brand: 'NearTransactionDigest';
-};
-export type Nep413Digest = string & {
-    readonly __brand: 'Nep413Digest';
-};
-export type NearDelegateActionDigest = string & {
-    readonly __brand: 'NearDelegateActionDigest';
-};
-export type Nep413Scope = string & {
-    readonly __brand: 'Nep413Scope';
-};
-export type NearDelegateActionScope = string & {
-    readonly __brand: 'NearDelegateActionScope';
-};
-export type SignNearAuthPolicy = {
-    kind: 'warm_session_only';
-    auth?: never;
-} | {
-    kind: 'warm_session_or_same_method_step_up';
-    auth: SigningSessionActivationAuth;
-};
-export type SignNearInput = {
-    kind: 'transaction_with_actions';
-    operationId: SigningOperationId;
-    walletId: WalletId;
-    rpId: RpId;
-    accountId: AccountId;
-    request: NearTransactionWithActionsPayload;
-    transactionDigests: NonEmptyReadonlyArray<NearTransactionDigest>;
-    requiredSignatureUses: PositiveInt;
-    authPolicy: SignNearAuthPolicy;
-} | {
-    kind: 'nep413_message';
-    operationId: SigningOperationId;
-    walletId: WalletId;
-    rpId: RpId;
-    accountId: AccountId;
-    request: NearNep413Payload;
-    digest: Nep413Digest;
-    scope: Nep413Scope;
-    authPolicy: SignNearAuthPolicy;
-} | {
-    kind: 'delegate_action';
-    operationId: SigningOperationId;
-    walletId: WalletId;
-    rpId: RpId;
-    accountId: AccountId;
-    request: NearDelegateActionPayload;
-    digest: NearDelegateActionDigest;
-    scope: NearDelegateActionScope;
-    authPolicy: SignNearAuthPolicy;
-};
-type SignNearSuccessBase = {
-    ok: true;
-    walletId: WalletId;
-    accountId: AccountId;
-    usedAuth: 'warm_session' | 'same_method_step_up';
-    signerLane: ReadyEd25519Lane;
-    signingPath: 'presign_pool' | 'two_rtt_fallback' | 'same_method_step_up';
-    budgetSpend: WarmSessionBudgetSpend;
-    code?: never;
-    message?: never;
-    retryable?: never;
-};
-export type SignNearSuccess = (SignNearSuccessBase & {
-    kind: 'transaction_with_actions';
-    transactionDigests: NonEmptyReadonlyArray<NearTransactionDigest>;
-    result: {
-        kind: 'near_transaction_with_actions';
-        signed: NearTransactionWithActionsResult;
-    };
-}) | (SignNearSuccessBase & {
-    kind: 'nep413_message';
-    digest: Nep413Digest;
-    scope: Nep413Scope;
-    result: {
-        kind: 'nep413_message';
-        signedMessage: NearNep413Result;
-    };
-}) | (SignNearSuccessBase & {
-    kind: 'delegate_action';
-    digest: NearDelegateActionDigest;
-    scope: NearDelegateActionScope;
-    result: {
-        kind: 'near_delegate_action';
-        signedDelegate: NearDelegateActionResult;
-    };
-});
-export type SignNearFailureCode = 'missing_ready_ed25519_material' | 'budget_exhausted' | 'presign_pool_failed' | 'relayer_failed' | 'digest_mismatch' | 'scope_mismatch' | 'ambiguous_lane_selection' | 'step_up_required' | 'dispatch_ambiguous' | 'invalid_state';
-export type SignNearResult = SignNearSuccess | UseCaseFailure<SignNearFailureCode>;
-export type SignNearLifecycleState = {
-    kind: 'received_input';
-    input: SignNearInput;
-} | {
-    kind: 'resolving_ready_lane';
-    input: SignNearInput;
-} | {
-    kind: 'validating_request';
-    input: SignNearInput;
-    lane: ReadyEd25519Lane;
-} | {
-    kind: 'reserving_budget';
-    input: SignNearInput;
-    lane: ReadyEd25519Lane;
-} | {
-    kind: 'signing';
-    input: SignNearInput;
-    lane: ReadyEd25519Lane;
-    budgetSpend: WarmSessionBudgetSpend;
-} | {
-    kind: 'signed';
-    result: SignNearSuccess;
-    failed?: never;
-} | ({
-    kind: 'failed';
-    result?: never;
-} & UseCaseFailure<SignNearFailureCode>);
-export type RestorePersistedSessionAuth = {
-    kind: 'passkey';
-    credentialId: WebAuthnCredentialId;
-    authSubjectId?: never;
-} | {
-    kind: 'email_otp';
-    authSubjectId: EmailOtpAuthSubjectId;
-    credentialId?: never;
-} | {
-    kind: 'missing_auth';
-    credentialId?: never;
-    authSubjectId?: never;
-};
-export type RestorePersistedSessionRequest = {
-    kind: 'ed25519';
-    chainTarget?: never;
-} | {
-    kind: 'ecdsa';
-    chainTarget: ThresholdEcdsaChainTarget;
-};
-export type RestorePersistedSessionsInput = {
-    restoreAttemptId: RestoreAttemptId;
-    walletId: WalletId;
-    rpId: RpId;
-    auth: RestorePersistedSessionAuth;
-    requested: NonEmptyReadonlyArray<RestorePersistedSessionRequest>;
-    ecdsaTargets: EcdsaTargetSelection;
-    reason: 'page_load' | 'session_status' | 'pre_sign' | 'manual_refresh';
-};
-export type RestorePersistedSessionCleanup = {
-    kind: 'cleanup_required';
-    walletId: WalletId;
-    rpId: RpId;
-    target: RestorePersistedSessionRequest;
-    reason: 'malformed_record' | 'expired_record' | 'incompatible_record' | 'seal_mismatch';
-};
-export type RestorePersistedSessionsSuccess = {
-    ok: true;
-    walletId: WalletId;
-    readiness: UseCaseWalletSessionReadiness;
-    restored: readonly (ReadyEd25519Lane | EcdsaUseCaseReadyLane)[];
-    reauthRequired: readonly ReauthRequiredLane[];
-    cleanup: readonly RestorePersistedSessionCleanup[];
-    code?: never;
-    message?: never;
-    retryable?: never;
-};
-export type RestorePersistedSessionsFailureCode = 'stale_persistence' | 'unavailable_storage' | 'seal_failed' | 'incompatible_record' | 'malformed_record' | 'cleanup_failed' | 'invalid_state';
-export type RestorePersistedSessionsResult = RestorePersistedSessionsSuccess | UseCaseFailure<RestorePersistedSessionsFailureCode>;
-export type RestorePersistedSessionsLifecycleState = ({
-    kind: 'received_input';
-} & RestorePersistedSessionsInput) | {
-    kind: 'reading_persistence';
-    input: RestorePersistedSessionsInput;
-} | {
-    kind: 'classifying_material';
-    input: RestorePersistedSessionsInput;
-    material: readonly (ReadyEd25519Lane | EcdsaUseCaseReadyLane | ReauthRequiredLane)[];
-} | {
-    kind: 'cleaning_stale_records';
-    input: RestorePersistedSessionsInput;
-    cleanup: NonEmptyReadonlyArray<RestorePersistedSessionCleanup>;
-} | {
-    kind: 'ready';
-    result: RestorePersistedSessionsSuccess;
-    failed?: never;
-} | ({
-    kind: 'failed';
-    result?: never;
-} & UseCaseFailure<RestorePersistedSessionsFailureCode>);
-export type EcdsaProvisioningStateKind = EcdsaProvisioningState['kind'];
-export type RegisterWalletLifecycleStateKind = RegisterWalletLifecycleState['kind'];
-export type UnlockWalletLifecycleStateKind = UnlockWalletLifecycleState['kind'];
-export type SignEvmFamilyLifecycleStateKind = SignEvmFamilyLifecycleState['kind'];
-export type SignNearLifecycleStateKind = SignNearLifecycleState['kind'];
-export type RestorePersistedSessionsLifecycleStateKind = RestorePersistedSessionsLifecycleState['kind'];
-export declare const ecdsaProvisioningAllowedTransitions: {
-    readonly needs_secret_source: readonly ["preparing_client_bootstrap", "failed"];
-    readonly preparing_client_bootstrap: readonly ["awaiting_relayer_identity", "failed"];
-    readonly awaiting_relayer_identity: readonly ["finalizing_ready_state", "failed"];
-    readonly finalizing_ready_state: readonly ["persisting_ready_record", "failed"];
-    readonly persisting_ready_record: readonly ["ready", "failed"];
-    readonly ready: readonly [];
-    readonly failed: readonly [];
-};
-export declare const registerWalletAllowedTransitions: {
-    readonly received_input: readonly ["authenticating", "failed"];
-    readonly authenticating: readonly ["provisioning_ed25519", "failed"];
-    readonly provisioning_ed25519: readonly ["provisioning_ecdsa", "failed"];
-    readonly provisioning_ecdsa: readonly ["sealing_sessions", "failed"];
-    readonly sealing_sessions: readonly ["persisting_wallet", "failed"];
-    readonly persisting_wallet: readonly ["ready", "failed"];
-    readonly ready: readonly [];
-    readonly failed: readonly [];
-};
-export declare const unlockWalletAllowedTransitions: {
-    readonly received_input: readonly ["authenticating", "failed"];
-    readonly authenticating: readonly ["restoring_sessions", "failed"];
-    readonly restoring_sessions: readonly ["provisioning_missing_ecdsa", "sealing_sessions", "ready", "failed"];
-    readonly provisioning_missing_ecdsa: readonly ["sealing_sessions", "failed"];
-    readonly sealing_sessions: readonly ["ready", "failed"];
-    readonly ready: readonly [];
-    readonly failed: readonly [];
-};
-export declare const signEvmFamilyAllowedTransitions: {
-    readonly received_input: readonly ["resolving_ready_lane", "failed"];
-    readonly resolving_ready_lane: readonly ["activating_same_method_session", "reserving_budget", "failed"];
-    readonly activating_same_method_session: readonly ["reserving_budget", "failed"];
-    readonly reserving_budget: readonly ["signing", "failed"];
-    readonly signing: readonly ["signed", "failed"];
-    readonly signed: readonly [];
-    readonly failed: readonly [];
-};
-export declare const signNearAllowedTransitions: {
-    readonly received_input: readonly ["resolving_ready_lane", "failed"];
-    readonly resolving_ready_lane: readonly ["validating_request", "failed"];
-    readonly validating_request: readonly ["reserving_budget", "failed"];
-    readonly reserving_budget: readonly ["signing", "failed"];
-    readonly signing: readonly ["signed", "failed"];
-    readonly signed: readonly [];
-    readonly failed: readonly [];
-};
-export declare const restorePersistedSessionsAllowedTransitions: {
-    readonly received_input: readonly ["reading_persistence", "failed"];
-    readonly reading_persistence: readonly ["classifying_material", "failed"];
-    readonly classifying_material: readonly ["cleaning_stale_records", "ready", "failed"];
-    readonly cleaning_stale_records: readonly ["ready", "failed"];
-    readonly ready: readonly [];
-    readonly failed: readonly [];
-};
-export type EcdsaProvisioningTransition = LifecycleTransitionFromTable<typeof ecdsaProvisioningAllowedTransitions>;
-export type RegisterWalletTransition = LifecycleTransitionFromTable<typeof registerWalletAllowedTransitions>;
-export type UnlockWalletTransition = LifecycleTransitionFromTable<typeof unlockWalletAllowedTransitions>;
-export type SignEvmFamilyTransition = LifecycleTransitionFromTable<typeof signEvmFamilyAllowedTransitions>;
-export type SignNearTransition = LifecycleTransitionFromTable<typeof signNearAllowedTransitions>;
-export type RestorePersistedSessionsTransition = LifecycleTransitionFromTable<typeof restorePersistedSessionsAllowedTransitions>;
-export declare const ecdsaProvisioningTerminalStates: readonly ["ready", "failed"];
-export declare const registerWalletTerminalStates: readonly ["ready", "failed"];
-export declare const unlockWalletTerminalStates: readonly ["ready", "failed"];
-export declare const signEvmFamilyTerminalStates: readonly ["signed", "failed"];
-export declare const signNearTerminalStates: readonly ["signed", "failed"];
-export declare const restorePersistedSessionsTerminalStates: readonly ["ready", "failed"];
-export declare const ecdsaProvisioningRetryableFailureCodes: readonly ["authenticator_failed", "signer_crypto_invocation_failed", "relayer_failed", "storage_failed"];
-export declare const registerWalletRetryableFailureCodes: readonly ["authenticator_failed", "email_otp_failed", "signer_crypto_invocation_failed", "relayer_failed", "storage_failed"];
-export declare const unlockWalletRetryableFailureCodes: readonly ["authenticator_failed", "email_otp_failed", "signer_crypto_invocation_failed", "relayer_failed", "storage_cleanup_failed"];
-export declare const signEvmFamilyRetryableFailureCodes: readonly ["relayer_failed", "signer_failed", "nonce_sender_unavailable"];
-export declare const signNearRetryableFailureCodes: readonly ["presign_pool_failed", "relayer_failed"];
-export declare const restorePersistedSessionsRetryableFailureCodes: readonly ["unavailable_storage", "seal_failed", "cleanup_failed"];
-export declare function assertNeverUseCaseLifecycle(value: never): never;
-export {};
-//# sourceMappingURL=lifecycle.d.ts.map