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

package/dist/esm/validations/evm-transaction.js

@@ -0,0 +1,35 @@
+import { ViolationCode, EvmActionKind, EvmActionOperation, } from "../types/index.js";
+// =============================================
+// Transaction constraints
+// =============================================
+const TRANSACTION_ALLOWED_ACTIONS = [
+    EvmActionOperation.Budget,
+    EvmActionOperation.Wrap,
+];
+export function validateTransactionActions(actions, basePath) {
+    const violations = [];
+    for (let i = 0; i < actions.length; i++) {
+        const action = actions[i];
+        if (action.type !== EvmActionKind.Transaction)
+            continue;
+        const actionPath = `${basePath}.requiredActions[${i}]`;
+        // MEDIUM: actions[] must contain exactly one allowed element
+        violations.push(...validateTransactionActionsList(action, actionPath));
+    }
+    return violations;
+}
+// MEDIUM: actions[] must contain exactly one element: Budget or Wrap
+function validateTransactionActionsList(action, actionPath) {
+    if (action.actions.length !== 1 ||
+        !TRANSACTION_ALLOWED_ACTIONS.includes(action.actions[0])) {
+        return [{
+                code: ViolationCode.TransactionActionsInvalid,
+                message: `Transaction actions must contain exactly one of ['Budget', 'Wrap']`,
+                path: `${actionPath}.actions`,
+                expected: TRANSACTION_ALLOWED_ACTIONS,
+                actual: action.actions,
+            }];
+    }
+    return [];
+}
+//# sourceMappingURL=evm-transaction.js.map

package/dist/esm/validations/evm-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm-transaction.js","sourceRoot":"","sources":["../../../src/validations/evm-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,aAAa,EAEb,aAAa,EACb,kBAAkB,GACrB,MAAM,UAAU,CAAC;AAElB,gDAAgD;AAChD,0BAA0B;AAC1B,gDAAgD;AAEhD,MAAM,2BAA2B,GAAkC;IAC/D,kBAAkB,CAAC,MAAM;IACzB,kBAAkB,CAAC,IAAI;CAC1B,CAAC;AAEF,MAAM,UAAU,0BAA0B,CACtC,OAA4B,EAC5B,QAAgB;IAEhB,MAAM,UAAU,GAAgB,EAAE,CAAC;IAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,CAAC,WAAW;YAAE,SAAS;QAExD,MAAM,UAAU,GAAG,GAAG,QAAQ,oBAAoB,CAAC,GAAG,CAAC;QAEvD,6DAA6D;QAC7D,UAAU,CAAC,IAAI,CACX,GAAG,8BAA8B,CAAC,MAAM,EAAE,UAAU,CAAC,CACxD,CAAC;IACN,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,qEAAqE;AACrE,SAAS,8BAA8B,CACnC,MAAyB,EACzB,UAAkB;IAElB,IACI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAC3B,CAAC,2BAA2B,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAC1D,CAAC;QACC,OAAO,CAAC;gBACJ,IAAI,EAAE,aAAa,CAAC,yBAAyB;gBAC7C,OAAO,EAAE,oEAAoE;gBAC7E,IAAI,EAAE,GAAG,UAAU,UAAU;gBAC7B,QAAQ,EAAE,2BAA2B;gBACrC,MAAM,EAAE,MAAM,CAAC,OAAO;aACzB,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,CAAC;AACd,CAAC"}

package/dist/esm/validations/hooks-common.js

