@anywalletkit/protocol-swap2-omniston 0.5.6 → 0.5.8

package/dist/index.cjs

@@ -511,6 +511,7 @@ var AUDITED_OMNISTON_EVM_ORDER_PROTOCOLS = {
 };
 
 // src/provider.ts
+var import_errors = require("@anywalletkit/protocol-swap2-core/errors");
 var import_core4 = require("@anywalletkit/core");
 var EVM_CASE = {
   1: "ethereum",
@@ -648,6 +649,54 @@ function encodeTypedMessage(td) {
     (0, import_viem.encodeAbiParameters)([paramFor(td.primaryType)], [td.message])
   );
 }
+function venueReason(error) {
+  const details = typeof error === "object" && error !== null ? error.details : void 0;
+  const info = typeof details === "object" && details !== null ? details.error_info : void 0;
+  if (typeof info !== "object" || info === null) return "upstream_unavailable";
+  const { reason, metadata } = info;
+  const meta = typeof metadata === "object" && metadata !== null ? metadata : {};
+  const type = typeof meta.type === "string" ? meta.type : "";
+  switch (reason) {
+    case "INVALID_ARGUMENT":
+    case "INVALID_PARAMETERS":
+      return void 0;
+    case "NOT_FOUND":
+      return typeof meta.object_type === "string" && meta.object_type.toLowerCase() === "quote" ? "quote_expired" : "upstream_unavailable";
+    case "UNSUPPORTED":
+      return "unsupported_pair";
+    case "SWAP_LIMIT_EXCEEDED":
+      return "amount_too_large";
+    case "QUOTE_VALIDATION_FAILED":
+      if (type === "EMULATION_UNSUPPORTED_TOKEN") return "unsupported_pair";
+      if (type === "EMULATION_WRONG_OUTPUT_AMOUNT" || type === "EMULATION_REFUND_SLIPPAGE") return "price_check_failed";
+      return type.startsWith("EMULATION_") ? "simulation_failed" : "upstream_unavailable";
+    default:
+      return "upstream_unavailable";
+  }
+}
+function venueFailure(error) {
+  if (!(error instanceof Error)) return error;
+  const reason = venueReason(error);
+  return reason ? (0, import_errors.withReason)(error, reason) : error;
+}
+function mismatchReason(field) {
+  return field === "trader" || field === "dest" || field === "owner" ? "recipient_mismatch" : "policy_refused";
+}
+function tonSwapPayloadReason(code) {
+  switch (code) {
+    case "receiver-not-destination":
+    case "refund-not-trader":
+    case "excess-not-trader":
+      return "recipient_mismatch";
+    case "min-out-zero":
+    case "min-out-below-quote":
+      return "price_check_failed";
+    case "leg-unverified":
+      return "vault_mismatch";
+    default:
+      return "policy_refused";
+  }
+}
 function generateSecret() {
   return crypto.getRandomValues(new Uint8Array(32));
 }
