Links

Canon Lore Object Model

Canon or Project Lore is only added by Project teams
Canon is the official representation of Lore / world pertaining to a specific NFT project contributed by the core team.
Who can write Canon?
Canon is only added/edited/deleted by the core project team. There is no single author attached to the Canon.
What is the difference between Lore Object and Canon Lore Object?
A Lore Object is always tagged to a token while a Canon Lore / Project Lore Object is attached to the collection as a whole.
Lore about Vogu Collection - https://hyy.pe/canon/6261c907d1ab470018cf6150

Overview

Here's an overview of some of the fields contained in a Canon Lore:
Field Name
Description
createdAtUnix
Shows when this lore was added. This is shared as a unix timestamp
communityDetails
communityDetails shares the details of the NFT series for which this Canon was written. see communityDetails section below.
canonDetails
canonDetails is the Object array of lore blocks which when combined together represent the entire lore. Lore can be made up of several text blocks, images, videos, embeds among different things. see canonDetails section below.
previewText
This shares the text blurb which is displayed as a peek text on a preview card if you are designing a feed.
previewImageUrl
This shares a preview image of the Lore (defined by the author) which is displayed as a peek image on a preview card if you are designing a feed. Optional.
ipfsHash
This shares the unique id of the canon lore object pinned on ipfs.
commentCount
This shares how many times the canon lore was commented on Hyy.pe.
reactionLooksRareCount
This shares how many times the canon lore was reacted on Hyy.pe.

communityDetails

communityDetails is the NFT collection / series summary object in the hyype API.
Below are a few fields contained in a community Details object:
Field Name
Description
name
Name of the collection e.g. Vogu
symbol
Short symbol of associated the ERC721 / ERC1155 token
discordUrl
Discord Join link of the collection optional
twitterUsername
twitter username the collection optional
communityNameLower
Lowercase collection name e.g. vogu
slug
the friendly URL string on hyy.pe . If the slug value says "vogu" then it translates to https://hyy.pe/collection/vogu
image
Object containing the thumbnail image of the collection
searchKeys
contains an object of all smart contract addresses associated with a collection (can be multiple if it's a multi-contract NFT series). In case of Artblocks, it will be contract-projectId
verified
whether the collection is verified or not. boolean

canonDetails

A Canon lore can be formed by combining many building blocks sequenced together. Building blocks can come in many forms - paragraphs, quotes, links, embeds, and more. canonDetails is an array of block objects which together to form the whole lore.
Field name
Type
Description
blocks
Object Array
blocks come in a variety of types - paragraph, embeds, images, videos & quotes being few of the more commonly used ones.
A few examples of blocks are included below:
paragraph
image
video
quote
embed
{
"id": "tbqvAKSuyg",
"type": "paragraph",
"data": {
"text": "<b>There has always been a bit of mystery surrounding this one.&nbsp;&nbsp;</b>"
}
}
{
"id": "IfOVQ2AeDW",
"type": "image",
"data": {
"file": {
"url": "https://media.hyy.pe/700xAUTO/61561912f084510012274814-1635403828014.jpeg"
},
"caption": "Year 2133: Citizen #10082 looking at the vast emptiness of planet Laran",
"withBorder": false,
"stretched": false,
"withBackground": false
}
}
{
"id": "VYvoLmuo0X",
"type": "video",
"data": {
"url": "https://videos.ctfassets.net/znxnw90vc5ew/7uAidRmq7VC7bvTq1Zd8Rx/c821009212f9fcfb1e5052cf0051392a/cover28-timelapse2_1.mp4",
"caption": "",
"autoplay": true,
"controls": true,
"muted": true,
"stretched": false
}
}
{
"id": "_jwh8Miavq",
"type": "quote",
"data": {
"text": "How did it all come to this",
"caption": "- Alien king says to himself",
"alignment": "left"
}
}
{
"id": "TVJQ2E5vmU",
"type": "embed",
"data": {
"service": "youtube",
"source": "https://youtu.be/5GaJOnwTHw8",
"embed": "https://www.youtube.com/embed/5GaJOnwTHw8",
"width": 580,
"height": 320,
"caption": ""
}
}