@@ -0,0 +1,204 @@
+import { ViolationCode, } from "../types/index.js";
+import { ChainId } from "../types/enums.js";
+import { validateSolanaHookActions } from "./solana-hook.js";
+// Both EVM and Solana use identical string values for hook operations
+const HOOK_OPERATIONS = ["Hook", "GasCompensation"];
+const HOOK_OPERATIONS_SET = new Set(HOOK_OPERATIONS);
+export function validateHooks(request, response, quoteMode) {
+    return [
+        ...validateHookAAConstraint(request, response),
+        ...validateHookCounts(request, response),
+        ...validatePreHooks(request, response, quoteMode),
+        ...validatePostHooks(request, response, quoteMode),
+    ];
+}
+// HIGH: hooks must be empty when AA=false
+function validateHookAAConstraint(request, response) {
+    if (request.enableAccountAbstraction)
+        return [];
+    const violations = [];
+    if (response.preHooks.length > 0) {
+        violations.push({
+            code: ViolationCode.NonEmptyHooksWithoutAA,
+            message: "preHooks must be empty when enableAccountAbstraction=false",
+            path: "response.preHooks",
+            expected: 0,
+            actual: response.preHooks.length,
+        });
+    }
+    if (response.postHooks.length > 0) {
+        violations.push({
+            code: ViolationCode.NonEmptyHooksWithoutAA,
+            message: "postHooks must be empty when enableAccountAbstraction=false",
+            path: "response.postHooks",
+            expected: 0,
+            actual: response.postHooks.length,
+        });
+    }
+    return violations;
+}
+// HIGH: preHooks may contain additional compensation hooks appended by the API,
+// so response count must be >= request count.
+// postHooks must match exactly — the API never adds extras to postHooks.
+function validateHookCounts(request, response) {
+    const violations = [];
+    const requestPreCount = request.preHooks?.length ?? 0;
+    const requestPostCount = request.postHooks?.length ?? 0;
+    // preHooks: API appends compensation hooks when gasCompensationInfo is present
+    if (response.preHooks.length < requestPreCount) {
+        violations.push({
+            code: ViolationCode.HookCountMismatch,
+            message: "response.preHooks count is less than request.preHooks count",
+            path: "response.preHooks",
+            expected: requestPreCount,
+            actual: response.preHooks.length,
+        });
+    }
+    // postHooks: strict 1:1 match, no extras allowed
+    if (response.postHooks.length !== requestPostCount) {
+        violations.push({
+            code: ViolationCode.HookCountMismatch,
+            message: "response.postHooks count does not match"
+                + " request.postHooks count",
+            path: "response.postHooks",
+            expected: requestPostCount,
+            actual: response.postHooks.length,
+        });
+    }
+    return violations;
+}
+function validatePreHooks(request, response, quoteMode) {
+    const violations = [];
+    const requestHooks = request.preHooks ?? [];
+    for (let i = 0; i < response.preHooks.length; i++) {
+        const basePath = `response.preHooks[${i}]`;
+        const hookPayload = response.preHooks[i];
+        const requestHook = requestHooks[i];
+        violations.push(...validateSingleHookPayload(hookPayload, requestHook, basePath, request, quoteMode));
+    }
+    return violations;
+}
+function validatePostHooks(request, response, quoteMode) {
+    const violations = [];
+    const requestHooks = request.postHooks ?? [];
+    for (let i = 0; i < response.postHooks.length; i++) {
+        const basePath = `response.postHooks[${i}]`;
+        const hookPayload = response.postHooks[i];
+        // User postHooks are matched by index; extra entries are compensation hooks
+        const requestHook = i < requestHooks.length ? requestHooks[i] : undefined;
+        violations.push(...validateSingleHookPayload(hookPayload, requestHook, basePath, request, quoteMode));
+    }
+    return violations;
+}
+function validateSingleHookPayload(hookPayload, requestHook, basePath, request, quoteMode) {
+    return [
+        ...validateHookEcho(hookPayload, requestHook, basePath),
+        ...validateHookUniqueActionIds(hookPayload, basePath),
+        ...validateHookActionsList(hookPayload, basePath),
+        ...validateGasCompensationRequiresInfo(hookPayload, basePath, request),
+        ...dispatchChainSpecificValidation(hookPayload, requestHook, basePath, quoteMode, request),
+    ];
+}
+// CRITICAL: response hook must echo back the request hook exactly
+function validateHookEcho(hookPayload, requestHook, basePath) {
+    if (!requestHook)
+        return [];
+    if (JSON.stringify(hookPayload.hook) !== JSON.stringify(requestHook)) {
+        return [{
+                code: ViolationCode.HookEchoMismatch,
+                message: "response hook does not match request hook",
+                path: `${basePath}.hook`,
+                expected: requestHook,
+                actual: hookPayload.hook,
+            }];
+    }
+    return [];
+}
+// HIGH: unique actionIds within hook requiredActions
+function validateHookUniqueActionIds(hookPayload, basePath) {
+    const seen = new Map();
+    const violations = [];
+    for (let i = 0; i < hookPayload.requiredActions.length; i++) {
+        const actionId = hookPayload.requiredActions[i].actionId;
+        const firstIndex = seen.get(actionId);
+        if (firstIndex !== undefined) {
+            violations.push({
+                code: ViolationCode.HookDuplicateActionId,
+                message: `duplicate actionId "${actionId}" at indices`
+                    + ` ${firstIndex} and ${i}`,
+                path: `${basePath}.requiredActions[${i}].actionId`,
+                actual: actionId,
+            });
+        }
+        else {
+            seen.set(actionId, i);
+        }
+    }
+    return violations;
+}
+// HIGH: each hook required action must have exactly one operation: [Hook] or [GasCompensation]
+function validateHookActionsList(hookPayload, basePath) {
+    const violations = [];
+    for (let i = 0; i < hookPayload.requiredActions.length; i++) {
+        const action = hookPayload.requiredActions[i];
+        const actionPath = `${basePath}.requiredActions[${i}]`;
+        if (action.actions.length !== 1) {
+            violations.push({
+                code: ViolationCode.HookActionsInvalid,
+                message: "hook required action must have exactly one operation",
+                path: `${actionPath}.actions`,
+                expected: 1,
+                actual: action.actions.length,
+            });
+            continue;
+        }
+        if (!HOOK_OPERATIONS_SET.has(action.actions[0])) {
+            violations.push({
+                code: ViolationCode.HookActionsInvalid,
+                message: "hook required action operation must be Hook"
+                    + " or GasCompensation",
+                path: `${actionPath}.actions`,
+                expected: HOOK_OPERATIONS,
+                actual: action.actions,
+            });
+        }
+    }
+    return violations;
+}
+// CRITICAL: GasCompensation must only appear when gasCompensationInfo exists
+function validateGasCompensationRequiresInfo(hookPayload, basePath, request) {
+    const hasGasCompensationInfo = (request.preHooks ?? []).some(h => h.gasCompensationInfo !== undefined);
+    const violations = [];
+    for (let i = 0; i < hookPayload.requiredActions.length; i++) {
+        const action = hookPayload.requiredActions[i];
+        const hasGasCompensation = action.actions.includes("GasCompensation");
+        if (hasGasCompensation && !hasGasCompensationInfo) {
+            violations.push({
+                code: ViolationCode.HookGasCompensationWithoutInfo,
+                message: "GasCompensation action present but no preHook has"
+                    + " gasCompensationInfo",
+                path: `${basePath}.requiredActions[${i}].actions`,
+                actual: action.actions,
+            });
+        }
+    }
+    return violations;
+}
+function dispatchChainSpecificValidation(hookPayload, requestHook, basePath, quoteMode, request) {
+    const chainId = hookPayload.hook.chainId;
+    if (chainId === ChainId.Solana) {
+        const srcChainAuthorityAddress = findSolanaSrcChainAuthority(request);
+        return validateSolanaHookActions(hookPayload, requestHook, basePath, quoteMode, srcChainAuthorityAddress, request);
+    }
+    // AI: EVM hook validation dispatch will go here when implemented
+    return [];
+}
+function findSolanaSrcChainAuthority(request) {
+    for (const trade of request.trades) {
+        if (trade.srcChainId === ChainId.Solana) {
+            return trade.srcChainAuthorityAddress;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=hooks-common.js.map

package/dist/esm/validations/hooks-common.js.map

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

package/dist/esm/validations/required-actions.js

@@ -0,0 +1,66 @@
+import { ViolationCode, EvmActionKind, EvmActionOperation, SolanaActionKind, SolanaActionOperation, ChainId, } from "../types/index.js";
+import { validateEvmRequiredActions } from "./evm-required-actions.js";
+import { validateSolanaRequiredActions } from "./solana-required-actions.js";
+import { groupTrades, matchIntentsToGroups } from "./trade-grouping.js";
+export function validateRequiredActions(request, response, quoteMode, envConfig) {
+    const { groups, violations: groupViolations } = groupTrades(request.trades, quoteMode);
+    const { contexts, violations } = matchIntentsToGroups(response.intents, groups, quoteMode);
+    violations.push(...groupViolations);
+    for (const ctx of contexts) {
+        const basePath = `response.intents[${ctx.intentIndex}]`;
+        const { realChainId } = ctx.tradeGroup;
+        const allActions = ctx.intentPayload.requiredActions;
+        violations.push(...validateActionKindConsistency(allActions, basePath, realChainId));
+        // Dispatch to chain-specific validator based on realChainId.
+        // "Transaction" exists in both EvmActionKind and SolanaActionKind,
+        // so we must use chain context to disambiguate.
+        if (realChainId === ChainId.Solana) {
+            const solanaActions = filterSolanaActions(allActions);
+            violations.push(...validateSolanaRequiredActions(request, solanaActions, basePath, realChainId, quoteMode, ctx.tradeGroup.trades, ctx.tradeGroup.srcChainAuthorityAddress, ctx.intentPayload.intent, envConfig));
+        }
+        else {
+            const evmActions = filterEvmActions(allActions);
+            violations.push(...validateEvmRequiredActions(request, response, evmActions, basePath, realChainId, quoteMode, ctx.intentPayload.intent, ctx.tradeGroup.trades, ctx.tradeGroup.srcChainAuthorityAddress, envConfig));
+        }
+    }
+    return violations;
+}
+function isEvmAction(action) {
+    return Object.values(EvmActionKind).includes(action.type);
+}
+function filterEvmActions(actions) {
+    return actions.filter(isEvmAction);
+}
+function isSolanaAction(action) {
+    return Object.values(SolanaActionKind).includes(action.type);
+}
+function filterSolanaActions(actions) {
+    return actions.filter(isSolanaAction);
+}
+const EVM_ACTION_OPERATIONS = new Set(Object.values(EvmActionOperation));
+const SOLANA_ACTION_OPERATIONS = new Set(Object.values(SolanaActionOperation));
+// CRITICAL: Each requiredAction must have consistent kind across all fields.
+// Uses realChainId to determine expected kind (avoids ambiguity from overlapping type strings).
+function validateActionKindConsistency(actions, basePath, realChainId) {
+    const isSolanaChain = realChainId === ChainId.Solana;
+    const expectedOps = isSolanaChain ? SOLANA_ACTION_OPERATIONS : EVM_ACTION_OPERATIONS;
+    const chainLabel = isSolanaChain ? "Solana" : "EVM";
+    const violations = [];
+    for (let i = 0; i < actions.length; i++) {
+        const action = actions[i];
+        const actionPath = `${basePath}.requiredActions[${i}]`;
+        const invalidOps = action.actions.filter(op => !expectedOps.has(op));
+        if (invalidOps.length > 0) {
+            violations.push({
+                code: ViolationCode.RequiredActionKindInconsistent,
+                message: `${chainLabel} action type "${action.type}" has non-${chainLabel}`
+                    + ` operations: ${invalidOps.join(", ")}`,
+                path: `${actionPath}.actions`,
+                expected: [...expectedOps],
+                actual: action.actions,
+            });
+        }
+    }
+    return violations;
+}
+//# sourceMappingURL=required-actions.js.map

package/dist/esm/validations/required-actions.js.map

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

package/dist/esm/validations/solana-hook.js

@@ -0,0 +1,222 @@
+import { ViolationCode, SolanaActionOperation, } from "../types/index.js";
+import { resolveInstructions, isSystemTransfer, isMemo, } from "../helpers/solana-instruction.js";
+import { GAS_COMPENSATION_ALLOWED_PROGRAMS, SPL_TOKEN_PROGRAM, SPL_TOKEN_2022_PROGRAM, } from "../whitelists/solana/programs.js";
+import { addressEquals } from "../helpers/address.js";
+import { ChainId } from "../types/enums.js";
+import { decodeSolanaVersionedTransaction } from "../helpers/solana-transaction-decode.js";
+export function validateSolanaHookActions(hookPayload, requestHook, basePath, quoteMode, srcChainAuthorityAddress, request) {
+    const violations = [];
+    const gasCompensationTokenAddresses = (request.preHooks ?? [])
+        .filter(h => h.gasCompensationInfo?.chainId === ChainId.Solana)
+        .map(h => h.gasCompensationInfo.tokenAddress);
+    for (let i = 0; i < hookPayload.requiredActions.length; i++) {
+        const action = hookPayload.requiredActions[i];
+        const actionPath = `${basePath}.requiredActions[${i}]`;
+        const ops = action.actions;
+        // Only single "Hook" or "GasCompensation" is allowed - validated earlier.
+        if (ops.includes(SolanaActionOperation.Hook)) {
+            violations.push(...validateSolanaHookAction(action, requestHook, actionPath));
+        }
+        if (ops.includes(SolanaActionOperation.GasCompensation)) {
+            violations.push(...validateSolanaGasCompensationAction(action, actionPath, quoteMode, srcChainAuthorityAddress, gasCompensationTokenAddresses));
+        }
+    }
+    return violations;
+}
+// =============================================
+// Hook action: user's transaction passed through as-is
+// =============================================
+function validateSolanaHookAction(action, requestHook, actionPath) {
+    const violations = [];
+    // CRITICAL: Hook action must have a corresponding request hook.
+    // If missing, the API is asking the user to sign a transaction they never sent.
+    if (!requestHook) {
+        return [{
+                code: ViolationCode.SolanaHookDataMismatch,
+                message: "Hook action in response has no corresponding request hook",
+                path: `${actionPath}.data.data`,
+            }];
+    }
+    // CRITICAL: decode as VersionedTransaction(MessageV0)
+    const decodeResult = decodeSolanaTransaction(action, actionPath, ViolationCode.SolanaHookDecodeError);
+    if (!decodeResult.ok)
+        return decodeResult.violations;
+    // CRITICAL: transaction data must match request hook data
+    const responseData = action.data.data;
+    const requestData = requestHook.data;
+    if (!hexEquals(responseData, requestData)) {
+        violations.push({
+            code: ViolationCode.SolanaHookDataMismatch,
+            message: "Hook transaction data does not match request hook data",
+            path: `${actionPath}.data.data`,
+            expected: truncateHex(requestData),
+            actual: truncateHex(responseData),
+        });
+    }
+    return violations;
+}
+// =============================================
+// GasCompensation action: API-built compensation transaction
+// =============================================
+function validateSolanaGasCompensationAction(action, actionPath, quoteMode, srcChainAuthorityAddress, gasCompensationTokenAddresses) {
+    // CRITICAL: decode as VersionedTransaction(MessageV0)
+    const decodeResult = decodeSolanaTransaction(action, actionPath, ViolationCode.SolanaGasCompensationDecodeError);
+    if (!decodeResult.ok)
+        return decodeResult.violations;
+    const transaction = decodeResult.transaction;
+    const staticAccountKeys = transaction.message.staticAccountKeys.map(key => key.toBase58());
+    const compiledIxs = transaction.message.compiledInstructions;
+    const violations = [];
+    // CRITICAL: all programs must be in GAS_COMPENSATION_ALLOWED_PROGRAMS
+    violations.push(...validateGasCompensationAllowedPrograms(compiledIxs, staticAccountKeys, actionPath));
+    const resolved = resolveInstructions(compiledIxs, staticAccountKeys);
+    // CRITICAL: must have exactly one transfer, rest must be memos
+    violations.push(...validateGasCompensationInstructions(resolved, actionPath, gasCompensationTokenAddresses));
+    // HIGH (execution): fee payer must not be the user
+    violations.push(...validateGasCompensationFeePayer(transaction, actionPath, quoteMode, srcChainAuthorityAddress));
+    return violations;
+}
+// CRITICAL: only allowed programs
+function validateGasCompensationAllowedPrograms(compiledInstructions, staticAccountKeys, actionPath) {
+    const violations = [];
+    for (let i = 0; i < compiledInstructions.length; i++) {
+        const programIdx = compiledInstructions[i].programIdIndex;
+        const programId = staticAccountKeys[programIdx];
+        if (programId === undefined) {
+            // Program from Address Lookup Table — forbidden
+            violations.push({
+                code: ViolationCode.SolanaGasCompensationForbiddenProgram,
+                message: "GasCompensation instruction uses a program from"
+                    + " Address Lookup Table",
+                path: `${actionPath}.data.data`,
+                actual: `instruction[${i}].programIdIndex=${programIdx}`,
+            });
+            continue;
+        }
+        if (!GAS_COMPENSATION_ALLOWED_PROGRAMS.has(programId)) {
+            violations.push({
+                code: ViolationCode.SolanaGasCompensationForbiddenProgram,
+                message: "GasCompensation instruction uses a forbidden program",
+                path: `${actionPath}.data.data`,
+                expected: [...GAS_COMPENSATION_ALLOWED_PROGRAMS],
+                actual: programId,
+            });
+        }
+    }
+    return violations;
+}
+// CRITICAL: exactly one transfer, rest = memo
+function validateGasCompensationInstructions(resolved, actionPath, gasCompensationTokenAddresses) {
+    const violations = [];
+    const transfers = [];
+    const splTransfers = [];
+    for (let i = 0; i < resolved.length; i++) {
+        const ix = resolved[i];
+        if (isSystemTransfer(ix)) {
+            transfers.push(ix);
+        }
+        else if (isSplTransferChecked(ix)) {
+            splTransfers.push(ix);
+        }
+        else if (isMemo(ix)) {
+            // OK: memo instructions are allowed
+        }
+        else {
+            // HIGH: unexpected instruction type
+            violations.push({
+                code: ViolationCode.SolanaGasCompensationUnexpectedInstruction,
+                message: "GasCompensation contains an unexpected instruction type",
+                path: `${actionPath}.data.data`,
+                actual: {
+                    index: i,
+                    programId: ix.programId,
+                    dataLength: ix.data.length,
+                },
+            });
+        }
+    }
+    const totalTransfers = transfers.length + splTransfers.length;
+    if (totalTransfers < 1 || totalTransfers > 1) {
+        violations.push({
+            code: ViolationCode.SolanaGasCompensationTransferMissing,
+            message: "GasCompensation must contain exactly one transfer",
+            path: `${actionPath}.data.data`,
+            expected: 1,
+            actual: totalTransfers,
+        });
+    }
+    // CRITICAL: for SPL transfers, validate token mint matches gasCompensationInfo
+    if (splTransfers.length === 1) {
+        violations.push(...validateGasCompensationTokenMint(splTransfers[0], actionPath, gasCompensationTokenAddresses));
+    }
+    return violations;
+}
+// CRITICAL: SPL transfer token must match gasCompensationInfo.tokenAddress
+function validateGasCompensationTokenMint(ix, actionPath, gasCompensationTokenAddresses) {
+    // transferChecked accounts: [0]=source, [1]=mint, [2]=destination, [3]=owner
+    if (ix.accountKeys.length < 4) {
+        return [{
+                code: ViolationCode.SolanaGasCompensationTokenMismatch,
+                message: "SPL transferChecked instruction has fewer than 4 accounts",
+                path: `${actionPath}.data.data`,
+                expected: 4,
+                actual: ix.accountKeys.length,
+            }];
+    }
+    const mint = ix.accountKeys[1];
+    const matchesAny = gasCompensationTokenAddresses.some(addr => addressEquals(ChainId.Solana, mint, addr));
+    if (!matchesAny) {
+        return [{
+                code: ViolationCode.SolanaGasCompensationTokenMismatch,
+                message: "GasCompensation SPL transfer mint does not match"
+                    + " any gasCompensationInfo.tokenAddress",
+                path: `${actionPath}.data.data`,
+                expected: gasCompensationTokenAddresses,
+                actual: mint,
+            }];
+    }
+    return [];
+}
+// HIGH (execution): fee payer must not be the user
+function validateGasCompensationFeePayer(transaction, actionPath, quoteMode, srcChainAuthorityAddress) {
+    if (quoteMode || !srcChainAuthorityAddress)
+        return [];
+    const keys = transaction.message.staticAccountKeys;
+    if (keys.length === 0)
+        return [];
+    const feePayer = keys[0].toBase58();
+    if (addressEquals(ChainId.Solana, feePayer, srcChainAuthorityAddress)) {
+        return [{
+                code: ViolationCode.SolanaGasCompensationFeePayerIsUser,
+                message: "GasCompensation fee payer must not be the user",
+                path: `${actionPath}.data.data`,
+                actual: feePayer,
+            }];
+    }
+    return [];
+}
+// =============================================
+// Helpers
+// =============================================
+function decodeSolanaTransaction(action, actionPath, errorCode) {
+    const dataHex = action.data.data;
+    return decodeSolanaVersionedTransaction(dataHex, `${actionPath}.data.data`, errorCode, errorCode);
+}
+// SPL Token transferChecked: discriminator = 12 (1 byte), data >= 10 bytes
+// (1 disc + 8 amount + 1 decimals)
+function isSplTransferChecked(ix) {
+    if (ix.programId !== SPL_TOKEN_PROGRAM && ix.programId !== SPL_TOKEN_2022_PROGRAM) {
+        return false;
+    }
+    return ix.data.length >= 10 && ix.data[0] === 12;
+}
+function hexEquals(a, b) {
+    const normalize = (s) => s.toLowerCase().replace(/^0x/, "");
+    return normalize(a) === normalize(b);
+}
+function truncateHex(hex) {
+    if (hex.length <= 20)
+        return hex;
+    return hex.slice(0, 10) + "..." + hex.slice(-8);
+}
+//# sourceMappingURL=solana-hook.js.map

package/dist/esm/validations/solana-hook.js.map

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