Разработка human-readable декодировщика транзакций для dApp

Разработка декодировщика транзакций (human-readable)

Пользователь видит в MetaMask data: 0xa9059cbb000000... и жмёт «Подтвердить», доверяя dApp. Это не проблема UX — это уязвимость, через которую ежегодно похищают миллионы долларов. Мы устраняем её: разрабатываем декодировщик транзакций, который показывает человеку, что он на самом деле подписывает. Wallet Guard, Rabby, WalletConnect уже внедрили такое. Ваш dApp тоже должен.

Какие проблемы решает декодировщик?

Риск подписания вредоносной транзакции

Без human-readable интерпретации пользователь не видит, что 0xa9059cbb... — это вызов transfer с указанием получателя и суммы. Анализаторы, вроде Slither, обнаруживают лишь статические уязвимости, а runtime-угрозы (например, approval на адреса контрактов-скамов) остаются скрытыми до первого взрыва кошелька.

Нечитаемые транзакции aggregator-роутов

Сложные DeFi-операции (multi-hop свапы, flash loan, yield farming) содержат до 20 вложенных вызовов. Без трейса и декодирования каждого уровня понять суть может только блокчейн-эксперт. Наш инструмент строит дерево вызовов, где каждый узел — человекопонятная команда: "Swap 100 DAI for 0.5 ETH via Uniswap V3", "Deposit into Aave V2", "Transfer 10% fee to treasury".

Как работает human-readable декодировщик?

Это модуль, который на лету преобразует calldata и логи в понятные строки. Он подключается к кошельку (MetaMask, WalletConnect) и перехватывает транзакцию перед подписанием. Используем ABI контракта, lookup по 4byte.directory или Etherscan, а для прокси-контрактов — резолв implementation. Результат — пользователь видит: "Перевести 100 USDC на 0xabc..." и только тогда подписывает.

Как мы строим декодировщик?

Есть три подхода, и мы выбираем лучший для вашего use case. Сравнение точности показывает, что комбинированный метод в 1.5 раза точнее одиночного 4byte (95% против 60%).

Для критичных приложений мы комбинируем: сначала пытаемся ABI, если не найден — Etherscan с прокси-резолвером, и только потом 4byte как fallback. Это даёт максимальную точность.

Глубокая деталь: proxy resolution

Реальные контракты используют прокси-паттерны (EIP-1967, EIP-1822, OpenZeppelin TransparentProxy). ABI прокси — пустышка. Мы вычитываем слоты хранилища, чтобы найти адрес implementation, затем загружаем его ABI из Etherscan или по Bytecode. Этот шаг — ключевой, без него декодирование для 70% популярных контрактов (USDC, UNI, AAVE) будет бесполезным.

async function resolveEIP1967(proxyAddress: `0x${string}`): Promise<`0x${string}` | null> { const client = createPublicClient({ chain: mainnet, transport: http(RPC_URL) }) const EIP1967_SLOT = "0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc" const slotValue = await client.getStorageAt({ address: proxyAddress, slot: EIP1967_SLOT }) if (!slotValue || slotValue === "0x" + "0".repeat(64)) return null return `0x${slotValue.slice(-40)}` as `0x${string}` }