File specifica input per ERC-1155

Il comando di inizializzazione di Blockchain App Builder legge il file delle specifiche di input e genera il progetto impalcato con diversi strumenti per assistere nel processo di sviluppo del codice concatenato.

È possibile definire asset standard e asset token fungibili e non fungibili basati sullo standard ERC-1155 nello stesso file di specifica. Impossibile definire asset token basati su più standard nello stesso file di specifica.

Per informazioni sull'inclusione degli asset standard nel file di specifica, vedere File di specifica di input.

Nel package Blockchain App Builder sono disponibili i seguenti file di specifica di esempio per gli asset token ERC-1155:
  • NFTArtCollectionMarketplacewithERC1155-TypeScript.yml
  • FractionalNFTinRealEstate-TypeScript.yml

Oltre alle proprietà e alle sezioni standard, gli asset token supportano le sezioni behavior e anatomy nel file di specifica. Inoltre, gli asset token non fungibili supportano la sezione metadata. L'esempio seguente mostra la struttura di un file di specifica per due asset token ERC-1155, un token intero non fungibile e un token fungibile frazionario: 

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

L'esempio seguente mostra la struttura di un file di specifica per un token frazionario non fungibile:

- 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

Tabella 4-3 Descrizioni ed esempi dei parametri per un file di specifica dei token ERC-1155

Voce Descrizione Esempi
type:

È necessario specificare type: token nella sezione assets. 

assets:
    - name: ArtCollection #Asset name
      type: token #Asset type
standard: La proprietà standard è obbligatoria per i token ERC-1155. Rappresenta lo standard del token da seguire durante la generazione del codice concatenato. 
standard: erc1155+ # Token standard
anatomy:
La sezione anatomy dispone di due parametri obbligatori:
  • type: nonfungible o type: fungible

    Un token non fungibile è univoco.

  • unit: whole o unit: fractional

    Un token intero non può essere suddiviso in unità frazionarie più piccole. Un token frazionario può essere suddiviso in unità o azioni più piccole, in base a un numero specificato di posizioni decimali.

 
anatomy:
          type: nonfungible # Token type
          unit: whole #Token unit
behavior: Questa sezione descrive le funzionalità e le limitazioni del token. I comportamenti mintable e transferable sono obbligatori per tutti i token. Il comportamento di indivisible è obbligatorio per i token non fungibili interi.
  • indivisible: questo comportamento supporta una restrizione in modo che i token interi non possano essere suddivisi in frazioni.
  • divisible: questo comportamento descrive come suddividere i token. Il parametro decimal specifica il numero di posizioni decimali che è possibile utilizzare. La frazione più piccola possibile con il numero di posizioni decimali è l'unità più piccola del token che può essere posseduta. Se il parametro decimal non viene specificato, il valore predefinito è zero posizioni decimali.
  • mintable: questo comportamento obbligatorio supporta la generazione di nuove istanze di token. Il parametro facoltativo max_mint_quantity specifica il numero totale di token che è possibile coniare. Se non si specifica il parametro max_mint_quantity, è possibile coniare un numero qualsiasi di token.
  • transferable: questo comportamento obbligatorio supporta il trasferimento della proprietà dei token.
  • burnable: questo comportamento supporta la disattivazione o la masterizzazione dei token. La masterizzazione non elimina un token ma lo colloca in uno stato permanente in cui non può essere utilizzato. Bruciare non è reversibile.
  • lockable: Questo comportamento è facoltativo ed è supportato solo da token non fungibili. Questo comportamento consente al proprietario del token di bloccare un token non fungibile. Un token bloccato non può essere trasferito o masterizzato da altri utenti.
  • roles: questo comportamento limita i comportamenti dei token agli utenti con ruoli specifici. Al momento sono disponibili due ruoli: minter_role_name e burner_role_name. Se non si specificano ruoli, qualsiasi utente può fungere da minatore o masterizzatore. Ad esempio, se il ruolo di masterizzatore non viene specificato, qualsiasi utente di account dispone implicitamente del ruolo di masterizzatore. Se si specifica il ruolo di masterizzatore, durante il processo di impostazione del token l'utente Token Admin deve assegnare il ruolo di masterizzatore ad altri utenti in modo esplicito. 
behavior:
        - indivisible
        - mintable:
            max_mint_quantity: 20000
        - transferable
        - burnable
        - lockable
        - roles:
            minter_role_name: minter
metadata:

La proprietà metadata è facoltativa ed è supportata solo da token non fungibili. Questa proprietà specifica le informazioni sui metadati, che vengono memorizzate sulla blockchain, per un token non fungibile. I valori degli attributi dei metadati possono essere assegnati solo dal proprietario del token che estrae il token e non possono essere aggiornati dopo la stampa del token.

Nell'esempio, name è il nome dell'attributo metadati e type è il tipo di valore dell'attributo. 

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

Limitazioni

Blockchain App Builder fornisce un supporto parziale per lo standard ERC-1155. Attualmente, i seguenti eventi e metodi ERC-1155 non sono supportati.

Eventi:
  • TransferSingle
  • TransferBatch
  • ApprovalForAll
  • URI
Metodi:
  • safeTransferFrom
  • balanceOf
  • setApprovalForAll
  • isApprovedForAll