Разработка отслеживания статуса транзакции в криптокошельке

Транзакция отправлена — и пользователь смотрит на статус Pending следующие 10 минут. Это нормально для блокчейна, но ненормально — не получить уведомление, когда транзакция подтвердилась или зафейлилась. Отслеживание статуса транзакции — это real-time задача с несколькими уровнями: polling блокчейна, WebSocket-подключение, push-уведомление при финальном статусе. Без своевременных обновлений пользователи теряют доверие, а в криптокошельках с большим трафиком (например, 8000 транзакций в день) задержка даже в 5 секунд создаёт негативный опыт.

Наши инженеры с 5+ летним опытом в блокчейн-проектах реализовали отслеживание для 15+ криптокошельков. Сертифицированы Apple и Google, работали с Ethereum, Bitcoin, Solana и другими сетями, интегрировали WebSocket через Alchemy WebSocket API и Infura, настраивали push-уведомления через APNs и FCM. Гарантируем стабильную работу и своевременные обновления статуса.

Как выглядит жизненный цикл транзакции?

Ethereum-транзакция проходит через состояния: submitted → pending (mempool) → confirmed (1 confirmation) → finalized (12+ confirmations) → failed (reverted / dropped). Bitcoin: mempool → 1 confirmation → 6 confirmations (finalized). Solana — значительно быстрее: слоты по ~400ms, processed → confirmed → finalized за секунды. На клиенте нужно показывать текущее состояние и количество подтверждений.

Какие стратегии получения статуса существуют?

Polling каждые 3–5 секунд при открытом экране — нормально. В фоне — только через silent push или WebSocket API. Экономия на инфраструктуре до 40% при использовании WebSocket вместо частого polling.

Polling через node RPC

// iOS — polling статуса ETH транзакции через JSON-RPC func pollTransactionStatus(txHash: String) async throws -> TransactionStatus { let params: [AnyEncodable] = [txHash, false] let receipt = try await ethClient.call(method: "eth_getTransactionReceipt", params: params) if receipt == nil { return .pending // Ещё в mempool } let confirmations = try await getConfirmationsCount(txHash: txHash) return confirmations >= requiredConfirmations ? .confirmed : .confirmingWith(count: confirmations) } 

Почему WebSocket быстрее polling?

WebSocket обеспечивает мгновенную передачу данных при появлении нового блока, в то время как polling имеет задержку до 5 секунд. Для критичных транзакций WebSocket — предпочтительный выбор. Мы помогаем выбрать оптимальный вариант под ваш бюджет и требования.

WebSocket подписка через Alchemy / Infura / QuickNode

// Бэкенд — подписка на событие через Alchemy WebSocket const { createAlchemyWeb3 } = require("@alch/alchemy-web3"); const web3 = createAlchemyWeb3(process.env.ALCHEMY_WS_URL); async function watchTransaction(txHash, userId) { const subscription = web3.eth.subscribe('newBlockHeaders'); subscription.on('data', async (blockHeader) => { const receipt = await web3.eth.getTransactionReceipt(txHash); if (receipt) { subscription.unsubscribe(); await updateTransactionStatus(txHash, receipt.status ? 'confirmed' : 'failed'); await sendPushNotification(userId, txHash, receipt.status); } }); } 

Как настроить отслеживание статуса транзакции через WebSocket?

1. На сервере поднимаем WebSocket эндпоинт, авторизованный по токену пользователя.
2. На клиенте устанавливаем соединение при переходе на экран списка транзакций.
3. Подписываемся на события по tx_hash — сервер отправляет обновления статуса.
4. При получении финального статуса закрываем соединение.
5. Повторно подключаемся при переоткрытии экрана или после ошибки.

// Android — подписка на статус транзакции через WebSocket class TransactionStatusSocket( private val token: String, private val okHttpClient: OkHttpClient ) { fun subscribe(txHash: String): Flow<TransactionStatus> = callbackFlow { val ws = okHttpClient.newWebSocket( Request.Builder() .url("wss://api.yourwallet.app/ws/tx/$txHash") .header("Authorization", "Bearer $token") .build(), object : WebSocketListener() { override fun onMessage(webSocket: WebSocket, text: String) { val status = json.decodeFromString<TransactionStatusUpdate>(text) trySend(status.status) if (status.isFinal) close() } override fun onFailure(webSocket: WebSocket, t: Throwable, response: Response?) { close(t) } } ) awaitClose { ws.close(1000, "Subscription ended") } } } 

Progress индикатор подтверждений

Для ETH отображаем прогресс к 12 подтверждениям. Используем ProgressView с градиентом от оранжевого к зеленому по мере увеличения count. Дизайн транзакции в разных статусах:

• pending — анимированный spinner, жёлтый акцент
• confirming — progress bar с количеством подтверждений
• confirmed — зелёная галочка, анимация
• failed — красный, причина ошибки если доступна (revert reason из receipt)

Push-уведомления при изменении статуса

При финальном статусе отправляем push пользователю:

{ "title": "Транзакция подтверждена", "body": "0.05 ETH отправлено на 0x742d...3B8C", "data": { "screen": "transaction_detail", "tx_hash": "0xabc123...", "status": "confirmed" } } 

Для failed транзакции — отдельный шаблон с описанием причины (revert reason или dropped from mempool).

Как устроена обработка dropped транзакций?

Транзакция может исчезнуть из mempool если gas price был слишком низким. Через 15–30 минут без подтверждения — транзакция считается dropped. Нужно detectить это:

suspend fun checkDroppedTransactions() { val pendingTxs = transactionDao.getPendingOlderThan(minutes = 20) pendingTxs.forEach { tx -> val receipt = ethClient.getTransactionReceipt(tx.hash) if (receipt == null) { transactionDao.updateStatus(tx.hash, TransactionStatus.DROPPED) pushService.notifyUser(tx.userId, "Транзакция не попала в блок", tx.hash) } } } 

Что входит в работу

Анализ текущей архитектуры кошелька и выбор стратегии (polling/WebSocket/webhook). Интеграция с блокчейн-нодами (Infura, Alchemy, QuickNode) или собственным узлом. Реализация клиентской логики: polling/WebSocket клиент для iOS и Android. Разработка progress bar для отображения количества подтверждений. Настройка push-уведомлений (APNs, FCM) при финальном статусе. Обработка dropped транзакций и ошибок (revert reason, timeout). Тестирование на тестовых сетях (Goerli, Sepolia) и mainnet. Документация и передача исходного кода.

Сроки и стоимость

Базовая реализация отслеживания с polling и push-уведомлениями занимает 6–10 рабочих дней. Полный цикл с WebSocket, progress bar, обработкой dropped транзакций и кастомными push — от 2 недель. Стоимость рассчитывается индивидуально после анализа проекта. Свяжитесь с нами для консультации и точной оценки.

Мы гарантируем качество, предоставляем поддержку после запуска. Опыт наших разработчиков подтвержден сертификатами Apple и Google. Получите бесплатную консультацию по архитектуре отслеживания для вашего криптокошелька.