본문으로 건너뛰기
Change page

JSON-RPC API

소프트웨어 애플리케이션이 블록체인 데이터를 읽거나 네트워크에 트랜잭션을 전송하는 등 이더리움 블록체인과 상호작용하려면 이더리움 노드에 연결해야 합니다.

이를 위해 모든 이더리움 클라이언트는 JSON-RPC 사양 (opens in a new tab)을 구현하므로, 특정 노드나 클라이언트 구현에 관계없이 애플리케이션이 의존할 수 있는 일관된 메서드 세트가 존재합니다.

JSON-RPC (opens in a new tab)는 무상태(stateless) 경량 원격 프로시저 호출(RPC) 프로토콜입니다. 이 프로토콜은 여러 데이터 구조와 그 처리 규칙을 정의합니다. 동일한 프로세스 내에서, 소켓을 통해, HTTP를 통해, 또는 다양한 메시지 전달 환경에서 개념을 사용할 수 있다는 점에서 전송 방식에 구애받지 않습니다. 데이터 형식으로는 JSON(RFC 4627)을 사용합니다.

클라이언트 구현

이더리움 클라이언트는 JSON-RPC 사양을 구현할 때 각각 다른 프로그래밍 언어를 사용할 수 있습니다. 특정 프로그래밍 언어와 관련된 자세한 내용은 개별 클라이언트 문서를 참조하세요. 최신 API 지원 정보는 각 클라이언트의 문서를 확인하는 것을 권장합니다.

편의 라이브러리

JSON-RPC API를 통해 이더리움 클라이언트와 직접 상호작용할 수도 있지만, 탈중앙화 애플리케이션 (dapp) 개발자를 위한 더 쉬운 옵션이 있는 경우가 많습니다. JSON-RPC API 위에 래퍼(wrapper)를 제공하는 수많은 JavaScript 및 백엔드 API 라이브러리가 존재합니다. 이러한 라이브러리를 사용하면 개발자는 자신이 선택한 프로그래밍 언어로 직관적인 한 줄짜리 메서드를 작성하여 이더리움과 상호작용하는 JSON-RPC 요청을 (내부적으로) 초기화할 수 있습니다.

합의 클라이언트 API

이 페이지는 주로 이더리움 실행 클라이언트에서 사용하는 JSON-RPC API를 다룹니다. 하지만 합의 클라이언트에도 RPC API가 있어 사용자가 노드에서 직접 노드에 대한 정보를 조회하고, 비콘(Beacon) 블록, 비콘 상태 및 기타 합의 관련 정보를 요청할 수 있습니다. 이 API는 비콘 API 웹페이지 (opens in a new tab)에 문서화되어 있습니다.

노드 내 클라이언트 간 통신을 위한 내부 API도 사용됩니다. 즉, 합의 클라이언트와 실행 클라이언트가 데이터를 스왑할 수 있게 해줍니다. 이를 '엔진 API(Engine API)'라고 하며, 사양은 GitHub (opens in a new tab)에서 확인할 수 있습니다.

실행 클라이언트 사양

GitHub에서 전체 JSON-RPC API 사양을 확인하세요 (opens in a new tab). 이 API는 실행 API 웹페이지 (opens in a new tab)에 문서화되어 있으며, 사용 가능한 모든 메서드를 테스트해 볼 수 있는 인스펙터(Inspector)를 포함하고 있습니다.

관례

16진수 값 인코딩

JSON을 통해 전달되는 두 가지 주요 데이터 유형은 형식이 지정되지 않은 바이트 배열과 수량입니다. 둘 다 16진수 인코딩으로 전달되지만 형식 지정 요구 사항이 다릅니다.

수량

수량(정수, 숫자)을 인코딩할 때: 16진수로 인코딩하고, "0x"를 접두사로 사용하며, 가장 간결한 표현을 사용합니다(약간의 예외: 0은 "0x0"으로 표현해야 함).

다음은 몇 가지 예시입니다.

  • 0x41 (10진수로 65)
  • 0x400 (10진수로 1024)
  • 잘못된 예: 0x (항상 하나 이상의 숫자가 있어야 합니다. 0은 "0x0"입니다)
  • 잘못된 예: 0x0400 (앞에 0을 붙일 수 없습니다)
  • 잘못된 예: ff (0x 접두사가 있어야 합니다)

형식이 지정되지 않은 데이터

형식이 지정되지 않은 데이터(바이트 배열, 계정 주소, 해시, 바이트코드 배열)를 인코딩할 때: 16진수로 인코딩하고, "0x"를 접두사로 사용하며, 바이트당 두 개의 16진수 숫자를 사용합니다.

다음은 몇 가지 예시입니다.

  • 0x41 (크기 1, "A")
  • 0x004200 (크기 3, "0B0")
  • 0x (크기 0, "")
  • 잘못된 예: 0xf0f0f (짝수 개의 숫자여야 합니다)
  • 잘못된 예: 004200 (0x 접두사가 있어야 합니다)

블록 매개변수

다음 메서드에는 블록 매개변수가 있습니다.

이더리움의 상태를 쿼리하는 요청이 이루어질 때, 제공된 블록 매개변수가 블록의 높이를 결정합니다.

블록 매개변수에 대해 다음 옵션을 사용할 수 있습니다.

  • HEX String - 정수 블록 번호
  • String "earliest" - 가장 초기/제네시스 블록
  • String "latest" - 가장 최근에 제안된 블록
  • String "safe" - 가장 최근의 안전한 헤드 블록
  • String "finalized" - 가장 최근에 완결된 블록
  • String "pending" - 대기 중인 상태/트랜잭션

예제

이 페이지에서는 명령줄 도구인 curl (opens in a new tab)을 사용하여 개별 JSON_RPC API 엔드포인트를 사용하는 방법에 대한 예제를 제공합니다. 이러한 개별 엔드포인트 예제는 아래의 Curl 예제 섹션에서 확인할 수 있습니다. 페이지 하단에서는 Geth 노드, JSON_RPC API 및 curl을 사용하여 스마트 컨트랙트를 컴파일링하고 배포하기 위한 엔드투엔드 예제도 제공합니다.

Curl 예제

이더리움 노드에 curl (opens in a new tab) 요청을 보내 JSON_RPC API를 사용하는 예제가 아래에 제공됩니다. 각 예제에는 특정 엔드포인트, 매개변수, 반환 유형에 대한 설명과 사용 방법에 대한 실제 예제가 포함되어 있습니다.

curl 요청은 콘텐츠 유형과 관련된 오류 메시지를 반환할 수 있습니다. 이는 --data 옵션이 콘텐츠 유형을 application/x-www-form-urlencoded로 설정하기 때문입니다. 노드에서 이와 관련된 오류가 발생하면 호출 시작 부분에 -H "Content-Type: application/json"를 배치하여 헤더를 수동으로 설정하세요. 또한 예제에는 curl에 제공되는 마지막 인수여야 하는 URL/IP 및 포트 조합(예: 127.0.0.1:8545)이 포함되어 있지 않습니다. 이러한 추가 데이터를 포함하는 완전한 curl 요청은 다음과 같은 형태를 취합니다.

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}' 127.0.0.1:8545

