Skip to content

Commit

Permalink
replacements
Browse files Browse the repository at this point in the history
slot -> core where applicable
  • Loading branch information
filippoweb3 committed Sep 25, 2024
1 parent 4bf14b3 commit 5a8fc46
Show file tree
Hide file tree
Showing 12 changed files with 57 additions and 67 deletions.
1 change: 0 additions & 1 deletion docs/build/build-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -329,7 +329,6 @@ For a complete list of tools, please take a look here:

## Resources

- [System (Common Good) Parachains](https://polkadot.network/blog/common-good-parachains-an-introduction-to-governance-allocated-parachain-slots/)
- [Agile Coretime Fellowship RFC](https://polkadot-fellows.github.io/RFCs/approved/0001-agile-coretime.html)
- [The Launch of Parachains](https://polkadot.network/blog/the-launch-of-parachains/)
- [Polkadot Bridges](https://medium.com/polkadot-network/polkadot-bridges-connecting-the-polkadot-ecosystem-with-external-networks-1118916392e3)
Expand Down
21 changes: 10 additions & 11 deletions docs/build/build-parachains.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,11 +45,11 @@ described in the [Polkadot Whitepaper](https://polkadot.network/PolkaDotPaper.pd

#### [Shared Security](../learn/learn-parachains.md) (Pooled Security)

Parachains can lease the security of the Polkadot network by bonding [DOT](../learn/learn-DOT.md)
for a parachain slot. This means that the social costs of building a community around your project
and convincing validators to participate in your network security are reduced. Polkadot has strong
security, and decentralised application projects wishing to benefit from this security would want to
become a parachain to share in that pooled security.
Parachains can lease the security and interoperability of the Polkadot network purchasing coretime
with [DOT](../learn/learn-DOT.md). This means that the social costs of building a community around
your project and convincing validators to participate in your network security are reduced. Polkadot
has strong security, and decentralised application projects wishing to benefit from this security
would want to become a parachain to share in that pooled security.

#### [On-Chain Governance](../learn/learn-polkadot-opengov.md) (Thought-through Governance)

Expand Down Expand Up @@ -148,7 +148,7 @@ in migrating onto the relay chain as a para-object. While the parachain model ha
may not be the go-to strategy for some projects.

As a path for migration onto Polkadot, it may be more viable to migrate to one of the chains in one
of the reserved slots.
of the reserved cores.

For instance, there are currently options for [smart contract deployment](build-smart-contracts.md)
on Kusama through the networks that have secured [coretime](../learn/learn-agile-coretime.md).
Expand Down Expand Up @@ -366,20 +366,19 @@ are available.
To include your parachain into the Polkadot network, you will need to reserve some time on a relay
chain core.

Parachain slots are acquired through [coretime](../learn/learn-agile-coretime.md) purchase to
produce blocks
[continuously or on-demand](../learn/learn-parachains.md#parachains-vs-on-demand-parachains). See
Time on a core is acquired through [coretime](../learn/learn-agile-coretime.md) purchased with DOT
to produce blocks
[continuously or on-demand](../learn/learn-parachains.md#parachains-vs-on-demand-parachains) while
benefiting from Polkadot's security. See
[these guides](../learn/learn-guides-coretime-marketplaces.md) to learn how to purchase coretime.

## Resources

- [Parachain tutorials](https://docs.substrate.io/reference/how-to-guides/parachains/)
- [System (Common Good) Parachains](https://polkadot.network/blog/common-good-parachains-an-introduction-to-governance-allocated-parachain-slots/)
- [The Launch of Parachains](https://polkadot.network/blog/the-launch-of-parachains/)
- [Parathreads: Pay-as-you-go Parachains](https://medium.com/polkadot-network/parathreads-pay-as-you-go-parachains-7440d23dde06)
- [Polkadot Bridges](https://medium.com/polkadot-network/polkadot-bridges-connecting-the-polkadot-ecosystem-with-external-networks-1118916392e3)
- [The Path of a Parachain Block](https://polkadot.network/blog/the-path-of-a-parachain-block/)
- [The Path of a Parachain Block (Video)](https://www.crowdcast.io/e/polkadot-path-of-a-parachain-block?utm_source=profile&utm_medium=profile_web&utm_campaign=profile)
- [Polkadot Parachain Slots](https://polkadot.network/polkadot-parachain-slots/)
- [How to become a parachain on Polkadot (Video)](https://www.youtube.com/watch?v=fYc1yolanoE)
- [Trusted Execution Environments and the Polkadot Ecosystem](https://polkadot.network/blog/trusted-execution-environments-and-the-polkadot-ecosystem/)
5 changes: 3 additions & 2 deletions docs/general/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,8 @@ OpenGov) to orchestrate decisions, including accessing funds from the
[treasury](../learn/learn-polkadot-opengov-treasury.md).

The [DOT token](../learn/learn-DOT.md) gives you the power to participate in Polkadot OpenGov,
[staking](../learn/learn-staking.md), and [parachains' crowdloans](../learn/learn-crowdloans.md).
[staking](../learn/learn-staking.md), and
[parachains' crowdloans](../learn/archive/learn-crowdloans.md).

The level of abstraction and generalization of Polkadot allows to build applications that are
specific to their use cases, and for those applications to communicate securely leveraging each
Expand Down Expand Up @@ -149,7 +150,7 @@ ideal ecosystem to build a [web3 future](./web3-and-polkadot.md).
## What can I do with my DOT?

[DOT](../learn/learn-DOT.md) is the native token of the Polkadot Network. DOT can be used for
transaction fees, staking, governance, acquisition of a parachain slot and for enabling several key
transaction fees, staking, governance, acquisition of coretime and for enabling several key
functionalities on Polkadot. See more information on
[the Chain State Values page](./chain-state-values.md).

Expand Down
3 changes: 1 addition & 2 deletions docs/general/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -94,8 +94,7 @@ makes BLS a preferred scheme for voting in consensus algorithms and threshold si
## Bonding

A process by which tokens can be "frozen" in exchange for some other benefit. For example, staking
is a form of bonding for which you receive rewards in exchange for securing the network. You can
also bond tokens in exchange for a parachain slot.
is a form of bonding for which you receive rewards in exchange for securing the network.

## [Bounty](../learn/learn-polkadot-opengov-treasury.md#bounties)

Expand Down
4 changes: 2 additions & 2 deletions docs/general/kusama/kusama-getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,8 @@ nominating), governance, basic transfers and everything else.
### What can I do with my KSM?

KSM is the native token of the Kusama Network. KSM can be used for transaction fees, staking,
governance, acquisition of a parachain slot and for enabling several key functionalities on Kusama.
See more information on [the Chain State Values page](../chain-state-values.md).
governance, purchase of coretime, and for enabling several key functionalities on Kusama. See more
information on [the Chain State Values page](../chain-state-values.md).

KSM has utility in [Kusama's OpenGov](../../learn/learn-polkadot-opengov.md) where you can
[vote](../../learn/learn-polkadot-opengov.md#voting-on-a-referendum),
Expand Down
12 changes: 6 additions & 6 deletions docs/general/kusama/kusama-timeline.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,17 +55,17 @@ what contributes to the much higher ratio of missed blocks on Kusama versus Polk
## Auctions

Kusama promised chaos, and it delivered on that promise. On June 15th, 2021, the roll out of the
first public parachain slot [auction](../../learn/learn-auction.md) commenced, marking the beginning
of the end to deliver on the last piece of core functionality outlined in the Polkadot whitepaper:
purpose-built, interoperable parachains.
first public parachain slot [auction](../../learn/archive/learn-auction.md) commenced, marking the
beginning of the end to deliver on the last piece of core functionality outlined in the Polkadot
whitepaper: purpose-built, interoperable parachains.

Teams and projects looking to become an official parachain on the Kusama network have been working
hard to bring their technologies to life, many of whom started a
[crowdloan campaign](../../learn/learn-crowdloans.md##starting-a-crowdloan-campaign) in order to
participate in the slot auctions.
[crowdloan campaign](../../learn/archive/learn-crowdloans.md#starting-a-crowdloan-campaign) in order
to participate in the auctions.

Kusama has made history with the permissionless launch of several independent parachains, and
continues to do so with ongoing slot auction. As parachains become operational, the community will
continues to do so with ongoing auction. As parachains become operational, the community will
determine which additional features and network upgrades should be added over time.

While Kusama’s current parachains are taking advantage of the built-in features of the network and
Expand Down
4 changes: 2 additions & 2 deletions docs/general/parachains-apps.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,8 +31,8 @@ and add your parachain app to this page.

[Astar](https://astar.network/) is an interoperable smart contracts platform for Polkadot and
Ethereum ecosystems supporting both Wasm and EVM smart contracts. Astar provides native access to
Polkadot and Ethereum through its parachain slot and Layer 2 scaling solution, while also offering
bridges into other major blockchain ecosystems.
Polkadot and Ethereum through its Polkadot parachain and Layer 2 scaling solution, while also
offering bridges into other major blockchain ecosystems.

Through the [dApp staking](https://docs.astar.network/docs/build/dapp-staking/), Astar offers a
basic income to dApp developers, which allows them to continue building and enhancing their dApps
Expand Down
10 changes: 5 additions & 5 deletions docs/general/polkadot-direction.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,14 +48,14 @@ Polkadot can be directed towards the following main changes.
A paradigm shift from:

- being a chain-focused ecosystem where each parachain owned an execution core at all times
(acquired through fixed parachain slots), which allowed a simple and secure, sharded execution
(acquired through fixed parachain auction), which allowed a simple and secure, sharded execution
environment
- to being an application-focused ecosystem where we remove the assumption that each application
owns a core, and instead that all cores are a resource to be consumed and used as needed by all
applications.

Previously, securing a parachain slot was a competitive process through an
[auction mechanism](../learn/learn-auction.md). With coretime rental, there is no need for slot
Previously, securing a core was a competitive process through an
[auction mechanism](../learn/archive/learn-auction.md). With coretime rental, there is no need for
auctions anymore. Teams can purchase on-demand coretime or reserve bulk coretime as required. This
greatly decreases the barrier-to-entry for software tinkerers and parachain teams.

Expand All @@ -76,8 +76,8 @@ access Polkadot's secure blockspace and interoperability for a finite period.
Cores must be agile and general: they can change what job they run as easily as a modern CPU. It
follows that the procurement of those cores must be agile as well.

The slot auction mechanism is not agile, creates high entry barriers, and is designed for
long-running single applications (i.e., the original Polkadot vision proposed in the whitepaper).
The auction mechanism is not agile, creates high entry barriers, and is designed for long-running
single applications (i.e., the original Polkadot vision proposed in the whitepaper).

We depart from the classic lease auctions and propose an agile marketplace for coretime, where
essentially **coretime becomes a commodity that can be tokenized, sold, and traded**. This setup
Expand Down
12 changes: 6 additions & 6 deletions docs/general/polkadot-v1.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,12 +73,12 @@ meaning that transactions can be made between different parachains.

### Polkadot's Additional Functionalities

The Polkadot relay-chain also manges [crowdloans](../learn/learn-crowdloans.md),
[auctions](../learn/learn-auction.md), [staking](../learn/learn-staking.md),
The Polkadot relay-chain also manges [crowdloans](../learn/archive/learn-crowdloans.md),
[auctions](../learn/archive/learn-auction.md), [staking](../learn/learn-staking.md),
[accounts](./learn-accounts-index), [balances](../learn/learn-transactions.md#balance-transfers),
and [governance](../learn/learn-polkadot-opengov.md). Parachain slots or cores are leased in 6-month
chunks for a maximum of two years, and crowdloans allow users to trustlessly loan funds to teams for
lease deposits in exchange for pre-sale tokens. There is no other way you could use Polkadot 1.0.
and [governance](../learn/learn-polkadot-opengov.md). Relay chain cores are leased in 6-month chunks
for a maximum of two years, and crowdloans allow users to trustlessly loan funds to teams for lease
deposits in exchange for pre-sale tokens. There is no other way you could use Polkadot 1.0.

### Polkadot's Resilience

Expand Down Expand Up @@ -142,7 +142,7 @@ further improved such that the tasks which are currently managed on the relay ch
balances transfers, staking, and governance, can be delegated to
[system parachains](../learn/learn-system-chains.md) to increase flexibility and to focus the use of
the relay-chain to provide shared security and interoperability. Blockspace is only accessible
through slot auctions, but an auction winner has access to a "freighter of blocks" regardless it is
through auctions, but an auction winner has access to a "freighter of blocks" regardless it is
needed or not. This creates high entry barriers and it can lead to waste of energy and resources.

For more information about blockspace see [this interview](https://youtu.be/e1vISppPwe4) with Robert
Expand Down
22 changes: 11 additions & 11 deletions docs/learn/learn-architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,12 +25,13 @@ features.

## [Parachain](learn-parachains.md) Slots

The relay chain can support a number of execution slots. These slots are like cores on a computer's
processor (a modern laptop's processor may have eight cores, for example). Each one of these cores
can run one process at a time. The relay chain allows these slots using two subscription models:
parachains and on-demand parachains. Parachains have a dedicated slot (core) for their chain and are
like a process that runs constantly. On-demand parachains share slots amongst a group, and are thus
more like processes that need to be woken up and run less frequently.
The relay chain can support a number of execution cores, like cores on a computer's processor (a
modern laptop's processor may have eight cores, for example). Each one of these cores can run one
process at a time. The relay chain allows these cores using two subscription models: parachains and
on-demand parachains. Parachains have a dedicated core for their chain and are like a process that
runs constantly. On-demand parachains share (not simultaneously) cores amongst a group, and are thus
more like processes that need to be woken up and run less frequently (similarly to concurrency in
modern computers).

Most of the computation that happens across the network as a whole will be delegated to specific
parachain implementations that handle various use cases. The relay chain places no constraints over
Expand All @@ -40,11 +41,10 @@ Some parachains may be specific to a particular application, others may focus on
like smart contracts, privacy, or scalability — still, others might be experimental
architectures that are not necessarily blockchain in nature.

The relay chain provides many ways to secure a slot for a parachain for a particular length of time.
On-demand parachains share slots with other parachains. Both regular and on-demand parachains have
the same API; their difference is economic. Parachains will have to reserve relay chain's native
token for the duration of their slot lease; on-demand parachains will pay on a per-block basis.
Parachains can switch between being on-demand and permanent.
The relay chain provides many ways to secure a core for a parachain for a particular length of time.
On-demand parachains share cores (not simultaneously) with other parachains. Both regular and
on-demand parachains have the same API and need to buy time on a core with DOT via
[coretime](./learn-agile-coretime.md). Parachains can switch between being on-demand and permanent.

### [Shared Security](learn-parachains.md)

Expand Down
9 changes: 4 additions & 5 deletions docs/learn/learn-assets.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,11 +20,10 @@ the hub can be thought of as a trusted "home base" of assets in the network.

The Asset Hub uses the relay chain's native token. The chain yields its governance to its parent
relay chain and has no inflation or era-based rewards for collators (although collators receive a
portion of transaction fees). As a
[system parachain](https://polkadot.network/blog/common-good-parachains-an-introduction-to-governance-allocated-parachain-slots/),
the Asset Hub has a trusted relationship with the relay chain, and as such, can teleport the relay
chain's native token between itself and the relay chain. That is, the native token on the relay
chain is just as good on Asset Hub.
portion of transaction fees). As a [system parachain](./learn-system-chains.md), the Asset Hub has a
trusted relationship with the relay chain, and as such, can teleport the relay chain's native token
between itself and the relay chain. That is, the native token on the relay chain is just as good on
Asset Hub.

The Asset Hub does not support smart contracts. See the [Advanced](#advanced-techniques) section at
the bottom for a discussion on using proxy and multisig accounts to replicate oft-used contract
Expand Down
21 changes: 7 additions & 14 deletions docs/learn/learn-parachains.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ Some examples of features you can have on a parachain or parathread:
Shared security, sometimes referred as _pooled security_, is one of the unique value propositions
for chains considering becoming a [parachain](learn-parachains.md) and joining the network. On a
high level, shared security means that all parachains that are connected to the relay chain by
leasing a parachain slot will benefit from the economic security provided by the relay chain
leasing a core will benefit from the economic security provided by the relay chain
[validators](learn-validator.md).

The notion of shared security is different from inter-chain protocols that build on an architecture
Expand Down Expand Up @@ -204,12 +204,6 @@ the network's governance. These chains remove transactions from the relay chain,
validators to allocate resources to validating parachains. System chains are Polkadot using its
scaling technology to host itself.

See this
[Polkadot blog article](https://polkadot.network/common-good-parachains-an-introduction-to-governance-allocated-parachain-slots/)
and this
[Polkadot Forum thread](https://forum.polkadot.network/t/polkadot-protocol-and-common-good-parachains/866)
for more information.

## On-demand Parachains

:::info On-demand parachains were previously named parathreads
Expand All @@ -220,13 +214,12 @@ On-demand parachains (previously called parathreads) are parachains that acquire
:::

On-demand parachains temporarily participate (on a block by block basis) in network security without
needing to lease a dedicated parachain slot. This is done through economically sharing the scarce
resource of a _parachain slot_ (or core) among several competing resources (parachains). Chains that
otherwise would not be able to acquire a full parachain slot or do not find it economically sensible
to do so, can participate in shared security as the
[on-demand coretime](./learn-agile-coretime.md#on-demand-coretime) offers a graceful off-ramp to
parachains that no longer require a dedicated parachain slot, but would like to continue using the
relay chain.
needing to lease a dedicated relay chain core. This is done through economically sharing the scarce
resource of a core among several competing resources (parachains). Chains that otherwise would not
be able to acquire a full core or do not find it economically sensible to do so, can participate in
shared security as the [on-demand coretime](./learn-agile-coretime.md#on-demand-coretime) offers a
graceful off-ramp to parachains that no longer require a dedicated core, but would like to continue
using the relay chain.

### Historical Context of On-demand parachains

Expand Down

0 comments on commit 5a8fc46

Please sign in to comment.