@defuse-protocol/intents-sdk 0.82.0 → 0.83.0

package/dist/src/bridges/omni-bridge/omni-bridge-utils.cjs

@@ -58,7 +58,8 @@ const CHAIN_MAPPINGS = [
 	[require_caip2.Chains.Fogo, _omni_bridge_core.ChainKind.Fogo],
 	[require_caip2.Chains.Polygon, _omni_bridge_core.ChainKind.Pol],
 	[require_caip2.Chains.Aptos, _omni_bridge_core.ChainKind.Aptos],
-	[require_caip2.Chains.HyperEvm, _omni_bridge_core.ChainKind.HlEvm]
+	[require_caip2.Chains.HyperEvm, _omni_bridge_core.ChainKind.HlEvm],
+	[require_caip2.Chains.Zcash, _omni_bridge_core.ChainKind.Zcash]
 ];
 function chainKindToCaip2(network) {
 	return CHAIN_MAPPINGS.find(([_, kind]) => kind === network)?.[0] ?? null;
@@ -83,7 +84,7 @@ async function getAccountOmniStorageBalance(nearProvider, accountId) {
 		})])
 	});
 }
-const OmniAddressSchema = valibot.custom((input) => typeof input === "string" && (input.startsWith("eth:") || input.startsWith("near:") || input.startsWith("sol:") || input.startsWith("arb:") || input.startsWith("base:") || input.startsWith("btc:") || input.startsWith("bnb:") || input.startsWith("abs:") || input.startsWith("strk:") || input.startsWith("fogo:") || input.startsWith("pol:") || input.startsWith("aptos:") || input.startsWith("hlevm:")), "Must comply with omni address schema");
+const OmniAddressSchema = valibot.custom((input) => typeof input === "string" && (input.startsWith("eth:") || input.startsWith("near:") || input.startsWith("sol:") || input.startsWith("arb:") || input.startsWith("base:") || input.startsWith("btc:") || input.startsWith("bnb:") || input.startsWith("abs:") || input.startsWith("strk:") || input.startsWith("fogo:") || input.startsWith("pol:") || input.startsWith("aptos:") || input.startsWith("hlevm:") || input.startsWith("zcash:")), "Must comply with omni address schema");
 /**
 * Converts a token address from one chain to its equivalent on another chain.
 * @param nearProvider Near provider used for querying the contract

package/dist/src/bridges/omni-bridge/omni-bridge-utils.js

@@ -56,7 +56,8 @@ const CHAIN_MAPPINGS = [
 	[Chains.Fogo, ChainKind.Fogo],
 	[Chains.Polygon, ChainKind.Pol],
 	[Chains.Aptos, ChainKind.Aptos],
-	[Chains.HyperEvm, ChainKind.HlEvm]
+	[Chains.HyperEvm, ChainKind.HlEvm],
+	[Chains.Zcash, ChainKind.Zcash]
 ];
 function chainKindToCaip2(network) {
 	return CHAIN_MAPPINGS.find(([_, kind]) => kind === network)?.[0] ?? null;
@@ -81,7 +82,7 @@ async function getAccountOmniStorageBalance(nearProvider, accountId) {
 		})])
 	});
 }
-const OmniAddressSchema = v.custom((input) => typeof input === "string" && (input.startsWith("eth:") || input.startsWith("near:") || input.startsWith("sol:") || input.startsWith("arb:") || input.startsWith("base:") || input.startsWith("btc:") || input.startsWith("bnb:") || input.startsWith("abs:") || input.startsWith("strk:") || input.startsWith("fogo:") || input.startsWith("pol:") || input.startsWith("aptos:") || input.startsWith("hlevm:")), "Must comply with omni address schema");
+const OmniAddressSchema = v.custom((input) => typeof input === "string" && (input.startsWith("eth:") || input.startsWith("near:") || input.startsWith("sol:") || input.startsWith("arb:") || input.startsWith("base:") || input.startsWith("btc:") || input.startsWith("bnb:") || input.startsWith("abs:") || input.startsWith("strk:") || input.startsWith("fogo:") || input.startsWith("pol:") || input.startsWith("aptos:") || input.startsWith("hlevm:") || input.startsWith("zcash:")), "Must comply with omni address schema");
 /**
 * Converts a token address from one chain to its equivalent on another chain.
 * @param nearProvider Near provider used for querying the contract

package/dist/src/bridges/omni-bridge/omni-withdraw-params.cjs

@@ -61,7 +61,7 @@ function deriveOmniWithdrawIntentParams(params) {
 function caip2ToChainKind(network) {
 	return require_omni_bridge_utils.CHAIN_MAPPINGS.find(([chain]) => chain === network)?.[1] ?? null;
 }
-const UTXO_CHAINS = [_omni_bridge_core.ChainKind.Btc];
+const UTXO_CHAINS = [_omni_bridge_core.ChainKind.Btc, _omni_bridge_core.ChainKind.Zcash];
 function isUtxoChain(network) {
 	return UTXO_CHAINS.includes(network);
 }

package/dist/src/bridges/omni-bridge/omni-withdraw-params.js

@@ -60,7 +60,7 @@ function deriveOmniWithdrawIntentParams(params) {
 function caip2ToChainKind(network) {
 	return CHAIN_MAPPINGS.find(([chain]) => chain === network)?.[1] ?? null;
 }
-const UTXO_CHAINS = [ChainKind.Btc];
+const UTXO_CHAINS = [ChainKind.Btc, ChainKind.Zcash];
 function isUtxoChain(network) {
 	return UTXO_CHAINS.includes(network);
 }

package/dist/src/bridges/poa-bridge/poa-bridge-utils.cjs

@@ -31,7 +31,6 @@ const caip2Mapping = {
 	[require_caip2.Chains.BitcoinCash]: "bch:mainnet",
 	[require_caip2.Chains.Dogecoin]: "doge:mainnet",
 	[require_caip2.Chains.XRPL]: "xrp:mainnet",
-	[require_caip2.Chains.Zcash]: "zec:mainnet",
 	[require_caip2.Chains.Gnosis]: "eth:100",
 	[require_caip2.Chains.Berachain]: "eth:80094",
 	[require_caip2.Chains.Tron]: "tron:mainnet",
@@ -56,7 +55,6 @@ const tokenPrefixMapping = {
 	bch: require_caip2.Chains.BitcoinCash,
 	doge: require_caip2.Chains.Dogecoin,
 	xrp: require_caip2.Chains.XRPL,
-	zec: require_caip2.Chains.Zcash,
 	gnosis: require_caip2.Chains.Gnosis,
 	bera: require_caip2.Chains.Berachain,
 	tron: require_caip2.Chains.Tron,

package/dist/src/bridges/poa-bridge/poa-bridge-utils.js

@@ -30,7 +30,6 @@ const caip2Mapping = {
 	[Chains.BitcoinCash]: "bch:mainnet",
 	[Chains.Dogecoin]: "doge:mainnet",
 	[Chains.XRPL]: "xrp:mainnet",
-	[Chains.Zcash]: "zec:mainnet",
 	[Chains.Gnosis]: "eth:100",
 	[Chains.Berachain]: "eth:80094",
 	[Chains.Tron]: "tron:mainnet",
@@ -55,7 +54,6 @@ const tokenPrefixMapping = {
 	bch: Chains.BitcoinCash,
 	doge: Chains.Dogecoin,
 	xrp: Chains.XRPL,
-	zec: Chains.Zcash,
 	gnosis: Chains.Gnosis,
 	bera: Chains.Berachain,
 	tron: Chains.Tron,

package/dist/src/constants/poa-tokens-migrated-to-omni-bridge.cjs

@@ -3,7 +3,8 @@ let _omni_bridge_core = require("@omni-bridge/core");
 
 //#region src/constants/poa-tokens-migrated-to-omni-bridge.ts
 /**
-* These tokens originaly have been PoA Bridge tokens but have been migrated to Omni bridge.
+* These tokens originally were PoA Bridge tokens but have since been migrated to Omni Bridge.
+* Every migrated token must be listed here, otherwise the PoA bridge class (supports, parseAssetId methods) will keep treating it as a PoA token.
 */
 const POA_TOKENS_MIGRATED_TO_OMNI_BRIDGE = {
 	"sol-57d087fd8c460f612f8701f5499ad8b2eec5ab68.omft.near": _omni_bridge_core.ChainKind.Sol,
@@ -21,7 +22,8 @@ const POA_TOKENS_MIGRATED_TO_OMNI_BRIDGE = {
 	"aptos.omft.near": _omni_bridge_core.ChainKind.Aptos,
 	"aptos-34ee497f210c5a511e8d5b53bc56d75b63612bb5.omft.near": _omni_bridge_core.ChainKind.Aptos,
 	"aptos-88cb7619440a914fe6400149a12b443c3ac21d59.omft.near": _omni_bridge_core.ChainKind.Aptos,
-	"starknet.omft.near": _omni_bridge_core.ChainKind.Strk
+	"starknet.omft.near": _omni_bridge_core.ChainKind.Strk,
+	"zec.omft.near": _omni_bridge_core.ChainKind.Zcash
 };
 
 //#endregion

package/dist/src/constants/poa-tokens-migrated-to-omni-bridge.d.cts

@@ -3,7 +3,8 @@ import { ChainKind } from "@omni-bridge/core";
 //#region src/constants/poa-tokens-migrated-to-omni-bridge.d.ts
 
 /**
- * These tokens originaly have been PoA Bridge tokens but have been migrated to Omni bridge.
+ * These tokens originally were PoA Bridge tokens but have since been migrated to Omni Bridge.
+ * Every migrated token must be listed here, otherwise the PoA bridge class (supports, parseAssetId methods) will keep treating it as a PoA token.
  */
 declare const POA_TOKENS_MIGRATED_TO_OMNI_BRIDGE: Record<string, ChainKind>;
 //#endregion

package/dist/src/constants/poa-tokens-migrated-to-omni-bridge.d.ts

@@ -3,7 +3,8 @@ import { ChainKind } from "@omni-bridge/core";
 //#region src/constants/poa-tokens-migrated-to-omni-bridge.d.ts
 
 /**
- * These tokens originaly have been PoA Bridge tokens but have been migrated to Omni bridge.
+ * These tokens originally were PoA Bridge tokens but have since been migrated to Omni Bridge.
+ * Every migrated token must be listed here, otherwise the PoA bridge class (supports, parseAssetId methods) will keep treating it as a PoA token.
  */
 declare const POA_TOKENS_MIGRATED_TO_OMNI_BRIDGE: Record<string, ChainKind>;
 //#endregion

package/dist/src/constants/poa-tokens-migrated-to-omni-bridge.js

@@ -2,7 +2,8 @@ import { ChainKind } from "@omni-bridge/core";
 
 //#region src/constants/poa-tokens-migrated-to-omni-bridge.ts
 /**
-* These tokens originaly have been PoA Bridge tokens but have been migrated to Omni bridge.
+* These tokens originally were PoA Bridge tokens but have since been migrated to Omni Bridge.
+* Every migrated token must be listed here, otherwise the PoA bridge class (supports, parseAssetId methods) will keep treating it as a PoA token.
 */
 const POA_TOKENS_MIGRATED_TO_OMNI_BRIDGE = {
 	"sol-57d087fd8c460f612f8701f5499ad8b2eec5ab68.omft.near": ChainKind.Sol,
@@ -20,7 +21,8 @@ const POA_TOKENS_MIGRATED_TO_OMNI_BRIDGE = {
 	"aptos.omft.near": ChainKind.Aptos,
 	"aptos-34ee497f210c5a511e8d5b53bc56d75b63612bb5.omft.near": ChainKind.Aptos,
 	"aptos-88cb7619440a914fe6400149a12b443c3ac21d59.omft.near": ChainKind.Aptos,
-	"starknet.omft.near": ChainKind.Strk
+	"starknet.omft.near": ChainKind.Strk,
+	"zec.omft.near": ChainKind.Zcash
 };
 
 //#endregion

package/dist/src/lib/validateAddress.cjs

@@ -1,6 +1,7 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
 const require_caip2 = require('./caip2.cjs');
 const require_ton_address = require('./ton-address.cjs');
+const require_zcash_unified_address = require('./zcash-unified-address.cjs');
 let _defuse_protocol_internal_utils = require("@defuse-protocol/internal-utils");
 let viem = require("viem");
 let _noble_hashes_sha2 = require("@noble/hashes/sha2");
@@ -199,6 +200,7 @@ function validateXrpAddress(address) {
 * Supports:
 * - Transparent addresses (t1, t3)
 * - TEX addresses (tex1)
+* - Unified Orchard / Unified Addresses (UA)
 */
 function validateZcashAddress(address) {
 	if (address.startsWith("t1") || address.startsWith("t3")) return /^t[13][a-km-zA-HJ-NP-Z1-9]{33}$/.test(address);
@@ -210,12 +212,7 @@ function validateZcashAddress(address) {
 	} catch {
 		return false;
 	}
-	const uaHrp = "u";
-	if (address.startsWith(`${uaHrp}1`)) try {
-		return _scure_base.bech32m.decodeToBytes(address).prefix === uaHrp;
-	} catch {
-		return false;
-	}
+	if (address.startsWith("u1")) return require_zcash_unified_address.validateZcashUnifiedAddress(address);
 	return false;
 }
 /**

package/dist/src/lib/validateAddress.js

@@ -1,5 +1,6 @@
 import { Chains } from "./caip2.js";
 import { TON_ADDRESS_TAG_BOUNCEABLE_MAINNET, TON_ADDRESS_TAG_NON_BOUNCEABLE_MAINNET, TON_WORKCHAIN_BASECHAIN, TON_WORKCHAIN_MASTERCHAIN, tryParseTonAddress } from "./ton-address.js";
+import { validateZcashUnifiedAddress } from "./zcash-unified-address.js";
 import { utils } from "@defuse-protocol/internal-utils";
 import { isAddress } from "viem";
 import { sha256 } from "@noble/hashes/sha2";
@@ -198,6 +199,7 @@ function validateXrpAddress(address) {
 * Supports:
 * - Transparent addresses (t1, t3)
 * - TEX addresses (tex1)
+* - Unified Orchard / Unified Addresses (UA)
 */
 function validateZcashAddress(address) {
 	if (address.startsWith("t1") || address.startsWith("t3")) return /^t[13][a-km-zA-HJ-NP-Z1-9]{33}$/.test(address);
@@ -209,12 +211,7 @@ function validateZcashAddress(address) {
 	} catch {
 		return false;
 	}
-	const uaHrp = "u";
-	if (address.startsWith(`${uaHrp}1`)) try {
-		return bech32m.decodeToBytes(address).prefix === uaHrp;
-	} catch {
-		return false;
-	}
+	if (address.startsWith("u1")) return validateZcashUnifiedAddress(address);
 	return false;
 }
 /**

package/dist/src/lib/zcash-unified-address.cjs

@@ -0,0 +1,192 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+let _scure_base = require("@scure/base");
+let _noble_hashes_blake2 = require("@noble/hashes/blake2");
+
+//#region src/lib/zcash-unified-address.ts
+/**
+* Zcash Unified Address (ZIP 316) validation.
+*
+* Reference implementation used to cross-check this code:
+*   - crate:  `zcash_address`  https://crates.io/crates/zcash_address
+*   - crate:  `f4jumble`       https://crates.io/crates/f4jumble
+*   - source: https://github.com/zcash/librustzcash/tree/main/components/zcash_address
+*             https://github.com/zcash/librustzcash/tree/main/components/f4jumble
+*
+* Spec: https://zips.z.cash/zip-0316
+*/
+const ZCASH_UA_MAINNET_HRP = "u";
+const F4_MIN_LEN = 48;
+const F4_MAX_LEN = 4194368;
+const F4_BLAKE2B_LEN = 64;
+const G_PREFIX = asciiBytes("UA_F4Jumble_G");
+const H_PREFIX = asciiBytes("UA_F4Jumble_H");
+const RECEIVER_TYPECODE = {
+	P2PKH: 0,
+	P2SH: 1,
+	SAPLING: 2,
+	ORCHARD: 3
+};
+const MAX_TYPECODE_OR_LENGTH = 33554432;
+const MUST_UNDERSTAND_METADATA_MIN = 224;
+const MUST_UNDERSTAND_METADATA_MAX = 252;
+const KNOWN_RECEIVER_LENGTH = {
+	[RECEIVER_TYPECODE.P2PKH]: 20,
+	[RECEIVER_TYPECODE.P2SH]: 20,
+	[RECEIVER_TYPECODE.SAPLING]: 43,
+	[RECEIVER_TYPECODE.ORCHARD]: 43
+};
+/**
+* Validates a Zcash Unified Address (ZIP 316) and requires that it contains
+* at least one Orchard, P2PKH, or P2SH receiver. Sapling-only UAs are rejected.
+*
+* The parse pipeline (bech32m → F4Jumble⁻¹ → padding check → receiver list)
+* mirrors `Encoding::parse_items` in
+* https://github.com/zcash/librustzcash/blob/main/components/zcash_address/src/kind/unified.rs
+*/
+function validateZcashUnifiedAddress(address) {
+	try {
+		const decoded = _scure_base.bech32m.decodeToBytes(address);
+		if (decoded.prefix !== ZCASH_UA_MAINNET_HRP) return false;
+		const payload = decoded.bytes;
+		if (payload.length < F4_MIN_LEN || payload.length > F4_MAX_LEN) return false;
+		const unjumbled = f4JumbleInverse(payload);
+		const paddingLen = 16;
+		if (unjumbled.length <= paddingLen) return false;
+		const paddingStart = unjumbled.length - paddingLen;
+		if (unjumbled[paddingStart] !== ZCASH_UA_MAINNET_HRP.charCodeAt(0)) return false;
+		for (let i = paddingStart + 1; i < unjumbled.length; i++) if (unjumbled[i] !== 0) return false;
+		let offset = 0;
+		let lastTypecode = -1;
+		let hasOrchardOrTransparent = false;
+		let hasP2pkh = false;
+		let hasP2sh = false;
+		while (offset < paddingStart) {
+			const typeRead = readCompactSize(unjumbled, offset, paddingStart);
+			if (typeRead === null) return false;
+			const typecode = typeRead.value;
+			offset = typeRead.next;
+			if (typecode > MAX_TYPECODE_OR_LENGTH) return false;
+			if (typecode <= lastTypecode) return false;
+			lastTypecode = typecode;
+			const lenRead = readCompactSize(unjumbled, offset, paddingStart);
+			if (lenRead === null) return false;
+			const len = lenRead.value;
+			offset = lenRead.next;
+			if (len === 0 || len > MAX_TYPECODE_OR_LENGTH) return false;
+			if (offset + len > paddingStart) return false;
+			const expectedLen = KNOWN_RECEIVER_LENGTH[typecode];
+			if (expectedLen !== void 0 && len !== expectedLen) return false;
+			if (expectedLen === void 0 && typecode >= MUST_UNDERSTAND_METADATA_MIN && typecode <= MUST_UNDERSTAND_METADATA_MAX) return false;
+			if (typecode === RECEIVER_TYPECODE.P2PKH) hasP2pkh = true;
+			if (typecode === RECEIVER_TYPECODE.P2SH) hasP2sh = true;
+			if (typecode === RECEIVER_TYPECODE.P2PKH || typecode === RECEIVER_TYPECODE.P2SH || typecode === RECEIVER_TYPECODE.ORCHARD) hasOrchardOrTransparent = true;
+			offset += len;
+		}
+		if (offset !== paddingStart) return false;
+		if (hasP2pkh && hasP2sh) return false;
+		return hasOrchardOrTransparent;
+	} catch {
+		return false;
+	}
+}
+/**
+* Bitcoin-style CompactSize decoder, canonical form only.
+* Reference: `CompactSize::read` in
+* https://github.com/zcash/librustzcash/blob/main/components/zcash_encoding/src/lib.rs
+*/
+function readCompactSize(buf, offset, end) {
+	if (offset >= end) return null;
+	const first = buf[offset];
+	if (first === void 0) return null;
+	if (first < 253) return {
+		value: first,
+		next: offset + 1
+	};
+	if (first === 253) {
+		if (offset + 3 > end) return null;
+		const b1 = buf[offset + 1];
+		const b2 = buf[offset + 2];
+		if (b1 === void 0 || b2 === void 0) return null;
+		const value = b1 | b2 << 8;
+		if (value < 253) return null;
+		return {
+			value,
+			next: offset + 3
+		};
+	}
+	if (first === 254) {
+		if (offset + 5 > end) return null;
+		const b1 = buf[offset + 1];
+		const b2 = buf[offset + 2];
+		const b3 = buf[offset + 3];
+		const b4 = buf[offset + 4];
+		if (b1 === void 0 || b2 === void 0 || b3 === void 0 || b4 === void 0) return null;
+		const value = (b1 | b2 << 8 | b3 << 16 | b4 << 24) >>> 0;
+		if (value <= 65535) return null;
+		return {
+			value,
+			next: offset + 5
+		};
+	}
+	return null;
+}
+/**
+* Inverse of ZIP 316 F4Jumble: a 4-round unkeyed Feistel over BLAKE2b.
+* Forward:  x = b ⊕ G_0(a);  y = a ⊕ H_0(x);  d = x ⊕ G_1(y);  c = y ⊕ H_1(d)
+* Inverse undoes each XOR in reverse order.
+*
+* Reference: `State::apply_f4jumble_inv` in
+* https://github.com/zcash/librustzcash/blob/main/components/f4jumble/src/lib.rs
+*/
+function f4JumbleInverse(msg) {
+	const len = msg.length;
+	const lLen = Math.min(F4_BLAKE2B_LEN, Math.floor(len / 2));
+	const rLen = len - lLen;
+	const left = msg.slice(0, lLen);
+	const right = msg.slice(lLen);
+	xorInto(left, hI(1, right, lLen));
+	xorInto(right, gI(1, left, rLen));
+	xorInto(left, hI(0, right, lLen));
+	xorInto(right, gI(0, left, rLen));
+	const out = new Uint8Array(len);
+	out.set(left, 0);
+	out.set(right, lLen);
+	return out;
+}
+function hI(i, u, lLen) {
+	return (0, _noble_hashes_blake2.blake2b)(u, {
+		personalization: buildPersonalization(H_PREFIX, i, 0),
+		dkLen: lLen
+	});
+}
+function gI(i, u, rLen) {
+	const chunks = Math.ceil(rLen / F4_BLAKE2B_LEN);
+	const out = new Uint8Array(chunks * F4_BLAKE2B_LEN);
+	for (let j = 0; j < chunks; j++) {
+		const digest = (0, _noble_hashes_blake2.blake2b)(u, {
+			personalization: buildPersonalization(G_PREFIX, i, j),
+			dkLen: F4_BLAKE2B_LEN
+		});
+		out.set(digest, j * F4_BLAKE2B_LEN);
+	}
+	return out.subarray(0, rLen);
+}
+function buildPersonalization(prefix, i, j) {
+	const p = new Uint8Array(16);
+	p.set(prefix, 0);
+	p[13] = i & 255;
+	p[14] = j & 255;
+	p[15] = j >> 8 & 255;
+	return p;
+}
+function asciiBytes(s) {
+	const out = new Uint8Array(s.length);
+	for (let i = 0; i < s.length; i++) out[i] = s.charCodeAt(i);
+	return out;
+}
+function xorInto(target, other) {
+	for (let i = 0; i < target.length; i++) target[i] = target[i] ^ other[i];
+}
+
+//#endregion
+exports.validateZcashUnifiedAddress = validateZcashUnifiedAddress;

package/dist/src/lib/zcash-unified-address.js

@@ -0,0 +1,191 @@
+import { bech32m } from "@scure/base";
+import { blake2b } from "@noble/hashes/blake2";
+
+//#region src/lib/zcash-unified-address.ts
+/**
+* Zcash Unified Address (ZIP 316) validation.
+*
+* Reference implementation used to cross-check this code:
+*   - crate:  `zcash_address`  https://crates.io/crates/zcash_address
+*   - crate:  `f4jumble`       https://crates.io/crates/f4jumble
+*   - source: https://github.com/zcash/librustzcash/tree/main/components/zcash_address
+*             https://github.com/zcash/librustzcash/tree/main/components/f4jumble
+*
+* Spec: https://zips.z.cash/zip-0316
+*/
+const ZCASH_UA_MAINNET_HRP = "u";
+const F4_MIN_LEN = 48;
+const F4_MAX_LEN = 4194368;
+const F4_BLAKE2B_LEN = 64;
+const G_PREFIX = asciiBytes("UA_F4Jumble_G");
+const H_PREFIX = asciiBytes("UA_F4Jumble_H");
+const RECEIVER_TYPECODE = {
+	P2PKH: 0,
+	P2SH: 1,
+	SAPLING: 2,
+	ORCHARD: 3
+};
+const MAX_TYPECODE_OR_LENGTH = 33554432;
+const MUST_UNDERSTAND_METADATA_MIN = 224;
+const MUST_UNDERSTAND_METADATA_MAX = 252;
+const KNOWN_RECEIVER_LENGTH = {
+	[RECEIVER_TYPECODE.P2PKH]: 20,
+	[RECEIVER_TYPECODE.P2SH]: 20,
+	[RECEIVER_TYPECODE.SAPLING]: 43,
+	[RECEIVER_TYPECODE.ORCHARD]: 43
+};
+/**
+* Validates a Zcash Unified Address (ZIP 316) and requires that it contains
+* at least one Orchard, P2PKH, or P2SH receiver. Sapling-only UAs are rejected.
+*
+* The parse pipeline (bech32m → F4Jumble⁻¹ → padding check → receiver list)
+* mirrors `Encoding::parse_items` in
+* https://github.com/zcash/librustzcash/blob/main/components/zcash_address/src/kind/unified.rs
+*/
+function validateZcashUnifiedAddress(address) {
+	try {
+		const decoded = bech32m.decodeToBytes(address);
+		if (decoded.prefix !== ZCASH_UA_MAINNET_HRP) return false;
+		const payload = decoded.bytes;
+		if (payload.length < F4_MIN_LEN || payload.length > F4_MAX_LEN) return false;
+		const unjumbled = f4JumbleInverse(payload);
+		const paddingLen = 16;
+		if (unjumbled.length <= paddingLen) return false;
+		const paddingStart = unjumbled.length - paddingLen;
+		if (unjumbled[paddingStart] !== ZCASH_UA_MAINNET_HRP.charCodeAt(0)) return false;
+		for (let i = paddingStart + 1; i < unjumbled.length; i++) if (unjumbled[i] !== 0) return false;
+		let offset = 0;
+		let lastTypecode = -1;
+		let hasOrchardOrTransparent = false;
+		let hasP2pkh = false;
+		let hasP2sh = false;
+		while (offset < paddingStart) {
+			const typeRead = readCompactSize(unjumbled, offset, paddingStart);
+			if (typeRead === null) return false;
+			const typecode = typeRead.value;
+			offset = typeRead.next;
+			if (typecode > MAX_TYPECODE_OR_LENGTH) return false;
+			if (typecode <= lastTypecode) return false;
+			lastTypecode = typecode;
+			const lenRead = readCompactSize(unjumbled, offset, paddingStart);
+			if (lenRead === null) return false;
+			const len = lenRead.value;
+			offset = lenRead.next;
+			if (len === 0 || len > MAX_TYPECODE_OR_LENGTH) return false;
+			if (offset + len > paddingStart) return false;
+			const expectedLen = KNOWN_RECEIVER_LENGTH[typecode];
+			if (expectedLen !== void 0 && len !== expectedLen) return false;
+			if (expectedLen === void 0 && typecode >= MUST_UNDERSTAND_METADATA_MIN && typecode <= MUST_UNDERSTAND_METADATA_MAX) return false;
+			if (typecode === RECEIVER_TYPECODE.P2PKH) hasP2pkh = true;
+			if (typecode === RECEIVER_TYPECODE.P2SH) hasP2sh = true;
+			if (typecode === RECEIVER_TYPECODE.P2PKH || typecode === RECEIVER_TYPECODE.P2SH || typecode === RECEIVER_TYPECODE.ORCHARD) hasOrchardOrTransparent = true;
+			offset += len;
+		}
+		if (offset !== paddingStart) return false;
+		if (hasP2pkh && hasP2sh) return false;
+		return hasOrchardOrTransparent;
+	} catch {
+		return false;
+	}
+}
+/**
+* Bitcoin-style CompactSize decoder, canonical form only.
+* Reference: `CompactSize::read` in
+* https://github.com/zcash/librustzcash/blob/main/components/zcash_encoding/src/lib.rs
+*/
+function readCompactSize(buf, offset, end) {
+	if (offset >= end) return null;
+	const first = buf[offset];
+	if (first === void 0) return null;
+	if (first < 253) return {
+		value: first,
+		next: offset + 1
+	};
+	if (first === 253) {
+		if (offset + 3 > end) return null;
+		const b1 = buf[offset + 1];
+		const b2 = buf[offset + 2];
+		if (b1 === void 0 || b2 === void 0) return null;
+		const value = b1 | b2 << 8;
+		if (value < 253) return null;
+		return {
+			value,
+			next: offset + 3
+		};
+	}
+	if (first === 254) {
+		if (offset + 5 > end) return null;
+		const b1 = buf[offset + 1];
+		const b2 = buf[offset + 2];
+		const b3 = buf[offset + 3];
+		const b4 = buf[offset + 4];
+		if (b1 === void 0 || b2 === void 0 || b3 === void 0 || b4 === void 0) return null;
+		const value = (b1 | b2 << 8 | b3 << 16 | b4 << 24) >>> 0;
+		if (value <= 65535) return null;
+		return {
+			value,
+			next: offset + 5
+		};
+	}
+	return null;
+}
+/**
+* Inverse of ZIP 316 F4Jumble: a 4-round unkeyed Feistel over BLAKE2b.
+* Forward:  x = b ⊕ G_0(a);  y = a ⊕ H_0(x);  d = x ⊕ G_1(y);  c = y ⊕ H_1(d)
+* Inverse undoes each XOR in reverse order.
+*
+* Reference: `State::apply_f4jumble_inv` in
+* https://github.com/zcash/librustzcash/blob/main/components/f4jumble/src/lib.rs
+*/
+function f4JumbleInverse(msg) {
+	const len = msg.length;
+	const lLen = Math.min(F4_BLAKE2B_LEN, Math.floor(len / 2));
+	const rLen = len - lLen;
+	const left = msg.slice(0, lLen);
+	const right = msg.slice(lLen);
+	xorInto(left, hI(1, right, lLen));
+	xorInto(right, gI(1, left, rLen));
+	xorInto(left, hI(0, right, lLen));
+	xorInto(right, gI(0, left, rLen));
+	const out = new Uint8Array(len);
+	out.set(left, 0);
+	out.set(right, lLen);
+	return out;
+}
+function hI(i, u, lLen) {
+	return blake2b(u, {
+		personalization: buildPersonalization(H_PREFIX, i, 0),
+		dkLen: lLen
+	});
+}
+function gI(i, u, rLen) {
+	const chunks = Math.ceil(rLen / F4_BLAKE2B_LEN);
+	const out = new Uint8Array(chunks * F4_BLAKE2B_LEN);
+	for (let j = 0; j < chunks; j++) {
+		const digest = blake2b(u, {
+			personalization: buildPersonalization(G_PREFIX, i, j),
+			dkLen: F4_BLAKE2B_LEN
+		});
+		out.set(digest, j * F4_BLAKE2B_LEN);
+	}
+	return out.subarray(0, rLen);
+}
+function buildPersonalization(prefix, i, j) {
+	const p = new Uint8Array(16);
+	p.set(prefix, 0);
+	p[13] = i & 255;
+	p[14] = j & 255;
+	p[15] = j >> 8 & 255;
+	return p;
+}
+function asciiBytes(s) {
+	const out = new Uint8Array(s.length);
+	for (let i = 0; i < s.length; i++) out[i] = s.charCodeAt(i);
+	return out;
+}
+function xorInto(target, other) {
+	for (let i = 0; i < target.length; i++) target[i] = target[i] ^ other[i];
+}
+
+//#endregion
+export { validateZcashUnifiedAddress };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defuse-protocol/intents-sdk",
-  "version": "0.82.0",
+  "version": "0.83.0",
   "private": false,
   "type": "module",
   "repository": {
@@ -48,8 +48,8 @@
     "@hot-labs/omni-sdk": "2.25.5",
     "@isaacs/ttlcache": "^1.0.0",
     "@lifeomic/attempt": "^3.0.0",
-    "@omni-bridge/core": "0.18.0",
-    "@omni-bridge/near": "0.18.0",
+    "@omni-bridge/core": "0.19.0",
+    "@omni-bridge/near": "0.19.0",
     "@noble/hashes": "^1.7.1",
     "@scure/base": "^1.0.0",
     "borsher": "^4.0.0",