이더리움 트랜잭션 오류 해설: 각 메시지의 뜻과 해결 방법

1. 이 오류 메시지는 어디서 올까?

거의 모든 지갑, 라이브러리, RPC 제공자는 가장 널리 운영되는 이더리움 클라이언트인 go-ethereum이 만들어 내는 오류 문구를 그대로 전달하며, 레이어 2 네트워크의 클라이언트도 같은 문자열을 재사용합니다. MetaMask는 이를 자체 대화상자로 감싸고, ethers.js는 NONCE_EXPIRED나 REPLACEMENT_UNDERPRICED 같은 코드를 덧붙이며, RPC 제공자는 코드 -32000의 JSON-RPC 오류로 돌려줍니다. 그 밑에 있는 메시지는 같습니다.

노드는 서로 다른 두 종류의 검사를 합니다. 첫 번째는 트랜잭션을 받는 시점에 이루어집니다. nonce가 맞는지, 수수료가 받아들일 만한지, 가스 한도가 정상인지, 보내는 쪽이 지불할 수 있는지. 여기서 실패한 트랜잭션은 버려지고 온체인에는 아무것도 기록되지 않습니다. 두 번째는 트랜잭션이 블록 안에서 실행될 때 이루어집니다. 컨트랙트 코드가 revert 없이 가스 한도 안에서 완료되는지. 여기서 실패한 트랜잭션은 그래도 채굴되어 익스플로러에 Fail 상태로 표시되고, 수수료는 소모됩니다.

오류가 어느 부류에 속하는지 알면 두 가지를 한 번에 알 수 있습니다. 돈을 잃었는지, 그리고 고칠 곳이 내 쪽(트랜잭션)인지 컨트랙트 쪽(입력값)인지.

2. 빠른 참조: 흔한 오류 전부

가장 자주 마주칠 순서로 정리한 정확한 문자열입니다. 문구는 go-ethereum 소스에서 가져왔으며, 지갑은 이를 줄여서 보여 주기도 합니다.

3. "nonce too low"는 무슨 뜻일까?

모든 계정은 자기 트랜잭션에 0부터 번호를 매기며, 각 번호는 한 번만 쓸 수 있습니다. "Nonce too low"는 방금 보낸 트랜잭션이 그 계정에서 네트워크가 이미 확인한 번호를 달고 있다는 뜻입니다. 노드는 트랜잭션의 nonce를 계정의 다음 예상 nonce와 비교해, 그보다 낮은 것은 모두 거부합니다.

지갑이 알고 있는 다음 nonce가 오래된 값일 때 생깁니다. 같은 계정에서 다른 지갑이나 기기로 트랜잭션을 보냈거나, 가속이나 취소가 이미 그 번호를 썼거나, 로컬 개발 체인을 재시작해 계정의 카운터는 0으로 돌아갔는데 MetaMask는 계속 세고 있었던 경우입니다. 하드웨어 지갑에서는 트랜잭션에 두 번 서명했을 때도 나타납니다.

해결법은 지갑이 다시 동기화하게 두는 것입니다. 먼저 익스플로러에서 주소를 조회하세요. 하려던 일이 그 nonce로 이미 처리되었다면 다시 보내지 마세요. 지갑이 계속 오래된 번호를 내민다면 MetaMask의 "Delete activity and nonce data"(활동 및 nonce 데이터 삭제) 옵션(설정, 개발자 도구)이 현재 네트워크의 로컬 카운터를 지웁니다. MetaMask는 이 작업이 되돌릴 수 없고, 현재 네트워크에만 적용되며, 잔액에는 영향이 없다고 안내합니다. 코드에서는 직접 카운터를 유지하는 대신 서명 전에 eth_getTransactionCount를 "pending" 태그로 호출해 다음 nonce를 읽으세요.

4. "nonce too high"는 무슨 뜻일까?

반대 방향의 틈입니다. 트랜잭션의 nonce가 계정의 다음 예상값보다 높아서 구멍이 생겼습니다. 더 낮은 번호가 아직 확인되지 않은 것입니다. 노드는 이런 트랜잭션을 실행하지 않고 대기열에 두며, 일부는 이 메시지와 함께 바로 거부합니다.

흔한 원인은 앞선 트랜잭션 하나가 탈락한 트랜잭션 묶음이거나, 반대 방향의 로컬 체인 초기화입니다(체인은 초기화됐는데 지갑은 아니어서, nonce 0을 기대하는 체인에 지갑이 nonce 40을 보내는 경우). 빠진 nonce를 보내 틈을 메우거나, 위에서처럼 지갑의 활동 데이터를 지우세요.

5. "replacement transaction underpriced"는 무슨 뜻일까?

