development_manual_update_june #98

Merged
mik-tf merged 10 commits from development_manual_update_june into development 2024-06-13 23:02:16 +00:00
60 changed files with 426 additions and 68 deletions
Showing only changes of commit 1637a7bbdf - Show all commits

View File

@ -1,6 +1,6 @@
- [Introduction](manual/intro.md) - [Introduction](manual/intro.md)
- [Documentation](manual/documentation.md) - [Documentation](manual/documentation.md)
- [Dashboard](dashboard/dashboard.md) - [ThreeFold Dashboard](dashboard/dashboard.md)
- [Wallet Connector](dashboard/wallet_connector.md) - [Wallet Connector](dashboard/wallet_connector.md)
- [TFGrid](dashboard/tfgrid/tfgrid.md) - [TFGrid](dashboard/tfgrid/tfgrid.md)
- [Grid Status](dashboard/tfgrid/grid_status.md) - [Grid Status](dashboard/tfgrid/grid_status.md)
@ -50,6 +50,11 @@
- [TF Token Bridge](dashboard/tfchain/tf_token_bridge.md) - [TF Token Bridge](dashboard/tfchain/tf_token_bridge.md)
- [TF Token Transfer](dashboard/tfchain/tf_token_transfer.md) - [TF Token Transfer](dashboard/tfchain/tf_token_transfer.md)
- [TF Minting Reports](dashboard/tfchain/tf_minting_reports.md) - [TF Minting Reports](dashboard/tfchain/tf_minting_reports.md)
- [ThreeFold Connect](tfconnect/tfconnect_toc.md)
- [TFConnect Overview](tfconnect/tfconnect_overview.md)
- [TFConnect Authenticator](tfconnect/tfconnect_authenticator.md)
- [TFConnect Advanced](tfconnect/tfconnect_advanced.md)
- [TFConnect Troubleshooting](tfconnect/tfconnect_troubleshooting.md)
- [Developers](developers/developers.md) - [Developers](developers/developers.md)
- [Javascript Client](developers/javascript/grid3_javascript_readme.md) - [Javascript Client](developers/javascript/grid3_javascript_readme.md)
- [Installation](developers/javascript/grid3_javascript_installation.md) - [Installation](developers/javascript/grid3_javascript_installation.md)

View File