가십, 상태, 기록

소수의 핵심 JSON-RPC 메서드는 이더리움 네트워크의 데이터를 필요로 하며, 크게 세 가지 주요 범주인 가십(Gossip), 상태(State), 기록(History)으로 나뉩니다. 각 메서드로 이동하려면 이 섹션의 링크를 사용하거나, 전체 메서드 목록을 살펴보려면 목차를 사용하세요.

가십 메서드

이 메서드들은 체인의 헤드(head)를 추적합니다. 이를 통해 트랜잭션이 네트워크를 돌아다니고, 블록에 포함되며, 클라이언트가 새로운 블록에 대해 알게 됩니다.

상태 메서드

저장된 모든 데이터의 현재 상태를 보고하는 메서드입니다. "상태"는 하나의 거대한 공유 RAM과 같으며, 계정 잔액, 컨트랙트 데이터 및 가스 추정치를 포함합니다.

기록 메서드

제네시스 블록까지 거슬러 올라가 모든 블록의 과거 기록을 가져옵니다. 이는 하나의 거대한 추가 전용(append-only) 파일과 같으며, 모든 블록 헤더, 블록 바디, 엉클 블록 및 트랜잭션 영수증을 포함합니다.

JSON-RPC API 플레이그라운드

플레이그라운드 도구 (opens in a new tab)를 사용하여 API 메서드를 알아보고 테스트해 볼 수 있습니다. 또한 다양한 노드 제공업체에서 어떤 메서드와 네트워크를 지원하는지도 보여줍니다.

JSON-RPC API 메서드

web3_clientVersion

현재 클라이언트 버전을 반환합니다.

매개변수

없음

반환값

String - 현재 클라이언트 버전

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'
// 결과
{
  "id":67,
  "jsonrpc":"2.0",
  "result": "Geth/v1.12.1-stable/linux-amd64/go1.19.1"
}

web3_sha3

주어진 데이터의 케착-256(표준화된 SHA3-256이 아님)을 반환합니다.

매개변수

  1. DATA - SHA3 해시로 변환할 데이터
params: ["0x68656c6c6f20776f726c64"]

반환값

DATA - 주어진 문자열의 SHA3 결과입니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'
// 결과
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}

net_version

현재 네트워크 ID를 반환합니다.

매개변수

없음

반환값

String - 현재 네트워크 ID입니다.

현재 네트워크 ID의 전체 목록은 chainlist.org (opens in a new tab)에서 확인할 수 있습니다. 일반적으로 사용되는 ID는 다음과 같습니다.

  • 1: 이더리움 메인넷
  • 11155111: Sepolia 테스트넷
  • 560048 : Hoodi 테스트넷

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'
// 결과
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "3"
}

net_listening

클라이언트가 네트워크 연결을 활발히 수신 대기 중인 경우 true를 반환합니다.

매개변수

없음

반환값

Boolean - 수신 대기 중인 경우 true, 그렇지 않은 경우 false.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'
// 결과
{
  "id":67,
  "jsonrpc":"2.0",
  "result":true
}

net_peerCount

현재 클라이언트에 연결된 피어의 수를 반환합니다.

매개변수

없음

반환값

QUANTITY - 연결된 피어의 수를 나타내는 정수입니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'
// 결과
{
  "id":74,
  "jsonrpc": "2.0",
  "result": "0x2" // 2
}

eth_protocolVersion

현재 이더리움 프로토콜 버전을 반환합니다. 참고로 이 메서드는 Geth에서 사용할 수 없습니다 (opens in a new tab).

매개변수

없음

반환값

String - 현재 이더리움 프로토콜 버전

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'
// 결과
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "54"
}

eth_syncing

동기화 상태에 대한 데이터가 포함된 객체 또는 false를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

없음

반환값

정확한 반환 데이터는 클라이언트 구현마다 다릅니다. 노드가 동기화 중이 아닐 때 모든 클라이언트는 False를 반환하며, 모든 클라이언트는 다음 필드를 반환합니다.

Object|Boolean, 동기화 상태 데이터가 포함된 객체 또는 동기화 중이 아닐 경우 FALSE:

  • startingBlock: QUANTITY - 가져오기가 시작된 블록 (동기화가 헤드에 도달한 후에만 재설정됨)
  • currentBlock: QUANTITY - 현재 블록, eth_blockNumber와 동일
  • highestBlock: QUANTITY - 예상되는 가장 높은 블록

하지만 개별 클라이언트는 추가 데이터를 제공할 수도 있습니다. 예를 들어 Geth는 다음을 반환합니다:

반면 Besu(베수)는 다음을 반환합니다:

자세한 내용은 특정 클라이언트의 문서를 참조하세요.

예시

eth_coinbase

클라이언트의 코인베이스 주소를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

참고: 이 메서드는 v1.14.0부터 더 이상 사용되지 않으며 지원되지 않습니다. 이 메서드를 사용하려고 시도하면 "Method not supported" 오류가 발생합니다.

매개변수

없음

반환값

DATA, 20바이트 - 현재 코인베이스 주소.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'
// 결과
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

eth_chainId

재전송 공격 방지 트랜잭션에 서명하는 데 사용되는 체인 ID를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

없음

반환값

chainId, 현재 체인 ID의 정수를 나타내는 문자열 형태의 16진수 값입니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":67}'
// 결과
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "0x1"
}

eth_mining

클라이언트가 활발하게 새 블록을 채굴하고 있는 경우 true를 반환합니다. 이는 작업증명(PoW) 네트워크에서만 true를 반환할 수 있으며, 머지 이후 일부 클라이언트에서는 사용할 수 없을 수도 있습니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

없음

반환값

Boolean - 클라이언트가 채굴 중이면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":71}'
//
{
  "id":71,
  "jsonrpc": "2.0",
  "result": true
}

eth_hashrate

노드가 채굴하는 초당 해시 수를 반환합니다. 이는 작업증명(PoW) 네트워크에 대해서만 true를 반환할 수 있으며, 머지 이후 일부 클라이언트에서는 사용할 수 없을 수도 있습니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

없음

반환값

QUANTITY - 초당 해시 수입니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'
// 결과
{
  "id":71,
  "jsonrpc": "2.0",
  "result": "0x38a"
}

eth_gasPrice

Wei 단위의 현재 가스당 가격 추정치를 반환합니다. 예를 들어, 베수 클라이언트는 기본적으로 최근 100개의 블록을 검사하여 가스 단위 가격의 중간값을 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

없음

반환값

QUANTITY - Wei 단위의 현재 가스 가격을 나타내는 정수입니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'
// 결과
{
  "id":73,
  "jsonrpc": "2.0",
  "result": "0x1dfd14000" // 8049999872 Wei
}

eth_accounts

클라이언트가 소유한 주소 목록을 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

없음

반환값

Array of DATA, 20바이트 - 클라이언트가 소유한 주소입니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
}

eth_blockNumber

가장 최근 블록의 번호를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

없음

반환값

QUANTITY - 클라이언트가 위치한 현재 블록 번호의 정수입니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'
// 결과
{
  "id":83,
  "jsonrpc": "2.0",
  "result": "0x4b7" // 1207
}

