# SCOPE Connect

> dApp과 외부 지갑을 연결하고 요청·서명을 라우팅하는 지갑 연결 중심 클라이언트 SDK. dApp에 넣는 AppKit과 지갑에 넣는 WalletKit으로 구성되며, injected·모바일·릴레이 연결을 하나의 인터페이스로 다룹니다.

## Start Here

- [Introduction](guides/getting-started/introduction): SCOPE Connect가 무엇을 해결하는지 소개하고, dApp 개발자와 지갑 제공사를 위한 통합 경로를 안내합니다.
- [Architecture](guides/architecture): SCOPE Connect의 구성 요소와 역할, 그리고 공개 값과 비밀 값을 어디에 두어야 하는지 설명합니다.

## AppKit — Getting Started

- [AppKit Overview](guides/appkit/overview): AppKit으로 브라우저 확장, 모바일 지갑, 릴레이 지갑을 연결하고 같은 인터페이스로 요청을 보내는 방법을 설명합니다.
- [Quickstart](guides/getting-started/quickstart): TypeScript 브라우저 앱에서 지갑을 선택해 연결하고 CAIP-10 계정과 CAIP-2 체인을 표시합니다.
- [Supported Wallets & Networks](guides/getting-started/supported-wallets): AppKit이 연결하는 검증된 지원 지갑과 네트워크 목록을 확인합니다.

## AppKit — Integration

- [Configuration](guides/appkit/configuration): AppKit 생성과 초기화, 공개 Client ID, 텔레메트리 옵션과 고정된 백엔드·릴레이 엔드포인트를 설명합니다.
- [Connecting Wallets](guides/appkit/connecting): 네트워크에 맞는 지갑 목록을 구성하고 connect() 또는 selectWallet()로 EVM·Solana 지갑을 연결합니다.
- [Relay Connection](guides/appkit/relay-connection): React 바인딩으로 릴레이 QR·딥링크를 표시하고 지갑 승인 후 릴레이 세션을 받는 방법을 설명합니다.
- [Sending Requests](guides/appkit/requests): 연결된 지갑 또는 릴레이 세션으로 JSON-RPC 요청을 보내고 전송 방식별 결과와 오류를 처리합니다.
- [Signing](guides/appkit/signing): 연결된 지갑에 EVM 메시지·구조화 데이터 또는 Solana 트랜잭션 서명을 요청하고 결과를 처리합니다.
- [Balances](guides/appkit/balances): AppKit.getBalance()와 createBalanceReader()로 네이티브 자산과 토큰 잔액을 조회합니다.
- [React Bindings](guides/appkit/react): @scope-connect/appkit-react로 React·Next.js 앱에 Provider, 세션 훅과 기본 지갑 연결 UI를 붙입니다.

## AppKit — Recipes

- [Payment Requests](guides/use-cases/payment-requests): 결제 요청 검증부터 지갑 연결, 토큰 전송, 온체인 확정 확인과 선택적 완료 보고까지 구현합니다.

## AppKit — API Reference

- [AppKit API](api-reference/appkit): AppKit 지원 환경과 기본 사용 예제, 생성·초기화 API를 설명합니다.
- [AppKit Connection](api-reference/appkit-connection): connect·selectWallet·pair·switchNetwork·disconnect와 릴레이 페어링 옵션을 정의합니다.
- [AppKit Operations](api-reference/appkit-operations): 요청·서명·잔액 조회 API와 Solana 모바일 연결, 연결 상태 속성을 설명합니다.
- [AppKit Types](api-reference/appkit-types): WalletConnection·AppKitOptions·지갑과 네트워크 정보 타입 등 공개 API에서 사용하는 타입을 설명합니다.
- [AppKit 선택적 API](api-reference/appkit-optional): 독립 잔액 리더, 커넥터 인터페이스, 릴레이 함수 등 필요할 때 선택적으로 사용하는 공개 API를 설명합니다.
- [AppKit Error Handling](api-reference/appkit-errors): AppError와 AppResultCode, 릴레이·프로바이더 오류를 발생 조건·재시도 가능성·사용자 조치별로 정리합니다.

## WalletKit — Getting Started

