# XChainJS 거래 확인 예제

Source: Dev.to

라이브 데모 & 소스 코드

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

이 예제가 하는 일

이 프로젝트는 XChainJS를 사용해 트랜잭션 상태를 확인하는 방법을 보여줍니다. 다음을 다룹니다:

• 해시로 트랜잭션 정보 가져오기
• 컨펌 및 최종성 확인
• 대기 중 트랜잭션과 확정된 트랜잭션 처리
• 체인에 구애받지 않는 API를 이용한 트랜잭션 조회

다음과 같은 개발자에게 유용합니다:

• 암호화폐 지갑
• 트랜잭션 히스토리 페이지
• 블록체인 탐색기
• 모니터링 및 알림 서비스
• 크로스‑체인 백엔드

기술 스택

• TypeScript
• Node.js
• XChainJS
• @xchainjs/xchain-util
• XChainJS 생태계의 체인 클라이언트들

프로젝트 위치

XChainJS 모노레포 내부:

examples/
 └─ check-tx/

이 예제는 트랜잭션 상태 로직에 초점을 맞추며 UI 코드는 포함하지 않습니다.

트랜잭션 확인 흐름

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

핵심 개념

Transaction Hash

트랜잭션 해시는 온‑체인 트랜잭션을 고유하게 식별합니다. 이 예제에서는 해시를 사용해 블록체인을 조회하고 트랜잭션 상세 정보를 가져오는 방법을 보여줍니다.

Transaction Status

체인에 따라 트랜잭션은 다음 중 하나일 수 있습니다:

• pending (대기)
• confirmed (확정)
• failed (실패)

XChainJS는 이러한 차이를 추상화하여 체인 간에 일관된 인터페이스로 트랜잭션 상태를 확인할 수 있게 합니다.

설치

저장소 복제

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

의존성 설치

npm install

예제 실행

npm start

브라우저에서 실행

CodeSandbox를 이용해 이 예제를 즉시 실행할 수도 있습니다.

코드 예시 (단순화)

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()

클라이언트를 교체하면 다른 체인에서도 동일한 패턴을 재사용할 수 있습니다.

트랜잭션 모니터링에 XChainJS를 사용하는 이유

• 여러 블록체인을 위한 통합 API
• 보다 안전한 코드를 위한 TypeScript‑first 설계
• 재사용 가능한 클라이언트 추상화
• 지갑 및 프로덕션 백엔드에 적합

이 예제가 유용한 경우

다음 상황에 해당한다면 이 예제를 활용하세요:

• 트랜잭션 추적 방식 학습
• 지갑 트랜잭션 히스토리 구축
• 컨펌 로직 구현
• 크로스‑체인 트랜잭션 모니터링
• XChainJS 클라이언트와 작업

관련 리소스

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

요약

이 예제는 XChainJS를 사용해 블록체인 트랜잭션을 확인하는 간단하고 실행 가능한 레퍼런스를 제공합니다. 지갑, 탐색기, 모니터링 서비스 등 트랜잭션 인식 애플리케이션을 구축하기 위한 견고한 기반이 됩니다.