@@ -658,7 +707,7 @@ function hashlock(secret, hashingFunction) {
     case "HASHING_FUNCTION_SHA256":
       return (0, import_viem.sha256)(secret, "bytes");
     default:
-      throw new Error(`omniston: unsupported HTLC hashing function ${String(hashingFunction)}`);
+      throw (0, import_errors.refusal)("policy_refused", `omniston: unsupported HTLC hashing function ${String(hashingFunction)}`);
   }
 }
 function sameAsset(a, b) {
@@ -696,7 +745,7 @@ function stepJetton(asset) {
 }
 function readBigEndian(bytes, offset, length) {
   if (!Number.isInteger(offset) || !Number.isInteger(length) || length < 1 || offset < 0 || offset + length > bytes.length) {
-    throw new Error("omniston: truncated EVM order extension");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: truncated EVM order extension");
   }
   let value = 0n;
   for (let index = offset; index < offset + length; index++) value = value << 8n | BigInt(bytes[index]);
@@ -741,30 +790,30 @@ var EVM_DEST_PROTOCOL_FEE_RECIPIENTS = /* @__PURE__ */ new Set(["0x076268146b4ec
 var EVM_AUCTION_POINTS = [[800000n, 100n], [700000n, 100n], [600000n, 100n], [500000n, 100n], [400000n, 100n]];
 var EVM_TIMELOCKS = [1n, 120n, 240n, 300n, 1n, 120n, 180n, 0n].reduce((packed, value, index) => packed | value << BigInt(index * 32), 0n);
 function readEvmOrderExtension(extension) {
-  if (extension.length < 32) throw new Error("omniston: malformed EVM order extension");
+  if (extension.length < 32) throw (0, import_errors.refusal)("policy_refused", "omniston: malformed EVM order extension");
   const view = new DataView(extension.buffer, extension.byteOffset, extension.byteLength);
   const fields = [];
   let begin = 0;
   const concatLength = extension.length - 32;
   for (let index = 0; index < 8; index++) {
     const end2 = view.getUint32(28 - index * 4, false);
-    if (end2 < begin || end2 > concatLength) throw new Error("omniston: malformed EVM order extension offsets");
+    if (end2 < begin || end2 > concatLength) throw (0, import_errors.refusal)("policy_refused", "omniston: malformed EVM order extension offsets");
     fields.push(extension.slice(32 + begin, 32 + end2));
     begin = end2;
   }
   for (const index of [0, 1, 4, 5, 6]) {
-    if (fields[index].length !== 0) throw new Error("omniston: unsupported EVM order extension field");
+    if (fields[index].length !== 0) throw (0, import_errors.refusal)("policy_refused", "omniston: unsupported EVM order extension field");
   }
   if (!sliceEqual(fields[2], fields[3])) {
-    throw new Error("omniston: making/taking amount getters use different programs");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: making/taking amount getters use different programs");
   }
   let target;
   for (const index of [2, 3, 7]) {
     const field2 = fields[index];
-    if (field2.length <= 20) throw new Error("omniston: incomplete EVM order extension program");
+    if (field2.length <= 20) throw (0, import_errors.refusal)("policy_refused", "omniston: incomplete EVM order extension program");
     const address = (0, import_viem.getAddress)(`0x${bytesToHex(field2.slice(0, 20))}`);
     if (target !== void 0 && (0, import_viem.getAddress)(target) !== address) {
-      throw new Error("omniston: EVM order extension target is not independently trusted");
+      throw (0, import_errors.refusal)("vault_mismatch", "omniston: EVM order extension target is not independently trusted");
     }
     target = address;
   }
@@ -782,7 +831,7 @@ function readEvmOrderExtension(extension) {
   cursor += 3;
   const pointCount = (0, import_core4.bigintToNumber)(readBigEndian(field, cursor, 1));
   cursor += 1;
-  if (pointCount !== 5) throw new Error("omniston: unsupported EVM auction profile");
+  if (pointCount !== 5) throw (0, import_errors.refusal)("policy_refused", "omniston: unsupported EVM auction profile");
   const points = [];
   for (let index = 0; index < pointCount; index++) {
     points.push([readBigEndian(field, cursor, 3), readBigEndian(field, cursor + 3, 2)]);
@@ -799,7 +848,7 @@ function readEvmOrderExtension(extension) {
   const getterWhitelistCount = (0, import_core4.bigintToNumber)(readBigEndian(field, cursor, 1));
   cursor += 1;
   if (getterWhitelistCount !== 1 || cursor + getterWhitelistCount * 10 !== field.length) {
-    throw new Error("omniston: malformed EVM amount-getter whitelist");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: malformed EVM amount-getter whitelist");
   }
   const getter = { gasBump, gasPrice, auctionStart, duration, initialRateBump, points, integratorFee, integratorShare, resolverFee, whitelistDiscount, resolver: readBigEndian(field, cursor, 10) };
   const post = fields[7];
@@ -821,7 +870,7 @@ function readEvmOrderExtension(extension) {
   const whitelistCount = (0, import_core4.bigintToNumber)(readBigEndian(post, cursor, 1));
   cursor += 1;
   if (whitelistCount !== 1 || cursor + whitelistCount * 12 + 160 !== post.length) {
-    throw new Error("omniston: malformed EVM post-interaction whitelist");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: malformed EVM post-interaction whitelist");
   }
   const postResolver = readBigEndian(post, cursor, 10);
   cursor += 10;
@@ -833,7 +882,7 @@ function readEvmOrderExtension(extension) {
     return value;
   });
   const customData = extension.slice(32 + begin);
-  if (customData.length !== 131) throw new Error("omniston: malformed EVM order extension custom data");
+  if (customData.length !== 131) throw (0, import_errors.refusal)("policy_refused", "omniston: malformed EVM order extension custom data");
   return {
     target,
     getter,
@@ -846,29 +895,29 @@ async function validateEvmToTonOrderExtension(extension, expected) {
   const evmDest = expected.dstChainId !== void 0;
   if (evmDest && (!Number.isSafeInteger(expected.dstChainId) || expected.dstChainId <= 0)) throw new Error("omniston: invalid EVM destination chain id");
   const { target, getter, post, extra, customData } = readEvmOrderExtension(extension);
-  if (!expected.trustedTarget(target)) throw new Error("omniston: EVM order extension target is not independently trusted");
+  if (!expected.trustedTarget(target)) throw (0, import_errors.refusal)("vault_mismatch", "omniston: EVM order extension target is not independently trusted");
   const quoteResolverFee = expected.protocolFeePips % 10 === 0 ? BigInt(expected.protocolFeePips / 10) : -1n;
   const resolverLow80 = BigInt((0, import_viem.getAddress)(expected.initialResolverAddress)) & (1n << 80n) - 1n;
   if (getter.gasBump !== 0n || getter.gasPrice !== 0n || !within(getter.auctionStart, expected.quoteTimestamp, 5, 5) || getter.duration !== 1800n || getter.initialRateBump !== 900000n || getter.points.some((point, index) => point[0] !== EVM_AUCTION_POINTS[index][0] || point[1] !== EVM_AUCTION_POINTS[index][1]) || expected.integratorFeePips !== 0 || getter.integratorFee !== 0n || getter.integratorShare !== 100n || quoteResolverFee < 0n || getter.resolverFee !== quoteResolverFee || getter.whitelistDiscount !== 50n || getter.resolver !== resolverLow80) {
-    throw new Error("omniston: EVM amount-getter terms do not match the pinned v1beta8 profile");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: EVM amount-getter terms do not match the pinned v1beta8 profile");
   }
   if (!zeroBytes(post.integratorRecipient) || !(zeroBytes(post.protocolRecipient) || evmDest && EVM_DEST_PROTOCOL_FEE_RECIPIENTS.has(`0x${bytesToHex(post.protocolRecipient)}`)) || post.integratorFee !== 0n || post.integratorShare !== 100n || post.resolverFee !== quoteResolverFee || post.discount !== 50n || !within(post.allowedTime, expected.quoteTimestamp, 60, 5) || post.resolver !== resolverLow80 || post.resolverTimeDelta !== 0n) {
-    throw new Error("omniston: EVM post-interaction terms do not match the pinned v1beta8 profile");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: EVM post-interaction terms do not match the pinned v1beta8 profile");
   }
   const hashlock2 = readBigEndian(expected.secretHash, 0, expected.secretHash.length);
   const dstToken = evmDest ? BigInt((0, import_viem.getAddress)(expected.outputTokenAddress)) : BigInt((0, import_viem.getAddress)(expected.takerAsset));
   const deposits = BigInt(expected.srcSecurityDepositUnits) << 128n | BigInt(expected.dstSecurityDepositUnits);
   if (expected.secretHash.length !== 32 || extra[0] !== hashlock2 || extra[1] !== (evmDest ? BigInt(expected.dstChainId) : 0n) || extra[2] !== dstToken || extra[3] !== deposits || extra[4] !== EVM_TIMELOCKS) {
-    throw new Error("omniston: signed EVM HTLC terms do not match the validated order details");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: signed EVM HTLC terms do not match the validated order details");
   }
   await checkOrderCustomData(customData, { evmDest, outputToken: expected.outputTokenAddress, traderDst: expected.traderDstAddress, quoteId: expected.quoteId });
   if (expected.tradeStartDeadline < expected.quoteTimestamp) {
-    throw new Error("omniston: invalid EVM order quote deadline");
+    throw (0, import_errors.refusal)("quote_expired", "omniston: invalid EVM order quote deadline");
   }
 }
 async function checkOrderCustomData(customData, expected) {
   if (expected.evmDest) {
-    if (!zeroBytes(customData.slice(0, 66))) throw new Error("omniston: unexpected TON addresses in an EVM-destination order");
+    if (!zeroBytes(customData.slice(0, 66))) throw (0, import_errors.refusal)("recipient_mismatch", "omniston: unexpected TON addresses in an EVM-destination order");
   } else {
     const { Address: Address3 } = await import("@ton/core");
     const expectedTon = [expected.outputToken, expected.traderDst].map((value) => Address3.parse(value));
@@ -876,16 +925,16 @@ async function checkOrderCustomData(customData, expected) {
       const offset = index * 33;
       const workchain = customData[offset] === 255 ? -1 : customData[offset];
       if (workchain !== expectedTon[index].workChain || !sliceEqual(customData.slice(offset + 1, offset + 33), expectedTon[index].hash)) {
-        throw new Error("omniston: signed EVM\u2192TON address does not match the validated request");
+        throw (0, import_errors.refusal)("recipient_mismatch", "omniston: signed EVM\u2192TON address does not match the validated request");
       }
     }
   }
   if (!zeroBytes(customData.slice(66, 99))) {
-    throw new Error("omniston: unexpected private TON disclosure address");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: unexpected private TON disclosure address");
   }
   const quoteId = expected.quoteId.replace(/^0x/, "");
   if (!QUOTE_ID.test(quoteId) || !sliceEqual(customData.slice(99), hexToBytes(quoteId.padStart(64, "0")))) {
-    throw new Error("omniston: EVM order extension custom data is not bound to the quote id");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: EVM order extension custom data is not bound to the quote id");
   }
 }
 function validateEvmTypedOrder(td, expected) {
@@ -907,7 +956,7 @@ function validateEvmTypedOrder(td, expected) {
   if (value.domain?.name !== "1inch Limit Order Protocol" || value.domain.version !== "4" || typeof value.domain.verifyingContract !== "string" || (0, import_viem.getAddress)(value.domain.verifyingContract) !== (0, import_viem.getAddress)(expected.settlementContract) || Number(value.domain.chainId) !== expected.chainId || value.primaryType !== "Order" || !exactSchema || !message || !exactMessage || (0, import_viem.getAddress)(String(message.maker)) !== (0, import_viem.getAddress)(expected.owner) || (0, import_viem.getAddress)(String(message.receiver)) !== (0, import_viem.getAddress)(expected.receiver) || (0, import_viem.getAddress)(String(message.makerAsset)) !== (0, import_viem.getAddress)(expected.makerAsset) || !validUint256(salt) || (BigInt(salt) & (1n << 160n) - 1n) !== (extensionHash & (1n << 160n) - 1n) || // The order expires at the quote's trade-start deadline (±15 s of clock
   // skew between the quote and the order builder), never later.
   traits < 0n || !flagsOk || allowedSender !== 0n || series !== 0n || !within(expiration, expected.tradeStartDeadline, 15, 15) || expiration <= BigInt(expected.quoteTimestamp) || !validEvmAddress(message.takerAsset) || (0, import_viem.getAddress)(String(message.takerAsset)) === (0, import_viem.getAddress)(expected.makerAsset) || !validUint256(message.makingAmount) || BigInt(message.makingAmount) !== BigInt(expected.makingAmount) || !validUint256(message.takingAmount) || BigInt(message.takingAmount) !== BigInt(expected.takingAmount)) {
-    throw new Error("omniston: EVM order fields do not match the validated quote/request");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: EVM order fields do not match the validated quote/request");
   }
 }
 async function validateTonEscrowPayload(message, expected, validateForwardPayload) {
@@ -917,9 +966,9 @@ async function validateTonEscrowPayload(message, expected, validateForwardPayloa
   try {
     roots = Cell2.fromBoc(import_buffer2.Buffer.from(boc));
   } catch {
-    throw new Error("omniston: malformed TON escrow BoC");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: malformed TON escrow BoC");
   }
-  if (roots.length !== 1) throw new Error("omniston: TON escrow must contain exactly one root cell");
+  if (roots.length !== 1) throw (0, import_errors.refusal)("policy_refused", "omniston: TON escrow must contain exactly one root cell");
   const slice = roots[0].beginParse();
   const op = slice.loadUint(32);
   slice.loadUintBig(64);
@@ -930,7 +979,7 @@ async function validateTonEscrowPayload(message, expected, validateForwardPayloa
   const forwardAmount = slice.loadCoins();
   const payloadByRef = slice.loadBit();
   if (op !== 260734629 || amount !== BigInt(expected.inputUnits) || !(destination instanceof Address3) || !destination.equals(Address3.parse(expected.protocolAddress)) || response !== null && (!(response instanceof Address3) || !response.equals(Address3.parse(expected.ownerAddress))) || customPayload !== null || forwardAmount <= 0n || forwardAmount > BigInt(message.sendAmount) || !payloadByRef || slice.remainingBits !== 0 || slice.remainingRefs !== 1) {
-    throw new Error("omniston: TON jetton transfer does not match the validated quote/request");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: TON jetton transfer does not match the validated quote/request");
   }
   const forwardPayload = slice.loadRef();
   const verified = await validateForwardPayload({
@@ -950,7 +999,7 @@ async function validateTonEscrowPayload(message, expected, validateForwardPayloa
     ...expected.hashingFunction ? { hashingFunction: expected.hashingFunction } : {},
     exclusivityTimeout: expected.exclusivityTimeout
   });
-  if (!verified) throw new Error("omniston: TON escrow forward payload failed independent semantic validation");
+  if (!verified) throw (0, import_errors.refusal)("policy_refused", "omniston: TON escrow forward payload failed independent semantic validation");
 }
 function feeToken(asset) {
   return asset.assetId || asset.contract || asset.symbol;
@@ -980,24 +1029,24 @@ var ProtoReader = class {
       const byte = this.bytes[this.pos++];
       out += (byte & 127) * 2 ** shift;
       if ((byte & 128) === 0) {
-        if (!Number.isSafeInteger(out)) throw new Error("omniston: unsafe protobuf varint");
+        if (!Number.isSafeInteger(out)) throw (0, import_errors.refusal)("policy_refused", "omniston: unsafe protobuf varint");
         return out;
       }
       shift += 7;
     }
-    throw new Error("omniston: malformed protobuf varint");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: malformed protobuf varint");
   }
   field() {
     const tag = this.varint();
     const number = Math.floor(tag / 8);
     const wire = tag & 7;
-    if (number < 1) throw new Error("omniston: malformed protobuf field");
+    if (number < 1) throw (0, import_errors.refusal)("policy_refused", "omniston: malformed protobuf field");
     return { number, wire };
   }
   lengthDelimited() {
     const length = this.varint();
     const end2 = this.pos + length;
-    if (length < 0 || end2 > this.bytes.length) throw new Error("omniston: truncated protobuf payload");
+    if (length < 0 || end2 > this.bytes.length) throw (0, import_errors.refusal)("policy_refused", "omniston: truncated protobuf payload");
     const value = this.bytes.slice(this.pos, end2);
     this.pos = end2;
     return value;
@@ -1019,10 +1068,10 @@ var ProtoReader = class {
       this.advance(4);
       return;
     }
-    throw new Error("omniston: unsupported protobuf wire type");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: unsupported protobuf wire type");
   }
   advance(length) {
-    if (this.pos + length > this.bytes.length) throw new Error("omniston: truncated protobuf payload");
+    if (this.pos + length > this.bytes.length) throw (0, import_errors.refusal)("policy_refused", "omniston: truncated protobuf payload");
     this.pos += length;
   }
 };
@@ -1049,10 +1098,10 @@ function decodeChainAddress(bytes) {
   while (!reader.done) {
     const { number, wire } = reader.field();
     const $case = PROTO_CASE_BY_FIELD[number];
-    if (!$case || wire !== 2 || address) throw new Error("omniston: malformed chain address in order details");
+    if (!$case || wire !== 2 || address) throw (0, import_errors.refusal)("policy_refused", "omniston: malformed chain address in order details");
     address = { chain: { $case, value: utf8.decode(reader.lengthDelimited()) } };
   }
-  if (!address?.chain.value) throw new Error("omniston: empty chain address in order details");
+  if (!address?.chain.value) throw (0, import_errors.refusal)("policy_refused", "omniston: empty chain address in order details");
   return address;
 }
 function decodeAssetId(bytes) {
@@ -1061,27 +1110,27 @@ function decodeAssetId(bytes) {
   while (!reader.done) {
     const { number, wire } = reader.field();
     const $case = PROTO_CASE_BY_FIELD[number];
-    if (!$case || wire !== 2 || asset) throw new Error("omniston: malformed asset id in order details");
+    if (!$case || wire !== 2 || asset) throw (0, import_errors.refusal)("policy_refused", "omniston: malformed asset id in order details");
     const kindReader = new ProtoReader(reader.lengthDelimited());
     const kindField = kindReader.field();
     if (kindField.wire !== 2 || kindField.number !== 1 && kindField.number !== 2) {
-      throw new Error("omniston: unsupported asset kind in order details");
+      throw (0, import_errors.refusal)("policy_refused", "omniston: unsupported asset kind in order details");
     }
     const kindCase = kindField.number === 1 ? "native" : $case === "ton" ? "jetton" : $case === "tron" ? "trc20" : "erc20";
     const value = kindField.number === 1 ? {} : utf8.decode(kindReader.lengthDelimited());
-    if (!kindReader.done || kindField.number === 2 && !value) throw new Error("omniston: malformed asset kind in order details");
+    if (!kindReader.done || kindField.number === 2 && !value) throw (0, import_errors.refusal)("policy_refused", "omniston: malformed asset kind in order details");
     asset = { chain: { $case, value: { kind: { $case: kindCase, value } } } };
   }
-  if (!asset) throw new Error("omniston: empty asset id in order details");
+  if (!asset) throw (0, import_errors.refusal)("policy_refused", "omniston: empty asset id in order details");
   return asset;
 }
 function validateSerializedOrderDetails(bytes, expected) {
-  if (!bytes?.length) throw new Error("omniston: EVM HTLC order payload has no serialized details");
+  if (!bytes?.length) throw (0, import_errors.refusal)("policy_refused", "omniston: EVM HTLC order payload has no serialized details");
   const wrapper = new ProtoReader(bytes);
   const outer = wrapper.field();
-  if (outer.number !== 1 || outer.wire !== 2) throw new Error("omniston: unsupported HTLC order-details version");
+  if (outer.number !== 1 || outer.wire !== 2) throw (0, import_errors.refusal)("policy_refused", "omniston: unsupported HTLC order-details version");
   const detailsBytes = wrapper.lengthDelimited();
-  if (!wrapper.done) throw new Error("omniston: ambiguous HTLC order-details wrapper");
+  if (!wrapper.done) throw (0, import_errors.refusal)("policy_refused", "omniston: ambiguous HTLC order-details wrapper");
   const reader = new ProtoReader(detailsBytes);
   let quoteId;
   let outputAsset;
@@ -1089,16 +1138,16 @@ function validateSerializedOrderDetails(bytes, expected) {
   const hashes = [];
   while (!reader.done) {
     const { number, wire } = reader.field();
-    if (wire !== 2) throw new Error("omniston: malformed HTLC order details");
+    if (wire !== 2) throw (0, import_errors.refusal)("policy_refused", "omniston: malformed HTLC order details");
     const value = reader.lengthDelimited();
     if (number === 1 && quoteId === void 0) quoteId = utf8.decode(value);
     else if (number === 2 && outputAsset === void 0) outputAsset = decodeAssetId(value);
     else if (number === 3 && traderDstAddress === void 0) traderDstAddress = decodeChainAddress(value);
     else if (number === 5) hashes.push(value);
-    else throw new Error("omniston: duplicate or unexpected HTLC order-details field");
+    else throw (0, import_errors.refusal)("policy_refused", "omniston: duplicate or unexpected HTLC order-details field");
   }
   if (quoteId !== expected.quoteId || !outputAsset || !sameAsset(outputAsset, expected.outputAsset) || !traderDstAddress || !sameChainAddress(traderDstAddress, expected.traderDstAddress) || hashes.length !== expected.secretHashes.length || hashes.some((hash, i) => !bytesEqual(hash, expected.secretHashes[i]))) {
-    throw new Error("omniston: resolver order payload does not match the validated quote/request");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: resolver order payload does not match the validated quote/request");
   }
 }
 function isPositiveInteger(value) {
@@ -1129,7 +1178,7 @@ function bytesToHex(bytes) {
 function hexToBytes(hex) {
   const clean = hex.replace(/^0x/, "");
   if (!clean || !/^(?:[0-9a-fA-F]{2})+$/.test(clean)) {
-    throw new Error("omniston: malformed hex payload");
+    throw (0, import_errors.refusal)("policy_refused", "omniston: malformed hex payload");
   }
   const out = new Uint8Array(clean.length / 2);
   for (let i = 0; i < out.length; i++) out[i] = Number.parseInt(clean.slice(i * 2, i * 2 + 2), 16);
@@ -1163,6 +1212,14 @@ function swapProtocols(v) {
   for (const route of v.routes) for (const step of route.steps) for (const chunk of step.chunks) names.add(chunk.protocol);
   return [...names];
 }
+function rejectionReason(rejection) {
+  return rejection === "quote timestamp out of range" ? "quote_expired" : "upstream_unavailable";
+}
+function rfqReason(outcome) {
+  if (outcome.error) return outcome.errorReason;
+  if (outcome.rejected) return rejectionReason(outcome.rejected);
+  return outcome.answered ? "no_route" : "upstream_unavailable";
+}
 function quoteRejection(q, update, acknowledgedRfqId, request, settlement) {
   if (!q) return "empty quote";
   if (!acknowledgedRfqId || update.rfqId !== acknowledgedRfqId || q.rfqId !== acknowledgedRfqId) return "quote for another RFQ";
@@ -1202,6 +1259,7 @@ function awaitQuote(stream, request, signal, settleMs = QUOTE_SETTLE_MS, settlem
     const max = setTimeout(() => finish(latest), QUOTE_MAX_MS);
     sub = stream.subscribe({
       next: (event) => {
+        if (event.$case === "ack" || event.$case === "quoteUpdated" || event.$case === "noQuote") outcome.answered = true;
         if (event.$case === "ack") {
           acknowledgedRfqId = event.value.rfqId || null;
         } else if (event.$case === "quoteUpdated") {
@@ -1221,6 +1279,7 @@ function awaitQuote(stream, request, signal, settleMs = QUOTE_SETTLE_MS, settlem
       },
       error: (err) => {
         outcome.error = String(err?.message ?? err).slice(0, 200);
+        outcome.errorReason = venueReason(err);
         finish(null);
       },
       complete: () => finish(latest)
@@ -1262,9 +1321,9 @@ function awaitSwapProgress(stream) {
 }
 var JETTON_TRANSFER_OP = 260734629;
 function parseSwapPayload(payloadHex) {
-  if (!/^(?:[0-9a-fA-F]{2})+$/.test(payloadHex)) throw new Error("omniston: malformed swap payload hex");
+  if (!/^(?:[0-9a-fA-F]{2})+$/.test(payloadHex)) throw (0, import_errors.refusal)("policy_refused", "omniston: malformed swap payload hex");
   const roots = import_core3.Cell.fromBoc(import_buffer2.Buffer.from(payloadHex, "hex"));
-  if (roots.length !== 1) throw new Error("omniston: swap payload must have one root");
+  if (roots.length !== 1) throw (0, import_errors.refusal)("policy_refused", "omniston: swap payload must have one root");
   const s = roots[0].beginParse();
   const op = s.loadUint(32);
   if (op !== JETTON_TRANSFER_OP) return { op, jettonTransfer: null };
@@ -1336,86 +1395,108 @@ function mapOrderStatus(order) {
 }
 function omnistonPins(trustedEvmOrderProtocols) {
   const byChain = new Map(Object.entries(trustedEvmOrderProtocols).map(([chain, list]) => [chain, list.map((a) => (0, import_viem.getAddress)(a))]));
-  return Object.freeze({ callTargets: () => [], spenders: (chain) => byChain.get(chain) ?? [] });
+  return Object.freeze({
+    callTargets: () => [],
+    spenders: (chain) => byChain.get(chain) ?? [],
+    // The reason behind a text omnistonVerifyBuild returned, so the remote stub's refusal carries it.
+    reasonOf: verifyNotes.reasonOf
+  });
+}
+var VERIFY_NOTES = /* @__PURE__ */ Symbol.for("@anywalletkit/protocol-swap2-omniston/verify-notes@1");
+var verifyNotes = (() => {
+  const shared = globalThis[VERIFY_NOTES];
+  if (shared && typeof shared.note === "function" && typeof shared.reasonOf === "function") return shared;
+  const notes = (0, import_errors.refusalNotes)();
+  try {
+    Object.defineProperty(globalThis, VERIFY_NOTES, { value: notes });
+  } catch {
+  }
+  return notes;
+})();
+var said = verifyNotes.note;
+function tonEscrowBuildReason(text) {
+  if (text.startsWith("the escrow transfer pays ")) return "vault_mismatch";
+  if (text.startsWith("the resolver is bound to deliver ")) return "price_check_failed";
+  return "policy_refused";
 }
 var MAX_EVM_ORDER_LIFETIME_S = 900;
 async function checkRemoteEvmOrder(quote, tx, params, trusted) {
   const chainId = evmRef2(params.sourceChain);
-  if (chainId === null || !params.sourceChain.startsWith("eip155:")) return "a typed order needs an EVM source";
+  if (chainId === null || !params.sourceChain.startsWith("eip155:")) return said("a typed order needs an EVM source", "policy_refused");
   const intent = decodeIntent(quote.intentId.replace(/~[0-9a-f]{32}$/, ""));
-  if (!intent || intent.kind !== "order" || intent.srcChain !== params.sourceChain) return "the quote's intent is not an order from this chain";
-  if (!tx.orderExtension || !/^0x(?:[0-9a-fA-F]{2})+$/.test(tx.orderExtension)) return "the build carries no order extension to check";
+  if (!intent || intent.kind !== "order" || intent.srcChain !== params.sourceChain) return said("the quote's intent is not an order from this chain", "policy_refused");
+  if (!tx.orderExtension || !/^0x(?:[0-9a-fA-F]{2})+$/.test(tx.orderExtension)) return said("the build carries no order extension to check", "policy_refused");
   const source = (0, import_swap2_assets.ccAsset)(params.sourceChain, params.sourceToken);
-  if (!source?.contract) return "unknown source token";
+  if (!source?.contract) return said("unknown source token", "unsupported_pair");
   const tonDest = isTon(params.destChain);
   const destChainId = tonDest ? null : evmRef2(params.destChain);
-  if (!tonDest && (destChainId === null || !params.destChain.startsWith("eip155:"))) return "the destination is neither TON nor an EVM chain";
+  if (!tonDest && (destChainId === null || !params.destChain.startsWith("eip155:"))) return said("the destination is neither TON nor an EVM chain", "unsupported_pair");
   const outputToken = (0, import_swap2_assets.ccAssetByToken)(params.destChain, params.destToken)?.contract ?? params.destToken;
   const listed = (table, chain, address) => typeof address === "string" && validEvmAddress(address) && (table[chain] ?? []).some((a) => validEvmAddress(a) && (0, import_viem.getAddress)(a) === (0, import_viem.getAddress)(address));
   let td;
   try {
     td = JSON.parse(tx.typedData ?? "");
   } catch {
-    return "the typed data is not JSON";
+    return said("the typed data is not JSON", "policy_refused");
   }
   const domain = td.domain ?? {};
   const contract = domain.verifyingContract;
-  if (domain.name !== "1inch Limit Order Protocol" || domain.version !== "4") return "the domain is not the 1inch Limit Order Protocol v4";
+  if (domain.name !== "1inch Limit Order Protocol" || domain.version !== "4") return said("the domain is not the 1inch Limit Order Protocol v4", "policy_refused");
   if (!listed(trusted.orderProtocols, params.sourceChain, contract) || !tx.approvalAddress || (0, import_viem.getAddress)(tx.approvalAddress) !== (0, import_viem.getAddress)(String(contract))) {
-    return `${String(contract)} is not a trusted order protocol on ${params.sourceChain}`;
+    return said(`${String(contract)} is not a trusted order protocol on ${params.sourceChain}`, "vault_mismatch");
   }
-  if (Number(domain.chainId) !== chainId || tx.chainId !== void 0 && tx.chainId !== chainId) return "the domain chainId is not the source chain";
+  if (Number(domain.chainId) !== chainId || tx.chainId !== void 0 && tx.chainId !== chainId) return said("the domain chainId is not the source chain", "policy_refused");
   const order = td.types?.Order;
   const message = td.message;
   if (td.primaryType !== "Order" || !Array.isArray(order) || order.length !== ORDER_FIELDS.length || !order.every((field, i) => field.name === ORDER_FIELDS[i][0] && field.type === ORDER_FIELDS[i][1]) || !message || Object.keys(message).length !== ORDER_FIELDS.length || !ORDER_FIELDS.every(([name]) => Object.hasOwn(message, name)) || !ORDER_FIELDS.every(([name, type]) => type === "address" ? validEvmAddress(message[name]) : validUint256(message[name]))) {
-    return "the typed data is not exactly a v4 Order";
+    return said("the typed data is not exactly a v4 Order", "policy_refused");
   }
-  if (!validEvmAddress(intent.trader) || (0, import_viem.getAddress)(String(message.maker)) !== (0, import_viem.getAddress)(intent.trader)) return "the maker is not the trader";
-  if ((0, import_viem.getAddress)(String(message.makerAsset)) !== (0, import_viem.getAddress)(source.contract)) return "the makerAsset is not the source token";
-  if (BigInt(message.makingAmount) !== BigInt(quote.sourceAmount)) return "the makingAmount is not the input";
-  if ((0, import_viem.getAddress)(String(message.takerAsset)) === (0, import_viem.getAddress)(String(message.makerAsset))) return "the takerAsset is the makerAsset";
+  if (!validEvmAddress(intent.trader) || (0, import_viem.getAddress)(String(message.maker)) !== (0, import_viem.getAddress)(intent.trader)) return said("the maker is not the trader", "policy_refused");
+  if ((0, import_viem.getAddress)(String(message.makerAsset)) !== (0, import_viem.getAddress)(source.contract)) return said("the makerAsset is not the source token", "policy_refused");
+  if (BigInt(message.makingAmount) !== BigInt(quote.sourceAmount)) return said("the makingAmount is not the input", "policy_refused");
+  if ((0, import_viem.getAddress)(String(message.takerAsset)) === (0, import_viem.getAddress)(String(message.makerAsset))) return said("the takerAsset is the makerAsset", "policy_refused");
   const floor = [quote.minDestAmount, params.minAmountOut ?? "0"].filter((v) => /^\d{1,80}$/.test(v)).map((v) => BigInt(v)).reduce((a, b) => a > b ? a : b, 0n);
-  if (floor <= 0n || BigInt(message.takingAmount) < floor) return `takingAmount ${String(message.takingAmount)} is below the quote's minimum ${floor}`;
+  if (floor <= 0n || BigInt(message.takingAmount) < floor) return said(`takingAmount ${String(message.takingAmount)} is below the quote's minimum ${floor}`, "price_check_failed");
   const traits = BigInt(message.makerTraits);
   const flags = traits & (1n << 56n) - 1n << 200n;
   const baseFlags = 1n << 251n | 1n << 249n;
-  if (flags !== baseFlags && flags !== (baseFlags | 1n << 255n)) return "the makerTraits flags are not a single-fill order with its extension";
-  if ((traits & (1n << 80n) - 1n) !== 0n || (traits >> 160n & (1n << 40n) - 1n) !== 0n) return "the makerTraits restrict the taker or the series";
+  if (flags !== baseFlags && flags !== (baseFlags | 1n << 255n)) return said("the makerTraits flags are not a single-fill order with its extension", "policy_refused");
+  if ((traits & (1n << 80n) - 1n) !== 0n || (traits >> 160n & (1n << 40n) - 1n) !== 0n) return said("the makerTraits restrict the taker or the series", "policy_refused");
   const now = BigInt(Math.floor(Date.now() / 1e3));
   const expiration = traits >> 80n & (1n << 40n) - 1n;
-  if (expiration <= now || expiration > now + BigInt(MAX_EVM_ORDER_LIFETIME_S)) return "the order's expiry is not minutes away";
+  if (expiration <= now || expiration > now + BigInt(MAX_EVM_ORDER_LIFETIME_S)) return said("the order's expiry is not minutes away", expiration <= now ? "quote_expired" : "policy_refused");
   const extension = (0, import_viem.hexToBytes)(tx.orderExtension);
   const mask = (1n << 160n) - 1n;
-  if ((BigInt(message.salt) & mask) !== (BigInt((0, import_viem.keccak256)(extension)) & mask)) return "the salt does not commit the order extension";
+  if ((BigInt(message.salt) & mask) !== (BigInt((0, import_viem.keccak256)(extension)) & mask)) return said("the salt does not commit the order extension", "policy_refused");
   let parsed;
   try {
     parsed = readEvmOrderExtension(extension);
   } catch (e) {
-    return e instanceof Error ? e.message.replace(/^omniston: /, "") : String(e);
+    return said(e instanceof Error ? e.message.replace(/^omniston: /, "") : String(e), (0, import_errors.refusalOf)(e) ?? "policy_refused");
   }
   const { target, getter, post, extra, customData } = parsed;
-  if (!listed(trusted.factories, params.sourceChain, target)) return `the extension targets ${target}, not a trusted escrow factory on ${params.sourceChain}`;
+  if (!listed(trusted.factories, params.sourceChain, target)) return said(`the extension targets ${target}, not a trusted escrow factory on ${params.sourceChain}`, "vault_mismatch");
   const receiverLow80 = BigInt((0, import_viem.getAddress)(String(message.receiver))) & (1n << 80n) - 1n;
-  if (getter.resolver !== receiverLow80 || post.resolver !== receiverLow80) return "the order's receiver is not the resolver its extension whitelists";
+  if (getter.resolver !== receiverLow80 || post.resolver !== receiverLow80) return said("the order's receiver is not the resolver its extension whitelists", "recipient_mismatch");
   if (getter.gasBump !== 0n || getter.gasPrice !== 0n || getter.duration !== 1800n || getter.initialRateBump !== 900000n || getter.points.some((point, index) => point[0] !== EVM_AUCTION_POINTS[index][0] || point[1] !== EVM_AUCTION_POINTS[index][1]) || getter.integratorFee !== 0n || getter.integratorShare !== 100n || getter.whitelistDiscount !== 50n || !within(getter.auctionStart, (0, import_core4.bigintToNumber)(now), MAX_EVM_ORDER_LIFETIME_S, 60)) {
-    return "the amount-getter terms do not match the pinned v1beta8 profile";
+    return said("the amount-getter terms do not match the pinned v1beta8 profile", "policy_refused");
   }
   if (!zeroBytes(post.integratorRecipient) || !(zeroBytes(post.protocolRecipient) || !tonDest && EVM_DEST_PROTOCOL_FEE_RECIPIENTS.has(`0x${bytesToHex(post.protocolRecipient)}`)) || post.integratorFee !== 0n || post.integratorShare !== 100n || post.resolverFee !== getter.resolverFee || post.discount !== 50n || post.resolverTimeDelta !== 0n || !within(post.allowedTime, (0, import_core4.bigintToNumber)(getter.auctionStart), 60, 5)) {
-    return "the post-interaction terms do not match the pinned v1beta8 profile";
+    return said("the post-interaction terms do not match the pinned v1beta8 profile", "policy_refused");
   }
   let dstToken;
   try {
     dstToken = tonDest ? BigInt((0, import_viem.getAddress)(String(message.takerAsset))) : BigInt((0, import_viem.getAddress)(outputToken));
   } catch {
-    return "the destination token is not an EVM address";
+    return said("the destination token is not an EVM address", "policy_refused");
   }
   if (extra[1] !== (tonDest ? 0n : BigInt(destChainId)) || extra[2] !== dstToken || extra[4] !== EVM_TIMELOCKS) {
-    return "the signed HTLC terms name another destination chain or token, or other timelocks";
+    return said("the signed HTLC terms name another destination chain or token, or other timelocks", "policy_refused");
   }
   try {
     await checkOrderCustomData(customData, { evmDest: !tonDest, outputToken, traderDst: params.destAddress, quoteId: intent.quoteId });
   } catch (e) {
-    return e instanceof Error ? e.message.replace(/^omniston: /, "") : String(e);
+    return said(e instanceof Error ? e.message.replace(/^omniston: /, "") : String(e), (0, import_errors.refusalOf)(e) ?? "policy_refused");
   }
   return null;
 }
@@ -1426,22 +1507,22 @@ function omnistonVerifyBuild(hooks) {
   };
   return async (quote, tx, params) => {
     if (tx.typedData !== void 0) {
-      if (!params) return "the request this quote answered is unknown";
+      if (!params) return said("the request this quote answered is unknown", "policy_refused");
       try {
         return await checkRemoteEvmOrder(quote, tx, params, trusted);
       } catch {
-        return "the typed order could not be checked";
+        return said("the typed order could not be checked", "policy_refused");
       }
     }
     if (tx.bodyBoc === void 0) return null;
-    if (!params) return "the request this quote answered is unknown";
+    if (!params) return said("the request this quote answered is unknown", "policy_refused");
     if (quote.providerData?.settlement !== "swap") {
       if (params.sourceChain.startsWith("ton:") && params.destChain.startsWith("eip155:")) {
-        if (!hooks.verifyTonEscrowBuild) return "a TON \u2192 EVM escrow body needs verifyTonEscrowBuild (createOmnistonTonValidators)";
-        if (!params.refundAddress) return "the trader's TON address (refundAddress) is unknown";
+        if (!hooks.verifyTonEscrowBuild) return said("a TON \u2192 EVM escrow body needs verifyTonEscrowBuild (createOmnistonTonValidators)", "unsupported_pair");
+        if (!params.refundAddress) return said("the trader's TON address (refundAddress) is unknown", "recipient_unverifiable");
         const floor = [quote.minDestAmount, params.minAmountOut ?? "0"].filter((v) => /^\d{1,80}$/.test(v)).map((v) => BigInt(v)).reduce((a, b) => a > b ? a : b, 0n);
         try {
-          return await hooks.verifyTonEscrowBuild({
+          const text = await hooks.verifyTonEscrowBuild({
             payloadBocHex: import_buffer2.Buffer.from(tx.bodyBoc, "base64").toString("hex"),
             ownerAddress: params.refundAddress,
             inputUnits: quote.sourceAmount,
@@ -1450,22 +1531,23 @@ function omnistonVerifyBuild(hooks) {
             outputTokenAddress: params.destToken,
             minResolverSendsUnits: floor.toString()
           });
+          return text ? said(text, tonEscrowBuildReason(text)) : text;
         } catch {
-          return "the escrow body could not be checked";
+          return said("the escrow body could not be checked", "policy_refused");
         }
       }
-      return "only TON swap and TON \u2192 EVM escrow bodies can be checked on the client";
+      return said("only TON swap and TON \u2192 EVM escrow bodies can be checked on the client", "unsupported_pair");
     }
     let steps;
     try {
       steps = JSON.parse(quote.providerData.routeSteps ?? "");
     } catch {
-      return "the quote carries no route steps";
+      return said("the quote carries no route steps", "policy_refused");
     }
-    if (!Array.isArray(steps) || steps.length === 0) return "the quote carries no route steps";
+    if (!Array.isArray(steps) || steps.length === 0) return said("the quote carries no route steps", "policy_refused");
     const source = (0, import_swap2_assets.ccAsset)(params.sourceChain, params.sourceToken);
     const dest = (0, import_swap2_assets.ccAssetByToken)(params.destChain, params.destToken);
-    if (!source || !dest) return "unknown source or destination token";
+    if (!source || !dest) return said("unknown source or destination token", "unsupported_pair");
     const protocols = (quote.providerData.protocols ?? "").split(",").filter(Boolean);
     let checked;
     try {
@@ -1483,17 +1565,17 @@ function omnistonVerifyBuild(hooks) {
         integratorAddress: hooks.integratorAddress ?? null
       });
     } catch (e) {
-      return e instanceof Error ? e.message.replace(/^omniston: /, "") : String(e);
+      return said(e instanceof Error ? e.message.replace(/^omniston: /, "") : String(e), e instanceof TonSwapPayloadError ? tonSwapPayloadReason(e.reason) : "policy_refused");
     }
     const payload = parseSwapPayload(import_buffer2.Buffer.from(tx.bodyBoc, "base64").toString("hex"));
     const target = source.contract ? payload.jettonTransfer?.destination : tx.to;
-    if (!target) return "the body names no swap destination";
+    if (!target) return said("the body names no swap destination", "policy_refused");
     try {
-      if (!await hooks.validateTonSwapTarget({ address: target, protocols })) return `${target} is not a recognized DEX contract for ${protocols.join("+")}`;
+      if (!await hooks.validateTonSwapTarget({ address: target, protocols })) return said(`${target} is not a recognized DEX contract for ${protocols.join("+")}`, "vault_mismatch");
     } catch {
-      return "the swap target could not be checked";
+      return said("the swap target could not be checked", "policy_refused");
     }
-    if (!hooks.validateTonSwapLeg) return "a TON swap body needs validateTonSwapLeg (createOmnistonTonValidators)";
+    if (!hooks.validateTonSwapLeg) return said("a TON swap body needs validateTonSwapLeg (createOmnistonTonValidators)", "unsupported_pair");
     for (const leg of checked.legs) {
       let ok = false;
       try {
@@ -1501,7 +1583,7 @@ function omnistonVerifyBuild(hooks) {
       } catch {
         ok = false;
       }
-      if (!ok) return `${leg.kind} v${leg.version} leg not verified`;
+      if (!ok) return said(`${leg.kind} v${leg.version} leg not verified`, "vault_mismatch");
     }
     return null;
   };
@@ -1685,19 +1767,19 @@ function omnistonProvider(opts = {}) {
     if (!bound.ok) {
       if (bound.reason === "legacy-expired") {
         trace("legacy-intent-expired", { where });
-        throw new Error("omniston: quote expired \u2014 request a fresh quote");
+        throw (0, import_errors.refusal)("quote_expired", "omniston: quote expired \u2014 request a fresh quote");
       }
       trace("intent-mismatch", { where, field: bound.field });
-      throw new Error(`omniston: intent id does not match the quote it was issued for (${bound.field})`);
+      throw (0, import_errors.refusal)(mismatchReason(bound.field), `omniston: intent id does not match the quote it was issued for (${bound.field})`);
     }
     if (bound.legacy) trace("legacy-intent", { where });
     if (!decoded.digest) {
       trace("intent-mismatch", { where, field: "digest-missing" });
-      throw new Error("omniston: this quote was issued before an update \u2014 request a fresh quote");
+      throw (0, import_errors.refusal)("quote_expired", "omniston: this quote was issued before an update \u2014 request a fresh quote");
     }
     if (decoded.digest !== quoteDigest(entry.quote)) {
       trace("intent-mismatch", { where, field: "digest" });
-      throw new Error("omniston: quote was replaced \u2014 request a fresh quote");
+      throw (0, import_errors.refusal)("policy_refused", "omniston: quote was replaced \u2014 request a fresh quote");
     }
     return bound.ref;
   }
@@ -1731,10 +1813,10 @@ function omnistonProvider(opts = {}) {
       const disclosed = (await store.load(disclosedKey(quoteId)) ?? []).length > 0;
       if (boundTo !== binding || disclosed) {
         traceFor(quoteId)("secret-reuse-refused", { disclosed, bound: boundTo !== void 0 });
-        throw new Error("omniston: this quote id already belongs to another order \u2014 request a fresh quote");
+        throw (0, import_errors.refusal)("policy_refused", "omniston: this quote id already belongs to another order \u2014 request a fresh quote");
       }
       if (existing.length !== count || !existing.every((s) => /^[0-9a-fA-F]{64}$/.test(s))) {
-        throw new Error("omniston: stored HTLC secrets for this quote do not fit the order \u2014 request a fresh quote");
+        throw (0, import_errors.refusal)("policy_refused", "omniston: stored HTLC secrets for this quote do not fit the order \u2014 request a fresh quote");
       }
       traceFor(quoteId)("secret-reused", { count });
       return { secrets: existing.map(hexToBytes), created: false };
@@ -1793,7 +1875,10 @@ function omnistonProvider(opts = {}) {
     let q = await rfq(slippagePips);
     if (!q) {
       if (!signal?.aborted) {
-        params.onRefusal?.(`omniston: ${outcome.error ? `RFQ failed: ${outcome.error}` : outcome.rejected ? `swap quote rejected: ${outcome.rejected}` : "no TON DEX route quoted this pair/amount"}`);
+        const text = `omniston: ${outcome.error ? `RFQ failed: ${outcome.error}` : outcome.rejected ? `swap quote rejected: ${outcome.rejected}` : "no TON DEX route quoted this pair/amount"}`;
+        const reason = rfqReason(outcome);
+        if (reason) params.onRefusal?.(text, { reason });
+        else params.onRefusal?.(text);
       }
       return null;
     }
@@ -1859,27 +1944,32 @@ function omnistonProvider(opts = {}) {
   async function buildSwapDeposit(ref, q, swap) {
     if (!ref.trader) throw new Error("omniston: quote was requested without a refund/source address");
     if (!isTon(ref.srcChain) || q.inputAsset.chain.$case !== "ton" || q.outputAsset.chain.$case !== "ton") {
-      throw new Error("omniston: swap quote is not a TON same-chain swap");
+      throw (0, import_errors.refusal)("policy_refused", "omniston: swap quote is not a TON same-chain swap");
     }
-    if (!sameChainTonReady()) throw new Error("omniston: TON same-chain swaps need independent jetton-wallet, swap-target and swap-leg validators");
+    if (!sameChainTonReady()) throw (0, import_errors.refusal)("unsupported_pair", "omniston: TON same-chain swaps need independent jetton-wallet, swap-target and swap-leg validators");
     const owner = { chain: { $case: "ton", value: ref.trader } };
     const receiver = { chain: { $case: "ton", value: ref.dest } };
     const omni = await getClient();
-    if (typeof omni.tonBuildSwap !== "function") throw new Error("omniston: client does not support swap settlement (tonBuildSwap)");
-    const tx = await omni.tonBuildSwap({
-      quoteId: ref.quoteId,
-      transferSrcAddress: owner,
-      refundSrcAddress: owner,
-      gasExcessAddress: owner,
-      traderDstAddress: receiver,
-      // Build at the slippage the quote was requested with: its
-      // minOutputAmount is the minimum this module reported to the router.
-      useRecommendedSlippage: false
-    });
+    if (typeof omni.tonBuildSwap !== "function") throw (0, import_errors.refusal)("unsupported_pair", "omniston: client does not support swap settlement (tonBuildSwap)");
+    let tx;
+    try {
+      tx = await omni.tonBuildSwap({
+        quoteId: ref.quoteId,
+        transferSrcAddress: owner,
+        refundSrcAddress: owner,
+        gasExcessAddress: owner,
+        traderDstAddress: receiver,
+        // Build at the slippage the quote was requested with: its
+        // minOutputAmount is the minimum this module reported to the router.
+        useRecommendedSlippage: false
+      });
+    } catch (error) {
+      throw venueFailure(error);
+    }
     const [message, ...rest] = tx.messages;
-    if (!message || rest.length > 0) throw new Error(`omniston: expected exactly one swap message, got ${tx.messages.length}`);
-    if (message.jettonWalletStateInit) throw new Error("omniston: deploying a resolver-provided jetton wallet is not supported");
-    if (!isPositiveInteger(message.sendAmount)) throw new Error("omniston: malformed swap message value");
+    if (!message || rest.length > 0) throw (0, import_errors.refusal)("policy_refused", `omniston: expected exactly one swap message, got ${tx.messages.length}`);
+    if (message.jettonWalletStateInit) throw (0, import_errors.refusal)("policy_refused", "omniston: deploying a resolver-provided jetton wallet is not supported");
+    if (!isPositiveInteger(message.sendAmount)) throw (0, import_errors.refusal)("policy_refused", "omniston: malformed swap message value");
     const sendAmount = BigInt(message.sendAmount);
     const gasCap = BigInt(maxTonExecutionNano);
     const gasBudget = q.gasBudget && isPositiveInteger(q.gasBudget) ? BigInt(q.gasBudget) : gasCap;
@@ -1891,53 +1981,53 @@ function omnistonProvider(opts = {}) {
     const ptonV1Native = !inputJetton && !!payload.jettonTransfer && singleV1;
     if (inputJetton) {
       const transfer = payload.jettonTransfer;
-      if (!transfer) throw new Error("omniston: jetton-input swap message is not a jetton transfer");
-      if (sendAmount > gasCap || sendAmount > gasBudget) throw new Error(`omniston: swap message attaches more TON than the quoted gas budget (${sendAmount} > ${gasBudget} nanoTON, cap ${gasCap}, ${protocols.join("+")})`);
-      if (transfer.amount !== BigInt(q.inputUnits)) throw new Error("omniston: swap message moves a different amount than quoted");
+      if (!transfer) throw (0, import_errors.refusal)("policy_refused", "omniston: jetton-input swap message is not a jetton transfer");
+      if (sendAmount > gasCap || sendAmount > gasBudget) throw (0, import_errors.refusal)("policy_refused", `omniston: swap message attaches more TON than the quoted gas budget (${sendAmount} > ${gasBudget} nanoTON, cap ${gasCap}, ${protocols.join("+")})`);
+      if (transfer.amount !== BigInt(q.inputUnits)) throw (0, import_errors.refusal)("policy_refused", "omniston: swap message moves a different amount than quoted");
       if (!transfer.responseDestination || !sameTonAddress(transfer.responseDestination, ref.trader)) {
-        throw new Error("omniston: swap message returns excess to a wallet other than the trader");
+        throw (0, import_errors.refusal)("recipient_mismatch", "omniston: swap message returns excess to a wallet other than the trader");
       }
-      if (transfer.forwardTon >= sendAmount) throw new Error("omniston: swap message forwards more TON than it carries");
+      if (transfer.forwardTon >= sendAmount) throw (0, import_errors.refusal)("policy_refused", "omniston: swap message forwards more TON than it carries");
       const walletValid = await opts.validateTonJettonWallet({
         ownerAddress: ref.trader,
         jettonMasterAddress: inputJetton,
         walletAddress: message.targetAddress
       });
-      if (!walletValid) throw new Error("omniston: TON jetton wallet was not independently validated");
+      if (!walletValid) throw (0, import_errors.refusal)("vault_mismatch", "omniston: TON jetton wallet was not independently validated");
       const targetValid = await opts.validateTonSwapTarget({ address: transfer.destination, protocols });
-      if (!targetValid) throw new Error("omniston: swap destination is not a recognized DEX contract for the quoted protocol");
+      if (!targetValid) throw (0, import_errors.refusal)("vault_mismatch", "omniston: swap destination is not a recognized DEX contract for the quoted protocol");
     } else if (ptonV1Native) {
       const transfer = payload.jettonTransfer;
       const input = BigInt(q.inputUnits);
-      if (transfer.amount !== input) throw new Error("omniston: swap message moves a different amount than quoted");
-      if (sendAmount < input) throw new Error("omniston: swap message carries less than the quoted input");
+      if (transfer.amount !== input) throw (0, import_errors.refusal)("policy_refused", "omniston: swap message moves a different amount than quoted");
+      if (sendAmount < input) throw (0, import_errors.refusal)("policy_refused", "omniston: swap message carries less than the quoted input");
       const gas = sendAmount - input;
-      if (gas > gasCap || gas > gasBudget) throw new Error(`omniston: swap message attaches more TON than the quoted gas budget (${gas} > ${gasBudget} nanoTON, cap ${gasCap}, ${protocols.join("+")})`);
-      if (transfer.forwardTon > gas) throw new Error("omniston: swap message forwards more TON than its gas");
+      if (gas > gasCap || gas > gasBudget) throw (0, import_errors.refusal)("policy_refused", `omniston: swap message attaches more TON than the quoted gas budget (${gas} > ${gasBudget} nanoTON, cap ${gasCap}, ${protocols.join("+")})`);
+      if (transfer.forwardTon > gas) throw (0, import_errors.refusal)("policy_refused", "omniston: swap message forwards more TON than its gas");
       if (!transfer.responseDestination || !sameTonAddress(transfer.responseDestination, ref.trader)) {
-        throw new Error("omniston: swap message returns excess to a wallet other than the trader");
+        throw (0, import_errors.refusal)("recipient_mismatch", "omniston: swap message returns excess to a wallet other than the trader");
       }
-      if (typeof opts.validateTonSwapLeg !== "function") throw new Error("omniston: STON.fi v1 native input needs the validateTonSwapLeg validator (pTON v1 wallet ownership)");
+      if (typeof opts.validateTonSwapLeg !== "function") throw (0, import_errors.refusal)("unsupported_pair", "omniston: STON.fi v1 native input needs the validateTonSwapLeg validator (pTON v1 wallet ownership)");
       const targetValid = await opts.validateTonSwapTarget({ address: message.targetAddress, protocols });
-      if (!targetValid) throw new Error("omniston: swap target is not a recognized DEX contract for the quoted protocol");
+      if (!targetValid) throw (0, import_errors.refusal)("vault_mismatch", "omniston: swap target is not a recognized DEX contract for the quoted protocol");
       const routerValid = await opts.validateTonSwapTarget({ address: transfer.destination, protocols });
-      if (!routerValid) throw new Error("omniston: swap destination is not a recognized DEX contract for the quoted protocol");
+      if (!routerValid) throw (0, import_errors.refusal)("vault_mismatch", "omniston: swap destination is not a recognized DEX contract for the quoted protocol");
     } else {
       if (payload.jettonTransfer) {
-        throw new Error(`omniston: native-input swap message must not be a jetton transfer (route ${protocols.join("+") || "?"}, target ${message.targetAddress}, transfer ${payload.jettonTransfer.amount} to ${payload.jettonTransfer.destination}, forwardTon ${payload.jettonTransfer.forwardTon}, value ${sendAmount})`);
+        throw (0, import_errors.refusal)("policy_refused", `omniston: native-input swap message must not be a jetton transfer (route ${protocols.join("+") || "?"}, target ${message.targetAddress}, transfer ${payload.jettonTransfer.amount} to ${payload.jettonTransfer.destination}, forwardTon ${payload.jettonTransfer.forwardTon}, value ${sendAmount})`);
       }
       const input = BigInt(q.inputUnits);
-      if (sendAmount < input) throw new Error("omniston: swap message carries less than the quoted input");
+      if (sendAmount < input) throw (0, import_errors.refusal)("policy_refused", "omniston: swap message carries less than the quoted input");
       const gas = sendAmount - input;
-      if (gas > gasCap || gas > gasBudget) throw new Error(`omniston: swap message attaches more TON than the quoted gas budget (${gas} > ${gasBudget} nanoTON, cap ${gasCap}, ${protocols.join("+")})`);
+      if (gas > gasCap || gas > gasBudget) throw (0, import_errors.refusal)("policy_refused", `omniston: swap message attaches more TON than the quoted gas budget (${gas} > ${gasBudget} nanoTON, cap ${gasCap}, ${protocols.join("+")})`);
       const targetValid = await opts.validateTonSwapTarget({ address: message.targetAddress, protocols });
-      if (!targetValid) throw new Error("omniston: swap target is not a recognized DEX contract for the quoted protocol");
+      if (!targetValid) throw (0, import_errors.refusal)("vault_mismatch", "omniston: swap target is not a recognized DEX contract for the quoted protocol");
     }
     const mode = ptonV1Native ? "enforce" : opts.tonSwapPayloadCheck ?? "enforce";
     const trace = traceFor(ref.quoteId);
     const payloadRefusal = (reason, detail) => {
       trace("ton-swap-payload", { reason, detail, mode, protocols: protocols.join("+") });
-      if (mode === "enforce") throw new Error(`omniston: ton-swap-payload ${reason} \u2014 ${detail}`);
+      if (mode === "enforce") throw (0, import_errors.refusal)(tonSwapPayloadReason(reason), `omniston: ton-swap-payload ${reason} \u2014 ${detail}`);
     };
     let checked = null;
     try {
@@ -2011,33 +2101,33 @@ function omnistonProvider(opts = {}) {
     const srcChain = ref.srcChain;
     const chainId = evmRef2(srcChain);
     const srcCase = q.inputAsset.chain.$case;
-    if (chainId === null || EVM_CASE[chainId] !== srcCase) throw new Error("omniston: source chain does not match the EVM quote");
+    if (chainId === null || EVM_CASE[chainId] !== srcCase) throw (0, import_errors.refusal)("policy_refused", "omniston: source chain does not match the EVM quote");
     const destCase = q.outputAsset.chain.$case;
     const destChain = caipForChainCase(destCase);
     const tonDest = destCase === "ton";
-    if (!destChain || destChain === srcChain) throw new Error("omniston: EVM-source order has no supported destination chain");
+    if (!destChain || destChain === srcChain) throw (0, import_errors.refusal)("unsupported_pair", "omniston: EVM-source order has no supported destination chain");
     if (!trustedOrderProtocols.has(srcChain) || typeof opts.validateEvmInputPosition !== "function" || typeof (tonDest ? opts.validateTonOutputPosition : opts.validateEvmOutputPosition) !== "function") {
-      throw new Error(`omniston: EVM\u2192${tonDest ? "TON" : "EVM"} needs a trusted order protocol and both position validators`);
+      throw (0, import_errors.refusal)("unsupported_pair", `omniston: EVM\u2192${tonDest ? "TON" : "EVM"} needs a trusted order protocol and both position validators`);
     }
     let owner;
     try {
       owner = (0, import_viem.getAddress)(ref.trader);
     } catch {
-      throw new Error("omniston: trader is not an EVM address");
+      throw (0, import_errors.refusal)("recipient_mismatch", "omniston: trader is not an EVM address");
     }
     let dest;
     if (tonDest) {
       try {
         import_core3.Address.parse(ref.dest);
       } catch {
-        throw new Error("omniston: destination is not a TON address");
+        throw (0, import_errors.refusal)("recipient_mismatch", "omniston: destination is not a TON address");
       }
       dest = ref.dest;
     } else {
       try {
         dest = (0, import_viem.getAddress)(ref.dest);
       } catch {
-        throw new Error("omniston: destination is not an EVM address");
+        throw (0, import_errors.refusal)("recipient_mismatch", "omniston: destination is not an EVM address");
       }
     }
     const traderDst = { chain: { $case: destCase, value: dest } };
@@ -2048,9 +2138,9 @@ function omnistonProvider(opts = {}) {
     const outputToken = assetContract(q.outputAsset);
     const destChainId = tonDest ? null : evmRef2(destChain);
     if (factory?.chain.$case === destCase && !isTrusted(destChain, factory.chain.value)) {
-      throw new Error(`omniston: untrusted ${destChain} settlement contract ${factory.chain.value}`);
+      throw (0, import_errors.refusal)("vault_mismatch", `omniston: untrusted ${destChain} settlement contract ${factory.chain.value}`);
     }
-    if (protocol.chain.$case !== srcCase || !isTrustedOrderProtocol(srcChain, protocol.chain.value) || resolver?.chain.$case !== srcCase || !validEvmAddress(resolver.chain.value) || factory?.chain.$case !== destCase || !isTrusted(destChain, factory.chain.value) || !inputToken || !outputToken || !Number.isSafeInteger(settlement.protocolFeePips) || !tonDest && (destChainId === null || !validEvmAddress(outputToken) || !isPositiveInteger(settlement.dstSecurityDepositUnits ?? ""))) throw new Error("omniston: incomplete EVM order settlement binding in quote");
+    if (protocol.chain.$case !== srcCase || !isTrustedOrderProtocol(srcChain, protocol.chain.value) || resolver?.chain.$case !== srcCase || !validEvmAddress(resolver.chain.value) || factory?.chain.$case !== destCase || !isTrusted(destChain, factory.chain.value) || !inputToken || !outputToken || !Number.isSafeInteger(settlement.protocolFeePips) || !tonDest && (destChainId === null || !validEvmAddress(outputToken) || !isPositiveInteger(settlement.dstSecurityDepositUnits ?? ""))) throw (0, import_errors.refusal)("policy_refused", "omniston: incomplete EVM order settlement binding in quote");
     const { secrets, created } = await secretsFor(ref, q, 1);
     const hashes = secrets.map((secret) => hashlock(secret, settlement.htlcHashingFunction));
     const forget = async () => {
@@ -2067,14 +2157,14 @@ function omnistonProvider(opts = {}) {
       });
     } catch (error) {
       await forget();
-      throw error;
+      throw venueFailure(error);
     }
     let td;
     try {
       try {
         td = JSON.parse(payload.typedData);
       } catch {
-        throw new Error("omniston: malformed EVM order typed data");
+        throw (0, import_errors.refusal)("policy_refused", "omniston: malformed EVM order typed data");
       }
       validateSerializedOrderDetails(payload.serializedOrderDetails, {
         quoteId: ref.quoteId,
@@ -2157,45 +2247,46 @@ function omnistonProvider(opts = {}) {
     async getQuote(params, signal) {
       if (params.flex) return null;
       if (isTon(params.sourceChain) && isTon(params.destChain)) return await getSwapQuote(params, signal);
-      const refuse2 = (reason) => {
-        params.onRefusal?.(`omniston: ${reason}`);
+      const refuse2 = (reason, why) => {
+        if (why) params.onRefusal?.(`omniston: ${reason}`, { reason: why });
+        else params.onRefusal?.(`omniston: ${reason}`);
         return null;
       };
       const evmSource = !isTon(params.sourceChain);
       const tonDest = isTon(params.destChain);
-      if (!omniston.supports(params.sourceChain, params.destChain)) return refuse2("route is not an Omniston order corridor");
+      if (!omniston.supports(params.sourceChain, params.destChain)) return refuse2("route is not an Omniston order corridor", "unsupported_pair");
       if (!trustedContracts.has(params.sourceChain) || !trustedContracts.has(params.destChain)) {
-        return refuse2(`no trusted settlement contract configured for ${trustedContracts.has(params.sourceChain) ? params.destChain : params.sourceChain}`);
+        return refuse2(`no trusted settlement contract configured for ${trustedContracts.has(params.sourceChain) ? params.destChain : params.sourceChain}`, "unsupported_pair");
       }
       if (evmSource) {
-        if (!trustedOrderProtocols.has(params.sourceChain)) return refuse2(`no trusted EVM order protocol configured for ${params.sourceChain}`);
+        if (!trustedOrderProtocols.has(params.sourceChain)) return refuse2(`no trusted EVM order protocol configured for ${params.sourceChain}`, "unsupported_pair");
         if (typeof opts.validateEvmInputPosition !== "function" || typeof (tonDest ? opts.validateTonOutputPosition : opts.validateEvmOutputPosition) !== "function") {
-          return refuse2(tonDest ? "EVM\u2192TON needs the EVM input-position and TON output-position validators" : "EVM\u2192EVM needs the EVM input-position and EVM output-position validators");
+          return refuse2(tonDest ? "EVM\u2192TON needs the EVM input-position and TON output-position validators" : "EVM\u2192EVM needs the EVM input-position and EVM output-position validators", "unsupported_pair");
         }
         if (params.dry === false) {
           if (tonDest) {
             try {
               import_core3.Address.parse(params.destAddress);
             } catch {
-              return refuse2("destination is not a TON address");
+              return refuse2("destination is not a TON address", "recipient_mismatch");
             }
-          } else if (!validEvmAddress(params.destAddress)) return refuse2("destination is not an EVM address");
+          } else if (!validEvmAddress(params.destAddress)) return refuse2("destination is not an EVM address", "recipient_mismatch");
         }
-      } else if (typeof opts.validateTonJettonWallet !== "function" || typeof opts.validateTonEscrowPayload !== "function" || typeof opts.validateEvmOutputPosition !== "function") return refuse2("TON\u2192EVM needs the jetton-wallet, escrow-payload and EVM output-position validators");
+      } else if (typeof opts.validateTonJettonWallet !== "function" || typeof opts.validateTonEscrowPayload !== "function" || typeof opts.validateEvmOutputPosition !== "function") return refuse2("TON\u2192EVM needs the jetton-wallet, escrow-payload and EVM output-position validators", "unsupported_pair");
       const source = (0, import_swap2_assets.ccAsset)(params.sourceChain, params.sourceToken);
       const dest = (0, import_swap2_assets.ccAssetByToken)(params.destChain, params.destToken);
-      if (!source || !dest) return refuse2("asset is not in the catalog");
+      if (!source || !dest) return refuse2("asset is not in the catalog", "unsupported_pair");
       const inputAsset = toAssetId(params.sourceChain, source);
       const outputAsset = toAssetId(params.destChain, dest);
       if (!inputAsset || !outputAsset) {
-        return refuse2(`cross-chain orders are token corridors only (no ${!inputAsset ? source.symbol : dest.symbol} native leg)`);
+        return refuse2(`cross-chain orders are token corridors only (no ${!inputAsset ? source.symbol : dest.symbol} native leg)`, "unsupported_pair");
       }
       const maxUnits = decimalToUnits(maxUsdText, source.decimals);
       if (!maxUnits || !isPositiveInteger(params.amountIn)) return refuse2("invalid amount");
-      if (BigInt(params.amountIn) > maxUnits) return refuse2(`amount above the ${maxUsdText} USD per-swap cap`);
+      if (BigInt(params.amountIn) > maxUnits) return refuse2(`amount above the ${maxUsdText} USD per-swap cap`, "amount_too_large");
       const trader = params.refundAddress ?? "";
       if (!trader && !params.dry) return refuse2(`execution quote needs the trader's ${evmSource ? "EVM" : "TON"} address (refundAddress)`);
-      if (evmSource && trader && !validEvmAddress(trader)) return refuse2("refundAddress is not an EVM address");
+      if (evmSource && trader && !validEvmAddress(trader)) return refuse2("refundAddress is not an EVM address", "recipient_mismatch");
       const request = {
         inputAsset,
         outputAsset,
@@ -2223,27 +2314,28 @@ function omnistonProvider(opts = {}) {
       if (!q) {
         if (signal?.aborted) return null;
         return refuse2(
-          rfq.error ? `RFQ failed: ${rfq.error}` : rfq.rejected ? `resolver quote rejected: ${rfq.rejected}` : "no resolver quoted this route/amount"
+          rfq.error ? `RFQ failed: ${rfq.error}` : rfq.rejected ? `resolver quote rejected: ${rfq.rejected}` : "no resolver quoted this route/amount",
+          rfqReason(rfq)
         );
       }
       const orderData = q.settlementData.$case === "order" ? q.settlementData.value : null;
-      if (!orderData) return refuse2("resolver answered without order settlement");
+      if (!orderData) return refuse2("resolver answered without order settlement", "upstream_unavailable");
       const srcContract = orderData.srcProtocolContractAddress.chain.value;
       if (evmSource ? !isTrustedOrderProtocol(params.sourceChain, srcContract) : !isTrusted(params.sourceChain, srcContract)) {
-        return refuse2(evmSource ? `untrusted ${params.sourceChain} order protocol ${srcContract}` : `untrusted TON settlement contract ${srcContract}`);
+        return refuse2(evmSource ? `untrusted ${params.sourceChain} order protocol ${srcContract}` : `untrusted TON settlement contract ${srcContract}`, "vault_mismatch");
       }
       if (!orderData.dstProtocolContractAddress || !isTrusted(params.destChain, orderData.dstProtocolContractAddress.chain.value)) {
-        return refuse2(`untrusted ${params.destChain} settlement contract ${orderData.dstProtocolContractAddress?.chain.value ?? "(none)"}`);
+        return refuse2(`untrusted ${params.destChain} settlement contract ${orderData.dstProtocolContractAddress?.chain.value ?? "(none)"}`, "vault_mismatch");
       }
       const deadlineMs = orderData.tradeStartDeadline * 1e3;
-      if (!Number.isFinite(deadlineMs) || deadlineMs <= Date.now()) return refuse2("quote trade-start deadline already passed");
-      if (params.dry === false && deadlineMs - Date.now() < MIN_START_HEADROOM_MS) return refuse2("quote trade-start deadline too close to execute");
+      if (!Number.isFinite(deadlineMs) || deadlineMs <= Date.now()) return refuse2("quote trade-start deadline already passed", "quote_expired");
+      if (params.dry === false && deadlineMs - Date.now() < MIN_START_HEADROOM_MS) return refuse2("quote trade-start deadline too close to execute", "quote_expired");
       const inputScaled = BigInt(q.inputUnits) * 10n ** BigInt(dest.decimals);
       const outputScaled = BigInt(q.outputUnits) * 10n ** BigInt(source.decimals);
-      if (outputScaled * 2n < inputScaled || outputScaled > inputScaled * 2n) return refuse2("quoted output is outside 0.5x\u20132x of the input");
-      if (await quoteIdInUse(q.quoteId)) return refuse2("the platform reused a quote id that already belongs to an order");
+      if (outputScaled * 2n < inputScaled || outputScaled > inputScaled * 2n) return refuse2("quoted output is outside 0.5x\u20132x of the input", "price_check_failed");
+      if (await quoteIdInUse(q.quoteId)) return refuse2("the platform reused a quote id that already belongs to an order", "policy_refused");
       if (!await claimBuilt(q.quoteId, { quote: q, at: Date.now(), bound: { trader, dest: params.destAddress, srcChain: params.sourceChain, kind: "order" } })) {
-        return refuse2("the platform reused a quote id that already holds another quote");
+        return refuse2("the platform reused a quote id that already holds another quote", "policy_refused");
       }
       const feeUnits = Number(q.protocolFeeUnits || "0") + Number(q.integratorFeeUnits || "0");
       const feeUsd = feeUnits / 10 ** dest.decimals;
@@ -2274,29 +2366,29 @@ function omnistonProvider(opts = {}) {
      */
     async buildDeposit(quote) {
       if (!Number.isFinite(quote.validUntilMs) || quote.validUntilMs <= Date.now()) {
-        throw new Error("omniston: quote expired \u2014 request a fresh quote");
+        throw (0, import_errors.refusal)("quote_expired", "omniston: quote expired \u2014 request a fresh quote");
       }
       const decoded = decodeIntent(quote.intentId);
       if (!decoded) throw new Error("omniston: malformed intent id");
       const cached = await loadBuilt(decoded.quoteId);
-      if (!cached) throw new Error("omniston: quote expired \u2014 request a fresh quote");
+      if (!cached) throw (0, import_errors.refusal)("quote_expired", "omniston: quote expired \u2014 request a fresh quote");
       const ref = requireBinding(decoded, cached, "buildDeposit");
       const q = cached.quote;
       if (q.settlementData.$case === "swap") return await buildSwapDeposit(ref, q, q.settlementData.value);
       if (q.settlementData.$case !== "order" || q.settlementData.value.tradeStartDeadline * 1e3 <= Date.now()) {
-        throw new Error("omniston: quote trade deadline expired \u2014 request a fresh quote");
+        throw (0, import_errors.refusal)("quote_expired", "omniston: quote trade deadline expired \u2014 request a fresh quote");
       }
       if (!ref.trader) throw new Error("omniston: quote was requested without a refund/source address");
       const srcCase = q.inputAsset.chain.$case;
       if (srcCase !== "ton") return await buildEvmOrder(ref, q, q.settlementData.value, cached.bound);
       const srcChain = ref.srcChain;
-      if (!isTon(srcChain)) throw new Error("omniston: source chain does not match TON quote");
+      if (!isTon(srcChain)) throw (0, import_errors.refusal)("policy_refused", "omniston: source chain does not match TON quote");
       const destCase = q.outputAsset.chain.$case;
       const traderDst = destCase === "ton" ? null : { chain: { $case: destCase, value: (0, import_viem.getAddress)(ref.dest) } };
-      if (!traderDst) throw new Error("omniston: TON-destination orders are not supported");
+      if (!traderDst) throw (0, import_errors.refusal)("unsupported_pair", "omniston: TON-destination orders are not supported");
       const minter = q.settlementData.value.srcProtocolContractAddress;
       if (minter.chain.$case !== "ton" || !isTrusted(srcChain, minter.chain.value)) {
-        throw new Error(`omniston: untrusted TON settlement contract ${minter.chain.value}`);
+        throw (0, import_errors.refusal)("vault_mismatch", `omniston: untrusted TON settlement contract ${minter.chain.value}`);
       }
       const settlement = q.settlementData;
       const hashingFunction = settlement.$case === "order" ? settlement.value.htlcHashingFunction : void 0;
@@ -2320,27 +2412,27 @@ function omnistonProvider(opts = {}) {
         });
       } catch (error) {
         await forget();
-        throw error;
+        throw venueFailure(error);
       }
       const [message, ...rest] = tx.messages;
       if (!message || rest.length > 0) {
         await forget();
-        throw new Error(`omniston: expected exactly one escrow message, got ${tx.messages.length}`);
+        throw (0, import_errors.refusal)("policy_refused", `omniston: expected exactly one escrow message, got ${tx.messages.length}`);
       }
       if (!isPositiveInteger(message.sendAmount) || BigInt(message.sendAmount) > BigInt(maxTonExecutionNano)) {
         await forget();
-        throw new Error("omniston: resolver TON execution value exceeds the configured safety cap");
+        throw (0, import_errors.refusal)("policy_refused", "omniston: resolver TON execution value exceeds the configured safety cap");
       }
       const expectedProtocol = q.settlementData.value.srcProtocolContractAddress;
       const initialResolver = q.settlementData.value.srcInitialResolverAddress;
       const jettonMaster = assetContract(q.inputAsset);
       if (expectedProtocol.chain.$case !== "ton" || initialResolver?.chain.$case !== "ton" || !jettonMaster) {
         await forget();
-        throw new Error("omniston: incomplete TON settlement binding in quote");
+        throw (0, import_errors.refusal)("policy_refused", "omniston: incomplete TON settlement binding in quote");
       }
       if (message.jettonWalletStateInit) {
         await forget();
-        throw new Error("omniston: deploying a resolver-provided jetton wallet is not supported");
+        throw (0, import_errors.refusal)("policy_refused", "omniston: deploying a resolver-provided jetton wallet is not supported");
       }
       let walletValid = false;
       try {
@@ -2355,11 +2447,11 @@ function omnistonProvider(opts = {}) {
       }
       if (!walletValid) {
         await forget();
-        throw new Error("omniston: TON jetton wallet was not independently validated");
+        throw (0, import_errors.refusal)("vault_mismatch", "omniston: TON jetton wallet was not independently validated");
       }
       try {
         if (!opts.validateTonEscrowPayload) {
-          throw new Error("omniston: TON source requires an independent escrow-payload validator");
+          throw (0, import_errors.refusal)("unsupported_pair", "omniston: TON source requires an independent escrow-payload validator");
         }
         await validateTonEscrowPayload(message, {
           quoteId: ref.quoteId,
@@ -2406,7 +2498,7 @@ function omnistonProvider(opts = {}) {
         const result = bindIntent(decoded, stored);
         if (!result.ok && result.reason === "mismatch") {
           trace("intent-mismatch", { where: "trackIntent", field: result.field });
-          throw new Error(`omniston: intent id does not match the quote it was issued for (${result.field})`);
+          throw (0, import_errors.refusal)(mismatchReason(result.field), `omniston: intent id does not match the quote it was issued for (${result.field})`);
         }
         if (result.ok) {
           if (result.legacy) trace("legacy-intent", { where: "trackIntent" });
@@ -2586,12 +2678,12 @@ function omnistonProvider(opts = {}) {
       if (!ref) throw new Error("omniston: malformed intent id");
       const cached = await loadBuilt(ref.quoteId);
       const order = cached?.evmOrder;
-      if (!order) throw new Error("omniston: no signed-order context for this quote \u2014 build the order again");
+      if (!order) throw (0, import_errors.refusal)("quote_expired", "omniston: no signed-order context for this quote \u2014 build the order again");
       requireBinding(ref, cached, "registerSignedOrder");
       if (!/^0x[0-9a-fA-F]{130}$/.test(signature)) throw new Error("omniston: malformed order signature");
       const td = JSON.parse(order.typedData);
       const omni = await getClient();
-      await omni.orderRegisterSignedOrder({
+      const request = {
         quoteId: ref.quoteId,
         ownerSrcAddress: { chain: { $case: order.chainCase, value: order.owner } },
         signedOrder: { order: { $case: "evmV1", value: {
@@ -2600,7 +2692,12 @@ function omnistonProvider(opts = {}) {
           orderExtension: hexToBytes(order.orderExtension)
         } } },
         ...order.serializedOrderDetails ? { serializedOrderDetails: hexToBytes(order.serializedOrderDetails) } : {}
-      });
+      };
+      try {
+        await omni.orderRegisterSignedOrder(request);
+      } catch (error) {
+        throw venueFailure(error);
+      }
     },
     close() {
       clientGeneration += 1;