Skip to content

Commit

Permalink
Merge pull request #10 from r0gue-io/feat/parachain_onboarding
Browse files Browse the repository at this point in the history
docs: parachain onboarding locally
  • Loading branch information
Daanvdplas authored Dec 13, 2024
2 parents 17a20fa + b000121 commit d19db2e
Show file tree
Hide file tree
Showing 10 changed files with 535 additions and 897 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

This file was deleted.

11 changes: 11 additions & 0 deletions pop-cli-for-appchains/guides/launch-a-chain/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
description: The following guides show how to launch a chain on Polkadot.
---

# Launch a chain on Polkadot

A typical development workflow for launching a chain on Polkadot: 

1. [Launch a Development Network](running-your-parachain.md) with predefined chains.
2. [Launch a Chain on Paseo](launch-a-chain-to-paseo.md).
4. Launch a Chain on Polkadot (same as Paseo).
53 changes: 53 additions & 0 deletions pop-cli-for-appchains/guides/launch-a-chain/coretime.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
---
description: The following guide shows how to acquire coretime.
---

# Coretime

In order to get a chain's block validated and finalised by the Relay chain it needs to acquire [coretime](https://wiki.polkadot.network/docs/learn-agile-coretime).

Acquire coretime using the following command:

```bash
pop call chain --url <relay_endpoint>
```
```bash
┌ Pop CLI : Call a chain
◇ What would you like to do?
│ Purchase on-demand coretime
◇ Enter the value for the parameter: max_amount
│ 10000000
◇ Enter the value for the parameter: para_id
│ 2000
◇ Signer of the extrinsic:
<CHAIN MANAGER ACCOUNT>
...
Event OnDemand ➜ OnDemandOrderPlaced
para_id: Id(2000)
spot_price: 1mUNIT
ordered_by: <CHAIN MANAGER ACCOUNT>
...
```

> Note: the `max_amount` (spot price willing to pay for a core) will vary depending on the Relay Network.
If the event `OnDemandOrderPlaced` is returned it means that your block will be validated and finalised!

## Resources

#### Learning Resources

* [https://paritytech.github.io/devops-guide/guides/parachain\_deployment.html](https://paritytech.github.io/devops-guide/guides/parachain\_deployment.html)
* 🧑‍🏫 To learn about Polkadot in general, [Polkadot.network](https://polkadot.network/) website is a good starting point.
* ⭕ Learn more about parachains [here](https://wiki.polkadot.network/docs/learn-parachains).
* 🧑‍🔧 For technical introduction, [here](https://github.com/paritytech/polkadot-sdk#-documentation) are the Polkadot SDK documentation resources.

**Technical Support**

* [Polkadot Stack Exchange](https://polkadot.stackexchange.com/)
* Create a question and tag it with "[`pop`](https://substrate.stackexchange.com/tags/pop/info)"
* Share the StackExchange question in our [Pop Support Telegram channel](https://t.me/pop\_support)
67 changes: 67 additions & 0 deletions pop-cli-for-appchains/guides/launch-a-chain/keys.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---
description: The following guide shows how to generate keys.
---

# Keys

There are multiple ways to generate [keys](https://wiki.polkadot.network/docs/learn-accounts) (accounts) on Polkadot, such as:

* [PolkadotJs Signer](https://polkadot.js.org/) or any other custodial&#x20;
* [PolkaVault](https://wiki.polkadot.network/docs/polkadot-vault)&#x20;
* [Subkey](https://paritytech.github.io/polkadot-sdk/master/subkey/index.html)

> Account creation should be done securely, such as using an air-gapped computer.
For the sake of this guide, we will use subkey:

#### Using Docker

```bash
docker pull parity/subkey:latest
```

Generate the key:

```bash
docker run -it parity/subkey:latest generate --scheme sr25519
```

#### On your Machine

You can download the [polkadot-sdk](https://github.com/paritytech/polkadot-sdk) and run the following command instead:

```bash
git clone --depth 1 https://github.com/paritytech/polkadot-sdk
cd polkadot-sdk
pop build
./target/debug/polkadot key generate --scheme sr25519
```

You should get an output similar to:

```bash
Secret phrase: innocent throw harsh wild example reflect sausage leopard lake bottom police enact
Network ID: substrate
Secret seed: 0xee07e6d00ebed8816d3f3839caca779dbddb52e9847159feaf1858dec6adcc6e
Public key (hex): 0xe0f20cba0c53da3ab427a5bd5b49b3214038a7b89fe4b1b7ea992d153fab495a
Account ID: 0xe0f20cba0c53da3ab427a5bd5b49b3214038a7b89fe4b1b7ea992d153fab495a
Public key (SS58): 5H9eVCvHfNMqNhMTL2FVJfy7fPgquCpvCktkMd98Dz9goRBy
SS58 Address: 5H9eVCvHfNMqNhMTL2FVJfy7fPgquCpvCktkMd98Dz9goRBy
```

> This your key (Polkadot account). Save the secret phrase in a vault securely and never share it.
## Resources

#### Learning Resources

* [https://paritytech.github.io/devops-guide/guides/parachain\_deployment.html](https://paritytech.github.io/devops-guide/guides/parachain\_deployment.html)
* 🧑‍🏫 To learn about Polkadot in general, [Polkadot.network](https://polkadot.network/) website is a good starting point.
* ⭕ Learn more about parachains [here](https://wiki.polkadot.network/docs/learn-parachains).
* 🧑‍🔧 For technical introduction, [here](https://github.com/paritytech/polkadot-sdk#-documentation) are the Polkadot SDK documentation resources.

**Technical Support**

* [Polkadot Stack Exchange](https://polkadot.stackexchange.com/)
* Create a question and tag it with "[`pop`](https://substrate.stackexchange.com/tags/pop/info)"
* Share the StackExchange question in our [Pop Support Telegram channel](https://t.me/pop\_support)
Loading

0 comments on commit d19db2e

Please sign in to comment.