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

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

標準資産、およびERC-1155標準に基づく真菌可能トークン資産と非真菌可能トークン資産の両方を同じ仕様ファイルに定義できます。同じ仕様ファイルの複数の標準に基づいてトークン・アセットを定義することはできません。

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

ブロックチェーン・アプリケーション・ビルダー・パッケージでは、ERC-1155トークン・アセットの次のサンプル仕様ファイルを使用できます。

• NFTArtCollectionMarketplacewithERC1155-TypeScript.yml
• FractionalNFTinRealEstate-TypeScript.yml

標準プロパティおよびセクションに加えて、トークン・アセットは仕様ファイルのbehaviorおよびanatomyセクションをサポートします。また、fungible以外のトークン・アセットは、metadataセクションをサポートしています。次の例は、2つのERC-1155トークン・アセットの仕様ファイルの構造、全非真菌トークンおよび小数の真菌トークンを示しています。

assets:
    - name: ArtCollection #Asset name
      type: token #Asset type
      standard: erc1155+   # Token standard
      
      anatomy:
          type: nonfungible # Token type
          unit: whole  #Token unit
      
      behavior:
        - indivisible                
        - mintable:                   
            max_mint_quantity: 20000
        - transferable                
        - burnable
        - lockable
        - roles:
            minter_role_name: minter
      
      properties:  # Custom asset attributes for non-fungible token 
          
          - 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

    - name: Loyalty # Asset name
      type: token  # Asset type
      standard: erc1155+   # Token standard

      anatomy: 
          type: fungible # Token type
          unit: fractional # Token unit

      behavior: # Token behaviors
          - divisible: 
                decimal: 2  
          - mintable: 
                max_mint_quantity: 10000 
          - transferable
          - burnable 
          - roles: 
                minter_role_name: minter 

      properties:
          - name: currency_name # Custom attribute to represent the token in a specific currency.
            type: string

          - name: token_to_currency_ratio # Custom attribute to specify the token to currency ratio.
            type: number

次の例は、小数非真菌トークンの仕様ファイルの構造を示しています。

- name: RealEstateProperty #Asset name
      type: token #Asset type
      standard: erc1155+ # Token standard
      
      anatomy:
          type: nonfungible # Token type
          unit: fractional #Token unit
      
      behavior:
        - divisible:
        - mintable:
        - transferable
        - roles:
            minter_role_name: minter
      
      properties: # Custom asset attributes for non-fungible token.
          
          - name: propertySellingPrice # Custom asset attribute to set the real estate property selling price
            type: number
 
          - name: propertyRentingPrice # Custom asset attribute maintains the renting amount for the real estate property
            type: number
            
      metadata: # To maintain the metadata on-chain, this tag will be used. Users won't be able to update the metadata attribute values.
          
          - name: propertyType
            type: string
 
          - name: propertyName
            type: string
 
          - name: propertyAddress
            type: string
          
          - name: propertyImage
            type: string

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

開始時	説明	例
type:	assetsセクションでtype: tokenを指定する必要があります。	assets: - name: ArtCollection #Asset name type: token #Asset type
standard:	standardプロパティは、ERC-1155トークンに必須です。これは、チェーンコード生成時に従うトークン標準を表します。	standard: erc1155+ # Token standard
anatomy:	anatomyセクションには、2つの必須パラメータがあります。 type: nonfungibleまたはtype: fungible 真でないトークンは一意です。 unit: wholeまたはunit: fractional トークン全体を小さな小数単位に分割することはできません。小数トークンは、指定した小数点以下の桁数に基づいて、小さい単位(共有)に分割できます。	anatomy: type: nonfungible # Token type unit: whole #Token unit
behavior:	この項では、トークンの機能および制限について説明します。mintable、transferableの動作は、すべてのトークンで必須です。indivisibleの動作は、完全ではないトークンに対して必須です。 indivisible: この動作では、トークン全体を小数に分割できないように制限がサポートされます。 divisible: この動作では、トークンを分割する方法について説明します。decimalパラメータは、使用できる小数点以下の桁数を指定します。小数点以下の桁数は、所有できるトークンの最小単位です。decimalパラメータが指定されていない場合、デフォルトは小数点以下0です。 mintable: この必須動作では、新しいトークン・インスタンスの作成がサポートされます。オプションのmax_mint_quantityパラメータは、ミント可能なトークンの合計数を指定します。max_mint_quantityパラメータを指定しない場合、任意の数のトークンをミントできます。 transferable: この必須動作では、トークンの所有権の転送がサポートされます。 burnable: この動作では、トークンの非アクティブ化または書込みがサポートされます。Burningでは、トークンは削除されませんが、使用できない永続的な状態になります。燃焼は元に戻せない。 lockable: この動作はオプションで、fungible以外のトークンでのみサポートされます。この動作により、トークン所有者は不確定トークンをロックできます。ロックされたトークンは、ほかのどのユーザーにも転送または書き込みできません。 roles: この動作は、トークン動作を特定のロールを持つユーザーに制限します。現在、minter_role_nameとburner_role_nameの2つのロールを使用できます。ロールを指定しない場合、すべてのユーザーがマイナーまたはバーナとして機能できます。たとえば、バーナ・ロールが指定されていない場合、アカウント・ユーザーは暗黙的にバーナ・ロールを持ちます。バーナ・ロールが指定されている場合、トークンの設定プロセス中に、Token Adminユーザーはバーナ・ロールを他のユーザーに明示的に割り当てる必要があります。	behavior: - indivisible - mintable: max_mint_quantity: 20000 - transferable - burnable - lockable - roles: minter_role_name: minter
metadata:	metadataプロパティはオプションであり、fungible以外のトークンでのみサポートされます。このプロパティは、ブロックチェーンに格納されているメタデータ情報(非真菌トークン)を指定します。メタデータ属性値は、トークンをミントするトークン所有者のみが割り当てることができ、トークンのミント後に更新することはできません。 この例では、nameはメタデータ属性の名前、typeは属性の値のタイプです。	metadata: - name: painting_name type: string - name: description type: string - name: image type: string - name: painter_name type: string

制限事項

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

イベント:

• TransferSingle
• TransferBatch
• ApprovalForAll
• URI

メソッド:

• safeTransferFrom
• balanceOf
• setApprovalForAll
• isApprovedForAll