...

_archive/tf_tokens/stellar_migration/tf_chain_to_stellar_chain.md

@@ -0,0 +1,39 @@
+# Convert TFT to the Stellar Blockchain in the ThreeFold Connect App
+
+This document helps you to convert your TFT from ThreeFold's proprietary Rivine blockchain to the Stellar blockchain. Depending on your current situation you have to do either one or two steps to complete this conversion.
+
+## Step 1: You have not updated to ThreeFold Connect and are still using the old TF App as a wallet
+
+You have not moved from the TF App to ThreeFold Connect. Please follow the steps in the slides below to migrate from TF App to the ThreeFold Connect app.
+
+<iframe src="https://docs.google.com/presentation/d/1IwcGyf6SGOsbXWVraU1OzWUX_O5W4nHobkKxkqs1ryg/embed?start=false&loop=false&delayms=10000" frameborder="0" width="750" height="470" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe>
+
+Congratulations, you successfully migrated your wallet(s) to the ThreeFold Connect app. Now you have only one more step to finish. 
+
+Please continue with Step 2.
+
+## Step 2: You already have ThreeFold Connect, and your tokens are listed in the ThreeFold Connect App
+
+As you've completed Step 1 (just now or a long time ago), we need you to go through the process listed below to move your tokens to the Stellar blockchain. This step is super simple. The migration process is built into the ThreeFold Connect app and only requires you to open it. The app on your phone grabs the updated software automatically and will convert the tokens for you. 
+
+Depending on your token situation (farmer with lots of transactions, an investor with locked tokens, etc, etc) this process might take a while. This is normal, just let the process complete.
+
+Let’s start the conversion process. It  is super simple:
+
+- Close the ThreeFold Connect app on your smartphone
+- Open it again by clicking the ThreeFold Connect icon
+- Click on the Wallet tab below the screen
+
+![](img/wallet_icon.jpg)
+
+- Enter your PIN 
+
+Et voila, the conversion process starts. As stated before, depending on your token situation this process might take a while.  **It is important not to close the app during conversion.**
+
+Once the conversion process has ended, you will arrive in the accounts overview page. Done!
+
+![image](img/accounts_overview_stellar_mainnet.jpg)
+
+*Note that if you get an error message, please try again later before contacting support.*
+
+- TFTA -> TFT: [See here for more info](tfta_to_tft)

_archive/tf_tokens/stellar_migration/tft_tfta_migration_process_technical.md

@@ -0,0 +1,27 @@
+# Technical information how to migrate from TFTA to TFT
+
+## How do we migrate from TFT Rivine to TFT Stellar
+
+While new users after May 2020 can be placed on the Stellar platform directly, existing ones need to have their funds migrated. [Rivine addresses can not be converted to Stellar addresses without knowing the private key](https://github.com/threefoldtech/rivine/blob/master/research/stellar/examples/accounts/readme.md#rivine-key-conversion). The other way is possible though but it does mean that a script to transfer all funds from tfchain to the Stellar platform is not possible.
+
+A possible solution is to provide a service to migrate the funds on demand, initiated by the user's wallet and make sure the private key never leaves the user wallet.
+
+Before the conversion, all addresses on tfchain will be locked by unauthorizing them. [A separate document explains why and the details](https://github.com/threefoldfoundation/tft-stellar/blob/master/specs/conversion/locked_conversion_transaction.md).
+
+### Process
+
+- At conversion time (week 1 or 2 in May), all the Rivine blockchain accounts get locked, this means no-one can transact on Rivine any longer.
+- Only the user knows the private key so it's impossible for any script to transfer the money from Rivine to Stellar.
+- At time of the users convenience, the user logs into the ThreeFold Wallet (ThreeFold Connect) and the following process happens
+  - The wallet creates an account on Stellar with the same private key (which is only visible by the user !!!)
+  - The stellar account creation can only happen by the wallet on the phone for security purposes and is 100% decentralized.
+  - A [Locked Conversion Transaction](https://github.com/threefoldfoundation/tft-stellar/blob/master/specs/conversion/locked_conversion_transaction.md) is started to allow the funds to switch blockchain.
+  - The TFTA is created on Stellar and sent to the users stellar account, the Rivine lock transaction hash is attached to this stellar transaction to make sure there is 100% transparency while the switch happens.
+
+### TFTA
+
+From a valuation perspective TFTA is 100% the same as a TFT, this is just a technical detail for migrating all TFTs from one blockchain to the other and at the end of 2020 all TFTA will become TFT. Using 2 currency names TFT & TFTA allows to provide some price protection during 2020 which is to the benefit of the full ThreeFold community. This means that during 2020 everyone who wants to know the full market cap of TFT needs to make the sum of TFTA and TFT. Starting 2021, this no longer needed, then TFTA will stop to exist.
+
+Source of this info see: [https://github.com/threefoldfoundation/tft-stellar/blob/master/specs/conversion/conversion.md](https://github.com/threefoldfoundation/tft-stellar/blob/master/specs/conversion/conversion.md)
+
+!!!wiki.include:legal:tft_not_investment

_archive/tf_tokens/stellar_migration/wiki_3bot_connect_wallet.md

@@ -0,0 +1,49 @@
+## The wallet in ThreeFold Connect app
+
+#### Where
+
+A wallet can be found in the ThreeFold Connect app (available on Android and iOS), behind the small `Wallet` icon below your screen.
+
+![](img/wallet_icon.jpg)
+
+#### Overview
+
+The main page gives you an overview of all your accounts, with in there the 3 ThreeFold_Tokens that are defined on the Stellar network.
+For each token, in the upper right corner, there is an icon that copies the public account address into the clipboard.
+
+![image](img/accounts_overview_stellar_mainnet.jpg)
+
+#### Detailed views
+
+Clicking on one of the accounts gives you a more detailed view of the individual tokens, with both unlocked and (if applicable) locked balance.
+
+![image](img/account_det_stellar_mainnet.jpg)
+
+Clicking further shows you the detail of the past transactions.
+
+![image](img/trx_stellar_mainnet.jpg)
+
+#### Send and receive tokens
+
+The blue circles with arrows allows you to send or receive tokens.
+
+##### Sending tokens
+
+You can send tokens to others by specifying the public address of the counterparty's account, the amount of tokens, and a message. there is a dropdown list to indicate the token type you want to transfer.
+A fee of 0.1 TFT or TFTA is applicable.
+
+![image](img/send_trx_stellar_mainnet.jpg)
+
+Push `SEND TOKENS` and confirm at the next screen.
+
+![image](img/confirm_send_stellar_mainnet.jpg)
+
+##### Receiving tokens
+
+For receiving tokens, you can generate a QR code. You prepare this QR by filling in all fields (account, currency, amount, a message).
+
+![image](img/receive_trx_stellar_mainnet.jpg)
+
+Pushing on `GENERATE QR`brings you to the next screen with the QR.
+
+![image](img/receive_qr_stellar_mainnet.jpg)