eth_getBalance

주어진 주소에 있는 계정의 잔액을 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. DATA, 20바이트 - 잔액을 확인할 주소입니다.
  2. QUANTITY|TAG - 정수 블록 번호, 또는 문자열 "latest", "earliest", "pending", "safe", "finalized". 블록 매개변수를 참조하세요.
params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]

반환값

QUANTITY - Wei 단위의 현재 잔액을 나타내는 정수입니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x0234c8a3397aab58" // 158972490234375000
}

eth_getStorageAt

주어진 주소의 스토리지 위치에 있는 값을 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. DATA, 20바이트 - 스토리지의 주소.
  2. QUANTITY - 스토리지 내 위치의 정수.
  3. QUANTITY|TAG - 정수 블록 번호 또는 문자열 "latest", "earliest", "pending", "safe", "finalized", 블록 매개변수 참조

반환값

DATA - 해당 스토리지 위치의 값.

예시 올바른 위치를 계산하는 방법은 검색할 스토리지에 따라 다릅니다. 주소 0x391694e7e0b0cce554cb130d723a9d27458f9298에 의해 0x295a70b2de5e3953354a6a8344e616ed314d7251에 배포된 다음 컨트랙트를 고려해 보세요.

contract Storage {
    uint pos0;
    mapping(address => uint) pos1;
    constructor() {
        pos0 = 1234;
        pos1[msg.sender] = 5678;
    }
}

pos0의 값을 검색하는 것은 간단합니다.

curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x0", "latest"], "id": 1}' localhost:8545
{"jsonrpc":"2.0","id":1,"result":"0x00000000000000000000000000000000000000000000000000000000000004d2"}

맵의 요소를 검색하는 것은 더 어렵습니다. 맵에 있는 요소의 위치는 다음과 같이 계산됩니다.

keccak(LeftPad32(key, 0), LeftPad32(map position, 0))

즉, pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"]의 스토리지를 검색하려면 다음을 사용하여 위치를 계산해야 합니다.

keccak(
  decodeHex(
    "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" +
      "0000000000000000000000000000000000000000000000000000000000000001"
  )
)

Web3 라이브러리와 함께 제공되는 geth 콘솔을 사용하여 계산할 수 있습니다.

> var key = "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" + "0000000000000000000000000000000000000000000000000000000000000001"
undefined
> web3.sha3(key, {"encoding": "hex"})
"0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9"

이제 스토리지를 가져옵니다.

curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9", "latest"], "id": 1}' localhost:8545
{"jsonrpc":"2.0","id":1,"result":"0x000000000000000000000000000000000000000000000000000000000000162e"}

eth_getTransactionCount

주소에서 보낸 트랜잭션의 수를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. DATA, 20바이트 - 주소.
  2. QUANTITY|TAG - 정수 블록 번호, 또는 문자열 "latest", "earliest", "pending", "safe" 또는 "finalized", 블록 매개변수 참조
params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "latest", // 최신 블록의 상태
]

반환값

QUANTITY - 이 주소에서 보낸 트랜잭션 수의 정수값.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getBlockTransactionCountByHash

주어진 블록 해시와 일치하는 블록에 있는 트랜잭션의 수를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. DATA, 32바이트 - 블록의 해시
params: ["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"]

반환값

QUANTITY - 이 블록에 있는 트랜잭션 수의 정수값.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"],"id":1}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x8b" // 139
}

eth_getBlockTransactionCountByNumber

주어진 블록 번호와 일치하는 블록의 트랜잭션 수를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. QUANTITY|TAG - 블록 번호의 정수, 또는 블록 매개변수와 같은 "earliest", "latest", "pending", "safe" 또는 "finalized" 문자열.
params: [
  "0x13738ca", // 20396234
]

반환값

QUANTITY - 이 블록에 포함된 트랜잭션 수의 정수.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x13738ca"],"id":1}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x8b" // 139
}

eth_getUncleCountByBlockHash

주어진 블록 해시와 일치하는 블록의 엉클 수를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. DATA, 32바이트 - 블록의 해시
params: ["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"]

반환값

QUANTITY - 이 블록에 있는 엉클 수의 정수값.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"],"id":1}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getUncleCountByBlockNumber

주어진 블록 번호와 일치하는 블록에 있는 엉클의 수를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. QUANTITY|TAG - 블록 번호의 정수, 또는 문자열 "latest", "earliest", "pending", "safe" 또는 "finalized". 블록 매개변수를 참조하세요.
params: [
  "0xe8", // 232
]

반환값

QUANTITY - 이 블록에 있는 엉클 수를 나타내는 정수입니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x0" // 0
}

eth_getCode

주어진 주소의 코드를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. DATA, 20바이트 - 주소
  2. QUANTITY|TAG - 정수 블록 번호, 또는 문자열 "latest", "earliest", "pending", "safe" 또는 "finalized". 블록 매개변수 참조
params: [
  "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "0x5daf3b", // 6139707
]

반환값

DATA - 주어진 주소의 코드.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x5daf3b"],"id":1}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x6060604052600436106100af576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806306fdde03146100b9578063095ea7b31461014757806318160ddd146101a157806323b872dd146101ca5780632e1a7d4d14610243578063313ce5671461026657806370a082311461029557806395d89b41146102e2578063a9059cbb14610370578063d0e30db0146103ca578063dd62ed3e146103d4575b6100b7610440565b005b34156100c457600080fd5b6100cc6104dd565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561010c5780820151818401526020810190506100f1565b50505050905090810190601f1680156101395780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561015257600080fd5b610187600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061057b565b604051808215151515815260200191505060405180910390f35b34156101ac57600080fd5b6101b461066d565b6040518082815260200191505060405180910390f35b34156101d557600080fd5b610229600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061068c565b604051808215151515815260200191505060405180910390f35b341561024e57600080fd5b61026460048080359060200190919050506109d9565b005b341561027157600080fd5b610279610b05565b604051808260ff1660ff16815260200191505060405180910390f35b34156102a057600080fd5b6102cc600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610b18565b6040518082815260200191505060405180910390f35b34156102ed57600080fd5b6102f5610b30565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561033557808201518184015260208101905061031a565b50505050905090810190601f1680156103625780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561037b57600080fd5b6103b0600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091908035906020019091905050610bce565b604051808215151515815260200191505060405180910390f35b6103d2610440565b005b34156103df57600080fd5b61042a600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610be3565b6040518082815260200191505060405180910390f35b34600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055503373ffffffffffffffffffffffffffffffffffffffff167fe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c346040518082815260200191505060405180910390a2565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156105735780601f1061054857610100808354040283529160200191610573565b820191906000526020600020905b81548152906001019060200180831161055657829003601f168201915b505050505081565b600081600460003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508273ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040518082815260200191505060405180910390a36001905092915050565b60003073ffffffffffffffffffffffffffffffffffffffff1631905090565b600081600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054101515156106dc57600080fd5b3373ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16141580156107b457507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205414155b156108cf5781600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020541015151561084457600080fd5b81600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055505b81600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254039250508190555081600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040518082815260200191505060405180910390a3600190509392505050565b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410151515610a2757600080fd5b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055503373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501515610ab457600080fd5b3373ffffffffffffffffffffffffffffffffffffffff167f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65826040518082815260200191505060405180910390a250565b600260009054906101000a900460ff1681565b60036020528060005260406000206000915090505481565b60018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015610bc65780601f10610b9b57610100808354040283529160200191610bc6565b820191906000526020600020905b815481529060010190602001808311610ba957829003601f168201915b505050505081565b6000610bdb33848461068c565b905092915050565b60046020528160005260406000206020528060005260406000206000915091505054815600a165627a7a72305820deb4c2ccab3c2fdca32ab3f46728389c2fe2c165d5fafa07661e4e004f6c344a0029"
}

