Skip to content

Commit cd12360

Browse files
authored
update docs (#12)
* add lnv3 & delete xtoken * update relayer configure * update user guide * bridge type
1 parent 503a7aa commit cd12360

File tree

7 files changed

+22
-88
lines changed

7 files changed

+22
-88
lines changed

docs/contract-addresses/mainnet.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,6 @@ sidebar_position: 1
77
## Ethereum
88

99
- chainId: 1
10-
- LnBridge(v1): [0x5F8D4232367759bCe5d9488D3ade77FCFF6B9b6B](https://etherscan.io/address/0x5F8D4232367759bCe5d9488D3ade77FCFF6B9b6B)
1110
- LnDefaultBridge(v2): [0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337](https://etherscan.io/address/0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337)
1211
- LnOppositeBridge(v2): [0x48d769d5C7ff75703cDd1543A1a2ed9bC9044A23](https://etherscan.io/address/0x48d769d5C7ff75703cDd1543A1a2ed9bC9044A23)
1312

@@ -16,54 +15,58 @@ sidebar_position: 1
1615
- chainId: 42161
1716
- LnDefaultBridge(v2): [0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337](https://arbiscan.io/address/0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337)
1817
- LnOppositeBridge(v2): [0x48d769d5C7ff75703cDd1543A1a2ed9bC9044A23](https://arbiscan.io/address/0x48d769d5C7ff75703cDd1543A1a2ed9bC9044A23)
18+
- LnBridge(v3): [0xbA5D580B18b6436411562981e02c8A9aA1776D10](https://arbiscan.io/address/0xbA5D580B18b6436411562981e02c8A9aA1776D10)
1919

2020
## Darwinia
2121

2222
- chainId: 46
23-
- LnBridge(v1): [0x84f7a56483C100ECb12CbB4A31b7873dAE0d8E9B](https://darwinia.subscan.io/address/0x84f7a56483C100ECb12CbB4A31b7873dAE0d8E9B)
2423
- LnDefaultBridge(v2): [0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337](https://darwinia.subscan.io/account/0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337)
24+
- LnOppositeBridge(v2): [0x48d769d5C7ff75703cDd1543A1a2ed9bC9044A23](https://darwinia.subscan.io/account/0x48d769d5C7ff75703cDd1543A1a2ed9bC9044A23)
25+
- LnBridge(v3): [0xbA5D580B18b6436411562981e02c8A9aA1776D10](https://darwinia.subscan.io/account/0xbA5D580B18b6436411562981e02c8A9aA1776D10)
2526

2627
## Pologon Pos
2728

2829
- chainId: 137
2930
- LnDefaultBridge(v2): [0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337](https://polygonscan.com/address/0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337)
31+
- LnBridge(v3): [0xbA5D580B18b6436411562981e02c8A9aA1776D10](https://polygonscan.com/address/0xbA5D580B18b6436411562981e02c8A9aA1776D10)
3032

3133
## zkSync era
3234

3335
- chainId: 324
34-
- LnDefaultBridge(v2): [0x767Bc046c989f5e63683fB530f939DD34b91ceAC](https://explorer.zksync.io/address/0x767Bc046c989f5e63683fB530f939DD34b91ceAC)
36+
- LnDefaultBridge(v2): [0x767Bc046c989f5e63683fB530f939DD34b91ceAC](https://era.zksync.network/address/0x767Bc046c989f5e63683fB530f939DD34b91ceAC)
3537

3638
## Binance Smart Chain
3739

3840
- chinaId: 56
3941
- LnDefaultBridge(v2): [0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337](https://bscscan.com/address/0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337)
42+
- LnBridge(v3): [0xbA5D580B18b6436411562981e02c8A9aA1776D10](https://bscscan.com/address/0xbA5D580B18b6436411562981e02c8A9aA1776D10)
4043

4144
## Linea
4245

4346
- chainId: 59144
4447
- LnDefaultBridge(v2): [0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337](https://lineascan.build/address/0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337)
48+
- LnBridge(v3): [0xbA5D580B18b6436411562981e02c8A9aA1776D10](https://lineascan.build/address/0xbA5D580B18b6436411562981e02c8A9aA1776D10)
4549

4650
## Mantle
4751

4852
- chainId: 5000
4953
- LnDefaultBridge(v2): [0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337](https://explorer.mantle.xyz/address/0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337)
54+
- LnBridge(v3): [0xbA5D580B18b6436411562981e02c8A9aA1776D10](https://explorer.mantle.xyz/address/0xbA5D580B18b6436411562981e02c8A9aA1776D10)
5055

5156
## Scroll
5257

5358
- chainId: 534352
5459
- LnDefaultBridge(v2): [0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337](https://scrollscan.com/address/0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337)
60+
- LnBridge(v3): [0xbA5D580B18b6436411562981e02c8A9aA1776D10](https://scrollscan.com/address/0xbA5D580B18b6436411562981e02c8A9aA1776D10)
5561

5662
## OP
5763

5864
- chainId: 10
5965
- LnDefaultBridge(v2): [0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337](https://optimistic.etherscan.io/address/0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337)
66+
- LnBridge(v3): [0xbA5D580B18b6436411562981e02c8A9aA1776D10](https://optimistic.etherscan.io/address/0xbA5D580B18b6436411562981e02c8A9aA1776D10)
6067

6168
## Gnosis Chain
6269

6370
- chainId: 100
6471
- LnDefaultBridge(v2): [0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337](https://gnosisscan.io/address/0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337)
65-
66-
## Crab
67-
68-
- chainId: 44
69-
- LnDefaultBridge(v2): [0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337](https://crab.subscan.io/account/0x94C614DAeFDbf151E1BB53d6A201ae5fF56A9337)
72+
- LnBridge(v3): [0xbA5D580B18b6436411562981e02c8A9aA1776D10](https://gnosisscan.io/address/0xbA5D580B18b6436411562981e02c8A9aA1776D10)

docs/protocol/liquidity-node-v2.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sidebar_position: 3
2+
sidebar_position: 1
33
---
44

55
# Liquidity Node(v2)

docs/protocol/mapping-token.md

Lines changed: 0 additions & 65 deletions
This file was deleted.

docs/relayer/register.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
sidebar_position: 2
33
---
44

5-
# Run a Relayer Node(v2)
5+
# Run a Relayer Node
66

77
## Overview
88

@@ -16,7 +16,7 @@ Prerequisites:
1616
2. Register as a Relayer on the Helix UI, which involves staking a certain amount of collateral.
1717
3. Pull the client code to your local environment, configure bridge information, and compile and run the code.
1818

19-
Now, let's run a Relayer Node on the testnet using the example of (arbitrum-sepolia -> sepolia, USDC).
19+
Now, let's run a Relayer Node (v2 opposite type for example) on the testnet using the example of (arbitrum-sepolia -> sepolia, USDC).
2020

2121
## Registration
2222

@@ -113,13 +113,18 @@ The configuration information for the Relayer is stored in the file `.maintain/c
113113
- **feeLimit**: Controls the maximum cost of a relay operation, protecting the relayer from excessive gas fees
114114
- **reorgThreshold**: It's an assumption about the block confirmation of transactions initiated by users on the source chain – the larger, the safer
115115
- **bridgeType**: Indicates the type of bridge, currently taking values of `lnv2-default`, `lnv2-opposite`, and `lnv3`, consistent with the type displayed during relayer registration
116+
- **minProfit[optional]**: Relayer's minimum profit expected.
117+
- **maxProfit[optional]**: Relayer's maximum profit expected, both minProfit and maxProfix configured, then when the profit range jumps out of the interval [minProfit, maxProfit], it is automatically adjusted to (minProfit+maxProfit)/2.
116118
- **tokens**: List the addresses of token pairs on the source and target chains, as well as the exchange rate for the native token on the target chain.
117119
:::info{title=swapRate}
118-
The swapRate is the conversion rate from the native token on the target chain to the transfer token. For example, the native token on Ethereum is ETH, and the token to be transferred is USDC, the conversion rate might be approximately 2500 at 16/01/2024. As prices fluctuate, the Relayer needs to periodically adjust this ratio.
120+
Parameter swapRate is the conversion rate from the native token on the target chain to the transfer token. For example, the native token on Ethereum is ETH, and the token to be transferred is USDC, the conversion rate might be approximately 2500 at 16/01/2024. As prices fluctuate, the Relayer needs to periodically adjust this ratio.
119121
:::
120122
:::info{title=withdrawLiquidity}
121123
For the lnv3 bridge, the relayer can set two parameters in this section, including withdrawLiquidityAmountThreshold and withdrawLiquidityCountThreshold. The relayer client will check every 6 hours, and if either threshold is met, the relayer client will initiate the settlement process.
122124
:::
125+
:::info{title=useDynamicBaseFee}
126+
This parameter useDynamicBaseFee is only valid for LnbridgeV2 of type opposite, and needs to be used in conjunction with the minProfit parameter. When it is true, the relayer will query the cost of the current relay from the target chain in real time, and convert it into a dynamic cost signature on the source chain for the user.
127+
:::
123128

124129
### SafeWallet
125130

@@ -170,4 +175,4 @@ Return to the Relayer Dashboard page on the UI, enter the **Manage** page, and y
170175

171176
## Tips
172177

173-
If the token bridge is the `Default` type, there will be slight differences in the registration process, and in the client's configuration, the bridgeType should be modified to lnv2-default.
178+
If the token bridge is the `Default` type, there will be slight differences in the registration process, and in the client's configuration, the bridgeType should be modified to lnv2-default. Or if the token bridge is the `v3` type, the bridgeType should be modified to `lnv3`.

docs/user-guide/fee.md

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,7 @@ sidebar_position: 3
44

55
# Fee
66

7-
## Fee for CBA Model
8-
9-
Under the CBA model, Helix relies on generic cross-chain messaging channel to transmit cross-chain information, with the cost of the underlying messaging being the primary factor contributing to the transfer expenses. Currently, Helix Bridge does not charge protocol fees. Therefore, in this type of token bridge, the fees incurred by users are limited to the cost associated with executing the messaging channel, typically paid using native tokens.
10-
11-
## Fee for LnBridge
12-
13-
For LnBridge, the fee structure consists of two components: a base fee to cover the gas fees incurred by the LnProvider when executing transactions on the target chain and a liquidity fee designed to compensate the LnProvider for the loss of liquidity.
7+
The fee structure consists of two components: a base fee to cover the gas fees incurred by the LnProvider when executing transactions on the target chain and a liquidity fee designed to compensate the LnProvider for the loss of liquidity.
148

159
1. Base Fee
1610

docs/user-guide/supported-chains.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,4 +25,3 @@ sidebar_position: 2
2525
- scroll
2626
- op
2727
- gnosis
28-
- crab-dvm

docs/user-guide/transfer.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,9 @@ sidebar_position: 1
88

99
- Visit Helix Bridge at [mainnet](https://helixbridge.app/) or [testnet](https://helix-stg-test.vercel.app/).
1010
- Select source chain, target chain and token you want to transfer.
11-
![Transfer](./img/transfer.png)
1211
- Switch wallet to the source chain and connect wallet.
1312
- Fill the transfer amount, and then you can find the transfer information include fee, estimated time if there are bridges avaliable.
1413
- Click `Transfer` and you will receive a popup for transfer confirmation. Then click `Confirm` after every detail is checked.
15-
![Confirm](./img/confirm.png)
1614
- Then you will be prompted to confirm the transaction in your wallet. After confirming in your wallet, you have submitted the transaction. You can track the transfer progress by clicking on the `transaction history` in the pop-up window.
1715
- All the transfer histories can be found in `Explorer`, and you can filter the history by account address or transaction hash. Click the record, you can see the detail of the transfer.
1816
![History Detail](./img/history-detail.png)

0 commit comments

Comments
 (0)