@debridge-finance/borderless-validation-sdk 0.0.0-dev-dee2389

package/dist/cjs/validator.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createValidator = createValidator;
+const types_1 = require("./types");
+const zod_1 = require("./helpers/zod");
+const echo_fields_1 = require("./validations/echo-fields");
+const required_actions_1 = require("./validations/required-actions");
+const hooks_common_1 = require("./validations/hooks-common");
+const trades_1 = require("./validations/trades");
+const environment_config_1 = require("./whitelists/environment-config");
+function createValidator(config) {
+    const envConfig = (0, environment_config_1.buildEnvironmentConfig)(config.environment);
+    return {
+        validate(url, request, response) {
+            const violations = [];
+            // MEDIUM: URL must match an allowed URL for the configured environment
+            if (!envConfig.allowedUrls.some(allowed => urlsEqual(url, allowed))) {
+                violations.push({
+                    code: types_1.ViolationCode.UrlNotWhitelisted,
+                    message: "URL does not match any allowed URL for this environment",
+                    path: "url",
+                    actual: url,
+                });
+            }
+            const reqResult = types_1.BundleCreationRequestSchema.safeParse(request);
+            const resResult = types_1.BundleCreationResponseSchema.safeParse(response);
+            if (!reqResult.success) {
+                violations.push(...reqResult.error.issues.map((issue) => ({
+                    code: types_1.ViolationCode.InvalidRequestStructure,
+                    message: issue.message,
+                    path: (0, zod_1.formatPath)(["request", ...issue.path]),
+                    details: issue
+                })));
+            }
+            if (!resResult.success) {
+                violations.push(...resResult.error.issues.map((issue) => ({
+                    code: types_1.ViolationCode.InvalidResponseStructure,
+                    message: issue.message,
+                    path: (0, zod_1.formatPath)(["response", ...issue.path]),
+                    details: issue
+                })));
+            }
+            if (!reqResult.success || !resResult.success) {
+                // If the structure is invalid, we can't do any meaningful validation,
+                // so we do not continue with field validations and just report
+                // the structure issues (+ URL violation if any).
+                return { ok: false, violations };
+            }
+            violations.push(...validateBundleCreation(reqResult.data, resResult.data, envConfig));
+            return {
+                ok: violations.length === 0,
+                violations,
+            };
+        },
+    };
+}
+function validateBundleCreation(request, response, envConfig) {
+    const quoteMode = isQuoteMode(request);
+    return [
+        ...(0, echo_fields_1.validateEchoFields)(request, response),
+        ...(0, trades_1.validateTrades)(request, response, quoteMode),
+        ...(0, required_actions_1.validateRequiredActions)(request, response, quoteMode, envConfig),
+        ...(0, hooks_common_1.validateHooks)(request, response, quoteMode),
+    ];
+}
+// Compares URLs ignoring a trailing slash
+function urlsEqual(a, b) {
+    return a.replace(/\/$/, "") === b.replace(/\/$/, "");
+}
+function isQuoteMode(request) {
+    return request.trades.every(t => t.srcChainAuthorityAddress === undefined &&
+        t.dstChainTokenOutRecipient === undefined &&
+        t.dstChainAuthorityAddress === undefined);
+}
+//# sourceMappingURL=validator.js.map

package/dist/cjs/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/validator.ts"],"names":[],"mappings":"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"}