대기 중인 트랜잭션을 대체하려 했는데(가속, 취소, 또는 그냥 같은 nonce로 다시 보내기) 새 트랜잭션이 이전 것보다 충분히 더 내지 않는 경우입니다. 노드는 수수료가 최소 비율 이상 오를 때만 대기 중인 트랜잭션을 같은 nonce의 다른 트랜잭션으로 바꿔 주며, go-ethereum에서 이 인상 폭의 기본값은 10퍼센트이고 최대 수수료와 우선 수수료 모두에 적용됩니다.

nonce는 맞고, 가격이 문제입니다. 현재 네트워크 요율이 아니라 대기 중인 트랜잭션을 기준으로 두 수수료 필드를 모두 10퍼센트 이상 올리세요. 관련된 "transaction underpriced" 대화상자에 대한 MetaMask의 안내는 우선 수수료를 10퍼센트 이상, 최대 수수료를 30퍼센트 이상 높이라는 것입니다. 대신 취소하려면 MetaMask의 오류 가이드에 설명된 대로 같은 nonce와 올린 수수료로 자기 주소에 0 ETH를 보내세요. 어느 쪽이든 대체 트랜잭션은 새 트랜잭션 해시를 받고 이전 것은 버려집니다.

6. "transaction underpriced"는 무슨 뜻일까?

"replacement"라는 단어가 없는 이것은 단순한 가격 검사입니다. 트랜잭션의 수수료가 노드가 풀에 보관하려는 수준보다 낮은 것입니다. 노드는 스팸을 막기 위해 최소 가스 가격을 정해 두는데, 붐비는 시간대에는 지갑의 "낮음" 수수료 추정치가 그 아래로 떨어질 수 있습니다. 비슷한 메시지인 "transaction gas price below minimum"도 같은 뜻입니다.

최대 수수료와 우선 수수료를 올려 다시 보내세요. 온체인에는 아무것도 기록되지 않았으므로 정리해야 할 멈춘 트랜잭션도 없습니다. 특정 네트워크에서 반복해서 보인다면 그 네트워크의 최소값이 지갑의 기본값보다 높은 것이며, 가스 트래커의 네트워크별 페이지에서 현재 시세를 볼 수 있습니다.

7. "insufficient funds for gas * price + value"는 무슨 뜻일까?

보내는 쪽의 네이티브 코인 잔액은 보내는 금액에 최악의 경우 수수료, 즉 가스 한도에 가스당 최대 수수료를 곱한 값을 더한 만큼을 감당해야 합니다. 이 규칙은 EIP-1559에 적혀 있습니다. 서명자는 value에 더해 gas_limit 곱하기 max_fee_per_gas를 지불할 수 있어야 합니다. 노드는 트랜잭션이 실제로 들 비용이 아니라 최대값을 기준으로 검사하므로, 최종 수수료라면 충분했을 트랜잭션도 이 검사에서 실패할 수 있습니다.

거의 모든 경우가 세 가지 원인으로 설명됩니다. 토큰은 있지만 네이티브 코인이 없는 경우: 베이스의 USDC는 가스로 ETH가 필요하고, 폴리곤의 USDT는 POL이, BNB 스마트 체인의 모든 것은 BNB가 필요합니다. 잔액 전부를 보내느라 수수료 몫을 남기지 않은 경우: 최대 수수료를 먼저 빼세요. 아니면 컨트랙트 호출 때문에 가스 한도가 부풀려져 최악의 경우가 실제 비용보다 훨씬 큰 경우입니다.

해결법은 네이티브 코인을 채우거나, 더 적은 금액을 보내거나, 최대 수수료나 가스 한도가 넉넉히 잡혀 있다면 낮추는 것입니다. 관련된 "insufficient funds for transfer"는 가스를 따지기도 전에 금액만으로 잔액을 넘는다는 뜻입니다.

8. Intrinsic gas too low, out of gas, 가스 한도 오류

가스 한도와 관련된 메시지는 네 가지이며, 실패하는 시점이 서로 다릅니다. "Intrinsic gas too low"는 포함 전 거부입니다. 모든 트랜잭션에는 코드가 실행되기 전의 고정 기본 비용이 있는데, 단순 전송은 21,000 가스에 데이터 바이트당 요금이 더해지며, 가스 한도가 그보다 낮은 것입니다. ethereum.org 가스 문서는 표준 전송을 21,000 단위로 적고 있으며, 토큰 전송이나 컨트랙트 호출은 더 필요합니다. 한도를 올리거나, 지갑이나 라이브러리가 추정하게 두세요.

