@seams/wallet 0.9.0 → 0.9.1

package/dist/types/wallet/src/core/signingEngine/flows/signNear/shared/ed25519YaoNormalSigning.d.ts

@@ -78,7 +78,7 @@ type Ed25519PrepareSessionResult = Awaited<ReturnType<typeof prepareRouterAbNorm
  * digest the dialog shows and to the signing digest, so the signature after
  * the confirmation can only use it for the same operation.
  */
-export type RouterAbEd25519SignatureOnlyStartedPrepare = {
+export type RouterAbEd25519StartedPrepare = {
     readonly prepare: RouterAbNormalSigningPrepareRequestV2BuildResult;
     readonly displayDigest: string;
     readonly signingDigestB64u: string;
@@ -103,7 +103,7 @@ type RouterAbEd25519SignatureOnlyNormalSigningArgs = RouterAbEd25519SignatureOnl
     authorization: {
         kind: 'reusable_wallet_session';
     };
-    startedPrepare?: RouterAbEd25519SignatureOnlyStartedPrepare;
+    startedPrepare?: RouterAbEd25519StartedPrepare;
 } | {
     materialFacts: NearEd25519YaoOperationMaterialFacts;
     walletSessionState?: never;
@@ -163,9 +163,9 @@ type RouterAbEd25519SignatureOnlyWarmArgs = RouterAbEd25519SignatureOnlyNormalSi
  * signature; a result that is never passed on expires with its lease and
  * keeps the quota use it claimed.
  */
-export declare function startRouterAbEd25519SignatureOnlyPrepare(args: RouterAbEd25519SignatureOnlyWarmArgs): Promise<RouterAbEd25519SignatureOnlyStartedPrepare | null>;
+export declare function startRouterAbEd25519SignatureOnlyPrepare(args: RouterAbEd25519SignatureOnlyWarmArgs): Promise<RouterAbEd25519StartedPrepare | null>;
 /** Leaves a started prepare to expire with its lease. */
-export declare function abandonRouterAbEd25519StartedPrepare(started: RouterAbEd25519SignatureOnlyStartedPrepare): void;
+export declare function abandonRouterAbEd25519StartedPrepare(started: RouterAbEd25519StartedPrepare): void;
 export declare function prepareRouterAbEd25519NearTransactionOperationStepUp(args: {
     ctx: NearSigningRuntimeDeps;
     thresholdSessionId: string;
@@ -202,10 +202,12 @@ type RouterAbEd25519NearTransactionNormalSigningArgs = RouterAbEd25519NearTransa
     authorization: {
         kind: 'reusable_wallet_session';
     };
+    startedPrepare?: RouterAbEd25519StartedPrepare | null;
 } | {
     materialFacts: NearEd25519YaoOperationMaterialFacts;
     walletSessionState?: never;
     sessionCoordinator?: never;
+    startedPrepare?: never;
     authorization: {
         kind: 'operation_step_up';
         prepared: Extract<PreparedNearOperationStepUp, {
@@ -216,6 +218,16 @@ type RouterAbEd25519NearTransactionNormalSigningArgs = RouterAbEd25519NearTransa
         issuedAuthorization: NearEd25519OperationStepUpAuthorization | null;
     };
 });
+type RouterAbEd25519NearTransactionWarmPrepareArgs = Pick<RouterAbEd25519NearTransactionNormalSigningBase, 'activeClient' | 'walletId' | 'operationId' | 'displayDigest' | 'nearAccountId'> & {
+    walletSessionState: AuthorizedRouterAbEd25519WalletSessionState;
+};
+/**
+ * Sends the prepare of a warm-session transaction while the confirmation
+ * dialog is open. The transaction context is the one the dialog reserved.
+ */
+export declare function startRouterAbEd25519NearTransactionPrepare(args: RouterAbEd25519NearTransactionWarmPrepareArgs & Pick<RouterAbEd25519NearTransactionNormalSigningBase, 'ctx' | 'thresholdSessionId' | 'thresholdKeyMaterial' | 'txSigningRequest'> & {
+    transactionContext: TransactionContext;
+}): Promise<RouterAbEd25519StartedPrepare>;
 export declare function tryFinalizeRouterAbEd25519NearTransactionNormalSigning(args: RouterAbEd25519NearTransactionNormalSigningArgs): Promise<RouterAbEd25519NearTransactionNormalSigningResult | null>;
 export {};
 //# sourceMappingURL=ed25519YaoNormalSigning.d.ts.map

package/dist/types/wallet/src/core/signingEngine/flows/signNear/shared/signatureOnlySigning.d.ts

@@ -15,7 +15,7 @@ import { type ConfirmSignatureOnlySigningOperationRequest, type ConfirmSignature
 import { type NearPreparedStepUpAuth } from '../requireNearStepUpAuth';
 import { type PreparedNearOperationStepUp } from './operationStepUpPreparation';
 import { resolveConfirmedNearEd25519YaoCapability, type NearOperationStepUpMaterial, type ResolvedNearOperationStepUpMaterial } from './ed25519YaoCapabilityResolution';
-import { type RouterAbEd25519SignatureOnlyIntentWire, type RouterAbEd25519SignatureOnlyStartedPrepare } from './ed25519YaoNormalSigning';
+import { type RouterAbEd25519SignatureOnlyIntentWire, type RouterAbEd25519StartedPrepare } from './ed25519YaoNormalSigning';
 /** One delegate-action or NEP-413 signing operation, fixed before its step-up starts. */
 export type NearSignatureOnlyOperation = {
     /** Names the operation in error messages. */
@@ -63,7 +63,7 @@ type NearSignatureOnlySigningMaterial = {
     thresholdSessionId: ThresholdEd25519SessionId;
     displayDigest: string;
     resolved: Awaited<ReturnType<typeof resolveConfirmedNearEd25519YaoCapability>>;
-    startedPrepare?: RouterAbEd25519SignatureOnlyStartedPrepare;
+    startedPrepare?: RouterAbEd25519StartedPrepare;
 } | {
     kind: 'operation_step_up';
     thresholdSessionId: ThresholdEd25519SessionId;
@@ -117,7 +117,7 @@ export declare function authorizeNearSignatureOnlyOperation(operation: NearSigna
 /** A prepare that left while the confirmation dialog was open. */
 export type NearSignatureOnlyStartedPrepare = {
     readonly resolved: Awaited<ReturnType<typeof resolveConfirmedNearEd25519YaoCapability>>;
-    readonly started: RouterAbEd25519SignatureOnlyStartedPrepare;
+    readonly started: RouterAbEd25519StartedPrepare;
 };
 /**
  * Sends the server prepare of a warm-session NEP-413 signature while the

package/dist/types/wallet/src/core/signingEngine/nonce/nearTransactionReadiness.d.ts

@@ -22,5 +22,8 @@ export type NearTransactionReadiness = ExclusiveUnion<{
     kind: 'funding_required';
     request: NearFundingRequest;
 }>;
+export type NearTransactionContextReady = Extract<NearTransactionReadiness, {
+    kind: 'context_ready';
+}>;
 export {};
 //# sourceMappingURL=nearTransactionReadiness.d.ts.map

package/dist/types/wallet/src/core/signingEngine/stepUpConfirmation/confirmOperation.d.ts

@@ -3,13 +3,14 @@ import type { RpcCallPayload, ConfirmationConfig } from '../../types/signer-work
 import type { EmailOtpConfirmPrompt, SigningAuthPlan, UserConfirmProgressEvent } from './types';
 import type { SerializableCredential, UserConfirmDecision, UserConfirmRequest, WebAuthnChallenge } from './channel/confirmTypes';
 import type { TxDisplayModel } from '../interfaces/display';
-import type { NearFundingRequest, NearTransactionReadiness } from '../nonce/nearTransactionReadiness';
+import type { NearFundingRequest, NearTransactionContextReady, NearTransactionReadiness } from '../nonce/nearTransactionReadiness';
 import type { NearOperationStepUpPreparationRef } from '../interfaces/operationStepUpPreparation';
 import type { SigningOperationConfirmationStateKind, SigningOperationInteractionEvent } from '../flows/shared/signingStateMachine';
 type SigningConfirmationChain = 'near' | 'evm' | 'tempo';
 export type RequestUserConfirmationBridge = (request: UserConfirmRequest, options?: {
     onProgress?: (progress: UserConfirmProgressEvent) => void;
     onSigningOperationInteractionEvent?: (event: SigningOperationInteractionEvent) => void;
+    onNearTransactionContextReady?: (readiness: NearTransactionContextReady) => void;
 }) => Promise<UserConfirmDecision>;
 export type UiConfirmRequestBridgeContext = {
     touchConfirm: {
@@ -74,6 +75,7 @@ type OrchestrateNearTransactionSigningConfirmationBaseParams = OrchestrateSignin
     nearFundingRequest: NearFundingRequest;
     signingOperationStateKind: SigningOperationConfirmationStateKind;
     onSigningOperationInteractionEvent: (event: SigningOperationInteractionEvent) => void;
+    onNearTransactionContextReady?: (readiness: NearTransactionContextReady) => void;
     title?: string;
     body?: string;
 };

package/dist/types/wallet/src/core/signingEngine/uiConfirm/handlers/flows/signing.d.ts

@@ -1,6 +1,7 @@
 import type { UiConfirmContext } from '../../uiConfirm.types';
 import type { NormalizedConfirmationConfig } from '../../../../types/confirmationConfig';
 import type { ThemeMode } from '../../../../types/seams';
+import type { NearTransactionContextReady } from '../../../nonce/nearTransactionReadiness';
 import { type TransactionSummary, type SigningUserConfirmRequest, type IntentDigestUserConfirmRequest } from '../../../stepUpConfirmation/channel/confirmTypes';
 import { type SigningAuthMode } from '../../../stepUpConfirmation/types';
 import { type UserConfirmResponsePort } from '../../../stepUpConfirmation/channel/confirmCommon';
@@ -16,6 +17,7 @@ export declare function handleTransactionSigningFlow(ctx: UiConfirmContext, requ
     theme: ThemeMode;
     surface: ConfirmUISurfaceSource;
     onSigningOperationInteractionEvent?: (event: SigningOperationInteractionEvent) => void;
+    onNearTransactionContextReady?: (readiness: NearTransactionContextReady) => void;
 }): Promise<void>;
 export declare function handleIntentDigestSigningFlow(ctx: UiConfirmContext, request: IntentDigestUserConfirmRequest, worker: UserConfirmResponsePort, opts: {
     confirmationConfig: NormalizedConfirmationConfig;

package/dist/types/wallet/src/core/signingEngine/uiConfirm/handlers/handlePromptFromWorker.d.ts

@@ -3,6 +3,7 @@ import { type UserConfirmDecision } from '../../stepUpConfirmation/channel/confi
 import type { UserConfirmPromptEnvelope } from '../../stepUpConfirmation/channel/confirmTypes';
 import type { ConfirmUISurfaceSource } from '../ui/confirm-ui';
 import type { SigningOperationInteractionEvent } from '../../flows/shared/signingStateMachine';
+import type { NearTransactionContextReady } from '../../nonce/nearTransactionReadiness';
 /**
  * Handles secure confirmation requests from the worker with robust error handling
  * => UserConfirmMessageType.PROMPT_USER_CONFIRM_IN_JS_MAIN_THREAD
@@ -12,5 +13,6 @@ export declare function handlePromptFromWorker(ctx: UiConfirmContext, message: U
     signingSurface: ConfirmUISurfaceSource;
     onDecision?: (decision: UserConfirmDecision) => void;
     onSigningOperationInteractionEvent?: (event: SigningOperationInteractionEvent) => void;
+    onNearTransactionContextReady?: (readiness: NearTransactionContextReady) => void;
 }): Promise<void>;
 //# sourceMappingURL=handlePromptFromWorker.d.ts.map

package/dist/types/wallet/src/core/signingEngine/uiConfirm/uiConfirm.types.d.ts

@@ -29,9 +29,12 @@ import type { WalletIframeSurfaceMeasurement } from '../../../SeamsWeb/walletIfr
 import type { WalletIframeRequestId } from '../../types/walletIframeIdentity';
 import type { TxDisplayModel } from '../interfaces/display';
 import type { SigningOperationInteractionEvent } from '../flows/shared/signingStateMachine';
+import type { NearTransactionContextReady } from '../nonce/nearTransactionReadiness';
 export type RequestUserConfirmationOptions = {
     onProgress?: (progress: UserConfirmProgressEvent) => void;
     onSigningOperationInteractionEvent?: (event: SigningOperationInteractionEvent) => void;
+    /** Reports the NEAR transaction context as soon as the confirmation reserves it. */
+    onNearTransactionContextReady?: (readiness: NearTransactionContextReady) => void;
 };
 export type ExportPrivateKeysWithUiOptions = {
     onViewerLifecycle?: (event: 'opened' | 'closed') => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seams/wallet",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "type": "module",
   "description": "Seams web and runtime TypeScript SDK for NEAR and EVM-family wallets",
   "main": "./dist/esm/index.js",