取引・アカウント・鍵

XRPLの結果コードとは:tes・tec・tefなど6種類の読み方

XRP Ledgerの結果コードは、取引がどうなったかを示す記号です。tes・tec・tef・tel・tem・terの6種類の意味、台帳に入るのはtesとtecだけというルール、送信直後の仮の結果と最終結果の違い、よく見るコードを紹介します。

「XRPLの結果コードとは:tes・tec・tefなど6種類の読み方」のイメージ画像

先に知っておきたい要点

  • 結果コードは先頭の3文字で6種類に分かれ、tesは成功、tecは手数料だけ消費した失敗を表します。
  • 検証済みの台帳に入るのはtesとtecの取引だけで、それ以外の結果は台帳を変えません。
  • 送信直後に返る結果は仮のもので、最終結果は検証済みの台帳で確かめます。
この記事の目次
  1. 1. 結果コードは、先頭の3文字で6種類に分かれる
  2. 2. 台帳に入るのは、tesとtecの取引だけ
  3. 3. 送信直後の結果は、まだ確定していない
  4. 4. 最終結果は、検証済みの台帳で確かめる
  5. 5. よく見る結果コード
  6. 注意しておきたいこと
  7. よくある疑問
  8. まとめ
  9. 出典・参考資料

XRP Ledgerの結果コードは、送った取引がどうなったかを示す記号です。「tesSUCCESS」や「tecUNFUNDED_PAYMENT」のように、先頭の3文字で結果の種類がわかります。

この記事では、6種類の結果コードの意味と、送信直後の仮の結果と最終結果の違いを紹介します。取引の全体の読み方はPayment JSONの記事で紹介しています。

広告

1. 結果コードは、先頭の3文字で6種類に分かれる

結果コードは、先頭の3文字で6つの種類に分かれます。資料1

種類 意味 台帳に入るか 手数料
tes 成功 入る 消費される
tec 失敗したが、手数料だけ消費 入る 消費される
tef 失敗(今後の台帳にも適用できない) 入らない かからない
tel サーバー側の一時的なエラー 入らない かからない
tem 取引の書き方が正しくない 入らない かからない
ter 今は適用できないが、あとで適用される可能性がある 入らない かからない

画面に収まらない場合は、表を左右にスクロールできます。

数字のコードもありますが、XRPLの公式ドキュメントは文字のコードで判断することを勧めています。数字の割り当ては、予告なく変わることがあるためです。

2. 台帳に入るのは、tesとtecの取引だけ

検証済みの台帳に記録されるのは、成功したtesと、失敗したtecの取引だけです。資料2 それ以外の結果の取引は台帳に入らず、台帳の状態も変えません。

tecは「失敗したのに台帳に入る」点が特徴です。tecの取引は手数料のXRPを消費し、アカウントのシーケンス番号(取引の通し番号)も1つ進めます。資料3

例えるなら、tecは「窓口で受け付けたが、残高不足で手続きできなかった」状態です。受付の手数料はかかり、記録も残ります。tef・tel・tem・terは「窓口で受け付けてもらえなかった」状態で、手数料も記録も残りません。

広告

3. 送信直後の結果は、まだ確定していない

取引を送信すると、サーバーからすぐに結果(engine_result)が返ってきます。この結果は仮のもので、最終結果とは限りません。資料1

XRPLの公式ドキュメントは、仮に成功した取引が最終的に失敗することも、仮に失敗した取引が最終的に成功することもあると説明しています。取引が次の台帳に回されたり、同じシーケンス番号の別の取引と競合したりするためです。

4. 最終結果は、検証済みの台帳で確かめる

最終結果は、取引が検証済みの台帳に入ったかどうかで決まります。資料2

状況 最終結果
検証済みの台帳にtesで入った 成功で確定
検証済みの台帳にtecで入った 失敗で確定(手数料は消費)
LastLedgerSequenceを過ぎても台帳に入らない 失敗で確定(手数料はかからない)
temの結果 書き方の誤りで、ルールが変わらない限り確定

画面に収まらない場合は、表を左右にスクロールできます。

LastLedgerSequenceは、取引が有効な最後の台帳番号です。公式ドキュメントは、すべての取引にLastLedgerSequenceを指定し、送信前に取引のハッシュを記録しておくことを勧めています。資料4

