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 팀