EIP-8072 트랜잭션 포함 구독 (Transaction Inclusion Subscription)
콜 결정 없음 · 네트워크·노드 · 원문 상태 Draft · 2025-10-31 작성
노드의 구독 기능(eth_subscribe)에 transactionInclusion 타입을 추가해 트랜잭션이 블록에 포함되는 순간 실시간 알림과 영수증을 받게 합니다.
왜 필요한가
지금은 트랜잭션을 보낸 뒤 결과를 알려면 두 단계를 거칩니다. 먼저 eth_sendRawTransaction으로 제출하고 그다음 영수증 조회(eth_getTransactionReceipt)를 반복해서 호출하며 포함됐는지 확인합니다. 이런 반복 조회(폴링)는 불필요한 지연과 네트워크 부담을 일으킵니다. 이를 풀려고 제안된 EIP-7966의 eth_sendRawTransactionSync는 포함될 때까지 응답을 기다리는 동기 방식인데, 여기에는 다른 비용이 따릅니다. 트랜잭션 하나마다 HTTP 연결 하나가 묶이고 연결 하나로 여러 트랜잭션을 지켜볼 수 없으며 체인마다 다른 블록 시간에 맞춰 타임아웃을 조정해야 합니다. 이 EIP는 이미 모든 주요 클라이언트에 구현되어 검증된 구독 방식을 확장해서 연결을 막지 않고 포함 알림을 받는 방법을 제시합니다. 제출과 모니터링을 한 번의 호출로 묶을 수도 있고 이미 제출된 트랜잭션을 해시로 지켜볼 수도 있습니다.
무엇이 바뀌나
지금
- 트랜잭션을 제출한 뒤 영수증 조회를 반복 호출해 포함 여부를 확인합니다
- 동기 방식(EIP-7966)은 확인이 끝날 때까지 HTTP 연결 하나를 통째로 점유합니다
- 여러 트랜잭션을 지켜보려면 그만큼 폴링 횟수나 연결 수가 늘어납니다
EIP-8072 이후
- 구독 한 번으로 트랜잭션이 블록에 포함되는 순간 알림과 영수증을 받습니다
- 웹소켓 연결 하나로 여러 트랜잭션을 동시에 지켜봅니다
- 제출과 모니터링을 한 번의 호출로 끝낼 수 있습니다
- 원하면 리오그 발생과 블록 확정까지 이어서 추적합니다
누구에게 영향이 있나
- 지갑·앱 개발자: 영수증 폴링 코드를 걷어내고 구독 알림 하나로 트랜잭션 확인 흐름을 만들 수 있습니다.
- 클라이언트 팀: 기존 eth_subscribe 구현 위에 transactionInclusion 구독 타입과 자동 해지 로직을 추가해야 합니다.
- RPC 노드 운영자: 반복 폴링과 연결 점유가 줄어 대역폭과 서버 자원 부담이 가벼워집니다.
심층 설명
새 구독 타입과 파라미터
eth_subscribe에 transactionInclusion 구독 타입을 추가합니다. 파라미터 객체는 세 필드를 받습니다. transaction(DATA, 선택)은 제출과 동시에 모니터링할 서명된 트랜잭션 데이터이고 이 필드가 오면 노드는 즉시 네트워크에 제출해야 합니다. hash(DATA 32바이트, 선택)는 이미 제출된 트랜잭션을 지켜볼 때 쓰는 해시입니다. includeReorgs(boolean, 선택, 기본값 false)는 리오그 모니터링 여부를 정합니다. transaction과 hash는 정확히 하나만 제공해야 하며 둘 다 주거나 둘 다 빠지면 노드는 JSON-RPC 오류 코드 -32602(Invalid params)를 반환해야 합니다.
알림 형식과 status 값
상태가 바뀌면 노드는 eth_subscription 알림을 보냅니다. result에는 status, blockHash, blockNumber, transactionIndex, receipt가 들어가고 receipt는 eth_getTransactionReceipt가 정의하는 완전한 영수증 객체여야 합니다. status는 세 가지입니다. "included"는 블록에 포함됐다는 뜻이고 "finalized"는 그 블록이 확정에 도달했다는 뜻이며 "reorged"는 리오그로 정식 체인에서 빠졌음을 나타냅니다. "finalized"와 "reorged"는 includeReorgs가 true일 때만 전송됩니다.
노드 동작 규칙
transaction이 제공되면 노드는 eth_sendRawTransaction과 같은 의미론으로 즉시 제출하고 해시를 유도해 모니터링을 시작합니다. 제출이 실패하면 오류를 반환하고 구독을 만들지 않아야 합니다. 구독 시점에 트랜잭션이 이미 블록에 포함되어 있으면 즉시 포함 알림을 보냅니다. 이때 includeReorgs가 false면 바로 해지하고 true면 확정까지 계속 지켜봅니다. 아직 펜딩이면 트랜잭션 풀과 정식 체인을 모니터링하다가 포함 시점에 알림을 보냅니다. hash로 지켜보는 트랜잭션이 멤풀에도 체인에도 없으면 구독은 유지되고 노드는 나중에 나타나는지 지켜보는 것이 권장되며 클라이언트가 원하면 직접 해지할 수 있습니다.
리오그 모니터링과 자동 해지
includeReorgs가 true이면 첫 포함 이후에도 모니터링이 이어집니다. 리오그로 트랜잭션이 정식 체인에서 빠지면 "reorged" 알림을, 다른 블록에 다시 포함되면 새 "included" 알림을 보내고 블록이 확정에 이르면 "finalized" 알림을 보낸 뒤 자동으로 해지합니다. 두 모드 모두 자동 해지하는 이유는 구독이 무한정 쌓이는 것을 막고 수명 주기를 분명히 하기 위해서입니다. false 모드는 빠른 피드백용이고 포함 뒤에도 리오그될 수 있다는 점을 사용자가 감수하는 선택이며 true 모드는 리오그가 더는 불가능해지는 확정까지 전체 수명 주기를 추적합니다.
EIP-7966 동기 방식과의 비교
원문은 구독 방식의 장점으로 네 가지를 듭니다. 연결을 막지 않아 대기 중에도 다른 작업을 할 수 있고 웹소켓 연결 하나로 여러 트랜잭션을 다중화할 수 있으며 확인 시간이 들쭉날쭉해도 타임아웃 파라미터가 필요 없고 모든 주요 클라이언트에 이미 있는 eth_subscribe 기반이라 구현 부담이 작습니다. transaction 파라미터를 추가해서 제출과 모니터링을 한 호출로 묶으면 eth_sendRawTransactionSync와 완전한 기능 동등성을 갖춥니다. 동기 방식은 트랜잭션마다 블로킹 HTTP 연결이 하나씩 필요하지만 구독은 연결 하나로 동시 구독 수에 제한이 없습니다.
보안과 프라이버시 고려사항
transaction이 제공되면 노드는 구독을 만들기 전에 eth_sendRawTransaction과 같은 검증을 수행해야 하고 유효하지 않은 트랜잭션은 구독 생성 없이 오류로 끝나야 합니다. 해시로 모니터링하는 것은 기존 영수증 폴링보다 새로운 프라이버시 문제를 만들지 않지만 어떤 해시를 구독하는지가 노드 운영자에게 그 트랜잭션에 대한 관심을 드러낸다는 점은 알아 둘 필요가 있습니다. includeReorgs를 쓰는 앱은 리오그 알림을 처리하는 로직을 갖춰야 하며 알림은 투명성을 줄 뿐 리오그 기반 공격 자체를 막아 주지는 않습니다.
하위 호환성과 진행 상태
기존 eth_subscribe에 구독 타입 하나를 더하는 것이라 완전히 하위 호환됩니다. 이 기능이 없는 클라이언트는 지원하지 않는 구독 타입이라는 표준 JSON-RPC 오류를 반환하고 기존 애플리케이션은 그대로 동작합니다. 이 EIP는 2025년 10월 31일에 만들어진 인터페이스 표준이며 현재 상태가 Draft라서 명세가 아직 바뀔 수 있습니다.