Tx Doctor / EVM 리버트 사전 / 세이프 전송 실패(STF / TF / TransferHelper)
EVM 오류: 세이프 전송 실패(STF / TF / TransferHelper) (STF)
라우터가 지갑에서 토큰을 가져가지 못했습니다. Uniswap 계열은 STF(safeTransferFrom 실패) 또는 TF, PancakeSwap은 TRANSFER_FROM_FAILED로 보고하지만 의미는 같습니다. 잔액, 승인, 토큰 규칙이 인출을 막았습니다.
원인
- 라우터의 토큰 승인 한도가 낮거나 이미 사용되었습니다.
- 거래를 만든 뒤 지갑 잔액이 줄었습니다(다른 대기 거래가 가져감).
- 전송 수수료 토큰이라 라우터 수령액이 옮기려던 금액보다 적었습니다.
- 토큰이 귀하의 주소로 전송을 금지합니다(블랙리스트, 일시정지, 거래 미개시).
해결 방법
- 탐색기에서 토큰을 열어 allowance(spender, router)를 확인하고, 거래가 실제로 호출한 라우터에 승인하세요.
- 잔액을 새로 고치고 실제로 보유한 금액으로 스왑을 다시 만드세요.
- 신규 토큰은 거래가 열렸는지 먼저 확인하세요. 런치 직후 매수는 항상 revert합니다.
- 한도가 0이 아니지만 부족하다면 revoke 후 다시 승인하세요(USDT에서 흔함).
지갑·익스플로러에서 보이는 모습
execution reverted: STF (Uniswap router: safeTransferFrom failed)
지금 이 문제가 발생했나요? 트랜잭션 해시를 붙여 넣으면 체인을 자동으로 찾아 실제 실패 원인을 디코딩합니다.
내 트랜잭션 진단하기