- [WalletKit Overview](guides/walletkit/overview): 지갑 제공사가 WalletKit의 도입 대상, 지원 플랫폼, 세션 연결 흐름과 역할 범위를 확인하는 파트너 프리뷰 개요입니다.
- [Installation](guides/walletkit/installation): WalletKit KMP 라이브러리를 Android·iOS·JVM에 연결하고 WalletKit 인스턴스를 만듭니다.
- [Quickstart](guides/walletkit/quickstart): JVM 명령줄 예제로 scope: 페어링 URI를 받아 세션을 연결하고 EIP-3009 서명 요청에 응답합니다.

## WalletKit — Integration

- [Wallet Session](guides/walletkit/session): 스캔한 scope: 페어링 URI에서 connect()로 릴레이 세션을 연결하고 WalletSessionResult를 처리합니다.
- [Approval](guides/walletkit/approval): 연결·서명 승인 UI를 연결하고 요청 정보를 사용자에게 표시·검증합니다.
- [Signing & Private Keys](guides/walletkit/signing): Signer 인터페이스의 역할과 실제 지갑 앱의 개인키 처리 주의사항을 설명합니다.
- [Relay Transport](guides/walletkit/relay-transport): RelayTransport와 KtorRelayTransport의 자동 재연결·재시도·오류 처리를 설명합니다.

## WalletKit — API Reference

- [WalletKit API](api-reference/walletkit): WalletKit 지원 환경과 Swift 사용 규칙, WalletKit 클래스와 세션 API를 설명합니다.
- [WalletKit Approval](api-reference/walletkit-approval): setApprovalHandler와 ApprovalRequest·ApprovalDecision, 요청 정보 타입을 정의합니다.
- [WalletKit Signer & Pairing](api-reference/walletkit-signer): Signer 인터페이스의 역할, 개인키 처리 범위와 scope 페어링 URI 파서를 설명합니다.
- [WalletKit Relay Transport](api-reference/walletkit-relay): RelayTransport 인터페이스와 KtorRelayTransport 기본 구현, 암호화 메시지·재연결·릴레이 오류를 설명합니다.
- [WalletKit Session Messages](api-reference/walletkit-wire): 태그별 세션 메시지 생성·해석 함수와 EIP-3009 구조화 데이터 함수를 설명합니다.
- [WalletKit Cryptography](api-reference/walletkit-crypto): ChannelCrypto·X25519·Secp256k1Signer와 해시·16진수 변환, EIP-712 인코딩 함수를 설명합니다.
- [WalletKit Error Handling](api-reference/walletkit-errors): RelayRpcException과 시간 초과 예외, 상황별 예외와 지갑 응답이 dApp에 나타나는 방식을 설명합니다.

## Changelog

- [2026-08-11](changelog/2026-08-11): userHash를 선택 옵션으로 전환하고, SDK가 대체 식별자를 만들지 않도록 변경했습니다.
- [2026-08-03](changelog/2026-08-03): 릴레이와 Connect 백엔드 엔드포인트를 SDK 빌드 시점 값으로 고정했습니다.
- [2026-07-31](changelog/2026-07-31): clientId를 필수 옵션으로 전환하고 텔레메트리를 기본 비활성화했습니다.
- [2026-07-30](changelog/2026-07-30): userHash를 필수 옵션으로 전환하고 SDK의 자동 대체 동작을 제거했습니다.
- [2026-07-28](changelog/2026-07-28): 개인정보 기반 userHash를 제거하고 임의 값 방식으로 전환했습니다.
- [2026-07-19](changelog/2026-07-19): 텔레메트리 사용자 식별값을 deviceId에서 userHash로 전환했습니다.
- [2026-07-10](changelog/2026-07-10): AppKit·WalletKit 텔레메트리와 콘솔 모니터링 연동을 추가했습니다.
- [2026-07-02](changelog/2026-07-02): WalletKit과 릴레이 페어링을 도입하고 지원 지갑을 확장했습니다.
- [2026-06-24](changelog/2026-06-24): AppKit 첫 릴리스를 공개했습니다.

## Notice

- [2026-07-16 Service Notice](notice/2026-07-16): SCOPE Connect 개발자 문서 사이트 오픈 공지입니다.

## Legal

- [Privacy Policy](https://lambda256.notion.site/scope-connect-privacy-policy?source=copy_link): 개인정보처리방침.
- [Terms of Service](https://lambda256.notion.site/scope-connect-terms-of-service?source=copy_link): 서비스 이용약관.