最終更新:
編集

NFTokenMint

[ソース]

NFTokenMintトランザクションは非代替性トークンを作成し、NFTokenMinterに紐付くNFTokenPageオブジェクトNFTokenオブジェクトとして追加します。このトランザクションはNFTokenMinterにとって、不変と定義されているトークンフィールド(例えばFlags)を設定することができる唯一の方法です。

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

NFTokenMint JSONの例

{
  "TransactionType": "NFTokenMint",
  "Account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
  "TransferFee": 314,
  "NFTokenTaxon": 0,
  "Flags": 8,
  "Fee": "10",
  "URI": "697066733A2F2F62616679626569676479727A74357366703775646D37687537367568377932366E6634646675796C71616266336F636C67747179353566627A6469",
  "Memos": [
        {
            "Memo": {
                "MemoType":
                  "687474703A2F2F6578616D706C652E636F6D2F6D656D6F2F67656E65726963",
                "MemoData": "72656E74"
            }
        }
    ]
}

トランザクションを取得してみる >

NFTokenMint フィールド

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

フィールドJSONの型内部の型説明
NFTokenTaxon数値UInt32トークンに関連する分類群。Taxonは通常、トークンの発行者が選択した値です。1つのTaxonは複数のトークンに使用することができます。0xFFFFFFFFより大きいTaxonの識別子は使用できません。
Issuer文字列AccountID(省略可) 送信元アカウントが他のアカウントの代理としてトークンを発行する場合における、トークンの発行者。トランザクションを送信するアカウントが NFToken の発行者である場合、このフィールドは指定してはいけません。指定される場合、発行者のAccountRootオブジェクトには NFTokenMinter フィールドが、このトランザクションの送信者(このトランザクションのAccountフィールド)に設定されていなければなりません。
TransferFee数値UInt16(省略可) この値は、NFTokenの二次販売が許可されている場合に、発行者が徴収する手数料を指定します。このフィールドの有効な値は0から50000の間で、0.001刻みで0.00%から50.00%の送金手数料を設定することができます。このフィールドが設定されている場合、トランザクションはtfTransferableフラグ を有効にしなければなりません。
URI文字列Blob(省略可) 最大256バイトの任意のデータ。JSONでは、16進数の文字列としてエンコードされる必要があります。URIを16進数に変換するために、xrpl.convertStringToHexユーティリティを使用することができます。これは、NFTに関連するデータまたはメタデータを指し示すURIであることを想定しています。コンテンツは、HTTPまたはHTTPS URL、IPFS URI、マグネットリンク、RFC2379 "data" URL としてエンコードされた即値データ、あるいは発行者固有のエンコーディングにデコードされていることがあります。URIの有効性はチェックされません。

NFTokenMintのフラグ

NFTokenMint型のトランザクションでは、以下のようにFlagsフィールドに追加の値を設定することが可能です。

フラグ名16進数値整数値説明
tfBurnable0x000000011発行者(または発行者が許可した者)がNFTokenを破棄できるようにします。(NFTokenの所有者は常に破棄することができます)。
tfOnlyXRP0x000000022発行されたNFTokenはXRPでのみ売買が可能です。これは、トークンに送金手数料がかかり、発行者がXRP以外のトークンで手数料を受け取りたくない場合に望ましいでしょう。
tfTrustLine0x000000044非推奨 発行者が、発行したNFTokenを転送する際に受け取る手数料を保有するために、自動的にトラストライン を作成します。fixRemoveNFTokenAutoTrustLine Amendmentにより、このフラグの設定は無効となります。
tfTransferable0x000000088発行されたNFTokenは他の人に譲渡することができます。このフラグが 有効でない 場合、トークンは 発行者から 、または 発行者へ のみ転送することができます。

追加情報の埋め込み

発行時に追加情報を指定する必要がある場合(たとえば、特定の区画を参照して不動産を特定できる詳細情報、車両識別番号を指定して車両を特定できる詳細情報、その他オブジェクト固有の説明)、取引メモを使用することができます。メモは署名された取引の一部であり、履歴アーカイブから入手できますが、レジャーの状態データには保存されません。

他のアカウントの代わりとして発行する

別のアカウントでNFTを発行する場合、次の2つを実行する必要があります。アカウント Aがあなたのアカウントで、アカウント BがNFTokenを発行したいアカウントであるとします。

  1. アカウントBNFTokenMinterアカウント設定を、アカウントAに設定します。(これは、アカウントBが自分に代わってNFTを作成するためにアカウントAを信頼することを意味します)。
  2. NFTokenを発行する際、IssuerフィールドをアカウントBに設定します。

NFTokenMintと発行者の組み合わせ例

{
  "TransactionType": "NFTokenMint",
  "Account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
  "Issuer": "rNCFjv8Ek5oDrNiMJ3pw6eLLFtMjZLJnf2",
  "TransferFee": 25000,
  "NFTokenTaxon": 0,
  "Flags": 8,
  "Fee": "10",
  "URI": "697066733A2F2F62616679626569676479727A74357366703775646D37687537367568377932366E6634646675796C71616266336F636C67747179353566627A6469",
  "Memos": [
        {
            "Memo": {
                "MemoType":
                  "687474703A2F2F6578616D706C652E636F6D2F6D656D6F2F67656E65726963",
                "MemoData": "72656E74"
            }
        }
    ]
}

このトランザクションは、発行者であるrNCFjv8Ek5oDrNiMJ3pw6eLFtMjZLJnf2がそのAccountRootNFTokenMinterフィールド rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59Bと設定して、そのアカウントが自身に代わってトークンを発行する権限を与えていると想定したものです。

エラーケース

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

エラーコード説明
temDISABLEDNonFungibleTokensV1 Amendmentは有効ではありません。
temBAD_NFTOKEN_TRANSFER_FEETransferFeeが許容範囲外です。
temINVALID_FLAGFlags値には、許可されていない、または有効なフラグでないビットが有効になっています。fixRemoveNFTokenAutoTrustLine amendmentが有効になっている場合、tfTrustLineフラグはこのエラーを発生させます。
temMALFORMEDトランザクションが正しく指定されていません。例えば、URIフィールドが256バイトより長い場合です。
tecNO_ISSUERIssuerは、レジャーに存在しないアカウントを指定しています。
tecNO_PERMISSIONIssuerフィールドで参照されるアカウントは、このトランザクションの送信者(NFTokenMinter設定を使用)が自身の代わりに発行することを承認していません。
tecINSUFFICIENT_RESERVEトークンを発行した後、オーナーは更新された準備金要件を満たせなくなります。新しいNFTokenは、新しいNFTokenPageオブジェクトを必要とする場合にのみ、オーナーの準備金を増加させることに注意する必要があり、それぞれ最大32NFTを格納することができます。
tecMAX_SEQUENCE_REACHEDIssuerMintedNFTokensフィールドはすでに最大値になっています。これは、発行者またはその代理人が合計で232-1つのNFTokenを発行した場合にのみ発生します。