@debridge-finance/borderless-validation-sdk 0.3.1 → 0.4.0

package/README.md

@@ -8,7 +8,7 @@ When a user submits a bundle request to the deBridge API, the response contains
 
 **Every field the user signs is a potential attack vector.** If the API is compromised (MITM, server bug, malicious rewrite), the user could unknowingly sign a transaction that drains their funds.
 
-This SDK runs on the client and independently verifies that every signable field in the response matches the original request — before the user signs anything.
+This SDK runs on the client before signing. It validates the response structure and checks signable payloads against the original request, protocol invariants, and environment-specific whitelists.
 
 ### Threats mitigated
 
@@ -23,11 +23,12 @@ This SDK runs on the client and independently verifies that every signable field
 npm install @debridge-finance/borderless-validation-sdk
 ```
 
-Peer dependencies:
+Declared peer dependency ranges:
 
-```bash
-npm install viem zod bs58 @solana/web3.js
-```
+- `@solana/web3.js >= 1.90.0`
+- `bs58 >= 5.0.0`
+- `viem >= 2.0.0`
+- `zod ^3.0.0 || ^4.0.0`
 
 ## Basic usage
 
@@ -83,8 +84,6 @@ createValidator(config: ValidatorConfig): Validator
 
 type ValidatorConfig = {
     environment: Environment;
-    allowLegacyHookV1?: boolean;
-    validateSolverExecutorAddress?: boolean;
 };
 
 type Validator = {
@@ -115,9 +114,9 @@ The SDK is designed to run **between** receiving the API response and presenting
 ### 1. Where to call
 
 ```
-┌──────────────┐     ┌─────────┐     ┌─────────────────-─┐     ┌──────────────┐
-│ Build request│ ──▶ │ fetch() │ ──▶ │ validator.validate│ ──▶ │ Sign / submit│
-└──────────────┘     └─────────┘     └──────────────────-┘     └──────────────┘
+┌───────────────┐     ┌─────────┐     ┌────────────────────┐     ┌───────────────┐
+│ Build request │ ──▶ │ fetch() │ ──▶ │ validator.validate │ ──▶ │ Sign / submit │
+└───────────────┘     └─────────┘     └────────────────────┘     └───────────────┘
                                               │
                                               ▼
                                      ok ? proceed : block
@@ -189,15 +188,125 @@ See [`src/README.md`](./src/README.md) for an overview of the source code struct
 - Zod 3 E2E compatibility tests (CI mode): `npm run test:e2e:zod3:ci`
 - Zod 3/4 full compatibility checks: `npm run test:zod-compat`
 - Unit test coverage: `npm run coverage`
-- E2E tests (hit the staging API): `npm run test:e2e`
+- E2E tests (use the stage API by default; override with `API_BASE_URL`): `npm run test:e2e`
+- E2E tests with validation-case recording: `npm run test:e2e:record-validation-cases`
 - E2E tests (CI mode, serial with longer timeout): `npm run test:e2e:ci`
 - E2E coverage: `npm run coverage:e2e`
+- Download the matching Java validator CLI: `npm run download:java-validator-cli`
+- Compare TypeScript and Java E2E validation results: `npm run test:e2e:java-parity`
 - Full build: `npm run build`
 - Build ESM only: `npm run build:esm`
 - Build CJS only: `npm run build:cjs`
 - Build type declarations only: `npm run build:types`
 - Clean build output: `npm run clean`
 
