@tatchi-xyz/sdk 0.21.0 → 0.31.0

package/dist/esm/react/src/core/TatchiPasskey/actions.js

@@ -0,0 +1,403 @@
+import { mergeSignerMode } from "../types/signer-worker.js";
+import { getNearShortErrorMessage, toError } from "../../utils/errors.js";
+import { ActionPhase, ActionStatus } from "../types/sdkSentEvents.js";
+import { ActionType, toActionArgsWasm } from "../types/actions.js";
+
+//#region src/core/TatchiPasskey/actions.ts
+/**
+* executeAction signs a single transaction (with actions[]) to a single receiver.
+* If you want to sign multiple transactions to different receivers,
+* use signTransactionsWithActions() instead.
+*
+* @param context - TatchiPasskey context
+* @param nearAccountId - NEAR account ID to sign transactions with
+* @param actionArgs - Action arguments to sign transactions with
+* @param options - Options for the action
+* @returns Promise resolving to the action result
+*/
+async function executeAction(args) {
+	try {
+		const signerMode = mergeSignerMode(getBaseSignerMode(args.context), args.options?.signerMode);
+		return executeActionInternal({
+			context: args.context,
+			nearAccountId: args.nearAccountId,
+			receiverId: args.receiverId,
+			actionArgs: args.actionArgs,
+			signerMode,
+			options: args.options,
+			confirmationConfigOverride: args.options.confirmationConfig
+		});
+	} catch (error) {
+		throw toError(error);
+	}
+}
+function parseExecutionWait(options) {
+	return { waitUntil: options?.waitUntil };
+}
+/**
+* Signs multiple transactions with actions, and broadcasts them
+*
+* @param context - TatchiPasskey context
+* @param nearAccountId - NEAR account ID to sign transactions with
+* @param transactionInput - Transaction input to sign
+* @param options - Options for the action
+* @returns Promise resolving to the action result
+*/
+async function signAndSendTransactions(args) {
+	const signerMode = mergeSignerMode(getBaseSignerMode(args.context), args.options?.signerMode);
+	return signAndSendTransactionsInternal({
+		context: args.context,
+		nearAccountId: args.nearAccountId,
+		transactionInputs: args.transactionInputs,
+		signerMode,
+		options: args.options,
+		confirmationConfigOverride: args.options.confirmationConfig
+	});
+}
+/**
+* Signs transactions with actions, without broadcasting them
+*
+* @param context - TatchiPasskey context
+* @param nearAccountId - NEAR account ID to sign transactions with
+* @param actionArgs - Action arguments to sign transactions with
+* @param options - Options for the action
+* @returns Promise resolving to the action result
+*/
+async function signTransactionsWithActions(args) {
+	try {
+		const signerMode = mergeSignerMode(getBaseSignerMode(args.context), args.options?.signerMode);
+		return signTransactionsWithActionsInternal({
+			context: args.context,
+			nearAccountId: args.nearAccountId,
+			transactionInputs: args.transactionInputs,
+			signerMode,
+			options: args.options,
+			confirmationConfigOverride: args.options.confirmationConfig
+		});
+	} catch (error) {
+		throw toError(error);
+	}
+}
+/**
+* 3. Transaction Broadcasting - Broadcasts the signed transaction to NEAR network
+* This method broadcasts a previously signed transaction and waits for execution
+*
+* @param context - TatchiPasskey context
+* @param signedTransaction - The signed transaction to broadcast
+* @param waitUntil - The execution status to wait for (defaults to FINAL)
+* @returns Promise resolving to the transaction execution outcome
+*
+* @example
+* ```typescript
+* // Sign a transaction first
+* const signedTransactions = await signTransactionsWithActions(context, 'alice.near', {
+*   transactions: [{
+*     nearAccountId: 'alice.near',
+*     receiverId: 'bob.near',
+*     actions: [{
+*       action_type: ActionType.Transfer,
+*       deposit: '1000000000000000000000000'
+*     }],
+*     nonce: '123'
+*   }]
+* });
+*
+* // Then broadcast it
+* const result = await sendTransaction(
+*   context,
+*   signedTransactions[0].signedTransaction,
+*   TxExecutionStatus.FINAL
+* );
+* ```
+*
+* sendTransaction centrally manages nonce lifecycle around broadcast:
+* - On success: reconciles nonce with chain via updateNonceFromBlockchain() (async),
+*   which also prunes any stale reservations.
+* - On failure: releases the reserved nonce immediately to avoid leaks.
+* Callers SHOULD NOT release the nonce in their own catch blocks.
+*/
+async function sendTransaction({ context, signedTransaction, options }) {
+	options?.onEvent?.({
+		step: 7,
+		phase: ActionPhase.STEP_7_BROADCASTING,
+		status: ActionStatus.PROGRESS,
+		message: `Broadcasting transaction...`
+	});
+	let transactionResult;
+	let txId;
+	try {
+		try {
+			const st = signedTransaction;
+			const snapshot = {
+				type: typeof st,
+				keys: st && typeof st === "object" ? Object.keys(st) : null,
+				hasBase64Encode: typeof st?.base64Encode === "function",
+				hasEncode: typeof st?.encode === "function",
+				hasSnakeBytes: !!st?.borsh_bytes,
+				hasCamelBytes: !!st?.borshBytes
+			};
+			console.debug("[sendTransaction] signedTransaction snapshot", snapshot);
+		} catch {}
+		transactionResult = await context.nearClient.sendTransaction(signedTransaction, options?.waitUntil);
+		txId = transactionResult.transaction?.hash || transactionResult.transaction?.id;
+		const nonce = signedTransaction.transaction.nonce;
+		context.webAuthnManager.getNonceManager().updateNonceFromBlockchain(context.nearClient, nonce.toString()).catch((error) => {
+			console.warn("[sendTransaction] Failed to update nonce from blockchain:", error);
+		});
+		options?.onEvent?.({
+			step: 7,
+			phase: ActionPhase.STEP_7_BROADCASTING,
+			status: ActionStatus.SUCCESS,
+			message: `Transaction ${txId} sent successfully`
+		});
+		options?.onEvent?.({
+			step: 8,
+			phase: ActionPhase.STEP_8_ACTION_COMPLETE,
+			status: ActionStatus.SUCCESS,
+			message: `Transaction ${txId} completed `
+		});
+	} catch (error) {
+		const e = toError(error);
+		console.error("[sendTransaction] failed:", e);
+		const details = e.details;
+		if (details) console.error("[sendTransaction] RPC error details:", details);
+		try {
+			const nonce = signedTransaction.transaction.nonce;
+			context.webAuthnManager.getNonceManager().releaseNonce(nonce.toString());
+		} catch (nonceError) {
+			console.warn("[sendTransaction]: Failed to release nonce after failure:", nonceError);
+		}
+		throw e;
+	}
+	return {
+		success: true,
+		transactionId: txId,
+		result: transactionResult
+	};
+}
+/**
+* Internal API for executing actions with optional confirmation override
+* @internal - Only used by internal SDK components like SecureTxConfirmButton
+*
+* @param context - TatchiPasskey context
+* @param nearAccountId - NEAR account ID to sign transactions with
+* @param actionArgs - Action arguments to sign transactions with
+* @param options - Options for the action
+* @returns Promise resolving to the action result
+*/
+async function executeActionInternal({ context, nearAccountId, receiverId, actionArgs, signerMode, options, confirmationConfigOverride }) {
+	const { onEvent, onError, afterCall, waitUntil } = options || {};
+	const confirmerText = options?.confirmerText;
+	const actions = Array.isArray(actionArgs) ? actionArgs : [actionArgs];
+	try {
+		context.webAuthnManager.getNonceManager().getNonceBlockHashAndHeight(context.nearClient).catch((error) => {
+			console.warn("[executeAction]: Failed to pre-warm NonceManager:", error);
+		});
+		const signedTxs = await signTransactionsWithActionsInternal({
+			context,
+			nearAccountId,
+			transactionInputs: [{
+				receiverId,
+				actions
+			}],
+			signerMode,
+			options: {
+				onEvent,
+				onError,
+				waitUntil,
+				confirmerText
+			},
+			confirmationConfigOverride
+		});
+		const txResult = await sendTransaction({
+			context,
+			signedTransaction: signedTxs[0].signedTransaction,
+			options: {
+				onEvent,
+				onError,
+				waitUntil
+			}
+		});
+		afterCall?.(true, txResult);
+		return txResult;
+	} catch (error) {
+		console.error("[executeAction] Error during execution:", error);
+		const e = toError(error);
+		const short = e.short || getNearShortErrorMessage(e);
+		onError?.(e);
+		onEvent?.({
+			step: 0,
+			phase: ActionPhase.ACTION_ERROR,
+			status: ActionStatus.ERROR,
+			message: `Action failed: ${short || e.message}`,
+			error: short || e.message
+		});
+		const result = {
+			success: false,
+			error: e.message,
+			errorDetails: e?.details,
+			transactionId: void 0
+		};
+		afterCall?.(false);
+		return result;
+	}
+}
+async function signAndSendTransactionsInternal({ context, nearAccountId, transactionInputs, signerMode, options, confirmationConfigOverride }) {
+	try {
+		const signedTxs = await signTransactionsWithActionsInternal({
+			context,
+			nearAccountId,
+			transactionInputs,
+			signerMode,
+			options,
+			confirmationConfigOverride
+		});
+		const plan = parseExecutionWait(options);
+		const txResults = [];
+		for (let i = 0; i < signedTxs.length; i++) {
+			const tx = signedTxs[i];
+			const txResult = await sendTransaction({
+				context,
+				signedTransaction: tx.signedTransaction,
+				options: {
+					onEvent: options?.onEvent,
+					waitUntil: plan.waitUntil ?? options?.waitUntil
+				}
+			});
+			txResults.push(txResult);
+		}
+		return txResults;
+	} catch (error) {
+		context.webAuthnManager.getNonceManager().releaseAllNonces();
+		const e = toError(error);
+		const short = e.short || getNearShortErrorMessage(e) || e.message;
+		options?.onEvent?.({
+			step: 0,
+			phase: ActionPhase.ACTION_ERROR,
+			status: ActionStatus.ERROR,
+			message: `Action failed: ${short}`,
+			error: short
+		});
+		options?.onError?.(e);
+		throw e;
+	}
+}
+/**
+* Internal API for signing transactions with actions
+* @internal - Only used by internal SDK components with confirmationConfigOverride
+*
+* @param context - TatchiPasskey context
+* @param nearAccountId - NEAR account ID to sign transactions with
+* @param actionArgs - Action arguments to sign transactions with
+* @param options - Options for the action
+* @returns Promise resolving to the action result
+*/
+async function signTransactionsWithActionsInternal({ context, nearAccountId, transactionInputs, signerMode, options, confirmationConfigOverride }) {
+	const { onEvent, onError, waitUntil, confirmerText } = options || {};
+	try {
+		onEvent?.({
+			step: 1,
+			phase: ActionPhase.STEP_1_PREPARATION,
+			status: ActionStatus.PROGRESS,
+			message: transactionInputs.length > 1 ? `Starting batched transaction with ${transactionInputs.length} actions` : `Starting ${transactionInputs[0].actions[0].type} action`
+		});
+		await validateInputsOnly(nearAccountId, transactionInputs, {
+			onEvent,
+			onError,
+			waitUntil
+		});
+		onEvent?.({
+			step: 2,
+			phase: ActionPhase.STEP_2_USER_CONFIRMATION,
+			status: ActionStatus.PROGRESS,
+			message: "Requesting user confirmation..."
+		});
+		const transactionInputsWasm = transactionInputs.map((tx) => {
+			return {
+				receiverId: tx.receiverId,
+				actions: tx.actions.map((action) => toActionArgsWasm(action))
+			};
+		});
+		return context.webAuthnManager.signTransactionsWithActions({
+			transactions: transactionInputsWasm,
+			rpcCall: {
+				contractId: context.configs.contractId,
+				nearRpcUrl: context.configs.nearRpcUrl,
+				nearAccountId
+			},
+			signerMode,
+			confirmationConfigOverride,
+			title: confirmerText?.title,
+			body: confirmerText?.body,
+			onEvent: onEvent ? (progressEvent) => {
+				if (progressEvent.phase === ActionPhase.STEP_3_WEBAUTHN_AUTHENTICATION) onEvent?.({
+					step: 3,
+					phase: ActionPhase.STEP_3_WEBAUTHN_AUTHENTICATION,
+					status: ActionStatus.PROGRESS,
+					message: "Authenticating with contract..."
+				});
+				if (progressEvent.phase === ActionPhase.STEP_4_AUTHENTICATION_COMPLETE) onEvent?.({
+					step: 4,
+					phase: ActionPhase.STEP_4_AUTHENTICATION_COMPLETE,
+					status: ActionStatus.SUCCESS,
+					message: "WebAuthn verification complete"
+				});
+				if (progressEvent.phase === ActionPhase.STEP_5_TRANSACTION_SIGNING_PROGRESS) onEvent?.({
+					step: 5,
+					phase: ActionPhase.STEP_5_TRANSACTION_SIGNING_PROGRESS,
+					status: ActionStatus.PROGRESS,
+					message: "Signing transaction..."
+				});
+				if (progressEvent.phase === ActionPhase.STEP_6_TRANSACTION_SIGNING_COMPLETE) onEvent?.({
+					step: 6,
+					phase: ActionPhase.STEP_6_TRANSACTION_SIGNING_COMPLETE,
+					status: ActionStatus.SUCCESS,
+					message: "Transaction signed successfully"
+				});
+				onEvent(progressEvent);
+			} : void 0
+		});
+	} catch (error) {
+		console.error("[signTransactionsWithActions] Error during execution:", error);
+		const e = toError(error);
+		const short = e.short || getNearShortErrorMessage(e) || e.message;
+		onError?.(e);
+		onEvent?.({
+			step: 0,
+			phase: ActionPhase.ACTION_ERROR,
+			status: ActionStatus.ERROR,
+			message: `Action failed: ${short}`,
+			error: short
+		});
+		throw e;
+	}
+}
+async function validateInputsOnly(nearAccountId, transactionInputs, options) {
+	const { onEvent, onError } = options || {};
+	if (!nearAccountId) throw new Error("User not logged in or NEAR account ID not set for direct action.");
+	onEvent?.({
+		step: 1,
+		phase: ActionPhase.STEP_1_PREPARATION,
+		status: ActionStatus.PROGRESS,
+		message: "Validating inputs..."
+	});
+	if (transactionInputs.length === 0) throw new Error("No payloads provided for signing");
+	for (const transactionInput of transactionInputs) {
+		if (!transactionInput.receiverId) throw new Error("Missing required parameter: receiverId");
+		for (const action of transactionInput.actions) {
+			if (action.type === ActionType.FunctionCall && (!action.methodName || action.args === void 0)) throw new Error("Missing required parameters for function call: methodName or args");
+			if (action.type === ActionType.Transfer && !action.amount) throw new Error("Missing required parameter for transfer: amount");
+		}
+	}
+}
+function getBaseSignerMode(context) {
+	try {
+		return context.webAuthnManager.getUserPreferences().getSignerMode();
+	} catch {
+		return context.configs.signerMode;
+	}
+}
+
+//#endregion
+export { executeAction, sendTransaction, signAndSendTransactions, signTransactionsWithActions };
+//# sourceMappingURL=actions.js.map

