Skip to content

Commit e1978dd

Browse files
committed
update new to polygon
1 parent 1fb0779 commit e1978dd

File tree

2 files changed

+52
-18
lines changed

2 files changed

+52
-18
lines changed

docs/home/new-to-matic.md

+45-9
Original file line numberDiff line numberDiff line change
@@ -5,17 +5,17 @@ description: Build your next blockchain app on Polygon.
55
keywords:
66
- docs
77
- matic
8-
image: https://matic.network/banners/matic-network-16x9.png
8+
image: https://matic.network/banners/matic-network-16x9.png
99
---
1010
Polygon is a scaling solution for public blockchains. Polygon PoS supports all the existing Ethereum tooling along with faster and cheaper transactions.
1111

12-
### Types of Interaction on Polygon
12+
## Types of Interaction on Polygon
1313

1414
* [Polygon PoS chain](/docs/develop/getting-started)
1515
* [Ethereum + Polygon with PoS bridge](https://docs.polygon.technology/docs/develop/ethereum-polygon/pos/getting-started)
1616
* [Ethereum + Polygon with Plasma bridge](https://docs.polygon.technology/docs/develop/ethereum-polygon/plasma/getting-started)
1717

18-
### Deploy Smart Contracts
18+
## Deploy Smart Contracts
1919

2020
<!-- ### Are you an Experience Blockchain Developer? -->
2121

@@ -28,17 +28,53 @@ Polygon is a scaling solution for public blockchains. Polygon PoS supports all t
2828
- [Using Hardhat](/docs/develop/hardhat)
2929
* Configure the Web3 RPC-URL to https://rpc-mumbai.matic.today, *Everything else remains the same*
3030

31-
### What is a Blockchain?
31+
## What is a Blockchain?
3232
Simply put, Blockchain is a shared, immutable ledger for recording transactions, tracking assets and building trust. Head over to [Blockchain Basics](blockchain-basics/blockchain) to read more.
3333

3434
:movie_camera: [Your first DApp](https://www.youtube.com/watch?v=rzvk2kdjr2I)
3535

36-
### What is a Sidechain?
36+
## What is a Sidechain?
3737
Think of a Sidechain as a clone of a 'parent' blockchain, supporting transfer of assets to and from the main chain. It is simply an alternate to parent chain that creates a new blockchain with its own mechanism of creating blocks (consensus mechanism). Connecting a sidechain to a parent chain involves setting up a method of moving assets between the chains.
3838

3939
:page_facing_up: [Sidechains and Childchains](https://hackernoon.com/what-are-sidechains-and-childchains-7202cc9e5994)
40-
### What is Plasma?
41-
Plasma is a framework of secondary chains that will communicate and interact as sparingly as possible with the main chain. Child chain is a scaling solution for Ethereum (or any blockchain for that matter).
42-
It is a layer 2 solution for Ethereum that provides a framework for building ‘off-chain’ decentralised applications that are secure, scalable and swift.
4340

44-
:page_facing_up: [Read more about Plasma](blockchain-basics/sidechain)
41+
## Validator and delegator roles
42+
43+
On the Polygon Network, you can be a validator or a delegator. See:
44+
45+
* [Who Is a Validator](/docs/validate/polygon-basics/who-is-validator)
46+
* [Who Is a Delegator](/docs/validate/polygon-basics/who-is-delegator)
47+
48+
## Architecture
49+
50+
If your goal is to become a validator, it is essential that you understand the Polygon architecture.
51+
52+
See [Polygon Architecture](/docs/validate/validator/architecture).
53+
54+
### Components
55+
56+
To have a granular understanding of the Polygon architecture, see core components:
57+
58+
* [Heimdall](/docs/contribute/heimdall/overview)
59+
* [Bor](/docs/contribute/bor/overview)
60+
* [Contracts](/docs/contribute/contracts/stakingmanager)
61+
62+
#### Codebases
63+
64+
To have a granular understanding of the core components, see the codebases:
65+
66+
* [Heimdall](https://github.com/maticnetwork/heimdall)
67+
* [Bor](https://github.com/maticnetwork/bor)
68+
* [Contracts](https://github.com/maticnetwork/contracts)
69+
70+
## How-tos
71+
72+
### Node setup
73+
74+
* [Run a Validator Node with Ansible](/docs/validate/validate/run-validator-ansible)
75+
* [Run a Validator Node from Binaries](/docs/validate/validate/run-validator-binaries)
76+
77+
### Staking operations
78+
79+
* [Validator Staking Operations](/docs/validate/validate/validator-staking-operations)
80+
* [Delegate](/docs/validate/delegate)

docs/validate/validator/architecture.md

+7-9
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ keywords:
77
- matic
88
- polygon
99
- architecture
10-
image: https://matic.network/banners/matic-network-16x9.png
10+
image: https://matic.network/banners/matic-network-16x9.png
1111
---
1212
import useBaseUrl from '@docusaurus/useBaseUrl';
1313

@@ -30,26 +30,24 @@ The staking contracts implement the following features:
3030
* Enable penalties/slashing for activities such as double signing, validator downtime, etc.
3131
* Save [checkpoints](/docs/validate/glossary#checkpoint-transaction) on the Ethereum mainnet.
3232

33-
The PoS mechanism also acts as a mitigation to the data unavailability problem for the Polygon sidechains in terms of Plasma.
34-
35-
The Plasma contracts implement the [MoreVP Plasma framework](https://ethresear.ch/t/more-viable-plasma/2160). See also [an overview of the Polygon MoreVP implementation](https://ethresear.ch/t/account-based-plasma-morevp/5480).
33+
The PoS mechanism also acts as a mitigation to the data unavailability problem for the Polygon sidechains.
3634

3735
## Heimdall (validation layer)
3836

39-
Heimdall layer handles the aggregation of blocks produced by [Bor](/docs/validate/glossary#bor) into a Merkle tree and publishing the Merkle root periodically to the root chain. The periodic publishing of snapshots of the Bor sidechain are called [checkpoints](/docs/validate/glossary#checkpoint-transaction).
37+
Heimdall layer handles the aggregation of blocks produced by [Bor](/docs/validate/glossary#bor) into a Merkle tree and publishing the Merkle root periodically to the root chain. The periodic publishing of snapshots of the Bor sidechain are called [checkpoints](/docs/validate/glossary#checkpoint-transaction).
4038

4139
For every few blocks on Bor, a validator on the Heimdall layer:
4240

4341
1. Validates all the blocks since the last checkpoint.
4442
2. Creates a Merkle tree of the block hashes.
4543
3. Publishes the Merkle root hash to the Ethereum mainnet.
4644

47-
Checkpoints are important for two reasons:
45+
Checkpoints are important for two reasons:
4846

4947
1. Providing finality on the root chain.
5048
2. Providing proof of burn in withdrawal of assets.
5149

52-
An overview of the process:
50+
An overview of the process:
5351

5452
* A subset of active validators from the pool is selected to act as [block producers](/docs/validate/glossary#block-producer) for a [span](/docs/validate/glossary#span). These block producers are responsible for creating blocks and broadcasting the created blocks on the network.
5553
* A checkpoint includes the Merkle root hash of all blocks created during any given interval. All nodes validate the Merkle root hash and attach their signature to it.
@@ -60,8 +58,8 @@ See also [Heimdall architecture](/docs/contribute/heimdall/overview).
6058

6159
### Bor (block producer layer)
6260

63-
Bor is Polygon's sidechain block producer — the entity responsible for aggregating transactions into blocks.
61+
Bor is Polygon's sidechain block producer — the entity responsible for aggregating transactions into blocks.
6462

6563
Bor block producers are a subset of the validators and are shuffled periodically by the [Heimdall](/docs/validate/glossary#heimdall) validators.
6664

67-
See also [Bor architecture](/docs/contribute/bor/overview).
65+
See also [Bor architecture](/docs/contribute/bor/overview).

0 commit comments

Comments
 (0)