@ -33,9 +33,6 @@
- [TF Connect App, TF Dashboard, GraphQL, Grix Proxy and Polkadot Substrate](#tf-connect-app-tf-dashboard-graphql-grix-proxy-and-polkadot-substrate) - [TF Connect App, TF Dashboard, GraphQL, Grix Proxy and Polkadot Substrate](#tf-connect-app-tf-dashboard-graphql-grix-proxy-and-polkadot-substrate)
- [Is there a way to create or import another wallet in TF Connect App?](#is-there-a-way-to-create-or-import-another-wallet-in-tf-connect-app) - [Is there a way to create or import another wallet in TF Connect App?](#is-there-a-way-to-create-or-import-another-wallet-in-tf-connect-app)
- [I created a farm on the TF Chain. On the TF Connect App Farmer Migration section, my farm is under Other v3 farms, is this normal?](#i-created-a-farm-on-the-tf-chain-on-the-tf-connect-app-farmer-migration-section-my-farm-is-under-other-v3-farms-is-this-normal) - [I created a farm on the TF Chain. On the TF Connect App Farmer Migration section, my farm is under Other v3 farms, is this normal?](#i-created-a-farm-on-the-tf-chain-on-the-tf-connect-app-farmer-migration-section-my-farm-is-under-other-v3-farms-is-this-normal)
- [I am trying to access my wallet in the ThreeFold Connect App. It worked fine before, but now I just get a white screen. What does it mean and what can I do?](#i-am-trying-to-access-my-wallet-in-the-threefold-connect-app-it-worked-fine-before-but-now-i-just-get-a-white-screen-what-does-it-mean-and-what-can-i-do)
- [When I open the ThreeFold Connect App, I get the error: Error in initialization in Flagsmith. How can I fix this issue?](#when-i-open-the-threefold-connect-app-i-get-the-error-error-in-initialization-in-flagsmith-how-can-i-fix-this-issue)
- [Apart form the ThreeFold Connect App Wallet, how can I check my TFT balance?](#apart-form-the-threefold-connect-app-wallet-how-can-i-check-my-tft-balance)
- [Is it possible to export the transaction history of a wallet to a CSV file?](#is-it-possible-to-export-the-transaction-history-of-a-wallet-to-a-csv-file) - [Is it possible to export the transaction history of a wallet to a CSV file?](#is-it-possible-to-export-the-transaction-history-of-a-wallet-to-a-csv-file)
- [How can I use GraphQl to find information on the ThreeFold Grid?](#how-can-i-use-graphql-to-find-information-on-the-threefold-grid) - [How can I use GraphQl to find information on the ThreeFold Grid?](#how-can-i-use-graphql-to-find-information-on-the-threefold-grid)
- [What are the different links to ThreeFold's Graph QL depending on the network?](#what-are-the-different-links-to-threefolds-graph-ql-depending-on-the-network) - [What are the different links to ThreeFold's Graph QL depending on the network?](#what-are-the-different-links-to-threefolds-graph-ql-depending-on-the-network)
@ -44,7 +41,6 @@
- [How can I use Grid Proxy to find information on the ThreeFold Grid and 3Nodes?](#how-can-i-use-grid-proxy-to-find-information-on-the-threefold-grid-and-3nodes) - [How can I use Grid Proxy to find information on the ThreeFold Grid and 3Nodes?](#how-can-i-use-grid-proxy-to-find-information-on-the-threefold-grid-and-3nodes)
- [Who is hosting GraphQL and Grid Proxy on the ThreeFold Grid?](#who-is-hosting-graphql-and-grid-proxy-on-the-threefold-grid) - [Who is hosting GraphQL and Grid Proxy on the ThreeFold Grid?](#who-is-hosting-graphql-and-grid-proxy-on-the-threefold-grid)
- [What is the difference between uptime, status and power state?](#what-is-the-difference-between-uptime-status-and-power-state) - [What is the difference between uptime, status and power state?](#what-is-the-difference-between-uptime-status-and-power-state)
- [I do not remember the name - ThreeFold 3bot ID - associated with my seed phrase on the ThreeFold Connect app. Can I recover my TF Connect app account with only the seed phrase and not the name, 3bot ID, associated with it?](#i-do-not-remember-the-name---threefold-3bot-id---associated-with-my-seed-phrase-on-the-threefold-connect-app-can-i-recover-my-tf-connect-app-account-with-only-the-seed-phrase-and-not-the-name-3bot-id-associated-with-it)
- [USERS FAQ](#users-faq) - [USERS FAQ](#users-faq)
- [TF Grid Functionalities](#tf-grid-functionalities) - [TF Grid Functionalities](#tf-grid-functionalities)
- [What are the type of storage available on TF Grid?](#what-are-the-type-of-storage-available-on-tf-grid) - [What are the type of storage available on TF Grid?](#what-are-the-type-of-storage-available-on-tf-grid)
@ -81,9 +77,6 @@
- [Users Troubleshooting and Error Messages](#users-troubleshooting-and-error-messages) - [Users Troubleshooting and Error Messages](#users-troubleshooting-and-error-messages)
- [When deploying a virtual machine (VM) on the ThreeFold Grid, I get the following message after trying a full system update and upgrade: GRUB failed to install to the following devices... Is there a fix to this issue?](#when-deploying-a-virtual-machine-vm-on-the-threefold-grid-i-get-the-following-message-after-trying-a-full-system-update-and-upgrade-grub-failed-to-install-to-the-following-devices-is-there-a-fix-to-this-issue) - [When deploying a virtual machine (VM) on the ThreeFold Grid, I get the following message after trying a full system update and upgrade: GRUB failed to install to the following devices... Is there a fix to this issue?](#when-deploying-a-virtual-machine-vm-on-the-threefold-grid-i-get-the-following-message-after-trying-a-full-system-update-and-upgrade-grub-failed-to-install-to-the-following-devices-is-there-a-fix-to-this-issue)
- [While deploying on the TF Dashboard, I get the following error :"global workload with the same name exists: conflict". What can I do to fix this issue?](#while-deploying-on-the-tf-dashboard-i-get-the-following-error-global-workload-with-the-same-name-exists-conflict-what-can-i-do-to-fix-this-issue) - [While deploying on the TF Dashboard, I get the following error :"global workload with the same name exists: conflict". What can I do to fix this issue?](#while-deploying-on-the-tf-dashboard-i-get-the-following-error-global-workload-with-the-same-name-exists-conflict-what-can-i-do-to-fix-this-issue)
- [ThreeFold Connect App](#threefold-connect-app)
- [TF Connect App is now asking for a 4-digit password (PIN). I don't remember it as I usually use touch or face ID to unlock the app. What can I do?](#tf-connect-app-is-now-asking-for-a-4-digit-password-pin-i-dont-remember-it-as-i-usually-use-touch-or-face-id-to-unlock-the-app-what-can-i-do)
- [Is there a way to have more than one wallet in TF Connect App?](#is-there-a-way-to-have-more-than-one-wallet-in-tf-connect-app)
- [What is the difference between 10.x.y.z and 192.168.x.y addresses?](#what-is-the-difference-between-10xyz-and-192168xy-addresses) - [What is the difference between 10.x.y.z and 192.168.x.y addresses?](#what-is-the-difference-between-10xyz-and-192168xy-addresses)
- [DEVELOPERS FAQ](#developers-faq) - [DEVELOPERS FAQ](#developers-faq)
- [General Information for Developer](#general-information-for-developer) - [General Information for Developer](#general-information-for-developer)
@ -117,7 +110,6 @@
- [When it comes to the Zero-OS bootstrap image, can I simply duplicate the first image I burnt when I build another 3Node?](#when-it-comes-to-the-zero-os-bootstrap-image-can-i-simply-duplicate-the-first-image-i-burnt-when-i-build-another-3node) - [When it comes to the Zero-OS bootstrap image, can I simply duplicate the first image I burnt when I build another 3Node?](#when-it-comes-to-the-zero-os-bootstrap-image-can-i-simply-duplicate-the-first-image-i-burnt-when-i-build-another-3node)
- [If a node is unused for certain time, e.g. many months offline, will it be erased by the Grid?](#if-a-node-is-unused-for-certain-time-eg-many-months-offline-will-it-be-erased-by-the-grid) - [If a node is unused for certain time, e.g. many months offline, will it be erased by the Grid?](#if-a-node-is-unused-for-certain-time-eg-many-months-offline-will-it-be-erased-by-the-grid)
- [Can a farm be erased from TF Grid?](#can-a-farm-be-erased-from-tf-grid) - [Can a farm be erased from TF Grid?](#can-a-farm-be-erased-from-tf-grid)
- [On the ThreeFold Connect App, it says I need to migrate my Titan farm from V2 to V3. What do I have to do? How long does this take?](#on-the-threefold-connect-app-it-says-i-need-to-migrate-my-titan-farm-from-v2-to-v3-what-do-i-have-to-do-how-long-does-this-take)
- [How can I migrate my DIY farm from V2 to V3?](#how-can-i-migrate-my-diy-farm-from-v2-to-v3) - [How can I migrate my DIY farm from V2 to V3?](#how-can-i-migrate-my-diy-farm-from-v2-to-v3)
- [What does the pricing policy ID of a farm represent?](#what-does-the-pricing-policy-id-of-a-farm-represent) - [What does the pricing policy ID of a farm represent?](#what-does-the-pricing-policy-id-of-a-farm-represent)
- [What is the difference between TiB and TB? Why doesn't the TF Explorer shows the same storage space as my disk?](#what-is-the-difference-between-tib-and-tb-why-doesnt-the-tf-explorer-shows-the-same-storage-space-as-my-disk) - [What is the difference between TiB and TB? Why doesn't the TF Explorer shows the same storage space as my disk?](#what-is-the-difference-between-tib-and-tb-why-doesnt-the-tf-explorer-shows-the-same-storage-space-as-my-disk)
@ -416,28 +408,6 @@ The TF Connect App supports Stellar and TF Chain wallets. The app by default can
Yes this is normal. Farms created on TF Chain instead of the TF Connect App will appear in *Other v3 farms*. Yes this is normal. Farms created on TF Chain instead of the TF Connect App will appear in *Other v3 farms*.
### I am trying to access my wallet in the ThreeFold Connect App. It worked fine before, but now I just get a white screen. What does it mean and what can I do?
On the TF Connect App, when you get a white screen, it means that there is a connection issue. It can help to try other networks; maybe try switching between ethernet cable or wifi. Or you can also try it later when the connection might be more stable.
### When I open the ThreeFold Connect App, I get the error: Error in initialization in Flagsmith. How can I fix this issue?
To fix this Flagsmith error message on the ThreeFold Connect app, you can try the following methods:
* Check your internet connection
* Update your phone current operating system (OS) version
* Update the date and time on your phone
### Apart form the ThreeFold Connect App Wallet, how can I check my TFT balance?
You can go on [Stellar.Expert](https://stellar.expert). With your wallet address, you will be able to see your transactions and wallet details.
### Is it possible to export the transaction history of a wallet to a CSV file? ### Is it possible to export the transaction history of a wallet to a CSV file?
Yes, every blockchain has an explorer function and these explorer functions allow you to see transactions and export them. TFT is on 2 chains at the moment: Stellar and Polkadot. Yes, every blockchain has an explorer function and these explorer functions allow you to see transactions and export them. TFT is on 2 chains at the moment: Stellar and Polkadot.
@ -568,15 +538,6 @@ There are three distinctly named endpoints or fields that exist in the back end
* Power state * Power state
* this is a field that only exists on GraphQL, and it's the self reported power state of the node. This only goes to "down" if the node shut itself down at request of the Farmerbot. * this is a field that only exists on GraphQL, and it's the self reported power state of the node. This only goes to "down" if the node shut itself down at request of the Farmerbot.
### I do not remember the name - ThreeFold 3bot ID - associated with my seed phrase on the ThreeFold Connect app. Can I recover my TF Connect app account with only the seed phrase and not the name, 3bot ID, associated with it?
If you forgot the name associated with your seed phrase on the TF Connect app, you can always create a new identity (ThreeFold 3bot ID) and import your wallet using the old seed phrase.
Since the Connect App is also used for identity and authentication, you need both the name (3bot ID) and seed phrase to fully recover your account. The wallet is only linked to the seed phrase and not the name (3bot ID).
# USERS FAQ # USERS FAQ
## TF Grid Functionalities ## TF Grid Functionalities
@ -1020,24 +981,6 @@ This should fix the issue.
This error happens if you deployed a workload on the TF Dashboard with the same deployment name of a previous deployment. In general, you can simply refresh the TF Dashboard browser page and/or change the deployment name for a new one. This should fix the issue. This error happens if you deployed a workload on the TF Dashboard with the same deployment name of a previous deployment. In general, you can simply refresh the TF Dashboard browser page and/or change the deployment name for a new one. This should fix the issue.
## ThreeFold Connect App
### TF Connect App is now asking for a 4-digit password (PIN). I don't remember it as I usually use touch or face ID to unlock the app. What can I do?
When you set up your the app, you are asked a 4-digit password (PIN). After some time, the app will be asking for this PIN when users may have been exclusively using touch/face ID. You can reset it by recovering the account with your seedphrase.
### Is there a way to have more than one wallet in TF Connect App?
Yes, this is perfectly possible. You can have multiple wallets in the TF Connect app. You can have multiple wallets for the Stellar network and multiple wallets for Polkadot Substrate.
For example, you can create a wallet on the Stellar Blockchain and import it on TF Connect App with the function *Import Wallet*. Just copy the seedphrase and it will be imported in TF Connect App.
Note: There will not be an automatic function in the app to create a new wallet. You must do it manually.
### What is the difference between 10.x.y.z and 192.168.x.y addresses? ### What is the difference between 10.x.y.z and 192.168.x.y addresses?
The addresses 10.x.y.z and 192.168.x.y are on the private network. The addresses 10.x.y.z and 192.168.x.y are on the private network.
@ -1257,14 +1200,6 @@ No, nodes only get deleted if the farm owner chooses to do so. Old "nodes" are r
No, this is not possible. In the future, we will implement some features in order to allow the cleaning of unused farms. As of now, this is not possible. Also, an old farm does not take resources on the TF Grid, or very little. No, this is not possible. In the future, we will implement some features in order to allow the cleaning of unused farms. As of now, this is not possible. Also, an old farm does not take resources on the TF Grid, or very little.
### On the ThreeFold Connect App, it says I need to migrate my Titan farm from V2 to V3. What do I have to do? How long does this take?
To migrate, read [this documentation](https://forum.threefold.io/t/what-to-do-if-your-farm-is-still-on-grid-v2-closed/3761).
### How can I migrate my DIY farm from V2 to V3? ### How can I migrate my DIY farm from V2 to V3?
Create a new [bootstrap image](https://bootstrap.grid.tf/) using your new V3 Farm ID. To create a new V3 Farm ID, you can use the ThreeFold Connect App or the ThreeFold Dashboard. Create a new [bootstrap image](https://bootstrap.grid.tf/) using your new V3 Farm ID. To create a new V3 Farm ID, you can use the ThreeFold Connect App or the ThreeFold Dashboard.

View File

@ -6,7 +6,8 @@ For complementary information on ThreeFold, refer to the [ThreeFold Knowledge Ba
<h2>Table of Contents</h2> <h2>Table of Contents</h2>
- [Dashboard](dashboard@@dashboard) - [ThreeFold Dashboard](dashboard@@dashboard)
- [ThreeFold Connect](tfconnect@@tfconnect_toc)
- [Developers](developers@@developers) - [Developers](developers@@developers)
- [Farmers](farmers@@farmers) - [Farmers](farmers@@farmers)
- [System Administrators](system_administrators@@system_administrators) - [System Administrators](system_administrators@@system_administrators)

View File

@ -9,7 +9,7 @@ This manual is organized in two main sections:
The *ThreeFold Knowledge Base* section contains all information needed to understand how the whole ThreeFold ecosystem works. The *ThreeFold Knowledge Base* section contains all information needed to understand how the whole ThreeFold ecosystem works.
The *ThreeFold Documentation* section contains all the practical information of the ThreeFold Grid, from general information covering the multi-functional [Dashboard](dashboard@@dashboard), [TFT](threefold_token@@threefold_token) and our community-based [FAQ](faq@@faq), to specific tutorials for [developers](developers@@developers), [farmers](farmers@@farmers) and [system administrators](system_administrators@@system_administrators). The *ThreeFold Documentation* section contains all the practical information of the ThreeFold Grid, from general information covering the multi-functional [ThreeFold Dashboard](dashboard@@dashboard), the versatile [ThreeFold Connect app](tfconnect@@tfconnect_toc), [TFT](threefold_token@@threefold_token) and our community-based [FAQ](faq@@faq), to specific tutorials for [developers](developers@@developers), [farmers](farmers@@farmers) and [system administrators](system_administrators@@system_administrators).
> Explore the TFGrid status page for live updates on Threefold services! > Explore the TFGrid status page for live updates on Threefold services!
> >

View File

Binary file not shown.

After

Width:  |  Height:  |  Size: 79 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 88 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 104 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 68 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 43 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 37 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 67 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 74 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 54 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 37 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 125 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 104 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 72 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 41 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 130 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 54 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 62 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 94 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 88 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 79 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 92 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 53 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 37 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 90 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 64 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 109 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 147 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 65 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 144 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 115 KiB

View File

@ -0,0 +1,267 @@
<h1> ThreeFold Connect Advanced </h1>
<h2> Table of Contents </h2>
- [Introduction](#introduction)
- [ThreeFold Connect Installation](#threefold-connect-installation)
- [Verify your identity by Email](#verify-your-identity-by-email)
- [Change email associated with TF account](#change-email-associated-with-tf-account)
- [Create a Wallet](#create-a-wallet)
- [See ThreeFold Connect App and Wallet Transactions](#see-threefold-connect-app-and-wallet-transactions)
- [Show Seed Phrase - Remove Account from TF Connect App](#show-seed-phrase---remove-account-from-tf-connect-app)
- [Recover Account on the ThreeFold Connect App](#recover-account-on-the-threefold-connect-app)
- [Import Farm from the TF Connect App to the TF Dashboard](#import-farm-from-the-tf-connect-app-to-the-tf-dashboard)
- [Import TF Dashboard Wallet to the TF Connect App Wallet](#import-tf-dashboard-wallet-to-the-tf-connect-app-wallet)
- [Send and Receive TFT between TF Connect Wallets](#send-and-receive-tft-between-tf-connect-wallets)
- [Send TFT](#send-tft)
- [Receive TFT](#receive-tft)
- [Send TFT to Hardware Wallet on Stellar Blockchain](#send-tft-to-hardware-wallet-on-stellar-blockchain)
- [Disclaimer](#disclaimer)
***
## Introduction
In this section, we cover the basics and advanced features of the ThreeFold Connect app.
This app is available for [Android](https://play.google.com/store/apps/details?id=org.jimber.threebotlogin&hl=en&gl=US) and [iOS](https://apps.apple.com/us/app/threefold-connect/id1459845885).
- Note that for Android phones, you need at minimum Android Nougat, the 8.0 software version.
- Note that for iOS phones, you need at minimum iOS 14.5. It will be soon available to iOS 13.
![farming_wallet_5](./img/farming_wallet_5.png)
## ThreeFold Connect Installation
Either use the links above, or search for the ThreeFold Connect app on the Apple Store or the Google Play store. Then install and open the app. If you want to leave a 5 star review of the app, no one here will stop you!
![farming_tf_wallet_1](./img/farming_tf_wallet_1.png)
![farming_tf_wallet_2](./img/farming_tf_wallet_2.png)
When you try to open the app, if you get an error message such as : "Error in initialization in Flagsmith...", you might need to upgrade your phone to a newer software version (8.0 for Android and 13 for iOS).
Once you are in the application, you will see some introduction pages to help you familiarize yourself with the TF Connect app. You will also be asked to read and accept ThreeFold's Terms and conditions.
![farming_tf_wallet_3](./img/farming_tf_wallet_3.png)
![farming_tf_wallet_4](./img/farming_tf_wallet_4.png)
You will then be asked to either *SIGN UP* or *RECOVER ACCOUNT*. For now, we will show how to sign up. Later in the guide, we will show you how to recover an account.
![farming_tf_wallet_5](./img/farming_tf_wallet_5.png)
You will then be asked to choose a *Threefold Connect Id*. This ID will be used, as well as the seed phrase, when you want to recover an account. Choose wisely. And do not forget it! Here we will use TFExample, as an example.
![farming_tf_wallet_6](./img/farming_tf_wallet_6.png)
Next, you need to add a valid email address. This will be used as a broad KYC. You will need to access your email and confirm the validation email from ThreeFold to use properly the TF Connect app wallet.
![farming_tf_wallet_7](./img/farming_tf_wallet_7.png)
Then, the next step is crucial! Make sure no one is around looking at your screen. You will be shown your seed phrase. Keep this in a secure and offline place. You will need the 3bot ID and the seed phrase to recover your account. This seed phrase is of utmost importance. Do not lose it nor give it to anyone.
![farming_tf_wallet_8](./img/farming_tf_wallet_8.png)
Once you've hit Next, you will be asked to write down 3 random words of your seed phrase. This is a necessary step to ensure you have taken the time to write down your seed phrase.
![farming_tf_wallet_9](./img/farming_tf_wallet_9.png)
Then, you'll be asked to confirm your TF 3bot name and the associated email.
![farming_tf_wallet_10](./img/farming_tf_wallet_10.png)
Finally, you will be asked to choose a 4-digit PIN. This will be needed to use the ThreeFold Connect app. If you ever forget this 4-digit PIN, you will need to recover your account from your 3bot name and your seed phrase. You will need to confirm the new pin in the next step.
![farming_tf_wallet_11](./img/farming_tf_wallet_11.png)
That's it! You've created your ThreeFold Connect account. You can press the hamburger menu on the top left to explore the ThreeFold Connect app.
![farming_tf_wallet_12](./img/farming_tf_wallet_12.png)
In the next step, we will create a ThreeFold Connect Wallet. You'll see, it's very simple!
### Verify your identity by Email
Once you've created your account, an email will be sent to the email address you've chosen in the account creation process.
To verify your email, go to your email account and open the email sent by *info@openkyc.live* with the subject *Verify your email address*.
In this email, click on the link *Verify my email address*. This will lead you to a *login.threefold.me* link. The process should be automatic. Once this is done, you will receive a confirmation on screen, as well as on your phone.
![farming_tf_wallet_39](./img/farming_tf_wallet_39.png)
![farming_tf_wallet_40](./img/farming_tf_wallet_40.png)
![farming_tf_wallet_41](./img/farming_tf_wallet_41.png)
If for some reason, you did not receive the verification email, simply click on *Verify* and another email will be sent.
![farming_tf_wallet_42](./img/farming_tf_wallet_42.png)
![farming_tf_wallet_43](./img/farming_tf_wallet_43.png)
### Change email associated with TF account
If you want to change your email, simply click on the *pencil* next to your email and write another email. You will need to redo the KYC verification process.
![farming_tf_wallet_44](./img/farming_tf_wallet_44.png)
## Create a Wallet
To create a wallet, click on the ThreeFold Connect app menu. This is what you see. Choose *Wallet*.
![farming_tf_wallet_13](./img/farming_tf_wallet_13.png)
Once you are in the section *Wallet*, click on *Create Initial Wallet*. If it doesn't work the first time, retry some more. If you have trouble creating a wallet, make sure your connection is reliable. You can try a couple of minutes later if it still doesn't work. With a reliable connection, there shouldn't be any problem. Contact TF Support if problems persist.
![farming_tf_wallet_14](./img/farming_tf_wallet_14.png)
This is what you see when the TF Grid is initializing your wallet.
![farming_tf_wallet_15](./img/farming_tf_wallet_15.png)
Once your wallet is initialized, you will see *No blanace found for this wallet*. You can click on this button to enter the wallet.
![farming_tf_wallet_16](./img/farming_tf_wallet_16.png)
Once inside your wallet, this is what you see.
![farming_tf_wallet_17](./img/farming_tf_wallet_17.png)
We will now see where the Stellar and the TF Chain Addresses and Secrets are to be found. We will also change the wallet name. To do so, click on the *circled i* at the bottom right of the screen.
![farming_tf_wallet_18](./img/farming_tf_wallet_18.png)
![farming_tf_wallet_19](./img/farming_tf_wallet_19.png)
You can choose the name you want for your wallet. Here we use TFWalletExample. Note that you can also use alphanumeric characters.
![farming_tf_wallet_20](./img/farming_tf_wallet_20.png)
At the top of the section *Wallet*, we can see that the name has changed.
![farming_tf_wallet_21](./img/farming_tf_wallet_21.png)
Now, if you want to copy your Stellar Address, simply click on the button presented with the green circle. To access the TF Chain address, click on the button presented with the red circle. When your phone has copied the address, the TF Connect app will give show a confirmation message as shown below.
![farming_tf_wallet_22](./img/farming_tf_wallet_22.png)
In some situations, you will want to access the Stellar and TF Chain secrets. To do so, simply click on the "eye" button of the desired chain, and then copy the secret.
![farming_tf_wallet_23](./img/farming_tf_wallet_23.png)
## See ThreeFold Connect App and Wallet Transactions
To see your transactions, simply click on the two arrows at the bottom of the screen, as shown below.
![farming_tf_wallet_29](./img/farming_tf_wallet_29.png)
## Show Seed Phrase - Remove Account from TF Connect App
To see your seed phrase or remove your account from the TF Connect app, choose *Settings* in the ThreeFold Connect app menu.
![farming_tf_wallet_32](./img/farming_tf_wallet_32.png)
First, to see your seed phrase, click on this button as shown below:
![farming_tf_wallet_31](./img/farming_tf_wallet_38.png)
You will then be able to see your seed phrase. You can make sure you have your seed phrase somewhere safe, offline, before removing your account.
Now, we will remove the account from the ThreeFold Connect app. In Settings, click on the arrow circled in green and click on the red button with a white dashed in it. Beware: once done, you can only recover your account with your **3bot ID** and your **seed phrase**.
![farming_tf_wallet_33](./img/farming_tf_wallet_33.png)
You will be asked to confirm your action as a security check.
![farming_tf_wallet_34](./img/farming_tf_wallet_34.png)
## Recover Account on the ThreeFold Connect App
Once you're removed your account, if you want to recover your account, choose the option *RECOVER ACCOUNT* on the opening screen on the app.
![farming_tf_wallet_35](./img/farming_tf_wallet_35.png)
You will be asked to enter your *3bot ID* as well as your *seed phrase*.
![farming_tf_wallet_36](./img/farming_tf_wallet_36.png)
You will then be asked to choose and confirm a new 4-digit pin code. Once this is done, you will receive the following confirmation:
![farming_tf_wallet_37](./img/farming_tf_wallet_37.png)
That's it! You've recovered your account.
## Import Farm from the TF Connect App to the TF Dashboard
If you want to import your farm from the ThreeFold Connect app to the ThreeFold Dashboard, follow these steps.
Note that as of now, you cannot import your farm from the TF Dashboard to the ThreeFold Connect app, but it is possible to import your wallet.
First, you want to find the TF Chain Secret, this is, in short, a hex version of the private key. To find the secret, head over to the *Farmer migration* (via the TF Menu).
In the *Farming migration* section, click on the arrow (in green here) of the farm you want to export on the ThreeFold Dashboard.
![farming_tf_wallet_45](./img/farming_tf_wallet_45.png)
Then, click on the arrow (in green) to see your TF Chain Secret.
![farming_tf_wallet_46](./img/farming_tf_wallet_46.png)
Click on the button to copy the Secret. The app will show a confirmation message.
![farming_tf_wallet_47](./img/farming_tf_wallet_47.png)
Now head over to the ThreeFold Dashboard and enter the TF Chain Secret as the mnemonics.
In the Farm section, you can now see your farm. You can see here that the farming reward address is the same as before.
That's it! You have successfully imported the farm from the ThreeFold Connect app to the ThreeFold Dashboard.
## Import TF Dashboard Wallet to the TF Connect App Wallet
Now that we've seen how to go from the TF Connect app to the ThreeFold Dashboard, we will now show how to go the other way around. This method is very simple. You will need your TF Dashboard seed phrase handy.
Go in the Wallet section of the ThreeFold Connect app and click on import at the bottom right (in green).
![farming_tf_wallet_57](./img/farming_tf_wallet_57.png)
Then simply name your wallet and enter the TF Dashboard seed phrase.
![farming_tf_wallet_58](./img/farming_tf_wallet_58.png)
Then in the Wallet section, you will now see the wallet.
![farming_tf_wallet_59](./img/farming_tf_wallet_59.png)
## Send and Receive TFT between TF Connect Wallets
To send and receive TFT between TF Connect Wallet, go into Wallet and select the wallet you want to use.Remember that you must always send and receive TFT on the same chain, so choose either Stellar or TFChain.
### Send TFT
To send tokens, select *Send Coins* in the wallet section. To send TFT, you can scan the QR code of the address you wish to send tokens to. This will enter automatically the necessary information. Make sure to double check that the information is correct to avoid any complications. Otherwise, you can simply enter the correct address in the section *To*. Choose the amount you want to send. Then click on *SEND TOKENS*.
Note that, for such transactions, there is a maximum fee of 0.10 TFT on the Stellar blockchain, and a maximum fee of 0.01 TFT on the TFChain. This amount is taken from the amount you are sending. It is not taken directly in your wallet.
### Receive TFT
To receive tokens, select *Receive Coins* in the wallet section. To receive TFT, you can generate a QR code to share to the person waiting to send you tokens. Otherwise, the sender can simply use your Stellar or TFChain address and send you TFT.
To generate the QR Code, select the chain you want to use, Stellar or TFChain, enter the amount and the message if needed and click on *GENERATE QR CODE*. Note that there is no message option for TFChain, only for Stellar. This will generate a QR Code that can be scanned by other devices.
### Send TFT to Hardware Wallet on Stellar Blockchain
Before sending TFT to a hardware wallet, make sure the hardware wallet has a TFT trustline on the Stellar Blockchain. For more information, read [this section](threefold_token@@hardware_wallet).
## Disclaimer
> The information provided in this tutorial or any related discussion is not intended as investment advice. The purpose is to provide educational and informational content only. Investing in cryptocurrencies or any other assets carries inherent risks, and it is crucial to conduct your own research and exercise caution before making any investment decisions.
>
> **The ThreeFold Token (TFT)** is not to be considered as a traditional investment instrument. The value of cryptocurrencies can be volatile, and there are no guarantees of profits or returns. Always be aware of the risks involved and make informed choices based on your own assessment and understanding. We strongly encourage you to read our [full disclaimer](legal@@disclaimer) and seek advice from a qualified financial professional if needed.

View File

@ -0,0 +1,43 @@
<h1> ThreeFold Connect Authenticator</h1>
<h2>Table of Contents</h2>
- [Introduction](#introduction)
- [Connect with the Authenticator](#connect-with-the-authenticator)
---
## Introduction
We present how to use the ThreeFold Authenticator.
The ThreeFold Connect two-factor authenticator enables you access to ThreeFold Grid tools and solutions. Not a single person in the world will be able to log in to your account, not even us.
## Connect with the Authenticator
To connect with the authenticator:
- Make sure your ThreeFold Connect app is open before sending the login request.
- Write your ThreeFold ID
![](./img/tfconnect_authenticator_1.png)
- Click `SIGN IN`
![](./img/tfconnect_authenticator_2.png)
- Take note of the icon shown on your screen
![](./img/tfconnect_authenticator_3.png)
- On your phone, open TFConnect and enter your password
![](./img/tfconnect_enter_password.png)
- Click on the icon you saw on the browser screen
- You will see a confirmation screen
![](./img/tfconnect_logging_in.png)
You should now be logged in.

View File

@ -0,0 +1,35 @@
<h1> ThreeFold Connect Overview </h1>
<h2>Table of Contents</h2>
- [Introduction](#introduction)
- [Benefits](#benefits)
- [Installation](#installation)
---
## Introduction
We present some of the ThreeFold Connect app benefits and provide links to install the app on your phone.
## Benefits
Some key features and benefits of the ThreeFold Connect app are:
- 2FA Authenticator:
- ThreeFold Connect is a passwordless 2FA authenticator that ensures a user is who they claim to be.
- Decentralized:
- The app is decentralized, allowing users to access the ThreeFold Network platforms and their fully private digital wallet.
- Private Digital Wallet:
- Users can manage their ThreeFold Tokens (TFT) and view their transaction history on the TF chain.
- Support Chat:
- The app provides a support chat where users can get answers to their questions about ThreeFold-related topics.
- News Section:
- The app features a news section where users can find the latest ThreeFold news and updates.
## Installation
The ThreeFold Connect app is available for both iOS and Android devices.
- [Google Store Link](https://play.google.com/store/apps/details?id=org.jimber.threebotlogin)
- [Apple Store](https://itunes.apple.com/be/app/3bot-login/id1459845885?l=nl&mt=8)

View File

@ -0,0 +1,10 @@
# ThreeFold Connect App
ThreeFold Connect is a mobile app that serves as a gateway to the ThreeFold ecosystem and its various ThreeFold products and services.
<h2> Table of Contents </h2>
- [TFConnect Overview](./tfconnect_overview.md)
- [TFConnect Authenticator](./tfconnect_authenticator.md)
- [TFConnect Advanced](./tfconnect_advanced.md)
- [TFConnect Troubleshooting](./tfconnect_troubleshooting.md)

View File

@ -0,0 +1,60 @@
<h1> ThreeFold Connect Troubleshooting </h1>
<h2>Table of Contents</h2>
- [Introduction](#introduction)
- [Basic Troubleshooting](#basic-troubleshooting)
- [I am trying to access my wallet in the ThreeFold Connect App. It worked fine before, but now I just get a white screen. What does it mean and what can I do?](#i-am-trying-to-access-my-wallet-in-the-threefold-connect-app-it-worked-fine-before-but-now-i-just-get-a-white-screen-what-does-it-mean-and-what-can-i-do)
- [When I open the ThreeFold Connect App, I get the error: Error in initialization in Flagsmith. How can I fix this issue?](#when-i-open-the-threefold-connect-app-i-get-the-error-error-in-initialization-in-flagsmith-how-can-i-fix-this-issue)
- [I do not remember the name (ThreeFold 3bot ID) associated with my seed phrase on the ThreeFold Connect app. Can I recover my TF Connect app account with only the seed phrase and not the name (3bot ID) associated with it?](#i-do-not-remember-the-name-threefold-3bot-id-associated-with-my-seed-phrase-on-the-threefold-connect-app-can-i-recover-my-tf-connect-app-account-with-only-the-seed-phrase-and-not-the-name-3bot-id-associated-with-it)
- [TF Connect App is now asking for a 4-digit password (PIN). I don't remember it as I usually use touch or face ID to unlock the app. What can I do?](#tf-connect-app-is-now-asking-for-a-4-digit-password-pin-i-dont-remember-it-as-i-usually-use-touch-or-face-id-to-unlock-the-app-what-can-i-do)
- [Is there a way to have more than one wallet in TF Connect App?](#is-there-a-way-to-have-more-than-one-wallet-in-tf-connect-app)
- [On the ThreeFold Connect App, it says I need to migrate my Titan farm from V2 to V3. What do I have to do? How long does this take?](#on-the-threefold-connect-app-it-says-i-need-to-migrate-my-titan-farm-from-v2-to-v3-what-do-i-have-to-do-how-long-does-this-take)
---
## Introduction
We provide solutions to different issues users can encounter while using the ThreeFold Connect app.
## Basic Troubleshooting
### I am trying to access my wallet in the ThreeFold Connect App. It worked fine before, but now I just get a white screen. What does it mean and what can I do?
On the TF Connect App, when you get a white screen, it means that there is a connection issue. It can help to try other networks; maybe try switching between ethernet cable or wifi. Or you can also try it later when the connection might be more stable.
### When I open the ThreeFold Connect App, I get the error: Error in initialization in Flagsmith. How can I fix this issue?
To fix this Flagsmith error message on the ThreeFold Connect app, you can try the following methods:
* Check your internet connection
* Update your phone current operating system (OS) version
* Update the date and time on your phone
### I do not remember the name (ThreeFold 3bot ID) associated with my seed phrase on the ThreeFold Connect app. Can I recover my TF Connect app account with only the seed phrase and not the name (3bot ID) associated with it?
If you forgot the name associated with your seed phrase on the TF Connect app, you can always create a new identity (ThreeFold 3bot ID) and import your wallet using the old seed phrase.
Since the Connect App is also used for identity and authentication, you need both the name (3bot ID) and seed phrase to fully recover your account. The wallet is only linked to the seed phrase and not the name (3bot ID).
### TF Connect App is now asking for a 4-digit password (PIN). I don't remember it as I usually use touch or face ID to unlock the app. What can I do?
When you set up your the app, you are asked a 4-digit password (PIN). After some time, the app will be asking for this PIN when users may have been exclusively using touch/face ID. You can reset it by recovering the account with your seedphrase.
### Is there a way to have more than one wallet in TF Connect App?
Yes, this is perfectly possible. You can have multiple wallets in the TF Connect app. You can have multiple wallets for the Stellar network and multiple wallets for Polkadot Substrate.
For example, you can create a wallet on the Stellar Blockchain and import it on TF Connect App with the function *Import Wallet*. Just copy the seedphrase and it will be imported in TF Connect App.
Note: There will not be an automatic function in the app to create a new wallet. You must do it manually.
### On the ThreeFold Connect App, it says I need to migrate my Titan farm from V2 to V3. What do I have to do? How long does this take?
To migrate, read [this documentation](https://forum.threefold.io/t/what-to-do-if-your-farm-is-still-on-grid-v2-closed/3761).

View File

@ -8,6 +8,8 @@
!!doctree.add !!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/dashboard' url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/dashboard'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/tfconnect'
!!doctree.add !!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/developers' url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/developers'
!!doctree.add !!doctree.add