difftreelog
Update README
in: master
1 file changed
README.mddiffbeforeafterboth123# NFT Parachain45## Project Description67The NFT Pallet is the core of NFT functionality. Like ERC-721 standard in Ethereum ecosystem, this pallet provides the basement for creating collections of unique non-divisible things, also called Non Fungible Tokens (NFTs), minting NFT of a given Collection, and managing their ownership.89The pallet also enables storing NFT properties. Though (according to ERC-721) NFT properties belong to logic of a concrete application that operates a Collection, so purposefully the NFT Tracking Module does not have any knowledge about properties except their byte size leaving application logic out to be controller by Smart Contracts.1011The NFT Chain also provides:1213* Smart Contracts Pallet and example smart contract that interacts with NFT Runtime14* ERC-1155 Functionality (currently PoC as Re-Fungible tokens)15* Variety of economic options for dapp producers to choose from to create freemium games and other ways to attract users16* Solutions that allow non-blockchain developers to quickly deploy dApps for mass markets17* Interoperability that allows reaching much bigger audiences18* Scalability on par with non-blockhcain solutions1920## Kusama Hackaphon Update2122During the Kusama Hackaphon the following changes were made:23* Enabled Smart Contracts Pallet24* Enabled integration between Smart Contracts and NFT Pallet (required special edition of RC4 Substrate version)25* Fixed misc. bugs in NFT Pallet26* Deployed NFT TestNet. Public node available at wss://unique.usetech.com, custom UI types - see below in this README.27* New Features:28 * Re-Fungible Token Mode29 * Off-Chain Schema to store token image URLs30 * Alternative economic model31 * White Lists and Public Mint Permission32* Use example: [SubstraPunks Game](https://github.com/usetech-llc/substrapunks), fully hosted on IPFS and NFT Testnet Blockchain.3334## Application Development3536If you are building an application that operates NFT tokens, use [this document](doc/application_development.md).3738## Building3940Building NFT chain requires special versions of Rust and toolchain. We don't use the most recent versions of everything so that we can keep the builds stable.41421. Install Rust:4344```bash45curl https://sh.rustup.rs -sSf | sh46sudo apt-get install libssl-dev pkg-config libclang-dev clang47```48492. Remove all installed toolchains with `rustup toolchain list` and `rustup toolchain uninstall <toolchain>`.50513. Install Rust Toolchain 1.44.0:5253```bash54rustup install 1.44.055```56574. Make it default (actual toochain version may be different, so do a `rustup toolchain list` first)58```bash59rustup toolchain list60rustup default 1.44.0-x86_64-unknown-linux-gnu61```62635. Install nightly toolchain and add wasm target for it:6465```bash66rustup toolchain install nightly-2020-05-0167rustup target add wasm32-unknown-unknown --toolchain nightly-2020-05-01-x86_64-unknown-linux-gnu68```69706. Build:71```bash72cargo build73```7475## Run7677You can start a development chain with:7879```bash80cargo run -- --dev81```8283Detailed logs may be shown by running the node with the following environment variables set: `RUST_LOG=debug RUST_BACKTRACE=1 cargo run -- --dev`.8485If you want to see the multi-node consensus algorithm in action locally, then you can create a local testnet with two validator nodes for Alice and Bob, who are the initial authorities of the genesis chain that have been endowed with testnet units. Give each node a name and expose them so they are listed on the Polkadot [telemetry site](https://telemetry.polkadot.io/#/Local%20Testnet). You'll need two terminal windows open.8687We'll start Alice's substrate node first on default TCP port 30333 with her chain database stored locally at `/tmp/alice`. The bootnode ID of her node is `QmQZ8TjTqeDj3ciwr93EJ95hxfDsb9pEYDizUAbWpigtQN`, which is generated from the `--node-key` value that we specify below:8889```bash90cargo run -- \91 --base-path /tmp/alice \92 --chain=local \93 --alice \94 --node-key 0000000000000000000000000000000000000000000000000000000000000001 \95 --telemetry-url ws://telemetry.polkadot.io:1024 \96 --validator97```9899In the second terminal, we'll start Bob's substrate node on a different TCP port of 30334, and with his chain database stored locally at `/tmp/bob`. We'll specify a value for the `--bootnodes` option that will connect his node to Alice's bootnode ID on TCP port 30333:100101```bash102cargo run -- \103 --base-path /tmp/bob \104 --bootnodes /ip4/127.0.0.1/tcp/30333/p2p/QmQZ8TjTqeDj3ciwr93EJ95hxfDsb9pEYDizUAbWpigtQN \105 --chain=local \106 --bob \107 --port 30334 \108 --telemetry-url ws://telemetry.polkadot.io:1024 \109 --validator110```111112Additional CLI usage options are available and may be shown by running `cargo run -- --help`.113114115## UI custom types116```117{118 "Schedule": {119 "version": "u32",120 "put_code_per_byte_cost": "Gas",121 "grow_mem_cost": "Gas",122 "regular_op_cost": "Gas",123 "return_data_per_byte_cost": "Gas",124 "event_data_per_byte_cost": "Gas",125 "event_per_topic_cost": "Gas",126 "event_base_cost": "Gas",127 "call_base_cost": "Gas",128 "instantiate_base_cost": "Gas",129 "dispatch_base_cost": "Gas",130 "sandbox_data_read_cost": "Gas",131 "sandbox_data_write_cost": "Gas",132 "transfer_cost": "Gas",133 "instantiate_cost": "Gas",134 "max_event_topics": "u32",135 "max_stack_height": "u32",136 "max_memory_pages": "u32",137 "max_table_size": "u32",138 "enable_println": "bool",139 "max_subject_len": "u32"140 },141 "CollectionMode": {142 "_enum": {143 "Invalid": null,144 "NFT": "u32",145 "Fungible": "u32",146 "ReFungible": "(u32, u32)"147 }148 },149 "NftItemType": {150 "Collection": "u64",151 "Owner": "AccountId",152 "Data": "Vec<u8>"153 },154 "Ownership": {155 "owner": "AccountId",156 "fraction": "u128"157 },158 "ReFungibleItemType": {159 "Collection": "u64",160 "Owner": "Vec<Ownership<AccountId>>",161 "Data": "Vec<u8>"162 },163 "CollectionType": {164 "Owner": "AccountId",165 "Mode": "CollectionMode",166 "Access": "u8",167 "DecimalPoints": "u32",168 "Name": "Vec<u16>",169 "Description": "Vec<u16>",170 "TokenPrefix": "Vec<u8>",171 "CustomDataSize": "u32",172 "OffchainSchema": "Vec<u8>",173 "Sponsor": "AccountId",174 "UnconfirmedSponsor": "AccountId"175 },176 "RawData": "Vec<u8>",177 "Address": "AccountId",178 "LookupSource": "AccountId",179 "Weight": "u64"180}181```123# NFT Parachain45## Project Description67The NFT Pallet is the core of NFT functionality. Like ERC-721 standard in Ethereum ecosystem, this pallet provides the basement for creating collections of unique non-divisible things, also called Non Fungible Tokens (NFTs), minting NFT of a given Collection, and managing their ownership.89The pallet also enables storing NFT properties. Though (according to ERC-721) NFT properties belong to logic of a concrete application that operates a Collection, so purposefully the NFT Tracking Module does not have any knowledge about properties except their byte size leaving application logic out to be controller by Smart Contracts.1011The NFT Chain also provides:1213* Smart Contracts Pallet and example smart contract that interacts with NFT Runtime14* ERC-1155 Functionality (currently PoC as Re-Fungible tokens, i.e. items that are still unique, but that can be split between multiple users)15* Variety of economic options for dapp producers to choose from to create freemium games and other ways to attract users. As a step one, we implemented an economic model when a collection sponsor can be set to pay for collection Transfer transactions.161718## Kusama Hackaphon Update1920During the Kusama Hackaphon the following changes were made:21* Enabled Smart Contracts Pallet22* Enabled integration between Smart Contracts and NFT Pallet (required special edition of RC4 Substrate version)23* Fixed misc. bugs in NFT Pallet24* Deployed NFT TestNet. Public node available at wss://unique.usetech.com, custom UI types - see below in this README.25* New Features:26 * Re-Fungible Token Mode27 * Off-Chain Schema to store token image URLs28 * Alternative economic model29 * White Lists and Public Mint Permission30* Use example: [SubstraPunks Game](https://github.com/usetech-llc/substrapunks), fully hosted on IPFS and NFT Testnet Blockchain.3132## Application Development3334If you are building an application that operates NFT tokens, use [this document](doc/application_development.md).3536## Building3738Building NFT chain requires special versions of Rust and toolchain. We don't use the most recent versions of everything so that we can keep the builds stable.39401. Install Rust:4142```bash43curl https://sh.rustup.rs -sSf | sh44sudo apt-get install libssl-dev pkg-config libclang-dev clang45```46472. Remove all installed toolchains with `rustup toolchain list` and `rustup toolchain uninstall <toolchain>`.48493. Install Rust Toolchain 1.44.0:5051```bash52rustup install 1.44.053```54554. Make it default (actual toochain version may be different, so do a `rustup toolchain list` first)56```bash57rustup toolchain list58rustup default 1.44.0-x86_64-unknown-linux-gnu59```60615. Install nightly toolchain and add wasm target for it:6263```bash64rustup toolchain install nightly-2020-05-0165rustup target add wasm32-unknown-unknown --toolchain nightly-2020-05-01-x86_64-unknown-linux-gnu66```67686. Build:69```bash70cargo build71```7273## Run7475You can start a development chain with:7677```bash78cargo run -- --dev79```8081Detailed logs may be shown by running the node with the following environment variables set: `RUST_LOG=debug RUST_BACKTRACE=1 cargo run -- --dev`.8283If you want to see the multi-node consensus algorithm in action locally, then you can create a local testnet with two validator nodes for Alice and Bob, who are the initial authorities of the genesis chain that have been endowed with testnet units. Give each node a name and expose them so they are listed on the Polkadot [telemetry site](https://telemetry.polkadot.io/#/Local%20Testnet). You'll need two terminal windows open.8485We'll start Alice's substrate node first on default TCP port 30333 with her chain database stored locally at `/tmp/alice`. The bootnode ID of her node is `QmQZ8TjTqeDj3ciwr93EJ95hxfDsb9pEYDizUAbWpigtQN`, which is generated from the `--node-key` value that we specify below:8687```bash88cargo run -- \89 --base-path /tmp/alice \90 --chain=local \91 --alice \92 --node-key 0000000000000000000000000000000000000000000000000000000000000001 \93 --telemetry-url ws://telemetry.polkadot.io:1024 \94 --validator95```9697In the second terminal, we'll start Bob's substrate node on a different TCP port of 30334, and with his chain database stored locally at `/tmp/bob`. We'll specify a value for the `--bootnodes` option that will connect his node to Alice's bootnode ID on TCP port 30333:9899```bash100cargo run -- \101 --base-path /tmp/bob \102 --bootnodes /ip4/127.0.0.1/tcp/30333/p2p/QmQZ8TjTqeDj3ciwr93EJ95hxfDsb9pEYDizUAbWpigtQN \103 --chain=local \104 --bob \105 --port 30334 \106 --telemetry-url ws://telemetry.polkadot.io:1024 \107 --validator108```109110Additional CLI usage options are available and may be shown by running `cargo run -- --help`.111112113## UI custom types114```115{116 "Schedule": {117 "version": "u32",118 "put_code_per_byte_cost": "Gas",119 "grow_mem_cost": "Gas",120 "regular_op_cost": "Gas",121 "return_data_per_byte_cost": "Gas",122 "event_data_per_byte_cost": "Gas",123 "event_per_topic_cost": "Gas",124 "event_base_cost": "Gas",125 "call_base_cost": "Gas",126 "instantiate_base_cost": "Gas",127 "dispatch_base_cost": "Gas",128 "sandbox_data_read_cost": "Gas",129 "sandbox_data_write_cost": "Gas",130 "transfer_cost": "Gas",131 "instantiate_cost": "Gas",132 "max_event_topics": "u32",133 "max_stack_height": "u32",134 "max_memory_pages": "u32",135 "max_table_size": "u32",136 "enable_println": "bool",137 "max_subject_len": "u32"138 },139 "CollectionMode": {140 "_enum": {141 "Invalid": null,142 "NFT": "u32",143 "Fungible": "u32",144 "ReFungible": "(u32, u32)"145 }146 },147 "NftItemType": {148 "Collection": "u64",149 "Owner": "AccountId",150 "Data": "Vec<u8>"151 },152 "Ownership": {153 "owner": "AccountId",154 "fraction": "u128"155 },156 "ReFungibleItemType": {157 "Collection": "u64",158 "Owner": "Vec<Ownership<AccountId>>",159 "Data": "Vec<u8>"160 },161 "CollectionType": {162 "Owner": "AccountId",163 "Mode": "CollectionMode",164 "Access": "u8",165 "DecimalPoints": "u32",166 "Name": "Vec<u16>",167 "Description": "Vec<u16>",168 "TokenPrefix": "Vec<u8>",169 "CustomDataSize": "u32",170 "OffchainSchema": "Vec<u8>",171 "Sponsor": "AccountId",172 "UnconfirmedSponsor": "AccountId"173 },174 "RawData": "Vec<u8>",175 "Address": "AccountId",176 "LookupSource": "AccountId",177 "Weight": "u64"178}179```