Skip to content

Commit 9d079da

Browse files
committed
CDK: unified bridge STB doc
- Updates as per legal review
1 parent 8b28bcc commit 9d079da

File tree

1 file changed

+9
-13
lines changed

1 file changed

+9
-13
lines changed

docs/cdk/architecture/staking-the-bridge.md

Lines changed: 9 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@ The LxLy bridge is the native bridging infrastructure for all CDK chains. The wa
22

33
This changes as the AggLayer v1 goes online, and introduces an upgrade to the existing LxLy architecture in the form of a _unified instance_ of the LxLy bridge that multiple chains can connect to.
44

5-
## What's "unified" bridge?
5+
## What's the "unified" bridge?
66

7-
Polygon AggLayer envisions a scalability solution that leverages shared state and unified liquidity across multiple ZK-powered chains within the Polygon ecosystem, all powered by the CDK infrastructure.
7+
AggLayer envisions a scalability solution that leverages shared state and unified liquidity across multiple ZK-powered chains within the Polygon ecosystem, all powered by the CDK infrastructure.
88

99
!!! tip "What's AggLayer?"
1010

@@ -19,13 +19,9 @@ All of this cool infrastructure needs a unified channel for easy transmission of
1919

2020
The new unified model of the LxLy bridge introduced as a part of the AggLayer v1 infrastructure has one significant difference from the existing LxLy bridge: any asset bridged onto a CDK chain using the unified bridge is held by the the **Unified Escrow** (also referred to as the **Master Escrow**) contract instead of a dedicated bridge contract.
2121

22-
!!! info
23-
24-
The master escrow contract is managed and governed by the Polygon zkEVM team.
25-
2622
Due to the shared nature of the bridge, chain operators will not have admin access to the funds locked in the master escrow contract, including the funds that belong to their own network.
2723

28-
The ability to manage bridge reserves is crucial to implement restaking for yield generation and other similar use cases. How does the unified bridge address this?
24+
The ability to manage bridge reserves is crucial to implement staking/restaking and other similar use cases, and is managed by the respective chain operators. How does the unified bridge address this?
2925

3026
## Introducing "Stake the Bridge"
3127

@@ -49,7 +45,7 @@ Let's briefly go over the specific actions and characteristics of each STB contr
4945

5046
#### `L1Escrow`
5147

52-
- Defines investment strategies.
48+
- Defines staking strategies to contribute to network security, or achieve other goals.
5349
- Sending token issuance messages to `L2Escrow`.
5450
- Fulfilling redemption messages from `L2Escrow`.
5551

@@ -74,7 +70,7 @@ Let's briefly go over the specific actions and characteristics of each STB contr
7470
There are three roles, each of which performs specific actions to manage the STB system:
7571

7672
- Admin: Can upgrade and pause the system.
77-
- Escrow manager: Can withdraw token backing from the respective escrow contract to invest using the `managerWithdraw()` function.
73+
- Escrow manager: Can withdraw token backing from the respective escrow contract to stake using the `managerWithdraw()` function and contribute to network security, or achieve other goals.
7874
- Risk manager: Can invoke `setIssuanceCap()` multiple times to increase or reduce the issuance cap.
7975

8076
## STB transaction flow vs. existing LxLy flow
@@ -111,12 +107,12 @@ The STB contracts grant chain operators control over the token backing in the es
111107

112108
!!! warning
113109

114-
Polygon Labs **does not** manage or facilitate the investing of the funds locked in the escrow contracts. The management of funds to implement any investment strategies and risk profiles is completely at the discretion of the chain operators and owners.
110+
Polygon Labs **does not** manage or facilitate the staking of the assets locked in the escrow contracts. Any decision to implement any staking strategies and contribute to network security, or otherwise, is completely at the discretion of the chain operators.
115111

116112
Bridging tokens to L2 CDK chains using the STB contracts is ideal for the following use cases:
117113

118-
- Coins that need to implement staking and yield generation mechanisms.
119-
- Coins that need to implement custom L2 functionality.
120-
- Coins that possess native issuance capabilities.
114+
- Tokens that need to implement staking/restaking or other mechanisms, or strategies.
115+
- Tokens that need to implement custom L2 functionality.
116+
- Tokens that possess native issuance capabilities.
121117

122118
Want to start testing with STB? The contracts are still being audited, but are ready to use on testnets, and can be found here: https://github.com/pyk/zkevm-stb.

0 commit comments

Comments
 (0)