確かめるときは、記録したハッシュで取引を検索し、結果に「“validated”: true」があるかを見ます。validatedがtrueでない結果は、まだ仮のものです。

広告

5. よく見る結果コード

送金でよく見る結果コードと、その意味は次のとおりです。資料3

コード 意味 対処の例
tesSUCCESS 成功 検証済みの台帳に入れば完了
tecUNFUNDED_PAYMENT リザーブを除いた残高より多く送ろうとした 送る量を減らす
tecNO_DST_INSUF_XRP 未作成のアドレスに、作成に足りない量を送った 1 XRP以上を送る
tecDST_TAG_NEEDED 宛先タグが必要な相手に、タグなしで送った 宛先タグを付けて送り直す
tecPATH_DRY 通貨を交換する経路が見つからない 交換の経路やトラストラインを確かめる
tefMAX_LEDGER LastLedgerSequenceを過ぎた 新しい設定で送り直す
terQUEUED 手数料が足りず、順番待ちに入った 次の台帳での処理を待つ

画面に収まらない場合は、表を左右にスクロールできます。

terQUEUEDは、手数料が台帳の要求に届かず、将来の台帳のためにキュー(順番待ち)に入ったことを示します。資料5 リザーブとの関係はリザーブの記事、宛先タグは宛先タグの記事で紹介しています。

注意しておきたいこと

  • 仮の結果で処理を進めない:送信直後のtesSUCCESSは仮の結果です。入金や出金の処理は、検証済みの台帳で結果を確かめてから行いましょう。
  • 二重送金に注意:結果がわからないまま同じ送金を新しく作り直すと、両方が成功して二重に送ってしまうおそれがあります。同じシーケンス番号で送り直すか、LastLedgerSequenceを過ぎたことを確かめてから作り直しましょう。
  • tecでも手数料はかかる:tecの失敗は台帳に記録され、手数料のXRPが消費されます。
  • 部分支払いの受取額:tesSUCCESSでも、Partial Paymentでは受取額が指定額より少ないことがあります。Partial Paymentの記事で確かめましょう。

よくある疑問

「tesSUCCESS」と表示されたのに、送金が届いていないのはなぜ?

送信直後のtesSUCCESSは仮の結果で、まだ検証済みの台帳に入っていないことがあります。取引のハッシュで検索し、validatedがtrueになっているか、送り先や宛先タグが正しいかを確かめましょう。

数字のコードで判断してもいい?

結果コードには数字もありますが、割り当ては予告なく変わることがあります。プログラムで判断するときは、tesSUCCESSのような文字のコードを使うのが安全です。

まとめ

XRPLの結果コードは、先頭の3文字で6種類に分かれ、台帳に入るのはtesとtecだけです。送信直後の結果は仮のもので、最終結果は検証済みの台帳で確かめます。「台帳に入ったか」と「検証済みか」の2つを軸にすると、結果コードを正しく読み分けられます。

出典・参考資料

技術はXRPLの公式文書、事業は発表元、裁判・制度は原典を参照します。資料の対象と時点を本文の説明と合わせて読むことを大切にしています。

  1. 01
    Transaction ResultsXRPL公式ドキュメント|結果コードの6分類。送信時のengine_resultは仮の結果で、仮に成功した取引が最終的に失敗することも、その逆もある|確認:2026年10月13日
  2. 02
    Finality of ResultsXRPL公式ドキュメント|検証済みの台帳に入るのはtesとtecの取引だけ。tefMAX_LEDGERは、LastLedgerSequenceより新しい検証済み台帳に含まれなければ最終|確認:2026年10月13日
  3. 03
    tec CodesXRPL公式ドキュメント|tecは手数料のXRPを消費し、シーケンス番号も進める。tecUNFUNDED_PAYMENT、tecNO_DST_INSUF_XRP、tecDST_TAG_NEEDED、tecPATH_DRYなどの意味|確認:2026年10月13日
  4. 04
    Reliable Transaction SubmissionXRPL公式ドキュメント|すべての取引にLastLedgerSequenceを指定する。送信前にハッシュなどを記録し、検証済みの台帳で結果を確かめる|確認:2026年10月13日
  5. 05
    ter CodesXRPL公式ドキュメント|terQUEUEDは、手数料が台帳の要求に届かず、将来の台帳のためにキューに入ったことを示す|確認:2026年10月13日