Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: parachain onboarding locally #10

Merged
merged 9 commits into from
Dec 13, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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 @@
---
Daanvdplas marked this conversation as resolved.
Show resolved Hide resolved
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:

Daanvdplas marked this conversation as resolved.
Show resolved Hide resolved
```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.
---
Daanvdplas marked this conversation as resolved.
Show resolved Hide resolved

# 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
Loading