package/dist/cjs/whitelists/environment-config.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildEnvironmentConfig = buildEnvironmentConfig;
+const web3_js_1 = require("@solana/web3.js");
+const enums_1 = require("../types/enums");
+const validation_1 = require("../types/validation");
+const intent_signature_1 = require("./solana/intent-signature");
+const programs_1 = require("./solana/programs");
+// =============================================
+// EVM: Allowance Holder
+// =============================================
+const DEFAULT_PROD_EVM_ALLOWANCE_HOLDER_ADDRESS = "0xddddddddd4B6472c5002F95610b194D1161223d0";
+const ALLOWANCE_HOLDER_BY_ENVIRONMENT = {
+    [validation_1.Environment.Prod]: {
+        [enums_1.ChainId.Wildcard]: [DEFAULT_PROD_EVM_ALLOWANCE_HOLDER_ADDRESS], // TODO: replace wildcard with actual chain-specific list
+    },
+    [validation_1.Environment.Dubai]: {
+        [enums_1.ChainId.Wildcard]: ["0xB75b7b65369aA7874FD1f0cDA020958D3491e568"], // TODO: replace wildcard with actual chain-specific list
+    },
+    [validation_1.Environment.Hanoi]: {
+        [enums_1.ChainId.Polygon]: ["0x1Baa3D24E5e5eBaF876CA1BC86be1636E3EA7F51"],
+        [enums_1.ChainId.BNB]: ["0x6e8D9768B3D5e70881F00411e6DFa72c3D59Ea1a"],
+    },
+    [validation_1.Environment.Madrid]: {}, // TODO: placeholder — update when known
+};
+// =============================================
+// EVM: Intent Manager
+// =============================================
+const DEFAULT_PROD_EVM_INTENT_MANAGER_ADDRESS = "0xDDDDDDDdeB2E68Ee19832e356FCB5537124A9708";
+const INTENT_MANAGER_BY_ENVIRONMENT = {
+    [validation_1.Environment.Prod]: {
+        [enums_1.ChainId.Wildcard]: [DEFAULT_PROD_EVM_INTENT_MANAGER_ADDRESS], // TODO: replace wildcard with actual chain-specific list
+    },
+    [validation_1.Environment.Dubai]: {
+        [enums_1.ChainId.Wildcard]: ["0x1266F88510e6dE4321ce5aA219ED35b5dfFD3410"], // TODO: replace wildcard with actual chain-specific list
+    },
+    [validation_1.Environment.Hanoi]: {
+        [enums_1.ChainId.Polygon]: ["0x9d8421Cc205195b55E2aBa5fdE5C54e952053773"],
+        [enums_1.ChainId.BNB]: ["0x62Cd6f0ccE48a229865686CB6796cDeba439a846"],
+    },
+    [validation_1.Environment.Madrid]: {}, // TODO: placeholder — update when known
+};
+// =============================================
+// Solana: Intent Program
+// =============================================
+const SOLANA_INTENT_PROGRAM_BY_ENVIRONMENT = {
+    [validation_1.Environment.Prod]: "DeintXmrdZFgSKzEWcJWhK793HuqnfDydAPvHmayY5Xz",
+    [validation_1.Environment.Dubai]: "intueneJjzHttKp83gWH3GX1h1Uwuixuusj4T8vGDzk",
+    [validation_1.Environment.Hanoi]: "intV2u5xDE8T2ZMFP3W3X6sVqGHBT7zvYtTW3rRLmvE",
+    [validation_1.Environment.Madrid]: "", // TODO: placeholder — update when known
+};
+// =============================================
+// Solana: Allowance Holder
+// =============================================
+const DEFAULT_PROD_SOLANA_ALLOWANCE_HOLDER_ADDRESS = "73dUbDAWUDZRfXM3DcuRgR4q74nr97MyuBt95738JnMz";
+const SOLANA_ALLOWANCE_HOLDER_BY_ENVIRONMENT = {
+    [validation_1.Environment.Prod]: DEFAULT_PROD_SOLANA_ALLOWANCE_HOLDER_ADDRESS,
+    [validation_1.Environment.Dubai]: DEFAULT_PROD_SOLANA_ALLOWANCE_HOLDER_ADDRESS,
+    [validation_1.Environment.Hanoi]: DEFAULT_PROD_SOLANA_ALLOWANCE_HOLDER_ADDRESS,
+    [validation_1.Environment.Madrid]: "", // TODO: placeholder — update when known
+};
+// =============================================
+// Allowed URLs
+// =============================================
+const ALLOWED_URLS_BY_ENVIRONMENT = {
+    [validation_1.Environment.Prod]: [
+        // TODO: add Prod URL
+        "https://cross-chain-api-stage.stage.debridge.io/v1.0/bundle", // Stage
+    ],
+    // TODO: update the allowed URLs for non-prod environments when known
+    [validation_1.Environment.Dubai]: [],
+    [validation_1.Environment.Hanoi]: [],
+    [validation_1.Environment.Madrid]: [],
+};
+// =============================================
+// Builder
+// =============================================
+const STATE_PDA_SEED = new TextEncoder().encode("state");
+function computeStatePdaBase58(intentProgram) {
+    const programPubKey = new web3_js_1.PublicKey(intentProgram);
+    const [statePda] = web3_js_1.PublicKey.findProgramAddressSync([STATE_PDA_SEED], programPubKey);
+    return statePda.toBase58();
+}
+function buildTransactionAllowedPrograms(intentProgram) {
+    return new Set([
+        programs_1.COMPUTE_BUDGET_PROGRAM,
+        programs_1.SPL_TOKEN_PROGRAM,
+        programs_1.SPL_TOKEN_2022_PROGRAM,
+        programs_1.SYSTEM_PROGRAM,
+        programs_1.ASSOCIATED_TOKEN_PROGRAM,
+        intentProgram,
+    ]);
+}
+function buildSignTransactionAllowedPrograms(intentProgram) {
+    return new Set([
+        programs_1.MEMO_PROGRAM,
+        programs_1.SPL_TOKEN_PROGRAM,
+        programs_1.SPL_TOKEN_2022_PROGRAM,
+        programs_1.SYSTEM_PROGRAM,
+        programs_1.ASSOCIATED_TOKEN_PROGRAM,
+        intentProgram,
+    ]);
+}
+function buildEnvironmentConfig(environment) {
+    const solanaIntentProgram = SOLANA_INTENT_PROGRAM_BY_ENVIRONMENT[environment];
+    return {
+        allowanceHolderContracts: ALLOWANCE_HOLDER_BY_ENVIRONMENT[environment],
+        intentManagerContracts: INTENT_MANAGER_BY_ENVIRONMENT[environment],
+        solanaIntentProgram,
+        solanaAllowanceHolder: SOLANA_ALLOWANCE_HOLDER_BY_ENVIRONMENT[environment],
+        solanaTransactionAllowedPrograms: buildTransactionAllowedPrograms(solanaIntentProgram),
+        solanaSignTransactionAllowedPrograms: buildSignTransactionAllowedPrograms(solanaIntentProgram),
+        solanaExpectedStatePdaBase58: computeStatePdaBase58(solanaIntentProgram),
+        solanaSignatureConfig: (0, intent_signature_1.getIntentSignatureConfig)(environment),
+        allowedUrls: ALLOWED_URLS_BY_ENVIRONMENT[environment],
+    };
+}
+//# sourceMappingURL=environment-config.js.map

package/dist/cjs/whitelists/environment-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-config.js","sourceRoot":"","sources":["../../../src/whitelists/environment-config.ts"],"names":[],"mappings":"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"}