"Out of gas"는 포함 후 버전입니다. 한도가 기본 비용은 감당해 트랜잭션은 채굴되었지만, 그다음 컨트랙트 코드가 한도보다 많은 가스를 필요로 한 것입니다. EVM은 모든 상태 변경을 되돌리지만, 같은 문서가 말하듯 수행된 작업에 대해 제공된 가스는 모두 소모됩니다. 수수료는 사라지고 트랜잭션은 익스플로러에 실패로 표시됩니다. 더 높은 한도로 다시 보내세요. 지갑이 보통 추정치에 여유를 더하는 이유가 바로 이것입니다.

"Exceeds block gas limit"은 설정한 한도가 그 네트워크에서 블록 하나가 담을 수 있는 양보다 크다는 뜻입니다. "Transaction gas limit too high"는 더 최근의 것으로, EIP-7825 이후 트랜잭션 하나가 16,777,216 가스(2의 24제곱)를 넘게 요청할 수 없으며, 상한을 넘는 트랜잭션은 거부됩니다. 둘 다 한도를 낮추면 해결됩니다. 정상적인 트랜잭션이 그 숫자 근처까지 필요한 일은 없습니다.

9. 최대 수수료와 우선 수수료 오류

EIP-1559 이후 트랜잭션에는 수수료 필드가 둘 있습니다. 단위당 지불할 최대 금액인 가스당 최대 수수료(max fee per gas)와, 밸리데이터에게 주는 팁인 가스당 최대 우선 수수료(max priority fee per gas)입니다. 프로토콜은 이 둘과 블록의 기본 수수료 사이에 두 가지 관계를 강제하며, 각각에 고유한 오류가 있습니다.

"Max fee per gas less than block base fee": 최대 수수료가 현재 기본 수수료보다 낮아서, 팁을 얼마로 하든 트랜잭션이 포함될 수 없습니다. 한산할 때 서명했다가 기본 수수료가 오른 뒤에 브로드캐스트한 트랜잭션과, 수수료를 하드코딩해 만든 트랜잭션이 여기에 걸립니다. 최대 수수료를 올리거나 기다리세요. 기본 수수료는 블록마다 움직이므로 상한 아래로 내려오면 트랜잭션은 다시 유효해집니다.

"Max priority fee per gas higher than max fee per gas": 팁이 전체 상한을 넘는 경우로, 기본 수수료가 먼저 채워지고 팁은 남은 몫에서만 나올 수 있기 때문에 명세가 금지합니다. 우선 수수료를 최대 수수료 이하로 설정하세요. 제대로 만든 트랜잭션은 최대 수수료가 대략 기본 수수료의 두 배에 팁을 더한 값이어서, 기다리는 동안 기본 수수료가 올라도 여유가 있습니다.

10. "execution reverted"는 무슨 뜻일까?

호출한 컨트랙트가 일부러 실행을 멈춘 것입니다. Solidity의 require, revert, assert 문은 모두 이 메시지로 끝나며, 뒤에 컨트랙트 자체의 이유 문자열이 따라오는 경우가 많습니다. "ERC20: transfer amount exceeds allowance", "UniswapV2Router: INSUFFICIENT_OUTPUT_AMOUNT", "Pausable: paused" 같은 것들입니다. 이유가 비어 있으면 "execution reverted"만 보이거나 원시 오류 데이터가 보입니다.

대개는 보내기 전에 보게 됩니다. 지갑이 eth_estimateGas로 호출을 돌려 보는데 그 시뮬레이션이 revert되기 때문이며, MetaMask는 그러면 가스를 추정할 수 없다고 알립니다. 이것이 저렴한 버전입니다. 아무것도 보내지지 않았습니다. 비싼 버전은 시뮬레이션을 통과해 채굴되었지만 그 사이 상태가 바뀌어 온체인에서 revert된 트랜잭션입니다(스왑 가격이 슬리피지를 넘어 움직였거나, 다른 사람이 마지막 물량을 샀거나, 기한이 지났거나). 익스플로러에 Fail로 표시되고 수수료는 지불됩니다.

해결법은 결코 더 높은 가스 한도가 아닙니다. 이유 문자열을 읽고 입력값을 바꾸세요. 토큰을 먼저 승인(approve)하고, 슬리피지를 넓히거나 금액을 줄이고, 컨트랙트가 일시 정지 상태가 아닌지 확인하고, 컨트랙트가 있는 네트워크에 접속해 있는지 확인하세요. 채굴된 실패의 revert 이유는 익스플로러의 트랜잭션 페이지에 표시되며, Etherscan 가이드에서 어디를 보면 되는지 알려 줍니다.

11. Already known, invalid sender, oversized data

"Already known"은 실질적인 의미에서 오류가 아닙니다. 노드가 보낸 것과 똑같은 트랜잭션을 이미 갖고 있는 것으로, 보통 라이브러리가 브로드캐스트를 재시도했거나 두 지갑이 같은 서명 바이트를 밀어 넣은 경우입니다. 원래 것이 확인될 때까지 기다리세요.

