EIP-7966 동기식 트랜잭션 전송 메서드 (eth_sendRawTransactionSync Method)

콜 결정 없음 · 네트워크·노드 · 원문 상태 Draft · 2025-06-11 작성

서명된 트랜잭션을 보내고 처리 결과인 영수증(receipt)까지 한 번의 호출로 받는 새 JSON-RPC 메서드 eth_sendRawTransactionSync를 추가합니다.

왜 필요한가

지금은 트랜잭션을 보낼 때 eth_sendRawTransaction을 씁니다. 이 메서드는 트랜잭션 해시만 바로 돌려주고 실제로 처리됐는지 확인하려면 앱이 영수증이 나올 때까지 따로 반복 조회해야 합니다. 이 반복 조회는 네트워크 부담과 지연을 키우고 앱 코드를 복잡하게 만듭니다. 블록 생성이 빠른 체인이나 레이어 2에서는 트랜잭션이 블록 생산자에게 닿자마자 영수증이 준비되는 경우가 많은데도, 조회를 한 번 더 해야 해서 불필요한 지연이 생깁니다. 또 논스 갭이나 잔액 부족처럼 트랜잭션이 바로 실행될 수 없는 상황에서는 지금의 에러 메시지가 원인을 알려주지 않아, 개발자가 계정 상태를 확인하는 추가 호출을 또 해야 합니다. 이 제안은 전송과 영수증 수신을 한 번의 호출로 합쳐 이런 왕복을 줄이고 전체 전송·확인 지연을 약 50% 줄이는 것을 목표로 합니다.

무엇이 바뀌나

지금

EIP-7966 이후

누구에게 영향이 있나

심층 설명

메서드 이름과 파라미터

메서드 이름은 eth_sendRawTransactionSync입니다. 첫 번째 파라미터는 DATA 타입의 서명된 트랜잭션으로, eth_sendRawTransaction과 같은 hex 인코딩 RLP 인코딩 형식이어야 합니다(MUST). 두 번째 파라미터는 선택 사항인 INT 타입의 최대 대기 시간(밀리초)입니다. 타임아웃은 양의 정수이면서 노드가 설정한 최대 타임아웃을 넘지 않아야 합니다(MUST). 타임아웃 파라미터가 들어오면 핸들러는 유효성을 검증해야 하고 유효하지 않으면 노드 기본 타임아웃을 사용해야 합니다(MUST).

반환값과 에러 코드 4·5·6

성공 시 노드는 eth_getTransactionReceipt가 정의하는 트랜잭션 영수증 객체를 반환해야 합니다(MUST). 전용 에러 코드는 세 가지입니다. 코드 4(Timeout)는 트랜잭션이 멤풀에 들어갔지만 타임아웃 안에 처리되지 않은 경우로, data에 트랜잭션 해시를 담습니다. 코드 5(Unknown/Queued)는 즉시 실행할 준비가 안 되어 멤풀에 추가되지 않은 경우로, data에 트랜잭션 해시를 담습니다. 코드 6(Nonce Gap)은 논스 갭으로 멤풀에 추가되지 않은 경우로, data에 기대 논스를 hex 문자열(예: "0x5")로 담습니다. 그 밖의 표준 에러는 기존 RPC 에러 형식을 따라야 합니다(MUST).

처리 절차

핸들러는 트랜잭션을 멤풀에 추가하기 전에 즉시 실행 가능한지 먼저 확인해야 합니다(MUST). 트랜잭션 논스가 기대 논스보다 높은 논스 갭이면 멤풀에 넣지 않고 코드 6과 기대 논스를 반환해야 하고 그 밖의 이유로 대기 상태가 되는 경우에도 멤풀에 넣지 않고 코드 5를 반환해야 합니다(MUST). 즉시 실행 가능하면 기존 eth_sendRawTransaction 의미론대로 멤풀에 제출하고 타임아웃이 끝날 때까지 영수증을 기다립니다. 영수증을 찾으면 즉시 반환하고 타임아웃이 지나면 코드 4와 트랜잭션 해시를 반환해야 합니다(MUST). 트랜잭션 데이터가 잘못되는 등 제출 자체가 실패하면 eth_sendRawTransaction 정의를 따르는 에러를 즉시 반환합니다.