eth_sign

sign 메서드는 다음과 같이 이더리움 전용 서명을 계산합니다: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))).

메시지에 접두사를 추가하면 계산된 서명을 이더리움 전용 서명으로 인식할 수 있게 됩니다. 이는 악의적인 탈중앙화 애플리케이션(dapp)이 임의의 데이터(예: 트랜잭션)에 서명하고 그 서명을 사용하여 피해자를 사칭하는 오용을 방지합니다.

참고: 서명에 사용할 주소는 잠금 해제되어 있어야 합니다.

매개변수

  1. DATA, 20바이트 - 주소
  2. DATA, N바이트 - 서명할 메시지

반환값

DATA: 서명

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_signTransaction

eth_sendRawTransaction을 사용하여 나중에 네트워크에 제출할 수 있는 트랜잭션에 서명합니다.

매개변수

  1. Object - 트랜잭션 객체
  • type:
  • from: DATA, 20바이트 - 트랜잭션을 보내는 주소입니다.
  • to: DATA, 20바이트 - (새 컨트랙트를 생성할 때는 선택 사항) 트랜잭션이 향하는 주소입니다.
  • gas: QUANTITY - (선택 사항, 기본값: 90000) 트랜잭션 실행을 위해 제공되는 가스의 정수값입니다. 사용되지 않은 가스는 반환됩니다.
  • gasPrice: QUANTITY - (선택 사항, 기본값: 미정) 지불된 각 가스에 사용되는 gasPrice의 정수값이며, 단위는 Wei입니다.
  • value: QUANTITY - (선택 사항) 이 트랜잭션과 함께 전송되는 값의 정수값이며, 단위는 Wei입니다.
  • data: DATA - 컨트랙트의 컴파일된 코드 또는 호출된 메서드 서명 및 인코딩된 매개변수의 해시입니다.
  • nonce: QUANTITY - (선택 사항) 논스의 정수값입니다. 이를 통해 동일한 논스를 사용하는 자신의 대기 중인 트랜잭션을 덮어쓸 수 있습니다.

반환값

DATA, 지정된 계정으로 서명된 RLP 인코딩된 트랜잭션 객체입니다.

예시

// 요청
curl -X POST --data '{"id": 1,"jsonrpc": "2.0","method": "eth_signTransaction","params": [{"data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675","from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155","gas": "0x76c0","gasPrice": "0x9184e72a000","to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567","value": "0x9184e72a"}]}'
// 결과
{
    "id": 1,
    "jsonrpc": "2.0",
    "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_sendTransaction

새로운 메시지 호출 트랜잭션을 생성하거나 데이터 필드에 코드가 포함된 경우 컨트랙트 생성을 수행하며, from에 지정된 계정을 사용하여 서명합니다.

매개변수

  1. Object - 트랜잭션 객체
  • from: DATA, 20바이트 - 트랜잭션을 보내는 주소입니다.
  • to: DATA, 20바이트 - (새 컨트랙트를 생성할 때는 선택 사항) 트랜잭션이 향하는 주소입니다.
  • gas: QUANTITY - (선택 사항, 기본값: 90000) 트랜잭션 실행을 위해 제공되는 가스의 정수 값입니다. 사용되지 않은 가스는 반환됩니다.
  • gasPrice: QUANTITY - (선택 사항, 기본값: 미정) 지불되는 각 가스에 사용되는 가스 가격의 정수 값입니다.
  • value: QUANTITY - (선택 사항) 이 트랜잭션과 함께 전송되는 값의 정수 값입니다.
  • input: DATA - 컨트랙트의 컴파일된 코드 또는 호출된 메서드 서명의 해시와 인코딩된 매개변수입니다.
  • nonce: QUANTITY - (선택 사항) 논스의 정수 값입니다. 이를 통해 동일한 논스를 사용하는 자신의 대기 중인 트랜잭션을 덮어쓸 수 있습니다.

반환값

DATA, 32바이트 - 트랜잭션 해시, 또는 트랜잭션을 아직 사용할 수 없는 경우 제로 해시입니다.

컨트랙트를 생성한 경우, 트랜잭션이 블록에 제안된 후 eth_getTransactionReceipt를 사용하여 컨트랙트 주소를 가져오세요.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_sendRawTransaction

서명된 트랜잭션에 대해 새로운 메시지 호출 트랜잭션을 만들거나 컨트랙트를 생성합니다.

매개변수

  1. DATA, 서명된 트랜잭션 데이터입니다.
params: [
  "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
]

반환값

DATA, 32바이트 - 트랜잭션 해시, 또는 트랜잭션을 아직 사용할 수 없는 경우 0 해시입니다.

컨트랙트를 생성했을 때 트랜잭션이 블록에 제안된 후 컨트랙트 주소를 가져오려면 eth_getTransactionReceipt를 사용하세요.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_call

블록체인에 트랜잭션을 생성하지 않고 즉시 새로운 메시지 호출을 실행합니다. 주로 읽기 전용 스마트 컨트랙트 함수를 실행하는 데 사용되며, 예를 들어 ERC-20 컨트랙트의 balanceOf가 있습니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. Object - 트랜잭션 호출 객체
  • from: DATA, 20 Bytes - (선택 사항) 트랜잭션을 보내는 주소입니다.
  • to: DATA, 20 Bytes - 트랜잭션이 향하는 주소입니다.
  • gas: QUANTITY - (선택 사항) 트랜잭션 실행을 위해 제공되는 가스의 정수 값입니다. eth_call은 가스를 소비하지 않지만, 일부 실행에서는 이 매개변수가 필요할 수 있습니다.
  • gasPrice: QUANTITY - (선택 사항) 지불된 각 가스에 사용되는 gasPrice의 정수 값입니다.
  • value: QUANTITY - (선택 사항) 이 트랜잭션과 함께 전송되는 값의 정수 값입니다.
  • input: DATA - (선택 사항) 메서드 서명 및 인코딩된 매개변수의 해시입니다. 자세한 내용은 Solidity 문서의 이더리움 컨트랙트 ABI (opens in a new tab)를 참조하세요.
  1. QUANTITY|TAG - 정수 블록 번호 또는 문자열 "latest", "earliest", "pending", "safe" 또는 "finalized"입니다. 블록 매개변수를 참조하세요.

반환값

DATA - 실행된 컨트랙트의 반환값입니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x"
}

eth_estimateGas