"Invalid sender"는 노드가 서명에서 유효한 서명자를 복원하지 못했다는 뜻입니다. EIP-155 이후 체인 ID가 서명 대상에 포함되므로, 체인 1용으로 서명해 체인 137에 보낸 트랜잭션은 엉뚱한 값으로 복원되어 거부됩니다. 서명 설정의 체인 ID를 RPC 엔드포인트가 보고하는 값과 대조하세요. 체인 ID 목록에 번호와 불일치 사례가 정리되어 있습니다.

"Oversized data"는 트랜잭션의 바이트 크기가 노드가 풀에 받아들이는 한도를 넘는다는 뜻으로, 아주 큰 컨트랙트 배포나 calldata에서만 생깁니다. 데이터를 나누거나 팩토리를 통해 배포하세요.

12. 실패한 트랜잭션도 가스가 들까?

어디서 실패했느냐에 따라 다릅니다. 이 가이드의 첫 번째 부류(nonce, underpriced, 자금 부족, intrinsic gas, 수수료 상한, already known, invalid sender, oversized data)는 모두 거부입니다. 노드가 트랜잭션을 버렸고 어느 블록에도 들어 있지 않으므로 수수료가 청구되지 않았고 익스플로러에서 찾을 것도 없습니다. 다시 보내도 추가 비용이 들지 않습니다.

"Out of gas"와 채굴된 "execution reverted"는 두 번째 부류입니다. 트랜잭션이 Fail 상태로 블록에 들어 있고, 밸리데이터가 작업을 했으며, 수수료는 전액 지불됩니다. ethereum.org 문서는 트랜잭션의 성공 여부와 관계없이 수수료가 지불된다고 명시합니다. 옮기려던 ETH나 토큰은 그대로 있고, 수수료만 사라집니다.

13. 코드에서 이 오류를 피하는 방법

네 가지 습관이면 전송 서비스에서 이 목록의 대부분이 사라집니다. 카운터를 직접 유지하는 대신 노드에서 pending nonce를 읽고, 현재 네트워크의 수수료 추정치를 노드에서 가져오고, 서명 전에 가스를 추정해 여유를 더하고, 브로드캐스트 전에 잔액을 금액 더하기 최악의 경우 수수료와 비교하는 것입니다. ChainGate SDK는 transfer() 안에서 이 네 가지를 모두 처리하고, 직접 다뤄야 하는 한 가지 경우를 타입이 있는 오류로 드러냅니다:

import { ChainGate, importWallet, NotEnoughFundsError } from 'chaingate';

const cg = new ChainGate({ apiKey: process.env.CHAINGATE_API_KEY });
const wallet = importWallet({ phrase: process.env.MNEMONIC });
const eth = cg.connect(cg.networks.ethereum, wallet);

try {
  // Nonce, gas limit and EIP-1559 fees are read from the node for you
  const tx = await eth.transfer(cg.networks.ethereum.amount('0.05'), '0x...');
  tx.setFee(tx.recommendedFees().normal);

  if (!tx.enoughFunds()) {
    // amount + worst-case fee exceeds the balance: nothing is broadcast
    console.log('short by', tx.missingFunds());
    return;
  }

  const sent = await tx.signAndBroadcast();
  console.log(sent.transactionId);
} catch (err) {
  if (err instanceof NotEnoughFundsError) {
    console.error('Not enough ETH for amount + fee');
  }
  throw err;
}

이더리움과 UTXO 체인의 전체 흐름은 JavaScript로 암호화폐를 보내는 튜토리얼에 있고, transfer 문서에는 수수료 등급과, 네이티브 코인이 정확히 얼마나 부족한지 알려 주는 missingFunds 필드가 정리되어 있습니다.

14. 다음에 볼 것

이 오류의 대부분은 수수료에 관한 것이므로, 다음으로 읽을 페이지는 가스비란 무엇이고 최대 수수료, 우선 수수료, 기본 수수료가 어떻게 맞물리는지이고, 그다음은 각 네트워크의 현재 요율을 보여 주는 가스 트래커입니다. 트랜잭션이 실제로 나갔고 어떻게 되었는지 알아야 한다면, 트랜잭션 해시 가이드에서 조회하는 방법을 보여 줍니다. 그리고 이더리움, EVM 레이어 2, 비트코인에 걸쳐 nonce, 수수료, 잔액 검사를 대신 처리해 주는 TypeScript 라이브러리를 찾는다면, ChainGate가 이 사이트를 뒷받침하는 SDK입니다.

자주 묻는 질문