manual added documentation in collection manual
@@ -0,0 +1,116 @@
|
||||
<h1> BSC-Stellar Bridge </h1>
|
||||
|
||||
<h2> Table of Contents </h2>
|
||||
|
||||
- [Introduction](#introduction)
|
||||
- [How to Use the BSC-Stellar Bridge](#how-to-use-the-bsc-stellar-bridge)
|
||||
- [Bridge from Stellar to BSC](#bridge-from-stellar-to-bsc)
|
||||
- [Bridge from BSC to Stellar](#bridge-from-bsc-to-stellar)
|
||||
- [Setting Up TFT on Metamask](#setting-up-tft-on-metamask)
|
||||
- [Bridge Fees](#bridge-fees)
|
||||
- [Questions and Feedback](#questions-and-feedback)
|
||||
|
||||
***
|
||||
|
||||
## Introduction
|
||||
|
||||
We present here the main steps to use the BSC-Stellar Bridge.
|
||||
|
||||
|
||||
|
||||
## How to Use the BSC-Stellar Bridge
|
||||
|
||||
To use the BSC-Stellar Bridge, follow the following steps. If this is your first time with MetaMask and BSC, read the section [Setting up TFT on Metamask](#setting-up-tft-on-metamask).
|
||||
|
||||
It will cost 100 TFT* to bridge from Stellar to BSC, and 1 TFT to bridge from BSC to Stellar. There is also a fixed fee of 0.01 TFT when using the Stellar blockchain. Those fees are taken from the total of what you are bridging.
|
||||
|
||||
*For example, if you Bridge 200 TFT, from Stellar to BSC, you will receive 100 TFT.
|
||||
|
||||
> Note: The bridge will process deposits/withdrawals within 48 hours.
|
||||
|
||||
|
||||
### Bridge from Stellar to BSC
|
||||
|
||||
**Pre-requisites:**
|
||||
|
||||
* Metamask account
|
||||
* TF Connect App+Wallet
|
||||
* TFT on Stellar Blockchain
|
||||
|
||||
**Steps**
|
||||
|
||||
1. Go to the BSC-Stellar [Bridge website](https://bridge.bsc.threefold.io/).
|
||||
2. Connect your MetaMask Wallet.
|
||||
3. Sign in with MetaMask.
|
||||
4. Choose the option *Deposit from Stellar*.
|
||||
5. Agree to the *ThreeFold Terms*.
|
||||
6. Read and tick the box of the *Warning Message*.
|
||||
7. On your phone, open up your ThreeFold Connect App and go to the wallet section.
|
||||
8. Select the option *Send*.
|
||||
9. Select the *Stellar* chain.
|
||||
10. Click on the button *Scan QR Code* . The QR Code option automatically fill up your *MESSAGE*.
|
||||
11. Scan the QR code that appears on the Bridge window (or write the information manually).
|
||||
12. Make sure the *MESSAGE* is correctly entered.
|
||||
13. Press *Send Tokens*.
|
||||
14. Press *Confirm*.
|
||||
|
||||
In this method, you use the Bridge directly. Thus, it is normal if you do not see your standard MetaMask address. MetaMask is on ERC20 and TFT is on Stellar. You are sending TFT to the Bridge's address, and the Bridge sends money to your wallet afterward.
|
||||
|
||||
|
||||
|
||||
### Bridge from BSC to Stellar
|
||||
|
||||
**Pre-requisites:**
|
||||
|
||||
* Metamask account
|
||||
* TF Connect App+Wallet
|
||||
* BNB for gas fees
|
||||
* TFT
|
||||
|
||||
**Steps**
|
||||
|
||||
1. Go to the BSC-Stellar [Bridge website](https://bridge.bsc.threefold.io/).
|
||||
2. Connect your MetaMask Wallet.
|
||||
3. Sign in with MetaMask.
|
||||
4. Choose the option *Deposit from BSC*.
|
||||
5. Agree to the *ThreeFold Terms*.
|
||||
6. Read and tick the box of the *Warning Message*.
|
||||
7. On your phone, open up your ThreeFold Connect App and go to the wallet section.
|
||||
8. Copy your Stellar address.
|
||||
9. Paste your Stellar address in the proper field on The BSC-Stellar Bridge.
|
||||
10. Enter the amount of TFT you want to bridge.
|
||||
11. Click on *Withdraw*.
|
||||
12. Follow the instructions on your Metamask Wallet.
|
||||
|
||||
**General Tips**
|
||||
|
||||
* It's a good idea to start with a small amount the first time.
|
||||
* The process is usually quick, but it can take up to 48h. In doubt, contact [TF Support](https://threefoldfaq.crisp.help/en/).
|
||||
* Going from Stellar to BSC costs 100 TFT.
|
||||
* Going from BSC to Stellar costs 1 TFT.
|
||||
* There is also fixed fee of 0.01 TFT when using the Stellar Blockchain.
|
||||
* Gas fees on BSC is usually around 5-20 gwei.
|
||||
* You can try the bridge later if gas fees are high at the moment of your transaction.
|
||||
|
||||
|
||||
|
||||
## Setting Up TFT on Metamask
|
||||
|
||||
* Download Metamask [here](https://metamask.io/download/). Then, install the Metamask extension in your local browser.
|
||||
* Create a Metamask account
|
||||
* Switch the network to `Binance chain` . You will have to create a new network with following information):
|
||||
* Mainnet
|
||||
* Network Name: Smart Chain
|
||||
* New RPC URL: https://bsc-dataseed.binance.org/
|
||||
* ChainID: 56
|
||||
* Symbol: BNB
|
||||
* Block Explorer URL: [https://bscscan.com](https://bscscan.com/)
|
||||
* Add TFT token in Metamask -> custom token -> contract address = `0x8f0FB159380176D324542b3a7933F0C2Fd0c2bbf`
|
||||
|
||||
## Bridge Fees
|
||||
|
||||
To learn more about the bridge fees, read [this documentation](../transaction_fees.md).
|
||||
|
||||
## Questions and Feedback
|
||||
|
||||
If you have any question, feel free to write a post on the [Threefold Forum](https://forum.threefold.io/).
|
@@ -0,0 +1,98 @@
|
||||
<h1>BSC-Stellar Bridge Verification</h1>
|
||||
|
||||
<h2>Table of Contents</h2>
|
||||
|
||||
- [Introduction](#introduction)
|
||||
- [From Stellar to BSC](#from-stellar-to-bsc)
|
||||
- [From BSC to Stellar](#from-bsc-to-stellar)
|
||||
- [Conclusion](#conclusion)
|
||||
|
||||
***
|
||||
|
||||
## Introduction
|
||||
|
||||
In this guide, we show how to verify transactions on the BSC-Stellar bridge.
|
||||
|
||||
When using the TFT bridge to Binance Chain (BSC), it's not simple to verify that tokens arrived at the destination wallet. The core reason is that it's not a regular token transfer, and so it doesn't show up that way in blockchain explorers.
|
||||
|
||||
Instead, the result of using the bridge is a contract call that actually mints wrapped TFT on Binance Chain. The corresponding tokens are vaulted on Stellar, and when the bridge is used in the opposite direction, TFT on Binance Chain are burnt and then released on Stellar. Thus, the total number of TFT in circulation is constant throughout these operations.
|
||||
|
||||
What we can do, instead of looking at token transfers, is to look for the mint events themselves. By parsing together data from a few different sources, we can verify that tokens sent to the bridge address on Stellar indeed arrived at their destination on Binance Chain.
|
||||
|
||||
## From Stellar to BSC
|
||||
|
||||
We start with a bridge example going from Stellar to BSC. For this tutorial, we'll use an example transaction found by looking at the transaction history from the [bridge wallet](https://stellar.expert/explorer/public/account/GBFFWXWBZDILJJAMSINHPJEUJKB3H4UYXRWNB4COYQAF7UUQSWSBUXW5). This wallet uses both directions of bridging. In our case, we want to look for an inbound transaction. Here's an example:
|
||||
|
||||

|
||||
|
||||
The first thing to do is decode the destination wallet address on Binance Chain, which is contained in the memo we see here on Stellar. It's encoded in base 64 and we can convert back to the original hex using a tool like this [Base64 to Hex Converter](https://base64.guru/converter/decode/hex):
|
||||
|
||||

|
||||
|
||||
The output is the destination address on Binance Chain. Since we usually write hex values with a leading `0x`, the full address in the normal format is `0x64df465bbcee5db45131e9406662818e8ba34fc0`.
|
||||
|
||||
The other thing to note is the date and time of the original Stellar transaction. There are sometimes delays on the bridge, but we know that the outbound transaction on Binance Chain will always happen after the inbound transaction on Stellar. In this case, we are looking at the most recent transaction on the Stellar side of the bridge, so we can just look for the most recent transaction on the Binance side too.
|
||||
|
||||
To do that, we'll go to the [Bitquery explorer](https://explorer.bitquery.io/bsc) for BSC. We're looking for the token contract for TFT on Binance Chain, which you can find in our documentation: `0x8f0fb159380176d324542b3a7933f0c2fd0c2bbf`.
|
||||
|
||||
On the [contract page](https://explorer.bitquery.io/bsc/token/0x8f0fb159380176d324542b3a7933f0c2fd0c2bbf), click **Events**:
|
||||
|
||||

|
||||
|
||||
Then on the row **Mint** events, click on the icon aligned with the **Event Count** column:
|
||||
|
||||

|
||||
|
||||
We then arrive at [this page](https://explorer.bitquery.io/bsc/txs/events?contract=0x8f0fb159380176d324542b3a7933f0c2fd0c2bbf&event=85a66b9141978db9980f7e0ce3b468cebf4f7999f32b23091c5c03e798b1ba7a):
|
||||
|
||||

|
||||
|
||||
You can use the **Date range** selector here to look for events in the past. In this case, we'll just look for the latest one, since that's what we're using for our example. Click the transaction link and then copy the transaction hash from the next page:
|
||||
|
||||

|
||||
|
||||
To get a look into the contract call, we switch over to [BscScan](https://bscscan.com/) at this point for a better view. Search for the transaction hash and then select the event log. We will then see the output address and the amount of TFT minted in the data below:
|
||||
|
||||

|
||||
|
||||
We can see that the address matches the one we decoded from the Stellar memo. As for the **tokens** amount, we need to account fo the fact that TFT uses 7 decimal places. For this reason, we move the decimal place by dividing by 1e7 (i.e. 1x10⁷):
|
||||
|
||||

|
||||
|
||||
The original transaction on Stellar was for 2600 TFT, and the output after subtracting the 100 TFT bridge fee is 2500 TFT.
|
||||
|
||||
## From BSC to Stellar
|
||||
|
||||
Now, we will see a bridge example going from BSC to Stellar. This time, we start at the BscScan explorer.
|
||||
|
||||
Here is an example bridge transaction, as seen from the account transactions view, which is the default view if you search for a wallet address:
|
||||
|
||||

|
||||
|
||||
We can identify it because it's using the **Withdraw** method in a transaction to the TFT contract address on BSC.
|
||||
|
||||
If we open the [Transaction Details page](https://bscscan.com/tx/0xae2a9b5cdad652ecb1e6252ee44a7f0e3c5fc9cdf1df9fddff3b0c100c4b3cb5) by clicking on the transaction hash and switch to the **Logs** view, we can see more details:
|
||||
|
||||

|
||||
|
||||
In particular, this shows us the destination address on Stellar and the TFT amount. To get the decimal form, we once again divide by 1e7 (i.e. 1x10⁷).
|
||||
|
||||
Back on StellarExpert, we can find a transaction on the same date just shortly after the transaction on BSC, for the same amount of TFT minus the 1 TFT bridge fee. It originates from the bridge address on Stellar and the destination is the address we see in the contract call above:
|
||||
|
||||

|
||||
|
||||
As a final step, we double-check that the transaction we see on Stellar is actually the result of the bridge interaction we saw on BSC. It's possible, after all, that the user has sent multiple transactions with the same amount. To do this, we look at the memo on the Stellar transaction. As above, we need to convert from base 64 to hex again. To do so, we can once again use the [Base64 to HEX Converter](https://base64.guru/converter/decode/hex):
|
||||
|
||||

|
||||
|
||||
If the output hex doesn't already look familiar, you can compare it to the transaction hash from above, while remembering that `0x` is just a formatting convention indicating that hex data follows. Indeed, we can even search it on BscScan, to come full circle back to transaction details page we have seen before.
|
||||
|
||||
We have made a direct link between the use of the bridge contract on BSC and the resulting payment from the bridge on Stellar.
|
||||
|
||||
## Conclusion
|
||||
|
||||
In this guide, we covered how to verify bridge transactions going from BSC to Stellar and from Stellar to BSC.
|
||||
|
||||
In the world of public blockchains, all data is recorded and accessible, but sometimes it takes some investigation to find what we are looking for.
|
||||
|
||||
If you have any questions, you can ask the ThreeFold community for help on the [ThreeFold Forum](http://forum.threefold.io/) or on the [ThreeFold Grid Tester Community](https://t.me/threefoldtesting) on Telegram.
|
After Width: | Height: | Size: 18 KiB |
After Width: | Height: | Size: 56 KiB |
After Width: | Height: | Size: 55 KiB |
After Width: | Height: | Size: 44 KiB |
After Width: | Height: | Size: 131 KiB |
After Width: | Height: | Size: 59 KiB |
After Width: | Height: | Size: 114 KiB |
After Width: | Height: | Size: 1.3 KiB |
After Width: | Height: | Size: 76 KiB |
After Width: | Height: | Size: 53 KiB |
After Width: | Height: | Size: 15 KiB |
After Width: | Height: | Size: 56 KiB |
After Width: | Height: | Size: 58 KiB |
@@ -0,0 +1,43 @@
|
||||
<h1> TFChain-Stellar Bridges: Main Net and Test Net</h1>
|
||||
|
||||
<h2> Table of Contents </h2>
|
||||
|
||||
- [Introduction](#introduction)
|
||||
- [How to Use the TFChain-Stellar Bridge](#how-to-use-the-tfchain-stellar-bridge)
|
||||
- [Bridge Fees](#bridge-fees)
|
||||
- [Questions and Feedback](#questions-and-feedback)
|
||||
|
||||
***
|
||||
|
||||
## Introduction
|
||||
|
||||
We present here the general steps to use the TFChain-Stellar Bridge. Note that the only difference between using the Main net or Test net TFChain-Stellar bridge lies in the ThreeFold Dashboard URL.
|
||||
|
||||
Read the [Dashboard section](../../dashboard/tfchain/tf_token_bridge.md) for more information.
|
||||
|
||||
|
||||
|
||||
## How to Use the TFChain-Stellar Bridge
|
||||
|
||||
1. Go on the ThreeFold Dashboard
|
||||
1. [Main Net](https://dashboard.grid.tf/)
|
||||
2. [Test Net](https://dashboard.test.grid.tf/)
|
||||
2. Go to **TFChain** -> **TF Token Bridge**
|
||||
3. 2-Way Bridge:
|
||||
* Transfer TFT from Stellar to TFChain
|
||||
* Click on *Deposit*
|
||||
* Transfer TFT from TFChain to Stellar
|
||||
* Click on *Withdraw*
|
||||
|
||||
Note: If you are on ThreeFold Connect App, you can export your account to the Polkadot extension. Look at the section [Move Farm from the TF app to the TF Portal (polkadot.js)](../storing_tft/tf_connect_app.md#move-farm-from-the-tf-connect-app-to-the-tf-portal-polkadotjs).
|
||||
|
||||
|
||||
|
||||
## Bridge Fees
|
||||
|
||||
To learn more about the bridge fees, read [this documentation](../transaction_fees.md).
|
||||
|
||||
## Questions and Feedback
|
||||
|
||||
If you have any question, feel free to write a post on the [Threefold Forum](https://forum.threefold.io/).
|
||||
|
@@ -0,0 +1,69 @@
|
||||
<h1> TFT Bridges </h1>
|
||||
|
||||
<h2> Table of Contents </h2>
|
||||
|
||||
- [TFChain-Stellar Bridge](./tfchain_stellar_bridge.md)
|
||||
- [BSC-Stellar Bridge](./bsc_stellar_bridge.md)
|
||||
- [BSC-Stellar Bridge Verification](./bsc_stellar_bridge_verification.md)
|
||||
- [Ethereum-Stellar Bridge](./tft_ethereum/tft_ethereum.md)
|
||||
- [Bridge Fees](../transaction_fees.md)
|
||||
|
||||
***
|
||||
|
||||
## Introduction
|
||||
|
||||
The ThreeFold Token (TFT) exists on different chains. To transfer TFTs between chains, you can use different TFT Bridges.
|
||||
|
||||
The following diagram shows the different bridges and ways to transfer ThreeFold Tokens (TFT) from one chain to another.
|
||||
|
||||
> Note: You can click on a given bridge to access its related guide.
|
||||
|
||||
```mermaid
|
||||
|
||||
graph LR
|
||||
A((TFChain-MainNet)) === id1(Stellar / TFChain MainNet Bridge) === B((Stellar Chain));
|
||||
C((TFChain-TestNet)) === id2(Stellar / TFChain TestNet Bridge) === B((Stellar Chain));
|
||||
B((Stellar Chain)) === id3(Stellar / BSC Bridge) === E((Binance Smart Chain));
|
||||
B((Stellar Chain)) === id4(Stellar / Eth Bridge) === D((Ethereum Chain));
|
||||
|
||||
click id1 "./tfchain_stellar_bridge.html"
|
||||
click id2 "./tfchain_stellar_bridge.html"
|
||||
click id3 "./bsc_stellar_bridge.html"
|
||||
click id4 "./tft_ethereum/tft_ethereum.html"
|
||||
|
||||
```
|
||||
|
||||
## Links
|
||||
|
||||
The links to the bridges for TFT are the following:
|
||||
|
||||
* Stellar-Ethereum Bridge
|
||||
* This bridge is accessible at the following link: [https://bridge.eth.threefold.io/](https://bridge.eth.threefold.io/)
|
||||
* Read [this guide](./tft_ethereum/tft_ethereum.md) for more information
|
||||
* Stellar-BSC Bridge
|
||||
* This bridge is accessible at the following link: [https://bridge.bsc.threefold.io/](https://bridge.bsc.threefold.io/)
|
||||
* Read [this guide](./bsc_stellar_bridge.html) for more information
|
||||
* The TFChain Main net Bridge
|
||||
* This bridge is accessible on the ThreeFold Main Net Dashboard: [https://dashboard.grid.tf/](https://dashboard.grid.tf/).
|
||||
* Read [this guide](./tfchain_stellar_bridge.html) for more information
|
||||
* The TFChain Test net Bridge
|
||||
* This bridge is accessible on the ThreeFold Test Net Dashboard: [https://dashboard.test.grid.tf/](https://dashboard.test.grid.tf/).
|
||||
* Read [this guide](./tfchain_stellar_bridge.html) for more information
|
||||
|
||||
## Chains Functions
|
||||
|
||||
The different bridges help you move your TFT and achieve different goals:
|
||||
|
||||
* The TFChain-Stellar Bridge is used to go between the Stellar Chain and TF Chain for Main net and Test net.
|
||||
* The BSC-Stellar Bridge is used to go between the Stellar Chain and Binance Smart Chain (BSC).
|
||||
* The Stellar-Ethereum Bridge is used to go between the Stellar Chain and the Ethereum blockchain.
|
||||
|
||||
As shown in the diagram, to go from BSC to TF Chain, or from TF Chain to BSC, you need to use first the BSC-Stellar bridge, then the Stellar-TFChain bridge. To go from the Ethereum blockchain to TFChain, you need to use the Ethereum-Stellar bridge then the Stellar-TFChain bridge.
|
||||
|
||||
BSC, Stellar and Ethereum can be used to sell/buy TFT, while TFChain can be used to deploy Dapps on the [ThreeFold Dashboard](https://dashboard.grid.tf). The TFT minting process happens on Stellar Blockchain.
|
||||
|
||||
> Note: You should always start with a small amount the first time you try a bridge.
|
||||
|
||||
## Bridge Details
|
||||
|
||||
When you bridge TFT from Stellar to another chain, the TFT on Stellar is vaulted. When you bridge TFT back to Stellar, the TFT on the other chain is burned and the vaulted TFT is released.
|
After Width: | Height: | Size: 19 KiB |
After Width: | Height: | Size: 18 KiB |
After Width: | Height: | Size: 18 KiB |
After Width: | Height: | Size: 14 KiB |
After Width: | Height: | Size: 14 KiB |
@@ -0,0 +1,36 @@
|
||||
<h1>Ethereum-Stellar Bridge</h1>
|
||||
|
||||
<h2>Table of Contents</h2>
|
||||
|
||||
- [Introduction](#introduction)
|
||||
- [How to Use the Ethereum-Stellar Bridge](#how-to-use-the-ethereum-stellar-bridge)
|
||||
- [Bridge Fees](#bridge-fees)
|
||||
- [Questions and Feedback](#questions-and-feedback)
|
||||
|
||||
***
|
||||
|
||||
## Introduction
|
||||
|
||||
The TFT Stellar-Ethereum bridge serves as a vital link between the Stellar and Ethereum blockchains, enabling the seamless transfer of TFT tokens between these two networks. This bridge enhances interoperability and expands the utility of TFT by allowing users to leverage the strengths of both platforms. With the bridge in place, TFT holders can convert their tokens from the Stellar network to the Ethereum network and vice versa, unlocking new possibilities for engagement with decentralized applications, smart contracts, and the vibrant Ethereum ecosystem. This bridge promotes liquidity, facilitates cross-chain transactions, and encourages collaboration between the Stellar and Ethereum communities.
|
||||
|
||||
|
||||
|
||||
## How to Use the Ethereum-Stellar Bridge
|
||||
|
||||
The easiest way to transfer TFT between Ethereum and Stellar is to use the [TFT Ethereum Bridge](https://bridge.eth.threefold.io). We present here the main steps on how to use this bridge.
|
||||
|
||||
When you go to the [TFT Ethereum-Stellar bridge website](https://bridge.eth.threefold.io/), connect your Ethereum wallet. Then the bridge will present a QR code which you scan with your Stellar wallet. This will populate a transaction with the bridge wallet as the destination and an encoded form of your Ethereum address as the memo. The bridge will scan the transaction, decode the Ethereum wallet address, and deliver newly minted TFT on Ethereum, minus the bridge fees.
|
||||
|
||||
For the reverse operation, going from Ethereum to Stellar, there is a smart contract interaction that burns TFT on Ethereum while embedding your Stellar wallet address. The bridge will scan that transaction and release TFT from its vault wallet to the specified Stellar address, again minus the bridge fees.
|
||||
|
||||
Note that the contract address for TFT on Ethereum is the following: `0x395E925834996e558bdeC77CD648435d620AfB5b`.
|
||||
|
||||
To see the ThreeFold Token on Etherscan, check [this link](https://etherscan.io/token/0x395E925834996e558bdeC77CD648435d620AfB5b).
|
||||
|
||||
## Bridge Fees
|
||||
|
||||
To learn more about the bridge fees, read [this documentation](../../transaction_fees.md).
|
||||
|
||||
## Questions and Feedback
|
||||
|
||||
If you have any question, feel free to write a post on the [Threefold Forum](https://forum.threefold.io/).
|