트랜잭션을 완료하는 데 필요한 가스량의 추정치를 생성하고 반환합니다. 트랜잭션은 블록체인에 추가되지 않습니다. EVM 메커니즘 및 노드 성능을 포함한 다양한 이유로 인해 추정치가 트랜잭션에서 실제로 사용되는 가스량보다 훨씬 많을 수 있다는 점에 유의하세요.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

모든 속성이 선택 사항이라는 점을 제외하고 eth_call 매개변수를 참조하세요. 가스 한도가 지정되지 않은 경우 Geth는 대기 중인 블록의 블록 가스 한도를 상한으로 사용합니다. 결과적으로 가스량이 대기 중인 블록 가스 한도보다 높을 때 반환된 추정치가 호출/트랜잭션을 실행하기에 충분하지 않을 수 있습니다.

반환값

QUANTITY - 사용된 가스량.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x5208" // 21000
}

eth_getBlockByHash

해시를 통해 블록에 대한 정보를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. DATA, 32바이트 - 블록의 해시.
  2. Boolean - true인 경우 전체 트랜잭션 객체를 반환하고, false인 경우 트랜잭션의 해시만 반환합니다.
params: [
  "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
  false,
]

반환값

Object - 블록 객체, 또는 블록을 찾을 수 없는 경우 null를 반환합니다:

  • number: QUANTITY - 블록 번호. 대기 중인 블록인 경우 null.
  • hash: DATA, 32바이트 - 블록의 해시. 대기 중인 블록인 경우 null.
  • parentHash: DATA, 32바이트 - 부모 블록의 해시.
  • nonce: DATA, 8바이트 - 생성된 작업증명 (PoW)의 해시. 대기 중인 블록인 경우 null, 지분 증명 (PoS) 블록인 경우 0x0 (머지 이후).
  • sha3Uncles: DATA, 32바이트 - 블록 내 엉클(uncles) 데이터의 SHA3.
  • logsBloom: DATA, 256바이트 - 블록의 로그를 위한 블룸 필터. 대기 중인 블록인 경우 null.
  • transactionsRoot: DATA, 32바이트 - 블록의 트랜잭션 트라이 루트.
  • stateRoot: DATA, 32바이트 - 블록의 최종 상태 트라이 루트.
  • receiptsRoot: DATA, 32바이트 - 블록의 영수증 트라이 루트.
  • miner: DATA, 20바이트 - 블록 보상을 받은 수혜자의 주소.
  • difficulty: QUANTITY - 이 블록의 난이도를 나타내는 정수.
  • totalDifficulty: QUANTITY - 이 블록까지 체인의 총 난이도를 나타내는 정수.
  • extraData: DATA - 이 블록의 "extra data(추가 데이터)" 필드.
  • size: QUANTITY - 이 블록의 크기(바이트 단위)를 나타내는 정수.
  • gasLimit: QUANTITY - 이 블록에서 허용되는 최대 가스.
  • gasUsed: QUANTITY - 이 블록의 모든 트랜잭션에서 사용된 총 가스.
  • timestamp: QUANTITY - 블록이 생성된 시점의 유닉스 타임스탬프.
  • transactions: Array - 마지막으로 주어진 매개변수에 따라 트랜잭션 객체의 배열 또는 32바이트 트랜잭션 해시의 배열.
  • uncles: Array - 엉클 해시의 배열.

예시

eth_getBlockByNumber

블록 번호로 블록에 대한 정보를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. QUANTITY|TAG - 블록 번호의 정수, 또는 블록 매개변수에 있는 문자열 "earliest", "latest", "pending", "safe" 또는 "finalized".
  2. Boolean - true인 경우 전체 트랜잭션 객체를 반환하고, false인 경우 트랜잭션의 해시만 반환합니다.
params: [
  "0x1b4", // 436
  true,
]

반환값 eth_getBlockByHash 참조

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'

결과는 eth_getBlockByHash 참조

eth_getTransactionByHash

트랜잭션 해시로 요청한 트랜잭션에 대한 정보를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. DATA, 32바이트 - 트랜잭션의 해시
params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]

반환값

Object - 트랜잭션 객체, 또는 트랜잭션을 찾을 수 없는 경우 null:

  • blockHash: DATA, 32바이트 - 이 트랜잭션이 포함된 블록의 해시. 대기 중(pending)인 경우 null.
  • blockNumber: QUANTITY - 이 트랜잭션이 포함된 블록 번호. 대기 중인 경우 null.
  • from: DATA, 20바이트 - 발신자의 주소.
  • gas: QUANTITY - 발신자가 제공한 가스.
  • gasPrice: QUANTITY - 발신자가 제공한 가스 가격(Wei 단위).
  • hash: DATA, 32바이트 - 트랜잭션의 해시.
  • input: DATA - 트랜잭션과 함께 전송된 데이터.
  • nonce: QUANTITY - 이 트랜잭션 이전에 발신자가 생성한 트랜잭션 수.
  • to: DATA, 20바이트 - 수신자의 주소. 컨트랙트 생성 트랜잭션인 경우 null.
  • transactionIndex: QUANTITY - 블록 내 트랜잭션 인덱스 위치의 정수. 대기 중인 경우 null.
  • value: QUANTITY - 전송된 값(Wei 단위).
  • v: QUANTITY - ECDSA 복구 ID
  • r: QUANTITY - ECDSA 서명 r
  • s: QUANTITY - ECDSA 서명 s

예시

eth_getTransactionByBlockHashAndIndex

블록 해시와 트랜잭션 인덱스 위치를 기반으로 트랜잭션에 대한 정보를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. DATA, 32바이트 - 블록의 해시입니다.
  2. QUANTITY - 트랜잭션 인덱스 위치의 정수입니다.
params: [
  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
  "0x0", // 0
]

반환값 eth_getTransactionByHash 참조

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'

결과는 eth_getTransactionByHash 참조

eth_getTransactionByBlockNumberAndIndex

블록 번호와 트랜잭션 인덱스 위치를 기반으로 트랜잭션에 대한 정보를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. QUANTITY|TAG - 블록 번호, 또는 블록 매개변수에서와 같은 "earliest", "latest", "pending", "safe" 또는 "finalized" 문자열.
  2. QUANTITY - 트랜잭션 인덱스 위치.
params: [
  "0x9c47cf", // 10241999
  "0x24", // 36
]

반환값 eth_getTransactionByHash 참조

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x9c47cf", "0x24"],"id":1}'

결과는 eth_getTransactionByHash 참조

eth_getTransactionReceipt

트랜잭션 해시로 트랜잭션의 영수증을 반환합니다.

참고 대기 중인 트랜잭션에 대해서는 영수증을 사용할 수 없습니다.

매개변수

  1. DATA, 32바이트 - 트랜잭션의 해시
params: ["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"]

