AssetTree
Last updated
Last updated
AssetTree files describe an asset's properties, including its creator, creation time, license, and other relevant details. These AssetTree files contain a comprehensive collection of metadata that are important to authenticating digital assets on the blockchain.
When changes are made to an asset, a new is created on the blockchain. This process also leads to the generation of a new AssetTree file, reflecting the updated state of the asset. Each of these commits includes the of the relevant AssetTree within its metadata, linking every asset state to a particular point in the blockchain.
An important part of this process is the merging of AssetTree files. This must be done according to the specifications, which then allows users to trace the complete history of an asset. Users may also use or module to merge AssetTree files. By merging the AssetTree files, one can see the complete lifecycle of the asset from its creation to its alterations, to the current state.
For example, consider a digital art piece that has undergone multiple iterations. Each AssetTree file would document properties such as the artist's name, the dates of revisions, the licenses under which the art is distributed, any relevant keywords, and other pertinent information about the art at each point of its evolution. These historical snapshots can be used to verify the authenticity of the art piece at each stage, ensuring it hasn't been tampered with and can always be traced back to its original creator.
Overall, AssetTree provides a comprehensive view of the properties of the asset and ensures transparency and accountability, making it an essential part of the assetization process.
AssetTree is a JSON file on IPFS containing the following information:
assetCid: (string) The Nid of the asset file
assetCreator: (string) Name of the asser creator. The length should not exceed 15 characters.
encodingFormat: (string) The asset's type expressed using a MIME format
abstract: (string) An abstract is a short description that summarizes the asset, the length should not exceed 500 characters. More details see the definition on the
assetTimestampCreated: (Unix timestamp) Creation time of the asset file, the time when the digital media content was converted to a Web3 asset (i.e. with the first blockchain recognition).
headline: (string, optional) Headline or the title of the content file, the length should not exceed 25 characters. More details see the definition on the
digitalSourceType: (string, optional) Specify the type of the source. More details see .
assetLocationCreated: (string, optional) precise or broad location where the asset was created.
assetSha256: (string, optional) SHA-256 hash of the asset file
assetSourceType: (string, optional) This field specify where the asset comes from
creatorWallet: (string, optional) the Wallet address of the asset creator
creatorProfile: (string, optional) The Nid of the creator profile
parentAssetCid: (string, optional) The Nid of the parent asset
license.name: (string, optional) License of the asset file
license.document: (string, optional) URL of the license file
miningPreference.allowed : (array, optional) Provide options of the allowed mining preferences for data mining or AI/ML training workflow. More details see .
miningPreference.notAllowed : (array, optional) Provide options of the NOT allowed mining preferences for data mining or AI/ML training workflow. More details see .
miningPreference.constrained : (array, optional) Provide options of the allowed mining preferences with constraints for data mining or AI/ML training workflow. More details see . If the mining option is shown in the constrained array, the users should follow the license to use the asset properly.
generatedBy : (string, optional) The AI model used to generate the content.
generatedThrough : (string, optional) URL of the software application or a downloadable link which generates the digital content.
usedBy: (string, optional) URL of the website that uses the asset
integrityCid: (string, optional) the Cid/Nid of the additional proof metadata on IPFS
nftRecord: (string, optional) IPFS Cid where you can find all the NFT records. More details can be found in the .
displaySocial: (boolean, optional) Set this to True if you want to display the asset on with the social media link instead of the IPFS file URL.
socialLink : (string, optional) Social link to the URL. If displaySocial is true, this URL will be used to display the asset on .
custom: (JSON, optional) Custom metadata
Note:
The describes the relationship between and tables. Here is . You may also refer to the for more examples of how to create AssetTree and Commit.
This specification follows the verification method for input: data, signature and output: signer's wallet address.