git.delta.rocks / unique-network / refs/commits / 2bca9fee0736

difftreelog

Merge branch 'doc/end_user'

Greg Zaitsev2020-05-06parents: #623e2e2 #5903896.patch.diff
in: master

4 files changed

modifiedREADME.mddiffbeforeafterboth
before · README.md
1# Substrate Node Template23A new Substrate node, ready for hacking. This node includes:45* A FRAME-based runtime6* A template pallet7* Aura block authoring8* Grandpa finality gadget910## Build1112Install Rust:1314```bash15curl https://sh.rustup.rs -sSf | sh16```1718Initialize your Wasm Build environment:1920```bash21./scripts/init.sh22```2324Build Wasm and native code:2526```bash27cargo build --release28```2930## Run3132### Single Node Development Chain3334Purge any existing developer chain state:3536```bash37./target/release/node-template purge-chain --dev38```3940Start a development chain with:4142```bash43./target/release/node-template --dev44```4546Detailed logs may be shown by running the node with the following environment variables set: `RUST_LOG=debug RUST_BACKTRACE=1 cargo run -- --dev`.4748### Multi-Node Local Testnet4950If 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.5152Optionally, give each node a name and expose them so they are listed on the Polkadot [telemetry site](https://telemetry.polkadot.io/#/Local%20Testnet).5354You'll need two terminal windows open.5556We'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 `QmRpheLN4JWdAnY7HGJfWFNbfkQCb6tFf4vvA6hgjMZKrR`, which is generated from the `--node-key` value that we specify below:5758```bash59cargo run -- \60  --base-path /tmp/alice \61  --chain=local \62  --alice \63  --node-key 0000000000000000000000000000000000000000000000000000000000000001 \64  --telemetry-url ws://telemetry.polkadot.io:1024 \65  --validator66```6768In 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:6970```bash71cargo run -- \72  --base-path /tmp/bob \73  --bootnodes /ip4/127.0.0.1/tcp/30333/p2p/QmRpheLN4JWdAnY7HGJfWFNbfkQCb6tFf4vvA6hgjMZKrR \74  --chain=local \75  --bob \76  --port 30334 \77  --telemetry-url ws://telemetry.polkadot.io:1024 \78  --validator79```8081Additional CLI usage options are available and may be shown by running `cargo run -- --help`.8283## Advanced: Generate Your Own Substrate Node Template8485A substrate node template is always based on a certain version of Substrate. You can inspect it by86opening [Cargo.toml](Cargo.toml) and see the template referred to a specific Substrate commit(87`rev` field), branch, or version.8889You can generate your own Substrate node-template based on a particular Substrate90version/commit by running following commands:9192```bash93# git clone from the main Substrate repo94git clone https://github.com/paritytech/substrate.git95cd substrate9697# Switch to a particular branch or commit of the Substrate repo your node-template based on98git checkout <branch/tag/sha1>99100# Run the helper script to generate a node template.101# This script compiles Substrate and takes a while to complete. It takes a relative file path102#   from the current dir. to output the compressed node template.103.maintain/node-template-release.sh ../node-template.tar.gz104```105106Noted though you will likely get faster and more thorough support if you stick with the releases107provided in this repository.
addeddoc/application_development.mddiffbeforeafterboth
--- /dev/null
+++ b/doc/application_development.md
@@ -0,0 +1,221 @@
+# Building an NFT Application
+
+## Architecture
+
+Both centralized and serverless architectures are supported and application creator can decide which one to use depending on how much logic and data they intend to manage off-chain and off-line.
+
+### Server-based architecture
+
+In server-based architecture the application creator manually creates NFT collections and authorizes server to perform operations on each collection. See NFT palette methods that have admin permission level to understand better what server (or administrators) can do.
+
+![](server_architecture.png)
+
+### Serverless architecture
+
+In serverless architecture the application creator does all initialization and token distribution manually. Alternatively, smart contracts may be used in order to implement some distribution mechanics such as token sales or claiming. The dApp has access to all properties of an NFT token, but it does not have any elevated permissions, since it resides on user site. All operations happen on user's behalf signed by user's private key.
+
+![](serverless_architecture.png)
+
+## NFT Palette Methods
+
+### Collection Management
+
+#### CreateCollection
+
+##### Description
+This method creates a Collection of NFTs. Each Token may have multiple properties encoded as an array of bytes of certain length. The initial owner and admin of the collection are set to the address that signed the transaction. Both addresses can be changed later.
+
+##### Permissions
+Anyone
+
+##### Parameters
+customDataSz: Size of NFT properties data.
+
+##### Events
+CollectionCreated
+CollectionID: Globally unique identifier of newly created collection.
+Owner: Collection owner
+
+#### ChangeCollectionOwner
+
+##### Description
+Change the owner of the collection
+
+##### Permissions
+Collection Owner
+
+##### Parameters
+CollectionId
+
+#### DestroyCollection
+
+##### Description
+DANGEROUS: Destroys collection and all NFTs within this collection. Users irrecoverably lose their assets and may lose real money.
+
+##### Permissions
+Collection Owner
+
+##### Parameters
+CollectionId
+
+#### CreateItem
+
+##### Description
+This method creates a concrete instance of NFT Collection created with CreateCollection method.
+
+##### Permissions
+Collection Owner
+Collection Admin
+
+##### Parameters
+CollectionID: ID of the collection
+Properties: Array of bytes that contains NFT properties. Since NFT Module is agnostic of properties’ meaning, it is treated purely as an array of bytes
+Owner: Address, initial owner of the NFT
+
+##### Events
+ItemCreated
+ItemId: Identifier of newly created NFT, which is unique within the Collection, so the NFT is uniquely identified with a pair of values: CollectionId and ItemId.
+
+#### BurnItem
+
+##### Description
+This method destroys a concrete instance of NFT.
+
+##### Permissions
+Collection Owner
+Collection Admin
+Current NFT Owner
+
+##### Parameters
+CollectionID: ID of the collection
+ItemID: ID of NFT to burn
+
+##### Events
+ItemDestroyed
+CollectionID
+ItemId: Identifier of burned NFT
+
+
+#### AddCollectionAdmin
+
+##### Description
+NFT Collection can be controlled by multiple admin addresses (some which can also be servers, for example). Admins can issue and burn NFTs, as well as add and remove other admins, but cannot change NFT or Collection ownership.
+
+This method adds an admin of the Collection.
+
+##### Permissions
+Collection Owner
+Collection Admin
+
+##### Parameters
+CollectionID: ID of the Collection to add admin for
+Admin: Address of new admin to add
+
+#### RemoveCollectionAdmin
+
+##### Description
+Remove admin address of the Collection. An admin address can remove itself. List of admins may become empty, in which case only Collection Owner will be able to add an Admin.
+
+##### Permissions
+Collection Owner
+Collection Admin
+
+##### Parameters
+CollectionID: ID of the Collection to remove admin for
+Admin: Address of admin to remove
+
+### Item Ownership and Transfers
+This group of methods allows managing NFT ownership.
+
+#### GetOwner
+
+##### Description
+Return the address of the NFT owner. 
+
+##### Permissions
+Anyone
+
+##### Parameters
+CollectionId
+ItemId: ID of the NFT
+
+##### Returns
+Owner address
+
+#### BalanceOf
+
+##### Description
+This method is included for compatibility with ERC-721. Return the total count of NFTs of a given Collection that belong to a given address. 
+
+##### Permissions
+Anyone
+
+##### Parameters
+CollectionId
+Address to count NFTs for
+
+##### Returns
+Total count of NFTs for Address
+
+
+#### Transfer
+
+##### Description
+Change ownership of the NFT.
+
+##### Permissions
+Collection Owner
+Collection Admin
+Current NFT owner
+
+##### Parameters
+Recipient: Address of token recipient
+ClassId: ID of item class
+ItemId: ID of the item
+
+#### TransferFrom
+
+##### Description
+Change ownership of a NFT on behalf of the owner. See Approve method for additional information. After this method executes, the approval is removed so that the approved address will not be able to transfer this NFT again from this owner.
+
+##### Permissions
+Collection Owner
+Collection Admin
+Current NFT owner
+Address approved by current NFT owner
+
+##### Parameters
+Recipient: Address of token recipient
+ClassId: ID of item class
+ItemId: ID of the item
+
+
+#### Approve
+
+##### Description
+Set, change, or remove approved address to transfer the ownership of the NFT.
+
+##### Permissions
+Collection Owner
+Collection Admin
+Current NFT owner
+
+##### Parameters
+Approved: Address that is approved to transfer this NFT or zero (if needed to remove approval)
+ClassId: ID of item class
+ItemId: ID of the item
+
+#### GetApproved
+
+##### Description
+Get the approved address for a single NFT.
+
+##### Permissions
+Anyone
+
+##### Parameters
+ClassId: ID of item class
+ItemId: ID of the item
+
+##### Returns
+Approved address
addeddoc/server_architecture.pngdiffbeforeafterboth

binary blob — no preview

addeddoc/serverless_architecture.pngdiffbeforeafterboth

binary blob — no preview