반환값 Object - 트랜잭션 영수증 객체, 또는 영수증을 찾을 수 없는 경우 null:

  • transactionHash : DATA, 32바이트 - 트랜잭션의 해시.
  • transactionIndex: QUANTITY - 블록 내 트랜잭션의 인덱스 위치를 나타내는 정수.
  • blockHash: DATA, 32바이트 - 이 트랜잭션이 포함된 블록의 해시.
  • blockNumber: QUANTITY - 이 트랜잭션이 포함된 블록 번호.
  • from: DATA, 20바이트 - 발신자의 주소.
  • to: DATA, 20바이트 - 수신자의 주소. 컨트랙트 생성 트랜잭션인 경우 null입니다.
  • cumulativeGasUsed : QUANTITY - 이 트랜잭션이 블록에서 실행될 때 사용된 가스의 총량.
  • effectiveGasPrice : QUANTITY - 가스 단위당 지불된 기본 수수료와 팁의 합계.
  • gasUsed : QUANTITY - 이 특정 트랜잭션에서만 사용된 가스의 양.
  • contractAddress : DATA, 20바이트 - 트랜잭션이 컨트랙트 생성인 경우 생성된 컨트랙트 주소, 그렇지 않으면 null입니다.
  • logs: Array - 이 트랜잭션이 생성한 로그 객체의 배열.
  • logsBloom: DATA, 256바이트 - 경량 클라이언트가 관련 로그를 빠르게 검색할 수 있도록 하는 블룸 필터(Bloom filter).
  • type: QUANTITY - 트랜잭션 유형을 나타내는 정수. 레거시 트랜잭션의 경우 0x0, 액세스 목록 유형의 경우 0x1, 동적 수수료의 경우 0x2입니다.

