wallet_connect

지갑을 연결하고 계정 접근 권한을 요청하는 Coinbase Wallet 전용 메서드입니다.

지갑 연결을 수립하기 위한 Coinbase Wallet 전용 메서드입니다.

지갑이 dApp에 연결되고 계정 접근 권한을 제공하도록 요청합니다. 기본 동작은 eth_requestAccounts와 비슷하지만, 추가 연결 기능을 함께 요청할 수 있습니다.

파라미터

options · object

연결에 사용할 선택적 설정 객체입니다.

Show 옵션 속성

version · string

사용할 wallet connect 버전입니다.

jsonrpc · string

JSON-RPC 버전입니다. 보통 "2.0"을 사용합니다.

capabilities · object

연결 시 함께 요청할 선택적 capability 집합입니다. 예를 들어 인증을 위한 signInWithEthereum를 요청할 수 있습니다.

Show 사용 가능한 capability

signInWithEthereum · object

연결 과정에서 SIWE(Sign-In With Ethereum) 인증을 요청합니다.

Show signInWithEthereum 속성

nonce · string · required

재전송 공격을 방지하기 위한 고유한 랜덤 문자열입니다.

chainId · string · required

16진수 문자열 형태의 체인 ID입니다. 예: Base Mainnet은 "0x2105"입니다.

반환값

result · object

계정 정보와 capability 결과를 담은 연결 결과 객체입니다.

Show 결과 속성

accounts · array

연결된 계정 객체 배열입니다.

Show 계정 객체 속성

address · string

계정 주소입니다.

capabilities · object

연결 시 요청한 capability가 있다면 그 결과가 포함됩니다.

Show Capability 결과

signInWithEthereum · object

요청한 경우 SIWE 인증 결과가 반환됩니다.

Show signInWithEthereum 결과

message · string

서명된 SIWE 형식 메시지입니다.

signature · string

메시지의 암호학적 서명입니다.

chainId · string

현재 체인 ID의 16진수 문자열입니다.

isConnected · boolean

지갑이 연결되었는지 여부입니다.

Basic Connection

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "wallet_connect",
  "params": [{}]
}

Basic Connection Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "accounts": [{
      "address": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
    }],
    "chainId": "0x2105",
    "isConnected": true
  }
}

오류 처리

Code	Message	설명
4001	User rejected the request	사용자가 연결 요청을 거부했습니다.
4100	Requested method not supported	지갑이 이 메서드를 지원하지 않습니다.
4200	Wallet not available	지갑이 설치되어 있지 않거나 사용할 수 없습니다.
-32602	Invalid params	signInWithEthereum capability의 nonce 또는 chainId가 올바르지 않습니다.

이 메서드는 Coinbase Wallet 전용이며 다른 지갑에서는 제공되지 않을 수 있습니다.

연결이 성공하면 지갑은 연결 이벤트를 발생시키고 계정 정보에 접근할 수 있게 합니다.

signInWithEthereum capability를 사용할 때는 재전송 공격을 막기 위해 매 인증 시도마다 새로운 nonce를 생성하세요. 생성된 서명은 viem 같은 라이브러리로 백엔드에서 검증할 수 있습니다.

Capability와 함께 사용하기

wallet_connect는 signInWithEthereum capability와 함께 사용해 사용자를 인증할 수 있습니다.