블록체인 동기화

블록체인 동기화 파이프라인은 연결된 각 지갑의 온체인 데이터를 가져오고, 정규화하고, 중복을 제거합니다. 진행 상황은 실시간으로 스트리밍되어 각 동기화가 진행되는 동안 모니터링할 수 있습니다.

동기화 작동 방식

지갑을 연결하거나 동기화를 시작하면 CryptaCount는 두 개의 병렬 데이터 스트림을 실행합니다:

거래 (Transactions) — 네이티브 통화 이체(이더리움의 ETH, 폴리곤의 MATIC 등)와 일반 컨트랙트 호출을 가져옵니다. 이는 체인의 기본 레이어에서의 직접 거래입니다.

토큰 전송 (Token Transfers) — 토큰 전송 이벤트(ERC-20 및 동등 표준)를 가져옵니다. 이는 거래 로그에서 캡처된 컨트랙트 발행 이벤트로, 네이티브 거래와 독립적으로 동기화됩니다.

각 스트림은 자체 진행 상황 추적기(마지막으로 처리된 블록 번호)와 페이지네이션 커서를 유지합니다.

동기화 생명주기

1. 초기화 — CryptaCount는 동일한 주소와 체인을 가진 다른 지갑이 이미 동기화 중인지 확인합니다(이중 동기화 방지). 스트림별 시작 블록을 결정합니다.
2. 가져오기 — 페이지 단위로 블록체인 제공업체에서 거래 데이터 요청
3. 정규화 — 체인별 형식을 CryptaCount의 범용 거래 모델로 변환
4. 중복 제거 — 각 거래를 기존 기록과 대조하여 중복 방지
5. 저장 — 새 거래를 워크스페이스에 기록
6. 분류 — 새 기록에 거래 분류 엔진 실행
7. 가격 책정 — 각 거래 타임스탬프의 각 자산에 대한 FMV 가져오기
8. 분개 — 복식 부기 분개 항목 생성

중복 제거

모든 거래에는 체인, 블록, 거래 해시, 이벤트 인덱스를 기반으로 고유 키가 부여됩니다. CryptaCount는 삽입 전에 기존 기록을 확인하여, 동기화가 중단되었다가 재시작되더라도 중복 데이터가 생기지 않도록 합니다.

스마트 재개

초기 전체 동기화 후, 이후의 동기화는 마지막으로 처리된 블록에서 재개됩니다. 중요한 점은 재개 지점이 스트림별로 추적된다는 것입니다(거래 vs. 토큰 전송):

• 각 스트림이 독립적으로 재개됩니다
• 이는 빠르게 완료된 스트림의 블록 번호로 인해 다른 스트림이 데이터를 건너뛰는 상황을 방지합니다

실시간 진행 상황

동기화 진행 상황은 인터페이스에 실시간으로 스트리밍됩니다. 진행 상황 표시는 다음을 제공합니다:

• 현재 동기화 단계 (가져오기, 정규화, 저장)
• 처리된 거래 수 / 예상 총 거래 수
• 블록 진행 상황 (현재 블록 / 최신 블록)
• 스트림별 상태 (거래, 토큰 전송)
• 오류 메시지 (있는 경우)

이를 통해 페이지를 새로 고침할 필요 없이 실시간 진행 상황 표시가 가능합니다.

다중 지갑 중복 제거

동일한 주소가 여러 워크스페이스 지갑에 사용되는 경우(예: 다른 레이블로 동일한 주소가 추가된 경우), CryptaCount는 중복을 확인하고 동일한 주소를 가진 다른 지갑이 이미 동기화되었거나 동기화 중이면 건너뜁니다. 이는 워크스페이스 수준에서 거래 데이터 중복을 방지합니다.

속도 제한 및 복원력

블록체인 데이터 제공업체는 속도 제한을 부과합니다. 동기화 파이프라인은 다음과 같이 처리합니다:

• 자동 백오프 — 속도 제한에 도달하면 시스템이 자동으로 백오프하고 재시도합니다
• 진행 상황 보존 — 동기화가 중단되면 스트림별로 진행 상황이 저장되고 다음 동기화에서 중단된 곳에서 재개됩니다
• 중단된 동기화 정리 — 백그라운드 작업이 주기적으로 중단된 동기화를 감지하고 정리합니다

동기화 상태 모니터링

지갑 상세 보기에서 Sync 탭은 다음을 보여줍니다:

• 스트림별 현재 동기화 상태 (거래, 토큰 전송)
• 스트림별 마지막으로 처리된 블록 번호
• 가져온 총 거래 수
• 오류 메시지 (있는 경우)
• 마지막 성공적인 동기화 시간

수동 동기화 시작

• 단일 지갑: 지갑 상세 열기 → Sync Now 클릭
• 재스캔: 블록 0부터 지갑의 전체 재스캔 강제 실행
• 동기화 요청: 사용자가 동기화를 요청하면 워크스페이스 관리자가 승인하거나 거부합니다

동기화 오류

일반적인 동기화 오류와 해결 방법:

오류	원인	해결 방법
속도 제한 초과	제공업체에 요청이 너무 많음	기다렸다가 재시도; 자동 백오프로 처리됨
타임아웃	대용량 데이터 배치 처리 지연	자동 처리; 다음 동기화에서 스트림별 마지막 블록에서 재개
잘못된 주소	지갑 주소가 선택된 체인과 일치하지 않음	주소 형식과 체인 선택 확인
제공업체 사용 불가	블록체인 데이터 제공업체 일시적 중단	대기 후 자동 재시도
이중 동기화 감지	동일한 주소가 이미 동기화 중	기존 동기화가 완료될 때까지 대기

지속적인 문제의 경우 동기화 및 연결 문제 해결 가이드를 참조하세요.