From 8b34bef4ba544110bcb1ba4b2ddf3078957f7a55 Mon Sep 17 00:00:00 2001 From: xiaoch05 Date: Mon, 8 Jul 2024 15:42:42 +0800 Subject: [PATCH 1/4] add lend --- docs/contract-addresses/testnet.md | 5 ++++ docs/relayer/register.md | 46 ++++++++++++++++++++++++++++++ 2 files changed, 51 insertions(+) diff --git a/docs/contract-addresses/testnet.md b/docs/contract-addresses/testnet.md index 1cf7258..07c2d96 100644 --- a/docs/contract-addresses/testnet.md +++ b/docs/contract-addresses/testnet.md @@ -23,3 +23,8 @@ sidebar_position: 2 - chainId: 300 - LnDefaultBridge(v2): [0xBe23e871318E49C747CB909AC65aCCFAEAac3a37](https://sepolia.explorer.zksync.io/address/0xBe23e871318E49C747CB909AC65aCCFAEAac3a37) - LnBridge(v3): [0xDc55fF59F82AA50D8A4A61dB8CcaDffD26Fb7dD2](https://sepolia.explorer.zksync.io/address/0xDc55fF59F82AA50D8A4A61dB8CcaDffD26Fb7dD2) + +## Base Sepolia + +- chainId: 84532 +- LnBridge(v3): [0x29D148A9e87C763292a33A55B9dBcAf44A194102](https://sepolia.basescan.org/address/0x29D148A9e87C763292a33A55B9dBcAf44A194102) diff --git a/docs/relayer/register.md b/docs/relayer/register.md index a56b0c1..5423124 100644 --- a/docs/relayer/register.md +++ b/docs/relayer/register.md @@ -137,6 +137,52 @@ You can also use safewallet to run relayer, just configure the following 3 param - **safeWalletRole:** the Role of the account, can be `signer` or `executor`, the `executor` will send execution transaction when there are enough signatures. +### Advanced Features +You can leverage the decentralized lending feature to achieve two purposes: +- Earn interest on account assets from the lending market during relayer idle times, reducing the cost of funds as a relayer. +- Provide relay services for an asset bridge without needing to hold that specific asset. + +Currently, Helix relayer supports the AAVE lending pool. This feature is only supported for SafeWallet accounts. To use this feature, you need to create a SafeWallet with the same address across different networks and then transfer the tokens to this wallet. + +For example, if you want to use the lending feature on Arbitrum, you will need to add configuration information similar to the example below. +``` +"rpcnodes": [ + { + "name": "arbitrum", + "rpc": "https://arb1.arbitrum.io/rpc", + "lendMarket": [ + { + "protocol": "aave", + "healthFactorLimit": 3.0, + "collaterals": [ + { + "symbol": "weth", + "autosupplyAmount": 0.2 + }, + { + "symbol": "usdt", + "autosupplyAmount": 2000 + } + ], + "tokens": [ + { + "symbol": "weth", + "minRepay": 0.0001, + "minReserved": 0 + } + ] + } + ] + }, +] +``` +- **lenMarket**: Represents the list of lending markets. +- `healthFactorLimit` represents the lending risk factor, with a recommended value of 3. The larger the value, the safer it is, but the corresponding lending amount is lower. +- `collaterals` represents the collateral, and `autosupplyAmount` indicates the automatic collateral limit when the account has a balance and the collateral amount has not reached this value. +- `tokens` represent the lending tokens, and the client will also automatically repay the loan when the account has a balance of these assets. +- `Priority Usage` When a relay order is generated, the usage order of relay account assets is **Account Balance** > **Collateral Redemption** > **Lending Assets**. The redemption of collateral or the use of lending assets will only be enabled if they are in the configuration list. +- `Native Token Handling` The handling of any native token assets, including supply, withdraw, or lending, is represented by its wrapped token in configure file. However, the use of assets in the account remains as native tokens. + ### Install & Run After completing the configuration, you can execute the following commands one by one to compile and start the client: From 3cf89ce9c6326ad8bea6a45f0ab2c89fe76910c0 Mon Sep 17 00:00:00 2001 From: xiaoch05 Date: Wed, 10 Jul 2024 15:08:25 +0800 Subject: [PATCH 2/4] required to connect indexer service --- docs/relayer/client.md | 2 ++ docs/relayer/register.md | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/relayer/client.md b/docs/relayer/client.md index e643199..4d875e4 100644 --- a/docs/relayer/client.md +++ b/docs/relayer/client.md @@ -15,6 +15,8 @@ Here's a brief overview of the steps to deploy a Relayer: If you're not using Helix's public service, you'll need to deploy your own Indexer service. This may involve setting up and configuring an Indexer to index and provide on-chain data. + If you are not connected to the Helix public service, the Helix app will not be able to display your relayer information and will be unable to complete recommendations when users send transactions. + - **Building from Source** Download the Relayer's source code and compile it according to the instructions in the project's documentation. Typically, this involves installing build tools, dependencies, and running build commands. diff --git a/docs/relayer/register.md b/docs/relayer/register.md index 5423124..b152f93 100644 --- a/docs/relayer/register.md +++ b/docs/relayer/register.md @@ -145,7 +145,7 @@ You can leverage the decentralized lending feature to achieve two purposes: Currently, Helix relayer supports the AAVE lending pool. This feature is only supported for SafeWallet accounts. To use this feature, you need to create a SafeWallet with the same address across different networks and then transfer the tokens to this wallet. For example, if you want to use the lending feature on Arbitrum, you will need to add configuration information similar to the example below. -``` +```js "rpcnodes": [ { "name": "arbitrum", From a761a3d5d46ebc3981e327bc36a5891153bcbf29 Mon Sep 17 00:00:00 2001 From: xiaoch05 Date: Wed, 10 Jul 2024 15:58:33 +0800 Subject: [PATCH 3/4] rmv icon on label --- docs/contract-addresses/_category_.json | 2 +- docs/introduction/_category_.json | 2 +- docs/protocol/_category_.json | 2 +- docs/relayer/_category_.json | 2 +- docs/user-guide/_category_.json | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/contract-addresses/_category_.json b/docs/contract-addresses/_category_.json index 69822cb..376c9f1 100644 --- a/docs/contract-addresses/_category_.json +++ b/docs/contract-addresses/_category_.json @@ -1,4 +1,4 @@ { "position": 3, - "label": "🔹 Contract Addresses" + "label": "Contract Addresses" } diff --git a/docs/introduction/_category_.json b/docs/introduction/_category_.json index 247b1d7..7317fd6 100644 --- a/docs/introduction/_category_.json +++ b/docs/introduction/_category_.json @@ -1,4 +1,4 @@ { "position": 1, - "label": "🔹 Introduction" + "label": "Introduction" } diff --git a/docs/protocol/_category_.json b/docs/protocol/_category_.json index a177f82..b9fa159 100644 --- a/docs/protocol/_category_.json +++ b/docs/protocol/_category_.json @@ -1,4 +1,4 @@ { "position": 2, - "label": "🔹 Protocol" + "label": "Protocol" } diff --git a/docs/relayer/_category_.json b/docs/relayer/_category_.json index 0756a07..a8568c3 100644 --- a/docs/relayer/_category_.json +++ b/docs/relayer/_category_.json @@ -1,4 +1,4 @@ { "position": 5, - "label": "🔹 Relayer" + "label": "Relayer" } diff --git a/docs/user-guide/_category_.json b/docs/user-guide/_category_.json index 499d575..0df704e 100644 --- a/docs/user-guide/_category_.json +++ b/docs/user-guide/_category_.json @@ -1,4 +1,4 @@ { "position": 4, - "label": "🔹 User Guide" + "label": "User Guide" } From 75d0fb23c665a63d2850173493505d3c54113c11 Mon Sep 17 00:00:00 2001 From: xiaoch05 Date: Wed, 10 Jul 2024 15:58:59 +0800 Subject: [PATCH 4/4] add audit report link --- sidebars.ts | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/sidebars.ts b/sidebars.ts index 7dfdcb5..656e7a3 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -12,20 +12,20 @@ import type { SidebarsConfig } from "@docusaurus/plugin-content-docs"; */ const sidebars: SidebarsConfig = { // By default, Docusaurus generates a sidebar from the docs folder structure - tutorialSidebar: [{ type: "autogenerated", dirName: "." }], - - // But you can create a sidebar manually - /* tutorialSidebar: [ - 'intro', - 'hello', - { - type: 'category', - label: 'Tutorial', - items: ['tutorial-basics/create-a-document'], - }, + { type: "autogenerated", dirName: "." }, + { + type: 'category', + label: 'Audit', + items: [ + { + type: 'link', + label: 'Audit Report', + href: 'https://github.com/helix-bridge/contracts/blob/master/helix-contract/audit/2024-07-04%20Audit%20Report%20-%20Helix%20Bridge%20v1.0.pdf', + } + ], + }, ], - */ }; export default sidebars;