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)
いまこの問題が出ていますか?トランザクションハッシュを貼ると、チェーンを自動判定して実際に失敗した理由をデコードします。
自分のトランザクションを診断