@seams/wallet 0.6.1 → 0.7.1

package/dist/esm/react/core/rpcClients/near/NearClient.js

@@ -1,28 +1,8 @@
-import { base64Decode, base64Encode } from "../../../shared-ts/src/utils/base64.js";
 import { errorMessage } from "../../../shared-ts/src/utils/errors.js";
-import { secureRandomId } from "../../../shared-ts/src/utils/secureRandomId.js";
+import { NearJsonRpcClient, SignedTransaction as SignedTransaction$1 } from "../../../shared-ts/src/near/nearClient.js";
 import { NearRpcError } from "./NearRpcError.js";
-import { DEFAULT_WAIT_STATUS } from "../../types/rpc.js";
-import { isFunction } from "../../../shared-ts/src/utils/validation.js";
-import { decodeJsonRpcEnvelope } from "../../../shared-ts/src/utils/jsonRpc.js";
-import { decodeNearAccessKeyList, decodeNearAccessKeyView, decodeNearAccountView, decodeNearBlockReference, decodeNearCodeBase64, decodeNearContractCallResult, decodeNearFinalExecutionOutcome, parseNearContractResult } from "../../../shared-ts/src/utils/nearRpcResults.js";
 //#region src/core/rpcClients/near/NearClient.ts
-let RpcCallType = /* @__PURE__ */ function(RpcCallType) {
-	RpcCallType["Query"] = "query";
-	RpcCallType["View"] = "view";
-	RpcCallType["Send"] = "send_tx";
-	RpcCallType["Block"] = "block";
-	RpcCallType["Call"] = "call_function";
-	return RpcCallType;
-}({});
-var SignedTransaction = class SignedTransaction {
-	constructor(data) {
-		this.transaction = data.transaction;
-		this.signature = data.signature;
-		this.borsh_bytes = data.borsh_bytes;
-		if (data.nonceLease) this.nonceLease = data.nonceLease;
-		if (data.serverDispatch) this.serverDispatch = data.serverDispatch;
-	}
+var SignedTransaction = class SignedTransaction extends SignedTransaction$1 {
 	static fromPlain(input) {
 		return new SignedTransaction({
 			transaction: input.transaction,
@@ -32,168 +12,33 @@ var SignedTransaction = class SignedTransaction {
 			...input.serverDispatch ? { serverDispatch: input.serverDispatch } : {}
 		});
 	}
-	encode() {
-		return new Uint8Array(this.borsh_bytes).buffer;
-	}
-	base64Encode() {
-		return base64Encode(this.encode());
-	}
-	static decode(bytes) {
+	static decode() {
 		throw new Error("SignedTransaction.decode(): borsh deserialization not implemented");
 	}
 };
-function toArrayBufferFromUnknownBytes(bytes) {
-	if (!bytes) return null;
-	if (Array.isArray(bytes)) return new Uint8Array(bytes).buffer;
-	if (ArrayBuffer.isView(bytes)) {
-		const view = bytes;
-		return view.buffer.slice(view.byteOffset, view.byteOffset + view.byteLength);
-	}
-	if (bytes instanceof ArrayBuffer) return bytes;
-	return null;
-}
-function encodeSignedTransactionBase64(signed) {
-	const maybeSigned = signed?.signedTransaction;
-	const txPayload = maybeSigned && typeof maybeSigned === "object" ? maybeSigned : signed;
-	const maybeBase64 = txPayload.base64Encode;
-	if (isFunction(maybeBase64)) return maybeBase64.call(txPayload);
-	const maybeEncode = txPayload.encode;
-	if (isFunction(maybeEncode)) return base64Encode(maybeEncode.call(txPayload));
-	const snakeBuf = toArrayBufferFromUnknownBytes(txPayload.borsh_bytes);
-	if (snakeBuf) return base64Encode(snakeBuf);
-	const camelBuf = toArrayBufferFromUnknownBytes(txPayload.borshBytes);
-	if (camelBuf) return base64Encode(camelBuf);
-	throw new Error("Invalid signed transaction payload: cannot serialize to base64");
-}
-var MinimalNearClient = class MinimalNearClient {
-	constructor(rpcUrl) {
-		this.rpcUrls = MinimalNearClient.normalizeRpcUrls(rpcUrl);
-	}
-	static normalizeRpcUrls(input) {
-		const normalized = (Array.isArray(input) ? input : input.split(/[\s,]+/).map((url) => url.trim()).filter(Boolean)).map((url) => {
-			try {
-				return new URL(url).toString();
-			} catch (err) {
-				const message = errorMessage(err) || `Invalid NEAR RPC URL: ${url}`;
-				throw new Error(message);
-			}
+var MinimalNearClient = class extends NearJsonRpcClient {
+	errorFromRpc(operationName, error) {
+		return NearRpcError.fromRpcError(operationName, error);
+	}
+	errorFromWrappedResult(message) {
+		return new NearRpcError({
+			message,
+			short: "RpcError",
+			type: "RpcError"
 		});
-		if (!normalized.length) throw new Error("NEAR RPC URL cannot be empty");
-		return Array.from(new Set(normalized));
 	}
-	/** Build a JSON-RPC 2.0 POST body (stringified). */
-	buildRequestBody(method, params) {
-		return JSON.stringify({
-			jsonrpc: "2.0",
-			id: secureRandomId("near-rpc", 32, "NEAR JSON-RPC request IDs"),
-			method,
-			params
-		});
+	errorFromOutcome(operationName, outcome, failure) {
+		return NearRpcError.fromOutcome(operationName, outcome, failure);
 	}
-	/** Perform a single POST to one endpoint and decode its JSON-RPC envelope. */
-	async postOnce(url, requestBody) {
-		const response = await fetch(url, {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: requestBody
-		});
-		if (response.status === 429) throw new Error("RPC throttled; retry shortly");
-		if (!response.ok) throw new Error(`RPC request failed: ${response.status} ${response.statusText}`);
-		const text = await response.text();
-		if (!text?.trim()) throw new Error("Empty response from RPC server");
-		const decoded = decodeJsonRpcEnvelope(JSON.parse(text));
-		if (!decoded.ok) throw new Error(`Invalid NEAR JSON-RPC response: ${decoded.error}`);
-		return decoded.value;
-	}
-	/** Try each configured RPC endpoint in order and return the first decoded envelope. */
-	async requestWithFallback(requestBody) {
-		let lastError;
-		for (const [index, url] of this.rpcUrls.entries()) try {
-			const result = await this.postOnce(url, requestBody);
-			if (index > 0) console.warn(`[NearClient] RPC succeeded via fallback: ${url}`);
-			return result;
-		} catch (err) {
-			lastError = err;
-			const remaining = index < this.rpcUrls.length - 1;
-			console.warn(`[NearClient] RPC call to ${url} failed${remaining ? ", trying next" : ""}: ${errorMessage(err) || "RPC request failed"}`);
-			if (!remaining) throw err instanceof Error ? err : new Error(String(err));
-		}
-		throw new Error(errorMessage(lastError) || "RPC request failed");
-	}
-	/** Unwrap an envelope while keeping the method result unknown. */
-	unwrapRpcResult(rpc, operationName) {
-		if (rpc.kind === "failure") throw NearRpcError.fromRpcError(operationName, rpc.error);
-		const result = rpc.result;
-		if (typeof result === "object" && result !== null && "error" in result) {
-			const wrappedError = Reflect.get(result, "error");
-			throw new NearRpcError({
-				message: `${operationName} Error: ${typeof wrappedError === "string" ? wrappedError : JSON.stringify(wrappedError)}`,
-				short: "RpcError",
-				type: "RpcError"
-			});
-		}
-		return rpc.result;
+	errorFromHttpStatus(response) {
+		if (response.status === 429) return /* @__PURE__ */ new Error("RPC throttled; retry shortly");
+		return super.errorFromHttpStatus(response);
 	}
-	/**
-	* Execute RPC call with proper error handling and result extraction
-	*/
-	async makeRpcCall(method, params, operationName, decodeResult) {
-		const requestBody = this.buildRequestBody(method, params);
-		const rpc = await this.requestWithFallback(requestBody);
-		return decodeResult(this.unwrapRpcResult(rpc, operationName));
-	}
-	async query(params, decodeResult) {
-		return this.makeRpcCall(RpcCallType.Query, params, "Query", decodeResult);
-	}
-	async viewAccessKey(accountId, publicKey, finalityQuery) {
-		const publicKeyStr = publicKey;
-		const params = {
-			request_type: "view_access_key",
-			finality: finalityQuery?.finality || "final",
-			account_id: accountId,
-			public_key: publicKeyStr
-		};
-		return this.makeRpcCall(RpcCallType.Query, params, "View Access Key", decodeNearAccessKeyView);
-	}
-	async viewAccessKeyList(accountId, finalityQuery) {
-		const params = {
-			request_type: "view_access_key_list",
-			finality: finalityQuery?.finality || "final",
-			account_id: accountId
-		};
-		return this.makeRpcCall(RpcCallType.Query, params, "View Access Key List", decodeNearAccessKeyList);
-	}
-	async viewAccount(accountId) {
-		const params = {
-			request_type: "view_account",
-			finality: "final",
-			account_id: accountId
-		};
-		return this.makeRpcCall(RpcCallType.Query, params, "View Account", decodeNearAccountView);
-	}
-	async viewCode(accountId, finalityQuery) {
-		const params = {
-			request_type: "view_code",
-			finality: finalityQuery?.finality || "final",
-			account_id: accountId
-		};
-		return base64Decode(await this.makeRpcCall(RpcCallType.Query, params, "View Code", decodeNearCodeBase64));
-	}
-	async viewBlock(params) {
-		return this.makeRpcCall(RpcCallType.Block, params, "View Block", decodeNearBlockReference);
-	}
-	async sendTransaction(signedTransaction, waitUntil = DEFAULT_WAIT_STATUS.executeAction) {
-		const params = {
-			signed_tx_base64: encodeSignedTransactionBase64(signedTransaction),
-			wait_until: waitUntil
-		};
+	async sendWithRetry(send) {
 		const maxAttempts = 5;
 		let lastError = null;
 		for (let attempt = 1; attempt <= maxAttempts; attempt++) try {
-			const outcome = await this.makeRpcCall(RpcCallType.Send, params, "Send Transaction", decodeNearFinalExecutionOutcome);
-			const status = outcome.status;
-			if (status && typeof status === "object" && "Failure" in status) throw NearRpcError.fromOutcome("Send Transaction", outcome, status.Failure);
-			return outcome;
+			return await send();
 		} catch (err) {
 			lastError = err;
 			const msg = errorMessage(err);
@@ -204,46 +49,6 @@ var MinimalNearClient = class MinimalNearClient {
 		}
 		throw lastError instanceof Error ? lastError : new Error(String(lastError));
 	}
-	async txStatus(txHash, senderAccountId) {
-		const params = {
-			tx_hash: txHash,
-			sender_account_id: senderAccountId
-		};
-		return this.makeRpcCall("EXPERIMENTAL_tx_status", params, "Tx Status", decodeNearFinalExecutionOutcome);
-	}
-	async callFunction(accountId, method, args, decodeResult, blockQuery) {
-		const rpcParams = {
-			request_type: "call_function",
-			...blockQuery ?? { finality: "final" },
-			account_id: accountId,
-			method_name: method,
-			args_base64: base64Encode(new TextEncoder().encode(JSON.stringify(args)).buffer)
-		};
-		return decodeResult(parseNearContractResult((await this.makeRpcCall(RpcCallType.Query, rpcParams, "View Function", decodeNearContractCallResult)).result));
-	}
-	async view(params) {
-		return this.callFunction(params.account, params.method, params.args, params.decodeResult);
-	}
-	async getAccessKeys({ account, block_id }) {
-		const params = {
-			request_type: "view_access_key_list",
-			account_id: account,
-			finality: "final"
-		};
-		if (block_id) {
-			params.block_id = block_id;
-			delete params.finality;
-		}
-		const accessKeyList = await this.makeRpcCall(RpcCallType.Query, params, "View Access Key List", decodeNearAccessKeyList);
-		const fullAccessKeys = [];
-		const functionCallAccessKeys = [];
-		for (const key of accessKeyList.keys) if (key.access_key.permission === "FullAccess") fullAccessKeys.push(key);
-		else if (key.access_key.permission && typeof key.access_key.permission === "object" && "FunctionCall" in key.access_key.permission) functionCallAccessKeys.push(key);
-		return {
-			fullAccessKeys,
-			functionCallAccessKeys
-		};
-	}
 };
 //#endregion
 export { MinimalNearClient, SignedTransaction };

package/dist/esm/react/core/rpcClients/near/rpcCalls.js

@@ -7,7 +7,7 @@ import { redactCredentialExtensionOutputs } from "../../signingEngine/webauthnAu
 import { mpcMaterialActivationRefsEqual, parseThresholdEd25519SessionId } from "../../../shared-ts/src/utils/domainIds.js";
 import { routerAbMpcMaterialActivationRefFromWire } from "../../../shared-ts/src/utils/routerAbNormalSigningIdentity.js";
 import { parseMpcWalletSigningQuotaId, parseWalletSessionAuthorizationId, parseWalletSessionId } from "../../../shared-ts/src/authorization/capabilityKinds.js";
-import { parseActiveWalletSessionV1, parseWalletSessionOperationCredentialV1 } from "../../../shared-ts/src/device-linking/parsers.js";
+import { parseActiveWalletSessionV1, parseWalletSessionOperationCredentialV1 } from "../../../shared-ts/src/device-linking/activeWalletSession.js";
 import { parseRouterAbEcdsaCredentialFreeSessionActivationResponseV1, parseRouterAbEcdsaDerivationPublicCapabilityV1, parseRouterAbEcdsaPostRegistrationSessionActivationPolicyV1, parseRouterAbEcdsaPostRegistrationSessionActivationResponseV1, parseRouterAbEcdsaRegistrationActivationReceiptV1 } from "../../../shared-ts/src/utils/routerAbEcdsaDerivation.js";
 import { parsePasskeyCustodyEnvelopeRecord } from "../../../shared-ts/src/passkey-custody/custodyEnvelope.js";
 import "../../../shared-ts/src/passkey-custody/index.js";

package/dist/esm/react/core/rpcClients/relayer/routerAbNormalSigning.js

@@ -1,4 +1,5 @@
 import { base64Decode, base64UrlDecode, base64UrlEncode } from "../../../shared-ts/src/utils/base64.js";
+import { coerceNonEmptyString } from "../../../shared-ts/src/utils/validation.js";
 import { alphabetizeStringify } from "../../../shared-ts/src/utils/digests.js";
 import { parseRouterAbMpcMaterialActivationRef, parseRouterAbNormalSigningAuthorization } from "../../../shared-ts/src/utils/routerAbNormalSigningIdentity.js";
 import { parseRouterAbEcdsaDerivationEvmDigestSigningPrepareResponseForRequestV1, parseRouterAbEcdsaDerivationEvmDigestSigningResponseForCoreRequestV1, parseRouterAbEcdsaOperationStepUpPreparationV1, routerAbEcdsaDerivationEvmDigestSigningFinalizeCoreRequestDigestV1, routerAbEcdsaDerivationEvmDigestSigningRequestDigestV1 } from "../../../shared-ts/src/utils/routerAbEcdsaDerivation.js";
@@ -42,11 +43,6 @@ function routerAbNormalSigningAdmissionErrorFromPayload(args) {
 		default: return null;
 	}
 }
-function requireNonEmptyString(value, label) {
-	const normalized = String(value || "").trim();
-	if (!normalized) throw new Error(`${label} is required`);
-	return normalized;
-}
 function requirePositiveInteger(value, label) {
 	const parsed = Math.floor(Number(value));
 	if (!Number.isSafeInteger(parsed) || parsed <= 0) throw new Error(`${label} must be a positive integer`);
@@ -60,17 +56,17 @@ function requireByteArray(value, label, byteLength) {
 	return bytes;
 }
 function requireDigestB64u(value, label) {
-	const normalized = requireNonEmptyString(value, label);
+	const normalized = coerceNonEmptyString(value, label);
 	if (base64UrlDecode(normalized).length !== 32) throw new Error(`${label} must decode to 32 bytes`);
 	return normalized;
 }
 function requireBase64UrlNonEmpty(value, label) {
-	const normalized = requireNonEmptyString(value, label);
+	const normalized = coerceNonEmptyString(value, label);
 	if (base64UrlDecode(normalized).length === 0) throw new Error(`${label} must decode to non-empty bytes`);
 	return normalized;
 }
 function normalizeNonceToB64u(value, label) {
-	const normalized = requireNonEmptyString(value, label);
+	const normalized = coerceNonEmptyString(value, label);
 	let bytes;
 	try {
 		bytes = base64Decode(normalized);
@@ -90,10 +86,10 @@ async function routerAbNormalSigningActionFingerprint(value) {
 	return base64UrlEncode(await sha256Bytes(new TextEncoder().encode(alphabetizeStringify(value))));
 }
 function routerAbEd25519Nep413CanonicalMessageB64uV2(args) {
-	const message = requireNonEmptyString(args.message, "nep413.message");
-	const recipient = requireNonEmptyString(args.recipient, "nep413.recipient");
+	const message = coerceNonEmptyString(args.message, "nep413.message");
+	const recipient = coerceNonEmptyString(args.recipient, "nep413.recipient");
 	const nonce = base64UrlDecode(normalizeNonceToB64u(args.nonce, "nep413.nonce"));
-	const callbackUrl = args.callbackUrl == null ? void 0 : requireNonEmptyString(args.callbackUrl, "callbackUrl");
+	const callbackUrl = args.callbackUrl == null ? void 0 : coerceNonEmptyString(args.callbackUrl, "callbackUrl");
 	const out = [];
 	pushU32Le(out, NEP413_PREFIX);
 	pushBorshString(out, message);
@@ -112,13 +108,13 @@ async function buildRouterAbEd25519NearTransactionPrepareRequestV2(args) {
 		display_digest: routerAbDigest32Wire(base64UrlDecode(requireDigestB64u(args.displayDigestB64u, "displayDigestB64u"))),
 		intent: {
 			kind: "near_transaction_v1",
-			operation_id: requireNonEmptyString(args.operationId, "operationId"),
-			operation_fingerprint: requireNonEmptyString(args.operationFingerprint, "operationFingerprint"),
-			near_account_id: requireNonEmptyString(args.nearAccountId, "nearAccountId"),
+			operation_id: coerceNonEmptyString(args.operationId, "operationId"),
+			operation_fingerprint: coerceNonEmptyString(args.operationFingerprint, "operationFingerprint"),
+			near_account_id: coerceNonEmptyString(args.nearAccountId, "nearAccountId"),
 			near_network_id: args.nearNetworkId,
 			transactions: args.transactions.map((transaction, index) => ({
-				receiver_id: requireNonEmptyString(transaction.receiverId, `transactions[${index}].receiverId`),
-				action_fingerprint: requireNonEmptyString(transaction.actionFingerprint, `transactions[${index}].actionFingerprint`)
+				receiver_id: coerceNonEmptyString(transaction.receiverId, `transactions[${index}].receiverId`),
+				action_fingerprint: coerceNonEmptyString(transaction.actionFingerprint, `transactions[${index}].actionFingerprint`)
 			})),
 			unsigned_transaction_borsh_b64u: requireBase64UrlNonEmpty(args.unsignedTransactionBorshB64u, "unsignedTransactionBorshB64u")
 		},
@@ -135,7 +131,7 @@ async function buildRouterAbEd25519NearTransactionPrepareRequestV2(args) {
 }
 async function buildRouterAbEd25519Nep413PrepareRequestV2(args) {
 	const nonceB64u = normalizeNonceToB64u(args.nonce, "nonce");
-	const callbackUrl = args.callbackUrl == null ? void 0 : requireNonEmptyString(args.callbackUrl, "callbackUrl");
+	const callbackUrl = args.callbackUrl == null ? void 0 : coerceNonEmptyString(args.callbackUrl, "callbackUrl");
 	const canonicalMessageB64u = routerAbEd25519Nep413CanonicalMessageB64uV2({
 		message: args.message,
 		recipient: args.recipient,
@@ -148,12 +144,12 @@ async function buildRouterAbEd25519Nep413PrepareRequestV2(args) {
 		display_digest: routerAbDigest32Wire(base64UrlDecode(requireDigestB64u(args.displayDigestB64u, "displayDigestB64u"))),
 		intent: {
 			kind: "nep413_v1",
-			operation_id: requireNonEmptyString(args.operationId, "operationId"),
-			operation_fingerprint: requireNonEmptyString(args.operationFingerprint, "operationFingerprint"),
-			near_account_id: requireNonEmptyString(args.nearAccountId, "nearAccountId"),
+			operation_id: coerceNonEmptyString(args.operationId, "operationId"),
+			operation_fingerprint: coerceNonEmptyString(args.operationFingerprint, "operationFingerprint"),
+			near_account_id: coerceNonEmptyString(args.nearAccountId, "nearAccountId"),
 			near_network_id: args.nearNetworkId,
-			recipient: requireNonEmptyString(args.recipient, "recipient"),
-			message: requireNonEmptyString(args.message, "message"),
+			recipient: coerceNonEmptyString(args.recipient, "recipient"),
+			message: coerceNonEmptyString(args.message, "message"),
 			nonce_b64u: nonceB64u,
 			...callbackUrl ? { callback_url: callbackUrl } : {}
 		},
@@ -176,17 +172,17 @@ async function buildRouterAbEd25519DelegateActionPrepareRequestV2(args) {
 		display_digest: routerAbDigest32Wire(base64UrlDecode(requireDigestB64u(args.displayDigestB64u, "displayDigestB64u"))),
 		intent: {
 			kind: "near_delegate_action_v1",
-			operation_id: requireNonEmptyString(args.operationId, "operationId"),
-			operation_fingerprint: requireNonEmptyString(args.operationFingerprint, "operationFingerprint"),
-			near_account_id: requireNonEmptyString(args.nearAccountId, "nearAccountId"),
+			operation_id: coerceNonEmptyString(args.operationId, "operationId"),
+			operation_fingerprint: coerceNonEmptyString(args.operationFingerprint, "operationFingerprint"),
+			near_account_id: coerceNonEmptyString(args.nearAccountId, "nearAccountId"),
 			near_network_id: args.nearNetworkId,
 			delegate: {
-				sender_id: requireNonEmptyString(args.delegate.senderId, "delegate.senderId"),
-				receiver_id: requireNonEmptyString(args.delegate.receiverId, "delegate.receiverId"),
-				public_key: requireNonEmptyString(args.delegate.publicKey, "delegate.publicKey"),
-				nonce: requireNonEmptyString(args.delegate.nonce, "delegate.nonce"),
-				max_block_height: requireNonEmptyString(args.delegate.maxBlockHeight, "delegate.maxBlockHeight"),
-				action_fingerprint: requireNonEmptyString(args.delegate.actionFingerprint, "delegate.actionFingerprint"),
+				sender_id: coerceNonEmptyString(args.delegate.senderId, "delegate.senderId"),
+				receiver_id: coerceNonEmptyString(args.delegate.receiverId, "delegate.receiverId"),
+				public_key: coerceNonEmptyString(args.delegate.publicKey, "delegate.publicKey"),
+				nonce: coerceNonEmptyString(args.delegate.nonce, "delegate.nonce"),
+				max_block_height: coerceNonEmptyString(args.delegate.maxBlockHeight, "delegate.maxBlockHeight"),
+				action_fingerprint: coerceNonEmptyString(args.delegate.actionFingerprint, "delegate.actionFingerprint"),
 				canonical_delegate_borsh_b64u: canonicalDelegateBorshB64u
 			}
 		},
@@ -207,7 +203,7 @@ function buildRouterAbEd25519NormalSigningFinalizeRequestV2(args) {
 		scope,
 		expires_at_ms: requirePositiveInteger(args.expiresAtMs, "expiresAtMs"),
 		prepare_binding: {
-			server_round1_handle: requireNonEmptyString(args.prepareResponse.server_round1_handle, "server_round1_handle"),
+			server_round1_handle: coerceNonEmptyString(args.prepareResponse.server_round1_handle, "server_round1_handle"),
 			round1_binding_digest: parseDigest32(args.prepareResponse.round1_binding_digest, "round1_binding_digest"),
 			intent_digest: parseDigest32(args.admissionMaterial.intentDigest, "intent_digest"),
 			signing_payload_digest: parseDigest32(args.admissionMaterial.signingPayloadDigest, "signing_payload_digest")
@@ -216,9 +212,9 @@ function buildRouterAbEd25519NormalSigningFinalizeRequestV2(args) {
 			kind: "ed25519_two_party_frost_finalize_v1",
 			client_commitments: parseCommitments(args.clientCommitments, "clientCommitments"),
 			server_commitments: parseCommitments(args.prepareResponse.server_commitments, "serverCommitments"),
-			client_verifying_share_b64u: requireNonEmptyString(args.clientVerifyingShareB64u, "clientVerifyingShareB64u"),
-			server_verifying_share_b64u: requireNonEmptyString(args.prepareResponse.server_verifying_share_b64u, "serverVerifyingShareB64u"),
-			client_signature_share_b64u: requireNonEmptyString(args.clientSignatureShareB64u, "clientSignatureShareB64u")
+			client_verifying_share_b64u: coerceNonEmptyString(args.clientVerifyingShareB64u, "clientVerifyingShareB64u"),
+			server_verifying_share_b64u: coerceNonEmptyString(args.prepareResponse.server_verifying_share_b64u, "serverVerifyingShareB64u"),
+			client_signature_share_b64u: coerceNonEmptyString(args.clientSignatureShareB64u, "clientSignatureShareB64u")
 		}
 	};
 	if (scope.authorization.kind === "reusable_wallet_session" && args.prepareResponse.scope.authorization.kind === "reusable_wallet_session") return {
@@ -267,11 +263,11 @@ function parseScope(value, label) {
 		"signing_worker_id"
 	], label);
 	const scope = {
-		request_id: requireNonEmptyString(record.request_id, `${label}.request_id`),
-		account_id: requireNonEmptyString(record.account_id, `${label}.account_id`),
+		request_id: coerceNonEmptyString(record.request_id, `${label}.request_id`),
+		account_id: coerceNonEmptyString(record.account_id, `${label}.account_id`),
 		authorization: parseRouterAbNormalSigningAuthorization(record.authorization),
 		material_activation: parseRouterAbMpcMaterialActivationRef(record.material_activation),
-		signing_worker_id: requireNonEmptyString(record.signing_worker_id, `${label}.signing_worker_id`)
+		signing_worker_id: coerceNonEmptyString(record.signing_worker_id, `${label}.signing_worker_id`)
 	};
 	if (scope.material_activation.signing_worker !== scope.signing_worker_id) throw new Error(`${label} material activation SigningWorker mismatch`);
 	return scope;
@@ -292,17 +288,17 @@ function parseCommitments(value, label) {
 	const record = value && typeof value === "object" ? value : null;
 	if (!record) throw new Error(`${label} must be an object`);
 	return {
-		hiding: requireNonEmptyString(record.hiding, `${label}.hiding`),
-		binding: requireNonEmptyString(record.binding, `${label}.binding`)
+		hiding: coerceNonEmptyString(record.hiding, `${label}.hiding`),
+		binding: coerceNonEmptyString(record.binding, `${label}.binding`)
 	};
 }
 function parseServerIdentity(value, label) {
 	const record = value && typeof value === "object" ? value : null;
 	if (!record) throw new Error(`${label} must be an object`);
 	return {
-		server_id: requireNonEmptyString(record.server_id, `${label}.server_id`),
-		key_epoch: requireNonEmptyString(record.key_epoch, `${label}.key_epoch`),
-		recipient_encryption_key: requireNonEmptyString(record.recipient_encryption_key, `${label}.recipient_encryption_key`)
+		server_id: coerceNonEmptyString(record.server_id, `${label}.server_id`),
+		key_epoch: coerceNonEmptyString(record.key_epoch, `${label}.key_epoch`),
+		recipient_encryption_key: coerceNonEmptyString(record.recipient_encryption_key, `${label}.recipient_encryption_key`)
 	};
 }
 function parseReusableWalletSessionAuthorizedOperation(value, label) {
@@ -319,16 +315,16 @@ function parseReusableWalletSessionAuthorizedOperation(value, label) {
 		"display_digest_b64u",
 		"operation_fingerprint_digest"
 	], label);
-	const kind = requireNonEmptyString(record.kind, `${label}.kind`);
+	const kind = coerceNonEmptyString(record.kind, `${label}.kind`);
 	if (kind !== "reusable_wallet_session_authorized_operation_v1") throw new Error(`${label}.kind is invalid`);
-	const capabilityKind = requireNonEmptyString(record.capability_kind, `${label}.capability_kind`);
+	const capabilityKind = coerceNonEmptyString(record.capability_kind, `${label}.capability_kind`);
 	if (capabilityKind !== "near_ed25519_mpc_signing") throw new Error(`${label}.capability_kind is invalid`);
-	const operationKind = requireNonEmptyString(record.operation_kind, `${label}.operation_kind`);
+	const operationKind = coerceNonEmptyString(record.operation_kind, `${label}.operation_kind`);
 	if (operationKind !== "near.sign_transaction" && operationKind !== "near.sign_delegate_action" && operationKind !== "near.sign_nep413_message") throw new Error(`${label}.operation_kind is invalid`);
 	return {
 		kind,
-		authorized_operation_id: requireNonEmptyString(record.authorized_operation_id, `${label}.authorized_operation_id`),
-		operation_id: requireNonEmptyString(record.operation_id, `${label}.operation_id`),
+		authorized_operation_id: coerceNonEmptyString(record.authorized_operation_id, `${label}.authorized_operation_id`),
+		operation_id: coerceNonEmptyString(record.operation_id, `${label}.operation_id`),
 		capability_kind: capabilityKind,
 		operation_kind: operationKind,
 		lane_digest_b64u: requireDigestB64u(record.lane_digest_b64u, `${label}.lane_digest_b64u`),
@@ -353,16 +349,16 @@ function parseVerifiedStepUpAuthorizedOperation(value, label) {
 		"display_digest_b64u",
 		"operation_fingerprint_digest"
 	], label);
-	if (requireNonEmptyString(record.kind, `${label}.kind`) !== "verified_step_up_authorized_operation_v1") throw new Error(`${label}.kind is invalid`);
-	if (requireNonEmptyString(record.capability_kind, `${label}.capability_kind`) !== "near_ed25519_mpc_signing") throw new Error(`${label}.capability_kind is invalid`);
-	const operationKind = requireNonEmptyString(record.operation_kind, `${label}.operation_kind`);
+	if (coerceNonEmptyString(record.kind, `${label}.kind`) !== "verified_step_up_authorized_operation_v1") throw new Error(`${label}.kind is invalid`);
+	if (coerceNonEmptyString(record.capability_kind, `${label}.capability_kind`) !== "near_ed25519_mpc_signing") throw new Error(`${label}.capability_kind is invalid`);
+	const operationKind = coerceNonEmptyString(record.operation_kind, `${label}.operation_kind`);
 	if (operationKind !== "near.sign_transaction" && operationKind !== "near.sign_delegate_action" && operationKind !== "near.sign_nep413_message") throw new Error(`${label}.operation_kind is invalid`);
 	return {
 		kind: "verified_step_up_authorized_operation_v1",
-		authorization_session_id: requireNonEmptyString(record.authorization_session_id, `${label}.authorization_session_id`),
+		authorization_session_id: coerceNonEmptyString(record.authorization_session_id, `${label}.authorization_session_id`),
 		evidence_set_digest: requireDigestB64u(record.evidence_set_digest, `${label}.evidence_set_digest`),
-		authorized_operation_id: requireNonEmptyString(record.authorized_operation_id, `${label}.authorized_operation_id`),
-		operation_id: requireNonEmptyString(record.operation_id, `${label}.operation_id`),
+		authorized_operation_id: coerceNonEmptyString(record.authorized_operation_id, `${label}.authorized_operation_id`),
+		operation_id: coerceNonEmptyString(record.operation_id, `${label}.operation_id`),
 		capability_kind: "near_ed25519_mpc_signing",
 		operation_kind: operationKind,
 		lane_digest_b64u: requireDigestB64u(record.lane_digest_b64u, `${label}.lane_digest_b64u`),
@@ -374,7 +370,7 @@ function parseVerifiedStepUpAuthorizedOperation(value, label) {
 function parsePrepareResponse(value) {
 	const record = value && typeof value === "object" ? value : null;
 	if (!record) throw new Error("Router A/B normal-signing prepare response must be an object");
-	const signatureScheme = requireNonEmptyString(record.signature_scheme, "signature_scheme");
+	const signatureScheme = coerceNonEmptyString(record.signature_scheme, "signature_scheme");
 	if (signatureScheme !== "ed25519_v1") throw new Error(`Unsupported Router A/B normal-signing signature scheme: ${signatureScheme}`);
 	const scope = parseScope(record.scope, "scope");
 	const base = {
@@ -382,9 +378,9 @@ function parsePrepareResponse(value) {
 		signing_payload_digest: parseDigest32(record.signing_payload_digest, "signing_payload_digest"),
 		round1_binding_digest: parseDigest32(record.round1_binding_digest, "round1_binding_digest"),
 		signing_worker: parseServerIdentity(record.signing_worker, "signing_worker"),
-		server_round1_handle: requireNonEmptyString(record.server_round1_handle, "server_round1_handle"),
+		server_round1_handle: coerceNonEmptyString(record.server_round1_handle, "server_round1_handle"),
 		server_commitments: parseCommitments(record.server_commitments, "server_commitments"),
-		server_verifying_share_b64u: requireNonEmptyString(record.server_verifying_share_b64u, "server_verifying_share_b64u"),
+		server_verifying_share_b64u: coerceNonEmptyString(record.server_verifying_share_b64u, "server_verifying_share_b64u"),
 		signature_scheme: "ed25519_v1",
 		prepared_at_ms: requirePositiveInteger(record.prepared_at_ms, "prepared_at_ms"),
 		expires_at_ms: requirePositiveInteger(record.expires_at_ms, "expires_at_ms")
@@ -447,7 +443,7 @@ function parseNormalSigningResponse(value) {
 		"signature",
 		"signed_at_ms"
 	], "Router A/B normal-signing response");
-	const signatureScheme = requireNonEmptyString(record.signature_scheme, "signature_scheme");
+	const signatureScheme = coerceNonEmptyString(record.signature_scheme, "signature_scheme");
 	if (signatureScheme !== "ed25519_v1") throw new Error(`Unsupported Router A/B normal-signing signature scheme: ${signatureScheme}`);
 	return {
 		scope: parseScope(record.scope, "scope"),
@@ -636,7 +632,7 @@ function routerAbSigningHttpError(args) {
 }
 async function postRouterAbNormalSigningJson(args) {
 	if (typeof fetch !== "function") throw new Error("fetch is not available for Router A/B normal-signing request");
-	const base = normalizeRelayerBaseUrl(requireNonEmptyString(args.relayServerUrl, "relayServerUrl"));
+	const base = normalizeRelayerBaseUrl(coerceNonEmptyString(args.relayServerUrl, "relayServerUrl"));
 	const response = await fetch(`${base}${args.path}`, {
 		...buildRouterAbRequestInit({
 			credential: args.credential,
@@ -677,31 +673,6 @@ async function prepareRouterAbEcdsaDerivationEvmDigestSigningV1(args) {
 		parse: (value) => parseRouterAbEcdsaDerivationEvmDigestSigningPrepareResponseForRequestV1(args.request, value)
 	});
 }
-async function parseFinalBatchPrepareResponse(request, value) {
-	if (!value || typeof value !== "object" || !("prepared_response" in value) || !("outgoing_messages_b64u" in value)) throw new Error("Invalid terminal prepare response");
-	const messages = value.outgoing_messages_b64u;
-	if (!Array.isArray(messages) || messages.length !== 1 || typeof messages[0] !== "string" || !/^[A-Za-z0-9_-]+$/.test(messages[0])) throw new Error("Terminal prepare response must contain one protocol message");
-	return {
-		preparedResponse: await parseRouterAbEcdsaDerivationEvmDigestSigningPrepareResponseForRequestV1(request, value.prepared_response),
-		outgoingMessagesB64u: [messages[0]]
-	};
-}
-async function prepareRouterAbEcdsaFinalPresignBatchV1(args) {
-	await routerAbEcdsaDerivationEvmDigestSigningRequestDigestV1(args.request);
-	const timeoutMs = Math.min(5e3, args.source.batch.ceremony_expires_at_ms - Date.now());
-	if (timeoutMs <= 0) throw new Error("Terminal presign ceremony expired before prepare");
-	return postRouterAbNormalSigningJson({
-		signal: AbortSignal.timeout(Math.floor(timeoutMs)),
-		relayServerUrl: args.relayServerUrl,
-		path: "/router-ab/ecdsa-derivation/sign/prepare",
-		credential: args.credential,
-		body: {
-			...args.request,
-			presign_source: args.source
-		},
-		parse: parseFinalBatchPrepareResponse.bind(void 0, args.request)
-	});
-}
 async function finalizeRouterAbNormalSigningV2(args) {
 	return postRouterAbNormalSigningJson({
 		relayServerUrl: args.relayServerUrl,
@@ -836,6 +807,6 @@ function sameBytes(left, right) {
 	return left.length === right.length && left.every((byte, index) => byte === right[index]);
 }
 //#endregion
-export { RouterAbSigningRequestError, buildRouterAbEd25519DelegateActionPrepareRequestV2, buildRouterAbEd25519NearTransactionPrepareRequestV2, buildRouterAbEd25519Nep413PrepareRequestV2, buildRouterAbEd25519NormalSigningFinalizeRequestV2, finalizeRouterAbEcdsaDerivationEvmDigestSigningV1, finalizeRouterAbNormalSigningV2, prepareRouterAbEcdsaDerivationEvmDigestSigningV1, prepareRouterAbEcdsaFinalPresignBatchV1, prepareRouterAbNormalSigningV2, routerAbCanonicalWireBytesToB64u, routerAbNormalSigningActionFingerprint };
+export { RouterAbSigningRequestError, buildRouterAbEd25519DelegateActionPrepareRequestV2, buildRouterAbEd25519NearTransactionPrepareRequestV2, buildRouterAbEd25519Nep413PrepareRequestV2, buildRouterAbEd25519NormalSigningFinalizeRequestV2, finalizeRouterAbEcdsaDerivationEvmDigestSigningV1, finalizeRouterAbNormalSigningV2, prepareRouterAbEcdsaDerivationEvmDigestSigningV1, prepareRouterAbNormalSigningV2, routerAbCanonicalWireBytesToB64u, routerAbNormalSigningActionFingerprint };
 
 //# sourceMappingURL=routerAbNormalSigning.js.map

package/dist/esm/react/core/rpcClients/relayer/walletRecoveryPrepare.js

@@ -1,13 +1,13 @@
 import "../../../shared-ts/src/utils/encoders.js";
 import { normalizeRuntimePolicyScope } from "../../../shared-ts/src/threshold/signingRootScope.js";
 import "../../../shared-ts/src/utils/signingSessionSeal.js";
-import { requireEvmFamilySigningKeySlotId } from "../../../shared-ts/src/signing-lanes/evmFamilySigningKeySlotId.js";
-import { ecdsaClientRootPublicKey33B64uFromString, parseSdkEcdsaDerivationSigningRootId, parseSdkEcdsaDerivationSigningRootVersion, parseSdkEcdsaDerivationThresholdKeyId } from "../../../shared-ts/src/threshold/ecdsaDerivationRoleLocalBootstrap.js";
 import { parseEcdsaServerGeneration } from "../../../shared-ts/src/utils/ecdsaCapabilityActivation.js";
 import { parseRouterAbMpcMaterialActivationRef } from "../../../shared-ts/src/utils/routerAbNormalSigningIdentity.js";
 import "../../../shared-ts/src/authorization/capabilityKinds.js";
 import { parseDigestField } from "../../../shared-ts/src/passkey-custody/primitives.js";
 import { parseRouterAbEcdsaDerivationPublicCapabilityV1, parseRouterAbEcdsaRegistrationActivationReceiptV1 } from "../../../shared-ts/src/utils/routerAbEcdsaDerivation.js";
+import { requireEvmFamilySigningKeySlotId } from "../../../shared-ts/src/signing-lanes/evmFamilySigningKeySlotId.js";
+import { ecdsaClientRootPublicKey33B64uFromString, parseSdkEcdsaDerivationSigningRootId, parseSdkEcdsaDerivationSigningRootVersion, parseSdkEcdsaDerivationThresholdKeyId } from "../../../shared-ts/src/threshold/ecdsaDerivationRoleLocalBootstrap.js";
 import "../../../shared-ts/src/signing-lanes/index.js";
 import "../../../shared-ts/src/passkey-custody/index.js";
 import { parseWalletRecoveryEcdsaPossessionChallengeV1 } from "../../../shared-ts/src/wallet-recovery/walletRecoveryEcdsaPossession.js";

package/dist/esm/react/core/rpcClients/relayer/walletRecoveryRotate.js

@@ -1,5 +1,4 @@
 import { buildRelayerJsonPostRequestInit, normalizeRelayerBaseUrl } from "./relayerHttp.js";
-import "../../../shared-ts/src/wallet-recovery/walletRecoveryEnvelopeSet.js";
 //#region src/core/rpcClients/relayer/walletRecoveryRotate.ts
 const WALLET_RECOVERY_ROTATE_PATH = "/wallets/recovery/rotate";
 const WALLET_RECOVERY_ACK_PATH = "/wallets/recovery/acknowledge-backup";