package/dist/cjs/whitelists/evm/caveat-enforcers.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIMESTAMP_ENFORCER_CONTRACTS = exports.ID_ENFORCER_CONTRACTS = exports.EXACT_EXECUTION_BATCH_ENFORCER_CONTRACTS = exports.EXACT_EXECUTION_ENFORCER_CONTRACTS = void 0;
+const enums_1 = require("../../types/enums");
+// See: https://docs.metamask.io/smart-accounts-kit/changelog/0.13.0#caveat-enforcers
+exports.EXACT_EXECUTION_ENFORCER_CONTRACTS = {
+    [enums_1.ChainId.Wildcard]: ["0x146713078D39eCC1F5338309c28405ccf85Abfbb"] // wildcard for any chain
+};
+exports.EXACT_EXECUTION_BATCH_ENFORCER_CONTRACTS = {
+    [enums_1.ChainId.Wildcard]: ["0x1e141e455d08721Dd5BCDA1BaA6Ea5633Afd5017"] // wildcard for any chain
+};
+exports.ID_ENFORCER_CONTRACTS = {
+    [enums_1.ChainId.Wildcard]: ["0xC8B5D93463c893401094cc70e66A206fb5987997"] // wildcard for any chain
+};
+exports.TIMESTAMP_ENFORCER_CONTRACTS = {
+    [enums_1.ChainId.Wildcard]: ["0x1046bb45C8d673d4ea75321280DB34899413c069"] // wildcard for any chain
+};
+//# sourceMappingURL=caveat-enforcers.js.map

package/dist/cjs/whitelists/evm/caveat-enforcers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caveat-enforcers.js","sourceRoot":"","sources":["../../../../src/whitelists/evm/caveat-enforcers.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAG5C,qFAAqF;AAExE,QAAA,kCAAkC,GAAoB;IAC/D,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,4CAA4C,CAAC,CAAC,yBAAyB;CACtF,CAAC;AAEE,QAAA,wCAAwC,GAAoB;IACrE,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,4CAA4C,CAAC,CAAC,yBAAyB;CACtF,CAAC;AAEE,QAAA,qBAAqB,GAAoB;IAClD,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,4CAA4C,CAAC,CAAC,yBAAyB;CACtF,CAAC;AAEE,QAAA,4BAA4B,GAAoB;IACzD,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,4CAA4C,CAAC,CAAC,yBAAyB;CACtF,CAAC"}

package/dist/cjs/whitelists/evm/delegation-manager.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DELEGATION_MANAGER_CONTRACTS = void 0;
+const enums_1 = require("../../types/enums");
+// See: https://docs.metamask.io/smart-accounts-kit/changelog/0.13.0#delegation-framework
+exports.DELEGATION_MANAGER_CONTRACTS = {
+    [enums_1.ChainId.Wildcard]: ["0xdb9B1e94B5b69Df7e401DDbedE43491141047dB3"] // wildcard for any chain
+};
+//# sourceMappingURL=delegation-manager.js.map

package/dist/cjs/whitelists/evm/delegation-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-manager.js","sourceRoot":"","sources":["../../../../src/whitelists/evm/delegation-manager.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAG5C,yFAAyF;AAE5E,QAAA,4BAA4B,GAAoB;IACzD,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,4CAA4C,CAAC,CAAC,yBAAyB;CACtF,CAAC"}

package/dist/cjs/whitelists/evm/eip7702-delegation.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EIP7702_DELEGATION_CONTRACTS = void 0;
+const enums_1 = require("../../types/enums");
+exports.EIP7702_DELEGATION_CONTRACTS = {
+    [enums_1.ChainId.Wildcard]: ["0x63c0c19a282a1B52b07dD5a65b58948A07DAE32B"] // wildcard for any chain
+};
+//# sourceMappingURL=eip7702-delegation.js.map

package/dist/cjs/whitelists/evm/eip7702-delegation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eip7702-delegation.js","sourceRoot":"","sources":["../../../../src/whitelists/evm/eip7702-delegation.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAG/B,QAAA,4BAA4B,GAAoB;IACzD,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,4CAA4C,CAAC,CAAC,yBAAyB;CACtF,CAAC"}

