Skip to main content

Documentation Index

Fetch the complete documentation index at: https://daehan-base.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Base Account에는 Base Account가 애플리케이션 전반에서 어떻게 사용되는지 더 잘 이해하고 개발자 경험을 개선하기 위한 익명 텔레메트리 시스템이 포함되어 있습니다. 이 익명 프로그램 참여는 선택 사항입니다. 사용 데이터를 공유하고 싶지 않다면 쉽게 옵트아웃할 수 있습니다.

텔레메트리를 수집하는 이유는 무엇인가요?

Base Account는 트랜잭션 및 메시지 서명, 서명자 관리 등의 기능을 갖춘 온체인 애플리케이션을 위한 중요한 지갑 인프라를 제공합니다. 텔레메트리 데이터를 수집함으로써 다음이 가능합니다:
  • 지갑 작동 성공 모니터링: 가장 신뢰할 수 있는 지갑 작동(서명, 연결, 트랜잭션)을 추적하고 실패 패턴 파악
  • 데이터 기반 개선: 엔지니어링 팀이 미래의 지갑 향상 및 신뢰성 개선을 이끄는 인사이트 생성
  • 사전 이슈 감지: 운영 메트릭 및 오류 모니터링을 통해 새로운 SDK 릴리스나 지갑 작동의 문제를 신속하게 감지

어떤 데이터가 수집되나요?

텔레메트리 데이터는 완전히 익명이며 기능 메트릭에 초점을 맞춥니다. 구체적으로 수집되는 데이터는 다음과 같습니다:
  • 요청 성공 메트릭: 신뢰성 문제를 파악하기 위한 지갑 요청의 성공 및 실패율 정보
  • 오류 이벤트: Base Account 신뢰성 개선을 위한 운영 컨텍스트가 포함된 일반 오류 이벤트
  • UI 컴포넌트 사용량: 최적의 신뢰성을 보장하기 위한 인터페이스 컴포넌트 기능에 관한 익명 메트릭
프라이버시 우선: 개인 키, 트랜잭션 내용, 사용자 주소 또는 개인 정보와 같은 민감한 데이터는 절대 수집되지 않습니다.

어떻게 작동하나요?

텔레메트리는 Base Account SDK에 통합되어 있으며 특정 지갑 이벤트가 발생할 때 자동으로 트리거됩니다(구성에서 텔레메트리가 활성화된 경우). 데이터는 분석을 위해 안전한 Coinbase 엔드포인트로 전송됩니다. 예를 들어, 지갑 요청이 발생하면 다음과 같은 텔레메트리 이벤트가 전송됩니다:
curl 'https://cca-lite.coinbase.com/amp' \
  -H 'content-type: application/x-www-form-urlencoded; charset=utf-8' \
  -H 'origin: https://your-app.com' \
  --data-raw 'e=[{"event_type":"scw_signer.request.started","event_properties":{"method":"eth_requestAccounts","correlationId":"abc123-def456","sdkVersion":"4.3.2","appName":"Your App Name","appOrigin":"https://your-app.com"}}]'
페이로드에는 운영 데이터가 포함된 텔레메트리 이벤트 배열이 들어 있습니다:
  • event_type: 추적 중인 특정 지갑 작동
  • method: 호출되는 지갑 메서드 (예: eth_requestAccounts)
  • correlationId: 요청 추적을 위한 고유 식별자
  • sdkVersion: Base Account SDK 버전
  • appName: 애플리케이션 이름
  • appOrigin: 애플리케이션의 도메인

옵트아웃하려면 어떻게 하나요?

기본적으로 텔레메트리 수집은 옵트아웃 모델을 따릅니다. Base Account SDK를 사용하는 앱에서 텔레메트리를 비활성화하려면 SDK 초기화 중에 설정할 수 있습니다:
import { createBaseAccountSDK } from "@base-org/account";

const sdk = createBaseAccountSDK({
  appName: "My App",
  appLogoUrl: "https://example.com/logo.png",
  preference: {
    telemetry: false, 
  },
});

const provider = sdk.getProvider();
레거시 Coinbase Wallet SDK 클래스 기반 컴포넌트의 경우:
import { CoinbaseWalletSDK } from "@coinbase/wallet-sdk";

const sdk = new CoinbaseWalletSDK({
  appName: "My App",
  appLogoUrl: "https://example.com/logo.png",
});

const provider = sdk.getProvider({
  telemetry: false, 
});
이 텔레메트리 이니셔티브가 가장 중요한 지갑 작동에 개선을 집중하고 문제를 조기에 발견하여 모든 개발자를 위한 Base Account를 더욱 발전시키는 데 도움이 될 것으로 기대합니다. 질문이나 피드백이 있으시면 Base Account 팀에 연락해 주세요. Base Account와 함께 즐거운 개발 되세요! — Base Account 팀