Skip to content

Commit

Permalink
Remove Satefy Module reference
Browse files Browse the repository at this point in the history
  • Loading branch information
samuelmanzanera committed May 28, 2024
1 parent 2d267e2 commit a947f36
Show file tree
Hide file tree
Showing 4 changed files with 20 additions and 45 deletions.
16 changes: 6 additions & 10 deletions docs/FAQ/bridge-2-ways.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,12 @@ id: bridge-2-ways
title: aeBridge
---

## General
## General

### What is Archethic Bridge two-ways?
The Archethic Bridge two-ways is a decentralized, peer-to-peer bridge that enables the seamless exchange of UCO ERC20 tokens and other major cryptocurrencies like ETH, MATIC, and BNB between the Archethic blockchain and various other blockchains, including Ethereum, Polygon, and BSC.
The Archethic Bridge two-ways is a decentralized, peer-to-peer bridge that enables the seamless exchange of UCO ERC20 tokens and other major cryptocurrencies like ETH, MATIC, and BNB between the Archethic blockchain and various other blockchains, including Ethereum, Polygon, and BSC.

This functionality allows for the transfer of these assets into their equivalent forms on Archethic, such as aeETH, aeMATIC, and aeBNB, providing a secure and straightforward method for exchanging assets. The bridge utilizes atomic swap technology, specifically Hash Time Lock Contracts (HTLC), to facilitate secure and intermediary-free transactions.
This functionality allows for the transfer of these assets into their equivalent forms on Archethic, such as aeETH, aeMATIC, and aeBNB, providing a secure and straightforward method for exchanging assets. The bridge utilizes atomic swap technology, specifically Hash Time Lock Contracts (HTLC), to facilitate secure and intermediary-free transactions.

Moreover, it incorporates Archethic's unique cross-chain verification technique, enhancing the security and decentralization of these exchanges.

Expand Down Expand Up @@ -47,9 +47,6 @@ HTLC stands for Hash Time Lock Contract. In Archethic's bridge, it is a type of
### How does Archethic's cross-chain verification work?
Archethic's cross-chain verification enhances atomic swaps by allowing data retrieval outside of the blockchain. This makes the process fully decentralized and strengthens the security model. Archethic's nodes can verify transaction status on other chains, like EVM blockchains, establishing a strong consensus on the status of a swap.

### What is the Safety Module in Archethic's bridge?
The Safety Module in Archethic's bridge is a reserve of tokens designed to mitigate risks associated with asset bridging. It addresses potential deficiencies and disruptions in bridge operations by providing a token reserve that matches the amount in each pool at launch. This module is funded by fees from transfers and is managed by a multisignature wallet governed by the bridge's governance.

## Specifics of Bridging

### How does the process of bridging from EVM to Archethic work?
Expand Down Expand Up @@ -91,8 +88,8 @@ Polygon Mumbai Testnet no longer supported. Amoy will be later

### How can I buy $UCO after receiving $ETH, $MATIC, or $BNB?

You will be able to buy some $UCO with $ETH / $MATIC or $BNB using the appropriate decentralized exchange (DEX) for your network.
Remember to set the slippage according to the amount's impact on liquidity.
You will be able to buy some $UCO with $ETH / $MATIC or $BNB using the appropriate decentralized exchange (DEX) for your network.
Remember to set the slippage according to the amount's impact on liquidity.
Here's how you can do it for each network:

