Merge pull request #34 from darwinia-network/aki

Aki add crowdloan

docs/crab-crowdloan-howto-okex.md

@@ -0,0 +1,7 @@
+---
+id: crab-crowdloan-howto-okex
+title: Contribute in Okex
+sidebar_label: Contribute in Okex
+---
+
+Waiting...

docs/crab-crowdloan-howto-polkadotjs.md

@@ -0,0 +1,29 @@
+---
+id: crab-crowdloan-howto-polkadotjs
+title: Contribute through Polkadot.{js}
+sidebar_label: Contribute through Polkadot.{js}
+---
+
+Before participating in the crowdloan via Polkadot.{js}, please make sure that you have:
+
+* Import the address holding KSM into the Polkadot.{js}.
+
+* Or create a new address in the Polkadot.{js}, and transfer KSM from the centralized exchange to this address
+
+## Contribute
+
+1. Click "Network" in the toolbar —> select "Parachains" —> click "Crowdloan".
+
+   ![](./assets/crowdloan/polkadotjs.jpg)
+
+2. Select "Crab Network" in "ongoing" and click "Contribute".
+
+   ![](./assets/crowdloan/polkadotjs2.jpg)
+
+3. Enter the amount of KSM you want to contribute, and click "Contribute".
+
+   ![](./assets/crowdloan/polkadotjs3.jpg)
+
+4. Finally, sign the transaction.
+
+   ![](./assets/crowdloan/polkadotjs4.jpg)

docs/crab-crowdloan-howto-unstaking.md