package/dist/esm/react/src/core/TatchiPasskey/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","names":["error: unknown","st: any","result: ActionResult","txResults: ActionResult[]","transactionInputsWasm: TransactionInputWasm[]","error: any"],"sources":["../../../../../../src/core/TatchiPasskey/actions.ts"],"sourcesContent":["import { ActionType, toActionArgsWasm } from '../types/actions';\nimport type {\n  ActionHooksOptions,\n  ExecutionWaitOption,\n  SendTransactionHooksOptions,\n  SignAndSendTransactionHooksOptions,\n  SignTransactionHooksOptions,\n} from '../types/sdkSentEvents';\nimport type { ActionResult, SignTransactionResult } from '../types/tatchi';\nimport type { TxExecutionStatus } from '@near-js/types';\nimport type { ActionArgs, TransactionInput, TransactionInputWasm } from '../types/actions';\nimport { type ConfirmationConfig, type SignerMode, mergeSignerMode } from '../types/signer-worker';\nimport type { PasskeyManagerContext } from './index';\nimport type { SignedTransaction } from '../NearClient';\nimport type { AccountId } from '../types/accountIds';\nimport { ActionPhase, ActionStatus, type ActionSSEEvent, type onProgressEvents } from '../types/sdkSentEvents';\nimport { toError, getNearShortErrorMessage } from '../../utils/errors';\n\n/**\n * executeAction signs a single transaction (with actions[]) to a single receiver.\n * If you want to sign multiple transactions to different receivers,\n * use signTransactionsWithActions() instead.\n *\n * @param context - TatchiPasskey context\n * @param nearAccountId - NEAR account ID to sign transactions with\n * @param actionArgs - Action arguments to sign transactions with\n * @param options - Options for the action\n * @returns Promise resolving to the action result\n */\nexport async function executeAction(args: {\n  context: PasskeyManagerContext,\n  nearAccountId: AccountId,\n  receiverId: AccountId,\n  actionArgs: ActionArgs | ActionArgs[],\n  options: ActionHooksOptions,\n}): Promise<ActionResult> {\n  try {\n    const signerMode = mergeSignerMode(getBaseSignerMode(args.context), args.options?.signerMode);\n    // Thread optional per-call confirmation override when provided; otherwise\n    // user preferences determine the confirmation behavior.\n    return executeActionInternal({\n      context: args.context,\n      nearAccountId: args.nearAccountId,\n      receiverId: args.receiverId,\n      actionArgs: args.actionArgs,\n      signerMode,\n      options: args.options,\n      confirmationConfigOverride: args.options.confirmationConfig\n    });\n  } catch (error: unknown) {\n    throw toError(error);\n  }\n}\n\n// Execution plan types for broadcasting multiple transactions\n// Helper: parse executionWait (only sequential for now)\nfunction parseExecutionWait(options?: SignAndSendTransactionHooksOptions): { waitUntil?: TxExecutionStatus } {\n  return { waitUntil: options?.waitUntil };\n}\n\n/**\n * Signs multiple transactions with actions, and broadcasts them\n *\n * @param context - TatchiPasskey context\n * @param nearAccountId - NEAR account ID to sign transactions with\n * @param transactionInput - Transaction input to sign\n * @param options - Options for the action\n * @returns Promise resolving to the action result\n */\nexport async function signAndSendTransactions(args: {\n  context: PasskeyManagerContext,\n  nearAccountId: AccountId,\n  transactionInputs: TransactionInput[],\n  options: SignAndSendTransactionHooksOptions,\n}): Promise<ActionResult[]> {\n  const signerMode = mergeSignerMode(getBaseSignerMode(args.context), args.options?.signerMode);\n  return signAndSendTransactionsInternal({\n    context: args.context,\n    nearAccountId: args.nearAccountId,\n    transactionInputs: args.transactionInputs,\n    signerMode,\n    options: args.options,\n    confirmationConfigOverride: args.options.confirmationConfig\n  });\n}\n\n/**\n * Signs transactions with actions, without broadcasting them\n *\n * @param context - TatchiPasskey context\n * @param nearAccountId - NEAR account ID to sign transactions with\n * @param actionArgs - Action arguments to sign transactions with\n * @param options - Options for the action\n * @returns Promise resolving to the action result\n */\nexport async function signTransactionsWithActions(args: {\n  context: PasskeyManagerContext,\n  nearAccountId: AccountId,\n  transactionInputs: TransactionInput[],\n  options: SignTransactionHooksOptions,\n}): Promise<SignTransactionResult[]> {\n  try {\n    const signerMode = mergeSignerMode(getBaseSignerMode(args.context), args.options?.signerMode);\n    return signTransactionsWithActionsInternal({\n      context: args.context,\n      nearAccountId: args.nearAccountId,\n      transactionInputs: args.transactionInputs,\n      signerMode,\n      options: args.options,\n      confirmationConfigOverride: args.options.confirmationConfig\n      // Public API always uses undefined override (respects user settings)\n    });\n  } catch (error: unknown) {\n    throw toError(error);\n  }\n}\n\n/**\n * 3. Transaction Broadcasting - Broadcasts the signed transaction to NEAR network\n * This method broadcasts a previously signed transaction and waits for execution\n *\n * @param context - TatchiPasskey context\n * @param signedTransaction - The signed transaction to broadcast\n * @param waitUntil - The execution status to wait for (defaults to FINAL)\n * @returns Promise resolving to the transaction execution outcome\n *\n * @example\n * ```typescript\n * // Sign a transaction first\n * const signedTransactions = await signTransactionsWithActions(context, 'alice.near', {\n *   transactions: [{\n *     nearAccountId: 'alice.near',\n *     receiverId: 'bob.near',\n *     actions: [{\n *       action_type: ActionType.Transfer,\n *       deposit: '1000000000000000000000000'\n *     }],\n *     nonce: '123'\n *   }]\n * });\n *\n * // Then broadcast it\n * const result = await sendTransaction(\n *   context,\n *   signedTransactions[0].signedTransaction,\n *   TxExecutionStatus.FINAL\n * );\n * ```\n *\n * sendTransaction centrally manages nonce lifecycle around broadcast:\n * - On success: reconciles nonce with chain via updateNonceFromBlockchain() (async),\n *   which also prunes any stale reservations.\n * - On failure: releases the reserved nonce immediately to avoid leaks.\n * Callers SHOULD NOT release the nonce in their own catch blocks.\n */\nexport async function sendTransaction({\n  context,\n  signedTransaction,\n  options,\n}: {\n  context: PasskeyManagerContext,\n  signedTransaction: SignedTransaction,\n  options?: SendTransactionHooksOptions,\n}): Promise<ActionResult> {\n\n  options?.onEvent?.({\n    step: 7,\n    phase: ActionPhase.STEP_7_BROADCASTING,\n    status: ActionStatus.PROGRESS,\n    message: `Broadcasting transaction...`\n  });\n\n  let transactionResult;\n  let txId;\n  try {\n    // Debug snapshot of the signed transaction shape to aid integration debugging.\n    try {\n      const st: any = signedTransaction as any;\n      const snapshot = {\n        type: typeof st,\n        keys: st && typeof st === 'object' ? Object.keys(st) : null,\n        hasBase64Encode: typeof st?.base64Encode === 'function',\n        hasEncode: typeof st?.encode === 'function',\n        hasSnakeBytes: !!st?.borsh_bytes,\n        hasCamelBytes: !!st?.borshBytes,\n      };\n      console.debug('[sendTransaction] signedTransaction snapshot', snapshot);\n    } catch {\n      // best-effort logging only\n    }\n\n    transactionResult = await context.nearClient.sendTransaction(\n      signedTransaction,\n      options?.waitUntil\n    );\n    txId = transactionResult.transaction?.hash || transactionResult.transaction?.id;\n\n    // Update nonce from blockchain after successful transaction broadcast asynchronously\n    const nonce = signedTransaction.transaction.nonce;\n    context.webAuthnManager.getNonceManager().updateNonceFromBlockchain(\n      context.nearClient,\n      nonce.toString()\n    ).catch((error) => {\n      console.warn('[sendTransaction] Failed to update nonce from blockchain:', error);\n      // don't fail transaction if nonce update fails\n    });\n\n    options?.onEvent?.({\n      step: 7,\n      phase: ActionPhase.STEP_7_BROADCASTING,\n      status: ActionStatus.SUCCESS,\n      message: `Transaction ${txId} sent successfully`\n    });\n    options?.onEvent?.({\n      step: 8,\n      phase: ActionPhase.STEP_8_ACTION_COMPLETE,\n      status: ActionStatus.SUCCESS,\n      message: `Transaction ${txId} completed `\n    });\n  } catch (error: unknown) {\n    const e = toError(error);\n    console.error('[sendTransaction] failed:', e);\n    const details = (e as { details?: unknown }).details;\n    if (details) {\n      // Surface full details at error level for visibility during debugging\n      console.error('[sendTransaction] RPC error details:', details);\n    }\n    // Centralized cleanup: release reserved nonce on failure (idempotent)\n    try {\n      const nonce = signedTransaction.transaction.nonce;\n      context.webAuthnManager.getNonceManager().releaseNonce(nonce.toString());\n    } catch (nonceError) {\n      console.warn('[sendTransaction]: Failed to release nonce after failure:', nonceError);\n    }\n    throw e;\n  }\n\n  return {\n    success: true,\n    transactionId: txId,\n    result: transactionResult\n  };\n}\n\n//////////////////////////////\n// === INTERNAL API ===\n//////////////////////////////\n\n/**\n * Internal API for executing actions with optional confirmation override\n * @internal - Only used by internal SDK components like SecureTxConfirmButton\n *\n * @param context - TatchiPasskey context\n * @param nearAccountId - NEAR account ID to sign transactions with\n * @param actionArgs - Action arguments to sign transactions with\n * @param options - Options for the action\n * @returns Promise resolving to the action result\n */\nexport async function executeActionInternal({\n  context,\n  nearAccountId,\n  receiverId,\n  actionArgs,\n  signerMode,\n  options,\n  confirmationConfigOverride,\n}: {\n  context: PasskeyManagerContext,\n  nearAccountId: AccountId,\n  receiverId: AccountId,\n  actionArgs: ActionArgs | ActionArgs[],\n  signerMode: SignerMode,\n  options?: ActionHooksOptions,\n  // Accept partial override and merge later in confirm flow\n  confirmationConfigOverride?: Partial<ConfirmationConfig> | undefined,\n}): Promise<ActionResult> {\n\n  const { onEvent, onError, afterCall, waitUntil } = options || {};\n  const confirmerText = options?.confirmerText;\n  const actions = Array.isArray(actionArgs) ? actionArgs : [actionArgs];\n\n  try {\n    // Pre-warm NonceManager with fresh transaction context data without blocking UI feedback\n    void context.webAuthnManager\n      .getNonceManager()\n      .getNonceBlockHashAndHeight(context.nearClient)\n      .catch((error) => {\n        console.warn('[executeAction]: Failed to pre-warm NonceManager:', error);\n        // Continue execution - NonceManager will fall back to direct RPC calls if needed\n      });\n\n    const signedTxs = await signTransactionsWithActionsInternal({\n      context,\n      nearAccountId,\n      transactionInputs: [{\n        receiverId: receiverId,\n        actions: actions,\n      }],\n      signerMode,\n      options: { onEvent, onError, waitUntil, confirmerText },\n      confirmationConfigOverride\n    });\n\n    const txResult = await sendTransaction({\n      context,\n      signedTransaction: signedTxs[0].signedTransaction,\n      options: { onEvent, onError, waitUntil }\n    });\n    afterCall?.(true, txResult);\n    return txResult;\n\n  } catch (error: unknown) {\n    console.error('[executeAction] Error during execution:', error);\n    const e = toError(error);\n    const short = (e as { short?: string }).short || getNearShortErrorMessage(e);\n    onError?.(e);\n    onEvent?.({\n      step: 0,\n      phase: ActionPhase.ACTION_ERROR,\n      status: ActionStatus.ERROR,\n      message: `Action failed: ${short || e.message}`,\n      error: short || e.message\n    });\n    const result: ActionResult = {\n      success: false,\n      error: e.message,\n      // propagate structured RPC details when present so UIs can render helpful errors\n      errorDetails: (e as any)?.details,\n      transactionId: undefined,\n    };\n    afterCall?.(false);\n    return result;\n  }\n}\n\nexport async function signAndSendTransactionsInternal({\n  context,\n  nearAccountId,\n  transactionInputs,\n  signerMode,\n  options,\n  confirmationConfigOverride,\n}: {\n  context: PasskeyManagerContext,\n  nearAccountId: AccountId,\n  transactionInputs: TransactionInput[],\n  signerMode: SignerMode,\n  options?: SignAndSendTransactionHooksOptions,\n  confirmationConfigOverride?: Partial<ConfirmationConfig> | undefined,\n}): Promise<ActionResult[]> {\n\n  try {\n    const signedTxs = await signTransactionsWithActionsInternal({\n      context,\n      nearAccountId,\n      transactionInputs,\n      signerMode,\n      options,\n      confirmationConfigOverride\n    });\n\n    const plan = parseExecutionWait(options);\n    const txResults: ActionResult[] = [];\n    for (let i = 0; i < signedTxs.length; i++) {\n      const tx = signedTxs[i];\n      const txResult = await sendTransaction({\n        context,\n        signedTransaction: tx.signedTransaction,\n        options: {\n          onEvent: options?.onEvent,\n          waitUntil: plan.waitUntil ?? options?.waitUntil,\n        }\n      });\n      txResults.push(txResult);\n    }\n    return txResults;\n  } catch (error: unknown) {\n    // If signing fails, release all reserved nonces\n    context.webAuthnManager.getNonceManager().releaseAllNonces();\n    const e = toError(error);\n    const short = (e as { short?: string }).short || getNearShortErrorMessage(e) || e.message;\n    options?.onEvent?.({\n      step: 0,\n      phase: ActionPhase.ACTION_ERROR,\n      status: ActionStatus.ERROR,\n      message: `Action failed: ${short}`,\n      error: short\n    });\n    options?.onError?.(e);\n    throw e;\n  }\n}\n\n/**\n * Internal API for signing transactions with actions\n * @internal - Only used by internal SDK components with confirmationConfigOverride\n *\n * @param context - TatchiPasskey context\n * @param nearAccountId - NEAR account ID to sign transactions with\n * @param actionArgs - Action arguments to sign transactions with\n * @param options - Options for the action\n * @returns Promise resolving to the action result\n */\nexport async function signTransactionsWithActionsInternal({\n  context,\n  nearAccountId,\n  transactionInputs,\n  signerMode,\n  options,\n  confirmationConfigOverride,\n}: {\n  context: PasskeyManagerContext,\n  nearAccountId: AccountId,\n  transactionInputs: TransactionInput[],\n  signerMode: SignerMode,\n  options?: Omit<ActionHooksOptions, 'afterCall'>,\n  confirmationConfigOverride?: Partial<ConfirmationConfig> | undefined,\n}): Promise<SignTransactionResult[]> {\n\n  const { onEvent, onError, waitUntil, confirmerText } = options || {};\n\n  try {\n    // Emit started event\n    onEvent?.({\n      step: 1,\n      phase: ActionPhase.STEP_1_PREPARATION,\n      status: ActionStatus.PROGRESS,\n      message: transactionInputs.length > 1\n        ? `Starting batched transaction with ${transactionInputs.length} actions`\n        : `Starting ${transactionInputs[0].actions[0].type} action`\n    });\n\n    // 1. Basic validation (NEAR data fetching moved to confirmation flow)\n    await validateInputsOnly(nearAccountId, transactionInputs, { onEvent, onError, waitUntil });\n\n    // 2. VRF Authentication + Transaction Signing (NEAR data fetched in confirmation flow)\n    onEvent?.({\n      step: 2,\n      phase: ActionPhase.STEP_2_USER_CONFIRMATION,\n      status: ActionStatus.PROGRESS,\n      message: 'Requesting user confirmation...'\n    });\n\n    // Convert all actions to ActionArgsWasm format for batched transaction\n    const transactionInputsWasm: TransactionInputWasm[] = transactionInputs.map(tx => {\n      return {\n        receiverId: tx.receiverId,\n        actions: tx.actions.map(action => toActionArgsWasm(action)),\n      }\n    });\n\n    // VRF challenge and NEAR data will be generated in the confirmation flow\n    // - Nonce will be fetched within the confirmation flow\n    // This eliminates the ~500ms blocking operations before modal display\n    return context.webAuthnManager.signTransactionsWithActions({\n      transactions: transactionInputsWasm,\n      rpcCall: {\n        contractId: context.configs.contractId,\n        nearRpcUrl: context.configs.nearRpcUrl,\n        nearAccountId: nearAccountId, // caller account\n      },\n      signerMode,\n      // VRF challenge and NEAR data computed in confirmation flow\n      confirmationConfigOverride: confirmationConfigOverride,\n      title: confirmerText?.title,\n      body: confirmerText?.body,\n      // Pass through the onEvent callback for progress updates\n      onEvent: onEvent ? (progressEvent: onProgressEvents) => {\n        if (progressEvent.phase === ActionPhase.STEP_3_WEBAUTHN_AUTHENTICATION) {\n          onEvent?.({\n            step: 3,\n            phase: ActionPhase.STEP_3_WEBAUTHN_AUTHENTICATION,\n            status: ActionStatus.PROGRESS,\n            message: 'Authenticating with contract...',\n          });\n        }\n        if (progressEvent.phase === ActionPhase.STEP_4_AUTHENTICATION_COMPLETE) {\n          onEvent?.({\n            step: 4,\n            phase: ActionPhase.STEP_4_AUTHENTICATION_COMPLETE,\n            status: ActionStatus.SUCCESS,\n            message: 'WebAuthn verification complete',\n          });\n        }\n        if (progressEvent.phase === ActionPhase.STEP_5_TRANSACTION_SIGNING_PROGRESS) {\n          onEvent?.({\n            step: 5,\n            phase: ActionPhase.STEP_5_TRANSACTION_SIGNING_PROGRESS,\n            status: ActionStatus.PROGRESS,\n            message: 'Signing transaction...',\n          });\n        }\n        if (progressEvent.phase === ActionPhase.STEP_6_TRANSACTION_SIGNING_COMPLETE) {\n          onEvent?.({\n            step: 6,\n            phase: ActionPhase.STEP_6_TRANSACTION_SIGNING_COMPLETE,\n            status: ActionStatus.SUCCESS,\n            message: 'Transaction signed successfully',\n          });\n        }\n        // Bridge worker onProgressEvents (generic) to ActionSSEEvent expected by public hooks\n        onEvent(progressEvent as ActionSSEEvent);\n      } : undefined,\n    });\n\n  } catch (error: any) {\n    console.error('[signTransactionsWithActions] Error during execution:', error);\n    const e = toError(error);\n    const short = (e as { short?: string }).short || getNearShortErrorMessage(e) || e.message;\n    onError?.(e);\n    onEvent?.({\n      step: 0,\n      phase: ActionPhase.ACTION_ERROR,\n      status: ActionStatus.ERROR,\n      message: `Action failed: ${short}`,\n      error: short\n    });\n    throw e;\n  }\n}\n\nasync function validateInputsOnly(\n  nearAccountId: AccountId,\n  transactionInputs: TransactionInput[],\n  options?: Omit<ActionHooksOptions, 'afterCall'>,\n): Promise<void> {\n  const { onEvent, onError } = options || {};\n\n  // Basic validation\n  if (!nearAccountId) {\n    throw new Error('User not logged in or NEAR account ID not set for direct action.');\n  }\n\n  onEvent?.({\n    step: 1,\n    phase: ActionPhase.STEP_1_PREPARATION,\n    status: ActionStatus.PROGRESS,\n    message: 'Validating inputs...'\n  });\n\n  if (transactionInputs.length === 0) {\n    throw new Error('No payloads provided for signing');\n  }\n\n  for (const transactionInput of transactionInputs) {\n    if (!transactionInput.receiverId) {\n      throw new Error('Missing required parameter: receiverId');\n    }\n    for (const action of transactionInput.actions) {\n      if (action.type === ActionType.FunctionCall && (!action.methodName || action.args === undefined)) {\n        throw new Error('Missing required parameters for function call: methodName or args');\n      }\n      if (action.type === ActionType.Transfer && !action.amount) {\n        throw new Error('Missing required parameter for transfer: amount');\n      }\n    }\n  }\n}\n\nfunction getBaseSignerMode(context: PasskeyManagerContext): SignerMode {\n  try {\n    return context.webAuthnManager.getUserPreferences().getSignerMode();\n  } catch {\n    return context.configs.signerMode;\n  }\n}\n"],"mappings":"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"}

package/dist/esm/react/src/core/TatchiPasskey/delegateAction.js

@@ -0,0 +1,76 @@
+import { toAccountId } from "../types/accountIds.js";
+import { mergeSignerMode } from "../types/signer-worker.js";
+import { toError } from "../../utils/errors.js";
+import { ActionPhase, ActionStatus } from "../types/sdkSentEvents.js";
+
+//#region src/core/TatchiPasskey/delegateAction.ts
+async function signDelegateAction(args) {
+	const { context, delegate, options } = args;
+	const nearAccountId = toAccountId(String(args.nearAccountId));
+	const title = options?.confirmerText?.title;
+	const body = options?.confirmerText?.body;
+	const base = context.webAuthnManager.getUserPreferences().getSignerMode();
+	const signerMode = mergeSignerMode(base, options.signerMode);
+	const resolvedDelegate = {
+		...delegate,
+		senderId: delegate.senderId || String(nearAccountId)
+	};
+	options?.onEvent?.({
+		step: 1,
+		phase: ActionPhase.STEP_1_PREPARATION,
+		status: ActionStatus.PROGRESS,
+		message: "Preparing delegate action inputs"
+	});
+	options?.onEvent?.({
+		step: 2,
+		phase: ActionPhase.STEP_2_USER_CONFIRMATION,
+		status: ActionStatus.PROGRESS,
+		message: "Requesting delegate action confirmation…"
+	});
+	try {
+		const coreResult = await context.webAuthnManager.signDelegateAction({
+			delegate: resolvedDelegate,
+			rpcCall: {
+				contractId: context.configs.contractId,
+				nearRpcUrl: context.configs.nearRpcUrl,
+				nearAccountId: String(nearAccountId)
+			},
+			signerMode,
+			confirmationConfigOverride: options?.confirmationConfig,
+			title,
+			body,
+			onEvent: options?.onEvent ? (ev) => options.onEvent?.(ev) : void 0
+		});
+		const result = {
+			hash: coreResult.hash,
+			signedDelegate: coreResult.signedDelegate,
+			nearAccountId: String(nearAccountId),
+			logs: coreResult.logs
+		};
+		options?.onEvent?.({
+			step: 8,
+			phase: ActionPhase.STEP_8_ACTION_COMPLETE,
+			status: ActionStatus.SUCCESS,
+			message: "Delegate action signed",
+			data: { hash: result.hash }
+		});
+		await options?.afterCall?.(true, result);
+		return result;
+	} catch (error) {
+		const e = toError(error);
+		options?.onError?.(e);
+		await options?.afterCall?.(false);
+		options?.onEvent?.({
+			step: 0,
+			phase: ActionPhase.ACTION_ERROR,
+			status: ActionStatus.ERROR,
+			message: e.message,
+			error: e.message
+		});
+		throw e;
+	}
+}
+
+//#endregion
+export { signDelegateAction };
+//# sourceMappingURL=delegateAction.js.map

package/dist/esm/react/src/core/TatchiPasskey/delegateAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegateAction.js","names":["resolvedDelegate: DelegateActionInput","result: SignDelegateActionResult","error: unknown"],"sources":["../../../../../../src/core/TatchiPasskey/delegateAction.ts"],"sourcesContent":["import type { PasskeyManagerContext } from './index';\nimport type { DelegateActionInput } from '../types/delegate';\nimport type {\n  DelegateActionSSEEvent,\n  DelegateActionHooksOptions,\n} from '../types/sdkSentEvents';\nimport type { SignDelegateActionResult } from '../types/tatchi';\nimport type { AccountId } from '../types/accountIds';\nimport { ActionPhase, ActionStatus } from '../types/sdkSentEvents';\nimport { toAccountId } from '../types/accountIds';\nimport { toError } from '../../utils/errors';\nimport { mergeSignerMode } from '../types/signer-worker';\n\n\nexport async function signDelegateAction(args: {\n  context: PasskeyManagerContext;\n  nearAccountId: AccountId;\n  delegate: DelegateActionInput;\n  options: DelegateActionHooksOptions;\n}): Promise<SignDelegateActionResult> {\n  const { context, delegate, options } = args;\n  const nearAccountId = toAccountId(String(args.nearAccountId));\n  const title = options?.confirmerText?.title;\n  const body = options?.confirmerText?.body;\n  const base = context.webAuthnManager.getUserPreferences().getSignerMode();\n  const signerMode = mergeSignerMode(base, options.signerMode);\n\n  const resolvedDelegate: DelegateActionInput = {\n    ...delegate,\n    senderId: delegate.senderId || String(nearAccountId),\n  };\n\n  options?.onEvent?.({\n    step: 1,\n    phase: ActionPhase.STEP_1_PREPARATION,\n    status: ActionStatus.PROGRESS,\n    message: 'Preparing delegate action inputs',\n  });\n\n  // Emit a user-confirmation phase before kicking off the VRF-driven\n  // confirmation flow so the wallet-iframe overlay can expand and allow\n  // the TxConfirmer modal to capture activation.\n  options?.onEvent?.({\n    step: 2,\n    phase: ActionPhase.STEP_2_USER_CONFIRMATION,\n    status: ActionStatus.PROGRESS,\n    message: 'Requesting delegate action confirmation…',\n  });\n\n  try {\n    const coreResult = await context.webAuthnManager.signDelegateAction({\n      delegate: resolvedDelegate,\n      rpcCall: {\n        contractId: context.configs.contractId,\n        nearRpcUrl: context.configs.nearRpcUrl,\n        nearAccountId: String(nearAccountId),\n      },\n      signerMode,\n      confirmationConfigOverride: options?.confirmationConfig,\n      title,\n      body,\n      onEvent: options?.onEvent\n        ? (ev) => options.onEvent?.(ev as DelegateActionSSEEvent)\n        : undefined,\n    });\n\n    const result: SignDelegateActionResult = {\n      hash: coreResult.hash,\n      signedDelegate: coreResult.signedDelegate,\n      nearAccountId: String(nearAccountId),\n      logs: coreResult.logs,\n    };\n\n    options?.onEvent?.({\n      step: 8,\n      phase: ActionPhase.STEP_8_ACTION_COMPLETE,\n      status: ActionStatus.SUCCESS,\n      message: 'Delegate action signed',\n      data: { hash: result.hash },\n    });\n\n    await options?.afterCall?.(true, result);\n\n    return result;\n  } catch (error: unknown) {\n    const e = toError(error);\n    options?.onError?.(e);\n    await options?.afterCall?.(false);\n    options?.onEvent?.({\n      step: 0,\n      phase: ActionPhase.ACTION_ERROR,\n      status: ActionStatus.ERROR,\n      message: e.message,\n      error: e.message,\n    });\n    throw e;\n  }\n}\n"],"mappings":";;;;;;AAcA,eAAsB,mBAAmB,MAKH;CACpC,MAAM,EAAE,SAAS,UAAU,YAAY;CACvC,MAAM,gBAAgB,YAAY,OAAO,KAAK;CAC9C,MAAM,QAAQ,SAAS,eAAe;CACtC,MAAM,OAAO,SAAS,eAAe;CACrC,MAAM,OAAO,QAAQ,gBAAgB,qBAAqB;CAC1D,MAAM,aAAa,gBAAgB,MAAM,QAAQ;CAEjD,MAAMA,mBAAwC;EAC5C,GAAG;EACH,UAAU,SAAS,YAAY,OAAO;;AAGxC,UAAS,UAAU;EACjB,MAAM;EACN,OAAO,YAAY;EACnB,QAAQ,aAAa;EACrB,SAAS;;AAMX,UAAS,UAAU;EACjB,MAAM;EACN,OAAO,YAAY;EACnB,QAAQ,aAAa;EACrB,SAAS;;AAGX,KAAI;EACF,MAAM,aAAa,MAAM,QAAQ,gBAAgB,mBAAmB;GAClE,UAAU;GACV,SAAS;IACP,YAAY,QAAQ,QAAQ;IAC5B,YAAY,QAAQ,QAAQ;IAC5B,eAAe,OAAO;;GAExB;GACA,4BAA4B,SAAS;GACrC;GACA;GACA,SAAS,SAAS,WACb,OAAO,QAAQ,UAAU,MAC1B;;EAGN,MAAMC,SAAmC;GACvC,MAAM,WAAW;GACjB,gBAAgB,WAAW;GAC3B,eAAe,OAAO;GACtB,MAAM,WAAW;;AAGnB,WAAS,UAAU;GACjB,MAAM;GACN,OAAO,YAAY;GACnB,QAAQ,aAAa;GACrB,SAAS;GACT,MAAM,EAAE,MAAM,OAAO;;AAGvB,QAAM,SAAS,YAAY,MAAM;AAEjC,SAAO;UACAC,OAAgB;EACvB,MAAM,IAAI,QAAQ;AAClB,WAAS,UAAU;AACnB,QAAM,SAAS,YAAY;AAC3B,WAAS,UAAU;GACjB,MAAM;GACN,OAAO,YAAY;GACnB,QAAQ,aAAa;GACrB,SAAS,EAAE;GACX,OAAO,EAAE;;AAEX,QAAM"}