+## Java parity E2E validation
+
+This check runs the repository's E2E validation cases through both the TypeScript SDK and its
+Java port, then verifies that both implementations produce equivalent validation results.
+
+### 1. Running the check
+
+Use the TypeScript SDK version from the root `package.json`:
+
+```bash
+npm run test:e2e:java-parity
+```
+
+To select the Java release associated with another TypeScript SDK version, pass that version
+explicitly:
+
+```bash
+npm run test:e2e:java-parity [-- <typescript-sdk-version>]
+```
+
+The argument selects the Java release mapping only. It does not check out or install that version of the TypeScript SDK; TypeScript results always come from the current working tree.
+
+The command requires Java and access to GitHub releases. For authenticated GitHub access, it uses
+`GITHUB_TOKEN`, `GH_TOKEN`, or the token returned by `gh auth token`, in that order.
+
+### 2. Execution flow and generated files
+
+The command performs the following steps:
+
+1. Determines the requested TypeScript SDK version from the command-line argument or the root
+   `package.json`.
+2. Finds the newest published Java release whose release notes contain
+   `TypeScript SDK tag: v<version>` and expects that release to contain exactly one `cli-*.jar`
+   asset.
+3. Downloads and verifies the Java CLI, unless the same verified release is already cached under:
+
+   ```text
+   .cache/java-validation-sdk/releases/<typescript-version>/<java-release-tag>/
+   ```
+
+   This directory contains the CLI JAR and its `metadata.json` cache metadata.
+4. Checks that the Java CLI supports the expected CLI contract version.
+5. Runs the regular TypeScript E2E suite with validation-case recording enabled. Every Jest worker
+   writes its validator inputs and TypeScript results to a separate JSONL file:
+
+   ```text
+   .cache/recorded-validation-cases/<date>__<unix-timestamp>/
+   └── recorded-cases__pid-<pid>.jsonl
+   ```
+
+   Each JSONL line contains the test identity, validator URL, request, response, validator config,
+   and TypeScript `ValidationResult` for one validator invocation.
+6. Sends every recorded input to the Java CLI daemon in the same order and reads one Java
+   `ValidationResult` per input.
+7. Compares the corresponding TypeScript and Java results. Up to ten mismatches are printed to the
+   console. The complete mismatch report is written to:
+
+   ```text
+   .cache/java-validation-sdk/parity-check-runs/<date>__<unix-timestamp>/mismatches.json
+   ```
+
+The temporary `.cache/recorded-validation-cases/latest-run.json` file connects the E2E recorder to
+the parity runner and is removed when the command finishes. A successful parity check also removes
+its recorded validation cases. If E2E execution or parity comparison fails, the recorded cases are
+preserved for investigation. A parity-check run directory is created only when mismatches need to
+be reported.
+
+### 3. Comparison rules
+
+The raw `ValidationResult` objects are not compared directly. Each result is reduced to this shape:
+
+```ts
+{
+    ok: boolean;
+    violations: Array<{
+        code: string;
+        path: string;
+        expected?: unknown;
+        actual?: unknown;
+    }>;
+}
+```
+
+The comparison includes:
+
+- the top-level `ok` value;
+- the number of violations, including duplicate violations;
+- each violation's `code` and `path`;
+- the presence and JSON value of `expected` and `actual`;
+- nested value types, string casing, and array element order inside `expected` and `actual`.
+
+Before comparison:
+
+- violations are sorted, so the order in which the two SDKs report violations does not matter;
+- object keys are sorted recursively, so object property order does not matter;
+- arrays are not sorted, so their element order remains significant.
+
+The comparison intentionally ignores:
+
+- violation `message` text;
+- violation `details`;
+- any other violation fields;
+- any other top-level result fields.
+
+After normalization, the two result objects are serialized and compared exactly. Any remaining
+difference is reported as a parity mismatch.
+
 ## License
 
 BUSL-1.1

package/dist/cjs/graylists/evm/token-permit-metadata.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TOKEN_PERMIT_METADATA = void 0;
 exports.getTokenPermitMetadata = getTokenPermitMetadata;
 const enums_1 = require("../../types/enums");
