ERC-721の入力仕様ファイル

ブロックチェーン・アプリケーション・ビルダーの初期化コマンドは、入力仕様ファイルを読み取り、チェーンコード開発プロセスを支援する複数のツールを使用してスキャフォールド済プロジェクトを生成します。

ERC-721標準に基づく標準アセットおよびトークン・アセットを同じ仕様ファイルに定義できます。ERC-721トークン・アセット定義を含む仕様ファイルには、次の制限が適用されます。
  • 同じ仕様ファイルの複数の標準に基づいてトークン・アセットを定義することはできません。
  • 1つの仕様ファイルに複数の非代替トークン・アセットを定義することはできません。

非代替トークン・アセットのカスタム属性値は、トークン所有者が更新できます。

標準アセットを仕様ファイルに含める方法の詳細は、「入力仕様ファイル」を参照してください。

ERC-721トークン・アセットの次のサンプル仕様ファイルは、Blockchain App Builderパッケージで使用できます。
  • NFTArtCollectionMarketPlace with ERC-721-Typescript.yml

非代替トークン・アセットでは、標準プロパティおよびセクションに加えて、仕様ファイルのbehavior、anatomyおよびmetadataセクションもサポートされます。非代替トークン・アセットでは、standardおよびsymbolプロパティもサポートされます。次の例は、ERC-721トークン・アセットの仕様ファイルの構造を示しています。 

assets:
    - name: ArtCollection #Asset name
      type: token #Asset type
      symbol: ART # Token symbol
      standard: erc721+ # Token standard
      
      anatomy:
          type: nonfungible # Token type
          unit: whole #Token unit
      
      behavior:
        - indivisible
        - singleton
        - mintable:
            max_mint_quantity: 20000
        - transferable
        - burnable
        - lockable
        - roles:
            minter_role_name: minter
      
      properties: # Custom asset attributes for non-fungible tokens
          
          - name: price # Custom asset attribute to set the price of a non-fungible token in the marketplace
            type: number
          
          - name: on_sale_flag # Custom asset attribute maintains non-fungible token selling status in the marketplace
            type: boolean
      
      metadata: # Use this section to maintain the metadata on the blockchain. Only the user creating the non-fungible token can assign metadata attribute values, which cannot be updated later.
          
          - name: painting_name
            type: string
          
          - name: description
            type: string
          
          - name: image
            type: string
          
          - name: painter_name
            type: string

表7-6 ERC-721トークン仕様ファイルのパラメータの説明と例

開始時 説明 例
type:

assetsセクションでtype: tokenを指定する必要があります。 

assets:
    - name: ArtCollection #Asset name
      type: token #Asset type
symbol: symbolプロパティは、トークン・コントラクトを識別する記号(ARTなど)を表します。通常、記号の長さは3 - 4文字です。 
symbol: ART # Token symbol
standard: standardプロパティは、非代替トークンに必須です。これは、チェーンコード生成時に従うトークン標準を表します。ブロックチェーン・アプリケーション・ビルダーでは、非代替トークンはERC-721標準の一部バージョンに従います。詳細は、制限を参照してください。 
standard: erc721+ # Token standard
anatomy:
anatomyセクションには、非代替トークンの2つの必須パラメータがあります。
  • type: nonfungible

    無効でないトークンは一意です。

  • unit: whole

    トークン全体を小数の単位に分割することはできません。

 
anatomy:
          type: nonfungible # Token type
          unit: whole #Token unit
behavior: この項では、トークンの機能および制限について説明します。mintable、transferable、singletonおよびindivisibleの動作は、非代替トークンには必須です。
  • singleton: この必須動作では、クラス内に1つのトークンのみが存在し、分割できないように制限がサポートされます。
  • indivisible: この必須動作では、トークン全体を小数に分割できないように制限がサポートされます。
  • mintable: この必須動作では、新しいトークン・インスタンスの作成がサポートされます。オプションのmax_mint_quantityパラメータは、ミント可能なトークンの合計数を指定します。max_mint_quantityパラメータを指定しない場合、任意の数のトークンをミントできます。
  • transferable: この必須動作では、トークンの所有権の転送がサポートされます。
  • burnable: このオプション動作では、トークンの非アクティブ化または書込みがサポートされます。書き込みは、トークンを削除するのではなく、使用できない永続的な状態にします。燃焼は可逆的ではない。
  • lockable: この動作はオプションであり、非代替トークンでのみサポートされます。この動作により、トークン所有者は非代替トークンをロックできます。ロックされたトークンは、他のユーザーが転送または書き込みすることはできません。
  • roles: このオプション動作は、トークン動作を特定のロールを持つユーザーに制限します。現在、minter_role_nameとburner_role_nameの2つのロールが使用可能です。ロールを指定しない場合は、任意のユーザーがマイナーまたはバーナーとして動作できます。たとえば、バーナー役割が指定されていない場合、すべてのアカウントユーザーが暗黙的にバーナー役割を持ちます。バーナー・ロールが指定されている場合、トークン設定プロセス中に、Token Adminユーザーはバーナー・ロールを他のユーザーに明示的に割り当てる必要があります。 
behavior:
        - indivisible
        - singleton
        - mintable:
            max_mint_quantity: 20000
        - transferable
        - burnable
        - lockable
        - roles:
            minter_role_name: minter
metadata:

metadataプロパティはオプションであり、非代替トークンでのみサポートされます。このプロパティは、非代替トークンのメタデータ情報(ブロックチェーンに格納)を指定します。メタデータ属性値は、トークンをミントするトークン所有者のみが割り当てることができます。また、トークンのミント後に更新することはできません。

この例では、nameはメタデータ属性の名前、typeは属性の値のタイプです。 

metadata:
                                
                                - name: painting_name
                                type: string
                                
                                - name: description
                                type: string
                                
                                - name: image
                                type: string
                                
                                - name: painter_name
                                type: string

制限事項

ブロックチェーン・アプリケーション・ビルダーは、ERC-721標準に対する部分的なサポートを提供します。現在、次のERC-721イベントおよびメソッドはサポートされていません。

イベント:
  • event Transfer
  • event Approval
  • event ApprovalForAll
メソッド:
  • approve
  • getApproved
  • setApprovalForAll
  • isApprovedForAll