ETH : [https://app.uniswap.org/](https://app.uniswap.org/)<br/>
Expand All @@ -115,7 +112,7 @@ During the delay of the acknowledgment, you should wait for the end of the durat
You lose the tokens if the Mainnet address is not your address. Same thing if you do an error in the address (for example a 0 instead of 1).

### Can I help the developers analyze the problems?
You can help developers improve the application by submitting information that describes the state of the application.
You can help developers improve the application by submitting information that describes the state of the application.
To do this, you can copy/paste your transaction from your local history in the application.

### While a bridge from Archethic to EVM Blockchain, I have an error '1405'
Expand All @@ -134,4 +131,3 @@ If your EVM wallet is not recognized by the bridge, follow these steps to resolv
By following these steps, you should be able to resolve the issue of the bridge not recognizing your EVM wallet.

---

32 changes: 9 additions & 23 deletions docs/participate/bridge/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,43 +21,29 @@ This atomic swap method ensures secure transfers between chains without a centra

While conventional atomic swaps rely on HTLC techniques for security through peer-to-peer and cryptographic approaches, Archethic enhances its atomic swap protocol by enabling data retrieval outside of the blockchain. This enhancement makes the process completely decentralized and strengthens the security model.

Archethic's nodes can fetch transaction status on other chains, such as EVM blockchains, to establish the status of a swap with a strong consensus.
Archethic's nodes can fetch transaction status on other chains, such as EVM blockchains, to establish the status of a swap with a strong consensus.
Combining HTLC and Archethic's specific capabilities provides a high level of trust in the origin and reveal capabilities of any swap, relying on cryptography and cross-chain data retrieval.

### Safety Module

To mitigate the risks associated with bridging assets, Archethic introduces a **Safety Module**, designed to address deficiencies that may occur when unexpected events disrupt the bridge's operation.

The Safety Module serves as a reserve of tokens that can be used in case of token loss or variations in the locked amount between both chains.

At the launch of any pool, the maximum amount of tokens held by the pool will match the amount in the Safety Module. Each pool has its dedicated Safety Module, which will grow over time, increasing liquidity in the bridge pool.

Funding the Safety Module involves deducting a fee from each transfer originating from EVM to Archethic. This fee is deposited directly into the Safety Module to strengthen the reserve. The more tokens held in the Safety Module, the lower the fee rate becomes.

The Safety Module is represented by a multisignature wallet managed by the bridge's governance.

## Specifics

### EVM to Archethic

The process begins with a secret held by a client (in this case, the bridge's dApp) and its hash, which forms a lock upon revealing the secret.
The process begins with a secret held by a client (in this case, the bridge's dApp) and its hash, which forms a lock upon revealing the secret.

The user deploys an HTLC smart contract on the EVM blockchain through the bridge's EVM pool.

This pool ensures the capacity of the swap's initiator, fee distribution ([see Safety Module](#safety-module)), lock time period, and the recipient's address for the assets to be bridged.
This pool ensures the capacity of the swap's initiator, lock time period, and the recipient's address for the assets to be bridged.

Similarly, the user must deploy a contract on Archethic under the same conditions while specifying the recipient wallet to receive the funds.
Similarly, the user must deploy a contract on Archethic under the same conditions while specifying the recipient wallet to receive the funds.

Subsequently, a request is made to the Archethic's pool (which holds the wrapped tokens) to fill the HTLC.

Because the tokens are wrapped on Archethic, the pool will mint new tokens after cross-chain verification ([see Archethic's specific](#archethics-cross-chain-verification)).

The remaining step involves revealing the secret on EVM to transfer the funds to the bridge's recipient wallet (including the safety module), and replicating this process on Archethic, ensuring that the action is executed on EVM blockchains through off-chain requests.
The remaining step involves revealing the secret on EVM to transfer the funds to the bridge's recipient wallet and replicating this process on Archethic, ensuring that the action is executed on EVM blockchains through off-chain requests.

This results in both counterparties receiving their funds, achieving parity in the bridged assets.


### Archethic to EVM
### Archethic to EVM

To exchange assets from Archethic to EVM, the process follows a similar pattern but in reverse order.
However, a new feature is introduced in the smart contracts. Since EVM cannot request information outside the blockchain, steps are taken to ensure that an action has been performed on Archethic's side. Cryptography is employed to assert the action through a signature and provide non-repudiation proof for the Archethic's pool.
Expand All @@ -72,7 +58,7 @@ On the other side, the user can request the EVM pool to create and provision an

The EVM pool can now create and transfer funds to this new contract.

The remaining step is to reveal the secret. The user asks the Archethic's pool to reveal the secret within the HTLC and provide a signature for this action. At this point, the locked tokens will be burnt.
The remaining step is to reveal the secret. The user asks the Archethic's pool to reveal the secret within the HTLC and provide a signature for this action. At this point, the locked tokens will be burnt.

With the secret revealed, the user can also reveal the secret on the EVM HTLC and provide the signature from Archethic's pool, unlocking the assets to the user's wallet registered within the contract.

Expand All @@ -81,9 +67,9 @@ This process ensures that both counterparties receive their funds, achieving par

## How to access
- **URL**: [https://bridge.archethic.net](https://bridge.archethic.net)
- If you'd like to test the application or take advantage of the latest features under development, you can safely use the application in the testnet: [https://bridge.testnet.archethic.net](https://bridge.testnet.archethic.net)
- If you'd like to test the application or take advantage of the latest features under development, you can safely use the application in the testnet: [https://bridge.testnet.archethic.net](https://bridge.testnet.archethic.net)

This document aims to provide a comprehensive guide to using aeBridge, including an introduction to the necessary concepts, step-by-step guides for interacting with the platform, and technical references for deeper integration and development purposes.

## FAQ
For further information, please refer to the [FAQ](/FAQ/bridge-2-ways).
For further information, please refer to the [FAQ](/FAQ/bridge-2-ways).
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
id: bridge-front
title: Bridge - Application Front End
sidebar_label: aeBridge
id: usage
title: aeBridge - Usage
sidebar_label: Usage
sidebar_position: 4
---

Expand Down Expand Up @@ -39,7 +39,7 @@ Before proceeding, familiarize yourself with [Archethic's Bridge Key Concepts](/

Upon accessing aeBridge, you are greeted with a welcome screen. To begin, click on the 'Bridge' button.

![Welcome Screen](/img/tutorial/Bridge-2-Welcome.png)
![Welcome Screen](/img/tutorial/Bridge-2-Welcome.png)
![Bridge Button](/img/tutorial/Bridge-2-Bridge.png)

### Application Menu
Expand Down Expand Up @@ -182,4 +182,4 @@ Once the refund has been processed, you can find your funds in your wallet.



---
---
7 changes: 0 additions & 7 deletions docs/participate/bridge/usage/_category_.json

This file was deleted.

0 comments on commit a947f36

Please sign in to comment.