NFTokenAcceptOffer

[ソース]

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

• 1つのオファーを受け入れます。これは ダイレクト モードと呼ばれます。
• 2つの異なるオファー(NFTokenの購入オファーと同じNFTokenに対するの売却オファー)をアトミックに受け入れます。これは ブローカー モードと呼ばれます。

(NonFungibleTokensV1_1 amendmentにより追加されました)

NFTokenAcceptOffer JSONの例

{
  "Account": "r9spUPhPBfB6kQeF6vPhwmtFwRhBh2JUCG",
  "Fee": "12",
  "LastLedgerSequence": 75447550,
  "Memos": [
    {
      "Memo": {
        "MemoData": "61356534373538372D633134322D346663382D616466362D393666383562356435386437"
      }
    }
  ],
  "NFTokenSellOffer": "68CD1F6F906494EA08C9CB5CAFA64DFA90D4E834B7151899B73231DE5A0C3B77",
  "Sequence": 68549302,
  "TransactionType": "NFTokenAcceptOffer"
}

トランザクションの例を確認 >

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

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

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

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

実行内容

トランザクションが成功した場合

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

以下の場合、トランザクションはtecコードで失敗します。

• 購入者が既にNFTokenを所有している。
• 販売者が現在NFTokenの所有者でない。
• 取引のオファーの一方または両方の期限が失効している。
• 売却オファーが特定の宛先アカウントを指定しており、トランザクションの送信者がそのアカウントでない。
• トランザクションの送信者が購入または売却のオファーを所有している。

フィールド

NFTokenAcceptOffer フィールド

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

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

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

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

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

エラーケース

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