@@ -0,0 +1,38 @@
+---
+id: crab-crowdloan-howto-unstaking
+title: Unstaking Your KSM Tokens on Polkadot.{js} Extension
+sidebar_label: Unstaking
+---
+
+You will need to unstake your KSM tokens prior to bonding them to the crowdloan module. For recently unstaked KSM tokens, Kusama has a delayed exit period (7 days), which serves as cooldown. During this period, you will not be able to transfer your tokens.
+
+
+## Stop nominating (staking)
+
+1. Open [Polkadot{.js}](https://polkadot.js.org/apps/) and connect to the Kusama network. Then in the navigation bar at the top of the page, click on "Network" dropdown and select "Staking".
+
+   ![unstaking1](./assets/crowdloan/unstaking1.jpg)
+
+2. Click on "Account actions" in the white sub-header towards the top of the screen. Then click "Stop" (towards the right of the screen) on the account that you'd like to unstake.
+
+   ![unstaking2](./assets/crowdloan/unstaking2.jpg)
+
+3. Click on "Sign and Submit" in the bottom right corner to authorize the transaction. Your browser extension will prompt you to enter your password and sign the transaction. You have now stopped nominating, but your tokens remain bonded.
+
+   ![unstaking3](./assets/crowdloan/unstaking3.jpg)
+
+4. To unbond your tokens, click the ellipses (three dots) on the right-hand side of the page and click on "Unbond funds".
+
+   ![unstaking5](./assets/crowdloan/unstaking5.jpg)
+
+5. Enter the amount you'd like to unbond and then click on "Unbond". Then sign and submit the transaction.
+
+   ![unstaking6](./assets/crowdloan/unstaking6.jpg)
+
+6. If done successfully, there should be a clock icon next the amount you requested to be unbonded. You can hover over the icon to see how much longer until the tokens are fully unlocked, which is approximately 7 days. Once the 7 days have passed, click on "Withdraw unbonded funds". This will make your KSM transferable. Even though it says "withdraw", they won't be leaving your account.
+
+   ![unstaking7](./assets/crowdloan/unstaking7.jpg)
+
+7. You can return to "My Accounts" and select the dropdown next to balance to see that your KSM is now transferable.
+
+   ![unstaking8](./assets/crowdloan/unstaking8.jpg)

docs/crab-crowdloan.md

@@ -1,32 +1,61 @@
 ---
 id: crab-crowdloan
-title: Kusama Parachain Slot Auctions / Crowdloan
-sidebar_label: Kusama Parachain Auctions / Crowdloan
+title: Kusama Parachain Slot Auction Crowdloan
+sidebar_label: Crowdloan
 ---
 
-[What & How-to from Kusama website](https://kusama.network/auctions)
-
 Kusama allows parachains to source KSM for their parachain bids in a decentralized crowdloan.
 
+## What can you get?
+
+* Guaranteed rewards
+
+  Every **1 KSM** donated by supporters of Crab during the Crowdloan will earn a reward of about **25 CRING** per day immediately at the end of the auction.
+
+* Rewards for a successful bid
+
+  After successfully winning the slot, we will distribute a 240,000,000 CRING prize pool and a 6,000,000 RING prize pool.
+
+* BTC Prize Lotto
+
+  In addition to NFT rewards, We will also offer a Mystery BTC Super Prize hidden somewhere in the NFT land. Within 20 days after the parachain auction is finished, all players who get the Evolution Land NFT Legendary Package lucky draw will have a chance to win the BTC lotto prize!
+
+More details in [Darwinia Crab’s Kusama Parachain Auction Strategy](https://darwinianetwork.medium.com/darwinia-crabs-kusama-parachain-auction-strategy-3f37cbfdfe4)
+
+## How to contribute?
+
+### If your KSM is in your exchange account
+
+* [Okex](./crab-crowdloan-howto-okex.md)
+
+* You can withdraw your KSM to your wallet. So, 
+
+### If your KSM is in your wallet
+
+* [Unstaking](./crab-crowdloan-howto-unstaking.md)
+
+* [Contribute through our webpage](https://crab.network/plo)
+
+* [Contribute through Polkadot.{js}](./crab-crowdloan-howto-polkadotjs.md)
+
+### About the crowdloan
+
 Anyone can create a new crowdloan campaign for a parachain slot. A campaign is configured as a range of slots (i.e. the duration the parachain will bid for), a cap, and a duration. The duration can last over several auctions, meaning that the team will not need to restart the campaign just because they do not secure a slot on their first attempt.
 
 Each created campaign will have an index. Once a crowdloan campaign is open, anyone can participate by sending a special transaction that references the campaign's index. KSM used to participate must be transferable --- that is, not locked for any reason, including staking, vesting, and governance --- because they will be moved into a module-controlled account that was generated uniquely for this campaign.
 
 > Important: All crowdloan contributions are handled by the Crowdloan module's logic where a campaign is identified by index, not by address. Never transfer KSM to an address in support of a campaign.
 
-It is up to individual parachain teams to decide if and how they want to reward participants who forgo staking and choose to lock their KSM in support of the parachain's campaign. As one can imagine, rewards will take many forms and may vary widely among projects.
-
-During some point of the crowdloan campaign the owner will upload the parachain data. Ideally, the owner does this before soliciting contributions to the campaign so that the contributors can verify it. The data can only be uploaded once during the course of the campaign and it will be what is deployed as the parachain's runtime. Of course, once the parachain is running it can always change via runtime upgrades (as determined through its own local governance).
-
-If a crowdloan campaign is successful, that parachain will be on-boarded in Kusama. The collective KSM will be locked in that parachain's account for the entire duration that it is active (up to two years).
+If a crowdloan campaign is successful, that parachain will be on-boarded in Kusama. The collective KSM will be locked in that parachain's account for the entire duration that it is active (up to 1 year, the fuchsia bar in the below picture).
 
-> ** The user's KSM will not leave their wallet (except for those hosted by the exchange). **
+> Important: The user's KSM will not leave their wallet (except for those hosted by the exchange). 
 
 Participants will be able to reclaim their KSM in one of two ways:
 
-- If the campaign was successful, then the parachain will enter a retirement phase at the end of its lease. During this phase, participants can withdraw the KSM with which they participated.
+- If the auction was successful, then the parachain will enter a retirement phase at the end of its lease. During this phase, participants can withdraw the KSM with which they participated.
 
-- If the campaign was not successful, then this retirement phase will begin at the campaign's configured end, and participants can likewise withdraw their KSM.
+- If the auction was not successful, then this retirement phase will begin at the crowdloan's configured end, and participants can likewise withdraw their KSM (at the end of the light purple bar, which is the crab's first crowdloan ).
 
-> Note that withdrawing KSM requires a transaction for each participant. Anyone can make the transactions, so a parachain team could free every participant's KSM in a batch. Tokens that are not withdrawn within a certain amount of time will go to the Kusama Treasury.
+![crowdloan.png](./assets/crowdloan/crowdloan.png)
 
+[More details in Kusama website](https://kusama.network/auctions)

i18n/zh-CN/docusaurus-plugin-content-docs/current/crab-crowdloan-howto-okex.md

@@ -0,0 +1,7 @@
+---
+id: crab-crowdloan-howto-okex
+title: Contribute in Okex
+sidebar_label: Contribute in Okex
+---
+
+Waiting...

i18n/zh-CN/docusaurus-plugin-content-docs/current/crab-crowdloan-howto-polkadotjs.md

@@ -0,0 +1,29 @@
+---
+id: crab-crowdloan-howto-polkadotjs
+title: Contribute through Polkadot.{js}
+sidebar_label: Contribute through Polkadot.{js}
+---
+
+Before participating in the crowdloan via Polkadot.{js}, please make sure that you have:
+
+* Import the address holding KSM into the Polkadot.{js}.
+
+* Or create a new address in the Polkadot.{js}, and transfer KSM from the centralized exchange to this address
+
+## Contribute
+
+1. Click "Network" in the toolbar —> select "Parachains" —> click "Crowdloan".
+
+   ![](./assets/crowdloan/polkadotjs.jpg)
+
+2. Select "Crab Network" in "ongoing" and click "Contribute".
+
+   ![](./assets/crowdloan/polkadotjs2.jpg)
+
+3. Enter the amount of KSM you want to contribute, and click "Contribute".
+
+   ![](./assets/crowdloan/polkadotjs3.jpg)
+
+4. Finally, sign the transaction.
+
+   ![](./assets/crowdloan/polkadotjs4.jpg)

i18n/zh-CN/docusaurus-plugin-content-docs/current/crab-crowdloan-howto-unstaking.md

@@ -0,0 +1,38 @@
+---
+id: crab-crowdloan-howto-unstaking
+title: Unstaking Your KSM Tokens on Polkadot.{js} Extension
+sidebar_label: Unstaking
+---
+
+You will need to unstake your KSM tokens prior to bonding them to the crowdloan module. For recently unstaked KSM tokens, Kusama has a delayed exit period (7 days), which serves as cooldown. During this period, you will not be able to transfer your tokens.
+
+
+## Stop nominating (staking)
+
+1. Open [Polkadot{.js}](https://polkadot.js.org/apps/) and connect to the Kusama network. Then in the navigation bar at the top of the page, click on "Network" dropdown and select "Staking".
+
+   ![unstaking1](./assets/crowdloan/unstaking1.jpg)
+
+2. Click on "Account actions" in the white sub-header towards the top of the screen. Then click "Stop" (towards the right of the screen) on the account that you'd like to unstake.
+
+   ![unstaking2](./assets/crowdloan/unstaking2.jpg)
+
+3. Click on "Sign and Submit" in the bottom right corner to authorize the transaction. Your browser extension will prompt you to enter your password and sign the transaction. You have now stopped nominating, but your tokens remain bonded.
+
+   ![unstaking3](./assets/crowdloan/unstaking3.jpg)
+
+4. To unbond your tokens, click the ellipses (three dots) on the right-hand side of the page and click on "Unbond funds".
+
+   ![unstaking5](./assets/crowdloan/unstaking5.jpg)
+
+5. Enter the amount you'd like to unbond and then click on "Unbond". Then sign and submit the transaction.
+
+   ![unstaking6](./assets/crowdloan/unstaking6.jpg)
+
+6. If done successfully, there should be a clock icon next the amount you requested to be unbonded. You can hover over the icon to see how much longer until the tokens are fully unlocked, which is approximately 7 days. Once the 7 days have passed, click on "Withdraw unbonded funds". This will make your KSM transferable. Even though it says "withdraw", they won't be leaving your account.
+
+   ![unstaking7](./assets/crowdloan/unstaking7.jpg)
+
+7. You can return to "My Accounts" and select the dropdown next to balance to see that your KSM is now transferable.
+
+   ![unstaking8](./assets/crowdloan/unstaking8.jpg)

i18n/zh-CN/docusaurus-plugin-content-docs/current/crab-crowdloan.md

@@ -1,31 +1,61 @@
 ---
 id: crab-crowdloan
-title: Kusama 平行链拍卖众贷
-sidebar_label: Kusama 平行链拍卖众贷
+title: Kusama Parachain Slot Auction Crowdloan
+sidebar_label: Crowdloan
 ---
 
-[Kusama 官网关于拍卖和众贷的信息](https://translate.google.com/translate?sl=en&tl=zh-CN&u=https://kusama.network/auctions)
+Kusama allows parachains to source KSM for their parachain bids in a decentralized crowdloan.
 
-Kusama 允许平行链在去中心化的众贷系统中为平行链竞拍提供 KSM。
+## What can you get?
 
-任何平行链项目团队都可以为平行链插槽创建新的众贷活动。一次众贷活动需要提供插槽使用时间（即，平行链将竞标的持续时间），上限和众贷的持续时间。在众贷时间范围内可以持续数次拍卖，这意味着团队无需因为没有在第一次尝试中获得插槽而重新开启众贷。
+* Guaranteed rewards
 
-每个已创建的众贷都会有一个 Index。众贷开启后，任何人都可以通过发送一笔包含项目方 Index 的特殊交易来参与。用于参与众贷的 KSM 必须为可交易的状态，不包括任何形式的锁定，如质押、投票或者治理）。
+  Every **1 KSM** donated by supporters of Crab during the Crowdloan will earn a reward of about **25 CRING** per day immediately at the end of the auction.
 
-> 重要提示：所有众贷捐款均由众贷模块的逻辑处理。为了准确识别项目方，请填写相应众贷活动的 Index 而非地址。
+* Rewards for a successful bid
 
-平行链项目方可以决定是否以及如何奖励那些放弃质押收益的参与者，并选择锁定他们的 KSM 以支持平行链的竞选活动。可以想象，奖励将采用多种形式，并且在各个项目中可能会有很大差异。
+  After successfully winning the slot, we will distribute a 240,000,000 CRING prize pool and a 6,000,000 RING prize pool.
 
-在众贷活动的某个阶段，项目方将上传平行链数据。理想情况下，项目方在向参与贡献的用户发放奖励前进行此操作，以便参与的用户可以对其进行验证。在活动过程中，数据只能上传一次，这将作为平行链的 runtime 部署。当然，一旦平行链开始运行，它可以通过升级 rumtime 来更改（由其自身的本地治理确定）。
+* BTC Prize Lotto
 
-如果众筹活动成功，该平行链将在 Kusama 网络上线。筹集的KSM在活动期间（最多两年）将被锁定在该平行链账户中。
+  In addition to NFT rewards, We will also offer a Mystery BTC Super Prize hidden somewhere in the NFT land. Within 20 days after the parachain auction is finished, all players who get the Evolution Land NFT Legendary Package lucky draw will have a chance to win the BTC lotto prize!
 
-> 注意：用户的 KSM 不会脱离用户的钱包账户(托管给交易所的除外）
+More details in [Darwinia Crab’s Kusama Parachain Auction Strategy](https://darwinianetwork.medium.com/darwinia-crabs-kusama-parachain-auction-strategy-3f37cbfdfe4)
 
-参与者将能够通过以下两种方式之一来收回其 KSM：
+## How to contribute?
 
-- 如果活动成功，则平行链将在其租约结束时进入退出阶段。在此阶段中，参与者可以赎回参与的 KSM。
+### If your KSM is in your exchange account
 
-- 如果竞选未成功，则可以在竞选结束后的退出阶段内，参与者也可以撤回其 KSM。
+* [Okex](./crab-crowdloan-howto-okex.md)
 
-> 注意，退出 KSM 需要为每个参与者进行交易。任何人都可以进行交易，因此平行链团队可以批量释放每个参与者的 KSM。在一定时间内未撤出的代币将进入 Kusama 国库。
+* You can withdraw your KSM to your wallet. So, 
+
+### If your KSM is in your wallet
+
+* [Unstaking](./crab-crowdloan-howto-unstaking.md)
+
+* [Contribute through our webpage](https://crab.network/plo)
+
+* [Contribute through Polkadot.{js}](./crab-crowdloan-howto-polkadotjs.md)
+
+### About the crowdloan
+
+Anyone can create a new crowdloan campaign for a parachain slot. A campaign is configured as a range of slots (i.e. the duration the parachain will bid for), a cap, and a duration. The duration can last over several auctions, meaning that the team will not need to restart the campaign just because they do not secure a slot on their first attempt.
+
+Each created campaign will have an index. Once a crowdloan campaign is open, anyone can participate by sending a special transaction that references the campaign's index. KSM used to participate must be transferable --- that is, not locked for any reason, including staking, vesting, and governance --- because they will be moved into a module-controlled account that was generated uniquely for this campaign.
+
+> Important: All crowdloan contributions are handled by the Crowdloan module's logic where a campaign is identified by index, not by address. Never transfer KSM to an address in support of a campaign.
+
+If a crowdloan campaign is successful, that parachain will be on-boarded in Kusama. The collective KSM will be locked in that parachain's account for the entire duration that it is active (up to 1 year, the fuchsia bar in the below picture).
+
+> Important: The user's KSM will not leave their wallet (except for those hosted by the exchange). 
+
+Participants will be able to reclaim their KSM in one of two ways:
+
+- If the auction was successful, then the parachain will enter a retirement phase at the end of its lease. During this phase, participants can withdraw the KSM with which they participated.
+
+- If the auction was not successful, then this retirement phase will begin at the crowdloan's configured end, and participants can likewise withdraw their KSM (at the end of the light purple bar, which is the crab's first crowdloan ).
+
+![crowdloan.png](./assets/crowdloan/crowdloan.png)
+
+[More details in Kusama website](https://kusama.network/auctions)

sidebars.js

@@ -3,7 +3,6 @@ module.exports = {
     "Crab Network": [
       'crab-home', 
       'crab-tools', 
-      'crab-crowdloan',
       'crab-parameters'
     ],
 
@@ -20,6 +19,13 @@ module.exports = {
       'crab-tut-exchange'
     ],
 
+    "Kusama Auction": [
+      'crab-crowdloan',
+      'crab-crowdloan-howto-unstaking',
+      'crab-crowdloan-howto-polkadotjs',
+      'crab-crowdloan-howto-okex',
+    ],
+
     "DVM": [
       'dvm-intro',
       {