타임아웃 설정

핸들러는 영수증을 기다릴 때 설정 가능한 타임아웃을 두는 것이 좋고(SHOULD), 권장 기본값은 2초입니다(RECOMMENDED). 노드 구현은 타임아웃 길이를 설정할 수단을 제공하는 것이 좋고(SHOULD), 노드 운영자는 실시간 네트워크 상황에 따라 타임아웃을 동적으로 조정할 수 있습니다(MAY). 사용자가 넘기는 선택적 타임아웃 파라미터는 앱이 자기 지연 요구에 맞게 최대 대기 시간을 정할 수 있게 하면서 RPC 호출이 무한정 블로킹되는 것을 막습니다.

별도 메서드로 만든 이유와 적용 범위

기존 eth_sendRawTransaction을 고쳐 이 동작을 넣으면 호환성 문제와 의미 모호성이 생길 수 있어, 별도 메서드로 만들어 의미를 명시적이고 선택적(opt-in)으로 했습니다. 이 메서드는 기존 비동기 전송 메서드를 대체하거나 바꾸지 않으며 구현하지 않은 노드도 기존 방식으로 정상 동작합니다. 원문은 블록 생성이 빠르고 네트워크 지연이 낮은 EVM 호환 체인이나 L2에 특히 적합하고 샤딩 이전 이더리움 메인넷처럼 지연이 크거나 느린 체인에서는 동기 대기가 호출 시간을 늘리거나 타임아웃을 유발해 실용성이 떨어진다고 밝힙니다.

논스 갭 에러에 기대 논스를 담는 설계

논스 갭으로 거부될 때 코드 6의 data 필드에 기대 논스를 hex 문자열로 돌려줍니다. 앱이 에러 응답에서 바로 올바른 논스를 얻으므로 별도의 eth_getTransactionCount 호출이 필요 없고 계정 상태를 조회하는 추가 왕복 없이 곧바로 올바른 논스로 트랜잭션을 다시 만들어 제출할 수 있습니다. 이 경우 트랜잭션이 멤풀에 추가된 적이 없으므로 트랜잭션 해시는 반환하지 않습니다.

구현 방식과 보안 고려

최소 구현은 기존 eth_sendRawTransaction 제출을 감싸고 타임아웃이 끝날 때까지 해당 영수증을 기다리는 로직을 더하면 됩니다. 영수증 가용성을 이벤트 알림으로 받거나, 짧은 간격으로 eth_getTransactionReceipt를 폴링하는 방식 모두 가능합니다(MAY). 원문은 reth용 핸들러 예시 코드를 싣고 go-ethereum 같은 구현은 폴링 대신 채널로 영수증 도착을 알릴 수 있다고 적습니다. 보안 측면에서는 트랜잭션 제출에 내재한 위험 외의 새 위험을 만들지 않고 노드 타임아웃이 무한 블로킹을 막습니다. 다만 구현이 성능을 떨어뜨리거나 서비스 거부를 일으키지 않도록 노드가 보장해야 합니다.

제안 상태

이 EIP는 Standards Track의 Interface 범주이고 현재 상태는 Draft입니다. 아직 초안 단계라 메서드 동작, 에러 코드, 권장 값이 바뀔 수 있습니다. 합의 규칙을 바꾸지 않는 새 RPC 메서드 추가이므로 기존 메서드를 수정하거나 폐기하지 않으며 eth_sendRawTransaction을 쓰는 기존 앱은 영향을 받지 않습니다. 코어 개발자 콜에서 포크 포함이 논의된 기록은 자료에 없습니다.

EIP 원문 · ← EIPs