package/dist/cjs/whitelists/evm/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WETH_CONTRACTS = exports.PERMIT2_CONTRACTS = exports.TIMESTAMP_ENFORCER_CONTRACTS = exports.ID_ENFORCER_CONTRACTS = exports.EXACT_EXECUTION_BATCH_ENFORCER_CONTRACTS = exports.EXACT_EXECUTION_ENFORCER_CONTRACTS = exports.DELEGATION_MANAGER_CONTRACTS = exports.EIP7702_DELEGATION_CONTRACTS = void 0;
+var eip7702_delegation_1 = require("./eip7702-delegation");
+Object.defineProperty(exports, "EIP7702_DELEGATION_CONTRACTS", { enumerable: true, get: function () { return eip7702_delegation_1.EIP7702_DELEGATION_CONTRACTS; } });
+var delegation_manager_1 = require("./delegation-manager");
+Object.defineProperty(exports, "DELEGATION_MANAGER_CONTRACTS", { enumerable: true, get: function () { return delegation_manager_1.DELEGATION_MANAGER_CONTRACTS; } });
+var caveat_enforcers_1 = require("./caveat-enforcers");
+Object.defineProperty(exports, "EXACT_EXECUTION_ENFORCER_CONTRACTS", { enumerable: true, get: function () { return caveat_enforcers_1.EXACT_EXECUTION_ENFORCER_CONTRACTS; } });
+Object.defineProperty(exports, "EXACT_EXECUTION_BATCH_ENFORCER_CONTRACTS", { enumerable: true, get: function () { return caveat_enforcers_1.EXACT_EXECUTION_BATCH_ENFORCER_CONTRACTS; } });
+Object.defineProperty(exports, "ID_ENFORCER_CONTRACTS", { enumerable: true, get: function () { return caveat_enforcers_1.ID_ENFORCER_CONTRACTS; } });
+Object.defineProperty(exports, "TIMESTAMP_ENFORCER_CONTRACTS", { enumerable: true, get: function () { return caveat_enforcers_1.TIMESTAMP_ENFORCER_CONTRACTS; } });
+var permit2_1 = require("./permit2");
+Object.defineProperty(exports, "PERMIT2_CONTRACTS", { enumerable: true, get: function () { return permit2_1.PERMIT2_CONTRACTS; } });
+var weth_1 = require("./weth");
+Object.defineProperty(exports, "WETH_CONTRACTS", { enumerable: true, get: function () { return weth_1.WETH_CONTRACTS; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/whitelists/evm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/whitelists/evm/index.ts"],"names":[],"mappings":";;;AAAA,2DAAoE;AAA3D,kIAAA,4BAA4B,OAAA;AACrC,2DAAoE;AAA3D,kIAAA,4BAA4B,OAAA;AACrC,uDAK4B;AAJxB,sIAAA,kCAAkC,OAAA;AAClC,4IAAA,wCAAwC,OAAA;AACxC,yHAAA,qBAAqB,OAAA;AACrB,gIAAA,4BAA4B,OAAA;AAEhC,qCAA8C;AAArC,4GAAA,iBAAiB,OAAA;AAC1B,+BAAwC;AAA/B,sGAAA,cAAc,OAAA"}

package/dist/cjs/whitelists/evm/permit2.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PERMIT2_CONTRACTS = void 0;
+const enums_1 = require("../../types/enums");
+const DEFAULT_PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+exports.PERMIT2_CONTRACTS = {
+    [enums_1.ChainId.Ethereum]: [DEFAULT_PERMIT2_ADDRESS],
+    [enums_1.ChainId.BNB]: [DEFAULT_PERMIT2_ADDRESS],
+    [enums_1.ChainId.Polygon]: [DEFAULT_PERMIT2_ADDRESS],
+    [enums_1.ChainId.Arbitrum]: [DEFAULT_PERMIT2_ADDRESS],
+    [enums_1.ChainId.Avalanche]: [DEFAULT_PERMIT2_ADDRESS],
+    [enums_1.ChainId.Linea]: [DEFAULT_PERMIT2_ADDRESS],
+    [enums_1.ChainId.Base]: [DEFAULT_PERMIT2_ADDRESS],
+    [enums_1.ChainId.Optimism]: [DEFAULT_PERMIT2_ADDRESS],
+    // Gnosis: no Permit2
+    // Sonic: no Permit2
+};
+//# sourceMappingURL=permit2.js.map

package/dist/cjs/whitelists/evm/permit2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permit2.js","sourceRoot":"","sources":["../../../../src/whitelists/evm/permit2.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAG5C,MAAM,uBAAuB,GAAG,4CAA4C,CAAC;AAEhE,QAAA,iBAAiB,GAAoB;IAC9C,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAG,CAAC,uBAAuB,CAAC;IAC9C,CAAC,eAAO,CAAC,GAAG,CAAC,EAAQ,CAAC,uBAAuB,CAAC;IAC9C,CAAC,eAAO,CAAC,OAAO,CAAC,EAAI,CAAC,uBAAuB,CAAC;IAC9C,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAG,CAAC,uBAAuB,CAAC;IAC9C,CAAC,eAAO,CAAC,SAAS,CAAC,EAAE,CAAC,uBAAuB,CAAC;IAC9C,CAAC,eAAO,CAAC,KAAK,CAAC,EAAM,CAAC,uBAAuB,CAAC;IAC9C,CAAC,eAAO,CAAC,IAAI,CAAC,EAAO,CAAC,uBAAuB,CAAC;IAC9C,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAG,CAAC,uBAAuB,CAAC;IAC9C,qBAAqB;IACrB,oBAAoB;CACd,CAAC"}

package/dist/cjs/whitelists/evm/weth.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WETH_CONTRACTS = void 0;
+const enums_1 = require("../../types/enums");
+exports.WETH_CONTRACTS = {
+    [enums_1.ChainId.Ethereum]: ["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"],
+    [enums_1.ChainId.BNB]: ["0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c"],
+    [enums_1.ChainId.Polygon]: ["0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270"],
+    [enums_1.ChainId.Arbitrum]: ["0x82aF49447D8a07e3bd95BD0d56f35241523fBab1"],
+    [enums_1.ChainId.Avalanche]: ["0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7"],
+    [enums_1.ChainId.Linea]: ["0xe5D7C2a44FfDDf6b295A15c148167daaAf5Cf34f"],
+    [enums_1.ChainId.Base]: ["0x4200000000000000000000000000000000000006"],
+    [enums_1.ChainId.Optimism]: ["0x4200000000000000000000000000000000000006"],
+    // Gnosis: no WETH
+    [enums_1.ChainId.Sonic]: ["0x039e2fB66102314Ce7b64Ce5Ce3E5183bc94aD38"],
+    // TODO: add other chains
+    [enums_1.ChainId.Tron]: ["0x891cdb91d149f23B1a45D9c5Ca78a88d0cB44C18"],
+};
+//# sourceMappingURL=weth.js.map

package/dist/cjs/whitelists/evm/weth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weth.js","sourceRoot":"","sources":["../../../../src/whitelists/evm/weth.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAG/B,QAAA,cAAc,GAAoB;IAC3C,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAG,CAAC,4CAA4C,CAAC;IACnE,CAAC,eAAO,CAAC,GAAG,CAAC,EAAQ,CAAC,4CAA4C,CAAC;IACnE,CAAC,eAAO,CAAC,OAAO,CAAC,EAAI,CAAC,4CAA4C,CAAC;IACnE,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAG,CAAC,4CAA4C,CAAC;IACnE,CAAC,eAAO,CAAC,SAAS,CAAC,EAAE,CAAC,4CAA4C,CAAC;IACnE,CAAC,eAAO,CAAC,KAAK,CAAC,EAAM,CAAC,4CAA4C,CAAC;IACnE,CAAC,eAAO,CAAC,IAAI,CAAC,EAAO,CAAC,4CAA4C,CAAC;IACnE,CAAC,eAAO,CAAC,QAAQ,CAAC,EAAG,CAAC,4CAA4C,CAAC;IACnE,kBAAkB;IAClB,CAAC,eAAO,CAAC,KAAK,CAAC,EAAM,CAAC,4CAA4C,CAAC;IACnE,yBAAyB;IACzB,CAAC,eAAO,CAAC,IAAI,CAAC,EAAO,CAAC,4CAA4C,CAAC;CAC7D,CAAC"}

package/dist/cjs/whitelists/solana/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./programs"), exports);
+__exportStar(require("./intent-signature"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/whitelists/solana/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/whitelists/solana/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,qDAAmC"}

package/dist/cjs/whitelists/solana/intent-signature.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIntentSignatureConfig = getIntentSignatureConfig;
+const validation_1 = require("../../types/validation");
+const enums_1 = require("../../types/enums");
+// Environment-specific prefix used in getBufferForIntentSignature().
+// Must match IntentProgramSigPrefix enum in @debridge-finance/intents-client.
+const SIG_PREFIX_BY_ENVIRONMENT = {
+    [validation_1.Environment.Prod]: "intents_program",
+    [validation_1.Environment.Dubai]: "intents_program_dubai",
+    [validation_1.Environment.Hanoi]: "intents_program_hanoi",
+    [validation_1.Environment.Madrid]: "intents_program_madrid", // TODO: placeholder — update when known
+};
+// "intents" label — constant across all environments
+const INTENTS_LABEL = new Uint8Array([105, 110, 116, 101, 110, 116, 115]);
+function getIntentSignatureConfig(environment) {
+    const prefixStr = SIG_PREFIX_BY_ENVIRONMENT[environment];
+    const prefix = new TextEncoder().encode(prefixStr);
+    const chainIdBytes = new Uint8Array(4);
+    new DataView(chainIdBytes.buffer).setUint32(0, enums_1.ChainId.Solana, true);
+    // prefix + chainId(4) + label(7) + intentId(32)
+    const expectedBufferLength = prefix.length + 4 + INTENTS_LABEL.length + 32;
+    return { prefix, chainIdBytes, label: INTENTS_LABEL, expectedBufferLength };
+}
+//# sourceMappingURL=intent-signature.js.map

package/dist/cjs/whitelists/solana/intent-signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-signature.js","sourceRoot":"","sources":["../../../../src/whitelists/solana/intent-signature.ts"],"names":[],"mappings":";;AAsBA,4DAWC;AAjCD,uDAAqD;AACrD,6CAA4C;AAE5C,qEAAqE;AACrE,8EAA8E;AAC9E,MAAM,yBAAyB,GAAgC;IAC3D,CAAC,wBAAW,CAAC,IAAI,CAAC,EAAE,iBAAiB;IACrC,CAAC,wBAAW,CAAC,KAAK,CAAC,EAAE,uBAAuB;IAC5C,CAAC,wBAAW,CAAC,KAAK,CAAC,EAAE,uBAAuB;IAC5C,CAAC,wBAAW,CAAC,MAAM,CAAC,EAAE,wBAAwB,EAAE,wCAAwC;CAC3F,CAAC;AAEF,qDAAqD;AACrD,MAAM,aAAa,GAAG,IAAI,UAAU,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAS1E,SAAgB,wBAAwB,CAAC,WAAwB;IAC7D,MAAM,SAAS,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEnD,MAAM,YAAY,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,eAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAErE,gDAAgD;IAChD,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,aAAa,CAAC,MAAM,GAAG,EAAE,CAAC;IAE3E,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,CAAC;AAChF,CAAC"}

package/dist/cjs/whitelists/solana/programs.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GAS_COMPENSATION_ALLOWED_PROGRAMS = exports.SPL_NATIVE_MINT = exports.ASSOCIATED_TOKEN_PROGRAM = exports.SYSTEM_PROGRAM = exports.SPL_TOKEN_2022_PROGRAM = exports.SPL_TOKEN_PROGRAM = exports.MEMO_PROGRAM = exports.COMPUTE_BUDGET_PROGRAM = void 0;
+// Well-known Solana program IDs used for instruction classification
+exports.COMPUTE_BUDGET_PROGRAM = "ComputeBudget111111111111111111111111111111";
+exports.MEMO_PROGRAM = "MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr";
+exports.SPL_TOKEN_PROGRAM = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+exports.SPL_TOKEN_2022_PROGRAM = "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb";
+exports.SYSTEM_PROGRAM = "11111111111111111111111111111111";
+exports.ASSOCIATED_TOKEN_PROGRAM = "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
+exports.SPL_NATIVE_MINT = "So11111111111111111111111111111111111111112";
+// GasCompensation hooks: only memo + transfer programs (no ATA, Intent, ComputeBudget)
+exports.GAS_COMPENSATION_ALLOWED_PROGRAMS = new Set([
+    exports.MEMO_PROGRAM,
+    exports.SYSTEM_PROGRAM,
+    exports.SPL_TOKEN_PROGRAM,
+    exports.SPL_TOKEN_2022_PROGRAM,
+]);
+//# sourceMappingURL=programs.js.map

package/dist/cjs/whitelists/solana/programs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.js","sourceRoot":"","sources":["../../../../src/whitelists/solana/programs.ts"],"names":[],"mappings":";;;AAAA,oEAAoE;AACvD,QAAA,sBAAsB,GAAG,6CAA6C,CAAC;AACvE,QAAA,YAAY,GAAG,6CAA6C,CAAC;AAC7D,QAAA,iBAAiB,GAAG,6CAA6C,CAAC;AAClE,QAAA,sBAAsB,GAAG,6CAA6C,CAAC;AACvE,QAAA,cAAc,GAAG,kCAAkC,CAAC;AACpD,QAAA,wBAAwB,GAAG,8CAA8C,CAAC;AAC1E,QAAA,eAAe,GAAG,6CAA6C,CAAC;AAE7E,uFAAuF;AAC1E,QAAA,iCAAiC,GAAG,IAAI,GAAG,CAAC;IACrD,oBAAY;IACZ,sBAAc;IACd,yBAAiB;IACjB,8BAAsB;CACzB,CAAC,CAAC"}

package/dist/cjs/whitelists/subscription-to-chain-id.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUBSCRIPTION_TO_CHAIN_ID = void 0;
+exports.resolveChainId = resolveChainId;
+const enums_1 = require("../types/enums");
+exports.SUBSCRIPTION_TO_CHAIN_ID = {
+    [enums_1.SubscriptionId.Ethereum]: enums_1.ChainId.Ethereum,
+    [enums_1.SubscriptionId.Optimism]: enums_1.ChainId.Optimism,
+    [enums_1.SubscriptionId.BNB]: enums_1.ChainId.BNB,
+    [enums_1.SubscriptionId.Polygon]: enums_1.ChainId.Polygon,
+    [enums_1.SubscriptionId.Arbitrum]: enums_1.ChainId.Arbitrum,
+    [enums_1.SubscriptionId.Avalanche]: enums_1.ChainId.Avalanche,
+    [enums_1.SubscriptionId.Linea]: enums_1.ChainId.Linea,
+    [enums_1.SubscriptionId.Base]: enums_1.ChainId.Base,
+    [enums_1.SubscriptionId.Solana]: enums_1.ChainId.Solana,
+    [enums_1.SubscriptionId.Neon]: enums_1.ChainId.Neon,
+    [enums_1.SubscriptionId.Gnosis]: enums_1.ChainId.Gnosis,
+    [enums_1.SubscriptionId.Metis]: enums_1.ChainId.Metis,
+    [enums_1.SubscriptionId.Sonic]: enums_1.ChainId.Sonic,
+    [enums_1.SubscriptionId.Story]: enums_1.ChainId.Story,
+    [enums_1.SubscriptionId.HyperEVM]: enums_1.ChainId.HyperEVM,
+    [enums_1.SubscriptionId.Flow]: enums_1.ChainId.Flow,
+    [enums_1.SubscriptionId.Bob]: enums_1.ChainId.Bob,
+    [enums_1.SubscriptionId.Sei]: enums_1.ChainId.Sei,
+    [enums_1.SubscriptionId.Mantle]: enums_1.ChainId.Mantle,
+    [enums_1.SubscriptionId.Monad]: enums_1.ChainId.Monad,
+    [enums_1.SubscriptionId.Injective]: enums_1.ChainId.Injective,
+    [enums_1.SubscriptionId.MegaETH]: enums_1.ChainId.MegaETH,
+    [enums_1.SubscriptionId.Cronos]: enums_1.ChainId.Cronos,
+    [enums_1.SubscriptionId.Tron]: enums_1.ChainId.Tron,
+};
+function resolveChainId(subscriptionId) {
+    // Cast is safe: unknown subscriptionIds simply return undefined
+    return exports.SUBSCRIPTION_TO_CHAIN_ID[subscriptionId];
+}
+//# sourceMappingURL=subscription-to-chain-id.js.map

package/dist/cjs/whitelists/subscription-to-chain-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-to-chain-id.js","sourceRoot":"","sources":["../../../src/whitelists/subscription-to-chain-id.ts"],"names":[],"mappings":";;;AA6BA,wCAGC;AAhCD,0CAAyD;AAE5C,QAAA,wBAAwB,GAAoC;IACrE,CAAC,sBAAc,CAAC,QAAQ,CAAC,EAAE,eAAO,CAAC,QAAQ;IAC3C,CAAC,sBAAc,CAAC,QAAQ,CAAC,EAAE,eAAO,CAAC,QAAQ;IAC3C,CAAC,sBAAc,CAAC,GAAG,CAAC,EAAE,eAAO,CAAC,GAAG;IACjC,CAAC,sBAAc,CAAC,OAAO,CAAC,EAAE,eAAO,CAAC,OAAO;IACzC,CAAC,sBAAc,CAAC,QAAQ,CAAC,EAAE,eAAO,CAAC,QAAQ;IAC3C,CAAC,sBAAc,CAAC,SAAS,CAAC,EAAE,eAAO,CAAC,SAAS;IAC7C,CAAC,sBAAc,CAAC,KAAK,CAAC,EAAE,eAAO,CAAC,KAAK;IACrC,CAAC,sBAAc,CAAC,IAAI,CAAC,EAAE,eAAO,CAAC,IAAI;IACnC,CAAC,sBAAc,CAAC,MAAM,CAAC,EAAE,eAAO,CAAC,MAAM;IACvC,CAAC,sBAAc,CAAC,IAAI,CAAC,EAAE,eAAO,CAAC,IAAI;IACnC,CAAC,sBAAc,CAAC,MAAM,CAAC,EAAE,eAAO,CAAC,MAAM;IACvC,CAAC,sBAAc,CAAC,KAAK,CAAC,EAAE,eAAO,CAAC,KAAK;IACrC,CAAC,sBAAc,CAAC,KAAK,CAAC,EAAE,eAAO,CAAC,KAAK;IACrC,CAAC,sBAAc,CAAC,KAAK,CAAC,EAAE,eAAO,CAAC,KAAK;IACrC,CAAC,sBAAc,CAAC,QAAQ,CAAC,EAAE,eAAO,CAAC,QAAQ;IAC3C,CAAC,sBAAc,CAAC,IAAI,CAAC,EAAE,eAAO,CAAC,IAAI;IACnC,CAAC,sBAAc,CAAC,GAAG,CAAC,EAAE,eAAO,CAAC,GAAG;IACjC,CAAC,sBAAc,CAAC,GAAG,CAAC,EAAE,eAAO,CAAC,GAAG;IACjC,CAAC,sBAAc,CAAC,MAAM,CAAC,EAAE,eAAO,CAAC,MAAM;IACvC,CAAC,sBAAc,CAAC,KAAK,CAAC,EAAE,eAAO,CAAC,KAAK;IACrC,CAAC,sBAAc,CAAC,SAAS,CAAC,EAAE,eAAO,CAAC,SAAS;IAC7C,CAAC,sBAAc,CAAC,OAAO,CAAC,EAAE,eAAO,CAAC,OAAO;IACzC,CAAC,sBAAc,CAAC,MAAM,CAAC,EAAE,eAAO,CAAC,MAAM;IACvC,CAAC,sBAAc,CAAC,IAAI,CAAC,EAAE,eAAO,CAAC,IAAI;CAC7B,CAAC;AAEX,SAAgB,cAAc,CAAC,cAAsB;IACjD,gEAAgE;IAChE,OAAO,gCAAwB,CAAC,cAAgC,CAAC,CAAC;AACtE,CAAC"}

package/dist/cjs/whitelists/types.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWhitelisted = isWhitelisted;
+const address_1 = require("../helpers/address");
+const enums_1 = require("../types/enums");
+function isWhitelisted(map, chainId, address) {
+    const addressFormat = (0, address_1.getAddressFormat)(chainId);
+    if (addressFormat === address_1.AddressFormat.Solana) {
+        // This function is not supposed to be used for Solana addresses.
+        // If it was called with a Solana address, it's likely a bug in the caller's code.
+        throw new Error("isWhitelisted() does not support Solana addresses — compare directly");
+    }
+    // Try chain-specific whitelist first.
+    // Different chains have different address formats, so we must check chain-specific list before wildcard.
+    const chainSpecific = map[chainId];
+    if (chainSpecific) {
+        const normalized = (0, address_1.normalizeAddress)(chainId, address);
+        return chainSpecific.some(a => (0, address_1.normalizeAddress)(chainId, a) === normalized);
+    }
+    // Fallback to wildcard (chainId 0).
+    // Wildcard always uses EVM hex format — convert non-EVM addresses.
+    const wildcard = map[enums_1.ChainId.Wildcard];
+    if (!wildcard)
+        return false;
+    const evmAddress = addressFormat === address_1.AddressFormat.Tron ? (0, address_1.tronAddressToEvmHex)(address) : address;
+    const normalized = evmAddress.toLowerCase();
+    return wildcard.some(a => a.toLowerCase() === normalized);
+}
+//# sourceMappingURL=types.js.map

package/dist/cjs/whitelists/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/whitelists/types.ts"],"names":[],"mappings":";;AAoCA,sCA6BC;AAjED,gDAK4B;AAC5B,0CAAyC;AA8BzC,SAAgB,aAAa,CACzB,GAAoB,EACpB,OAAgB,EAChB,OAAe;IAEf,MAAM,aAAa,GAAG,IAAA,0BAAgB,EAAC,OAAO,CAAC,CAAC;IAEhD,IAAI,aAAa,KAAK,uBAAa,CAAC,MAAM,EAAE,CAAC;QACzC,iEAAiE;QACjE,kFAAkF;QAClF,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC5F,CAAC;IAED,sCAAsC;IACtC,yGAAyG;IACzG,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,aAAa,EAAE,CAAC;QAChB,MAAM,UAAU,GAAG,IAAA,0BAAgB,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtD,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAA,0BAAgB,EAAC,OAAO,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC;IAChF,CAAC;IAED,oCAAoC;IACpC,mEAAmE;IACnE,MAAM,QAAQ,GAAG,GAAG,CAAC,eAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,MAAM,UAAU,GAAG,aAAa,KAAK,uBAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,6BAAmB,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACjG,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;AAC9D,CAAC"}

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

@@ -0,0 +1,24 @@
+// "Graylists" are hardcoded lookup tables for known values that are NOT
+// security-critical whitelists. They are used for informational or
+// best-effort validation. If a value is absent from a graylist, the
+// corresponding check is skipped rather than producing a violation.
+// Note: addresses in this map MUST be lowercased.
+import { ChainId } from "../../types/enums.js";
+export const TOKEN_PERMIT_METADATA = {
+    // TODO: verify this list. At the moment it contains TEST values.
+    [ChainId.Ethereum]: {
+        "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": { name: "USD Coin", version: "2" }, // USDC
+        "0x6b175474e89094c44da98b954eedeac495271d0f": { name: "Dai Stablecoin", version: "1" }, // DAI
+        "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9": { name: "Aave Token", version: "1" }, // AAVE
+    },
+    [ChainId.Arbitrum]: {
+        "0xaf88d065e77c8cc2239327c5edb3a432268e5831": { name: "USD Coin", version: "2" }, // USDC
+    },
+};
+export function getTokenPermitMetadata(realChainId, tokenAddress) {
+    const chain = TOKEN_PERMIT_METADATA[realChainId];
+    if (!chain)
+        return undefined;
+    return chain[tokenAddress.toLowerCase()];
+}
+//# sourceMappingURL=token-permit-metadata.js.map

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

@@ -0,0 +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;AAgBpE,kDAAkD;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IACzD,iEAAiE;IACjE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAChB,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,OAAO;QACzF,4CAA4C,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,MAAM;QAC9F,4CAA4C,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,OAAO;KAC9F;IACD,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAChB,4CAA4C,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,OAAO;KAC5F;CACJ,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAClC,WAAoB,EACpB,YAAoB;IAEpB,MAAM,KAAK,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;AAC7C,CAAC"}

package/dist/esm/helpers/address.js

@@ -0,0 +1,63 @@
+import { bytesToHex, zeroAddress } from "viem";
+import bs58 from "bs58";
+import { ChainId } from "../types/enums.js";
+import { SYSTEM_PROGRAM } from "../whitelists/solana/index.js";
+// Tron-specific addresses (Base58Check format)
+export const TRON_NATIVE_ADDRESS = "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb";
+export var AddressFormat;
+(function (AddressFormat) {
+    AddressFormat[AddressFormat["EVM"] = 0] = "EVM";
+    AddressFormat[AddressFormat["Tron"] = 1] = "Tron";
+    AddressFormat[AddressFormat["Solana"] = 2] = "Solana";
+})(AddressFormat || (AddressFormat = {}));
+export function getAddressFormat(chainId) {
+    if (chainId === ChainId.Tron)
+        return AddressFormat.Tron;
+    if (chainId === ChainId.Solana)
+        return AddressFormat.Solana;
+    return AddressFormat.EVM;
+}
+export 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;
+}
+// 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
+export function tronAddressToEvmHex(tronAddress) {
+    const decoded = bs58.decode(tronAddress);
+    // Skip first byte (0x41 prefix) and last 4 bytes (checksum)
+    const addressBytes = decoded.slice(1, 21);
+    return bytesToHex(addressBytes);
+}
+// Normalizes address for comparison based on chain format
+export function normalizeAddress(chainId, address) {
+    const format = getAddressFormat(chainId);
+    if (format === AddressFormat.Tron || format === AddressFormat.Solana) {
+        return address; // case-sensitive
+    }
+    return address.toLowerCase(); // EVM: case-insensitive
+}
+// Compares two addresses with chain-aware normalization
+export function addressEquals(chainId, a, b) {
+    return normalizeAddress(chainId, a) === normalizeAddress(chainId, b);
+}
+// Checks if address is native token for the given chain
+export function isNativeToken(address, chainId) {
+    if (chainId === ChainId.Tron) {
+        return address === TRON_NATIVE_ADDRESS;
+    }
+    if (chainId === ChainId.Solana) {
+        return address === SYSTEM_PROGRAM;
+    }
+    return address.toLowerCase() === zeroAddress;
+}
+//# sourceMappingURL=address.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../src/helpers/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,oCAAoC,CAAC;AAExE,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACrB,+CAAG,CAAA;IACH,iDAAI,CAAA;IACJ,qDAAM,CAAA;AACV,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC5C,IAAI,OAAO,KAAK,OAAO,CAAC,IAAI;QAAE,OAAO,aAAa,CAAC,IAAI,CAAC;IACxD,IAAI,OAAO,KAAK,OAAO,CAAC,MAAM;QAAE,OAAO,aAAa,CAAC,MAAM,CAAC;IAC5D,OAAO,aAAa,CAAC,GAAG,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe;IACzC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACxC,4DAA4D;IAC5D,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,8DAA8D;AAC9D,4EAA4E;AAC5E,oEAAoE;AACpE,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACzC,4DAA4D;IAC5D,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,UAAU,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAAe;IAC7D,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,aAAa,CAAC,IAAI,IAAI,MAAM,KAAK,aAAa,CAAC,MAAM,EAAE,CAAC;QACnE,OAAO,OAAO,CAAC,CAAC,iBAAiB;IACrC,CAAC;IACD,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,wBAAwB;AAC1D,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,CAAS,EAAE,CAAS;IAC/D,OAAO,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,OAAgB;IAC3D,IAAI,OAAO,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;QAC3B,OAAO,OAAO,KAAK,mBAAmB,CAAC;IAC3C,CAAC;IACD,IAAI,OAAO,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;QAC7B,OAAO,OAAO,KAAK,cAAc,CAAC;IACtC,CAAC;IACD,OAAO,OAAO,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC;AACjD,CAAC"}