# XChainJS 检查交易示例

Source: Dev.to

Live Demo & Source Code

• Live demo (CodeSandbox):
• Source code (GitHub):

What This Example Does

该项目演示了如何使用 XChainJS 检查交易状态。它涵盖了：

• 通过哈希获取交易信息
• 检查确认数和最终性
• 处理待确认与已确认的交易
• 使用链无关的 API 进行交易查询

对以下开发者非常有用：

• 加密钱包
• 交易历史页面
• 区块链浏览器
• 监控与告警服务
• 跨链后端

Tech Stack

• TypeScript
• Node.js
• XChainJS
• @xchainjs/xchain-util
• XChainJS 生态系统中的链客户端

Project Location

在 XChainJS monorepo 中：

examples/
 └─ check-tx/

该示例侧重于 交易状态逻辑，不包含 UI 代码。

How Transaction Checking Works

Transaction Hash
      ↓
XChainJS Chain Client
      ↓
Fetch Transaction Data
      ↓
Check Confirmations & Status
      ↓
Return Result

Core Concepts

Transaction Hash

交易哈希唯一标识链上一次交易。此示例展示了如何使用哈希查询区块链并获取交易详情。

Transaction Status

根据不同链的实现，交易状态可能为：

• 待确认 (pending)
• 已确认 (confirmed)
• 失败 (failed)

XChainJS 抽象了这些差异，提供了一致的跨链交易状态检查接口。

Installation

Clone the repository

git clone https://github.com/xchainjs/xchainjs-lib.git
cd xchainjs-lib/examples/check-tx

Install dependencies

npm install

Run the example

npm start

Running in the Browser

你也可以通过 CodeSandbox 即时运行此示例。

Code Example (Simplified)

import { getClient } from '@xchainjs/xchain-thorchain'

const txHash = 'YOUR_TRANSACTION_HASH'

async function checkTx() {
  const client = getClient()
  const tx = await client.getTransactionData(txHash)

  if (!tx) {
    throw new Error('Transaction not found')
  }

  console.log(tx)
}

checkTx()

通过切换客户端，此模式可复用于不同链。

Why Use XChainJS for Transaction Monitoring

• 为多条区块链提供统一 API
• TypeScript 优先，代码更安全
• 可复用的客户端抽象
• 适用于钱包和生产后端

When This Example Is Useful

如果你正在：

• 学习交易追踪原理
• 构建钱包交易历史
• 实现确认数逻辑
• 监控跨链交易
• 使用 XChainJS 客户端

则此示例非常适用。

Related Resources

• XChainJS GitHub:
• XChainJS utilities:
• Live check transaction example:

Summary

本示例提供了一个 简洁、可直接运行的参考，演示如何使用 XChainJS 检查区块链交易。它为构建钱包、浏览器以及监控服务等交易感知应用提供了坚实的基础。