+const address_1 = require("../../helpers/address");
 // Note: addresses in this map MUST be lowercased.
 exports.TOKEN_PERMIT_METADATA = {
     // TODO: extend this verified-only graylist with additional tokens after
@@ -56,6 +57,11 @@ function getTokenPermitMetadata(realChainId, tokenAddress) {
     const chain = exports.TOKEN_PERMIT_METADATA[realChainId];
     if (!chain)
         return undefined;
-    return chain[tokenAddress.toLowerCase()];
+    try {
+        return chain[(0, address_1.addressToHex)(realChainId, tokenAddress)];
+    }
+    catch {
+        return undefined;
+    }
 }
 //# sourceMappingURL=token-permit-metadata.js.map

package/dist/cjs/graylists/evm/token-permit-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"token-permit-metadata.js","sourceRoot":"","sources":["../../../../src/graylists/evm/token-permit-metadata.ts"],"names":[],"mappings":";AAAA,wEAAwE;AACxE,mEAAmE;AACnE,oEAAoE;AACpE,oEAAoE;;;AAgEpE,wDAOC;AArED,6CAA4C;AAgB5C,kDAAkD;AACrC,QAAA,qBAAqB,GAA2B;IACzD,wEAAwE;IACxE,2EAA2E;IAC3E,uEAAuE;IACvE,kEAAkE;IAClE,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE;QAChB,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;QAChF,4CAA4C,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,GAAG,EAAE;QACtF,4CAA4C,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;KACvE;IACD,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE;QAChB,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;KACnF;IACD,CAAC,eAAO,CAAC,OAAO,CAAC,EAAE;QACf,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;KACnF;IACD,CAAC,eAAO,CAAC,KAAK,CAAC,EAAE;QACb,4CAA4C,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;KAC/E;IACD,CAAC,eAAO,CAAC,KAAK,CAAC,EAAE;QACb,4CAA4C,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;KAC/E;IACD,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE;QAChB,4CAA4C,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;KAC/E;IACD,CAAC,eAAO,CAAC,GAAG,CAAC,EAAE;QACX,4CAA4C,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;KAC/E;IACD,CAAC,eAAO,CAAC,SAAS,CAAC,EAAE;QACjB,4CAA4C,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;KAC/E;IACD,CAAC,eAAO,CAAC,IAAI,CAAC,EAAE;QACZ,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;KACnF;IACD,CAAC,eAAO,CAAC,KAAK,CAAC,EAAE;QACb,4CAA4C,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;KAC/E;IACD,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE;QAChB,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;KACnF;IACD,CAAC,eAAO,CAAC,SAAS,CAAC,EAAE;QACjB,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;KACnF;CACJ,CAAC;AAEF,SAAgB,sBAAsB,CAClC,WAAoB,EACpB,YAAoB;IAEpB,MAAM,KAAK,GAAG,6BAAqB,CAAC,WAAW,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"token-permit-metadata.js","sourceRoot":"","sources":["../../../../src/graylists/evm/token-permit-metadata.ts"],"names":[],"mappings":";AAAA,wEAAwE;AACxE,mEAAmE;AACnE,oEAAoE;AACpE,oEAAoE;;;AAiEpE,wDAYC;AA3ED,6CAA4C;AAC5C,mDAAqD;AAgBrD,kDAAkD;AACrC,QAAA,qBAAqB,GAA2B;IACzD,wEAAwE;IACxE,2EAA2E;IAC3E,uEAAuE;IACvE,kEAAkE;IAClE,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE;QAChB,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;QAChF,4CAA4C,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,GAAG,EAAE;QACtF,4CAA4C,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;KACvE;IACD,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE;QAChB,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;KACnF;IACD,CAAC,eAAO,CAAC,OAAO,CAAC,EAAE;QACf,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;KACnF;IACD,CAAC,eAAO,CAAC,KAAK,CAAC,EAAE;QACb,4CAA4C,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;KAC/E;IACD,CAAC,eAAO,CAAC,KAAK,CAAC,EAAE;QACb,4CAA4C,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;KAC/E;IACD,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE;QAChB,4CAA4C,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;KAC/E;IACD,CAAC,eAAO,CAAC,GAAG,CAAC,EAAE;QACX,4CAA4C,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;KAC/E;IACD,CAAC,eAAO,CAAC,SAAS,CAAC,EAAE;QACjB,4CAA4C,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;KAC/E;IACD,CAAC,eAAO,CAAC,IAAI,CAAC,EAAE;QACZ,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;KACnF;IACD,CAAC,eAAO,CAAC,KAAK,CAAC,EAAE;QACb,4CAA4C,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;KAC/E;IACD,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE;QAChB,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;KACnF;IACD,CAAC,eAAO,CAAC,SAAS,CAAC,EAAE;QACjB,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;KACnF;CACJ,CAAC;AAEF,SAAgB,sBAAsB,CAClC,WAAoB,EACpB,YAAoB;IAEpB,MAAM,KAAK,GAAG,6BAAqB,CAAC,WAAW,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,IAAI,CAAC;QACD,OAAO,KAAK,CAAC,IAAA,sBAAY,EAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC"}

package/dist/cjs/helpers/address.js

@@ -7,11 +7,15 @@ exports.TRON_NATIVE_ADDRESS = void 0;
 exports.getChainEngine = getChainEngine;
 exports.isEvmHexAddress = isEvmHexAddress;
 exports.isTronAddress = isTronAddress;
+exports.isTronAddressOrEvmHex = isTronAddressOrEvmHex;
+exports.isSolanaAddress = isSolanaAddress;
+exports.isAddressRepresentationValidForChain = isAddressRepresentationValidForChain;
+exports.isAddressRepresentationValidForEngine = isAddressRepresentationValidForEngine;
 exports.evmHexToTronAddress = evmHexToTronAddress;
 exports.tronAddressToEvmHex = tronAddressToEvmHex;
-exports.normalizeAddress = normalizeAddress;
+exports.getAddressIdentityKey = getAddressIdentityKey;
+exports.getAddressIdentityKeyByValue = getAddressIdentityKeyByValue;
 exports.detectChainEngine = detectChainEngine;
-exports.normalizeAddressByValue = normalizeAddressByValue;
 exports.addressEquals = addressEquals;
 exports.addressToHex = addressToHex;
 exports.addressToHexByValue = addressToHexByValue;
@@ -22,8 +26,13 @@ const enums_1 = require("../types/enums");
 const solana_1 = require("../whitelists/solana");
 // Tron-specific addresses (Base58Check format)
 exports.TRON_NATIVE_ADDRESS = "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb";
-const EVM_HEX_ADDRESS_REGEX = /^0x[0-9a-f]{40}$/iu;
+const EVM_HEX_ADDRESS_REGEX = /^0x[0-9a-fA-F]{40}$/u;
+const EVM_ADDRESS_BYTE_LENGTH = 20;
+const SOLANA_ADDRESS_BYTE_LENGTH = 32;
 const TRON_ADDRESS_PREFIX = 0x41;
+const TRON_PAYLOAD_BYTE_LENGTH = 1 + EVM_ADDRESS_BYTE_LENGTH;
+const TRON_CHECKSUM_BYTE_LENGTH = 4;
+const TRON_ADDRESS_BYTE_LENGTH = TRON_PAYLOAD_BYTE_LENGTH + TRON_CHECKSUM_BYTE_LENGTH;
 function getChainEngine(chainId) {
     if (chainId === enums_1.ChainId.Tron)
         return enums_1.ChainEngine.Tron;
@@ -35,16 +44,25 @@ function isEvmHexAddress(address) {
     return EVM_HEX_ADDRESS_REGEX.test(address);
 }
 function isTronAddress(address) {
-    if (!address)
-        return false;
-    if (address.startsWith("0x"))
-        return false;
-    if (!address.startsWith("T"))
-        return false;
-    if (address.length !== 34)
-        return false;
-    // AI: TODO: add Base58Check checksum verification if needed
-    return true;
+    return decodeTronAddressBytes(address) !== undefined;
+}
+function isTronAddressOrEvmHex(address) {
+    return isEvmHexAddress(address) || isTronAddress(address);
+}
+function isSolanaAddress(address) {
+    return decodeSolanaAddressBytes(address) !== undefined;
+}
+// Use only for standalone semantic address fields. Encoded EIP-712, ABI and
+// interaction fields keep their own stricter wire-format validation.
+function isAddressRepresentationValidForChain(chainId, address) {
+    return isAddressRepresentationValidForEngine(getChainEngine(chainId), address);
+}
+function isAddressRepresentationValidForEngine(engine, address) {
+    if (engine === enums_1.ChainEngine.EVM)
+        return isEvmHexAddress(address);
+    if (engine === enums_1.ChainEngine.Tron)
+        return isTronAddressOrEvmHex(address);
+    return isSolanaAddress(address);
 }
 // Converts a 20-byte EVM hex address to Tron Base58Check format.
 function evmHexToTronAddress(evmAddress) {
@@ -55,83 +73,141 @@ function evmHexToTronAddress(evmAddress) {
         Uint8Array.of(TRON_ADDRESS_PREFIX),
         (0, viem_1.hexToBytes)(evmAddress),
     ]);
-    const firstHash = (0, viem_1.sha256)(payload);
-    const secondHash = (0, viem_1.sha256)((0, viem_1.hexToBytes)(firstHash));
-    const checksum = (0, viem_1.hexToBytes)(secondHash).slice(0, 4);
+    const checksum = computeTronChecksum(payload);
     return bs58_1.default.encode((0, viem_1.concatBytes)([payload, checksum]));
 }
-// Converts Tron Base58Check address to EVM hex format (0x...)
-// Tron address = 0x41 (1 byte prefix) + 20 bytes address + 4 bytes checksum
-// We extract the 20-byte address part and return as 0x-prefixed hex
+// Converts a valid Tron Base58Check address to its 20-byte EVM hex identity.
 function tronAddressToEvmHex(tronAddress) {
-    const decoded = bs58_1.default.decode(tronAddress);
-    // Skip first byte (0x41 prefix) and last 4 bytes (checksum)
-    const addressBytes = decoded.slice(1, 21);
+    const addressBytes = decodeTronAddressBytes(tronAddress);
+    if (addressBytes === undefined) {
+        throw new Error(`Invalid Tron Base58Check address: ${tronAddress}`);
+    }
     return (0, viem_1.bytesToHex)(addressBytes);
 }
-// Normalizes address for comparison based on chain engine
-function normalizeAddress(chainId, address) {
+// Builds a canonical address-byte key using the representation rules of the
+// given chain. Malformed values have no address identity and return undefined.
+function getAddressIdentityKey(chainId, address) {
     const engine = getChainEngine(chainId);
-    return applyEngineNormalization(address, engine);
+    return toCanonicalAddressHex(address, engine);
 }
-// Detects the chain engine from the address value alone (no chainId required).
-// Useful when a chain is not fixed (e.g. destinationChainIds = "any").
+// Builds an address identity key using only its own value — no chainId needed.
+function getAddressIdentityKeyByValue(address) {
+    return toCanonicalAddressHexByValue(address);
+}
+// Detects the chain engine from a valid address value alone. Ambiguous 20-byte
+// hex belongs to the EVM-compatible representation. Invalid values have no
+// detectable chain engine.
 function detectChainEngine(address) {
-    if (address.startsWith("0x"))
+    if (isEvmHexAddress(address))
         return enums_1.ChainEngine.EVM;
     if (isTronAddress(address))
         return enums_1.ChainEngine.Tron;
-    return enums_1.ChainEngine.Solana;
-}
-// Normalizes an address using only its own value — no chainId needed.
-function normalizeAddressByValue(address) {
-    return applyEngineNormalization(address, detectChainEngine(address));
-}
-function applyEngineNormalization(address, engine) {
-    if (engine === enums_1.ChainEngine.Tron || engine === enums_1.ChainEngine.Solana) {
-        return address; // case-sensitive
-    }
-    return address.toLowerCase(); // EVM: case-insensitive
+    if (isSolanaAddress(address))
+        return enums_1.ChainEngine.Solana;
+    return undefined;
 }
-// Compares two addresses with chain-aware normalization
-function addressEquals(chainId, a, b) {
-    return normalizeAddress(chainId, a) === normalizeAddress(chainId, b);
+// Compares canonical address identity. Field-specific format validation must
+// happen separately; malformed values never compare equal and never throw.
+function addressEquals(chainId, left, right) {
+    const engine = getChainEngine(chainId);
+    const leftCanonical = toCanonicalAddressHex(left, engine);
+    const rightCanonical = toCanonicalAddressHex(right, engine);
+    return leftCanonical !== undefined
+        && rightCanonical !== undefined
+        && leftCanonical === rightCanonical;
 }
 // Raw byte representation, used when an address flows into the intent ID
-// keccak256 hash. EVM → 20 bytes, Tron → 20 bytes (after stripping 0x41
-// prefix and checksum), Solana → 32 bytes (base58, no checksum).
+// keccak256 hash. EVM → 20 bytes, Tron → 20 bytes, Solana → 32 bytes.
 function addressToHex(chainId, address) {
-    return applyEngineToHex(address, getChainEngine(chainId));
+    const engine = getChainEngine(chainId);
+    const canonical = toCanonicalAddressHex(address, engine);
+    if (canonical === undefined) {
+        throw new Error(`Invalid ${enums_1.ChainEngine[engine]} address: ${address}`);
+    }
+    return canonical;
 }
 // Same as addressToHex but infers the engine from the address value alone.
 // Use when the chainId is unknown (e.g. destinationChainIds = "any").
 function addressToHexByValue(address) {
-    return applyEngineToHex(address, detectChainEngine(address));
+    const canonical = toCanonicalAddressHexByValue(address);
+    if (canonical === undefined)
+        throw new Error(`Invalid address: ${address}`);
+    return canonical;
 }
-function applyEngineToHex(address, engine) {
-    // API address parsing treats 0x-prefixed values as raw hex for every
-    // chain, including Tron. Preserve that behavior before engine-specific
-    // human-readable decoding.
-    if (address.startsWith("0x")) {
-        return address.toLowerCase();
+// Checks if address is the native token for the given chain.
+function isNativeToken(address, chainId) {
+    const engine = getChainEngine(chainId);
+    if (engine === enums_1.ChainEngine.Tron) {
+        // Accept strict Tron Base58Check and the equivalent 20-byte EVM hex representation.
+        return addressEquals(chainId, address, exports.TRON_NATIVE_ADDRESS);
+    }
+    if (engine === enums_1.ChainEngine.Solana) {
+        // Accept only a valid 32-byte Solana Base58 address.
+        return addressEquals(chainId, address, solana_1.SYSTEM_PROGRAM);
     }
+    // Accept only a valid 20-byte EVM hex address.
+    return isEvmHexAddress(address) && address.toLowerCase() === viem_1.zeroAddress;
+}
+function toCanonicalAddressHex(address, engine) {
     if (engine === enums_1.ChainEngine.EVM) {
-        return address.toLowerCase();
+        return isEvmHexAddress(address) ? address.toLowerCase() : undefined;
     }
     if (engine === enums_1.ChainEngine.Tron) {
-        return tronAddressToEvmHex(address);
+        if (isEvmHexAddress(address))
+            return address.toLowerCase();
+        const bytes = decodeTronAddressBytes(address);
+        return bytes === undefined ? undefined : (0, viem_1.bytesToHex)(bytes);
     }
-    return (0, viem_1.bytesToHex)(bs58_1.default.decode(address));
+    const bytes = decodeSolanaAddressBytes(address);
+    return bytes === undefined ? undefined : (0, viem_1.bytesToHex)(bytes);
 }
-// Checks if address is the native token for the given chain.
-function isNativeToken(address, chainId) {
-    const engine = getChainEngine(chainId);
-    if (engine === enums_1.ChainEngine.Tron) {
-        return address === exports.TRON_NATIVE_ADDRESS;
+function toCanonicalAddressHexByValue(address) {
+    if (isEvmHexAddress(address))
+        return address.toLowerCase();
+    const tronBytes = decodeTronAddressBytes(address);
+    if (tronBytes !== undefined)
+        return (0, viem_1.bytesToHex)(tronBytes);
+    const solanaBytes = decodeSolanaAddressBytes(address);
+    return solanaBytes === undefined ? undefined : (0, viem_1.bytesToHex)(solanaBytes);
+}
+function decodeTronAddressBytes(address) {
+    const decoded = decodeBase58(address);
+    if (decoded === undefined || decoded.length !== TRON_ADDRESS_BYTE_LENGTH)
+        return undefined;
+    if (decoded[0] !== TRON_ADDRESS_PREFIX)
+        return undefined;
+    const payload = decoded.slice(0, TRON_PAYLOAD_BYTE_LENGTH);
+    const checksum = decoded.slice(TRON_PAYLOAD_BYTE_LENGTH);
+    if (!bytesEqual(checksum, computeTronChecksum(payload)))
+        return undefined;
+    return payload.slice(1);
+}
+function decodeSolanaAddressBytes(address) {
+    const decoded = decodeBase58(address);
+    return decoded?.length === SOLANA_ADDRESS_BYTE_LENGTH ? decoded : undefined;
+}
+function decodeBase58(value) {
+    if (value.length === 0)
+        return undefined;
+    try {
+        return bs58_1.default.decode(value);
     }
-    if (engine === enums_1.ChainEngine.Solana) {
-        return address === solana_1.SYSTEM_PROGRAM;
+    catch {
+        return undefined;
     }
-    return address.toLowerCase() === viem_1.zeroAddress;
+}
+function computeTronChecksum(payload) {
+    const firstHash = (0, viem_1.sha256)(payload);
+    const secondHash = (0, viem_1.sha256)((0, viem_1.hexToBytes)(firstHash));
+    return (0, viem_1.hexToBytes)(secondHash).slice(0, TRON_CHECKSUM_BYTE_LENGTH);
+}
+function bytesEqual(left, right) {
+    if (left.length !== right.length)
+        return false;
+    for (let i = 0; i < left.length; i++) {
+        if (left[i] !== right[i])
+            return false;
+    }
+    return true;
 }
 //# sourceMappingURL=address.js.map

package/dist/cjs/helpers/address.js.map

@@ -1 +1 @@
-{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../src/helpers/address.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../src/helpers/address.ts"],"names":[],"mappings":";;;;;;AAsBA,wCAIC;AAED,0CAEC;AAED,sCAEC;AAED,sDAEC;AAED,0CAEC;AAID,oFAKC;AAED,sFAOC;AAGD,kDAYC;AAGD,kDAMC;AAID,sDAMC;AAGD,oEAIC;AAKD,8CAKC;AAID,sCASC;AAID,oCAOC;AAID,kDAIC;AAGD,sCAYC;AA9JD,+BAMc;AACd,gDAAwB;AACxB,0CAAsD;AACtD,iDAAsD;AAEtD,+CAA+C;AAClC,QAAA,mBAAmB,GAAG,oCAAoC,CAAC;AAExE,MAAM,qBAAqB,GAAG,sBAAsB,CAAC;AACrD,MAAM,uBAAuB,GAAG,EAAE,CAAC;AACnC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AACtC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,MAAM,wBAAwB,GAAG,CAAC,GAAG,uBAAuB,CAAC;AAC7D,MAAM,yBAAyB,GAAG,CAAC,CAAC;AACpC,MAAM,wBAAwB,GAAG,wBAAwB,GAAG,yBAAyB,CAAC;AAEtF,SAAgB,cAAc,CAAC,OAAe;IAC1C,IAAI,OAAO,KAAK,eAAO,CAAC,IAAI;QAAE,OAAO,mBAAW,CAAC,IAAI,CAAC;IACtD,IAAI,OAAO,KAAK,eAAO,CAAC,MAAM;QAAE,OAAO,mBAAW,CAAC,MAAM,CAAC;IAC1D,OAAO,mBAAW,CAAC,GAAG,CAAC;AAC3B,CAAC;AAED,SAAgB,eAAe,CAAC,OAAe;IAC3C,OAAO,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,SAAgB,aAAa,CAAC,OAAe;IACzC,OAAO,sBAAsB,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC;AACzD,CAAC;AAED,SAAgB,qBAAqB,CAAC,OAAe;IACjD,OAAO,eAAe,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,SAAgB,eAAe,CAAC,OAAe;IAC3C,OAAO,wBAAwB,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC;AAC3D,CAAC;AAED,4EAA4E;AAC5E,qEAAqE;AACrE,SAAgB,oCAAoC,CAChD,OAAe,EACf,OAAe;IAEf,OAAO,qCAAqC,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AACnF,CAAC;AAED,SAAgB,qCAAqC,CACjD,MAAmB,EACnB,OAAe;IAEf,IAAI,MAAM,KAAK,mBAAW,CAAC,GAAG;QAAE,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IAChE,IAAI,MAAM,KAAK,mBAAW,CAAC,IAAI;QAAE,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACvE,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,iEAAiE;AACjE,SAAgB,mBAAmB,CAAC,UAAkB;IAClD,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,kBAAW,EAAC;QACxB,UAAU,CAAC,EAAE,CAAC,mBAAmB,CAAC;QAClC,IAAA,iBAAU,EAAC,UAA2B,CAAC;KAC1C,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE9C,OAAO,cAAI,CAAC,MAAM,CAAC,IAAA,kBAAW,EAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,6EAA6E;AAC7E,SAAgB,mBAAmB,CAAC,WAAmB;IACnD,MAAM,YAAY,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACzD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,qCAAqC,WAAW,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,IAAA,iBAAU,EAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,4EAA4E;AAC5E,+EAA+E;AAC/E,SAAgB,qBAAqB,CACjC,OAAe,EACf,OAAe;IAEf,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED,+EAA+E;AAC/E,SAAgB,4BAA4B,CACxC,OAAe;IAEf,OAAO,4BAA4B,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,+EAA+E;AAC/E,2EAA2E;AAC3E,2BAA2B;AAC3B,SAAgB,iBAAiB,CAAC,OAAe;IAC7C,IAAI,eAAe,CAAC,OAAO,CAAC;QAAE,OAAO,mBAAW,CAAC,GAAG,CAAC;IACrD,IAAI,aAAa,CAAC,OAAO,CAAC;QAAE,OAAO,mBAAW,CAAC,IAAI,CAAC;IACpD,IAAI,eAAe,CAAC,OAAO,CAAC;QAAE,OAAO,mBAAW,CAAC,MAAM,CAAC;IACxD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,6EAA6E;AAC7E,2EAA2E;AAC3E,SAAgB,aAAa,CAAC,OAAe,EAAE,IAAY,EAAE,KAAa;IACtE,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAEvC,MAAM,aAAa,GAAG,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAE5D,OAAO,aAAa,KAAK,SAAS;WAC3B,cAAc,KAAK,SAAS;WAC5B,aAAa,KAAK,cAAc,CAAC;AAC5C,CAAC;AAED,yEAAyE;AACzE,sEAAsE;AACtE,SAAgB,YAAY,CAAC,OAAe,EAAE,OAAe;IACzD,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,WAAW,mBAAW,CAAC,MAAM,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,2EAA2E;AAC3E,sEAAsE;AACtE,SAAgB,mBAAmB,CAAC,OAAe;IAC/C,MAAM,SAAS,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,SAAS,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IAC5E,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,6DAA6D;AAC7D,SAAgB,aAAa,CAAC,OAAe,EAAE,OAAe;IAC1D,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,mBAAW,CAAC,IAAI,EAAE,CAAC;QAC9B,oFAAoF;QACpF,OAAO,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,2BAAmB,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,MAAM,KAAK,mBAAW,CAAC,MAAM,EAAE,CAAC;QAChC,qDAAqD;QACrD,OAAO,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,uBAAc,CAAC,CAAC;IAC3D,CAAC;IACD,+CAA+C;IAC/C,OAAO,eAAe,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,kBAAW,CAAC;AAC7E,CAAC;AAED,SAAS,qBAAqB,CAC1B,OAAe,EACf,MAAmB;IAEnB,IAAI,MAAM,KAAK,mBAAW,CAAC,GAAG,EAAE,CAAC;QAC7B,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAmB,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,CAAC;IAED,IAAI,MAAM,KAAK,mBAAW,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,eAAe,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC,WAAW,EAAmB,CAAC;QAC5E,MAAM,KAAK,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC9C,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,iBAAU,EAAC,KAAK,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,KAAK,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,iBAAU,EAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,4BAA4B,CAAC,OAAe;IACjD,IAAI,eAAe,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC,WAAW,EAAmB,CAAC;IAE5E,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,IAAA,iBAAU,EAAC,SAAS,CAAC,CAAC;IAE1D,MAAM,WAAW,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACtD,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,iBAAU,EAAC,WAAW,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe;IAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,wBAAwB;QAAE,OAAO,SAAS,CAAC;IAC3F,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,mBAAmB;QAAE,OAAO,SAAS,CAAC;IAEzD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,wBAAwB,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAE1E,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAe;IAC7C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,OAAO,EAAE,MAAM,KAAK,0BAA0B,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEzC,IAAI,CAAC;QACD,OAAO,cAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAmB;IAC5C,MAAM,SAAS,GAAG,IAAA,aAAM,EAAC,OAAO,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,IAAA,aAAM,EAAC,IAAA,iBAAU,EAAC,SAAS,CAAC,CAAC,CAAC;IACjD,OAAO,IAAA,iBAAU,EAAC,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,UAAU,CAAC,IAAgB,EAAE,KAAiB;IACnD,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAC3C,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/cjs/helpers/amount.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMaxAmountMode = isMaxAmountMode;
+const types_1 = require("../types");
+function isMaxAmountMode(amount) {
+    return amount === types_1.SpecialAmount.Max || amount === types_1.SpecialAmount.MaxReserved;
+}
+//# sourceMappingURL=amount.js.map

package/dist/cjs/helpers/amount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.js","sourceRoot":"","sources":["../../../src/helpers/amount.ts"],"names":[],"mappings":";;AAEA,0CAEC;AAJD,oCAAyC;AAEzC,SAAgB,eAAe,CAAC,MAAc;IAC1C,OAAO,MAAM,KAAK,qBAAa,CAAC,GAAG,IAAI,MAAM,KAAK,qBAAa,CAAC,WAAW,CAAC;AAChF,CAAC"}

package/dist/cjs/helpers/evm-dln-hook-pack.js

@@ -2,9 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.packEvmHookV1 = packEvmHookV1;
 exports.packEvmTransactionCall = packEvmTransactionCall;
+exports.packEvmTransactionCallForTrade = packEvmTransactionCallForTrade;
 exports.serializeDlnHook = serializeDlnHook;
 const viem_1 = require("viem");
 const enums_1 = require("../types/enums");
+const subscription_to_chain_id_1 = require("../whitelists/subscription-to-chain-id");
+const address_1 = require("./address");
 const hex_1 = require("./hex");
 // Hook envelope: ABI-encoded tuple prefixed with a `uint8 version=1` byte.
 // keccak256 of these bytes is what ends up in `intent.externalCallHash`.
@@ -60,6 +63,18 @@ function packEvmTransactionCall(data, dstChainAuthorityAddress) {
         targetPayload: inner,
     });
 }
+function packEvmTransactionCallForTrade(data, trade) {
+    if (trade.dstChainAuthorityAddress === undefined) {
+        throw new Error("evm_transaction_call hook requires dstChainAuthorityAddress on the trade");
+    }
+    const realDestinationChainId = (0, subscription_to_chain_id_1.resolveChainId)(trade.dstChainId);
+    // The API converts a chain-native destination authority, including Tron
+    // Base58Check, to its raw address before ABI-encoding the EVM hook envelope.
+    const fallbackAddress = realDestinationChainId === undefined
+        ? trade.dstChainAuthorityAddress
+        : (0, address_1.addressToHex)(realDestinationChainId, trade.dstChainAuthorityAddress);
+    return packEvmTransactionCall(data, fallbackAddress);
+}
 // Parses an EVM request trade's `dlnHook` JSON and returns the serialized
 // external-call bytes used for hashing. Returns `undefined` when the trade has
 // no hook. Throws on unknown / Solana hook types; Solana hooks are verified
@@ -73,10 +88,7 @@ function serializeDlnHook(trade) {
         case enums_1.DlnHookType.EvmHookV1:
             return packEvmHookV1(hook.data);
         case enums_1.DlnHookType.EvmTransactionCall: {
-            if (trade.dstChainAuthorityAddress === undefined) {
-                throw new Error("evm_transaction_call hook requires dstChainAuthorityAddress on the trade");
-            }
-            return packEvmTransactionCall(hook.data, trade.dstChainAuthorityAddress);
+            return packEvmTransactionCallForTrade(hook.data, trade);
         }
         case enums_1.DlnHookType.SolanaSerializedInstructions:
             throw new Error("Solana hook types are not folded into externalCallHash");

package/dist/cjs/helpers/evm-dln-hook-pack.js.map

@@ -1 +1 @@
-{"version":3,"file":"evm-dln-hook-pack.js","sourceRoot":"","sources":["../../../src/helpers/evm-dln-hook-pack.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"evm-dln-hook-pack.js","sourceRoot":"","sources":["../../../src/helpers/evm-dln-hook-pack.ts"],"names":[],"mappings":";;AA2CA,sCAaC;AASD,wDA4BC;AAED,wEAgBC;AAOD,4CAkBC;AAxID,+BAAmE;AACnE,0CAA6C;AAE7C,qFAAwE;AACxE,uCAAyC;AACzC,+BAA+C;AAE/C,2EAA2E;AAC3E,yEAAyE;AACzE,MAAM,cAAc,GAAG;IACnB,IAAI,EAAE,OAAO;IACb,UAAU,EAAE;QACR,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE;QAC5C,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE;QAC5C,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE;QACzC,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,MAAM,EAAE;QAC/C,EAAE,IAAI,EAAE,6BAA6B,EAAE,IAAI,EAAE,MAAM,EAAE;QACrD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE;KACrC;CACK,CAAC;AAEX,MAAM,uBAAuB,GAAkB,MAAM,CAAC;AAsBtD,SAAgB,aAAa,CAAC,IAAmB;IAC7C,MAAM,KAAK,GAAG,IAAA,0BAAmB,EAC7B,CAAC,cAAc,CAAC,EAChB,CAAC;YACG,eAAe,EAAE,IAAI,CAAC,eAAgC;YACtD,eAAe,EAAE,IAAI,CAAC,MAAuB;YAC7C,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;YACjC,qBAAqB,EAAE,IAAI,CAAC,WAAW;YACvC,2BAA2B,EAAE,IAAI,CAAC,iBAAiB;YACnD,OAAO,EAAE,IAAA,4BAAsB,EAAC,IAAI,CAAC,aAAa,CAAC;SACtD,CAAC,CACL,CAAC;IACF,OAAO,IAAA,gBAAS,EAAC,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,8EAA8E;AAC9E,8CAA8C;AAC9C,qBAAqB;AACrB,kCAAkC;AAClC,uCAAuC;AACvC,+CAA+C;AAC/C,0BAA0B;AAC1B,SAAgB,sBAAsB,CAClC,IAA4B,EAC5B,wBAAgC;IAEhC,MAAM,KAAK,GAAG,IAAA,0BAAmB,EAC7B,CAAC;YACG,IAAI,EAAE,OAAO;YACb,UAAU,EAAE;gBACR,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC/B,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACjC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;aACtC;SACJ,CAAC,EACF,CAAC;YACG,EAAE,EAAE,IAAI,CAAC,EAAmB;YAC5B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YAC5B,QAAQ,EAAE,IAAA,4BAAsB,EAAC,IAAI,CAAC,QAAQ,CAAC;SAClD,CAAC,CACL,CAAC;IAEF,OAAO,aAAa,CAAC;QACjB,eAAe,EAAE,wBAAwB;QACzC,MAAM,EAAE,kBAAW;QACnB,MAAM,EAAE,GAAG;QACX,WAAW,EAAE,KAAK;QAClB,iBAAiB,EAAE,IAAI;QACvB,aAAa,EAAE,KAAK;KACvB,CAAC,CAAC;AACP,CAAC;AAED,SAAgB,8BAA8B,CAC1C,IAA4B,EAC5B,KAAmB;IAEnB,IAAI,KAAK,CAAC,wBAAwB,KAAK,SAAS,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,sBAAsB,GAAG,IAAA,yCAAc,EAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAChE,wEAAwE;IACxE,6EAA6E;IAC7E,MAAM,eAAe,GAAG,sBAAsB,KAAK,SAAS;QACxD,CAAC,CAAC,KAAK,CAAC,wBAAwB;QAChC,CAAC,CAAC,IAAA,sBAAY,EAAC,sBAAsB,EAAE,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAE3E,OAAO,sBAAsB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;AACzD,CAAC;AAED,0EAA0E;AAC1E,+EAA+E;AAC/E,4EAA4E;AAC5E,gFAAgF;AAChF,kDAAkD;AAClD,SAAgB,gBAAgB,CAAC,KAAmB;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAErC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAgB,CAAC;IAEtD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,mBAAW,CAAC,SAAS;YACtB,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,KAAK,mBAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC;YAClC,OAAO,8BAA8B,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5D,CAAC;QACD,KAAK,mBAAW,CAAC,4BAA4B;YACzC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC9E,OAAO,CAAC,CAAC,CAAC;YACN,MAAM,UAAU,GAAU,IAAI,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;IACL,CAAC;AACL,CAAC"}