또한 다음 중 하나를 반환합니다:

  • root : DATA 트랜잭션 후 상태 루트의 32바이트 (비잔티움 이전)
  • status: QUANTITY 1(성공) 또는0` (실패)

예시

eth_getUncleByBlockHashAndIndex

해시와 엉클 인덱스 위치를 통해 블록의 엉클에 대한 정보를 반환합니다.

플레이그라운드에서 엔드포인트 테스트하기 (opens in a new tab)

매개변수

  1. DATA, 32바이트 - 블록의 해시입니다.
  2. QUANTITY - 엉클의 인덱스 위치입니다.
params: [
  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
  "0x0", // 0
]

반환값 eth_getBlockByHash 참조

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'

결과는 eth_getBlockByHash 참조

참고: 엉클에는 개별 트랜잭션이 포함되지 않습니다.

eth_getUncleByBlockNumberAndIndex

블록 번호와 엉클 인덱스 위치를 기반으로 블록의 엉클에 대한 정보를 반환합니다.

플레이그라운드에서 엔드포인트 사용해 보기 (opens in a new tab)

매개변수

  1. QUANTITY|TAG - 블록 번호, 또는 블록 매개변수와 같은 "earliest", "latest", "pending", "safe", "finalized" 문자열.
  2. QUANTITY - 엉클의 인덱스 위치.
params: [
  "0x29c", // 668
  "0x0", // 0
]

반환값 eth_getBlockByHash 참조

참고: 엉클은 개별 트랜잭션을 포함하지 않습니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'

결과는 eth_getBlockByHash 참조

eth_newFilter

필터 옵션을 기반으로 상태가 변경(로그)될 때 알림을 보내는 필터 객체를 생성합니다. 상태가 변경되었는지 확인하려면 eth_getFilterChanges를 호출하세요.

토픽 필터 지정에 대한 참고 사항: 토픽은 순서에 의존합니다. 토픽 [A, B]가 포함된 로그가 있는 트랜잭션은 다음 토픽 필터와 일치합니다.

  • [] "모든 것"
  • [A] "첫 번째 위치에 A (그리고 그 이후에는 모든 것)"
  • [null, B] "첫 번째 위치에 모든 것 그리고 두 번째 위치에 B (그리고 그 이후에는 모든 것)"
  • [A, B] "첫 번째 위치에 A 그리고 두 번째 위치에 B (그리고 그 이후에는 모든 것)"
  • [[A, B], [A, B]] "첫 번째 위치에 (A 또는 B) 그리고 두 번째 위치에 (A 또는 B) (그리고 그 이후에는 모든 것)"
  • 매개변수
  1. Object - 필터 옵션:
  • fromBlock: QUANTITY|TAG - (선택 사항, 기본값: "latest") 정수 블록 번호, 또는 마지막으로 제안된 블록의 경우 "latest", 가장 최근의 안전한 블록의 경우 "safe", 가장 최근의 완결된 블록의 경우 "finalized", 또는 아직 블록에 포함되지 않은 트랜잭션의 경우 "pending", "earliest".
  • toBlock: QUANTITY|TAG - (선택 사항, 기본값: "latest") 정수 블록 번호, 또는 마지막으로 제안된 블록의 경우 "latest", 가장 최근의 안전한 블록의 경우 "safe", 가장 최근의 완결된 블록의 경우 "finalized", 또는 아직 블록에 포함되지 않은 트랜잭션의 경우 "pending", "earliest".
  • address: DATA|Array, 20바이트 - (선택 사항) 로그가 발생해야 하는 컨트랙트 주소 또는 주소 목록.
  • topics: Array of DATA, - (선택 사항) 32바이트 DATA 토픽의 배열. 토픽은 순서에 의존합니다. 각 토픽은 "또는(or)" 옵션이 있는 DATA 배열일 수도 있습니다.

반환값 QUANTITY - 필터 ID.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_newBlockFilter

새로운 블록이 도착할 때 알림을 받도록 노드에 필터를 생성합니다. 상태가 변경되었는지 확인하려면 eth_getFilterChanges를 호출하세요.

매개변수 없음

반환값 QUANTITY - 필터 ID입니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":73}'
// 결과
{
  "id":1,
  "jsonrpc":  "2.0",
  "result": "0x1" // 1
}

eth_newPendingTransactionFilter

새로운 대기 중인 트랜잭션이 도착할 때 알리도록 노드에 필터를 생성합니다. 상태가 변경되었는지 확인하려면 eth_getFilterChanges를 호출하세요.

매개변수 없음

반환값 QUANTITY - 필터 ID입니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":73}'
// 결과
{
  "id":1,
  "jsonrpc":  "2.0",
  "result": "0x1" // 1
}

eth_uninstallFilter

주어진 id의 필터를 제거합니다. 더 이상 감시가 필요하지 않을 때 항상 호출해야 합니다. 또한 일정 기간 동안 eth_getFilterChanges를 통해 요청되지 않으면 필터는 시간 초과됩니다.

매개변수

  1. QUANTITY - 필터 id.
params: [
  "0xb", // 11
]

반환값 Boolean - 필터가 성공적으로 제거된 경우 true, 그렇지 않은 경우 false입니다.

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'
// 결과
{
  "id":1,
  "jsonrpc": "2.0",
  "result": true
}

eth_getFilterChanges

마지막 폴링 이후 발생한 로그의 배열을 반환하는 필터용 폴링 메서드입니다.

매개변수

  1. QUANTITY - 필터 ID입니다.
params: [
  "0x16", // 22
]

반환값 Array - 로그 객체의 배열, 또는 마지막 폴링 이후 변경된 사항이 없으면 빈 배열입니다.

  • eth_newBlockFilter로 생성된 필터의 경우 반환값은 블록 해시(DATA, 32바이트)입니다(예: ["0x3454645634534..."]).

  • eth_newPendingTransactionFilter 로 생성된 필터의 경우 반환값은 트랜잭션 해시(DATA, 32바이트)입니다(예: ["0x6345343454645..."]).

  • eth_newFilter로 생성된 필터의 경우 로그는 다음 매개변수를 가진 객체입니다.

    • removed: TAG - 체인 재구성으로 인해 로그가 제거된 경우 true입니다. 유효한 로그일 경우 false입니다.
    • logIndex: QUANTITY - 블록 내 로그 인덱스 위치의 정수입니다. 대기 중인 로그일 경우 null입니다.
    • transactionIndex: QUANTITY - 로그가 생성된 트랜잭션 인덱스 위치의 정수입니다. 대기 중인 로그일 경우 null입니다.
    • transactionHash: DATA, 32바이트 - 이 로그가 생성된 트랜잭션의 해시입니다. 대기 중인 로그일 경우 null입니다.
    • blockHash: DATA, 32바이트 - 이 로그가 포함된 블록의 해시입니다. 대기 중일 경우 null입니다. 대기 중인 로그일 경우 null입니다.
    • blockNumber: QUANTITY - 이 로그가 포함된 블록 번호입니다. 대기 중일 경우 null입니다. 대기 중인 로그일 경우 null입니다.
    • address: DATA, 20바이트 - 이 로그가 발생한 주소입니다.
    • data: DATA - 가변 길이의 인덱싱되지 않은 로그 데이터입니다. (Solidity의 경우: 0개 이상의 32바이트 인덱싱되지 않은 로그 인수입니다.)
    • topics: Array of DATA - 인덱싱된 로그 인수의 0~4개 32바이트 DATA 배열입니다. (Solidity의 경우: 이벤트를 anonymous 지정자로 선언하지 않은 이상, 첫 번째 주제는 이벤트 서명의 해시입니다(예: Deposit(address,bytes32,uint256)).)

  • 예시

eth_getFilterLogs

주어진 ID를 가진 필터와 일치하는 모든 로그의 배열을 반환합니다.

매개변수

  1. QUANTITY - 필터 ID입니다.
params: [
  "0x16", // 22
]

반환값 eth_getFilterChanges 참조

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'

결과는 eth_getFilterChanges 참조

eth_getLogs

주어진 필터 객체와 일치하는 모든 로그의 배열을 반환합니다.

매개변수

  1. Object - 필터 옵션:
  • fromBlock: QUANTITY|TAG - (선택 사항, 기본값: "latest") 정수 블록 번호, 또는 마지막으로 제안된 블록의 경우 "latest", 최신 안전 블록의 경우 "safe", 최신 완결된 블록의 경우 "finalized", 아직 블록에 포함되지 않은 트랜잭션의 경우 "pending", "earliest".
  • toBlock: QUANTITY|TAG - (선택 사항, 기본값: "latest") 정수 블록 번호, 또는 마지막으로 제안된 블록의 경우 "latest", 최신 안전 블록의 경우 "safe", 최신 완결된 블록의 경우 "finalized", 아직 블록에 포함되지 않은 트랜잭션의 경우 "pending", "earliest".
  • address: DATA|Array, 20 Bytes - (선택 사항) 로그가 발생해야 하는 컨트랙트 주소 또는 주소 목록입니다.
  • topics: Array of DATA, - (선택 사항) 32 Bytes DATA 토픽의 배열입니다. 토픽은 순서에 의존합니다. 각 토픽은 "or" 옵션이 있는 DATA 배열일 수도 있습니다.
  • blockHash: DATA, 32 Bytes - (선택 사항, 예정) EIP-234가 추가됨에 따라, blockHash는 반환되는 로그를 32바이트 해시 blockHash를 가진 단일 블록으로 제한하는 새로운 필터 옵션이 될 것입니다. blockHash를 사용하는 것은 fromBlock = toBlock = 해시가 blockHash인 블록 번호와 같습니다. 필터 기준에 blockHash가 존재하면 fromBlock 및 toBlock는 모두 허용되지 않습니다.
params: [
  {
    topics: [
      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
    ],
  },
]

반환값 eth_getFilterChanges 참조

예시

// 요청
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":74}'

결과는 eth_getFilterChanges 참조

사용 예시

JSON-RPC를 사용한 컨트랙트 배포

이 섹션에서는 RPC 인터페이스만을 사용하여 컨트랙트를 배포하는 방법을 보여줍니다. 이러한 복잡성을 추상화하여 컨트랙트를 배포하는 대안적인 방법도 있습니다. 예를 들어, RPC 인터페이스 위에 구축된 Web3.js (opens in a new tab) 및 Web3.py (opens in a new tab)와 같은 라이브러리를 사용하는 것입니다. 이러한 추상화는 일반적으로 이해하기 쉽고 오류가 발생할 확률이 적지만, 내부적으로 어떤 일이 일어나는지 이해하는 것은 여전히 도움이 됩니다.

다음은 JSON-RPC 인터페이스를 사용하여 이더리움 노드에 배포될 Multiply7라는 간단한 스마트 컨트랙트입니다. 이 튜토리얼은 독자가 이미 Geth 노드를 실행하고 있다고 가정합니다. 노드 및 클라이언트에 대한 자세한 정보는 여기에서 확인할 수 있습니다. Geth 이외의 클라이언트에서 HTTP JSON-RPC를 시작하는 방법은 개별 클라이언트 문서를 참조하세요. 대부분의 클라이언트는 기본적으로 localhost:8545에서 서비스를 제공합니다.

contract Multiply7 {
    event Print(uint);
    function multiply(uint input) returns (uint) {
        Print(input * 7);
        return input * 7;
    }
}

가장 먼저 해야 할 일은 HTTP RPC 인터페이스가 활성화되어 있는지 확인하는 것입니다. 즉, 시작할 때 Geth에 --http 플래그를 제공해야 합니다. 이 예시에서는 프라이빗 개발 체인에서 Geth 노드를 사용합니다. 이 접근 방식을 사용하면 실제 네트워크의 이더가 필요하지 않습니다.

geth --http --dev console 2>>geth.log

이렇게 하면 http://localhost:8545에서 HTTP RPC 인터페이스가 시작됩니다.

curl (opens in a new tab)을 사용하여 코인베이스 주소(계정 배열에서 첫 번째 주소를 가져옴)와 잔액을 조회함으로써 인터페이스가 실행 중인지 확인할 수 있습니다. 이 예시의 데이터는 로컬 노드마다 다를 수 있다는 점에 유의하세요. 이 명령을 시도해 보려면 두 번째 curl 요청의 요청 매개변수를 첫 번째 요청에서 반환된 결과로 바꾸세요.

curl --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[], "id":1}' -H "Content-Type: application/json" localhost:8545
{"id":1,"jsonrpc":"2.0","result":["0x9b1d35635cc34752ca54713bb99d38614f63c955"]}

curl --data '{"jsonrpc":"2.0","method":"eth_getBalance", "params": ["0x9b1d35635cc34752ca54713bb99d38614f63c955", "latest"], "id":2}' -H "Content-Type: application/json" localhost:8545
{"id":2,"jsonrpc":"2.0","result":"0x1639e49bba16280000"}

숫자는 16진수로 인코딩되므로 잔액은 16진수 문자열 형태의 Wei로 반환됩니다. 잔액을 이더 단위의 숫자로 확인하려면 Geth 콘솔에서 web3를 사용할 수 있습니다.

web3.fromWei("0x1639e49bba16280000", "ether")
// "410"

이제 프라이빗 개발 체인에 약간의 이더가 있으므로 컨트랙트를 배포할 수 있습니다. 첫 번째 단계는 Multiply7 컨트랙트를 EVM으로 보낼 수 있는 바이트코드로 컴파일하는 것입니다. Solidity 컴파일러인 solc를 설치하려면 Solidity 문서 (opens in a new tab)를 따르세요. (예시에서 사용된 컴파일러 버전 (opens in a new tab)과 일치시키기 위해 이전 solc 릴리스를 사용하고 싶을 수도 있습니다.)

다음 단계는 Multiply7 컨트랙트를 EVM으로 보낼 수 있는 바이트코드로 컴파일하는 것입니다.

echo 'pragma solidity ^0.4.16; contract Multiply7 { event Print(uint); function multiply(uint input) public returns (uint) { Print(input * 7); return input * 7; } }' | solc --bin

======= <stdin>:Multiply7 =======
Binary:
6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029

이제 컴파일된 코드가 있으므로 이를 배포하는 데 가스가 얼마나 드는지 확인해야 합니다. RPC 인터페이스에는 예상치를 제공하는 eth_estimateGas 메서드가 있습니다.

curl --data '{"jsonrpc":"2.0","method": "eth_estimateGas", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 5}' -H "Content-Type: application/json" localhost:8545
{"jsonrpc":"2.0","id":5,"result":"0x1c31e"}

그리고 마지막으로 컨트랙트를 배포합니다.

curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "gas": "0x1c31e", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 6}' -H "Content-Type: application/json" localhost:8545
{"id":6,"jsonrpc":"2.0","result":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"}

트랜잭션이 노드에서 수락되고 트랜잭션 해시가 반환됩니다. 이 해시를 사용하여 트랜잭션을 추적할 수 있습니다. 다음 단계는 컨트랙트가 배포된 주소를 확인하는 것입니다. 실행된 각 트랜잭션은 영수증을 생성합니다. 이 영수증에는 트랜잭션이 포함된 블록과 EVM에서 사용한 가스 양 등 트랜잭션에 대한 다양한 정보가 포함되어 있습니다. 트랜잭션이 컨트랙트를 생성하는 경우 컨트랙트 주소도 포함됩니다. eth_getTransactionReceipt RPC 메서드를 사용하여 영수증을 조회할 수 있습니다.

curl --data '{"jsonrpc":"2.0","method": "eth_getTransactionReceipt", "params": ["0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"], "id": 7}' -H "Content-Type: application/json" localhost:8545
{"jsonrpc":"2.0","id":7,"result":{"blockHash":"0x77b1a4f6872b9066312de3744f60020cbd8102af68b1f6512a05b7619d527a4f","blockNumber":"0x1","contractAddress":"0x4d03d617d700cf81935d7f797f4e2ae719648262","cumulativeGasUsed":"0x1c31e","from":"0x9b1d35635cc34752ca54713bb99d38614f63c955","gasUsed":"0x1c31e","logs":[],"logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","status":"0x1","to":null,"transactionHash":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf","transactionIndex":"0x0"}}

컨트랙트가 0x4d03d617d700cf81935d7f797f4e2ae719648262에 생성되었습니다. 영수증 대신 null 결과가 반환되면 트랜잭션이 아직 블록에 포함되지 않았음을 의미합니다. 잠시 기다렸다가 합의 클라이언트가 실행 중인지 확인하고 다시 시도하세요.

스마트 컨트랙트와 상호작용하기

이 예시에서는 eth_sendTransaction를 사용하여 컨트랙트의 multiply 메서드로 트랜잭션을 보냅니다.

eth_sendTransaction에는 여러 인수, 특히 from, to 및 data가 필요합니다. From는 계정의 공개 주소이고, to는 컨트랙트 주소입니다. data 인수에는 호출해야 할 메서드와 인수를 정의하는 페이로드가 포함되어 있습니다. 여기서 ABI(애플리케이션 바이너리 인터페이스) (opens in a new tab)가 사용됩니다. ABI는 EVM을 위해 데이터를 정의하고 인코딩하는 방법을 정의하는 JSON 파일입니다.

페이로드의 바이트는 컨트랙트에서 호출되는 메서드를 정의합니다. 이는 함수 이름과 인수 유형에 대한 Keccak 해시의 처음 4바이트를 16진수로 인코딩한 것입니다. multiply 함수는 uint256의 별칭인 uint를 허용합니다. 따라서 다음과 같이 됩니다.

web3.sha3("multiply(uint256)").substring(0, 10)
// "0xc6888fa1"

다음 단계는 인수를 인코딩하는 것입니다. uint256이 하나만 있으며, 예를 들어 값은 6입니다. ABI에는 uint256 유형을 인코딩하는 방법을 지정하는 섹션이 있습니다.

int<M>: enc(X)는 X의 빅 엔디언 2의 보수 인코딩으로, 길이가 32바이트의 배수가 되도록 음수 X의 경우 상위(왼쪽)에 0xff로 패딩하고 양수 X의 경우 0바이트로 패딩합니다.

이는 0000000000000000000000000000000000000000000000000000000000000006로 인코딩됩니다.

함수 선택자와 인코딩된 인수를 결합하면 데이터는 0xc6888fa10000000000000000000000000000000000000000000000000000000000000006가 됩니다.

이제 이를 노드로 보낼 수 있습니다.

curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0xeb85a5557e5bdc18ee1934a89d8bb402398ee26a", "to": "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d", "data": "0xc6888fa10000000000000000000000000000000000000000000000000000000000000006"}], "id": 8}' -H "Content-Type: application/json" localhost:8545
{"id":8,"jsonrpc":"2.0","result":"0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74"}

트랜잭션이 전송되었으므로 트랜잭션 해시가 반환되었습니다. 영수증을 조회하면 다음과 같습니다.

영수증에는 로그가 포함되어 있습니다. 이 로그는 트랜잭션 실행 시 EVM에 의해 생성되어 영수증에 포함되었습니다. multiply 함수는 입력값에 7을 곱한 값으로 Print 이벤트가 발생했음을 보여줍니다. Print 이벤트의 인수가 uint256이었으므로 ABI 규칙에 따라 디코딩할 수 있으며, 예상되는 10진수 42를 얻게 됩니다. 데이터 외에도 토픽을 사용하여 어떤 이벤트가 로그를 생성했는지 확인할 수 있다는 점에 주목할 가치가 있습니다.

web3.sha3("Print(uint256)")
// "24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"

이것은 JSON-RPC의 직접적인 사용을 보여주는 가장 일반적인 작업 중 일부에 대한 간단한 소개였습니다.