Asset Descriptor v1.0 - hadescoincom/hds-core GitHub Wiki

Abstract

The assets are described here

This document's purpose is to specify the asset metadata, to enable 3rd party tools to consume and display the subset of asset-related information in a simple and well-standardized manner.

General notes

Asset meta is a byte buffer associated with the asset and stored on chain.

  • Asset metadata should be an UTF-8 string
  • Asset m etadata should be serialized as a simple name=value set of pairs, delimited with ;
  • The keyN=valueN; sequence must be preceded with STD: prefix, there is no need for ; at the sequence end
  • The total size of the metadata cannot exceed 16 Kbytes (16,384 bytes)
  • Every description should be in English

Asset metadata has 2 groups of properties:

  • Standard properties
  • Optional properties

WARNING: Both types of properties are immutable and can't be changed after the asset is created. Therefore it is strongly recommended to double-check the values before starting the asset registration.

Standard properties, mandatory

  • SCH_VER= metadata schema version, currently must be 1
  • N= human-readable asset name, for example Hds Coin
  • SN= human-readable short name/asset code, for example HDS
  • UN= human-readable asset unit name, for example Hds
  • NTHUN= human-readable smallest asset unit name (nth-unit name), for example Groth

Standard properties, non-mandatory

  • NTH_RATIO= integer that represents the ratio of the smallest asset unit to regular unit. If omitted default value of 100000000 is used

Optional properties

  • OPT_SHORT_DESC= an one-liner, should not exceed 128 characters
  • OPT_LONG_DESC= a paragraph, should not exceed 1024 characters
  • OPT_SITE_URL= URL of the asset website
  • OPT_PDF_URL= URL for the description paper
  • OPT_FAVICON_URL= URL of the favicon
  • OPT_LOGO_URL= URL of the logo in SVG vector format