Skip to content

Commit 239a550

Browse files
authored
Add bridging explanation (#2410)
* Add bridging explanation * spag comment
1 parent 2bdb72f commit 239a550

File tree

2 files changed

+67
-31
lines changed

2 files changed

+67
-31
lines changed

docs/pages/overview/bridging.mdx

Lines changed: 33 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -3,20 +3,26 @@ import { Callout } from "vocs/components";
33
# Bridge Closure
44

55
<Callout type="danger">
6-
Important information – Game Bridge **permanently** closes **48 hours** after victory has been claimed. <br />
7-
6+
# Critical End-Game Information
7+
The Game Bridge **permanently** closes **48 hours** after after victory has been claimed.
8+
9+
[Read the full End Season Disclaimer](/overview/disclaimer) to understand all risks and limitations.
810
</Callout>
911

1012
## Bridging in Eternum
1113

12-
Eternum is a fully onchain game with immutable smart contracts, meaning the game rules cannot be altered after
13-
deployment. Bridging tokens in and out of the game is a core mechanic, but you must carefully manage this process. The
14-
game bridge closes **forever** 48 hours after the game ends (victory claimed). Any tokens left in the game at that time
15-
are **permanently locked** in the contract (effectively **burned**).
16-
17-
Bridging out of the game is done by sending resources to a bank. This process takes **time and requires donkeys** as
18-
part of the gameplay mechanics. Since the contracts are immutable, "code is law." Players must plan accordingly, as the
19-
developers cannot modify the system after deployment.
14+
Eternum is a fully onchain game with immutable smart contracts, meaning the game rules cannot be altered. Bridging tokens in and out of the game is a core mechanic, but you must carefully manage this process.
15+
16+
<Callout type="warning">
17+
### End Game Bridge Closure
18+
- The game bridge closes **permanently** 48 hours after "End Season" is triggered
19+
- Only resources in your Realm's direct balance can be bridged out
20+
- Resources in the following locations are NOT part of your bridgeable balance:
21+
- AMM Liquidity Pool positions
22+
- Open market orders
23+
- Resources in transit
24+
- Any resources not bridged out by the deadline are **permanently locked** in the contract
25+
</Callout>
2026

2127
## Bridging in
2228

@@ -49,22 +55,24 @@ You can bridge out resources from the game, which will be converted to the ERC20
4955

5056
### Game End
5157

52-
When the game ends, players will have **48 hours** to withdraw all in-game assets including:
58+
When "End Season" is triggered:
5359

54-
> - All **$LORDS** tokens
55-
> - Resources in storage
56-
> - Market orders
57-
> - Liquidity pool positions
58-
> - Any other in-game assets
60+
1. A **48-hour countdown** begins immediately
61+
2. During this window, you can only:
62+
- Bridge out **$LORDS** and resources from your Realm's direct balance
63+
- Register your score (within 4 days)
5964

6065
To preserve your assets, you **must**:
6166

62-
> 1. Remove liquidity from AMM pools before the game ends.
63-
> 2. Cancel open orders on the Order Book.
64-
> 3. Bridge out **$LORDS** and **Resources** through the Central Bank before the game ends.
65-
66-
### ⚠️ Key Reminders ⚠️
67-
68-
- The 48 hour window after the game ends is your **final** opportunity to secure your in-game assets.
69-
- Developers **cannot** intervene or make exceptions after the bridge closes.
70-
- Plan ahead to ensure a smooth and timely withdrawal of your assets.
67+
> 1. Remove all liquidity from AMM pools **before** the season ends
68+
> 2. Cancel all open orders on the Order Book **before** the season ends
69+
> 3. Ensure all resource transfers to your Realm are completed **before** the season ends
70+
> 4. Bridge out **$LORDS** and **Resources** from your Realm's balance within the 48-hour window
71+
72+
<Callout type="error">
73+
### ⚠️ Permanent Loss Warning ⚠️
74+
- The 48-hour countdown is **final** and **cannot be extended**
75+
- Developers **cannot** recover any assets after the bridge closes
76+
- Any resources not in your Realm's direct balance **cannot** be bridged out
77+
- Plan ahead to ensure all your assets are in your Realm's balance before the season ends
78+
</Callout>

docs/pages/overview/disclaimer.mdx

Lines changed: 34 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -25,13 +25,41 @@ A season of Eternum concludes when a single player achieves the required
2525
**{formatNumberWithSpaces(HYPERSTRUCTURE_POINTS_FOR_WIN)}** Victory Points and clicks the "End Season" button. At this
2626
point:
2727

28-
- A **48 hour** period begins where you **must** bridge out **ALL $LORDS** tokens and in-game resources.
29-
- After this period, **ALL $LORDS** tokens and **Resources** are **permanently** locked within the game.
30-
- Individual rewards are claimed by **registering** scores. Players will have **4 days** to register their scores and
31-
**must** register to be eligible. There is **no** time limit to claim prizes.
3228

33-
Players are encouraged to review the documentation for instructions on how to bridge tokens out during the active
34-
gameplay phase.
29+
30+
### ⚠️ SEASON END CRITICAL INFORMATION
31+
32+
When the season ends, **ALL in-game actions are DISABLED.**
33+
34+
#### ⛔️ Disabled Actions
35+
- You **cannot** retrieve LP positions from the AMM
36+
- You **cannot** cancel market orders to retrieve locked resources
37+
- You **cannot** conclude ongoing battles
38+
39+
1. **48-Hour Withdrawal Window (starts immediately when "End Season" is clicked)**
40+
- Starting from the exact moment the season ends, you have **48 hours** to bridge out **ALL $LORDS** tokens and resources from your Realms' balance
41+
- **IMPORTANT:** Your Realm's balance withdrawal:
42+
- Can be BLOCKED if your Realm is in an active battle
43+
- Does NOT include resources that are:
44+
- Locked in AMM LP positions
45+
- Locked in market orders
46+
- In transit to your Realm (not yet deposited)
47+
- These locked/in-transit resources CANNOT be recovered after the season ends
48+
49+
2. **After 48 Hours**
50+
- Any remaining **$LORDS** tokens and **Resources** will be **permanently locked**
51+
- These assets **CANNOT** be recovered under any circumstances
52+
53+
3. **Score Registration**
54+
- Players have **4 days** to register their scores
55+
- Registration is **MANDATORY** to be eligible for prizes
56+
- While registration has a deadline, prize claiming does not
57+
58+
<Callout type="warning">
59+
**PRO TIP:** Don't wait for the season to end! You can and should start bridging out tokens during active gameplay to minimize risk.
60+
</Callout>
61+
62+
Please refer to the documentation for detailed instructions on the bridging process during active gameplay.
3563

3664
## No Recourse
3765

0 commit comments

Comments
 (0)