Add Obtain Coretime page (#1104)

* add parachains/launch-a-parachain/obtain-coretime.md

* Update parachains/launch-a-parachain/obtain-coretime.md

Co-authored-by: Nicolás Hussein <[email protected]>

* Update content

* grammar and formatting

* update image names and fix links

* minor edits

* fix

---------

Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>

Author: 3 people

.ai/categories/parachains.md

@@ -16537,84 +16537,177 @@ Page Title: Obtain Coretime
 
 - Source (raw): https://raw.githubusercontent.com/polkadot-developers/polkadot-docs/master/.ai/pages/parachains-launch-a-parachain-obtain-coretime.md
 - Canonical (HTML): https://docs.polkadot.com/parachains/launch-a-parachain/obtain-coretime/
-- Summary: Learn how to obtain and manage coretime for your Polkadot parachain. Explore bulk and on-demand options, prerequisites, and initial setup.
+- Summary: Learn how to obtain coretime for block production with this guide, covering both on-demand and bulk options for smooth operations.
 
 # Obtain Coretime
 
 ## Introduction
 
-Securing coretime is essential for operating a parachain on Polkadot. It provides your parachain with guaranteed computational resources and access to Polkadot's shared security model, ensuring your blockchain can process transactions, maintain its state, and interact securely with other parachains in the network. Without coretime, a parachain cannot participate in the ecosystem or leverage the relay chain's validator set for security.
+After deploying a parachain to Paseo in the [Deploy on Polkadot](/parachains/launch-a-parachain/deploy-to-polkadot/){target=\_blank} tutorial, the next critical step is obtaining coretime. Coretime is the mechanism through which validation resources are allocated from the relay chain to your parachain. Your parachain can only produce and finalize blocks on the relay chain by obtaining coretime.
 
-Coretime represents the computational resources allocated to your parachain on the Polkadot network. It determines when and how often your parachain can produce blocks and have them validated by the relay chain.
+There are two primary ways to obtain coretime:
 
-There are two primary methods to obtain coretime:
+- **[On-demand coretime](#order-on-demand-coretime)**: Purchase coretime on a block-by-block basis, ideal for variable or unpredictable workloads.
+- **[Bulk coretime](#purchase-bulk-coretime)**: Obtain a core or portion of a core for an extended period (up to 28 days), requiring renewal upon lease expiration.
 
-- **Bulk coretime**: Purchase computational resources in advance for a full month.
-- **On-demand coretime**: Buy computational resources as needed for individual block production.
+In this tutorial, you will:
 
-This guide explains the different methods of obtaining coretime and walks through the necessary steps to get your parachain running. 
+- Understand the different coretime options available.
+- Learn how to purchase a core via bulk coretime.
+- Assign your parachain to a core for block production.
+- Explore on-demand coretime as an alternative approach.
 
 ## Prerequisites
 
-Before obtaining coretime, ensure you have:
+Before proceeding, ensure you have the following:
 
-- Developed your parachain runtime using the Polkadot SDK.
-- Set up and configured a parachain collator for your target relay chain.
-- Successfully compiled your parachain collator node.
-- Generated and exported your parachain's genesis state.
-- Generated and exported your parachain's validation code (Wasm).
+- A parachain ID reserved on Paseo.
+- A properly configured chain specification file (both plain and raw versions).
+- A registered parathread with the correct genesis state and runtime.
+- A synced collator node running and connected to the Paseo relay chain.
+- [PAS tokens](https://faucet.polkadot.io/?parachain=1005){target=\_blank} in your account on the Coretime Chain for transaction fees.
 
-## Initial Setup Steps
+If you haven't completed these prerequisites, start by referring to the [Deploy on Polkadot](/parachains/launch-a-parachain/deploy-to-polkadot/){target=\_blank} tutorial.
 
-1. Reserve a unique identifier, `ParaID`, for your parachain:
+## Order On-Demand Coretime
 
-    1. Connect to the relay chain.
-    2. Submit the [`registrar.reserve`](https://paritytech.github.io/polkadot-sdk/master/polkadot_runtime_common/paras_registrar/pallet/dispatchables/fn.reserve.html){target=\_blank} extrinsic.
+On-demand coretime allows you to purchase validation resources on a per-block basis. This approach is useful when you don't need continuous block production or want to test your parachain before committing to bulk coretime.
 
-    Upon success, you'll receive a registered `ParaID`.
+### On-Demand Extrinsics
 
-2. Register your parachain's essential information by submitting the [`registrar.register`](https://paritytech.github.io/polkadot-sdk/master/polkadot_runtime_common/paras_registrar/pallet/dispatchables/fn.register.html){target=\_blank} extrinsic with the following parameters:
+There are two extrinsics available for ordering on-demand coretime:
 
-    - **`id`**: Your reserved `ParaID`.
-    - **`genesisHead`**: Your exported genesis state.
-    - **`validationCode`**: Your exported Wasm validation code.
+- **[`onDemand.placeOrderAllowDeath`](https://paritytech.github.io/polkadot-sdk/master/polkadot_runtime_parachains/on_demand/pallet/struct.Pallet.html#method.place_order_allow_death){target=\_blank}**: Will [reap](https://wiki.polkadot.com/learn/learn-accounts/#existential-deposit-and-reaping){target=\_blank} the account once the provided funds are depleted.
+- **[`onDemand.placeOrderKeepAlive`](https://paritytech.github.io/polkadot-sdk/master/polkadot_runtime_parachains/on_demand/pallet/struct.Pallet.html#method.place_order_keep_alive){target=\_blank}**: Includes a check to prevent reaping the account, ensuring it remains alive even if funds run out.
 
-3. Start your parachain collator and begin synchronization with the relay chain.
+### Place an On-Demand Order
 
-## Obtaining Coretime
+To place an on-demand coretime order, follow these steps:
 
-### Bulk Coretime
+1. Open the [Polkadot.js Apps interface connected to the Polkadot TestNet (Paseo)](https://polkadot.js.org/apps/?rpc=wss://paseo.dotters.network){target=\_blank}.
 
-Bulk coretime provides several advantages:
+2. Navigate to **Developer > Extrinsics** in the top menu.
 
-- Monthly allocation of resources
-- Guaranteed block production slots (every 12 seconds, or 6 seconds with [Asynchronous Backing](https://wiki.polkadot.com/learn/learn-async-backing/#asynchronous-backing){target=\_blank})
-- Priority renewal rights
-- Protection against price fluctuations
-- Ability to split and resell unused coretime
+3. Select the account that registered your parachain ID.
 
-To purchase bulk coretime:
+4. From the **submit the following extrinsic** dropdown, select **onDemand** and then choose **placeOrderAllowDeath** as the extrinsic.
 
-1. Access the Coretime system parachain.
-2. Interact with the Broker pallet.
-3. Purchase your desired amount of coretime.
-4. Assign the purchased core to your registered `ParaID`.
+5. Configure the parameters:
 
-After successfully obtaining coretime, your parachain will automatically start producing blocks at regular intervals.
+    - **maxAmount**: The maximum amount of tokens you're willing to spend (e.g., `1000000000000`). This value may vary depending on network conditions.
+    - **paraId**: Your reserved parachain ID (e.g., `4508`).
 
-For current marketplaces and pricing, consult the [Coretime Marketplaces](https://wiki.polkadot.com/learn/learn-guides-coretime-marketplaces/){target=\_blank} page on the Polkadot Wiki.
+6. Review the transaction details and click **Submit Transaction**.
 
-### On-demand Coretime
+![Placing an on-demand order for coretime](/images/parachains/launch-a-parachain/obtain-coretime/obtain-coretime-01.webp)
 
-On-demand coretime allows for flexible, as-needed block production. To purchase:
+Upon successful submission, your parachain will produce a new block. You can verify this by checking your collator node logs, which should display output confirming block production.
 
-1. Ensure your collator node is fully synchronized with the relay chain.
-2. Submit the `onDemand.placeOrderAllowDeath` extrinsic on the relay chain with:
+!!!note
+    Each successful on-demand extrinsic will trigger one block production cycle. For continuous block production, you'll need to place multiple orders or consider bulk coretime.
 
-    - **`maxAmountFor`**: Sufficient funds for the transaction.
-    - **`paraId`**: Your registered `ParaID`.
+## Purchase Bulk Coretime
 
-After successfully executing the extrinsic, your parachain will produce a block.
+Bulk coretime offers a cost-effective way to maintain continuous block production. It lets you reserve a core for up to 28 days and renew it as needed.
+
+You can purchase and manage cores on the [Coretime Chain](https://wiki.polkadot.com/learn/learn-system-chains/#coretime-chain){target=\_blank}, a system parachain that runs the [`pallet_broker`](https://paritytech.github.io/polkadot-sdk/master/pallet_broker/index.html){target=\_blank} to handle core sales, allocation, and renewal across the Polkadot ecosystem.
+
+!!!tip
+    Paseo has a unique process for obtaining coretime cores. Refer to the [PAS-10 Onboard Paras Coretime](https://github.com/paseo-network/paseo-action-submission/blob/main/pas/PAS-10-Onboard-paras-coretime.md#summary){target=\_blank} guide for detailed instructions.
+
+This tutorial shows you how to purchase bulk coretime using the [RegionX Coretime Marketplace](https://app.regionx.tech){target=\_blank}, a user-friendly interface for buying and managing cores on both the Polkadot TestNet and production networks.
+
+![RegionX home page with Wallet connected](/images/parachains/launch-a-parachain/obtain-coretime/obtain-coretime-02.webp)
+
+### Connect Your Wallet to RegionX
+
+1. Visit the [RegionX App](https://app.regionx.tech){target=\_blank}.
+
+2. Click the **Connect Wallet** button in the upper right corner.
+
+3. Select your wallet provider and approve the connection.
+
+### Obtain Coretime Chain Funds
+
+To purchase a core, you need funds on the Coretime Chain. You can fund your account directly on the Coretime Chain using the Polkadot Faucet:
+
+1. Visit the [Polkadot Faucet](https://faucet.polkadot.io/?parachain=0){target=\_blank}.
+
+2. Select the **Coretime (Paseo)** network from the dropdown menu.
+
+3. Paste your wallet address in the input field.
+
+4. Click **Get some PASs** to receive 5000 PAS tokens.
+
+!!!note
+    The Polkadot Faucet has a daily limit of 5,000 PAS tokens per account. If you need more tokens than this limit allows, you have two options:
+    
+    - Return to the faucet on consecutive days to accumulate additional tokens.
+    - Create additional accounts, fund each one separately, and then transfer the tokens to your primary account that will be making the bulk coretime purchase.
+
+    Alternatively, to expedite the process, you can send a message to the [Paseo Support channel](https://matrix.to/#/#paseo-testnet-support:parity.io){target=\_blank} on Matrix, and the Paseo team will assist you in funding your account.
+
+### Purchase a Core
+
+1. From the RegionX home page, ensure the correct network is selected using the network switch in the top right corner (set to **Paseo**).
+
+2. Review the information displayed on the home page, including:
+    - **Cores Remaining**: Number of available cores
+    - **Cores Offered**: Total cores in the current sale
+    - **Current price**: The price per core in PAS tokens
+    - **Auction Phase Status**: Current phase and progress
+
+3. Click the **Purchase New Core** button displayed on the page.
+
+4. A modal will appear detailing the transaction details and fees. Review the information carefully.
+
+5. Click **Ok** and sign the transaction using your connected wallet.
+
+6. Wait for the transaction to be confirmed on-chain.
+
+### Verify Your Purchase
+
+1. Once the transaction is confirmed, navigate to [**My Regions**](https://app.regionx.tech/regions){target=\_blank} from the left menu.
+
+2. You should see your newly purchased core listed in your dashboard.
+
+Congratulations! You've successfully purchased a core using RegionX.
+
+### Assign Your Parachain to the Core
+
+With your core purchased, you now need to assign your parachain to it for block production:
+
+1. From the **My Regions** page, click on your core to select it.
+
+2. Click the **Assign** option from the left-hand menu.
+
+3. A modal will appear, allowing you to add a new task.
+
+4. Click **Add Task** and enter the following information:
+
+    - **Parachain ID**: Your reserved parachain identifier
+    - **Project Name**: The name of your parachain project
+
+5. Click **Add Task** to proceed.
+
+6. Select your parachain task from the list.
+
+7. Set the core's **Finality** setting:
+
+    - **Provisional**: Allows interlacing and partitioning of the core, but the region cannot be renewed as-is.
+    - **Final**: Prevents modification of the core but allows renewal. Choose this if you plan to renew the core.
+
+8. Sign and submit the transaction.
+
+Once confirmed, your parachain will be assigned to the core and should begin producing blocks (provided your collator is running and synced with the relay chain).
+
+## Next Steps
+
+Your parachain is now set up for block production. Consider the following:
+
+- **Monitor your collator**: Keep your collator node running and monitor its performance.
+- **Plan coretime renewal**: If using bulk coretime, plan to renew your core before the current lease expires.
+- **Explore runtime upgrades**: Once comfortable with your setup, explore how to upgrade your parachain's runtime without interrupting block production.
 
 
 ---