트랜잭션 풀

StableNet으로 전송된 트랜잭션은 블록에 포함될 때까지 트랜잭션 풀(mempool)에 머뭅니다. 풀을 이해하면 트랜잭션이 대기 중인 이유와 해결 방법을 알 수 있습니다.

​

두 가지 상태: pending과 queued

​

트랜잭션이 pending인 이유

1. 논스 공백 — 논스 4가 아직 pending인데 논스 5를 전송한 경우. 논스 5는 논스 4가 포함될 때까지 queued 상태로 대기합니다.
2. 가스 팁이 최솟값 미만 — 거버넌스 적용 최소 maxPriorityFeePerGas를 충족하지 못한 경우. 트랜잭션이 queued가 아닌 제출 단계에서 거부됩니다.
3. 잔액 부족 — balance < value + gasLimit × maxFeePerGas. 트랜잭션이 유효성 검사에서 실패합니다.
4. 풀 가득 참 — 전역 pending 한도(기본값 5,120 슬롯)에 도달했고 내 트랜잭션의 우선순위가 기존 트랜잭션보다 낮은 경우.

​

가스 팁과 우선순위

​

막힌 트랜잭션 교체하기

const replacement = await wallet.sendTransaction({
  to: originalTx.to,
  value: originalTx.value,
  nonce: originalTx.nonce,               // 동일한 논스
  maxPriorityFeePerGas: ethers.parseUnits("30360", "gwei"),  // 원래보다 ≥ 10% 높게
  maxFeePerGas: ethers.parseUnits("90000", "gwei"),
});

​

풀 상태 검사

// 모든 pending 및 queued 트랜잭션
const content = await provider.send("txpool_content", []);

// pending 수와 queued 수
const status = await provider.send("txpool_status", []);
console.log("pending:", parseInt(status.pending, 16));
console.log("queued:", parseInt(status.queued, 16));

// 특정 주소의 트랜잭션
const mine = await provider.send("txpool_contentFrom", [wallet.address]);

​

풀 한도

​

블록 포함 이후 처리

1. 블록에 포함된 트랜잭션을 제거합니다
2. 논스 공백이 채워진 queued 트랜잭션을 pending으로 승격합니다
3. 업데이트된 잔액에 대해 남은 트랜잭션을 재검증합니다
4. GovValidator에서 최신 가스 팁을 조회하고 필터링을 업데이트합니다

​

개발자 이점

• 풀 상태를 조회 가능 — txpool_contentFrom으로 내 트랜잭션을 모니터링
• 논스 공백이 막힌 트랜잭션의 주요 원인 — 동시 발신자에서 논스를 신중하게 관리
• 교체가 예측 가능 — 10% 가격 범프로 교체 보장

​

관련 문서

• 가스 및 수수료 — 거버넌스 팁 메커니즘
• 아키텍처 개요 — 풀을 포함한 전체 트랜잭션 생명주기
• RPC API 레퍼런스 — txpool_content, txpool_status