Decoder Crystal: Difference between revisions

From wizzypedia
Jump to navigation Jump to search
mNo edit summary
m (Edits for clarity)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
The Decoder Crystal is an ERC-721 token on the Ethereum blockchain and is a critical aspect of the Forgotten Runes [[wikipedia:Provenance#Data_provenance|provenance]].
[[File:Decoder Crystal Image.gif|alt=The Decoder Crystal|frame|The Decoder Crystal]]The Decoder Crystal is an ERC-721 token on the Ethereum blockchain and is a critical aspect of the Forgotten Runes [[wikipedia:Provenance#Data_provenance|provenance]].


== 10,000 Encoded On-Chain Wizards ==
== 10,000 Encoded On-Chain Wizards ==
[[File:Decoder Crystal Image.gif|alt=The Decoder Crystal|frame|The Decoder Crystal]]
[[File:Wizard Contract ASCII.png|alt=ASCII Art of the Traditional Forgotten Runes Purple Hat Wizard Included In the Wizards' Ethereum Smart Contract|thumb|ASCII Art of the Traditional Forgotten Runes [[Wizards (Runiverse)|Purple Hat Wizard]] Included In the Wizards' Ethereum Smart Contract]]
To understand the Decoder Crystal, it is first crucial to understand [https://www.forgottenrunes.com/posts/on-chain the on-chain encoding of Forgotten Runes Wizard's Cult]. Unlike many other NFTs, the [[Wizards]] actually [https://etherscan.io/address/0x521f9c7505005cfa19a8e5786a9c3c9c9f5e6f42 live on the Ethereum blockchain]. However, the specific images of these 10,000 Wizard permutations are not stored on-chain. Rather, the parts (ortraits) of the Wizards — the [[List of Heads|heads]], [https://wizzypedia.forgottenrunes.com/Wizards#List_of_Wizard_Bodies bodies], [[List of Items|props]], [[List of Runes|runes]] , and [[List of Companions|familiars]] that make up each character — are contained in a single image grid on the blockchain.[[File:Wizard Contract ASCII.png|alt=ASCII Art of the Traditional Forgotten Runes Purple Hat Wizard Included In the Wizards' Ethereum Smart Contract|thumb|ASCII Art of the Traditional Forgotten Runes [[Wizards (Runiverse)|Purple Hat Wizard]] Included In the Wizards' Ethereum Smart Contract]]
To understand the Decoder Crystal, it is first crucial to understand [https://www.forgottenrunes.com/posts/on-chain the on-chain encoding of Forgotten Runes Wizard's Cult]. Unlike many other NFTs, [[Wizards]] are truly [https://etherscan.io/address/0x521f9c7505005cfa19a8e5786a9c3c9c9f5e6f42 stored on the Ethereum blockchain]. However, the specific images of these 10,000 individual Wizard permutations are not stored on-chain. Rather, the parts (or traits) of the Wizards — the [[List of Heads|heads]], [https://wizzypedia.forgottenrunes.com/Wizards#List_of_Wizard_Bodies bodies], [[List of Items|props]], [[List of Runes|runes]] , and [[List of Companions|familiars]] that make up each character — are contained in a single image grid on the blockchain.


== 10,000 Decoded Wizards ==
[[File:ASCII Art of the Illuminatus Included In the Decoder Crystal Contract.png|alt=ASCII Art of the Illuminatus In the Wizards Ethereum Contract|thumb|ASCII Art of the [[Illuminatus]] In the Decoder Crystal Ethereum Contract]]Along with the on-chain, encoded, image grid of the 341 total parts that serve as the base of the Forgotten Runes Wizards, there exists a pairing of wizard attributes necessary to decode it. This is the Decoder Crystal.
While it exists as [https://opensea.io/assets/ethereum/0x2d00d68bf8bc14d139b4dcea5fb7ce0a42e09c86/0 its own token], the Decoder Crystal contains the code to call [[List of Wizards|every Wizard in the collection]] from the Ethereum blockchain. This means that the characters of Forgotten Runes are not dependent on outside or centralized entities to exist. As long as there is Ethereum, there are Wizards.
=== IPFS ===
=== IPFS ===
[[wikipedia:InterPlanetary_File_System|The InterPlanetary File System]] is a peer-to-peer network used for hosting and sharing data. IPFS is popular among NFT project developers for hosting project-related images. If an image is only stored on IPFS, the owner actually only owns a pointer to that image. This means that the image must have a host, or it will disappear.  
[[wikipedia:InterPlanetary_File_System|The InterPlanetary File System]] is a peer-to-peer network used for hosting and sharing data. IPFS is popular among NFT project developers for hosting project-related images. If a token's image is stored solely on IPFS, the owner actually only owns a pointer to that image. This means that the image must have a host, or it will disappear.  


One of the benefits of IPFS use for NFT project leaders is visibility and compatibility with off-chain organizations, such as [https://opensea.io/collection/forgottenruneswizardscult OpenSea].
One of the benefits of IPFS use for NFT project leaders is visibility and compatibility with off-chain organizations, such as [https://opensea.io/collection/forgottenruneswizardscult OpenSea].


==== Forgotten Runes and IPFS ====
==== Forgotten Runes and IPFS ====
While all of the Wizards' data is stored on Ethereum, [[Magic Machine]] also include an IPFS URL in the <code>tokenURI</code>
While all of the Wizards' data is stored on Ethereum and is completely reproducible, [[Magic Machine]] also includes an IPFS URL of the token image in the <code>tokenURI</code>


This exists solely for convenience and off-chain interoperability, rather than out of necessity for the persistence of Wizards.
This exists solely for convenience and off-chain interoperability, rather than out of necessity for the persistence of Wizards.
== 10,000 Decoded Wizards ==
=== Shortcomings of The Decoding Method ===
[[File:ASCII Art of the Illuminatus Included In the Decoder Crystal Contract.png|alt=ASCII Art of the Illuminatus In the Wizards Ethereum Contract|thumb|ASCII Art of the Illuminatus In the Wizards Ethereum Contract]]Along with the on-chain, encoded image grid of the 341 total parts that result in the Forgotten Runes Wizards, there exists a pairing of wizard attributes necessary to decode it. This is the Decoder Crystal.
The main shortcoming for this method is that the traits are not accessible to other smart contracts. This could potentially create obstacles during integration with other on-chain projects (such as web3 games).
 
While it exists as its own token, the Decoder Crystal contains the code to call [[List of Wizards|every Wizard in the collection]] from the Ethereum blockchain. This means that the characters of Forgotten Runes are not dependent on outside or centralized entities to exist. As long as there is Ethereum, there are Wizards.
=== Shortcomings of This Method ===
The main shortcoming for this method is that the traits are not accessible to other smart contracts. This could potentially create obstacles during integration with other on-chain projects (such as games).


==== The Lost Grimoire ====
==== The Lost Grimoire ====
Line 40: Line 40:
  ],
  ],
  affinities: "0x1be4aa782c9dc164ecbf2cd155537e7250b344f405dff03b5c33fdd63261c80e"</code>
  affinities: "0x1be4aa782c9dc164ecbf2cd155537e7250b344f405dff03b5c33fdd63261c80e"</code>
This data ''itself'' is also stored within the Decoder Crystal.
This data ''itself'' is also [https://etherscan.io/address/0x2d00d68bf8bc14d139b4dcea5fb7ce0a42e09c86#code stored within the Decoder Crystal].


== How to Re-create Any Wizard ==
== How to Re-create Any Wizard ==
If you'd like to re-create your Wizard(s) entirely from on-chain data, you can run the following commands:
To re-create a Wizard(s) entirely from on-chain data, run the following commands:
  <code>curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x0b8eb29d7a592023b5330fd9a93299bca2a9604aaa2494c87333fc56da50ec9e"],"id":67}' <nowiki>https://cloudflare-eth.com/</nowiki> | jq -r '.result.input' | cut -c 139- | xxd --plain --reverse | head -n 297 > decoder.ts
  <code>curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x0b8eb29d7a592023b5330fd9a93299bca2a9604aaa2494c87333fc56da50ec9e"],"id":67}' <nowiki>https://cloudflare-eth.com/</nowiki> | jq -r '.result.input' | cut -c 139- | xxd --plain --reverse | head -n 297 > decoder.ts
  npm init -y
  npm init -y

Latest revision as of 00:04, 25 February 2023

The Decoder Crystal
The Decoder Crystal

The Decoder Crystal is an ERC-721 token on the Ethereum blockchain and is a critical aspect of the Forgotten Runes provenance.

10,000 Encoded On-Chain Wizards

ASCII Art of the Traditional Forgotten Runes Purple Hat Wizard Included In the Wizards' Ethereum Smart Contract
ASCII Art of the Traditional Forgotten Runes Purple Hat Wizard Included In the Wizards' Ethereum Smart Contract

To understand the Decoder Crystal, it is first crucial to understand the on-chain encoding of Forgotten Runes Wizard's Cult. Unlike many other NFTs, Wizards are truly stored on the Ethereum blockchain. However, the specific images of these 10,000 individual Wizard permutations are not stored on-chain. Rather, the parts (or traits) of the Wizards — the heads, bodies, props, runes , and familiars that make up each character — are contained in a single image grid on the blockchain.

10,000 Decoded Wizards

ASCII Art of the Illuminatus In the Wizards Ethereum Contract
ASCII Art of the Illuminatus In the Decoder Crystal Ethereum Contract

Along with the on-chain, encoded, image grid of the 341 total parts that serve as the base of the Forgotten Runes Wizards, there exists a pairing of wizard attributes necessary to decode it. This is the Decoder Crystal.

While it exists as its own token, the Decoder Crystal contains the code to call every Wizard in the collection from the Ethereum blockchain. This means that the characters of Forgotten Runes are not dependent on outside or centralized entities to exist. As long as there is Ethereum, there are Wizards.

IPFS

The InterPlanetary File System is a peer-to-peer network used for hosting and sharing data. IPFS is popular among NFT project developers for hosting project-related images. If a token's image is stored solely on IPFS, the owner actually only owns a pointer to that image. This means that the image must have a host, or it will disappear.

One of the benefits of IPFS use for NFT project leaders is visibility and compatibility with off-chain organizations, such as OpenSea.

Forgotten Runes and IPFS

While all of the Wizards' data is stored on Ethereum and is completely reproducible, Magic Machine also includes an IPFS URL of the token image in the tokenURI

This exists solely for convenience and off-chain interoperability, rather than out of necessity for the persistence of Wizards.

Shortcomings of The Decoding Method

The main shortcoming for this method is that the traits are not accessible to other smart contracts. This could potentially create obstacles during integration with other on-chain projects (such as web3 games).

The Lost Grimoire

Community member Meph1587 has created code to remedy this issue in The Lost Grimoire, which has been deployed on Rinkeby, though it is not yet on Ethereum Mainnet.

Transactions

The transactions used to store this data are available at the following hashes:

img: "0xbb6413bd70bae87b724c30ba9e46224fa63629709e7ccfe60a39cc14aa41013e",
traits: [
  "0x227552b04af7606108d306654c620a655393451742e299e8bfd28236683da2cf",
  "0x529b29d36d07c917cc24bf162d737adc0c8ddc07003f9d5ca59876cf8167bfda",
  "0x8ec128ed9b3f4f92853d8df0ff6a2159963e81f2a611145f60a8d96990439049",
  "0xe6f0b0e76ddbc581ba3a8155ff545b7d5c31a394ac0a54b44aa9ea21525d0d06",
  "0x78a6304221ff044d3adcdb037be10aa843707f2c8241e81b4b2c6fbcb51f8b79",
  "0x74b9d75a174e76981f823d594c2c2fbcaff61e66a76be7977e0cbeb52c28f01f",
  "0x3500861637fce52bef4be39ae935e632881df4a69a47abcca8bbfc9490278dc6",
  "0x96677df7c85535328b16d93acf8cd925b87886ca2198c3654ff8d8cc56236f69",
  "0xa2977bf5ef9864796fe713db9e08f98fbbce129f4280651b6b9782c4ffdf4bd2",
  "0xe9ecc9dd5f0518617afb8593157dde0bc58d5d1e4fdb5f10a3ff8f96a81897dc"
],
affinities: "0x1be4aa782c9dc164ecbf2cd155537e7250b344f405dff03b5c33fdd63261c80e"

This data itself is also stored within the Decoder Crystal.

How to Re-create Any Wizard

To re-create a Wizard(s) entirely from on-chain data, run the following commands:

curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x0b8eb29d7a592023b5330fd9a93299bca2a9604aaa2494c87333fc56da50ec9e"],"id":67}' https://cloudflare-eth.com/ | jq -r '.result.input' | cut -c 139- | xxd --plain --reverse | head -n 297 > decoder.ts
npm init -y
npm install ethers@5.0.26 yargs@16.1.0 chalk@4.1.0 ora@5.3.0 ts-node@9.0.0 typescript@4.0.5 bson@4.4.0 sharp@0.28.3 parse-numeric-range@1.2.0 mkdirp@1.0.4 @types/yargs @types/node
./node_modules/.bin/ts-node ./decoder.ts --wizards "0-9,13,123"

It will look like this.