Core Wallet을 Avalanche DeFi 애플리케이션에 연결하는 방법

핵심 지갑 통합 아키텍처

1. Core Wallet은 EIP-1193을 준수하는 주입 공급자로 작동하여 Avalanche C-Chain을 포함한 EVM 호환 체인 전반에 걸쳐 dApp 상호 작용을 위한 표준화된 인터페이스를 노출합니다.

2. 지갑은 이더리움 개체를 전역 창 범위에 주입하여 외부 SDK 없이 request , on 및 RemoveListener 와 같은 메서드에 직접 액세스할 수 있도록 합니다.

3. Avalanche별 체인 구성은 Core Wallet의 네트워크 목록에 사전 등록되어 있어야 합니다. 누락된 항목은 첫 번째 연결 중에 사용자가 수동으로 RPC 끝점 입력을 트리거합니다.

4. 서명 요청은 기본적으로 EIP-1559 트랜잭션 형식을 따르며 https://api.avax.network/ext/bc/C/rpc와 같은 Avalanche의 공개 RPC 엔드포인트에서 가져온 동적 가스 추정을 사용합니다.

5. 다중 체인 지원은 switchEthereumChain 방법을 통해 처리되므로 dApp UI를 다시 로드하지 않고도 Avalanche Fuji 테스트넷과 메인넷 간에 원활하게 전환할 수 있습니다.

프런트엔드 연결 흐름

1. MetaMask나 다른 주입된 지갑과 구별하기 위해 window.ethereum?.isCore 또는 window.ethereum?.providers?.find(p => p.isCore)를 사용하여 Core Wallet의 존재를 감지합니다.

2. 사용자 승인을 요청하고 승인된 주소 배열을 반환하는 ethereum.request({ method: 'eth_requestAccounts' }) 를 사용하여 연결을 초기화합니다.

3. ethereum.request({ method: 'eth_getBalance', params: [address, 'latest'] }) 로 계정 잔액을 가져오고 BigInt 변환을 통해 결과를 16진수 문자열에서 10진수로 구문 분석합니다.

4. ethereum.on('chainChanged', handlerChainChange) 을 통해 네트워크 변경 이벤트를 수신하여 dApp 상태가 현재 Avalanche 체인 ID(메인넷의 경우 43114, Fuji의 경우 43113)를 반영하는지 확인합니다.

5. ethereum.on('accountsChanged', handlerAccountsChanged) 을 통해 연결 해제 처리를 구현하여 주소 취소 또는 지갑 잠금을 감지합니다.

Avalanche DeFi 계약 상호 작용

1. Avalanche C-Chain에 배포된 스마트 계약에는 읽기/쓰기 작업을 위해 Viem 또는 ethers.js 계약 객체를 인스턴스화하기 위한 ABI 및 계약 주소가 필요합니다.

2. Pangolin 또는 Trader Joe의 토큰 스왑의 경우 정확한 입력 금액, 미끄러짐 허용 범위 및 Uniswap V2 포크 표준에 따라 인코딩된 기한이 포함된 encodeFunctionData를 사용하여 거래 매개변수를 구성합니다.

3. Avalanche의 가스 가격 모델에 대해 검증된 to , data , value , gasLimit 및 maxFeePerGas 필드를 포함하는 서명된 페이로드로 eth_sendTransaction을 호출합니다.

4. eth_getTransactionReceipt 폴링 또는 ethereum.request({ method: 'eth_subscribe', params: ['newHeads'] }) 를 통한 이벤트 구독을 사용하여 트랜잭션 상태를 모니터링합니다.

5. 거래 영수증에 포함된 되돌리기 사유 문자열을 분석하여 유동성 부족, 기한 만료, 가격 영향 확인 실패 등 일반적인 되돌리기 원인을 처리합니다.

보안 검증 체크리스트

1. DNS 하이재킹이나 응답 변조를 방지하기 위해 모든 RPC 호출이 타사 프록시가 아닌 Avalanche의 공식 엔드포인트에서 발생하는지 확인합니다.

2. 자금 이체 또는 승인과 관련된 상호 작용을 시작하기 전에 Snowtrace.io에서 확인된 소스에 대해 계약 주소를 검증합니다.

3. document.location.origin 이 Core Wallet의 내부 권한 데이터베이스에 등록된 화이트리스트 dApp 도메인과 일치하는지 확인하여 엄격한 도메인 바인딩을 시행합니다.

4. personal_sign 또는 eth_signTypedData_v4 응답에 EIP-191 및 EIP-712 사양에 정의된 일치하는 접두사 패턴이 없으면 서명되지 않은 메시지 서명을 거부합니다.

5. 알려진 dApp ID 키 쌍으로 암호화된 방식으로 서명되지 않는 한 URL 매개변수 또는 쿼리 문자열에 의해 트리거되는 계약 호출의 자동 실행을 비활성화합니다.

자주 묻는 질문

Q: Core Wallet은 맞춤형 Avalanche 서브넷을 지원합니까? 코어 지갑은 기본적으로 기본 C-체인 및 X-체인 상호 작용만 지원합니다. 서브넷 통합에는 수동 RPC 구성이 필요하며 기본적으로 활성화되지 않습니다.

Q: AvaxCanary 또는 NFTPort와 같은 Avalanche의 EVM 호환 L2와 함께 Core Wallet을 사용할 수 있습니까? 예, 해당 L2가 표준 EVM JSON-RPC 엔드포인트를 노출하고 연결하기 전에 Core Wallet의 네트워크 레지스트리에 체인 ID를 등록한다면 가능합니다.

Q: MetaMask도 설치되어 있는데 dApp이 Core Wallet을 감지하지 못하는 이유는 무엇입니까? 이는 두 지갑 모두 window.ethereum 을 주입하기 때문에 발생합니다. 감지 논리는 최상위 속성 존재에만 의존하는 대신 window.ethereum.providers를 통해 반복하고 isCore 플래그를 확인해야 합니다.

Q: Avalanche 거래를 위해 Core Wallet 내에서 하드웨어 지갑 지원이 가능한가요? Core Wallet은 기본적으로 Ledger 또는 Trezor 장치를 통합하지 않습니다. 사용자는 브라우저 기반 서명이나 호환 브리지를 통해 라우팅되는 외부 지갑 연결 세션을 사용해야 합니다.