NFTokenAcceptOffer

NFTokenAcceptOfferトランザクションはNFTokenの購入または売却のオファーを受け入れるために使用されます。トランザクションは次のいずれかになります。

  • 1つのオファーを受け入れることを許可する。これは ダイレクト モードと呼ばれます。
  • 2つの異なるオファー、1つは与えられたNFTokenの購入を提案し、もう1つは同じNFTokenの売却を提案し、アトミックに受け入れられることを許可します。これは ブローカー モードと呼ばれます。

(NonFungibleTokensV1_1 amendmentが必要です)

ブローカー vs. ダイレクト モード

トランザクションが動作するモードは、トランザクションのNFTokenSellOfferフィールドとNFTokenBuyOfferフィールドの存在によって決まります。

NFTokenSellOffer NFTokenBuyOffer Mode
✔️ ✔️ ブローカー
✔️ X ダイレクト
X ✔️ ダイレクト

もしこれらのフィールドがどちらも指定されていない場合、トランザクションは不正で、temクラスのエラーを発生させます。

ブローカーモードの意味合いは、ダイレクト・モードのそれとは若干異なります。トランザクションを送信するアカウントはブローカーとして機能し、2つのオファーをまとめてマッチングさせますが、関係するNFTokenの所有権を取得することはなく、トランザクションが成功すれば、販売者から購入者に直接転送されます。

実行内容

ダイレクトモード

ダイレクトモードでは、以下の場合、NFTokenAcceptOfferトランザクションは失敗します。

  • NFTokenAcceptOfferトランザクションの対象となるNFTokenOfferがNFTokenの購入オファーであり、NFTokenAcceptOfferを送信したアカウントが、実行時に対応するNFTokenを所有していない場合。
  • NFTokenAcceptOfferトランザクションの対象となるNFTokenOfferはNFTokenの売却オファーであり、実行時にNFTokenの所有者ではないアカウントが送信している場合。
  • NFTokenAcceptOfferトランザクションの対象となるNFTokenOfferはNFTokenの売却オファーであり、実行時にNFTokenOffer内の受信者であるAccount以外のアカウントによって送信された場合（存在する場合）。
  • NFTokenAcceptOfferトランザクションの対象となるNFTokenOfferにexpirationが設定されており、そのトランザクションが含まれる親レジャーのフィールドの終了時刻が既に経過している場合。
  • NFTokenAcceptOfferトランザクションの対象となるNFTokenOfferが、NFTokenAcceptOfferを実行するアカウントが所有し、NFTokenの売買が行われる場合。

このような失敗の副作用として、NFTokenOfferオブジェクトが削除され、オファーがキャンセルされたかのように準備金が払い戻されることがあります。このため、適切なtecクラスのエラーを使用する必要があります。

トランザクションが正常に実行された場合

  • 既存のownerのNFTokenPageからトークンが削除され、新しいownerのNFTokenPageに追加されます。
  • NFTokenOfferで指定された通り、購入者から販売者に資金が移動します。対応するNFTokenのオファーにTransferFeeが指定されている場合、issuerは指定されたパーセンテージを受け取り、残りはNFTokenの販売者に送られます。

ブローカーモード

ブローカーモードでは、以下の場合、NFTokenAcceptOfferトランザクションは失敗します。

  • NFTokenAcceptOfferトランザクションに対するNFTokenOfferの購入オファーがトランザクションを送信するアカウントによって所有されている場合。
  • NFTokenAcceptOfferトランザクションに対するNFTokenOfferの売却オファーが、トランザクションを送信するアカウントによって所有されている場合。
  • NFTokenの売却オファーを出したアカウントが、その実行時に対応するNFTokenの現在の所有者ではない場合。
  • いずれかのオファー（購入または売却）がexpirationを指定しており、そのトランザクションが含まれる親レジャーのクローズ時間がすでに経過している場合。

フィールド

NFTokenAcceptOffer フィールド

共通フィールドに加えて、NFTokenAcceptOfferトランザクションは以下のフィールドを使用します。

フィールド JSONの型 内部の型 説明
NFTokenSellOffer 文字列 Hash256 (省略可) NFTokenの売却を提案するNFTokenOfferの識別情報です。
NFTokenBuyOffer 文字列 Hash256 (省略可) NFTokenの購入を提案するNFTokenOfferの識別情報です。
NFTokenBrokerFee 通貨額 Amount (省略可) このフィールドはブローカーモードでのみ有効であり、2つのオファーをまとめるための手数料としてブローカーが保持する金額を指定します。残りの金額はNFTokenの販売者に送られます。指定する場合、発行者が課す送金手数料を考慮する前に、販売者が受け取る金額が少なくとも売却オファーで示された金額になるように手数料を設定しなければなりません。

ダイレクトモードでは、NFTokenSellOfferまたはNFTokenBuyOfferフィールドのいずれかを指定する必要があります。ブローカーモードでは、両方のフィールドを指定する必要があります。

この機能は、NFTokenの所有者が第三者のブローカーにトークンの売却を提案し、ブローカーがNFTokenを所有したり資金を預けることなく、より高額でNFTokenを売却することを可能にするものです。

両方のオファーが同じ資産に対するものである場合、資金が転送される順序によって、本来成功するはずの取引が、資金不足のために失敗する可能性があります。決定論的なトランザクション実行を保証し、成功の可能性を最大化するために、NFTokenを購入しようとするアカウントから先に資金が引き落とされます。ブローカーに支払われる資金は、販売者に入金される前に入金されます。

ブローカーモードでは、NFTokenBuyOfferとNFTokenSellOfferの両方が同じNFTokenIDを指定する必要があります。

エラーケース

すべてのトランザクションで発生する可能性のあるエラーに加えて、NFTokenAcceptOfferトランザクションでは、次のトランザクション結果コードが発生する可能性があります。

エラーコード 説明
temDISABLED NonFungibleTokensV1の修正は有効ではありません。
temMALFORMED トランザクションのフォーマットが正しくありません。たとえば、NFTokenSellOfferとNFTokenBuyOfferのどちらも指定されていないか、NFTokenBrokerFeeに負の値が指定されています。
tecCANT_ACCEPT_OWN_NFTOKEN_OFFER 購入者と販売者が同じアカウントになっています。
tecEXPIRED トランザクションで指定されたオファーの有効期限が既に切れています。
tecINSUFFICIENT_FUNDS 購入者が申し出た金額を全額持っていない。購入額がXRPで指定されている場合、所有者準備金が原因である可能性があります。購入額が発行済み通貨である場合、トークンが凍結 されていることが原因と考えられます。
tecINSUFFICIENT_PAYMENT ブローカーモードにおいて、提示された購入額は、BrokerFee および NFTokenの売却コストを支払うには十分な額ではありません。
tecOBJECT_NOT_FOUND トランザクションで指定されたオファーがレジャーに存在しません。
tecNFTOKEN_BUY_SELL_MISMATCH ブローカーモードにおいて、2つのオファーが有効なマッチングではありません。例えば、販売者が購入者の提示額よりも高い金額を提示している、購入と売却のオファーが異なる通貨で提示されている、販売者が購入者や ブローカーとは異なる販売先を指定している、などです。
tecNFTOKEN_OFFER_TYPE_MISMATCH NFTokenBuyOfferで識別されるオブジェクトが実際には購入オファーでない、またはNFTokenSellOfferで識別されるオブジェクトが実際には売却オファーでない場合です。
tecNO_PERMISSION 販売者が売却するNFTokenを所有していません。または、マッチングオファーが、オファーを受け入れるアカウントとは異なるDestinationアカウントを指定しています。