diff --git a/collections/manual/documentation/.collection b/collections/manual/documentation/.collection new file mode 100644 index 0000000..e69de29 diff --git a/collections/manual/documentation/dashboard/dashboard.md b/collections/manual/documentation/dashboard/dashboard.md new file mode 100644 index 0000000..991b189 --- /dev/null +++ b/collections/manual/documentation/dashboard/dashboard.md @@ -0,0 +1,43 @@ +

ThreeFold Dashboard

+ +Explore, control, and manage your ThreeFold Grid resources effortlessly through our integrated Dashboard. Deploy solutions seamlessly while gaining full control, all within a unified interface. + +The ThreeFold Dashboard is a revolutionary platform that simplifies the deployment process, allowing users to effortlessly interact with the TFGrid using intuitive web components known as weblets. + +## What is the ThreeFold Dashboard? + +The ThreeFold Dashboard is a dynamic environment designed for both seasoned developers and newcomers alike. It offers a seamless and accessible browser experience, making it easy to deploy solutions on the TFGrid through the use of weblets. + +In the context of the Dashboard, a weblet is a compiled JavaScript web component that can be effortlessly embedded within the HTML page of a web application. This modular approach allows for flexible and intuitive interactions, facilitating a user-friendly deployment process. + +The backend for the weblets is introduced with the [Javascript Client](../developers/javascript/grid3_javascript_readme.md) which communicates to TFChain over RMB. + +

Table of Contents

+ +- [Wallet Connector](./wallet_connector.md) +- [TFGrid](./tfgrid/tfgrid.md) +- [Deploy](./deploy/deploy.md) +- [Farms](./farms/farms.md) +- [TFChain](./tfchain/tfchain.md) + +## Advantages + +- It is a non-code easy way to deploy a whole solution on the TFGrid. +- It is 100% decentralized, there is no server involved. +- It is powerful tool designed to empower individuals and organizations with seamless control and management over their ThreeFold Grid resources. +- It provides an intuitive web-based interface that allows users to effortlessly deploy, monitor, and scale their workloads on the decentralized and sustainable ThreeFold Grid infrastructure. + +## Dashboard + +You can access the ThreeFold Dashboard on different TF Chain networks. + +- [https://dashboard.dev.grid.tf](https://dashboard.dev.grid.tf) for Dev net +- [https://dashboard.qa.grid.tf](https://dashboard.qa.grid.tf) for QA net +- [https://dashboard.test.grid.tf](https://dashboard.test.grid.tf) for Test net +- [https://dashboard.grid.tf](https://dashboard.grid.tf) for Main net + +## Limitations + +- Regarding browser support, we're only supporting Google Chrome browser (and thus Brave browser) at the moment with more browsers to be supported soon. +- Deploys one thing at a time. +- Might take sometime to deploy a solution like Peertube, so you should wait a little bit until it's fully running. diff --git a/collections/manual/documentation/dashboard/deploy/applications.md b/collections/manual/documentation/dashboard/deploy/applications.md new file mode 100644 index 0000000..ca16e19 --- /dev/null +++ b/collections/manual/documentation/dashboard/deploy/applications.md @@ -0,0 +1,24 @@ +

Ready Community Applications

+ +Easily deploy your favourite applications on the ThreeFold grid with a click of a button. + +![](../img/applications_landing.png) + +*** + +

Table of Contents

+ +- [Algorand](../solutions/algorand.md) +- [CasperLabs](../solutions/casper.md) +- [Discourse](../solutions/discourse.md) +- [Funkwhale](../solutions/funkwhale.md) +- [Mattermost](../solutions/mattermost.md) +- [Nextcloud](../solutions/nextcloud.md) +- [Node Pilot](../solutions/nodepilot.md) +- [ownCloud](../solutions/owncloud.md) +- [Peertube](../solutions/peertube.md) +- [Presearch](../solutions/presearch.md) +- [Subsquid](../solutions/subsquid.md) +- [Taiga](../solutions/taiga.md) +- [Umbrel](../solutions/umbrel.md) +- [WordPress](../solutions/wordpress.md) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/deploy/dedicated_machines.md b/collections/manual/documentation/dashboard/deploy/dedicated_machines.md new file mode 100644 index 0000000..24f4dbb --- /dev/null +++ b/collections/manual/documentation/dashboard/deploy/dedicated_machines.md @@ -0,0 +1,93 @@ +

Dedicated Machines

+ +

Table of Contents

+ +- [What is a Dedicated Machine?](#what-is-a-dedicated-machine) +- [Description](#description) +- [Billing \& Pricing](#billing--pricing) +- [Discounts](#discounts) +- [Usage](#usage) +- [GPU Support](#gpu-support) +- [Filter and Reserve a GPU Node](#filter-and-reserve-a-gpu-node) + - [Filter Nodes](#filter-nodes) + - [Reserve a Node](#reserve-a-node) +- [GPU Support Links](#gpu-support-links) + +*** + +## What is a Dedicated Machine? + +Dedicated machines are 3Nodes that can be reserved and rented entirely by one user. The user can thus reserve an entire node and use it exclusively to deploy solutions. This feature is ideal for users who want to host heavy deployments with the benefits of high reliability and cost effectiveness. + +## Description + +- Node reserved with deploying a `RentContract` on this node. node can has only one rentContract. +- When a user create a RentContract against a node, the grid validate that there are no other active contracts on that node on the creation. +- Once a RentContract is created, the grid can only accept contracts on this node from the tenant. +- Only workloads from the tenant are accepted + +## Billing & Pricing + +- Once a node is rented, there is a fixed charge billed to the tenant regardless of deployed workloads. +- Any subsequent NodeContract deployed on a node where a rentContract is active (and the same user is creating the nodeContracts) can be excluded from billing (apart from public ip and network usage). +- Billing rates are calculated hourly on the TFGrid. + - While some of the documentation mentions a monthly price, the chain expresses pricing per hour. The monthly price shown within the manual is offered as a convenience to users, as it provides a simple way to estimate costs. + +## Discounts + +- Received Discounts for renting a node on TFGrid internet capacity + - 50% for dedicated node (TF Pricing policies) + - A second level discount up to 60% for balance level see [Discount Levels](../../../knowledge_base/cloud/pricing/staking_discount_levels.md) +- Discounts are calculated every time the grid bills by checking the available TFT balance on the user wallet and seeing if it is sufficient to receive a discount. As a result, if the user balance drops below the treshold of a given discount, the deployment price increases. + +## Usage + +- See list of all dedicated node on `Dedicated Machines` tab on the portal. + + ![ ](../img/dedicated_machines.png) + + - Hover over the price to see the applied discounts + + ![](../img/dashboard_dedicated_nodes_discounts.png) + + - Expand row to see more info on the node: + + ![ ](../img/dashboard_dedicated_nodes_details.png) + - Resources + - Location + - Possible Public Ips *this depends on the farm it belongs to* + + - You can see the nodes in 2 states: + - Free + - Reserved *Owned by current twin* +- Reserve a node: + - If node is not rented by another twin you can simply click reserve. + + +- Unreserve a node: + - Simply as reserving but another check will be done to check you don't have any active workloads on the node before unreserving. + +## GPU Support + +To use a GPU on the TFGrid, users need to rent a dedicated node. Once they have rented a dedicated node equipped with a GPU, users can deploy workloads on their dedicated GPU node. + +## Filter and Reserve a GPU Node + +You can filter and reserve a GPU node using the [Dedicated Machines section](https://dashboard.grid.tf/#/deploy/dedicated-nodes/) of the **Dashboard**. + +### Filter Nodes + +- Filter nodes using the vendor name + - In **Filters**, select **GPU's vendor name** + - Write the name of the vendor desired (e.g. **nvidia**, **amd**) +- Filter nodes using the device name + - In **Filters**, select **GPU's device name** + - Write the name of the device desired (e.g. **GT218**) + +### Reserve a Node + +When you have decided which node to reserve, click on **Reserve** under the column named **Actions**. Once you've rented a dedicated node that has a GPU, you can deploy GPU workloads. + +## GPU Support Links + +The ThreeFold Manual covers many ways to use a GPU node on the TFGrid. Read [this section](../../system_administrators/gpu/gpu_toc.md) to learn more. \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/deploy/deploy.md b/collections/manual/documentation/dashboard/deploy/deploy.md new file mode 100644 index 0000000..a96decc --- /dev/null +++ b/collections/manual/documentation/dashboard/deploy/deploy.md @@ -0,0 +1,27 @@ +# Deploy + +Here you will find everything related to deployments on the ThreeFold grid. This includes: + +- Checking the cost of a deployment using [Pricing Calculator](./pricing_calculator.md) +- Finding a node to deploy on using the [Node Finder](./node_finder.md) +- Deploying your desired workload from [Virtual Machines](../solutions/vm_intro.md), [Orchestrators](./orchestrators.md), or [Applictions](./applications.md) +- Renting your own node on the ThreeFold grid from [Dedicated Machines](./dedicated_machines.md) +- Consulting [Your Contracts](./your_contracts.md) on the TFGrid +- Finding or publishing Flists from [Images](./images.md) +- Updating or generating your SSH key from [SSH Keys](./ssh_keys.md) + + ![](../img/sidebar_2.png) + +*** + +## Table of Content + +- [Pricing Calculator](./pricing_calculator.md) +- [Node Finder](./node_finder.md) +- [Virtual Machines](../solutions/vm_intro.md) +- [Orchestrators](./orchestrators.md) +- [Dedicated Machines](./dedicated_machines.md) +- [Applications](./applications.md) +- [Your Contracts](./your_contracts.md) +- [Images](./images.md) +- [SSH Keys](./ssh_keys.md) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/deploy/images.md b/collections/manual/documentation/dashboard/deploy/images.md new file mode 100644 index 0000000..2c27966 --- /dev/null +++ b/collections/manual/documentation/dashboard/deploy/images.md @@ -0,0 +1,5 @@ +# Images + +Find or Publish your Flist from [Zero-OS Hub](https://hub.grid.tf/) + +![](../img/0_hub.png) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/deploy/node_finder.md b/collections/manual/documentation/dashboard/deploy/node_finder.md new file mode 100644 index 0000000..dd93347 --- /dev/null +++ b/collections/manual/documentation/dashboard/deploy/node_finder.md @@ -0,0 +1,40 @@ +

Node Finder

+ +

Table of Contents

+ +- [Nodes](#nodes) +- [GPU Support](#gpu-support) + +*** + +## Nodes + +The Node Finder page provides a more detailed view for the nodes available on the ThreeFold grid With detailed information and statistics about any of the available nodes. + +![](../img/nodes.png) + +You can get a node with the desired specifications using the filters available in the nodes page. + +![](../img/nodes_filters.png) + +You can see all of the node details by clicking on a node record. + +![](../img/nodes_details.png) + +## GPU Support + +![GPU support](../img/gpu_filter.png) + +- A new filter for GPU supported node is now available on the Nodes page. +- GPU count +- Filtering capabilities based on the model / device + +On the details pages is shown the card information and its status (`reserved` or `available`) also the ID that’s needed to be used during deployments is easily accessible and has a copy to clipboard button. + +![GPU details](../img/gpu_details.png) + +Here’s an example of how it looks in case of reserved + +![GPU details](../img/gpu_details_reserved.png) + +The TF Dashboard is where to reserve the nodes the farmer should be able to set the extra fees on the form and the user also should be able to reserve and get the details of the node (cost including the extrafees, GPU informations). diff --git a/collections/manual/documentation/dashboard/deploy/node_finder_gpu_support.md b/collections/manual/documentation/dashboard/deploy/node_finder_gpu_support.md new file mode 100644 index 0000000..7002630 --- /dev/null +++ b/collections/manual/documentation/dashboard/deploy/node_finder_gpu_support.md @@ -0,0 +1,19 @@ +

GPU Support

+ +*** + +![GPU support](../img/gpu_filter.png) + +- A new filter for GPU supported node is now available on the Nodes page. +- GPU count +- Filtering capabilities based on the model / device + +On the details pages is shown the card information and its status (`reserved` or `available`) also the ID that’s needed to be used during deployments is easily accessible and has a copy to clipboard button. + +![GPU details](../img/gpu_details.png) + +Here’s an example of how it looks in case of reserved + +![GPU details](../img/gpu_details_reserved.png) + +The TF Dashboard is where to reserve the nodes the farmer should be able to set the extra fees on the form and the user also should be able to reserve and get the details of the node (cost including the extrafees, GPU informations). diff --git a/collections/manual/documentation/dashboard/deploy/orchestrators.md b/collections/manual/documentation/dashboard/deploy/orchestrators.md new file mode 100644 index 0000000..47282a6 --- /dev/null +++ b/collections/manual/documentation/dashboard/deploy/orchestrators.md @@ -0,0 +1,14 @@ +# Orchestrators + +Deploy your favorite orchestrating services and enjoy the seamless coordination and automation of various software applications and services. + +![](../img/orchestrator_landing.png) + +*** + +## Table of Contnet + +- [Kubernetes](../solutions/k8s.md) +- [Caprover](../solutions/caprover.md) + - [Caprover Admin](../solutions/caprover_admin.md) + - [Caprover Worker](../solutions/caprover_worker.md) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/deploy/pricing_calculator.md b/collections/manual/documentation/dashboard/deploy/pricing_calculator.md new file mode 100644 index 0000000..a050215 --- /dev/null +++ b/collections/manual/documentation/dashboard/deploy/pricing_calculator.md @@ -0,0 +1,6 @@ +# TF Resource Calculator + +A tool provided by ThreeFold that allows users to estimate and calculate potential cost of a deployment on the ThreeFold grid. The resource calculator takes into account various factors, including deployment resources, node certification, currnet balance, and in return it displays an accurate estimate for the deployment in terms of ThreeFold Tokens (TFT) and in USD per month. + + +![](../img/pricing_calculator.png) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/deploy/ssh_keys.md b/collections/manual/documentation/dashboard/deploy/ssh_keys.md new file mode 100644 index 0000000..4e2cecb --- /dev/null +++ b/collections/manual/documentation/dashboard/deploy/ssh_keys.md @@ -0,0 +1,5 @@ +# SSH Keys + +Add, update or generate your SSH key with a click of a button. + +![](../img/SSH_Key.png) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/deploy/vm.md b/collections/manual/documentation/dashboard/deploy/vm.md new file mode 100644 index 0000000..5a22576 --- /dev/null +++ b/collections/manual/documentation/dashboard/deploy/vm.md @@ -0,0 +1,13 @@ +

Virtual Machines

+ +On the TFGrid, you can deploy both micro and full virtual machines. + +![](../img/vm_landing.png) + +*** + +

Table of Contents

+ +- [Micro and Full VM Differences ](../solutions/vm_differences.md) +- [Full Virtual Machine](../solutions/fullVm.md) +- [Micro Virtual Machine](../solutions/vm.md) diff --git a/collections/manual/documentation/dashboard/deploy/your_contracts.md b/collections/manual/documentation/dashboard/deploy/your_contracts.md new file mode 100644 index 0000000..c7cb4a6 --- /dev/null +++ b/collections/manual/documentation/dashboard/deploy/your_contracts.md @@ -0,0 +1,49 @@ +# Contracts + +From the Contracts section you can check your contracts by navigating to the `Deploy` then `Your Contracts` tab from the sidebar. + +From there you will see the `Contracts List`, the list is split into three different sections. these sections are: + +### Node contracts + +![image](../img/node_contracts.png) + +### Name contracts + +![image](../img/name_contracts.png) + +### Rent contracts + +![image](../img/rent_contracts.png) + + + +This list includes the following information about each contract. + +- Contract ID. +- Contract Type. +- Contract State (Created, Deleted, GracePeriod). +- Solution Typw +- Billing Rate (in TFT/Hour). +- Solution Name. +- Created At. +- Expiration (Only appears if the contract is in GracePeriod). +- Node ID +- Node Status (Up, Down, Standby). +- Show Details (This button will display the detailed information of the desired contract). + + ![image](../img/contract_details.png) + + +## Cancel Contract + +You can also cancel the target contract/s by select the contract you want to cancel + +- Click on the checkbox on the left side of the contract row +- Click on the delete button in the bottom right of the table +- Review the contract/s ID then click on *Delete* button + +Note: + +>- You can Cancel all you contracts by clicking on the checkbox on the left side of the table header then click on *Delete* button. +>- It is advisable to remove the contract from its solution page, especially when multiple contracts may be linked to the same instance. diff --git a/collections/manual/documentation/dashboard/farms/farms.md b/collections/manual/documentation/dashboard/farms/farms.md new file mode 100644 index 0000000..7faedd3 --- /dev/null +++ b/collections/manual/documentation/dashboard/farms/farms.md @@ -0,0 +1,19 @@ +# Farms + +Here you will find everything farming related. this includes: + +- Monitoring, creating, and updating your farms from the [Your Farms](./your_farms.md) section where you can also check your nodes and update multiple things like the public configuration and extra fees of the node. +- Exploring and finding farms that are available on the ThreeFold grid from the [Farm Finder](./farms_finder.md) section. +- Generating your own boot device for your system from the [Node Installer](./node_installer.md) section. +- Estimating and calculating potential earnings from farming on the ThreeFold Grid from the [Simulator](./simulator.md) section. + + ![](../img/sidebar_3.png) + +*** + +## Table of Content + +- [Your Farms](./your_farms.md) +- [Farm Finder](./farms_finder.md) +- [Node Installer](./node_installer.md) +- [Simulator](./simulator.md) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/farms/farms_finder.md b/collections/manual/documentation/dashboard/farms/farms_finder.md new file mode 100644 index 0000000..252aa73 --- /dev/null +++ b/collections/manual/documentation/dashboard/farms/farms_finder.md @@ -0,0 +1,13 @@ +# Farms + +The farms page provides a more detailed view for the farms available on the ThreeFold grid With detailed information about any of the available farms. + +![](../img/farms.png) + +You can search for a specific farm using the farms filters. + +![](../img/farms_filters.png) + +You can see all of the farm details by clicking on a farm record. + +![](../img/farms_details.png) diff --git a/collections/manual/documentation/dashboard/farms/node_installer.md b/collections/manual/documentation/dashboard/farms/node_installer.md new file mode 100644 index 0000000..903e10e --- /dev/null +++ b/collections/manual/documentation/dashboard/farms/node_installer.md @@ -0,0 +1,5 @@ +# Node Installer + +Generate your own boot device for your system and download Zero-OS Images from [Zero-OS Bootstrap](https://bootstrap.grid.tf/) + +![](../img/0_Bootstrap.png) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/farms/simulator.md b/collections/manual/documentation/dashboard/farms/simulator.md new file mode 100644 index 0000000..3d5b594 --- /dev/null +++ b/collections/manual/documentation/dashboard/farms/simulator.md @@ -0,0 +1,5 @@ +# Simulator + +A tool provided by ThreeFold that allows users to estimate and calculate potential earnings from farming on the ThreeFold Grid. Farming refers to the process of providing computing resources, such as storage and processing power, to the ThreeFold Grid and earning tokens in return. The tf-farming-calculator takes into account various factors, including the amount of resources contributed, the duration of farming, and the current market conditions, to provide users with an estimate of their potential earnings in terms of ThreeFold Tokens (TFT). + +![](../img/simulator.png) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/farms/your_farms.md b/collections/manual/documentation/dashboard/farms/your_farms.md new file mode 100644 index 0000000..8afc756 --- /dev/null +++ b/collections/manual/documentation/dashboard/farms/your_farms.md @@ -0,0 +1,134 @@ +# Farms + +This comprehensive guide aims to provide users with detailed instructions and insights into efficiently managing their _Farms_. Farms encompass servers and storage devices contributing computational and storage capabilities to the grid, empowering users to oversee, maintain, and optimize their resources effectively. + +- [Getting started](#getting-started) +- [Create a new Farm](#create-a-new-farm) +- [Manage Your Farms](#manage-your-farms) + - [Add a public IP to your Farm](#add-a-public-ip-to-your-farm) + - [Add a Stellar address for payout](#add-a-stellar-address-for-payout) + - [Generate your node bootstrap image](#generate-your-node-bootstrap-image) + - [Additional information](#additional-information) +- [Manage Your Nodes](#manage-your-nodes) + - [Node information](#node-information) + - [Extra Fees](#extra-fees) + - [Public Configuration](#public-configuration) + - [The Difference Between IPs Assigned to Nodes Versus a Farm](#the-difference-between-ips-assigned-to-nodes-versus-a-farm) + +## Getting started + +After logging in to the TF Dashboard, on the sidebar click on **Dashboard** then _Your Farms_ . + +## Create a new Farm + +If you want to start farming, you need a farmID, the ID of the farm that is owning the hardware node(s) you connect to the TFGrid. + +**Currently on**: + +- [Devnet](https://dashboard.dev.grid.tf/) +- [Qanet](https://dashboard.qa.grid.tf/) +- [Testnet](https://dashboard.test.grid.tf/) +- [Mainnet](https://dashboard.grid.tf/) + +Click `Create Farm` and choose a name. + +![ ](../img/dashboard_farms.png) + +![ ](../img/dashboard_farms_create.png) + +Click on `Create`. + +The farm is by default set up as 'DIY'. A farm can become certified through certification program. +Also a pricing policy is defined. Pricing policy is currently the same for all farms, the field is created for future use. + +## Manage Your Farms + +You can browse your Farms in _Farms_ table; Farms table contains all your own farms and its your entry point to manage your farm as in the following sections. + +![](../img/dashboard_farms_farms_table.png) + +### Add a public IP to your Farm + +If you have public IPv4 addresses available that can be used for usage on the TFGrid, you can add them in your farm. +Click `ADD IP`, specify the addresses, the gateway and click `CREATE`. +You can add them one by one or using range of IPs. + +**Some notes about adding a new IPs**: + +- Be careful not to create a new IP range that contains an IP address that already exists; doing so will result in an error. +- Verify that both the gateway address and the IP address are correct. +- Be careful not to include the same gateway address in a new IP range. + +![ ](../img/dashboard_farms_farm_details.png) + +![ ](../img/dashboard_farms_add_ip_single.png) + +![ ](../img/dashboard_farms_add_ip_range.png) + +Deleting IPv4 addresses is also possible here. The `Deployed Contract ID` gives an indication of whether an IP is currently used. If it is 0, it is safe to remove it. + +![ ](../img/dashboard_farms_ip_details.png) + +### Add a Stellar address for payout + +In a first phase, farming of tokens still results in payout on the Stellar network. So to get the farming reward, a Stellar address needs to be provided. + +![ ](../img/dashboard_farms_farm_details.png) + +![ ](../img/dashboard_farms_stellar_address.png) + +You can read about different ways to store TFT [here](../../threefold_token/storing_tft/storing_tft.md). Make sure to use a Stellar wallet for your farming rewards. + +### Generate your node bootstrap image + +Once you know your farmID, you can set up your node on TFGrid3. Click on `Bootstrap Node Image`. + +![dashboard_bootstrap_farm](../img/dashboard_bootstrap_farm.png) + +Read more Zero-OS bootstrap image [here](../../farmers/3node_building/2_bootstrap_image.md). + +### Additional information + +After booting a node, the info will become available in `Your Nodes` table, including the status info along with the minting and fixup receipts. + +![ ](../img/dashboard_farms_node_details.png) + +Clicking on the node statistics will open up a calendar where you can view the periods the node was minting or undergoing a fixup. Clicking on the periods will show a popup with the start and end datetimes, receipt hash and the amount of TFTs minted (if it is a minting receipt). + +![ ](../img/dashboard_portal_ui_nodes_minting.png) + +You can also download a single node's receipts using the `Download Receipts` button within the node statistics. Moreover, you can download all of the nodes' receipts using the `Download Receipts` button on the top left corner of the farm nodes table. + +## Manage Your Nodes + +as in farms table _Nodes_ table contains all your own nodes and its your entry point to manage your farm as in the following sections. + +### Node information + +Expand your node information by clicking on the expand button in the target node row. + +### Extra Fees + +You can set a price for the special hardware you’re providing e.g. GPUs while renting. + +![](../img/dashboard_farms_extra_fee.png) + +- Under the **Your Nodes** table, locate the target node and click **Set Additional Fees** under **Actions** +- Set a monthly fee (in USD) and click **Save** + +### Public Configuration + +To configure public IP addresses to a specific Node + +![](../img/dashboard_farms_public_config.png) + +- Under the **Your Nodes** table, locate the target node and click **Add a public config** under **Actions** +- Fill in the necessary information and click save. Only the IPv4 address and gateway are necessary. + +> The IPv6 address and the Domain are optional but if you provide The IPv6 you have to provide its Domain. + +#### The Difference Between IPs Assigned to Nodes Versus a Farm + +--- + +IPs assigned to a farm are available to be rented by workloads. They can be assigned to virtual machines for example. IPs assigned to nodes enable each node to become a gateway. diff --git a/collections/manual/documentation/dashboard/home.md b/collections/manual/documentation/dashboard/home.md new file mode 100644 index 0000000..d14fd9a --- /dev/null +++ b/collections/manual/documentation/dashboard/home.md @@ -0,0 +1,43 @@ +

ThreeFold Dashboard

+ +Explore, control, and manage your ThreeFold Grid resources effortlessly through our integrated Dashboard. Deploy solutions seamlessly while gaining full control, all within a unified interface. + +The ThreeFold Dashboard is a revolutionary platform that simplifies the deployment process, allowing users to effortlessly interact with the TFGrid using intuitive web components known as weblets. + +## What is the ThreeFold Dashboard? + +The ThreeFold Dashboard is a dynamic environment designed for both seasoned developers and newcomers alike. It offers a seamless and accessible browser experience, making it easy to deploy solutions on the TFGrid through the use of weblets. + +In the context of the Dashboard, a weblet is a compiled JavaScript web component that can be effortlessly embedded within the HTML page of a web application. This modular approach allows for flexible and intuitive interactions, facilitating a user-friendly deployment process. + +The backend for the weblets is introduced with the [Javascript Client](../javascript/grid3_javascript_readme.md) which communicates to TFChain over RMB. + +

Table of Contents

+ +- [Wallet Connector](./wallet_connector.md) +- [TFGrid](./tfgrid/tfgrid.md) +- [Deploy](./deploy/deploy.md) +- [Farms](./farms/farms.md) +- [TFChain](./tfchain/tfchain.md) + +## Advantages + +- It is a non-code easy way to deploy a whole solution on the TFGrid. +- It is 100% decentralized, there is no server involved. +- It is powerful tool designed to empower individuals and organizations with seamless control and management over their ThreeFold Grid resources. +- It provides an intuitive web-based interface that allows users to effortlessly deploy, monitor, and scale their workloads on the decentralized and sustainable ThreeFold Grid infrastructure. + +## Dashboard + +You can access the ThreeFold Dashboard on different TF Chain networks. + +- [https://dashboard.dev.grid.tf](https://dashboard.dev.grid.tf) for Dev net. +- [https://dashboard.qa.grid.tf](https://dashboard.qa.grid.tf) for QA net. +- [https://dashboard.test.grid.tf](https://dashboard.test.grid.tf) for Test net. +- [https://dashboard.grid.tf](https://dashboard.grid.tf) for Main net. + +## Limitations + +- Regarding browser support, we're only supporting Google Chrome browser (and thus Brave browser) at the moment with more browsers to be supported soon. +- Deploys one thing at a time. +- Might take sometime to deploy a solution like Peertube, so you should wait a little bit until it's fully running. diff --git a/collections/manual/documentation/dashboard/img/.done b/collections/manual/documentation/dashboard/img/.done new file mode 100644 index 0000000..d8eefe3 --- /dev/null +++ b/collections/manual/documentation/dashboard/img/.done @@ -0,0 +1,3 @@ +dashboard_tc.png +dashboard_portal_terms_conditions.png +profile_manager1.png diff --git a/collections/manual/documentation/dashboard/img/0_bootstrap.png b/collections/manual/documentation/dashboard/img/0_bootstrap.png new file mode 100644 index 0000000..dedec1b Binary files /dev/null and b/collections/manual/documentation/dashboard/img/0_bootstrap.png differ diff --git a/collections/manual/documentation/dashboard/img/0_hub.png b/collections/manual/documentation/dashboard/img/0_hub.png new file mode 100644 index 0000000..da7faf5 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/0_hub.png differ diff --git a/collections/manual/documentation/dashboard/img/add_domain_10.png b/collections/manual/documentation/dashboard/img/add_domain_10.png new file mode 100644 index 0000000..aabe5de Binary files /dev/null and b/collections/manual/documentation/dashboard/img/add_domain_10.png differ diff --git a/collections/manual/documentation/dashboard/img/add_domain_11.png b/collections/manual/documentation/dashboard/img/add_domain_11.png new file mode 100644 index 0000000..8540ce8 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/add_domain_11.png differ diff --git a/collections/manual/documentation/dashboard/img/add_domain_6.png b/collections/manual/documentation/dashboard/img/add_domain_6.png new file mode 100644 index 0000000..05611ef Binary files /dev/null and b/collections/manual/documentation/dashboard/img/add_domain_6.png differ diff --git a/collections/manual/documentation/dashboard/img/add_domain_8.png b/collections/manual/documentation/dashboard/img/add_domain_8.png new file mode 100644 index 0000000..3a35803 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/add_domain_8.png differ diff --git a/collections/manual/documentation/dashboard/img/add_domain_9.png b/collections/manual/documentation/dashboard/img/add_domain_9.png new file mode 100644 index 0000000..346009b Binary files /dev/null and b/collections/manual/documentation/dashboard/img/add_domain_9.png differ diff --git a/collections/manual/documentation/dashboard/img/add_new_domain_success.png b/collections/manual/documentation/dashboard/img/add_new_domain_success.png new file mode 100644 index 0000000..3b23776 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/add_new_domain_success.png differ diff --git a/collections/manual/documentation/dashboard/img/applications_landing.png b/collections/manual/documentation/dashboard/img/applications_landing.png new file mode 100644 index 0000000..e4117a5 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/applications_landing.png differ diff --git a/collections/manual/documentation/dashboard/img/bridge.png b/collections/manual/documentation/dashboard/img/bridge.png new file mode 100644 index 0000000..269dead Binary files /dev/null and b/collections/manual/documentation/dashboard/img/bridge.png differ diff --git a/collections/manual/documentation/dashboard/img/bridge_deposit.png b/collections/manual/documentation/dashboard/img/bridge_deposit.png new file mode 100644 index 0000000..97619cc Binary files /dev/null and b/collections/manual/documentation/dashboard/img/bridge_deposit.png differ diff --git a/collections/manual/documentation/dashboard/img/bridge_withdraw.png b/collections/manual/documentation/dashboard/img/bridge_withdraw.png new file mode 100644 index 0000000..461a80d Binary files /dev/null and b/collections/manual/documentation/dashboard/img/bridge_withdraw.png differ diff --git a/collections/manual/documentation/dashboard/img/contract_details.png b/collections/manual/documentation/dashboard/img/contract_details.png new file mode 100644 index 0000000..286c87a Binary files /dev/null and b/collections/manual/documentation/dashboard/img/contract_details.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_bootstrap_farm.png b/collections/manual/documentation/dashboard/img/dashboard_bootstrap_farm.png new file mode 100644 index 0000000..82f8759 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_bootstrap_farm.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_bridge.png b/collections/manual/documentation/dashboard/img/dashboard_bridge.png new file mode 100644 index 0000000..111ef91 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_bridge.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_connect.png b/collections/manual/documentation/dashboard/img/dashboard_connect.png new file mode 100644 index 0000000..289b2e8 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_connect.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_dao.png b/collections/manual/documentation/dashboard/img/dashboard_dao.png new file mode 100644 index 0000000..37fb232 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_dao.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_dedicated_nodes_details.png b/collections/manual/documentation/dashboard/img/dashboard_dedicated_nodes_details.png new file mode 100644 index 0000000..649f7c9 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_dedicated_nodes_details.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_dedicated_nodes_discounts.png b/collections/manual/documentation/dashboard/img/dashboard_dedicated_nodes_discounts.png new file mode 100644 index 0000000..fe66434 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_dedicated_nodes_discounts.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_explorer_farms.png b/collections/manual/documentation/dashboard/img/dashboard_explorer_farms.png new file mode 100644 index 0000000..58d3305 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_explorer_farms.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_explorer_nodes.png b/collections/manual/documentation/dashboard/img/dashboard_explorer_nodes.png new file mode 100644 index 0000000..963730e Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_explorer_nodes.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_explorer_statistics.png b/collections/manual/documentation/dashboard/img/dashboard_explorer_statistics.png new file mode 100644 index 0000000..0d81f19 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_explorer_statistics.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_farms.png b/collections/manual/documentation/dashboard/img/dashboard_farms.png new file mode 100644 index 0000000..bebffe2 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_farms.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_farms_add_ip_range.png b/collections/manual/documentation/dashboard/img/dashboard_farms_add_ip_range.png new file mode 100644 index 0000000..30d6dcc Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_farms_add_ip_range.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_farms_add_ip_single.png b/collections/manual/documentation/dashboard/img/dashboard_farms_add_ip_single.png new file mode 100644 index 0000000..26f80e4 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_farms_add_ip_single.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_farms_create.png b/collections/manual/documentation/dashboard/img/dashboard_farms_create.png new file mode 100644 index 0000000..684dfbb Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_farms_create.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_farms_extra_fee.png b/collections/manual/documentation/dashboard/img/dashboard_farms_extra_fee.png new file mode 100644 index 0000000..2800f03 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_farms_extra_fee.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_farms_farm_details.png b/collections/manual/documentation/dashboard/img/dashboard_farms_farm_details.png new file mode 100644 index 0000000..5de107e Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_farms_farm_details.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_farms_farms_table.png b/collections/manual/documentation/dashboard/img/dashboard_farms_farms_table.png new file mode 100644 index 0000000..dd92e0b Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_farms_farms_table.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_farms_ip_details.png b/collections/manual/documentation/dashboard/img/dashboard_farms_ip_details.png new file mode 100644 index 0000000..025d9b5 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_farms_ip_details.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_farms_node_details.png b/collections/manual/documentation/dashboard/img/dashboard_farms_node_details.png new file mode 100644 index 0000000..c95e3fc Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_farms_node_details.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_farms_public_config.png b/collections/manual/documentation/dashboard/img/dashboard_farms_public_config.png new file mode 100644 index 0000000..cf1e8f5 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_farms_public_config.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_farms_stellar_address.png b/collections/manual/documentation/dashboard/img/dashboard_farms_stellar_address.png new file mode 100644 index 0000000..0ba6efd Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_farms_stellar_address.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_generate_account.png b/collections/manual/documentation/dashboard/img/dashboard_generate_account.png new file mode 100644 index 0000000..c0433dc Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_generate_account.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_login.png b/collections/manual/documentation/dashboard/img/dashboard_login.png new file mode 100644 index 0000000..c119ac3 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_login.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_portal_account.png b/collections/manual/documentation/dashboard/img/dashboard_portal_account.png new file mode 100644 index 0000000..be66b4e Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_portal_account.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_portal_create_account_1.png b/collections/manual/documentation/dashboard/img/dashboard_portal_create_account_1.png new file mode 100644 index 0000000..4024e7d Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_portal_create_account_1.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_portal_create_account_2.png b/collections/manual/documentation/dashboard/img/dashboard_portal_create_account_2.png new file mode 100644 index 0000000..5f1b4e5 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_portal_create_account_2.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_portal_create_twin.png b/collections/manual/documentation/dashboard/img/dashboard_portal_create_twin.png new file mode 100644 index 0000000..776a27e Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_portal_create_twin.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_portal_deposit_tft.png b/collections/manual/documentation/dashboard/img/dashboard_portal_deposit_tft.png new file mode 100644 index 0000000..97782e3 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_portal_deposit_tft.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_portal_farms.png b/collections/manual/documentation/dashboard/img/dashboard_portal_farms.png new file mode 100644 index 0000000..3272e64 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_portal_farms.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_portal_fill_ipv6.png b/collections/manual/documentation/dashboard/img/dashboard_portal_fill_ipv6.png new file mode 100644 index 0000000..c2ddd0c Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_portal_fill_ipv6.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_portal_terms_conditions.png b/collections/manual/documentation/dashboard/img/dashboard_portal_terms_conditions.png new file mode 100644 index 0000000..b784fef Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_portal_terms_conditions.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_portal_transaction_sign.png b/collections/manual/documentation/dashboard/img/dashboard_portal_transaction_sign.png new file mode 100644 index 0000000..62b4219 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_portal_transaction_sign.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_portal_transfer_detail.png b/collections/manual/documentation/dashboard/img/dashboard_portal_transfer_detail.png new file mode 100644 index 0000000..919303c Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_portal_transfer_detail.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_portal_twin_created.png b/collections/manual/documentation/dashboard/img/dashboard_portal_twin_created.png new file mode 100644 index 0000000..0d9b470 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_portal_twin_created.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_portal_ui_nodes_minting.png b/collections/manual/documentation/dashboard/img/dashboard_portal_ui_nodes_minting.png new file mode 100644 index 0000000..fc925e2 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_portal_ui_nodes_minting.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_portal_withdraw_tft.png b/collections/manual/documentation/dashboard/img/dashboard_portal_withdraw_tft.png new file mode 100644 index 0000000..5493694 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_portal_withdraw_tft.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_sidebar_portal.png b/collections/manual/documentation/dashboard/img/dashboard_sidebar_portal.png new file mode 100644 index 0000000..9639032 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_sidebar_portal.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_statistics.png b/collections/manual/documentation/dashboard/img/dashboard_statistics.png new file mode 100644 index 0000000..8badd4c Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_statistics.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_swap.png b/collections/manual/documentation/dashboard/img/dashboard_swap.png new file mode 100644 index 0000000..dbda2ba Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_swap.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_tc.png b/collections/manual/documentation/dashboard/img/dashboard_tc.png new file mode 100644 index 0000000..f58af46 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_tc.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_transfer_address.png b/collections/manual/documentation/dashboard/img/dashboard_transfer_address.png new file mode 100644 index 0000000..2a389e9 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_transfer_address.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_transfer_twin.png b/collections/manual/documentation/dashboard/img/dashboard_transfer_twin.png new file mode 100644 index 0000000..7bff8ca Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_transfer_twin.png differ diff --git a/collections/manual/documentation/dashboard/img/dashboard_uptime.png b/collections/manual/documentation/dashboard/img/dashboard_uptime.png new file mode 100644 index 0000000..21920e7 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dashboard_uptime.png differ diff --git a/collections/manual/documentation/dashboard/img/dedicated_machines.png b/collections/manual/documentation/dashboard/img/dedicated_machines.png new file mode 100644 index 0000000..e832be5 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/dedicated_machines.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_basics_.png b/collections/manual/documentation/dashboard/img/explorer_basics_.png new file mode 100644 index 0000000..d8635ea Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_basics_.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_basics_2.png b/collections/manual/documentation/dashboard/img/explorer_basics_2.png new file mode 100644 index 0000000..8af783c Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_basics_2.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_darkmode.png b/collections/manual/documentation/dashboard/img/explorer_darkmode.png new file mode 100644 index 0000000..54cce34 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_darkmode.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_farm_details.png b/collections/manual/documentation/dashboard/img/explorer_farm_details.png new file mode 100644 index 0000000..17f5f88 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_farm_details.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_farms.png b/collections/manual/documentation/dashboard/img/explorer_farms.png new file mode 100644 index 0000000..73ddb75 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_farms.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_find_country_pubip.png b/collections/manual/documentation/dashboard/img/explorer_find_country_pubip.png new file mode 100644 index 0000000..54b7ab6 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_find_country_pubip.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_gpu.png b/collections/manual/documentation/dashboard/img/explorer_gpu.png new file mode 100644 index 0000000..6df7394 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_gpu.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_grafana.png b/collections/manual/documentation/dashboard/img/explorer_grafana.png new file mode 100644 index 0000000..9a702fb Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_grafana.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_node_details.png b/collections/manual/documentation/dashboard/img/explorer_node_details.png new file mode 100644 index 0000000..e6fd8c1 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_node_details.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_node_example_1.png b/collections/manual/documentation/dashboard/img/explorer_node_example_1.png new file mode 100644 index 0000000..712a8da Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_node_example_1.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_node_example_2.png b/collections/manual/documentation/dashboard/img/explorer_node_example_2.png new file mode 100644 index 0000000..7a0e46b Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_node_example_2.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_node_resources_1.png b/collections/manual/documentation/dashboard/img/explorer_node_resources_1.png new file mode 100644 index 0000000..51e44a0 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_node_resources_1.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_node_resources_2.png b/collections/manual/documentation/dashboard/img/explorer_node_resources_2.png new file mode 100644 index 0000000..0c406f3 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_node_resources_2.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_node_resources_3.png b/collections/manual/documentation/dashboard/img/explorer_node_resources_3.png new file mode 100644 index 0000000..47af607 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_node_resources_3.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_nodes.png b/collections/manual/documentation/dashboard/img/explorer_nodes.png new file mode 100644 index 0000000..d99a011 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_nodes.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_nodes_distribution.png b/collections/manual/documentation/dashboard/img/explorer_nodes_distribution.png new file mode 100644 index 0000000..90cd664 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_nodes_distribution.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_statistics.png b/collections/manual/documentation/dashboard/img/explorer_statistics.png new file mode 100644 index 0000000..9821a1d Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_statistics.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_status.png b/collections/manual/documentation/dashboard/img/explorer_status.png new file mode 100644 index 0000000..821d4ca Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_status.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_toggle_gateways.png b/collections/manual/documentation/dashboard/img/explorer_toggle_gateways.png new file mode 100644 index 0000000..6ce6c9f Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_toggle_gateways.png differ diff --git a/collections/manual/documentation/dashboard/img/explorer_toggle_gpu.png b/collections/manual/documentation/dashboard/img/explorer_toggle_gpu.png new file mode 100644 index 0000000..7ee4d6f Binary files /dev/null and b/collections/manual/documentation/dashboard/img/explorer_toggle_gpu.png differ diff --git a/collections/manual/documentation/dashboard/img/farms.png b/collections/manual/documentation/dashboard/img/farms.png new file mode 100644 index 0000000..5280633 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/farms.png differ diff --git a/collections/manual/documentation/dashboard/img/farms_details.png b/collections/manual/documentation/dashboard/img/farms_details.png new file mode 100644 index 0000000..744fde4 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/farms_details.png differ diff --git a/collections/manual/documentation/dashboard/img/farms_filters.png b/collections/manual/documentation/dashboard/img/farms_filters.png new file mode 100644 index 0000000..8eca69f Binary files /dev/null and b/collections/manual/documentation/dashboard/img/farms_filters.png differ diff --git a/collections/manual/documentation/dashboard/img/gpu_details.png b/collections/manual/documentation/dashboard/img/gpu_details.png new file mode 100644 index 0000000..83314cb Binary files /dev/null and b/collections/manual/documentation/dashboard/img/gpu_details.png differ diff --git a/collections/manual/documentation/dashboard/img/gpu_details_reserved.png b/collections/manual/documentation/dashboard/img/gpu_details_reserved.png new file mode 100644 index 0000000..84ab221 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/gpu_details_reserved.png differ diff --git a/collections/manual/documentation/dashboard/img/gpu_filter.png b/collections/manual/documentation/dashboard/img/gpu_filter.png new file mode 100644 index 0000000..3a3657d Binary files /dev/null and b/collections/manual/documentation/dashboard/img/gpu_filter.png differ diff --git a/collections/manual/documentation/dashboard/img/grid_health.png b/collections/manual/documentation/dashboard/img/grid_health.png new file mode 100644 index 0000000..2c5d9ee Binary files /dev/null and b/collections/manual/documentation/dashboard/img/grid_health.png differ diff --git a/collections/manual/documentation/dashboard/img/list_domains.png b/collections/manual/documentation/dashboard/img/list_domains.png new file mode 100644 index 0000000..9144a76 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/list_domains.png differ diff --git a/collections/manual/documentation/dashboard/img/manage_domains_button.png b/collections/manual/documentation/dashboard/img/manage_domains_button.png new file mode 100644 index 0000000..891110b Binary files /dev/null and b/collections/manual/documentation/dashboard/img/manage_domains_button.png differ diff --git a/collections/manual/documentation/dashboard/img/minting.png b/collections/manual/documentation/dashboard/img/minting.png new file mode 100644 index 0000000..b7de134 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/minting.png differ diff --git a/collections/manual/documentation/dashboard/img/monitoring.png b/collections/manual/documentation/dashboard/img/monitoring.png new file mode 100644 index 0000000..1cda446 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/monitoring.png differ diff --git a/collections/manual/documentation/dashboard/img/name_contracts.png b/collections/manual/documentation/dashboard/img/name_contracts.png new file mode 100644 index 0000000..35f1217 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/name_contracts.png differ diff --git a/collections/manual/documentation/dashboard/img/node_contracts.png b/collections/manual/documentation/dashboard/img/node_contracts.png new file mode 100644 index 0000000..b785b21 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/node_contracts.png differ diff --git a/collections/manual/documentation/dashboard/img/node_detail_.png b/collections/manual/documentation/dashboard/img/node_detail_.png new file mode 100644 index 0000000..1e06f9a Binary files /dev/null and b/collections/manual/documentation/dashboard/img/node_detail_.png differ diff --git a/collections/manual/documentation/dashboard/img/node_detail_1.png b/collections/manual/documentation/dashboard/img/node_detail_1.png new file mode 100644 index 0000000..6747192 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/node_detail_1.png differ diff --git a/collections/manual/documentation/dashboard/img/nodes.png b/collections/manual/documentation/dashboard/img/nodes.png new file mode 100644 index 0000000..be29183 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/nodes.png differ diff --git a/collections/manual/documentation/dashboard/img/nodes_details.png b/collections/manual/documentation/dashboard/img/nodes_details.png new file mode 100644 index 0000000..f5c4e8b Binary files /dev/null and b/collections/manual/documentation/dashboard/img/nodes_details.png differ diff --git a/collections/manual/documentation/dashboard/img/nodes_filters.png b/collections/manual/documentation/dashboard/img/nodes_filters.png new file mode 100644 index 0000000..68257c2 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/nodes_filters.png differ diff --git a/collections/manual/documentation/dashboard/img/orchestrator_landing.png b/collections/manual/documentation/dashboard/img/orchestrator_landing.png new file mode 100644 index 0000000..4770f40 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/orchestrator_landing.png differ diff --git a/collections/manual/documentation/dashboard/img/owncloud_create_user.png b/collections/manual/documentation/dashboard/img/owncloud_create_user.png new file mode 100644 index 0000000..ba0badc Binary files /dev/null and b/collections/manual/documentation/dashboard/img/owncloud_create_user.png differ diff --git a/collections/manual/documentation/dashboard/img/owncloud_credentials.png b/collections/manual/documentation/dashboard/img/owncloud_credentials.png new file mode 100644 index 0000000..8f1ad29 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/owncloud_credentials.png differ diff --git a/collections/manual/documentation/dashboard/img/owncloud_details.png b/collections/manual/documentation/dashboard/img/owncloud_details.png new file mode 100644 index 0000000..efe6136 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/owncloud_details.png differ diff --git a/collections/manual/documentation/dashboard/img/owncloud_enabled.png b/collections/manual/documentation/dashboard/img/owncloud_enabled.png new file mode 100644 index 0000000..8877f6b Binary files /dev/null and b/collections/manual/documentation/dashboard/img/owncloud_enabled.png differ diff --git a/collections/manual/documentation/dashboard/img/owncloud_logo.svg b/collections/manual/documentation/dashboard/img/owncloud_logo.svg new file mode 100644 index 0000000..4959a9f --- /dev/null +++ b/collections/manual/documentation/dashboard/img/owncloud_logo.svg @@ -0,0 +1,159 @@ + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/collections/manual/documentation/dashboard/img/owncloud_logout.png b/collections/manual/documentation/dashboard/img/owncloud_logout.png new file mode 100644 index 0000000..ba21a9f Binary files /dev/null and b/collections/manual/documentation/dashboard/img/owncloud_logout.png differ diff --git a/collections/manual/documentation/dashboard/img/owncloud_show.png b/collections/manual/documentation/dashboard/img/owncloud_show.png new file mode 100644 index 0000000..6b16ee3 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/owncloud_show.png differ diff --git a/collections/manual/documentation/dashboard/img/owncloud_tfconnect.png b/collections/manual/documentation/dashboard/img/owncloud_tfconnect.png new file mode 100644 index 0000000..d386991 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/owncloud_tfconnect.png differ diff --git a/collections/manual/documentation/dashboard/img/owncloud_users.png b/collections/manual/documentation/dashboard/img/owncloud_users.png new file mode 100644 index 0000000..aec7c03 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/owncloud_users.png differ diff --git a/collections/manual/documentation/dashboard/img/owncloud_visit.png b/collections/manual/documentation/dashboard/img/owncloud_visit.png new file mode 100644 index 0000000..5624e89 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/owncloud_visit.png differ diff --git a/collections/manual/documentation/dashboard/img/polkadot_extension_.png b/collections/manual/documentation/dashboard/img/polkadot_extension_.png new file mode 100644 index 0000000..bf3f6fd Binary files /dev/null and b/collections/manual/documentation/dashboard/img/polkadot_extension_.png differ diff --git a/collections/manual/documentation/dashboard/img/pricing_calculator.png b/collections/manual/documentation/dashboard/img/pricing_calculator.png new file mode 100644 index 0000000..31f21eb Binary files /dev/null and b/collections/manual/documentation/dashboard/img/pricing_calculator.png differ diff --git a/collections/manual/documentation/dashboard/img/pro_manager5.png b/collections/manual/documentation/dashboard/img/pro_manager5.png new file mode 100644 index 0000000..791dae0 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/pro_manager5.png differ diff --git a/collections/manual/documentation/dashboard/img/pro_manager6.png b/collections/manual/documentation/dashboard/img/pro_manager6.png new file mode 100644 index 0000000..2b77950 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/pro_manager6.png differ diff --git a/collections/manual/documentation/dashboard/img/profile_manager1.png b/collections/manual/documentation/dashboard/img/profile_manager1.png new file mode 100644 index 0000000..c34e966 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/profile_manager1.png differ diff --git a/collections/manual/documentation/dashboard/img/profile_manager2.png b/collections/manual/documentation/dashboard/img/profile_manager2.png new file mode 100644 index 0000000..98f2154 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/profile_manager2.png differ diff --git a/collections/manual/documentation/dashboard/img/profile_manager3.png b/collections/manual/documentation/dashboard/img/profile_manager3.png new file mode 100644 index 0000000..407780c Binary files /dev/null and b/collections/manual/documentation/dashboard/img/profile_manager3.png differ diff --git a/collections/manual/documentation/dashboard/img/rent_contracts.png b/collections/manual/documentation/dashboard/img/rent_contracts.png new file mode 100644 index 0000000..170ca57 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/rent_contracts.png differ diff --git a/collections/manual/documentation/dashboard/img/select_to_delete_domain.png b/collections/manual/documentation/dashboard/img/select_to_delete_domain.png new file mode 100644 index 0000000..1ae8ce8 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/select_to_delete_domain.png differ diff --git a/collections/manual/documentation/dashboard/img/sidebar_1.png b/collections/manual/documentation/dashboard/img/sidebar_1.png new file mode 100644 index 0000000..4779b4c Binary files /dev/null and b/collections/manual/documentation/dashboard/img/sidebar_1.png differ diff --git a/collections/manual/documentation/dashboard/img/sidebar_1_copy_full.png b/collections/manual/documentation/dashboard/img/sidebar_1_copy_full.png new file mode 100644 index 0000000..9e01af9 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/sidebar_1_copy_full.png differ diff --git a/collections/manual/documentation/dashboard/img/sidebar_2.png b/collections/manual/documentation/dashboard/img/sidebar_2.png new file mode 100644 index 0000000..58e913b Binary files /dev/null and b/collections/manual/documentation/dashboard/img/sidebar_2.png differ diff --git a/collections/manual/documentation/dashboard/img/sidebar_2_copy_full.png b/collections/manual/documentation/dashboard/img/sidebar_2_copy_full.png new file mode 100644 index 0000000..f7d8600 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/sidebar_2_copy_full.png differ diff --git a/collections/manual/documentation/dashboard/img/sidebar_3.png b/collections/manual/documentation/dashboard/img/sidebar_3.png new file mode 100644 index 0000000..565715d Binary files /dev/null and b/collections/manual/documentation/dashboard/img/sidebar_3.png differ diff --git a/collections/manual/documentation/dashboard/img/sidebar_3_copy_full.png b/collections/manual/documentation/dashboard/img/sidebar_3_copy_full.png new file mode 100644 index 0000000..8924f42 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/sidebar_3_copy_full.png differ diff --git a/collections/manual/documentation/dashboard/img/sidebar_4.png b/collections/manual/documentation/dashboard/img/sidebar_4.png new file mode 100644 index 0000000..8f94e9e Binary files /dev/null and b/collections/manual/documentation/dashboard/img/sidebar_4.png differ diff --git a/collections/manual/documentation/dashboard/img/sidebar_4_copy_full.png b/collections/manual/documentation/dashboard/img/sidebar_4_copy_full.png new file mode 100644 index 0000000..7a7e165 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/sidebar_4_copy_full.png differ diff --git a/collections/manual/documentation/dashboard/img/simulator.png b/collections/manual/documentation/dashboard/img/simulator.png new file mode 100644 index 0000000..b85a528 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/simulator.png differ diff --git a/collections/manual/documentation/dashboard/img/ssh_key.png b/collections/manual/documentation/dashboard/img/ssh_key.png new file mode 100644 index 0000000..7d22832 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/ssh_key.png differ diff --git a/collections/manual/documentation/dashboard/img/statistics.png b/collections/manual/documentation/dashboard/img/statistics.png new file mode 100644 index 0000000..a216231 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/statistics.png differ diff --git a/collections/manual/documentation/dashboard/img/twin.png b/collections/manual/documentation/dashboard/img/twin.png new file mode 100644 index 0000000..1e62185 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/twin.png differ diff --git a/collections/manual/documentation/dashboard/img/vm_landing.png b/collections/manual/documentation/dashboard/img/vm_landing.png new file mode 100644 index 0000000..21211a3 Binary files /dev/null and b/collections/manual/documentation/dashboard/img/vm_landing.png differ diff --git a/collections/manual/documentation/dashboard/play_go.md b/collections/manual/documentation/dashboard/play_go.md new file mode 100644 index 0000000..5bb8332 --- /dev/null +++ b/collections/manual/documentation/dashboard/play_go.md @@ -0,0 +1,5 @@ +- Choose one of the networks: + - https://dashboard.dev.grid.tf for Devnet. + - https://dashboard.qa.grid.tf for QAnet. + - https://dashboard.test.grid.tf for Testnet. + - https://dashboard.grid.tf for Mainnet. \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/add_domain.md b/collections/manual/documentation/dashboard/solutions/add_domain.md new file mode 100644 index 0000000..6883c97 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/add_domain.md @@ -0,0 +1,107 @@ +

Add a Domain to a VM

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Preparation](#preparation) +- [Add New Domain](#add-new-domain) +- [Domains List](#domains-list) +- [Delete a Domain](#delete-a-domain) +- [Questions and Feedback](#questions-and-feedback) + +*** + +## Introduction + +We cover the overall process to add a domain to a virtual machine running on the ThreeFold Grid. + +## Preparation + +- Deploy a virtual machine +- Click on the button **Manage Domains** under **Actions** + +![](../img/add_domain_6.png) + +- Open the **Add New Domain** tab + +![](../img/add_domain_10.png) + +## Add New Domain + +We cover the different domain parameters presented in the **Add New Domain** tab. + +- **Subdomain** + - The subdomain is used to reference to the complete domain name. It is randomly generated, but the user can write a specific subdomain name. + - The subdomain prefix (e.g. **fvm3748domainguide**) is decided as follows: + - Solution name (e.g. **fvm**) + - Twin ID (e.g. **3748**) + - Deployment name (e.g. **domainguide**) + - The complete subdomain is thus composed of the subdomain prefix mentioned above and the subdomain entered in the **Subdomain** field. +- **Custom domain name** + - You can also use a custom domain. + - In this case, instead of having a gateway subdomain and a gateway name as your domain, the domain will be the custom domain entered in this field. + - If you select **Custom domain**, make sure to set a DNS A record pointing to the gateway IP address on your domain name registrar. + +![Custom Domain Name](../img/add_domain_8.png) + +- **Select domain** + - Choose a gateway for your domain. + +- **Port** + - Choose the port that exposes your application instance on the virtual machine which the domain will point to. + - By default, it is set to **80**. + +- **TLS Passthrough** + - Disabling TLS passthrough will let the gateway terminate the traffic. + - Enabling TLS passthrough will let the backend service terminate the traffic. + +- **Network Name** + - This is the name of the WireGuard interface network (read-only field). + +- **IP Address** + - This is the WireGuard IP address (read-only field). + +Once you've filled the domain parameters, click on the **Add** button. The message **Successfully deployed gateway** will be presented once the domain is properly added. + +![Success Domain](../img/add_new_domain_success.png) + +## Domains List + +Once your domain is set, you can access the **Domains List** tab to consult its parameters. To visit the domain, simply click on the **Visit** button under **Actions**. + +![List Domain For VM](../img/add_domain_9.png) + +* **Name** + * The name is the subdomain (without the prefix) +* **Contract ID** + * Contract ID of the domain +* **Domain** + * Without a custom domain (default) + * The complete domain name (e.g. `fvm3748domainguidextebgpt.gent01.dev.grid.tf`) is composed of the subdomain prefix, the subdomain and the gateway domain. + - The subdomain prefix (e.g. `fvm3748domainguide`), as mentioned above. + - The subdomain (e.g. `xtebgpt`), chosen during the domain creation. + - The gateway domain (e.g. `gent01.dev.grid.tf`), based on the chosen gateway. + - With a custom domain + - The domain will be your custom domain (`e.g. threefold.pro`). +* **TLS Passthrough** + * The TLS passthrough status can be either **Yes** or **No**. +* **Backend** + * The WireGuard IP and the chosen port of the domain (e.g. `http://10.20.4.2:80`). +* **Status** + * **OK** is displayed when the domain is properly set. +* **Actions** + * Use the **Visit** button to open the domain URL. + +At all time, you can click on **Reload** to reload the Domains List parameters. + +## Delete a Domain + +To delete a domain, open the **Manage Domains** window, in the tab **Domains lists** select the domain you wish to delete and click **Delete**. + +![Select To Delete Domain](../img/add_domain_11.png) + +By clicking the **Delete** button, the deletion will start and the domain will be deleted from this virtual machine. + +## Questions and Feedback + +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. \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/algorand.md b/collections/manual/documentation/dashboard/solutions/algorand.md new file mode 100644 index 0000000..21c25c7 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/algorand.md @@ -0,0 +1,97 @@ +

Algorand

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) + - [Algorand Structure](#algorand-structure) +- [Run Default Node](#run-default-node) +- [Run Relay Node](#run-relay-node) +- [Run Participant Node](#run-participant-node) +- [Run Indexer Node](#run-indexer-node) +- [Select Capacity](#select-capacity) + +*** + +## Introduction + +[Algorand](https://www.algorand.com/) builds technology that accelerates the convergence between decentralized and traditional finance by enabling the simple creation of next-generation financial products, protocols, and exchange of value. + +## Prerequisites + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Algorand** + +### Algorand Structure + +- Algorand has two main [types](https://developer.algorand.org/docs/run-a-node/setup/types/#:~:text=The%20Algorand%20network%20is%20comprised,%2C%20and%20non%2Drelay%20nodes.) of nodes (Relay or Participant) you can run also a 4 networks you can run your node against. Combining the types you can get: + - Defualt: + This is a Non-relay and Non-participant + It can run on (Devnet, Testnet, Betanet, Mainnet) + - Relay: + Relay node Can't be participant. + It can run only on (Testnet, Mainnet) + - Participant: + Can run on any of the four nets. + - Indexer: + It is a default node but with Archival Mode enbled which will make you able to query the data of the blockchain. + +## Run Default Node + +The basic type. you select any network you want. and for the node type select Default. +![defaultdep](./img/solutions_algorand.png) + +after the deployment is done. `ssh` to the node and run `goal node status` +![defaulttest](./img/algorand_defaulttest.png) +here you see your node run against mainnet. + +## Run Relay Node + +Relay nodes are where other nodes connect. Therefore, a relay node must be able to support a large number of connections and handle the processing load associated with all the data flowing to and from these connections. Thus, relay nodes require significantly more power than non-relay nodes. Relay nodes are always configured in archival mode. + +The relay node must be publicaly accessable. so it must have public ip. +![relaydep](./img/algorand_relaydep.png) + +after the deployment is done. `ssh` to the node and run `goal node status` to see the status of the node. and also you can check if the right port is listening (:4161 for testnet, and :4160 for mainnet) +![relaytest](./img/algorand_relaytest.png) + +The next step accourding to the [docs](https://developer.algorand.org/docs/run-a-node/setup/types/#relay-node) is to register your `ip:port` on Algorand Public SRV. + +## Run Participant Node + +Participation means participation in the Algorand consensus protocol. An account that participates in the Algorand consensus protocol is eligible and available to be selected to propose and vote on new blocks in the Algorand blockchain. +Participation node is responsible for hosting participation keys for one or more online accounts. + +What you need? +- Account mnemonics on the network you deploy on (offline) you can check the status for you account on the AlgoExplorer. search by your account id. + + The account needs to have some microAlgo to sign the participation transaction. + - [Main net explorer](https://algoexplorer.io/) + - [Test net explorer](https://testnet.algoexplorer.io/) + +- First Round: is the first block you need your participaiton node to validate from. you can choose the last block form the explorer. + ![partexp](./img/algorand_partexp.png) +- Last Round: is the final block your node can validate. let's make it 30M + +![partdep](./img/algorand_partdep.png) + +after the deployment is done. `ssh` to the node and run `goal node status` to see the status of the node. you see it do catchup. and the fast catchup is to make the node sync with the latest block faster by only fetch the last 1k blocks. after it done it will start create the participation keys. +![partstatus](./img/algorand_partstatus.png) + +now if you check the explorer you can see the status of the account turned to Online +![partonl](./img/algorand_partonl.png) + +## Run Indexer Node + +The primary purpose of this Indexer is to provide a REST API interface of API calls to support searching the Algorand Blockchain. The Indexer REST APIs retrieve the blockchain data from a PostgreSQL compatible database that must be populated. This database is populated using the same indexer instance or a separate instance of the indexer which must connect to the algod process of a running Algorand node to read block data. This node must also be an Archival node to make searching the entire blockchain possible. + +![indexernode](./img/algorand_indexernode.png) + +After it finish you can access the indexer API at port `8980` and here are the [endpoint](https://developer.algorand.org/docs/rest-apis/indexer/) you can access. + +## Select Capacity + +The default scinario the capacity is computed based on the node (network/type) accourding to this [reference](https://howbigisalgorand.com/). +But you still can change this only to higher values by selecting the option `Set Custom Capacity` + \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/basic_environments_readme.md b/collections/manual/documentation/dashboard/solutions/basic_environments_readme.md new file mode 100644 index 0000000..d1bd532 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/basic_environments_readme.md @@ -0,0 +1,11 @@ +

Basic Environments

+ +

Table of Contents

+ +- [Virtual Machines](./vm_intro.md) + - [Micro and Full VM Differences ](./vm_differences.md) + - [Full Virtual Machine](./fullVm.md) + - [Micro Virtual Machine](./vm.md) +- [Kubernetes](./k8s.md) +- [NixOS MicroVM](./nixos_micro.md) +- [Add a Domain](./add_domain.md) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/caprover.md b/collections/manual/documentation/dashboard/solutions/caprover.md new file mode 100644 index 0000000..32034d7 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/caprover.md @@ -0,0 +1,165 @@ +

CapRover

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Requirements](#requirements) +- [Configs Tab](#configs-tab) +- [Admin and Workers Tabs](#admin-and-workers-tabs) +- [The Domain Name](#the-domain-name) + - [Domain Name Example](#domain-name-example) +- [How to Know the IP Address](#how-to-know-the-ip-address) +- [How to Access the Admin Interface](#how-to-access-the-admin-interface) +- [How to Work with CapRover](#how-to-work-with-caprover) + +*** + +## Introduction + +CapRover is an extremely easy to use app/database deployment & web server manager for your NodeJS, Python, PHP, ASP.NET, Ruby, MySQL, MongoDB, Postgres, WordPress (and etc...) applications! + +It's blazingly fast and very robust as it uses Docker, nginx, LetsEncrypt and NetData under the hood behind its simple-to-use interface. + +- CLI for automation and scripting +- Web GUI for ease of access and convenience +- No lock-in! Remove CapRover and your apps keep working! +- Docker Swarm under the hood for containerization and clustering +- Nginx (fully customizable template) under the hood for load-balancing +- Let's Encrypt under the hood for free SSL (HTTPS) + +Caprover is a very cool management app for containers based on Docker Swarm. + +It has following benefits : + +- easy to deploy apps (in seconds) +- easy to create new apps +- super good monitoring +- can be extended over the TFGrid + +## Requirements + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Orchestrators** +- Click on **CapRover** + +## Configs Tab + +![ ](./img/solutions_caprover.png) + +- Enter domain for you Caprover instance, Be very careful about the domain name: it needs to be a wildcard domain name you can configure in your chosen domain name system. +- Enter password for you Caprover instance. + +## Admin and Workers Tabs + +![ ](./img/solutions_caprover_leader.png) + +![ ](./img/solutions_caprover_workers.png) +Note: Worker nodes only accept SSH keys of RSA format. + +Deployment will take couple of minutes. + +## The Domain Name + +As per the [CapRover documentation](https://caprover.com/docs/get-started.html), you need to point a wildcard DNS entry to the VM IP address of your CapRover instance. You have to do this after having deployed the CapRover instance, otherwise you won't have access to the VM IP address. + +Let’s say your domain is **example.com** and your subdomain is **subdomain**. You can set **\*.subdomain.example.com** as an A record in your DNS settings to point to the VM IP address of the server hosting the CapRover instance, where **\*** acts as the wildcard. To do this, go to the DNS settings of your domain name registrar, and set a wild card A record entry. + +On your domain name registrar, you can manage your DNS settings as such, with **subdomain** as an example: + +| Record | Host | Value | TTL | +| ------ | ------------- | ------------- | --------- | +| A | @ | VM IP address | Automatic | +| A | subdomain | VM IP address | Automatic | +| A | \*.subdomain | VM IP address | Automatic | + +We note here that **@** is the root domain (@ takes the value of your domain name, e.g. **example** in **example.com**), **subdomain** is the name of your subdomain (it can be anything you want), and **\*.subdomain** is the wildcard for **subdomain**. If you don't want to use a subdomain, but only the domain, you could use a wildcard linked to the domain instead of the subdomain (e.g. put **\*** instead of **\*.subdomain** in the column **Host**). + +Once you've point a wildcard DNS entry to your CapRover IP address and that the DNS is properly propagated, you can click the **Admin Panel** button to access CapRover. This will lead you to the following URL (with **subdomain.example.com** as an example): + +> captain.subdomain.example.com + +Note that, to confirm the DNS propagation, you can use a [DNS lookup tool](https://mxtoolbox.com/DNSLookup.aspx). As an example, you can use the URL **captain.subdomain.example.com** to check if the IP address resolves to the VM IP address. + +### Domain Name Example + +In the following example, we pick ```apps.openly.life``` which is a domain name that will point to the IP address of the CapRover instance (which we only know after deployment). + +![ ](./img/domain_name_caprover_config.png) + +> Note how the *.apps.openly.life points to the public IPv4 address that has been returned from the deployment. + +## How to Know the IP Address + +Go back to your CapRover weblet and go to the deployment list. Click on `Show Details`. + +![ ](./img/solution_caprover_list.png) + +- The public IPv4 address is visible in here +- Now you can configure the domain name (see above, don't forget to point the wildcard domain to the public IP address) + +Click on details if you want to see more details + +```json + +{ + "version": 0, + "name": "caprover_leader_cr_156e44f0", + "created": 1637843368, + "status": "ok", + "message": "", + "flist": "https://hub.grid.tf/samehabouelsaad.3bot/tf-caprover-main-a4f186da8d.flist", + "publicIP": { + "ip": "185.206.122.136/24", + "gateway": "185.206.122.1" + }, + "planetary": false, + "yggIP": "", + "interfaces": [ + { + "network": "caprover_network_cr_156e44f0", + "ip": "10.200.4.2" + } + ], + "capacity": { + "cpu": 4, + "memory": 8192 + }, + "mounts": [ + { + "name": "data0", + "mountPoint": "/var/lib/docker", + "size": 107374182400, + "state": "ok", + "message": "" + } + ], + "env": { + "SWM_NODE_MODE": "leader", + "CAPROVER_ROOT_DOMAIN": "apps.openly.life", + "PUBLIC_KEY": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC/9RNGKRjHvViunSOXhBF7EumrWvmqAAVJSrfGdLaVasgaYK6tkTRDzpZNplh3Tk1aowneXnZffygzIIZ82FWQYBo04IBWwFDOsCawjVbuAfcd9ZslYEYB3QnxV6ogQ4rvXnJ7IHgm3E3SZvt2l45WIyFn6ZKuFifK1aXhZkxHIPf31q68R2idJ764EsfqXfaf3q8H3u4G0NjfWmdPm9nwf/RJDZO+KYFLQ9wXeqRn6u/mRx+u7UD+Uo0xgjRQk1m8V+KuLAmqAosFdlAq0pBO8lEBpSebYdvRWxpM0QSdNrYQcMLVRX7IehizyTt+5sYYbp6f11WWcxLx0QDsUZ/J" + }, + "entrypoint": "/sbin/zinit init", + "metadata": "", + "description": "caprover leader machine/node" +} +``` + +## How to Access the Admin Interface + +Make sure that you've point a wildcard DNS entry to your CapRover IP address (e.g. **185.206.122.136** in our example), as explained [here](#the-domain-name). + +* To access the CapRover admin interface, you can click the **Admin Panel** button or you can use the following admin URL template: **https://captain.subdomain.example.com**. + * Note the prefix **captain** and the usage of our wildcard domain. + +* The admin password is generated and visible behind the `Show Details` button of your CapRover deployment. + +![ ](./img/caprover_login.png) + +* You should now see the following screen: + +![ ](./img/captain_login+weblet_caprover_.png) + +## How to Work with CapRover + +* [CapRover Admin Tutorial](./caprover_admin.md) +* [CapRover Worker Tutorial](./caprover_worker.md) diff --git a/collections/manual/documentation/dashboard/solutions/caprover_admin.md b/collections/manual/documentation/dashboard/solutions/caprover_admin.md new file mode 100644 index 0000000..47dd8fd --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/caprover_admin.md @@ -0,0 +1,59 @@ +

CapRover Admin

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Step 1: Enable HTTPS](#step-1-enable-https) +- [Step 2: Add a Default Docker Registry](#step-2-add-a-default-docker-registry) +- [Step 3: Deploy an App](#step-3-deploy-an-app) +- [Step 4: Enable Monitoring](#step-4-enable-monitoring) +- [Step 5: Change Your Password](#step-5-change-your-password) + +*** + +## Introduction + +We present the steps to manage a CapRover Admin node. + +## Step 1: Enable HTTPS + +![ ](./img/enable_https_caprover.png) + +You need to specify your email address. + +You will have to login again. + +![ ](./img/caprover_https_activated.png) + +> Now force https. + +You will have to login again, and you should notice https is now used. + +## Step 2: Add a Default Docker Registry + +You'll have to add a default docker registry so other CapRover nodes in the cluster can download images from, and it can be self-hosted (managed by CapRover itself), to add it, go to `Cluster` -> `Docker Registry Configuration`. + +![ ](./img/caprover_docker_registry.png) + +You can check [official documentation](https://caprover.com/docs/app-scaling-and-cluster.html#setup-docker-registry) to know more about Docker registry options. + +## Step 3: Deploy an App + +![ ](./img/deploy_app_caprover1.png) + +just go to apps & follow the instructions, there is much more info on caprover website. + +## Step 4: Enable Monitoring + +![ ](./img/caprover_monitoring_start_.png) + +You should now see + +![ ](./img/caprover_monitoring_2_.png) + +## Step 5: Change Your Password + +- Go to `Settings` and change your password. This is important for your own security. + + +> Further information regarding the process of attaching a new node to the cluster can be found through the following documentation link: [Attach a New Node to the Cluster](./caprover_worker.md/#step-2-attach-a-new-node-to-the-cluster) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/caprover_worker.md b/collections/manual/documentation/dashboard/solutions/caprover_worker.md new file mode 100644 index 0000000..5269e23 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/caprover_worker.md @@ -0,0 +1,42 @@ +

CapRover Worker

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Step 1: Add a Default Docker Registry](#step-1-add-a-default-docker-registry) +- [Step 2: Attach a New Node to the Cluster](#step-2-attach-a-new-node-to-the-cluster) + +*** + +## Introduction + +We present the steps to manage a CapRover Worker node. + +## Step 1: Add a Default Docker Registry + +You'll have to add a default docker registry so other CapRover nodes in the cluster can download images from, and it can be self-hosted (managed by CapRover itself), to add it, go to `Cluster` -> `Docker Registry Configuration`. + +![ ](./img/caprover_docker_registry.png) + +- Click `Add Self-Hosted Registry` button, then click `Enable Self-Hosted Registry` + +![ ](./img/caprover_docker_default_registry.png) + +You can check [official documentation](https://caprover.com/docs/app-scaling-and-cluster.html#setup-docker-registry) to know more about Docker registry options. + + + +## Step 2: Attach a New Node to the Cluster + +![ ](./img/caprover_add_worker.png) + +- Add the public IPv4 address that has been returned from the worker deployment in the `New node IP Address` field. +- Add your `SSH private key` (you can use this command `cat ~/.ssh/id_rsa` to get your private key). +- Click `Join cluster` button. + +You should see the new added node under **Current Cluster Nodes** +![ ](./img/caprover_node_added.png) + +If you faced any problem you can use the `Alternative method`. + +Also you can check for Troubleshooting instruction on [Caprover Troubleshooting](https://caprover.com/docs/troubleshooting.html#second) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/casper.md b/collections/manual/documentation/dashboard/solutions/casper.md new file mode 100644 index 0000000..5071c09 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/casper.md @@ -0,0 +1,51 @@ +

CasperLabs

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Deployment](#deployment) + +*** + +## Introduction + +[Casper Network](https://casperlabs.io/) is a blockchain protocol built from the ground up to remain true to core Web3 principles and adapt to the needs of our evolving world. + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Casperlabs** + +## Deployment + +__Process__ : + +![ ](./img/solutions_casperlabs.png) + +- Enter an Application Name. It's used in generating a unique subdomain on one of the gateways on the network alongside your twin ID. Ex. ***cl98casp*.gent02.dev.grid.tf** + +- Select a capacity package: + - **Small**: {cpu: 2, memory: 4, diskSize: 100 } + - **Medium**: {cpu: 4, memory: 16, diskSize: 500 } + - **Large**: {cpu: 8, memory: 32, diskSize: 100 } + - Or choose a **Custom** plan +- Choose the network + - `Public IPv4` flag gives the virtual machine a Public IPv4 + +- `Dedicated` flag to retrieve only dedeicated nodes +- `Certified` flag to retrieve only certified nodes +- Choose the location of the node + - `Region` + - `Country` + - `Farm Name` +- Choose the node to deploy on +> Or you can select a specific node with manual selection. +- `Custom Domain` flag lets the user to use a custom domain +- Choose a gateway node to deploy your Casperlab instance on. + +After that is done you can see a list of all of your deployed instances + +![ ](./img/casper4.png) + +Click on ***Visit*** to go to the homepage of your Casperlabs instance! The node takes a long time in order for the RPC service to be ready so be patient! + +![ ](./img/casper5.png) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/discourse.md b/collections/manual/documentation/dashboard/solutions/discourse.md new file mode 100644 index 0000000..9bdff3c --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/discourse.md @@ -0,0 +1,53 @@ +

Discourse

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Deployment](#deployment) + +*** + +## Introduction + +[Discourse](https://www.discourse.org/) is the 100% open source discussion platform built for the next decade of the Internet. Use it as a mailing list, discussion forum, long-form chat room, and more! + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Discourse** + +## Deployment + +![ ](./img/solutions_discourse.png) + +- Enter an Application Name. It's used in generating a unique subdomain on one of the gateways on the network alongside your twin ID. Ex. ***dc98newdisc*.gent02.dev.grid.tf** + +- Enter administrator information including **Email**. This admin will have full permission on the deployed instance. +- Select a capacity package: + - **Small**: {cpu: 1, memory: 2, diskSize: 15 } + - **Medium**: {cpu: 2, memory: 4, diskSize: 50 } + - **Large**: {cpu: 4, memory: 16, diskSize: 100 } + - Or choose a **Custom** plan + +- `Dedicated` flag to retrieve only dedeicated nodes +- `Certified` flag to retrieve only certified nodes +- Choose the location of the node + - `Region` + - `Country` + - `Farm Name` + +- Choose the node to deploy on +> Or you can select a specific node with manual selection. +- `Custom Domain` flag lets the user to use a custom domain +- Choose a gateway node to deploy your Discourse instance on. + +Unlike other solutions, Discourse requires that you have an SMTP server. So make sure you fill the fields in the **Mail Server** tab in order to deploy your instance successfully. + +![ ](./img/discourse4.png) + +After that is done you can see a list of all of your deployed instances + +![ ](./img/discourse5.png) + +Click on ***Visit*** to go to the homepage of your Discourse instance! + +![ ](./img/discourse6.png) diff --git a/collections/manual/documentation/dashboard/solutions/fullvm.md b/collections/manual/documentation/dashboard/solutions/fullvm.md new file mode 100644 index 0000000..59b01e6 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/fullvm.md @@ -0,0 +1,108 @@ +

Full Virtual Machine

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Deployment](#deployment) +- [Difference Between Full VM and Micro VM](#difference-between-full-vm-and-micro-vm) +- [Manually Mounting Additional Disk](#manually-mounting-additional-disk) + - [Check All Disks Attached to the VM](#check-all-disks-attached-to-the-vm) + - [Create a Mount Directory](#create-a-mount-directory) + - [New file system](#new-file-system) + - [Mount drive](#mount-drive) + +*** + +## Introduction + +We present the steps to deploy a full VM on the TFGrid. + +## Deployment + +Deploy a new full virtual machine on the Threefold Grid + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Full Virtual Machine** + +**Process:** + +![ ](./img/solutions_fullvm.png) + +- Fill in the instance name: it's used to reference the Full VM in the future. +- Choose the image from the drop down (e.g Alpine, Ubuntu) or you can click on `Other` and manually specify the flist URL and the entrypoint. +- Select a capacity package: + - **Small**: {cpu: 1, memory: 2, diskSize: 25 } + - **Medium**: {cpu: 2, memory: 4, diskSize: 50 } + - **Large**: {cpu: 4, memory: 16, diskSize: 100} + - Or choose a **Custom** plan +- Choose the network + - `Public IPv4` flag gives the virtual machine a Public IPv4 + - `Public IPv6` flag gives the virtual machine a Public IPv6 + - `Planetary Network` to connect the Virtual Machine to Planetary network + - `Myceluim` to enable mycelium on the virtual machine + - `Wireguard Access` to add a wireguard access to the Virtual Machine +- `GPU` flag to add GPU to the Virtual machine + - To deploy a Full VM with GPU, you first need to [rent a dedicated node](../../dashboard/deploy/dedicated_machines.md) +- `Dedicated` flag to retrieve only dedicated nodes +- `Certified` flag to retrieve only certified nodes +- Choose the location of the node + - `Country` + - `Farm Name` +- Choose the node to deploy the Full Virtual Machine on + ![](./img/node_selection.png) + +You can attach one or more disks to the Virtual Machine by clicking on the Disks tab and the plus `+` sign and specify the following parameters +![ ](./img/new_vm3.png) + +- Disk name +- Disk size + +in the bottom of the page you can see a list of all of the virtual machines you deployed. you can click on `Show details` for more details + +![ ](./img/new_vm5.png) +You can also go to JSON tab for full details +![ ](./img/new_vm6.png) + +## Difference Between Full VM and Micro VM + +- Full VM contains a default disk attached to it which is not the case in the Micro VM where you needed to make sure to attach a disk to it or the VM will fail +- The default disk is mounted on / so if you want to attach any additional disks, you have to choose a different mounting point +- Only cloud init flists can be deployed on Full VM. You can check official Threefold flists [here](https://hub.grid.tf/tf-official-vms) +- In Full VM, you need to mount the additional disks manually after the VM is deployed + +## Manually Mounting Additional Disk + +- You can follow the following commands to add your disk manually: + +### Check All Disks Attached to the VM + +```bash +fdisk -l +``` + +The additional disk won't be mounted and you won't find it listed + +```bash +df -h +``` + +### Create a Mount Directory + +```bash +sudo mkdir /hdd6T +``` + +### New file system + +```bash +sudo mkfs.ext4 /dev/vdb +``` + +### Mount drive + +```bash +sudo mount /dev/vdb /hdd6T/ +``` + +![mounting additional disk](./img/fullvm6.png) diff --git a/collections/manual/documentation/dashboard/solutions/funkwhale.md b/collections/manual/documentation/dashboard/solutions/funkwhale.md new file mode 100644 index 0000000..8940728 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/funkwhale.md @@ -0,0 +1,59 @@ +

Funkwhale

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Deployment](#deployment) + +*** + +## Introduction + +[Funkwhale](https://funkwhale.audio/) is social platform to enjoy and share music. +Funkwhale is a community-driven project that lets you listen and share music and audio within a decentralized, open network. + +## Prerequisites + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Funkwhale** + +## Deployment + +__Process__ : + +![ ](./img/solutions_funkwhale.png) + +- Enter an Application Name. It's used in generating a unique subdomain on one of the gateways on the network alongside your twin ID. Ex. ***fw100myfunk*.gent02.dev.grid.tf** + +- Enter administrator information including **Username**, **Email** and **Password**. This admin user will have full permission on the deployed instance. + +- Select a capacity package: + - **Small**: {cpu: 1, memory: 2, diskSize: 50 } + - **Medium**: {cpu: 2, memory: 4, diskSize: 100 } + - **Large**: {cpu: 4, memory: 16, diskSize: 250 } + - Or choose a **Custom** plan +- Choose the network + - `Public IPv4` flag gives the virtual machine a Public IPv4 + +- `Dedicated` flag to retrieve only dedeicated nodes +- `Certified` flag to retrieve only certified nodes +- Choose the location of the node + - `Region` + - `Country` + - `Farm Name` + +- Choose the node to deploy on +> Or you can select a specific node with manual selection. +- `Custom Domain` flag lets the user to use a custom domain +- Choose a gateway node to deploy your Funkwhale instance on. + + +After that is done you can see a list of all of your deployed instances + +![ ](./img/funkwhale2.png) + +Click on ***Visit*** to go to the homepage of your Funkwhale instance! + +![ ](./img/funkwhale3.png) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/img/algorand_defaulttest.png b/collections/manual/documentation/dashboard/solutions/img/algorand_defaulttest.png new file mode 100644 index 0000000..8fbad1c Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/algorand_defaulttest.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/algorand_indexernode.png b/collections/manual/documentation/dashboard/solutions/img/algorand_indexernode.png new file mode 100644 index 0000000..54540ab Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/algorand_indexernode.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/algorand_partdep.png b/collections/manual/documentation/dashboard/solutions/img/algorand_partdep.png new file mode 100644 index 0000000..bde2f8c Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/algorand_partdep.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/algorand_partexp.png b/collections/manual/documentation/dashboard/solutions/img/algorand_partexp.png new file mode 100644 index 0000000..1c452fb Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/algorand_partexp.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/algorand_partonl.png b/collections/manual/documentation/dashboard/solutions/img/algorand_partonl.png new file mode 100644 index 0000000..984ebd5 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/algorand_partonl.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/algorand_partstatus.png b/collections/manual/documentation/dashboard/solutions/img/algorand_partstatus.png new file mode 100644 index 0000000..f8a9635 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/algorand_partstatus.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/algorand_relaydep.png b/collections/manual/documentation/dashboard/solutions/img/algorand_relaydep.png new file mode 100644 index 0000000..eb04aca Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/algorand_relaydep.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/algorand_relaytest.png b/collections/manual/documentation/dashboard/solutions/img/algorand_relaytest.png new file mode 100644 index 0000000..870b06e Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/algorand_relaytest.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_1.png b/collections/manual/documentation/dashboard/solutions/img/caprover_1.png new file mode 100644 index 0000000..b6b3f39 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_1.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_add_node2.png b/collections/manual/documentation/dashboard/solutions/img/caprover_add_node2.png new file mode 100644 index 0000000..e3ae2a0 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_add_node2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_add_worker.png b/collections/manual/documentation/dashboard/solutions/img/caprover_add_worker.png new file mode 100644 index 0000000..ee0e83a Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_add_worker.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_cluster.png b/collections/manual/documentation/dashboard/solutions/img/caprover_cluster.png new file mode 100644 index 0000000..0ede9c8 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_cluster.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_deploy_leader.png b/collections/manual/documentation/dashboard/solutions/img/caprover_deploy_leader.png new file mode 100644 index 0000000..0d757e4 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_deploy_leader.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_deploy_worker.png b/collections/manual/documentation/dashboard/solutions/img/caprover_deploy_worker.png new file mode 100644 index 0000000..e4f80ce Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_deploy_worker.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_deploying.png b/collections/manual/documentation/dashboard/solutions/img/caprover_deploying.png new file mode 100644 index 0000000..307569c Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_deploying.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_detail_weblet.png b/collections/manual/documentation/dashboard/solutions/img/caprover_detail_weblet.png new file mode 100644 index 0000000..4f619ff Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_detail_weblet.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_docker_default_registry.png b/collections/manual/documentation/dashboard/solutions/img/caprover_docker_default_registry.png new file mode 100644 index 0000000..0998b1c Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_docker_default_registry.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_docker_registry.png b/collections/manual/documentation/dashboard/solutions/img/caprover_docker_registry.png new file mode 100644 index 0000000..06abbeb Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_docker_registry.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_https_activated.png b/collections/manual/documentation/dashboard/solutions/img/caprover_https_activated.png new file mode 100644 index 0000000..2cbadd6 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_https_activated.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_login.png b/collections/manual/documentation/dashboard/solutions/img/caprover_login.png new file mode 100644 index 0000000..3d27d7e Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_login.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_monitoring_2_.png b/collections/manual/documentation/dashboard/solutions/img/caprover_monitoring_2_.png new file mode 100644 index 0000000..c92bf01 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_monitoring_2_.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_monitoring_start_.png b/collections/manual/documentation/dashboard/solutions/img/caprover_monitoring_start_.png new file mode 100644 index 0000000..2a5fa78 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_monitoring_start_.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_node_added.png b/collections/manual/documentation/dashboard/solutions/img/caprover_node_added.png new file mode 100644 index 0000000..93e9a35 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_node_added.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/caprover_select_node.png b/collections/manual/documentation/dashboard/solutions/img/caprover_select_node.png new file mode 100644 index 0000000..ce155b1 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/caprover_select_node.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/captain_loginweblet_caprover_.png b/collections/manual/documentation/dashboard/solutions/img/captain_loginweblet_caprover_.png new file mode 100644 index 0000000..c4f14d9 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/captain_loginweblet_caprover_.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/casper2.png b/collections/manual/documentation/dashboard/solutions/img/casper2.png new file mode 100644 index 0000000..4948b79 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/casper2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/casper3.png b/collections/manual/documentation/dashboard/solutions/img/casper3.png new file mode 100644 index 0000000..a9123f0 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/casper3.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/casper4.png b/collections/manual/documentation/dashboard/solutions/img/casper4.png new file mode 100644 index 0000000..17bd144 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/casper4.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/casper5.png b/collections/manual/documentation/dashboard/solutions/img/casper5.png new file mode 100644 index 0000000..5d3f1e7 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/casper5.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/cluster_add_nodes.png b/collections/manual/documentation/dashboard/solutions/img/cluster_add_nodes.png new file mode 100644 index 0000000..c338f54 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/cluster_add_nodes.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/contracts_list.png b/collections/manual/documentation/dashboard/solutions/img/contracts_list.png new file mode 100644 index 0000000..2990bde Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/contracts_list.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/deleted_contract_info.png b/collections/manual/documentation/dashboard/solutions/img/deleted_contract_info.png new file mode 100644 index 0000000..a3c0357 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/deleted_contract_info.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/deleted_contract_info_copy.png b/collections/manual/documentation/dashboard/solutions/img/deleted_contract_info_copy.png new file mode 100644 index 0000000..a3c0357 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/deleted_contract_info_copy.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/deplist1.png b/collections/manual/documentation/dashboard/solutions/img/deplist1.png new file mode 100644 index 0000000..e73d1fd Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/deplist1.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/deploy_app_caprover1.png b/collections/manual/documentation/dashboard/solutions/img/deploy_app_caprover1.png new file mode 100644 index 0000000..7a8fe1e Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/deploy_app_caprover1.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/discourse4.png b/collections/manual/documentation/dashboard/solutions/img/discourse4.png new file mode 100644 index 0000000..eaeb779 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/discourse4.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/discourse5.png b/collections/manual/documentation/dashboard/solutions/img/discourse5.png new file mode 100644 index 0000000..01dca67 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/discourse5.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/discourse6.png b/collections/manual/documentation/dashboard/solutions/img/discourse6.png new file mode 100644 index 0000000..f1566c8 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/discourse6.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/domain_name_caprover_config.png b/collections/manual/documentation/dashboard/solutions/img/domain_name_caprover_config.png new file mode 100644 index 0000000..dca23c3 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/domain_name_caprover_config.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/enable_https_caprover.png b/collections/manual/documentation/dashboard/solutions/img/enable_https_caprover.png new file mode 100644 index 0000000..4149288 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/enable_https_caprover.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/fullvm1.png b/collections/manual/documentation/dashboard/solutions/img/fullvm1.png new file mode 100644 index 0000000..ce820d2 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/fullvm1.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/fullvm2.png b/collections/manual/documentation/dashboard/solutions/img/fullvm2.png new file mode 100644 index 0000000..811bdfc Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/fullvm2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/fullvm4.png b/collections/manual/documentation/dashboard/solutions/img/fullvm4.png new file mode 100644 index 0000000..5186f74 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/fullvm4.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/fullvm5.png b/collections/manual/documentation/dashboard/solutions/img/fullvm5.png new file mode 100644 index 0000000..376d3d9 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/fullvm5.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/fullvm6.png b/collections/manual/documentation/dashboard/solutions/img/fullvm6.png new file mode 100644 index 0000000..30348fc Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/fullvm6.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/fullvm7.jpg b/collections/manual/documentation/dashboard/solutions/img/fullvm7.jpg new file mode 100644 index 0000000..f5fd320 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/fullvm7.jpg differ diff --git a/collections/manual/documentation/dashboard/solutions/img/funkwhale2.png b/collections/manual/documentation/dashboard/solutions/img/funkwhale2.png new file mode 100644 index 0000000..de4fab4 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/funkwhale2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/funkwhale3.png b/collections/manual/documentation/dashboard/solutions/img/funkwhale3.png new file mode 100644 index 0000000..7a5f00c Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/funkwhale3.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/k8s_dl_1.png b/collections/manual/documentation/dashboard/solutions/img/k8s_dl_1.png new file mode 100644 index 0000000..c8b5670 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/k8s_dl_1.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/k8s_dl_2.png b/collections/manual/documentation/dashboard/solutions/img/k8s_dl_2.png new file mode 100644 index 0000000..a5874f7 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/k8s_dl_2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/k8s_dl_4.png b/collections/manual/documentation/dashboard/solutions/img/k8s_dl_4.png new file mode 100644 index 0000000..be4361c Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/k8s_dl_4.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/mastodon1.jpg b/collections/manual/documentation/dashboard/solutions/img/mastodon1.jpg new file mode 100644 index 0000000..e4bc3d6 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/mastodon1.jpg differ diff --git a/collections/manual/documentation/dashboard/solutions/img/mastodon2.jpg b/collections/manual/documentation/dashboard/solutions/img/mastodon2.jpg new file mode 100644 index 0000000..ae0748b Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/mastodon2.jpg differ diff --git a/collections/manual/documentation/dashboard/solutions/img/mastodon3.jpg b/collections/manual/documentation/dashboard/solutions/img/mastodon3.jpg new file mode 100644 index 0000000..591570b Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/mastodon3.jpg differ diff --git a/collections/manual/documentation/dashboard/solutions/img/mastodon4.jpg b/collections/manual/documentation/dashboard/solutions/img/mastodon4.jpg new file mode 100644 index 0000000..f9afe85 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/mastodon4.jpg differ diff --git a/collections/manual/documentation/dashboard/solutions/img/mastodon5.jpg b/collections/manual/documentation/dashboard/solutions/img/mastodon5.jpg new file mode 100644 index 0000000..eb01556 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/mastodon5.jpg differ diff --git a/collections/manual/documentation/dashboard/solutions/img/mattermost3.png b/collections/manual/documentation/dashboard/solutions/img/mattermost3.png new file mode 100644 index 0000000..2ada6dc Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/mattermost3.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/mattermost4.png b/collections/manual/documentation/dashboard/solutions/img/mattermost4.png new file mode 100644 index 0000000..fd6ee19 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/mattermost4.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/mattermost5.png b/collections/manual/documentation/dashboard/solutions/img/mattermost5.png new file mode 100644 index 0000000..a45f632 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/mattermost5.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_cap2.png b/collections/manual/documentation/dashboard/solutions/img/new_cap2.png new file mode 100644 index 0000000..689da23 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_cap2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_cap3.png b/collections/manual/documentation/dashboard/solutions/img/new_cap3.png new file mode 100644 index 0000000..31c5110 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_cap3.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_funk2.png b/collections/manual/documentation/dashboard/solutions/img/new_funk2.png new file mode 100644 index 0000000..eb87d9f Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_funk2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_funk3.png b/collections/manual/documentation/dashboard/solutions/img/new_funk3.png new file mode 100644 index 0000000..4e97d6d Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_funk3.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_k8s4.png b/collections/manual/documentation/dashboard/solutions/img/new_k8s4.png new file mode 100644 index 0000000..9dded9c Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_k8s4.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_k8s5.png b/collections/manual/documentation/dashboard/solutions/img/new_k8s5.png new file mode 100644 index 0000000..e6aa91a Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_k8s5.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_peer2.png b/collections/manual/documentation/dashboard/solutions/img/new_peer2.png new file mode 100644 index 0000000..604fe10 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_peer2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_peer3.png b/collections/manual/documentation/dashboard/solutions/img/new_peer3.png new file mode 100644 index 0000000..43987a4 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_peer3.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_vm2.png b/collections/manual/documentation/dashboard/solutions/img/new_vm2.png new file mode 100644 index 0000000..c5ebf1d Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_vm2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_vm3.png b/collections/manual/documentation/dashboard/solutions/img/new_vm3.png new file mode 100644 index 0000000..1981cb6 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_vm3.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_vm5.png b/collections/manual/documentation/dashboard/solutions/img/new_vm5.png new file mode 100644 index 0000000..723a44e Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_vm5.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_vm6.png b/collections/manual/documentation/dashboard/solutions/img/new_vm6.png new file mode 100644 index 0000000..d2af47d Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_vm6.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_vm7.png b/collections/manual/documentation/dashboard/solutions/img/new_vm7.png new file mode 100644 index 0000000..da8c92b Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_vm7.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/new_vm8.png b/collections/manual/documentation/dashboard/solutions/img/new_vm8.png new file mode 100644 index 0000000..ee291c8 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/new_vm8.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/nixos_micro1.png b/collections/manual/documentation/dashboard/solutions/img/nixos_micro1.png new file mode 100644 index 0000000..0114907 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/nixos_micro1.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/nixos_micro2.png b/collections/manual/documentation/dashboard/solutions/img/nixos_micro2.png new file mode 100644 index 0000000..d094ef3 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/nixos_micro2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/nixos_micro3.png b/collections/manual/documentation/dashboard/solutions/img/nixos_micro3.png new file mode 100644 index 0000000..85247c3 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/nixos_micro3.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/node_selection.png b/collections/manual/documentation/dashboard/solutions/img/node_selection.png new file mode 100644 index 0000000..50a30dc Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/node_selection.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/nodep_2.png b/collections/manual/documentation/dashboard/solutions/img/nodep_2.png new file mode 100644 index 0000000..f1f7ac2 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/nodep_2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/nodepilot_2.png b/collections/manual/documentation/dashboard/solutions/img/nodepilot_2.png new file mode 100644 index 0000000..083551b Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/nodepilot_2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/nodepilot_3.png b/collections/manual/documentation/dashboard/solutions/img/nodepilot_3.png new file mode 100644 index 0000000..8b4549b Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/nodepilot_3.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/nxios_micro1.png b/collections/manual/documentation/dashboard/solutions/img/nxios_micro1.png new file mode 100644 index 0000000..c2fc9d7 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/nxios_micro1.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/owncloud1.png b/collections/manual/documentation/dashboard/solutions/img/owncloud1.png new file mode 100644 index 0000000..2a5567e Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/owncloud1.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/owncloud2.png b/collections/manual/documentation/dashboard/solutions/img/owncloud2.png new file mode 100644 index 0000000..c34fab7 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/owncloud2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/owncloud3.png b/collections/manual/documentation/dashboard/solutions/img/owncloud3.png new file mode 100644 index 0000000..62995d3 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/owncloud3.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/owncloud4.png b/collections/manual/documentation/dashboard/solutions/img/owncloud4.png new file mode 100644 index 0000000..98d16ae Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/owncloud4.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/owncloud5.png b/collections/manual/documentation/dashboard/solutions/img/owncloud5.png new file mode 100644 index 0000000..d441b86 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/owncloud5.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/owncloud6.png b/collections/manual/documentation/dashboard/solutions/img/owncloud6.png new file mode 100644 index 0000000..a994782 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/owncloud6.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/presearch0.png b/collections/manual/documentation/dashboard/solutions/img/presearch0.png new file mode 100644 index 0000000..29dedbe Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/presearch0.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/presearch4.png b/collections/manual/documentation/dashboard/solutions/img/presearch4.png new file mode 100644 index 0000000..2c3c8e9 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/presearch4.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/presearch5.png b/collections/manual/documentation/dashboard/solutions/img/presearch5.png new file mode 100644 index 0000000..9c7ec67 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/presearch5.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/presearch6.png b/collections/manual/documentation/dashboard/solutions/img/presearch6.png new file mode 100644 index 0000000..9279f30 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/presearch6.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/qvm1.png b/collections/manual/documentation/dashboard/solutions/img/qvm1.png new file mode 100644 index 0000000..93277ab Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/qvm1.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/qvm2.png b/collections/manual/documentation/dashboard/solutions/img/qvm2.png new file mode 100644 index 0000000..0777158 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/qvm2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/qvm_nodes.png b/collections/manual/documentation/dashboard/solutions/img/qvm_nodes.png new file mode 100644 index 0000000..3670785 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/qvm_nodes.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/qvm_qsfs_config.png b/collections/manual/documentation/dashboard/solutions/img/qvm_qsfs_config.png new file mode 100644 index 0000000..6e337e4 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/qvm_qsfs_config.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solution_caprover_list.png b/collections/manual/documentation/dashboard/solutions/img/solution_caprover_list.png new file mode 100644 index 0000000..3f672e2 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solution_caprover_list.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_algorand.png b/collections/manual/documentation/dashboard/solutions/img/solutions_algorand.png new file mode 100644 index 0000000..ca7e860 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_algorand.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_caprover.png b/collections/manual/documentation/dashboard/solutions/img/solutions_caprover.png new file mode 100644 index 0000000..bf2f072 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_caprover.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_caprover_leader.png b/collections/manual/documentation/dashboard/solutions/img/solutions_caprover_leader.png new file mode 100644 index 0000000..218931d Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_caprover_leader.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_caprover_workers.png b/collections/manual/documentation/dashboard/solutions/img/solutions_caprover_workers.png new file mode 100644 index 0000000..0b12a69 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_caprover_workers.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_casperlabs.png b/collections/manual/documentation/dashboard/solutions/img/solutions_casperlabs.png new file mode 100644 index 0000000..f9f3271 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_casperlabs.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_discourse.png b/collections/manual/documentation/dashboard/solutions/img/solutions_discourse.png new file mode 100644 index 0000000..d7e0c66 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_discourse.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_fullvm.png b/collections/manual/documentation/dashboard/solutions/img/solutions_fullvm.png new file mode 100644 index 0000000..32d786d Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_fullvm.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_funkwhale.png b/collections/manual/documentation/dashboard/solutions/img/solutions_funkwhale.png new file mode 100644 index 0000000..6802db6 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_funkwhale.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_k8s.png b/collections/manual/documentation/dashboard/solutions/img/solutions_k8s.png new file mode 100644 index 0000000..935de58 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_k8s.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_k8s_master.png b/collections/manual/documentation/dashboard/solutions/img/solutions_k8s_master.png new file mode 100644 index 0000000..948a43b Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_k8s_master.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_k8s_workers.png b/collections/manual/documentation/dashboard/solutions/img/solutions_k8s_workers.png new file mode 100644 index 0000000..5e6df13 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_k8s_workers.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_mattermost.png b/collections/manual/documentation/dashboard/solutions/img/solutions_mattermost.png new file mode 100644 index 0000000..e47bb61 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_mattermost.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_microvm.png b/collections/manual/documentation/dashboard/solutions/img/solutions_microvm.png new file mode 100644 index 0000000..abad7ff Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_microvm.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_nextcloud.png b/collections/manual/documentation/dashboard/solutions/img/solutions_nextcloud.png new file mode 100644 index 0000000..a588f97 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_nextcloud.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_nodepilot.png b/collections/manual/documentation/dashboard/solutions/img/solutions_nodepilot.png new file mode 100644 index 0000000..65de04c Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_nodepilot.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_owncloud.png b/collections/manual/documentation/dashboard/solutions/img/solutions_owncloud.png new file mode 100644 index 0000000..98f7302 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_owncloud.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_owncloud_visit.png b/collections/manual/documentation/dashboard/solutions/img/solutions_owncloud_visit.png new file mode 100644 index 0000000..45c8857 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_owncloud_visit.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_peertube.png b/collections/manual/documentation/dashboard/solutions/img/solutions_peertube.png new file mode 100644 index 0000000..341653d Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_peertube.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_presearch.png b/collections/manual/documentation/dashboard/solutions/img/solutions_presearch.png new file mode 100644 index 0000000..258fca0 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_presearch.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_subsquid.png b/collections/manual/documentation/dashboard/solutions/img/solutions_subsquid.png new file mode 100644 index 0000000..2b2f132 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_subsquid.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_taiga.png b/collections/manual/documentation/dashboard/solutions/img/solutions_taiga.png new file mode 100644 index 0000000..b4f89e1 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_taiga.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_umbrel.png b/collections/manual/documentation/dashboard/solutions/img/solutions_umbrel.png new file mode 100644 index 0000000..311d83c Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_umbrel.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/solutions_wordpress.png b/collections/manual/documentation/dashboard/solutions/img/solutions_wordpress.png new file mode 100644 index 0000000..58e66b2 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/solutions_wordpress.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/subsquid_graphql.png b/collections/manual/documentation/dashboard/solutions/img/subsquid_graphql.png new file mode 100644 index 0000000..82cf6d0 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/subsquid_graphql.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/subsquid_list.jpg b/collections/manual/documentation/dashboard/solutions/img/subsquid_list.jpg new file mode 100644 index 0000000..596497f Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/subsquid_list.jpg differ diff --git a/collections/manual/documentation/dashboard/solutions/img/subsquid_list.png b/collections/manual/documentation/dashboard/solutions/img/subsquid_list.png new file mode 100644 index 0000000..c0a78aa Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/subsquid_list.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/taiga2.png b/collections/manual/documentation/dashboard/solutions/img/taiga2.png new file mode 100644 index 0000000..cdcfcd4 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/taiga2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/taiga3.png b/collections/manual/documentation/dashboard/solutions/img/taiga3.png new file mode 100644 index 0000000..35ddd01 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/taiga3.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/taiga4.png b/collections/manual/documentation/dashboard/solutions/img/taiga4.png new file mode 100644 index 0000000..8b9c844 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/taiga4.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/taiga5.png b/collections/manual/documentation/dashboard/solutions/img/taiga5.png new file mode 100644 index 0000000..f0bcc2b Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/taiga5.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/taiga6.png b/collections/manual/documentation/dashboard/solutions/img/taiga6.png new file mode 100644 index 0000000..606939b Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/taiga6.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/umbrel2.png b/collections/manual/documentation/dashboard/solutions/img/umbrel2.png new file mode 100644 index 0000000..859e141 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/umbrel2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/umbrel3.png b/collections/manual/documentation/dashboard/solutions/img/umbrel3.png new file mode 100644 index 0000000..c8dacd5 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/umbrel3.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/umbrel4.png b/collections/manual/documentation/dashboard/solutions/img/umbrel4.png new file mode 100644 index 0000000..1d9bdf1 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/umbrel4.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/umbrel5.png b/collections/manual/documentation/dashboard/solutions/img/umbrel5.png new file mode 100644 index 0000000..4d7379d Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/umbrel5.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/vm_json.png b/collections/manual/documentation/dashboard/solutions/img/vm_json.png new file mode 100644 index 0000000..1ab3737 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/vm_json.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/vm_list.png b/collections/manual/documentation/dashboard/solutions/img/vm_list.png new file mode 100644 index 0000000..2a504b1 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/vm_list.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/weblet_peertube_instance.png b/collections/manual/documentation/dashboard/solutions/img/weblet_peertube_instance.png new file mode 100644 index 0000000..4474a75 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/weblet_peertube_instance.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/weblet_peertube_listing.png b/collections/manual/documentation/dashboard/solutions/img/weblet_peertube_listing.png new file mode 100644 index 0000000..93de06f Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/weblet_peertube_listing.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/weblet_vm4.png b/collections/manual/documentation/dashboard/solutions/img/weblet_vm4.png new file mode 100644 index 0000000..f088303 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/weblet_vm4.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/weblet_vm5.png b/collections/manual/documentation/dashboard/solutions/img/weblet_vm5.png new file mode 100644 index 0000000..0f778f5 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/weblet_vm5.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/weblet_vm_overview.png b/collections/manual/documentation/dashboard/solutions/img/weblet_vm_overview.png new file mode 100644 index 0000000..3262552 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/weblet_vm_overview.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/weblet_vm_presearch_result.jpg b/collections/manual/documentation/dashboard/solutions/img/weblet_vm_presearch_result.jpg new file mode 100644 index 0000000..ae77142 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/weblet_vm_presearch_result.jpg differ diff --git a/collections/manual/documentation/dashboard/solutions/img/wp10.png b/collections/manual/documentation/dashboard/solutions/img/wp10.png new file mode 100644 index 0000000..c4f9998 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/wp10.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/wp11.png b/collections/manual/documentation/dashboard/solutions/img/wp11.png new file mode 100644 index 0000000..35e9f58 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/wp11.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/wp2.png b/collections/manual/documentation/dashboard/solutions/img/wp2.png new file mode 100644 index 0000000..8e3aed3 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/wp2.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/wp3.png b/collections/manual/documentation/dashboard/solutions/img/wp3.png new file mode 100644 index 0000000..e485277 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/wp3.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/wp4.png b/collections/manual/documentation/dashboard/solutions/img/wp4.png new file mode 100644 index 0000000..8d534f1 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/wp4.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/wp5.png b/collections/manual/documentation/dashboard/solutions/img/wp5.png new file mode 100644 index 0000000..141497d Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/wp5.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/wp6.png b/collections/manual/documentation/dashboard/solutions/img/wp6.png new file mode 100644 index 0000000..0f72d48 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/wp6.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/wp7.png b/collections/manual/documentation/dashboard/solutions/img/wp7.png new file mode 100644 index 0000000..01af952 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/wp7.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/wp8.png b/collections/manual/documentation/dashboard/solutions/img/wp8.png new file mode 100644 index 0000000..f243cd2 Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/wp8.png differ diff --git a/collections/manual/documentation/dashboard/solutions/img/wp9.png b/collections/manual/documentation/dashboard/solutions/img/wp9.png new file mode 100644 index 0000000..34173dd Binary files /dev/null and b/collections/manual/documentation/dashboard/solutions/img/wp9.png differ diff --git a/collections/manual/documentation/dashboard/solutions/k8s.md b/collections/manual/documentation/dashboard/solutions/k8s.md new file mode 100644 index 0000000..11197ec --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/k8s.md @@ -0,0 +1,98 @@ +

Kubernetes

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Configs tab](#configs-tab) +- [Master and Workers tabs](#master-and-workers-tabs) +- [Kubeconfig](#kubeconfig) +- [Manage Workers](#manage-workers) + +*** + +## Introduction + +Kubernetes is the standard container orchestration tool. + +On the TF grid, Kubernetes clusters can be deployed out of the box. We have implemented [K3S](https://k3s.io/), a full-blown Kubernetes offering that uses only half of the memory footprint. It is packaged as a single binary and made more lightweight to run workloads in resource-constrained locations (fits e.g. IoT, edge, ARM workloads). + +## Prerequisites + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Kubernetes** + +## Configs tab + +![ ](./img/solutions_k8s.png) + +- `Name`: Your Kubernetes Cluster name. +- `Cluster Token`: It's used for authentication between your worker nodes and master node. You could use the auto-generated one or type your own. + + +## Master and Workers tabs + +![ ](./img/solutions_k8s_master.png) +![ ](./img/solutions_k8s_workers.png) + +> Currently, we only support "single-master-multi-worker" k8s clusters. So you could always add more than one worker node by clicking on the **+** in the ***Worker*** tab. + + +## Kubeconfig +Once the cluster is ready, you can SSH into the cluster using `ssh root@IP` +> IP can be the public IP or the planetary network IP + +Onced connected via SSH, you can execute commands on the cluster like `kubectl get nodes`, and to get the kubeconfig, you can find it in `/root/.kube/config` + +> if it doesn't exist in `/root/.kube/config` it can be in `/etc/rancher/k3s/k3s.yaml` + +example: + +``` +root@WR768dbf76:~# cat /root/.kube/config +apiVersion: v1 +clusters: +- cluster: + certificate-authority-data: LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUJkakNDQVIyZ0F3SUJBZ0lCQURBS0JnZ3Foa2pPUFFRREFqQWpNU0V3SHdZRFZRUUREQmhyTTNNdGMyVnkKZG1WeUxXTmhRREUyTkRBeU5qWTBNVE13SGhjTk1qRXhNakl6TVRNek16TXpXaGNOTXpFeE1qSXhNVE16TXpNegpXakFqTVNFd0h3WURWUVFEREJock0zTXRjMlZ5ZG1WeUxXTmhRREUyTkRBeU5qWTBNVE13V1RBVEJnY3Foa2pPClBRSUJCZ2dxaGtqT1BRTUJCd05DQUFUcGNtZE1KaWg1eGFTa1JlelNKVU5mUkQ5NWV6cE12amhVeUc2bWU4bTkKY0lQWENoNUZ2ZU81Znk1d1VTSTlYOFlGV2JkOGtRcG9vaVdVbStwYjFvU3hvMEl3UURBT0JnTlZIUThCQWY4RQpCQU1DQXFRd0R3WURWUjBUQVFIL0JBVXdBd0VCL3pBZEJnTlZIUTRFRmdRVUtkL3VUU3FtWk12bHhtcWNYU3lxCmVhWERIbXd3Q2dZSUtvWkl6ajBFQXdJRFJ3QXdSQUlnSUQ0cGNQWDl2R0F6SC9lTkhCNndVdmNZRi9HbXFuQVIKR2dqT1RSdWVia1lDSUdRUmUwTGJzQXdwMWNicHlYRWljV3V0aG1RQ1dwRXY1NThWZ3BoMFpETFAKLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo= + server: https://127.0.0.1:6443 + name: default +contexts: +- context: + cluster: default + user: default + name: default +current-context: default +kind: Config +preferences: {} +users: +- name: default + user: + client-certificate-data: LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUJrVENDQVRlZ0F3SUJBZ0lJWnptV1A4ellKaGd3Q2dZSUtvWkl6ajBFQXdJd0l6RWhNQjhHQTFVRUF3d1kKYXpOekxXTnNhV1Z1ZEMxallVQXhOalF3TWpZMk5ERXpNQjRYRFRJeE1USXlNekV6TXpNek0xb1hEVEl5TVRJeQpNekV6TXpNek0xb3dNREVYTUJVR0ExVUVDaE1PYzNsemRHVnRPbTFoYzNSbGNuTXhGVEFUQmdOVkJBTVRESE41CmMzUmxiVHBoWkcxcGJqQlpNQk1HQnlxR1NNNDlBZ0VHQ0NxR1NNNDlBd0VIQTBJQUJINTZaZGM5aTJ0azAyNGQKcXBDQ2NRMndMMjc1QWtPZUFxalIzQjFTTGFQeG1oOG9IcXd4SzY2RTc1ZWQya2VySFIySnBZbWwwNE5sa0grLwpSd2kvMDNDalNEQkdNQTRHQTFVZER3RUIvd1FFQXdJRm9EQVRCZ05WSFNVRUREQUtCZ2dyQmdFRkJRY0RBakFmCkJnTlZIU01FR0RBV2dCVGhPakJSaExjeE53UDkzd0xtUzBYRUFUNjlSekFLQmdncWhrak9QUVFEQWdOSUFEQkYKQWlBcjdDcDR2dks4Y2s0Q0lROEM5em5zVkFUZVhDaHZsUmdvanZuVXU4REZld0loQUlwRVYyMWJZVXBpUEkzVQowa3QvQmJqRUtjV1poVXNHQ0g0YzVNWTFFS0JhCi0tLS0tRU5EIENFUlRJRklDQVRFLS0tLS0KLS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUJkekNDQVIyZ0F3SUJBZ0lCQURBS0JnZ3Foa2pPUFFRREFqQWpNU0V3SHdZRFZRUUREQmhyTTNNdFkyeHAKWlc1MExXTmhRREUyTkRBeU5qWTBNVE13SGhjTk1qRXhNakl6TVRNek16TXpXaGNOTXpFeE1qSXhNVE16TXpNegpXakFqTVNFd0h3WURWUVFEREJock0zTXRZMnhwWlc1MExXTmhRREUyTkRBeU5qWTBNVE13V1RBVEJnY3Foa2pPClBRSUJCZ2dxaGtqT1BRTUJCd05DQUFUY3NlakN3TDQ5VkZvQnJhWVRyR3ByR2lMajNKeEw4ZVcwYnpTVDBWRGUKeFlrb3hDbDlnR0N6R2p1Q2Q0ZmZmRXV0QWdFMjU5MDFBWGJCU2VnOHdlSkJvMEl3UURBT0JnTlZIUThCQWY4RQpCQU1DQXFRd0R3WURWUjBUQVFIL0JBVXdBd0VCL3pBZEJnTlZIUTRFRmdRVTRUb3dVWVMzTVRjRC9kOEM1a3RGCnhBRSt2VWN3Q2dZSUtvWkl6ajBFQXdJRFNBQXdSUUloQU5CYWRhcFFZbnlYOEJDUllNODZtYWtMNkFDM0hSenMKL2l3Ukp6TnV6YytaQWlCZm14YytDTVZHQnBrblAzR2dWSWlFMFVQWkUrOFRnRUdkTTgrdCt4V2Ywdz09Ci0tLS0tRU5EIENFUlRJRklDQVRFLS0tLS0K + client-key-data: LS0tLS1CRUdJTiBFQyBQUklWQVRFIEtFWS0tLS0tCk1IY0NBUUVFSURXQURoZUl0RVdHWlFCc0tCSUpZTTZPeDB5TmRHQ1JjTDBTMUtvYjRTZ25vQW9HQ0NxR1NNNDkKQXdFSG9VUURRZ0FFZm5wbDF6MkxhMlRUYmgycWtJSnhEYkF2YnZrQ1E1NENxTkhjSFZJdG8vR2FIeWdlckRFcgpyb1R2bDUzYVI2c2RIWW1saWFYVGcyV1FmNzlIQ0wvVGNBPT0KLS0tLS1FTkQgRUMgUFJJVkFURSBLRVktLS0tLQo= +root@WR768dbf76:~# + +``` + +If you want to use kubectl through another machine, you need to change the line `server: https://127.0.0.1:6443` to be `server: https://PLANETARYIP_OR_PUBLICIP/6443` +replace PLANETARYIP_OR_PUBLICIP with the IP you want to reach th cluster through. + + +## Manage Workers +Add or Remove workers in any **Kubernetes cluster**. + + +- Kubernetes DeployedList Weblet +![ ](./img/k8s_dl_1.png) + +- Manager kubernetes workers +![ ](./img/k8s_dl_2.png) + +- Add a new worker +![ ](./img/new_k8s4.png) + +- Successfully added new worker +![ ](./img/k8s_dl_4.png) + +- Delete a worker +![ ](./img/new_k8s5.png) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/mattermost.md b/collections/manual/documentation/dashboard/solutions/mattermost.md new file mode 100644 index 0000000..0e9528c --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/mattermost.md @@ -0,0 +1,55 @@ +

Mattermost

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Deployment](#deployment) + +*** + +## Introduction + +[Mattermost](https://mattermost.com/) A single point of collaboration. Designed specifically for digital operations. + +## Prerequisites + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Mattermost** + +## Deployment + +![ ](./img/solutions_mattermost.png) + +- Enter an Application Name. It's used in generating a unique subdomain on one of the gateways on the network alongside your twin ID. Ex. ***matter*.gent02.dev.grid.tf** + +- Select a capacity package: + - **Small**: {cpu: 1, memory: 2, diskSize: 15 } + - **Medium**: {cpu: 2, memory: 4, diskSize: 50 } + - **Large**: {cpu: 4, memory: 16, diskSize: 100 } + - Or choose a **Custom** plan +- `Dedicated` flag to retrieve only dedeicated nodes +- `Certified` flag to retrieve only certified nodes +- Choose the location of the node + - `Region` + - `Country` + - `Farm Name` + +- Choose the node to deploy on +> Or you can select a specific node with manual selection. +- `Custom Domain` flag lets the user to use a custom domain +- Choose a gateway node to deploy your Mattermost instance on. + + +- There's also an optional **SMTP Server** tab if you'd like to have your Mattermost instance configured with an SMTP server. + + ![ ](./img/mattermost3.png) + +After that is done you can see a list of all of your deployed instances + +![ ](./img/mattermost4.png) + +Click on ***Visit*** to go to the homepage of your Mattermost instance! You need to login using TFConnect so make sure you download the *TFConnect* app from your App Store. + +![ ](./img/mattermost5.png) diff --git a/collections/manual/documentation/dashboard/solutions/nextcloud.md b/collections/manual/documentation/dashboard/solutions/nextcloud.md new file mode 100644 index 0000000..d25dd79 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/nextcloud.md @@ -0,0 +1,207 @@ +

Nextcloud

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Domain Names and Public IPs](#domain-names-and-public-ips) +- [Deploy Nextcloud](#deploy-nextcloud) +- [Nextcloud Setup](#nextcloud-setup) +- [DNS Details](#dns-details) + - [DNS Record with Public IPv4](#dns-record-with-public-ipv4) + - [DNS Record with Gateway](#dns-record-with-gateway) + - [DNS Propagation](#dns-propagation) +- [Talk](#talk) + - [Install Talk](#install-talk) + - [TURN](#turn) + - [Use Talk](#use-talk) +- [Backups and Updates](#backups-and-updates) + - [Create a Backup](#create-a-backup) + - [Automatic Backups and Updates](#automatic-backups-and-updates) +- [Troubleshooting](#troubleshooting) + - [Retrieve the Nextcloud AIO Password](#retrieve-the-nextcloud-aio-password) + - [Access the Nextcloud Interface Page](#access-the-nextcloud-interface-page) + - [Check the DNS Propagation](#check-the-dns-propagation) +- [Questions and Feedback](#questions-and-feedback) + +*** + +# Introduction + +[Nextcloud](https://nextcloud.com/) is a suite of client-server software for creating and using file hosting services. + +Nextcloud provides functionality similar to Dropbox, Office 365 or Google Drive when used with integrated office suites like Collabora Online or OnlyOffice. + + + +# Prerequisites + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Nextcloud** + + + +# Domain Names and Public IPs + +A domain name is required to use Nextcloud. You can either use your own, which we'll call a *custom domain*, or you can get a free subdomain from a gateway node. This won't impact the function of your deployment, it's just a matter of preference. If you want to use your own domain, follow the steps for custom domain wherever you see them below. + +Another choice to make before launching your Nextcloud instance is whether you want to reserve a public IPv4 for the deployment. Renting a public IP is an extra cost and is only required for the dedicated Nextcloud Talk video conferencing backend, recommended for calls with more than four participants. If you don't reserve a public IP, you can still use Talk in a more limited fashion (see the [Talk](#talk) section below for details). + +If you're not sure and just want the easiest, most affordable option, skip the public IP and use a gateway domain. + + + +# Deploy Nextcloud + +* On the [ThreeFold Dashboard](https://dashboard.grid.tf/), click on solutions from the sidebar, then click on **Nextcloud** +* Choose a name for your deployment + * Note: You can use the auto-generated name if you want +* Select a capacity package: + * **Minimum**: {cpu: 2, memory: 4gb, diskSize: 50gb } + * **Standard**: {cpu: 2, memory: 8gb, diskSize: 500gb } + * **Recommended**: {cpu: 4, memory: 16gb, diskSize: 1000gb } + * Or choose a **Custom** plan +* If want to reserve a public IPv4 address, click on Network then select **Public IPv4** +* If you want a [dedicated](../deploy/dedicated_machines.md) and/or a certified node, select the corresponding option +* Choose the location of the node + * `Country` + * `Farm Name` +* Select a node +* If you want to use a custom domain, click on **Custom domain** under **Domain Name** and write your domain name + * Example: `nextcloudwebsite.com` +* The **Select gateway** box will be visible whenever a gateway is required. If so, click it and choose a gateway + * If you are also using a custom domain, you must set your DNS record now before proceeding. The IP of the gateway will appear on screen. Check [below](#set-the-dns-record) for more information +* Click **Deploy** + + + +# Nextcloud Setup + +Once the weblet is deployed, the details page will appear. If you are using a custom domain with a public IPv4, you'll need to set your DNS record now using the IP address shown under **Public IPv4**. Again, see [below](#dns-details) for details. + +Before you can access Nextcloud itself, you'll need to decide which addons you want to install and complete a setup step. This is done through the AIO interface that's included with your deployment. To access it, you can visit the **Nextcloud Setup** link shown in the details page, or click on the **Nextcloud Setup** button under **Actions** in the deployments list to set up Nextcloud. + +* Once you have access to the **Nextcloud AIO setup page**, you will be given a password composed of 8 words. + * Use this password to access the **Nextcloud AIO interface page**. + * Store this password somewhere safe. It's only possible to recover it by using SSH. +* On the next page, you can add **Optionals addons** if you want. +* Click on **Download and start containers** to start the Nextcloud instance. +* Once the containers are properly started, you can access the Nextcloud admin login page by clicking **Open your Nextcloud**. + * You will be given an **Initial Nextcloud user name** and an **Initial Nextcloud password**. Use these credentials to log into the admin page. + * Store these credentials somewhere safe. +* Later, if you want to access the Nextcloud admin login page, you can simply click on the button **Open Nextcloud** under **Actions** in the deployment list. + +The installation is now complete and you have access to your Nextcloud instance. + + + +# DNS Details + +## DNS Record with Public IPv4 + +After deployment, you will have access to the IPv4 address of the VM you deployed on. You will need to add a **DNS A record** (Host: "@", Value: ) to your domain to access Nextcloud. This record type indicates the IP address of a given domain. + +## DNS Record with Gateway + +Before starting the deployment, you will need to add a **DNS A record** (Host: "@", Value: ) to your domain. The gateway IP will be shown to you when you select this option. + +## DNS Propagation + +When setting your own custom domain, it might take time for DNS to propagate. It is possible that you see the following message when opening the Nextcloud page: + +>"This site can't be reached. DNS address could not be found. Diagnosing the problem." + +This is normal. You might simply need to wait for the DNS to propagate completely. + + + +# Talk + +If you don't rent a public IP with your deployement, it's still possible to use Nextcloud Talk in a more limited fashion. It's generally understood that this method can work well for up to four participants in a call, and text chat also works without restriction. For larger calls, the dedicated backend, which requires a public IP, is recommended. + +While some calls can go entirely peer-to-peer and don't require any setup beyond installing the Talk app, a TURN server can be helpful to relay data when a peer-to-peer connection can't be established. There's more information on TURN servers after the install instructions. + +## Install Talk + +To install Talk, do the following: + +* Open the dropdown menu at the top right of the Nextcloud page +* Click on **Apps** +* In the left-side menu, select **Social & communication** +* Scroll down and locate the Talk app +* Click on **Download and enable** + +Once the Talk app is downloaded and enabled, you can find its icon at the top bar menu. + +## TURN + +As mentioned before, TURN servers relay data to help call participants connect to each other. All data sent to TURN server is encrypted in this case, so it's perfectly safe to use a free public server. + +That said, such free servers are not common, because relaying video chat uses a lot of bandwidth. As of the time of writing, Open Relay Project is one example that includes [instructions for use with Nextcloud Talk](https://www.metered.ca/tools/openrelay/#turn-server-for-nextcloud-talk). + +TURN server configuration can be found by opening the Talk settings, like this: + +* Open the dropdown menu at the top right of the Nextcloud page +* Click on **Personal settings** +* In the left-side menu, select **Talk** + +## Use Talk + +Once you've installed Talk and optionally added a TURN server, you can use Talk to create video conferences. + +Note that the host of the video meeting might need to turn the VPN off before creating a new conversation. + + + +# Backups and Updates + +## Create a Backup + +In the section **Backup and restore**, you can set a [BorgBackup](https://www.borgbackup.org/) of your Nextcloud instance. + +* Add a mount point and a directory name for your backup (e.g. **/mnt/backup**) and click **Submit backup location**. +* After the creation of the backup location, write down the **encryption password for backups** somewhere safe and offline. +* Click **Create backup** to create a BorgBackup of your Nextcloud instance. + * This will stop all containers, run the backup container and create the backup. +* Once the backup is complete, you can click on **Start containers** to restart the Nextcloud instance. + +## Automatic Backups and Updates + +After the first manual backup of your Nextcloud instance is complete, you can set automatic backups and updates. + +* In the section **Backup and restore**, open the dropdown menu **Click here to reveal all backup options**. +* In the section **Daily backup and automatic updates**, choose a time for your daily backup and click **Submit backup time**. + * To set automatic updates, make sure that the option **Automatically update all containers, the mastercontainer and on** is selected. + + + +# Troubleshooting + +## Retrieve the Nextcloud AIO Password + +You can retrieve the Nextcloud AIO password (8 words) by writing the following command line on the VM hosting your Nextcloud instance: + +``` +cat /mnt/data/docker/volumes/nextcloud_aio_mastercontainer/_data/data/configuration.json | grep password +``` + +## Access the Nextcloud Interface Page + +To access the Nextcloud interface page, follow those stepse + +* Open your Nextcloud instance +* In the top right Profile menu, select **Administration Settings** +* Under **Nextcloud All-in-One**, click **Open Nextcloud AIO Interface** + + + +## Check the DNS Propagation + +You can check if the DNS records are propagated globally with DNS propagation check services such as [DNS Checker](https://dnschecker.org/). You can use this tool to verify that your domain is properly pointing to the IPv4 address of the VM you deployed on. + + + +# Questions and Feedback + +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. \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/nixos_micro.md b/collections/manual/documentation/dashboard/solutions/nixos_micro.md new file mode 100644 index 0000000..41f8932 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/nixos_micro.md @@ -0,0 +1,66 @@ +

NixOS MicroVM

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Access the ThreeFold Dashboard](#access-the-threefold-dashboard) +- [Deploy a NixOS MicroVM](#deploy-a-nixos-microvm) +- [Questions and Feedback](#questions-and-feedback) + +*** + +## Introduction + +__NixOS MicroVM__ refers to a minimalistic virtual machine environment based on the NixOS Linux distribution. +The NixOS MicroVM leverages these principles to create a highly customizable and reproducible virtual machine environment. It allows users to define the entire system configuration, including packages, services, and dependencies, in a declarative manner using the Nix language. This ensures that the MicroVM is consistent, easily reproducible, and can be version-controlled. + +In this guide, will learn how to make reproducible, declarative and reliable systems by deploying a NixOS MicroVM weblet in ThreeFold Dashboard. + +For more information on Nix, you can read the [Nix Reference Manual](https://nixos.org/manual/nix/stable/). + +## Access the ThreeFold Dashboard + +* Go to the ThreeFold Dashboard website, based on the deployment network you prefer: + * [Mainnet](https://dashboard.grid.tf) + * [Testnet](https://dashboard.test.grid.tf) + * [Devnet](https://dashboard.dev.grid.tf) + * [QAnet](https://dashboard.qa.grid.tf) + +* Make sure you have a [wallet](../wallet_connector.md) +* From the sidebar click on **Solutions** +* Click on **Micro Virtual Machine** to start your NixOS MicroVM Deployment + + + +## Deploy a NixOS MicroVM + +We now present the main steps to properly configure your NixOS MicroVM running on the TFGrid. + +* In the section `Config`, make sure to select `Nixos` as the `VM Image`. You can choose different parameters (CPU, Memory, etc.) for your deployment depending on your workload needs. + +![](./img/nxios-micro1.png) + +* In the section `Environment Variables`, you can add the default configurations for Nix. Here's an example: + * ``` + { pkgs ? import { } }: + let pythonEnv = pkgs.python3.withPackages(ps: [ ]); in pkgs.mkShell { packages = [ pythonEnv ]; } + ``` + * This will be written to `/root/default.nix`. You can change the Nix shell configuration there. + +![](./img/nixos-micro2.png) + +* In the section `Disks`, you should mount a disk large enough for Nix to store its files used for `nix-store`. + +![](./img/nixos-micro3.png) + +* Once your configured the parameters, you can deploy the MicroVM. + +If you need more information on how to SSH into your deployment, read [this section](../../system_administrators/getstarted/tfgrid3_getstarted.md) of the TF Manual. + + + +## Questions and Feedback + +You should now be able to easily deploy a NixOS MicroVM on the ThreeFold Grid. + +If you have any question or feedback, you can write a post on the [ThreeFold Forum](http://forum.threefold.io/). \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/nodepilot.md b/collections/manual/documentation/dashboard/solutions/nodepilot.md new file mode 100644 index 0000000..1fc212a --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/nodepilot.md @@ -0,0 +1,52 @@ +

NodePilot

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Deployment](#deployment) + +*** + +## Introduction + +This is a simple instance of upstream [Node Pilot](https://nodepilot.tech). + +## Prerequisites + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Node Pilot** + +## Deployment + +![ ](./img/solutions_nodepilot.png) + +- Fill in the instance name: it's used to reference the node-pilot in the future. + +- Minimum CPU allowed is 8 cores and minimum memory allowed is 8192. + +- `Dedicated` flag to retrieve only dedeicated nodes +- `Certified` flag to retrieve only certified nodes + +- Choose the location of the node + - `Region` + - `Country` + - `Farm Name` +- Select a node to deploy your node-pilot instance on. + +> Or you can select a specific node with manual selection. + +- When using the [flist](https://hub.grid.tf/tf-official-vms/node-pilot-zdbfs.flist) you get a node pilot instance ready out-of-box. You need to get a public ipv4 to get it to works. + +After that is done you can see a list of all of your deployed instances + +![ ](./img/nodeP_2.png) + +Click on ***Visit*** to go to the registration page of your Node Pilot instance! + +![ ](./img/nodePilot_3.png) + +You can go to `https://publicip` and configure your node-pilot. You can upload a backup to the VM via ssh as well if you have a backup of a previous instance. + +What change compared to upstream node-pilot, we have out-of-box a transparent pre-filled blockchain database for some blochain (currently Fuse and Pokt as proof-of-concept). You can start one of theses blockchain in no-time and it will be automatically nearly sync already without the requirement of the full space locally nor downloading everything and killing bandwidth. diff --git a/collections/manual/documentation/dashboard/solutions/owncloud.md b/collections/manual/documentation/dashboard/solutions/owncloud.md new file mode 100644 index 0000000..16726a0 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/owncloud.md @@ -0,0 +1,86 @@ +

ownCloud

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Deploy ownCloud](#deploy-owncloud) + - [Base](#base) + - [SMTP](#smtp) + - [List of Instances](#list-of-instances) +- [Admin Connection](#admin-connection) +- [TFConnect App Connection](#tfconnect-app-connection) + +*** + +## Introduction + +[ownCloud](https://owncloud.com/) develops and provides open-source software for content collaboration, allowing teams to easily share and work on files seamlessly regardless of device or location. + +## Prerequisites + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Solutions** +- Click on **ownCloud** + +## Deploy ownCloud + +![ ](./img/owncloud1.png) + +### Base + +- Enter an ownCloud deployment name. + - The name is used in generating a unique subdomain on one of the gateways on the network alongside your twin ID. + - Ex. ***oc98newcloud*.gent02.dev.grid.tf** + +- Enter administrator information including **Username** and **Password**. + - This admin user will have full permission on the deployed instance. +- Select a capacity package: + - **Small**: {cpu: 2, memory: 8, diskSize: 250 } + - **Medium**: {cpu: 2, memory: 16, diskSize: 500 } + - **Large**: {cpu: 4, memory: 32, diskSize: 1000 } + - Or choose a **Custom** plan +- Choose the network + - `Public IPv4` flag gives the virtual machine a Public IPv4 +- Enable the `Dedicated` flag to retrieve only dedicated nodes +- Enable the `Certified` flag to retrieve only certified nodes +- Choose the location of the node + - `Region` + - `Country` + - `Farm Name` +- Choose the node to deploy on +> Or you can select a specific node with manual selection. +- Enable the `Custom Domain` flag to use a custom domain +- Choose a gateway node to deploy your ownCloud instance on. + +Once you've set the deployment parameters, you can click on **Deploy**. + +### SMTP + +On the SMTP window, you can enable the optional `SMTP Server` flag if you want to have your ownCloud instance configured with an SMTP server. + +![ ](./img/owncloud4.png) + +### List of Instances + +When the deployment is ready, you will see a list of all of your deployed instances. + +![ ](./img/owncloud5.png) + +## Admin Connection + +Click on the button **Visit** under **Actions** to open the ownCloud login window. If you see **bad gateway**, you might simply need to wait a couple of minutes until the deployment completes. + +![ ](./img/solutions_owncloud_visit.png) + +To consult the deployment details, click on the button **Details** under **Actions**. On this page, you can access the **ownCloud Admin Username** and the **ownCloud Admin Password**. Use those credentials to log in as an administrator on your ownCloud deployment. + +![ ](./img/owncloud6.png) + +## TFConnect App Connection + +To connect to your ownCloud instance with the ThreeFold Connect app, you need to add permissions to your ThreeFold 3Bot ID by first [connecting as an administrator](#admin-connection). + +- Once you're connected as an admin, open the top-right menu and click on **Users**. +- To create a new user, set your 3Bot ID as the username with its corresponding email address, and set **Groups** as **admin**. Then click **Create**. +- You can now log out and connect to your ownCloud instance with the TF Connect app. \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/peertube.md b/collections/manual/documentation/dashboard/solutions/peertube.md new file mode 100644 index 0000000..79a74ee --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/peertube.md @@ -0,0 +1,59 @@ +

Peertube

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Deployment](#deployment) + +*** + +## Introduction + +[Peertube](https://joinpeertube.org/) aspires to be a decentralized and free/libre alternative to video broadcasting services. + +## Prerequisites + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Peertube** + +## Deployment + +![ ](./img/solutions_peertube.png) + +- Enter an Application Name. It's used in generating a unique subdomain on one of the gateways on the network alongside your twin ID. + the applied format `.` Ex. ***pt100peerprod*.gent02.dev.grid.tf** +- Enter an email and password which will be used for the admin login. +- Select a capacity package: + - **Small**: { cpu: 1, memory: 2, diskSize: 15 } + - **Medium**: { cpu: 2, memory: 4, diskSize: 100 } + - **Large**: { cpu: 4, memory: 16, diskSize: 250 } + - Or choose a **Custom** plan + + - `Public IPv4` flag gives the virtual machine a Public IPv4 + - `Public IPv6` flag gives the virtual machine a Public IPv6 + - `Planetary Network` to connect the Virtual Machine to Planetary network + - `Wiregaurd Access` to add a wiregaurd acces to the Virtual Machine +- `Dedicated` flag to retrieve only dedeicated nodes +- `Certified` flag to retrieve only certified nodes +- Choose the location of the node + - `Region` + - `Country` + - `Farm Name` + +- Choose the node to deploy on +> Or you can select a specific node with manual selection. +- `Custom Domain` flag lets the user to use a custom domain +- Choose a gateway node to deploy your Peertube instance on. + +After that is done you can see a list of all of your deployed instances + + +![ ](./img/weblet_peertube_listing.png) + +Click on ***Visit*** to go to the homepage of your Peertube instance! + +![ ](./img/weblet_peertube_instance.png) + +> Please note it may take sometime to be ready \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/presearch.md b/collections/manual/documentation/dashboard/solutions/presearch.md new file mode 100644 index 0000000..c0c3f55 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/presearch.md @@ -0,0 +1,98 @@ +

Presearch

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Deploy a Presearch Node](#deploy-a-presearch-node) +- [Migrate an Existing Presearch Node to the TFGrid](#migrate-an-existing-presearch-node-to-the-tfgrid) +- [Verify if a 3Node Already Runs a Presearch Workload](#verify-if-a-3node-already-runs-a-presearch-workload) +- [Learn More About Presearch](#learn-more-about-presearch) +- [Questions and Feedback](#questions-and-feedback) + +*** + +## Introduction + +[Presearch](https://www.presearch.io/) is a community-powered, decentralized search engine that provides better results while protecting your privacy and rewarding you when you search. This weblet deploys a Presearch node. Presearch Nodes are used to process user search requests, and node operators earn Presearch PRE tokens for joining and supporting the network. + +## Prerequisites + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Presearch** + +## Deploy a Presearch Node + +![ ](./img/solutions_presearch.png) + +- Enter an instance name. + +- You need to sign up on Presearch in order to get your *Presearch Registration Code*. To sign up, go to the [Presearch](https://presearch.com) website, create your account and then head to your [dashboard](https://nodes.presearch.com/dashboard) to find your registration code. + +- Choose the network + - `Public IPv4` flag gives the virtual machine a Public IPv4 + - `Planetary Network` to connect the Virtual Machine to Planetary network + +- `Dedicated` flag to retrieve only dedeicated nodes +- `Certified` flag to retrieve only certified nodes +- Choose the location of the node + - `Region` + - `Country` + - `Farm Name` + +- Choose the node to deploy the Virtual Machine on +> Or you can select a specific node with manual selection. + +## Migrate an Existing Presearch Node to the TFGrid + +Now what if you already have a Presearch node deployed somewhere and would like to migrate to Threefold? + +We got you! All you need to do is: + +1. Login to your old server that has your node via SSH. +2. Run `docker cp presearch-node:/app/node/.keys presearch-node-keys` in order to generate your key-pair. +3. Head to the *Restore* tab in the Presearch weblet and paste your key-pair in the fields below and you'll be good to deploy! + +![ ](./img/presearch6.png) + +After that is done you can see a list of all of your deployed instances + +![ ](./img/presearch4.png ) + +Now head to your [dashboard](https://nodes.presearch.com/dashboard) again and scroll down to **Current Nodes**, you'll see your newly created node up and connected! + +![ ](./img/presearch5.png) + + +## Verify if a 3Node Already Runs a Presearch Workload + +You can do the following to verify if a Presearch workload deployed without a public IP address already has a Presearch workload running. Note that you will first need to deploy a Presearch workload on the 3Node. After deployment, you can SSH into the VM and do the verification. + +* SSH into the VM running the Presearch workload + * ``` + ssh root@ + ``` +* List running containers and identity the Presearch container + * ``` + docker ps + ``` +* Print the logs of the Presearch container + * ``` + docker logs + ``` +* If there is no other Presearch workload running on the 3Node, you will see a similar output: + * > 2023-10-16T12:18:33.780Z info: Node is listening for searches... +* If there is another Presearch workload running on the 3Node, you will see a similar output: + * > 2023-10-16T12:24:00.346Z error: Duplicate IP: This IP Address is already running another Node. Only one Node is permitted per IP Address. + * If there is another Presearch workload running, you will need to either deploy on another 3Node with a public IP or deploy on another node without a public IP that isn't running a Presearch deployment. + + + +## Learn More About Presearch + +To learn more about Presearch, you can read the [Presearch documentation](https://docs.presearch.io/). + +## Questions and Feedback + +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. \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/solutions.md b/collections/manual/documentation/dashboard/solutions/solutions.md new file mode 100644 index 0000000..60732e3 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/solutions.md @@ -0,0 +1,29 @@ +

Solutions

+ +This section provides a non-code easy way to deploy a whole solution on the TFGrid. + +

Table of Contents

+ +- [Basic Environments](./basic_environments_readme.md) + - [Virtual Machines](./vm_intro.md) + - [Micro and Full VM Differences](./vm_differences.md) + - [Full Virtual Machine](./fullVm.md) + - [Micro Virtual Machine](./vm.md) + - [Kubernetes](./k8s.md) + - [NixOS MicroVM](./nixos_micro.md) +- [Ready Community Solutions](./ready_community_readme.md) + - [Caprover](./caprover.md) + - [Funkwhale](./funkwhale.md) + - [Peertube](./peertube.md) + - [Taiga](./taiga.md) + - [Owncloud](./owncloud.md) + - [Nextcloud](./nextcloud.md) + - [Discourse](./discourse.md) + - [Mattermost](./mattermost.md) + - [Presearch](./presearch.md) + - [CasperLabs](./casper.md) + - [Node Pilot](./nodepilot.md) + - [Subsquid](./subsquid.md) + - [Algorand](./algorand.md) + - [Wordpress](./wordpress.md) + - [Umbrel](./umbrel.md) diff --git a/collections/manual/documentation/dashboard/solutions/subsquid.md b/collections/manual/documentation/dashboard/solutions/subsquid.md new file mode 100644 index 0000000..063ff35 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/subsquid.md @@ -0,0 +1,54 @@ +

Subsquid

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Deployment](#deployment) + +*** + +## Introduction + +[Subsquid](https://www.subsquid.io/) indexer is a piece of software that reads all the blocks from a Substrate based blockchain, decodes and stores them for processing in a later stage. + +## Prerequisites + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Subsquid** + +## Deployment + +![ ](./img/solutions_subsquid.png) + +- Enter an instance name. + +- Enter an endpoint for a supported substrate chain. You can find the list of endpoints of supported cahins [here](https://github.com/polkadot-js/apps/blob/master/packages/apps-config/src/endpoints/production.ts). + + +- Select a capacity package: + - **Small**: {cpu: 1, memory: 2 , diskSize: 50 } + - **Medium**: {cpu: 2, memory: 4, diskSize: 100 } + - **Large**: {cpu: 4, memory: 16, diskSize: 250 } + - Or choose a **Custom** plan + +- `Dedicated` flag to retrieve only dedeicated nodes +- `Certified` flag to retrieve only certified nodes +- Choose the location of the node + - `Region` + - `Country` + - `Farm Name` +- Choose the node to deploy on +> Or you can select a specific node with manual selection. +- `Custom Domain` flag lets the user to use a custom domain +- Choose a gateway node to deploy your Subsquid instance on. + + +After that is done you can see a list of all of your deployed instances + +![ ](./img/subsquid_list.png) + +Click on ***Visit*** to go to the homepage of your Subsquid indexer instance! + +![ ](./img/subsquid_graphql.png) diff --git a/collections/manual/documentation/dashboard/solutions/taiga.md b/collections/manual/documentation/dashboard/solutions/taiga.md new file mode 100644 index 0000000..4291e12 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/taiga.md @@ -0,0 +1,57 @@ +

Taiga

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Deployment](#deployment) + +*** + +## Introduction + +[Taiga](https://www.taiga.io/) is the project management tool for multi-functional agile teams. It has a rich feature set and at the same time it is very simple to start with through its intuitive user interface. + +## Prerequisites + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Taiga** + +## Deployment + +![ ](./img/solutions_taiga.png) + +- Enter an Application Name. It's used in generating a unique subdomain on one of the gateways on the network alongside your twin ID. Ex. ***tg98taigar*.gent02.dev.grid.tf** + +- Enter administrator information including **Username**, **Email** and **Password**. This admin user will have full permission on the deployed instance. +- Select a capacity package: + - **Small**: {cpu: 2, memory: 4, diskSize: 100 } + - **Medium**: {cpu: 4, memory: 8, diskSize: 150 } + - **Large**: {cpu: 4, memory: 16, diskSize: 250 } + - Or choose a **Custom** plan + +- `Dedicated` flag to retrieve only dedeicated nodes +- `Certified` flag to retrieve only certified nodes +- Choose the location of the node + - `Region` + - `Country` + - `Farm Name` +- Choose the node to deploy the Tiaga instance on +> Or you can select a specific node with manual selection. +- `Custom Domain` flag lets the user to use a custom domain +- Choose a gateway node to deploy your Funkwhale instance on. + + + +There's also an optional **Mail Server** tab if you'd like to have your Taiga instance configured with an SMTP server. + +![ ](./img/taiga4.png) + +After that is done you can see a list of all of your deployed instances + +![ ](./img/taiga5.png) + +Click on ***Visit*** to go to the homepage of your Taiga instance! + +![ ](./img/taiga6.png) diff --git a/collections/manual/documentation/dashboard/solutions/umbrel.md b/collections/manual/documentation/dashboard/solutions/umbrel.md new file mode 100644 index 0000000..21075ca --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/umbrel.md @@ -0,0 +1,60 @@ +

Umbrel

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) + +*** + +## Introduction + +[Umbrel](https://umbrel.com/) is an OS for running a personal server in your home. Self-host open source apps like Nextcloud, Bitcoin node, and more. + +## Prerequisites + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Applications** +- Click on **Umbrel** + +**Process** : +![Config](./img/solutions_umbrel.png) + +- Enter an instance name. +- Enter a Username + - will be used to create Umbrel dashboard account. +- Enter a Password + - Will be used to login to the Umbrel dashboard. + - Must be 12 to 30 characters . +- Select a capacity package: + - **Small**: { cpu: 1, memory: 2, diskSize: 10 } + - **Medium**: { cpu: 2, memory: 4 , diskSize: 50 } + - **Large**: { cpu: 4, memory: 16 , diskSize: 100 } + - Or choose a **Custom** plan + +- `Dedicated` flag to retrieve only dedeicated nodes +- `Certified` flag to retrieve only certified nodes +- Choose the location of the node + - `Region` + - `Country` + - `Farm Name` +- Choose the node to deploy the Umbrel instance on +> Or you can select a specific node with manual selection. + +**After Deploying**: + +You can see a list of all of your deployed instances + +![ ](./img/umbrel2.png) + +- you can click on `Show details` for more details about the Umbrel deployment. + ![ ](./img/umbrel3.png) + and for more detailed information switch to `JSON` tap. + ![ ](./img/umbrel4.png) +- Click on ***Admin Panel*** to go to the dashboard of your Umbrel instance! + - Enter the ***Password*** that you provided in `config` section to login into Umbrel dashboard. + > Forget the credentials? You can find them with `Show details` button. + +![ ](./img/umbrel5.png) + +> **Warning**: Due to the nature of the grid, shutdown, or restart your umbrel from the dashboard **MAY** make some unwanted behaviors. diff --git a/collections/manual/documentation/dashboard/solutions/vm.md b/collections/manual/documentation/dashboard/solutions/vm.md new file mode 100644 index 0000000..5e8db2f --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/vm.md @@ -0,0 +1,62 @@ +

Micro Virtual Machine

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Deployment](#deployment) + +*** + +## Introduction + +We present the steps to deploy a micro VM on the TFGrid. + + +## Deployment + +Deploy a new virtual machine on the Threefold Grid + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Solutions** +- Click on **Micro Virtual Machine** + +__Process__ : + +![ ](./img/solutions_microvm.png) + +- Fill in the instance name: it's used to reference the VM in the future. +- Choose the image from the drop down (e.g Alpine, Ubuntu) or you can click on `Other` and manually specify the flist URL and the entrypoint. +- Select a capacity package: + - **Small**: {cpu: 1, memory: 2, diskSize: 25 } + - **Medium**: {cpu: 2, memory: 4, diskSize: 50 } + - **Large**: {cpu: 4, memory: 16, diskSize: 100} + - Or choose a **Custom** plan +- Choose the network + - `Public IPv4` flag gives the virtual machine a Public IPv4 + - `Public IPv6` flag gives the virtual machine a Public IPv6 + - `Planetary Network` to connect the Virtual Machine to Planetary network + - `Wireguard Access` to add a wireguard acces to the Virtual Machine +- `GPU` flag to add GPU to the Virtual machine +- `Dedicated` flag to retrieve only dedicated nodes +- `Certified` flag to retrieve only certified nodes +- Choose the location of the node + - `Region` + - `Country` + - `Farm Name` +- Choose the node to deploy the Virtual Machine on +> Or you can select a specific node with manual selection. + +![](./img/nixos-micro2.png) +* In the section `Environment Variables`, you can add any environment variables that the machine might need + +![](./img/nixos-micro3.png) + +* In the section `Disks`, You can attach one or more disks to the Virtual Machine by clicking on the Disks tab and the plus `+` sign and specify the following parameters + - Disk name + - Disk size + +in the bottom of the page you can see a list of all of the virual machines you deployed. you can click on `Show details` for more details + +![](./img/vm_list.png) +You can also go to JSON tab for full details +![ ](./img/vm_json.png) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/vm_differences.md b/collections/manual/documentation/dashboard/solutions/vm_differences.md new file mode 100644 index 0000000..a6dff11 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/vm_differences.md @@ -0,0 +1,29 @@ +

Micro and Full VM Differences

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Micro Virtual Machine](#micro-virtual-machine) +- [Full Virtual Machine](#full-virtual-machine) + +*** + +## Introduction + +We present the main differences between a micro VM and a full VM. This is useful information when it comes to choosing the proper deployment on the TFGrid. + +## Micro Virtual Machine + +- It's meant to host microservice. and the user should enter the entrypoint. +- The user has no control over ther kernel used to run the machine. +- The network setup will be created for the user. And the vm's init process can assume that it will be fully set up (according to the config the user provided) by the time it is started. +- Mountpoints will also be setup for the user. The environment variables passed will be available inside the the vm. + +## Full Virtual Machine + +- The users run their own operating system, but the image must be + - EFI bootable + - Cloud-init enabled +- It contains a default disk attached, as the boot image will be copied to this disk. +- The default disk is mounted on / so if you want to attach any additional disks, you have to choose a different mounting point. +- A /image.raw file is used as "boot disk". This /image.raw is copied to the first attached volume of the vm. Cloud-init will take care of resizing the filesystem on the image to take the full disk size allocated in the deployment. \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/vm_intro.md b/collections/manual/documentation/dashboard/solutions/vm_intro.md new file mode 100644 index 0000000..d9cc0a7 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/vm_intro.md @@ -0,0 +1,11 @@ +

Virtual Machines

+ +On the TFGrid, you can deploy both micro and full virtual machines. + +

Table of Contents

+ +- [Micro and Full VM Differences ](./vm_differences.md) +- [Full Virtual Machine](./fullVm.md) +- [Micro Virtual Machine](./vm.md) +- [Nixos MicroVM](./nixos_micro.md) +- [Add a Domain](./add_domain.md) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/solutions/wordpress.md b/collections/manual/documentation/dashboard/solutions/wordpress.md new file mode 100644 index 0000000..57f2938 --- /dev/null +++ b/collections/manual/documentation/dashboard/solutions/wordpress.md @@ -0,0 +1,147 @@ +

WordPress

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Domain Name and IP Address](#domain-name-and-ip-address) +- [DNS Details with Custom Domain](#dns-details-with-custom-domain) + - [DNS Record with Public IPv4](#dns-record-with-public-ipv4) + - [DNS Record with Gateway](#dns-record-with-gateway) + - [DNS Propagation](#dns-propagation) +- [Deployment Process](#deployment-process) +- [Access WordPress](#access-wordpress) + - [WordPress Instance Website](#wordpress-instance-website) + - [WordPress Instance Admin Page](#wordpress-instance-admin-page) +- [WordPress Instance Credentials](#wordpress-instance-credentials) +- [Questions and Feedback](#questions-and-feedback) + +*** + +# Introduction + +[WordPress](https://wordpress.org/) is the most popular CMS on the market, powering 65.2% of websites whose CMS we know. That translates to 42.4% of all websites – nearly half of the internet. It is a popular option for those who want to build a website or a blog. + +# Prerequisites + +- Make sure you have a [wallet](../wallet_connector.md) +- From the sidebar click on **Solutions** +- Click on **Wordpress** + +# Domain Name and IP Address + +A domain name is required to use WordPress. You can either use your own, which we'll call a **custom domain**, or you can get a free subdomain from a gateway node. Note that this won't impact the function of your deployment, it's just a matter of preference. If you want to use your own domain, follow the steps for custom domain wherever you see them below. + +Another choice to make before launching your WordPress instance is whether you want to reserve a public IPv4 for the deployment. Note that renting a public IPv4 address is an extra cost. If you do not enable IPv4, the deployment will be provided a gateway IPv4 address. + +If you're not sure and just want the easiest, most affordable option, do not enable public IPv4 nor custom domain. + +# DNS Details with Custom Domain + +In this section, we cover the essential DNS information when deploying a WordPress instance with a custom domain. + +You can skip this section if you did not enable **Custom Domain** in **Domain Name**. + +As a general reference, here is what setting a DNS A record can look like: + +![ ](img/wp11.png) + +This record type indicates the IP address of a given domain. + +## DNS Record with Public IPv4 + +Consider the following if you've enabled **Custom Domain** in **Domain Name** and **Public IPv4** in **Network**. + +After deployment, you will have access to the IPv4 address of the VM you deployed on. You will need to add a **DNS A record** (Host: "@", Value: ) to your domain to access WordPress. + +## DNS Record with Gateway + +Consider the following if you've enabled **Custom domain** in **Domain Name** but did not enable **Public IPv4** in **Network**. + +Before deploying the WordPress instance, you will have access to the gateway IPv4 address. You will need to add a **DNS A record** (Host: "@", Value: ) to your domain to access WordPress. + +## DNS Propagation + +When setting a DNS A record, it might take time for the DNS to propagate. It is possible that you see the following message when opening the WordPress page: + +>"This site can't be reached. DNS address could not be found. Diagnosing the problem." + +This is normal. You might simply need to wait for the DNS to propagate completely. + +You can check if the DNS records are propagated globally with DNS propagation check services such as [DNS Checker](https://dnschecker.org/). You can use this tool to verify that your domain is properly pointing to either the VM or the gateway IPv4 address. + +# Deployment Process + +In this section, we cover the steps to deploy a WordPress instance on the Playground. + +![Config](./img/solutions_wordpress.png) + +- Enter an instance name or leave the auto-generated instance name +- Enter the admin information or leave the auto-generated information + - **Username**: This will be used as the MySQL DB username and for Wp-admin + - **Password**: This will be used as the MySQL DB password and for Wp-admin + - **Email**: This will be used for Wp-admin +- Select a capacity package: + - **Small**: { cpu: 1, memory: 2 , diskSize: 15 } + - **Medium**: { cpu: 2, memory: 4 , diskSize: 50 } + - **Large**: { cpu: 4, memory: 16 , diskSize: 100 } + - Or choose a **Custom** plan + +- Choose the network + - **Public IPv4** flag gives the virtual machine a Public IPv4 + +- **Dedicated** flag to retrieve only dedicated nodes +- **Certified** flag to retrieve only certified nodes +- Choose the location of the node + - **Country** + - **Farm Name** +- Choose the node to deploy the WordPress instance on +- **Custom Domain** flag lets the user to use a custom domain +- Choose a gateway node to deploy your WordPress instance on + - If you've enabled IPv4, you do not need to choose a gateway node + +# Access WordPress + +In the section **WordPress Instances**, you can see a list of all of your deployed instances: + +![ ](./img/wp2.png) + +You can click on **Show details** under **Actions** for more details about the WordPress deployment. + +![ ](img/wp8.png) + +![ ](img/wp3.png) + +For more detailed information, you can switch to the **Json** tab. + +![ ](img/wp4.png) + +## WordPress Instance Website + +Click on **Visit** under **Actions** to go to the homepage of your WordPress instance. + +![ ](img/wp10.png) + +![ ](img/wp5.png) + +## WordPress Instance Admin Page + +Click on **Admin Panel** to go to the WordPress admin page (**wp-admin**) of your WordPress instance. + +![ ](img/wp9.png) + +Enter the **Username** and the **Password** that you provided in the **config** section to log into the admin panel. + +![ ](img/wp6.png) + +![ ](img/wp7.png) + +# WordPress Instance Credentials + +At any time, you can find the credentials of your WordPress instance by clicking on the **Show details** button under **Actions**. + +![ ](img/wp8.png) + +# Questions and Feedback + +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. diff --git a/collections/manual/documentation/dashboard/tfchain/tf_dao.md b/collections/manual/documentation/dashboard/tfchain/tf_dao.md new file mode 100644 index 0000000..648280b --- /dev/null +++ b/collections/manual/documentation/dashboard/tfchain/tf_dao.md @@ -0,0 +1,41 @@ +

DAO Voting

+ +The TFChain DAO (i.e. Decentralized Autonomous Organization) feature integrates decentralized governance capabilities into the ThreeFold Dashboard. It enables community members to participate in decision-making processes and to contribute to the evolution of the ThreeFold ecosystem. Through the TFChain DAO, users can propose, vote on, and implement changes to the network protocols, policies, and operations, fostering a collaborative and inclusive environment. + +

Table of Contents

+ +- [An Introduction to the DAO concept](#an-introduction-to-the-dao-concept) +- [Prerequisites to Vote](#prerequisites-to-vote) +- [How to Vote for a Proposal](#how-to-vote-for-a-proposal) +- [The Goal of the Threefold DAO](#the-goal-of-the-threefold-dao) + +*** + +## An Introduction to the DAO concept + +[A decentralized autonomous organization (DAO)](../../../knowledge_base/about/dao/dao.md) is an entity with no central leadership. Decisions get made from the bottom-up, governed by a community organized around a specific set of rules enforced on a blockchain. + +DAOs are internet-native organizations collectively owned and managed by their members. They have built-in treasuries that are only accessible with the approval of their members. Decisions are made via proposals the group votes on during a specified period. + + + +## Prerequisites to Vote + +Voting for a DAO proposal is very simple. You first need to meet certain requirements to be able to vote. + +- Have a [Threefold farm](../farms/farms.md) +- Have at least one active [3node server](../../farmers/3node_building/3node_building.md) on the farm +- If you created your farm with the Threefold Connect app + - [Import your farm on the Threefold Dashboard](../../threefold_token/storing_tft/tf_connect_app.md#move-farm-from-the-tf-connect-app-to-the-tf-portal-polkadotjs) + + + +## How to Vote for a Proposal + +To vote, you need to log into your Threefold Dashboard account, go to **TF DAO** section of **TFChain** and vote for an active proposal. Make sure to read the proposition and ask questions on the Threefold Forum proposition post if you have any. + +## The Goal of the Threefold DAO + +The goal of DAO voting system is to gather the thoughts and will of the Threefold community and build projects that are aligned with the ethos of the project. + +We encourage anyone to share their ideas. Who knows? Your sudden spark of genius might lead to an accepted proposal on the Threefold DAO! diff --git a/collections/manual/documentation/dashboard/tfchain/tf_minting_reports.md b/collections/manual/documentation/dashboard/tfchain/tf_minting_reports.md new file mode 100644 index 0000000..158ba04 --- /dev/null +++ b/collections/manual/documentation/dashboard/tfchain/tf_minting_reports.md @@ -0,0 +1,5 @@ +# TF Minting Reports + +TFGrid Minting Explorer, works by simply entering a receipt hash and you will get full minting report in return. + +![](../img/Minting.png) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/tfchain/tf_token_bridge.md b/collections/manual/documentation/dashboard/tfchain/tf_token_bridge.md new file mode 100644 index 0000000..f7391c2 --- /dev/null +++ b/collections/manual/documentation/dashboard/tfchain/tf_token_bridge.md @@ -0,0 +1,44 @@ +# TF Token Bridge + +Transferring TFT between Stellar and Tfchain + +## Usage + +This document will explain how you can transfer TFT from Tfchain to Stellar and back. + +![bridge page](../img/bridge.png) + +## Prerequisites + +- Stellar wallet + +- Account on TFchain (use TF Dashboard to create one). + +## Stellar to Tfchain + +You can deposit to Tfchain using the bridge page on the TF Dashboard + +A deposit of tokens from the Stellar network onto TF-Chain needs to happen from a Stellar wallet, like in the ThreeFold Connect App. + +You have 2 options: + +- TFT needs to be sent to the bridge account +- specifying in the memo field the twinID that was generated with the Twin creation e.g. twin_110 (dont forget twin_) +- Note there is a transaction cost of 1 TFT. + +Or + +- You can scan the QR code + +![bridge](../img/bridge_deposit.png) + +## Tfchain to Stellar + +You can bridge back to stellar using the bridge page on the dashboard, click *withdraw*: + +After indicating the destination address and the amount to be transferred, click *Send*. + +![withdraw](../img/bridge_withdraw.png) + +A withdraw fee of 1 TFT will be taken, so make sure you send a larger amount as 1 TFT. +The amount withdrawn from TFChain will be sent to your Stellar wallet. diff --git a/collections/manual/documentation/dashboard/tfchain/tf_token_transfer.md b/collections/manual/documentation/dashboard/tfchain/tf_token_transfer.md new file mode 100644 index 0000000..733eff6 --- /dev/null +++ b/collections/manual/documentation/dashboard/tfchain/tf_token_transfer.md @@ -0,0 +1,26 @@ +# TF Token Transfer + +Manage your TFT on TFChain. + +## Transfer TFT between TFChain accounts + +You can transfer TFTs between two accounts that exist on the same chain. + +> Remark: testnet and mainnet both have the same TFTs but as the 2 chains are different, there is no way to do a direct transfer between accounts on testnet and on mainnet. + +You can transfer TFTs by recipient address or recipient twin id; by selecting the needed tab. + + +### Transfer by twin id + +Fill in the recipient twin id, the amount of tokens to transfer, and click on `Send`. + +![](../img/dashboard_transfer_twin.png) + +### Transfer by address + +Fill in the recipient address, the amount of tokens to transfer, and click on `Send`. + +![](../img/dashboard_transfer_address.png) + +There is no transfer fee, just a signing fee of `0.001` TFT. diff --git a/collections/manual/documentation/dashboard/tfchain/tfchain.md b/collections/manual/documentation/dashboard/tfchain/tfchain.md new file mode 100644 index 0000000..bda6640 --- /dev/null +++ b/collections/manual/documentation/dashboard/tfchain/tfchain.md @@ -0,0 +1,20 @@ +# TFChain + +Here you will find everything related to the ThreeFold chain. this includes: + +- Detailed account information from the [Your Profile](./your_profile.md) section. +- Information about what DAO is and how to vote on DAO proposals from the [TF DAO](./tf_dao.md) section. +- Transferring TFTs on different chains from the [TF Token Bridge](./tf_token_bridge.md) section. +- Transferring TFTs on the TFChain from the [TF Token Transfer](./tf_token_transfer.md) section. +- getting miniting reports from the [TF Minting Reports](./tf_minting_reports.md) section. + + ![](../img/sidebar_4.png) + +*** +## Table of Content + +- [Your Profile](./your_profile.md) +- [TF DAO](./tf_dao.md) +- [TF Token Bridge](./tf_token_bridge.md) +- [TF Token Transfer](./tf_token_transfer.md) +- [TF Minting Reports](./tf_minting_reports.md) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/tfchain/your_profile.md b/collections/manual/documentation/dashboard/tfchain/your_profile.md new file mode 100644 index 0000000..091cffe --- /dev/null +++ b/collections/manual/documentation/dashboard/tfchain/your_profile.md @@ -0,0 +1,13 @@ +

Twin Management

+ +The TF Twin management feature of the ThreeFold Dashboard enables users to create, manage, and monitor their individual digital entities known as **Twins**. A Twin can represent a virtual machine (VM) or a container running on the ThreeFold Grid. With the Twin management, users can easily deploy and scale their workloads, allocate resources, and configure networking and storage settings for their Twins. + +![](../img/twin.png) + +The twin details consists of three main items. + +- `ID` Your unique identifier for your twin on the ThreeFold chain. +- `Address` Your public address on the ThreeFold chain. +- `Relay` A relay is a component that facilitates the reliable and secure transfer of messages between different entities within the ThreeFold ecosystem. + +To create a twin check the [Wallet Connector](../wallet_connector.md) Section. \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/tfgrid/grid_status.md b/collections/manual/documentation/dashboard/tfgrid/grid_status.md new file mode 100644 index 0000000..5969a99 --- /dev/null +++ b/collections/manual/documentation/dashboard/tfgrid/grid_status.md @@ -0,0 +1,5 @@ +# Grid Status + +Check the status and health of ThreeFold services From [Grid Status](https://status.grid.tf/status/threefold) + +![](../img/grid_health.png) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/tfgrid/node_monitoring.md b/collections/manual/documentation/dashboard/tfgrid/node_monitoring.md new file mode 100644 index 0000000..a7c8d51 --- /dev/null +++ b/collections/manual/documentation/dashboard/tfgrid/node_monitoring.md @@ -0,0 +1,5 @@ +# Node Monitoring + +Monitor and check the metrics and status of Zero-OS nodes from [Node Monitoring](https://metrics.grid.tf/d/rYdddlPWkfqwf/zos-host-metrics?orgId=2&refresh=30s) + +![](../img/Monitoring.png) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/tfgrid/node_statistics.md b/collections/manual/documentation/dashboard/tfgrid/node_statistics.md new file mode 100644 index 0000000..0980105 --- /dev/null +++ b/collections/manual/documentation/dashboard/tfgrid/node_statistics.md @@ -0,0 +1,18 @@ +# Statistics + +Statistics allows you to see the distribution of 3Nodes all over the world with information on how many nodes are available and in which country. + +![](../img/statistics.png) + +Here you can see generic overview about: + +- Number of Nodes +- Number of Dedicated Nodes +- Number of Farms +- Number of Countries +- The capacity CRU, SRU, HRU, MRU +- Number of GPUs +- Number of Gateways +- Number of Twins +- The number of public IPs available +- Number of Contracts \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/tfgrid/tfgrid.md b/collections/manual/documentation/dashboard/tfgrid/tfgrid.md new file mode 100644 index 0000000..2b06d9b --- /dev/null +++ b/collections/manual/documentation/dashboard/tfgrid/tfgrid.md @@ -0,0 +1,17 @@ +# TFGrid + +Check and use all things related to the threefold grid. Including: + +- The status of ThreeFold services from the [Grid Status](./grid_status.md) website. +- The statistics of all nodes that are available on the ThreeFold grid from [Node Statistics](./node_statistics.md). +- The health and status of Zero-OS nodes that are available on the ThreeFold grid from [Node Monitoring](./node_monitoring.md). + + ![](../img/sidebar_1.png) + +*** + +## Table of Content + +- [Grid Status](./grid_status.md) +- [Node Statistics](./node_statistics.md) +- [Node Monitoring](./node_monitoring.md) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/toc.md b/collections/manual/documentation/dashboard/toc.md new file mode 100644 index 0000000..5507842 --- /dev/null +++ b/collections/manual/documentation/dashboard/toc.md @@ -0,0 +1,8 @@ +## Dashboard TOC + +- [Home](./home.md) +- [Wallet Connector](./wallet_connector.md) +- [CapRover](./caprover.md) +- [Virtual Machine](./vm.md) +- [Funkwhale](./funkwhale.md) +- [Peertube](./peertube.md) diff --git a/collections/manual/documentation/dashboard/vm_presearch.md b/collections/manual/documentation/dashboard/vm_presearch.md new file mode 100644 index 0000000..f438507 --- /dev/null +++ b/collections/manual/documentation/dashboard/vm_presearch.md @@ -0,0 +1,51 @@ +# Mount a Presearch node on TFGrid3 using VM + +The fastest way to mount a Presearch node on TFGrid3 is inside a VM. + +Steps : +- Set up a VM, see [here](./vm.md). It is recommended to reserve a fix IP. You can also try out the planetary network (so reserve a VM without public IP), as long as the node you select is connected to the internet through an IPv4 address that isn't used yet for a Presearch node, you don't explicitly need to reserve a public IPv4 address. However, the planetary network is still in beta phase and might generate performance issues. +- 1 CPU is enough for a PRE node. As we still need to install Docker on the VM before deploying a PRE node, please choose 8192 memory size. +- Once your VM is set up, SSH into our machine. + +![](./img/vm_list.png) + +For the VM having an IP address you can enter the terminal command +``` +ssh root@185.206.122.162 +``` + +If you didn't reserve a public IPv4 address, you can ssh into your machine using the IPv6 address. Peopl doing this, should however first set up their identity in the Planetary Network with Yggdrasil. See [here](yggdrasil_client) to know how to do this. + +``` +ssh root@300:aa1b:e91b:720f:ae5f:8991:6df8:1ec9 +``` + +Now you have an empty VM, also Docker still needs to be installed. + +Execute the following commands inside your VM : + +``` +apt update ; +apt install sudo ; +sudo apt install apt-transport-https ca-certificates curl software-properties-common ; +curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - ; +sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable" ; +``` +Finally, install Docker. The Ubuntu machine does not come with `systemd`. The following does the trick : + +``` +apt-get install docker-ce docker-ce-cli containerd.io +apt-cache madison docker-ce + +dockerd & +``` + +Once Docker is set up, you can launch the PRE node instructions on your VM: + +``` +docker stop presearch-node ; docker rm presearch-node ; docker stop presearch-auto-updater ; docker rm presearch-auto-updater ; docker run -d --name presearch-auto-updater --restart=unless-stopped -v /var/run/docker.sock:/var/run/docker.sock presearch/auto-updater --cleanup --interval 900 presearch-auto-updater presearch-node ; docker pull presearch/node ; docker run -dt --name presearch-node --restart=unless-stopped -v presearch-node-storage:/app/node -e REGISTRATION_CODE=$YOUR_REGISTRATION_CODE_HERE presearch/node ; docker logs -f presearch-node +``` + +And you're done ! + +![ ](./img/weblet_vm_presearch_result.jpg) \ No newline at end of file diff --git a/collections/manual/documentation/dashboard/wallet_connector.md b/collections/manual/documentation/dashboard/wallet_connector.md new file mode 100644 index 0000000..842339a --- /dev/null +++ b/collections/manual/documentation/dashboard/wallet_connector.md @@ -0,0 +1,42 @@ +

Wallet Connector

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Supported Networks](#supported-networks) +- [Process](#process) + +*** + +## Introduction + +To interact with TFChain, users need to set a wallet connector. + +## Supported Networks + +Currently, we're supporting four different networks: + +- Dev net, for development purposes + - [https://dashboard.dev.grid.tf](https://dashboard.dev.grid.tf) +- QA net, for internal testing and verifications + - [https://dashboard.qa.grid.tf](https://dashboard.qa.grid.tf) +- Test net, for testing purposes + - [https://dashboard.test.grid.tf](https://dashboard.test.grid.tf) +- Main net, for production-ready purposes + - [https://dashboard.grid.tf](https://dashboard.grid.tf) + +![ ](./img/profile_manager1.png) + +## Process + +Start entering the following information required to create your new profile. + +![ ](./img/profile_manager2.png) + +- `Mnemonics` are the secret words of your Polkadot account. Click on the **Create Account** button to generate yours. +- `Password` is used to access your account +- `Confirm Password` + +After you finish typing your credentials, click on **Connect**. Once your profile gets activated, you should find your **Twin ID** and **Address** generated under your **_Mnemonics_** for verification. Also, your **Account Balance** will be available at the top right corner under your profile name. + +![ ](./img/profile_manager3.png) diff --git a/collections/manual/documentation/developers/developers.md b/collections/manual/documentation/developers/developers.md new file mode 100644 index 0000000..3877320 --- /dev/null +++ b/collections/manual/documentation/developers/developers.md @@ -0,0 +1,90 @@ +# ThreeFold Developers + +This section covers all practical tutorials on how to develop and build on the ThreeFold Grid. + +For complementary information on the technology developed by ThreeFold, refer to the [Technology](../../knowledge_base/technology/technology_toc.md) section. + +

Table of Contents

+ +- [Javascript Client](./javascript/grid3_javascript_readme.md) + - [Installation](./javascript/grid3_javascript_installation.md) + - [Loading Client](./javascript/grid3_javascript_loadclient.md) + - [Deploy a VM](./javascript/grid3_javascript_vm.md) + - [Capacity Planning](./javascript/grid3_javascript_capacity_planning.md) + - [Deploy Multiple VMs](./javascript/grid3_javascript_vms.md) + - [Deploy CapRover](./javascript/grid3_javascript_caprover.md) + - [Gateways](./javascript/grid3_javascript_vm_gateways.md) + - [Deploy a Kubernetes Cluster](./javascript/grid3_javascript_kubernetes.md) + - [Deploy a ZDB](./javascript/grid3_javascript_zdb.md) + - [Deploy ZDBs for QSFS](./javascript/grid3_javascript_qsfs_zdbs.md) + - [QSFS](./javascript/grid3_javascript_qsfs.md) + - [Key Value Store](./javascript/grid3_javascript_kvstore.md) + - [VM with Wireguard and Gateway](./javascript/grid3_wireguard_gateway.md) + - [GPU Support](./javascript/grid3_javascript_gpu_support.md) +- [Go Client](./go/grid3_go_readme.md) + - [Installation](./go/grid3_go_installation.md) + - [Loading Client](./go/grid3_go_load_client.md) + - [Deploy a VM](./go/grid3_go_vm.md) + - [Deploy Multiple VMs](./go/grid3_go_vms.md) + - [Deploy Gateways](./go/grid3_go_gateways.md) + - [Deploy Kubernetes](./go/grid3_go_kubernetes.md) + - [Deploy a QSFS](./go/grid3_go_qsfs.md) + - [GPU Support](./go/grid3_go_gpu.md) +- [TFCMD](./tfcmd/tfcmd.md) + - [Getting Started](./tfcmd/tfcmd_basics.md) + - [Deploy a VM](./tfcmd/tfcmd_vm.md) + - [Deploy Kubernetes](./tfcmd/tfcmd_kubernetes.md) + - [Deploy ZDB](./tfcmd/tfcmd_zdbs.md) + - [Gateway FQDN](./tfcmd/tfcmd_gateway_fqdn.md) + - [Gateway Name](./tfcmd/tfcmd_gateway_name.md) + - [Contracts](./tfcmd/tfcmd_contracts.md) +- [TFROBOT](./tfrobot/tfrobot.md) + - [Installation](./tfrobot/tfrobot_installation.md) + - [Configuration File](./tfrobot/tfrobot_config.md) + - [Deployment](./tfrobot/tfrobot_deploy.md) + - [Commands and Flags](./tfrobot/tfrobot_commands_flags.md) + - [Supported Configurations](./tfrobot/tfrobot_configurations.md) +- [ThreeFold Chain](./tfchain/tfchain.md) + - [Introduction](./tfchain/introduction.md) + - [Farming Policies](./tfchain/farming_policies.md) + - [External Service Contract](./tfchain/tfchain_external_service_contract.md) + - [Solution Provider](./tfchain/tfchain_solution_provider.md) +- [Grid Proxy](./proxy/proxy_readme.md) + - [Introducing Grid Proxy](./proxy/proxy.md) + - [Setup](./proxy/setup.md) + - [DB Testing](./proxy/db_testing.md) + - [Commands](./proxy/commands.md) + - [Contributions](./proxy/contributions.md) + - [Explorer](./proxy/explorer.md) + - [Database](./proxy/database.md) + - [Production](./proxy/production.md) + - [Release](./proxy/release.md) +- [Flist](./flist/flist.md) + - [ThreeFold Hub Intro](./flist/flist_hub/zos_hub.md) + - [Generate an API Token](./flist/flist_hub/api_token.md) + - [Convert Docker Image Into Flist](./flist/flist_hub/convert_docker_image.md) + - [Supported Flists](./flist/grid3_supported_flists.md) + - [Flist Case Studies](./flist/flist_case_studies/flist_case_studies.md) + - [Case Study: Debian 12](./flist/flist_case_studies/flist_debian_case_study.md) + - [Case Study: Nextcloud AIO](./flist/flist_case_studies/flist_nextcloud_case_study.md) +- [Internals](./internals/internals.md) + - [Reliable Message Bus (RMB)](./internals/rmb/rmb_toc.md) + - [Introduction to RMB](./internals/rmb/rmb_intro.md) + - [RMB Specs](./internals/rmb/rmb_specs.md) + - [RMB Peer](./internals/rmb/uml/peer.md) + - [RMB Relay](./internals/rmb/uml/relay.md) + - [ZOS](./internals/zos/index.md) + - [Manual](./internals/zos/manual/manual.md) + - [Workload Types](./internals/zos/manual/workload_types.md) + - [Internal Modules](./internals/zos/internals/internals.md) + - [Capacity](./internals/zos/internals/capacity.md) + - [Performance Monitor Package](./internals/zos/performance/performance.md) + - [Public IPs Validation Task](./internals/zos/performance/publicips.md) + - [CPUBenchmark](./internals/zos/performance/cpubench.md) + - [IPerf](./internals/zos/performance/iperf.md) + - [Health Check](./internals/zos/performance/healthcheck.md) + - [API](./internals/zos/manual/api.md) +- [Grid Deployment](./grid_deployment/grid_deployment.md) + - [TFGrid Stacks](./grid_deployment/tfgrid_stacks.md) + - [Full VM Grid Deployment](./grid_deployment/grid_deployment_full_vm.md) + - [Grid Snapshots](./grid_deployment/snapshots.md) \ No newline at end of file diff --git a/collections/manual/documentation/developers/tfchain/img/attach.png b/collections/manual/documentation/developers/tfchain/img/attach.png new file mode 100644 index 0000000..96e3c5f Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/attach.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/close_proposal.png b/collections/manual/documentation/developers/tfchain/img/close_proposal.png new file mode 100644 index 0000000..07e66a2 Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/close_proposal.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/create_contract.png b/collections/manual/documentation/developers/tfchain/img/create_contract.png new file mode 100644 index 0000000..f082e80 Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/create_contract.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/create_policy.png b/collections/manual/documentation/developers/tfchain/img/create_policy.png new file mode 100644 index 0000000..fa344e7 Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/create_policy.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/create_provider.png b/collections/manual/documentation/developers/tfchain/img/create_provider.png new file mode 100644 index 0000000..e8668a2 Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/create_provider.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/propose_approve.png b/collections/manual/documentation/developers/tfchain/img/propose_approve.png new file mode 100644 index 0000000..667f66f Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/propose_approve.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/proposed_approve.png b/collections/manual/documentation/developers/tfchain/img/proposed_approve.png new file mode 100644 index 0000000..5202c4c Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/proposed_approve.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/query_provider.png b/collections/manual/documentation/developers/tfchain/img/query_provider.png new file mode 100644 index 0000000..de66d4c Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/query_provider.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/service_contract_approve.png b/collections/manual/documentation/developers/tfchain/img/service_contract_approve.png new file mode 100644 index 0000000..1e0d034 Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/service_contract_approve.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/service_contract_bill.png b/collections/manual/documentation/developers/tfchain/img/service_contract_bill.png new file mode 100644 index 0000000..55e84fe Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/service_contract_bill.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/service_contract_cancel.png b/collections/manual/documentation/developers/tfchain/img/service_contract_cancel.png new file mode 100644 index 0000000..7669510 Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/service_contract_cancel.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/service_contract_create.png b/collections/manual/documentation/developers/tfchain/img/service_contract_create.png new file mode 100644 index 0000000..69ec62a Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/service_contract_create.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/service_contract_id.png b/collections/manual/documentation/developers/tfchain/img/service_contract_id.png new file mode 100644 index 0000000..e49c396 Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/service_contract_id.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/service_contract_reject.png b/collections/manual/documentation/developers/tfchain/img/service_contract_reject.png new file mode 100644 index 0000000..6235530 Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/service_contract_reject.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/service_contract_set_fees.png b/collections/manual/documentation/developers/tfchain/img/service_contract_set_fees.png new file mode 100644 index 0000000..6cfa91a Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/service_contract_set_fees.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/service_contract_set_metadata.png b/collections/manual/documentation/developers/tfchain/img/service_contract_set_metadata.png new file mode 100644 index 0000000..e472145 Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/service_contract_set_metadata.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/service_contract_state.png b/collections/manual/documentation/developers/tfchain/img/service_contract_state.png new file mode 100644 index 0000000..e824552 Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/service_contract_state.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/service_contract_twin_from_account.png b/collections/manual/documentation/developers/tfchain/img/service_contract_twin_from_account.png new file mode 100644 index 0000000..293bad2 Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/service_contract_twin_from_account.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/tf.png b/collections/manual/documentation/developers/tfchain/img/tf.png new file mode 100644 index 0000000..528b5d9 Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/tf.png differ diff --git a/collections/manual/documentation/developers/tfchain/img/vote_proposal.png b/collections/manual/documentation/developers/tfchain/img/vote_proposal.png new file mode 100644 index 0000000..16111a0 Binary files /dev/null and b/collections/manual/documentation/developers/tfchain/img/vote_proposal.png differ diff --git a/collections/manual/documentation/developers/tfchain/tfchain.md b/collections/manual/documentation/developers/tfchain/tfchain.md new file mode 100644 index 0000000..a575535 --- /dev/null +++ b/collections/manual/documentation/developers/tfchain/tfchain.md @@ -0,0 +1,95 @@ +

ThreeFold Chain

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Twins](#twins) +- [Farms](#farms) +- [Nodes](#nodes) +- [Node Contract](#node-contract) +- [Rent Contract](#rent-contract) +- [Name Contract](#name-contract) +- [Contract billing](#contract-billing) +- [Contract locking](#contract-locking) +- [Contract grace period](#contract-grace-period) +- [DAO](#dao) +- [Farming Policies](#farming-policies) +- [Node Connection price](#node-connection-price) +- [Node Certifiers](#node-certifiers) + +*** + +## Introduction + +ThreeFold Chain (TFChain) is the base layer for everything that interacts with the grid. Nodes, farms, users are registered on the chain. It plays the central role in achieving decentralised consensus between a user and Node to deploy a certain workload. A contract can be created on the chain that is essentially an agreement between a node and user. + +## Twins + +A twin is the central Identity object that is used for every entity that lives on the grid. A twin optionally has an IPV6 planetary network address which can be used for communication between twins no matter of the location they are in. A twin is coupled to a private/public keypair on chain. This keypair can hold TFT on TF Chain. + +## Farms + +A farm must be created before a Node can be booted. Every farms needs to have an unique name and is linked to the Twin that creates the farm. Once a farm is created, a unique ID is generated. This ID can be used to provide to the boot image of a Node. + +## Nodes + +When a node is booted for the first time, it registers itself on the chain and a unique identity is generated for this Node. + +## Node Contract + +A node contract is a contract between a user and a Node to deploy a certain workload. The contract is specified as following: + +``` +{ + "contract_id": auto generated, + "node_id": unique id of the node, + "deployment_data": some additional deployment data + "deployment_hash": hash of the deployment definition signed by the user + "public_ips": number of public ips to attach to the deployment contract +} +``` + +We don't save the raw workload definition on the chain but only a hash of the definition. After the contract is created, the user must send the raw deployment to the specified node in the contract. He can find where to send this data by looking up the Node's twin and contacting that twin over the planetary network. + +## Rent Contract + +A rent contract is also a contract between a user and a Node, but instead of being able to reserve a part of the node's capacity, the full capacity is rented. Once a rent contract is created on a Node by a user, only this user can deploy node contracts on this specific node. A discount of 50% is given if a the user wishes to rent the full capacity of a node by creating a rent contract. All node contracts deployed on a node where a user has a rent contract are free of use expect for the public ip's which can be added on a node contract. + +## Name Contract + +A name contract is a contract that specifies a unique name to be used on the grid's webgateways. Once a name contract is created, this name can be used as and entrypoint for an application on the grid. + +## Contract billing + +Every contract is billed every 1 hour on the chain, the amount that is due is deducted from the user's wallet every 24 hours or when the user cancels his contract. The total amount acrued in those 24 hours gets send to following destinations: + +- 10% goes to the threefold foundation +- 5% goes to staking pool wallet (to be implemented in a later phase) +- 50% goes to certified sales channel +- 35% TFT gets burned + +See [pricing](../../../knowledge_base/cloud/pricing/pricing.md) for more information on how the cost for a contract is calculated. + +## Contract locking + +To not overload the chain with transfer events and others we choose to lock the amount due for a contract every hour and after 24 hours unlock the amount and deduct it in one go. This lock is saved on a user's account, if the user has multiple contracts the locked amount will be stacked. + +## Contract grace period + +When the owner of a contract runs out funds on his wallet to pay for his deployment, the contract goes in to a Grace Period state. The deployment, whatever that might be, will be unaccessible during this period to the user. When the wallet is funded with TFT again, the contract goes back to a normal operating state. If the grace period runs out (by default 2 weeks) the user's deployment and data will be deleted from the node. + +## DAO + +See [DAO](../../dashboard/tfchain/tf_dao.md) for more information on the DAO on TF Chain. + +## Farming Policies + +See [farming_policies](farming_policies.md) for more information on the farming policies on TF Chain. + +## Node Connection price + +A connection price is set to every new Node that boots on the Grid. This connection price influences the amount of TFT farmed in a period. The connection price set on a node is permanent. The DAO can propose the increase / decrease of the connection price. At the time of writing the connection price is set to $ 0.08. When the DAO proposes a connection price and the vote is passed, new nodes will attach to the new connection price. + +## Node Certifiers + +Node certifiers are entities who are allowed to set a node's certification level to `Certified`. The DAO can propose to add / remove entities that can certify nodes. This is usefull for allowing approved resellers of Threefold nodes to mark nodes as Certified. A certified node farms 25% more tokens than `Diy` a node. \ No newline at end of file diff --git a/collections/manual/documentation/documentation.md b/collections/manual/documentation/documentation.md new file mode 100644 index 0000000..1724121 --- /dev/null +++ b/collections/manual/documentation/documentation.md @@ -0,0 +1,14 @@ +

ThreeFold Documentation

+ +The section contains all the practical information for farmers, developers and system administrators of the ThreeFold Grid. + +For complementary information on ThreeFold, refer to the [ThreeFold Knowledge Base](../knowledge_base/knowledge_base.md). + +

Table of Contents

+ +- [Dashboard](./dashboard/dashboard.md) +- [Developers](./developers/developers.md) +- [Farmers](./farmers/farmers.md) +- [System Administrators](./system_administrators/system_administrators.md) +- [ThreeFold Token](./threefold_token/threefold_token.md) +- [FAQ](./faq/faq.md) \ No newline at end of file diff --git a/collections/manual/documentation/faq/faq.md b/collections/manual/documentation/faq/faq.md new file mode 100644 index 0000000..dda0496 --- /dev/null +++ b/collections/manual/documentation/faq/faq.md @@ -0,0 +1,2480 @@ +

ThreeFold FAQ

+ +

Table of Contents

+ +- [GENERAL FAQ](#general-faq) + - [Basic Facts](#basic-facts) + - [What is the the ThreeFold blockchain?](#what-is-the-the-threefold-blockchain) + - [What is the architecture of the ThreeFold Grid in simple terms?](#what-is-the-architecture-of-the-threefold-grid-in-simple-terms) + - [What is the difference between Internet capacity and connectivity? Does ThreeFold replace my Internet service provider (ISP)?](#what-is-the-difference-between-internet-capacity-and-connectivity-does-threefold-replace-my-internet-service-provider-isp) + - [What are the priorities of ThreeFold - the Three P of ThreeFold? ThreeFold is a Planet first project, what does it mean?](#what-are-the-priorities-of-threefold---the-three-p-of-threefold-threefold-is-a-planet-first-project-what-does-it-mean) + - [I want to help build the new Internet. How can I become a ThreeFold certified 3node partner?](#i-want-to-help-build-the-new-internet-how-can-i-become-a-threefold-certified-3node-partner) + - [How can I create a twin on the TF Grid?](#how-can-i-create-a-twin-on-the-tf-grid) + - [ThreeFold Communication](#threefold-communication) + - [Is there a ThreeFold app for mobile?](#is-there-a-threefold-app-for-mobile) + - [I want to reach the ThreeFold community. What are ThreeFold social links?](#i-want-to-reach-the-threefold-community-what-are-threefold-social-links) + - [Could we reach out someone for publishing research work on ThreeFold?](#could-we-reach-out-someone-for-publishing-research-work-on-threefold) + - [Who can I write to for a proposal? Where can I send a proposal email for a new partnership opportunity with ThreeFold?](#who-can-i-write-to-for-a-proposal-where-can-i-send-a-proposal-email-for-a-new-partnership-opportunity-with-threefold) + - [How can I track and follow the progress and development of ThreeFold?](#how-can-i-track-and-follow-the-progress-and-development-of-threefold) + - [Why do some forum posts need to be approved?](#why-do-some-forum-posts-need-to-be-approved) + - [The Technology of ThreeFold](#the-technology-of-threefold) + - [What is a 3Node?](#what-is-a-3node) + - [What is the difference between a 3node and a ThreeFold farm?](#what-is-the-difference-between-a-3node-and-a-threefold-farm) + - [What is Zero-OS from ThreeFold?](#what-is-zero-os-from-threefold) + - [ThreeFold uses Quantum Safe Storage technology, what does it mean?](#threefold-uses-quantum-safe-storage-technology-what-does-it-mean) + - [Quantum Safe File System (QSFS) allows for part of the storage to go down and it can self repair, however it’s still attached to a single VM and a single point of failure. Can a QSFS instance be reattached to another VM to recover it?](#quantum-safe-file-system-qsfs-allows-for-part-of-the-storage-to-go-down-and-it-can-self-repair-however-its-still-attached-to-a-single-vm-and-a-single-point-of-failure-can-a-qsfs-instance-be-reattached-to-another-vm-to-recover-it) + - [Where does the ThreeFold Explorer take its data from?](#where-does-the-threefold-explorer-take-its-data-from) + - [How can I use the Gridproxy to query information on the TF Grid?](#how-can-i-use-the-gridproxy-to-query-information-on-the-tf-grid) + - [How can I see the stats of the ThreeFold Grid?](#how-can-i-see-the-stats-of-the-threefold-grid) + - [What is the difference between a seed phrase (mnemonics) and an HEX secret?](#what-is-the-difference-between-a-seed-phrase-mnemonics-and-an-hex-secret) + - [Buying and Transacting TFT](#buying-and-transacting-tft) + - [How long does it take when you use the BSC-Stellar Bridge?](#how-long-does-it-take-when-you-use-the-bsc-stellar-bridge) + - [On my website, users can donate TFT on the Stellar Chain. Is there a way for users on my website to easily track the total sum of TFT donated?](#on-my-website-users-can-donate-tft-on-the-stellar-chain-is-there-a-way-for-users-on-my-website-to-easily-track-the-total-sum-of-tft-donated) + - [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) + - [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) + - [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) + - [How can I find 3Nodes with IPv6 addresses?](#how-can-i-find-3nodes-with-ipv6-addresses) + - [How can I use GraphQL to see contracts on my 3Nodes?](#how-can-i-use-graphql-to-see-contracts-on-my-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) + - [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) + - [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) + - [Deployments on the ThreeFold Grid](#deployments-on-the-threefold-grid) + - [Does the ThreeFold Grid charge the total resources rented or it only charges the resources used during deployment?](#does-the-threefold-grid-charge-the-total-resources-rented-or-it-only-charges-the-resources-used-during-deployment) + - [Do I pay for Internet traffic while deploying workloads on IPv4, IPv6 or Planetary Network?](#do-i-pay-for-internet-traffic-while-deploying-workloads-on-ipv4-ipv6-or-planetary-network) + - [What is the monthly cost for an IPv4 or an IPv6 public address on the ThreeFold Grid?](#what-is-the-monthly-cost-for-an-ipv4-or-an-ipv6-public-address-on-the-threefold-grid) + - [What are the differences between a container, a micro virtual machine and a full virtual machine (VM)?](#what-are-the-differences-between-a-container-a-micro-virtual-machine-and-a-full-virtual-machine-vm) + - [What is a 3Node gateway? How can I configure a 3Node as a gateway node?](#what-is-a-3node-gateway-how-can-i-configure-a-3node-as-a-gateway-node) + - [When connecting remotely with SSH, I get the following error: "WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!...". What can I do to fix this?](#when-connecting-remotely-with-ssh-i-get-the-following-error-warning-remote-host-identification-has-changed-what-can-i-do-to-fix-this) + - [How can I remove one host from known\_hosts?](#how-can-i-remove-one-host-from-known_hosts) + - [How can I add ThreeFold peers in the Yggdrasil configuration file?](#how-can-i-add-threefold-peers-in-the-yggdrasil-configuration-file) + - [How can I see Yggdrasil/Planetary Network's peers?](#how-can-i-see-yggdrasilplanetary-networks-peers) + - [How can I ping an Yggdrasil IP or IPv6 address?](#how-can-i-ping-an-yggdrasil-ip-or-ipv6-address) + - [Is there a way to test if I am properly connected to the Yggdrasil network - Planetary Network?](#is-there-a-way-to-test-if-i-am-properly-connected-to-the-yggdrasil-network---planetary-network) + - [How can I change the username of my SSH key?](#how-can-i-change-the-username-of-my-ssh-key) + - [What is ThreeFold's stance on sharded workload? Will ThreeFold embrace and move towards distributed data chunks or stay with the one deployment, one node model?](#what-is-threefolds-stance-on-sharded-workload-will-threefold-embrace-and-move-towards-distributed-data-chunks-or-stay-with-the-one-deployment-one-node-model) + - [Tutorials and Guides](#tutorials-and-guides) + - [What is the minimum amount of TFT to deploy a Presearch node? How can I get a TFT discount when I deploy a Presearch node?](#what-is-the-minimum-amount-of-tft-to-deploy-a-presearch-node-how-can-i-get-a-tft-discount-when-i-deploy-a-presearch-node) + - [Can I use the same seed phrase for my mainnet and testnest accounts? How can I transfer my TFT from mainnet to testnet or vice versa?](#can-i-use-the-same-seed-phrase-for-my-mainnet-and-testnest-accounts-how-can-i-transfer-my-tft-from-mainnet-to-testnet-or-vice-versa) + - [Do I need a full or micro virtual machine (VM) when I run QSFS, quantum safe file system, on the ThreeFold Grid?](#do-i-need-a-full-or-micro-virtual-machine-vm-when-i-run-qsfs-quantum-safe-file-system-on-the-threefold-grid) + - [Linux, Github, Containers and More](#linux-github-containers-and-more) + - [Where should I start to learn more about Linux?](#where-should-i-start-to-learn-more-about-linux) + - [How can I clone a single branch of a repository on Github?](#how-can-i-clone-a-single-branch-of-a-repository-on-github) + - [Grace Period - Status Paused](#grace-period---status-paused) + - [The status of my deployment is paused, in grace period, how can I resume the deployment?](#the-status-of-my-deployment-is-paused-in-grace-period-how-can-i-resume-the-deployment) + - [Once I refund my TF wallet, how long does it take for the deployment to resume from grace period?](#once-i-refund-my-tf-wallet-how-long-does-it-take-for-the-deployment-to-resume-from-grace-period) + - [Can I SSH into my deployments when they are in grace period - i.e. when their status is paused?](#can-i-ssh-into-my-deployments-when-they-are-in-grace-period---ie-when-their-status-is-paused) + - [How long is the grace period - i.e. when the deployment status is paused?](#how-long-is-the-grace-period---ie-when-the-deployment-status-is-paused) + - [Terraform](#terraform) + - [Working with Terraform, I get the following error: failed to create contract: ContractIsNotUnique. Is there a fix to this issue?](#working-with-terraform-i-get-the-following-error-failed-to-create-contract-contractisnotunique-is-there-a-fix-to-this-issue) + - [I am working with Terraform. What do I have to write in the file env.tfvars?](#i-am-working-with-terraform-what-do-i-have-to-write-in-the-file-envtfvars) + - [I am working with Terraform and I am using the example in Terraform Provider Grid. How can I use the example main.tf file with environment variables? Why am I getting the message Error: account not found, when deploying with Terraform?](#i-am-working-with-terraform-and-i-am-using-the-example-in-terraform-provider-grid-how-can-i-use-the-example-maintf-file-with-environment-variables-why-am-i-getting-the-message-error-account-not-found-when-deploying-with-terraform) + - [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) + - [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) +- [DEVELOPERS FAQ](#developers-faq) + - [General Information for Developer](#general-information-for-developer) + - [Does Zero-OS assign private IPv4 addresses to workloads?](#does-zero-os-assign-private-ipv4-addresses-to-workloads) + - [Why does each 3Node server have two IP addresses associated with it?](#why-does-each-3node-server-have-two-ip-addresses-associated-with-it) + - [Can Zero-OS assign public IPv4 or IPv6 addresses to workloads?](#can-zero-os-assign-public-ipv4-or-ipv6-addresses-to-workloads) + - [What does MAC mean when it comes to networking?](#what-does-mac-mean-when-it-comes-to-networking) + - [I am a developer looking for a way to automatically convert BSC tokens into TFT. Could you please share tips on how to swap regular tokens into TFT, on backend, without and browser extensions, via any platform API?](#i-am-a-developer-looking-for-a-way-to-automatically-convert-bsc-tokens-into-tft-could-you-please-share-tips-on-how-to-swap-regular-tokens-into-tft-on-backend-without-and-browser-extensions-via-any-platform-api) + - [Test Net](#test-net) + - [Can I get some free TFT to test on Test Net](#can-i-get-some-free-tft-to-test-on-test-net) +- [FARMERS FAQ](#farmers-faq) + - [TFT Farming Basics](#tft-farming-basics) + - [My Titan is v2.1 and the ThreeFold Grid is v3., what is the distinction?](#my-titan-is-v21-and-the-threefold-grid-is-v3-what-is-the-distinction) + - [When will I receive the farming rewards for my 3Nodes?](#when-will-i-receive-the-farming-rewards-for-my-3nodes) + - [What is the TFT minting process? Is it fully automated?](#what-is-the-tft-minting-process-is-it-fully-automated) + - [What should I do if I did not receive my farming rewards this month?](#what-should-i-do-if-i-did-not-receive-my-farming-rewards-this-month) + - [What is the TFT entry price of my 3Node farming rewards?](#what-is-the-tft-entry-price-of-my-3node-farming-rewards) + - [What is the necessary uptime for a 3Node per period of one month?](#what-is-the-necessary-uptime-for-a-3node-per-period-of-one-month) + - [How can I check the uptime of my 3Nodes? Is there a tool to check the uptime of 3Node servers on the ThreeFold Grid?](#how-can-i-check-the-uptime-of-my-3nodes-is-there-a-tool-to-check-the-uptime-of-3node-servers-on-the-threefold-grid) + - [I set up a 3Node in the middle of the month, does it affect uptime requirements and rewards?](#i-set-up-a-3node-in-the-middle-of-the-month-does-it-affect-uptime-requirements-and-rewards) + - [What is the difference between a certified and a non-certified 3Node?](#what-is-the-difference-between-a-certified-and-a-non-certified-3node) + - [What are the different certifications available for 3Node servers and farms? What are the Gold and Silver certifications?](#what-are-the-different-certifications-available-for-3node-servers-and-farms-what-are-the-gold-and-silver-certifications) + - [What is the difference between V2 and V3 minting?](#what-is-the-difference-between-v2-and-v3-minting) + - [What is the TFT minting address on Stellar Chain?](#what-is-the-tft-minting-address-on-stellar-chain) + - [Can Titans and DIY 3Nodes share the same farm?](#can-titans-and-diy-3nodes-share-the-same-farm) + - [Do I need one farm for each 3Node?](#do-i-need-one-farm-for-each-3node) + - [Can a single farm be composed of many 3Nodes?](#can-a-single-farm-be-composed-of-many-3nodes) + - [Can a single 3Node be on more than one farm?](#can-a-single-3node-be-on-more-than-one-farm) + - [Do I need one reward address per 3Node?](#do-i-need-one-reward-address-per-3node) + - [How can I access the expert bootstrap mode for Zero-OS?](#how-can-i-access-the-expert-bootstrap-mode-for-zero-os) + - [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) + - [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) + - [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) + - [Farming Rewards and Related Notions](#farming-rewards-and-related-notions) + - [What are the rewards of farming? Can I get more rewards when my 3Node is being utilized?](#what-are-the-rewards-of-farming-can-i-get-more-rewards-when-my-3node-is-being-utilized) + - [How can I know the potential farming rewards for Grid Utilization?](#how-can-i-know-the-potential-farming-rewards-for-grid-utilization) + - [What is the easiest way to farm ThreeFold tokens (TFT)?](#what-is-the-easiest-way-to-farm-threefold-tokens-tft) + - [When do I receive my rewards?](#when-do-i-receive-my-rewards) + - [Do farming rewards take into account the type of RAM, SSD, HDD and CPU of the 3Node server?](#do-farming-rewards-take-into-account-the-type-of-ram-ssd-hdd-and-cpu-of-the-3node-server) + - [Can I send my farming rewards directly to a crypto exchange?](#can-i-send-my-farming-rewards-directly-to-a-crypto-exchange) + - [Do I need collateral to farm ThreeFold tokens?](#do-i-need-collateral-to-farm-threefold-tokens) + - [Can I add external drives to the 3Nodes to increase rewards and resources available to the ThreeFold Grid?](#can-i-add-external-drives-to-the-3nodes-to-increase-rewards-and-resources-available-to-the-threefold-grid) + - [Do I have access to the TFT rewards I receive each month when farming?](#do-i-have-access-to-the-tft-rewards-i-receive-each-month-when-farming) + - [What is TFTA? Is it still used?](#what-is-tfta-is-it-still-used) + - [Is there a way to certify a DIY 3Node? How can I become a 3Node certified vendor and builder?](#is-there-a-way-to-certify-a-diy-3node-how-can-i-become-a-3node-certified-vendor-and-builder) + - [Does it make sense to make my farm a company?](#does-it-make-sense-to-make-my-farm-a-company) + - [What is the difference between uptime and downtime, and between online and offline, when it comes to 3Nodes?](#what-is-the-difference-between-uptime-and-downtime-and-between-online-and-offline-when-it-comes-to-3nodes) + - [My 3Node server grid utilization is low, is it normal?](#my-3node-server-grid-utilization-is-low-is-it-normal) + - [3Node Farming Requirements](#3node-farming-requirements) + - [Can I host more than one 3Node server at my house?](#can-i-host-more-than-one-3node-server-at-my-house) + - [Is Wifi supported? Can I farm via Wifi instead of an Ethernet cable?](#is-wifi-supported-can-i-farm-via-wifi-instead-of-an-ethernet-cable) + - [I have 2 routers with each a different Internet service provider. I disconnected the ethernet cable from one router and connected it to the other router. Do I need to reboot the 3Node?](#i-have-2-routers-with-each-a-different-internet-service-provider-i-disconnected-the-ethernet-cable-from-one-router-and-connected-it-to-the-other-router-do-i-need-to-reboot-the-3node) + - [Do I need any specific port configuration when booting a 3Node?](#do-i-need-any-specific-port-configuration-when-booting-a-3node) + - [How much electricity does a 3Node use?](#how-much-electricity-does-a-3node-use) + - [Has anyone run stress tests to know the power consumption at heavy load of certain 3Nodes?](#has-anyone-run-stress-tests-to-know-the-power-consumption-at-heavy-load-of-certain-3nodes) + - [Can the Titan 3Node be run on Power Over Ethernet, PoE?](#can-the-titan-3node-be-run-on-power-over-ethernet-poe) + - [What is the relationship between the 3Node's resources and bandwidth?](#what-is-the-relationship-between-the-3nodes-resources-and-bandwidth) + - [What is the bandwidth needed when it comes to running 3Nodes on the Grid?](#what-is-the-bandwidth-needed-when-it-comes-to-running-3nodes-on-the-grid) + - [Can I run Zero-OS on a virtual machine?](#can-i-run-zero-os-on-a-virtual-machine) + - [Is it possible to build a DIY 3Node with VMWare VM ?](#is-it-possible-to-build-a-diy-3node-with-vmware-vm-) + - [Can I run a 3Node on another operating system, like Windows, MAC or Linux?](#can-i-run-a-3node-on-another-operating-system-like-windows-mac-or-linux) + - [What is the minimum SSD requirement for a 3Node server to farm ThreeFold tokens (TFT)?](#what-is-the-minimum-ssd-requirement-for-a-3node-server-to-farm-threefold-tokens-tft) + - [Is it possible to have a 3Node server running on only HDD disks?](#is-it-possible-to-have-a-3node-server-running-on-only-hdd-disks) + - [Building a 3Node - Steps and Details](#building-a-3node---steps-and-details) + - [How can I be sure that I properly wiped my disks?](#how-can-i-be-sure-that-i-properly-wiped-my-disks) + - [If I wipe my disk to create a new node ID, will I lose my farming rewards during the month?](#if-i-wipe-my-disk-to-create-a-new-node-id-will-i-lose-my-farming-rewards-during-the-month) + - [My disks have issues with Zero-OS and my 3Nodes. How can I do a factory reset of the disks?](#my-disks-have-issues-with-zero-os-and-my-3nodes-how-can-i-do-a-factory-reset-of-the-disks) + - [Before doing a bootstrap image, I need to format my USB key. How can I format my USB key?](#before-doing-a-bootstrap-image-i-need-to-format-my-usb-key-how-can-i-format-my-usb-key) + - [What do you use to burn or to load the Zero-OS bootstrap image onto a USB stick?](#what-do-you-use-to-burn-or-to-load-the-zero-os-bootstrap-image-onto-a-usb-stick) + - [Should I do a UEFI image or a BIOS image to bootstrap Zero-OS?](#should-i-do-a-uefi-image-or-a-bios-image-to-bootstrap-zero-os) + - [How do I set the BIOS or UEFI of my 3Node?](#how-do-i-set-the-bios-or-uefi-of-my-3node) + - [For my 3Node server, do I need to enable virtualization in BIOS or UEFI?](#for-my-3node-server-do-i-need-to-enable-virtualization-in-bios-or-uefi) + - [How can I boot a 3Node server with a Zero-OS bootstrap image?](#how-can-i-boot-a-3node-server-with-a-zero-os-bootstrap-image) + - [The first time I booted my 3Node server, it says that the node is not registered yet. What can I do?](#the-first-time-i-booted-my-3node-server-it-says-that-the-node-is-not-registered-yet-what-can-i-do) + - [The first time I boot my 3Node, the node gets registered but it says cache disk : no ssd. What can I do?](#the-first-time-i-boot-my-3node-the-node-gets-registered-but-it-says-cache-disk--no-ssd-what-can-i-do) + - [The first time I boot my 3 node, the node gets registered and it says cache disk : OK, but the table System Used Capacity is empty. What can I do?](#the-first-time-i-boot-my-3-node-the-node-gets-registered-and-it-says-cache-disk--ok-but-the-table-system-used-capacity-is-empty-what-can-i-do) + - [I have a relatively old server. I have trouble booting Zero-OS. What could I do?](#i-have-a-relatively-old-server-i-have-trouble-booting-zero-os-what-could-i-do) + - [I connected a SATA SSD to a CD-DVD optical drive adaptor. My system does not recognize the disk. What can I do?](#i-connected-a-sata-ssd-to-a-cd-dvd-optical-drive-adaptor-my-system-does-not-recognize-the-disk-what-can-i-do) + - [Can someone explain what should I put in the Public IP part of my farm? Should I just insert my Public IP and Gateway given by my ISP?](#can-someone-explain-what-should-i-put-in-the-public-ip-part-of-my-farm-should-i-just-insert-my-public-ip-and-gateway-given-by-my-isp) + - [Farming Optimization](#farming-optimization) + - [What is the difference between a ThreeFold 3Node and a ThreeFold farm? What is the difference between the farm ID and the node ID?](#what-is-the-difference-between-a-threefold-3node-and-a-threefold-farm-what-is-the-difference-between-the-farm-id-and-the-node-id) + - [How can I know how many GB of SSD and RAM do I need?](#how-can-i-know-how-many-gb-of-ssd-and-ram-do-i-need) + - [What is the optimal ratio of virtual cores - vcores or threads - SSD storage and RAM memory? What is the best optimization scenario for a 3Node, in terms of TFT farming rewards?](#what-is-the-optimal-ratio-of-virtual-cores---vcores-or-threads---ssd-storage-and-ram-memory-what-is-the-best-optimization-scenario-for-a-3node-in-terms-of-tft-farming-rewards) + - [What does TBW mean? What is a good TBW level for a SSD disk?](#what-does-tbw-mean-what-is-a-good-tbw-level-for-a-ssd-disk) + - [Are SATA and SAS drives interchangeable?](#are-sata-and-sas-drives-interchangeable) + - [What is the speed difference between SAS and SATA disks?](#what-is-the-speed-difference-between-sas-and-sata-disks) + - [Is it possible to do a graceful shutdown to a 3Node server? How can you shutdown or power off a 3Node server?](#is-it-possible-to-do-a-graceful-shutdown-to-a-3node-server-how-can-you-shutdown-or-power-off-a-3node-server) + - [Is it possible to have direct access to Zero-OS's core to force a reboot?](#is-it-possible-to-have-direct-access-to-zero-oss-core-to-force-a-reboot) + - [Do I need some port forwarding in my router for each 3Node server?](#do-i-need-some-port-forwarding-in-my-router-for-each-3node-server) + - [Are there ways to reduce 3Node servers' noises?](#are-there-ways-to-reduce-3node-servers-noises) + - [I built a 3Node out of old hardware. Is it possible that my BIOS or UEFI has improper time and date set as factory default?](#i-built-a-3node-out-of-old-hardware-is-it-possible-that-my-bios-or-uefi-has-improper-time-and-date-set-as-factory-default) + - [I have rack servers in my ThreeFold farm. Can I set rack servers vertically?](#i-have-rack-servers-in-my-threefold-farm-can-i-set-rack-servers-vertically) + - [Farming and Maintenance](#farming-and-maintenance) + - [How can I check if there is utilization on my 3Nodes?](#how-can-i-check-if-there-is-utilization-on-my-3nodes) + - [Do I need the Zero-OS bootstrap image drive when I reboot, or can I boot Zero-OS from the 3Node main hard drive?](#do-i-need-the-zero-os-bootstrap-image-drive-when-i-reboot-or-can-i-boot-zero-os-from-the-3node-main-hard-drive) + - [It's written that my node is using 100% of HRU. What does it mean?](#its-written-that-my-node-is-using-100-of-hru-what-does-it-mean) + - [On the ThreeFold Node Finder, I only see half of the virtual cores or threads my 3Node has, what can I do?](#on-the-threefold-node-finder-i-only-see-half-of-the-virtual-cores-or-threads-my-3node-has-what-can-i-do) + - [Why are the 3Nodes' resources different on the ThreeFold Node Finder and the ThreeFold Dashboard?](#why-are-the-3nodes-resources-different-on-the-threefold-node-finder-and-the-threefold-dashboard) + - [How can I test the health of my disks?](#how-can-i-test-the-health-of-my-disks) + - [How can I transfer my 3Node from one farm to another?](#how-can-i-transfer-my-3node-from-one-farm-to-another) + - [What do CRU, MRU, HRU and SRU mean on the ThreeFold Node Finder?](#what-do-cru-mru-hru-and-sru-mean-on-the-threefold-node-finder) + - [I have more than one ThreeFold 3Node farm, but I want all my 3Nodes on only one farm. How can I put all my 3Nodes on one farm? How can I change the farm ID of my 3Node?](#i-have-more-than-one-threefold-3node-farm-but-i-want-all-my-3nodes-on-only-one-farm-how-can-i-put-all-my-3nodes-on-one-farm-how-can-i-change-the-farm-id-of-my-3node) + - [How can I know if my 3Node is online on the Grid?](#how-can-i-know-if-my-3node-is-online-on-the-grid) + - [I booted my 3Node and the monitor says it's online and connected to the Grid. But the ThreeFold Node Finder says it is offline? What can I do?](#i-booted-my-3node-and-the-monitor-says-its-online-and-connected-to-the-grid-but-the-threefold-node-finder-says-it-is-offline-what-can-i-do) + - [My 3Node does show on the ThreeFold Node Finder, but not on the ThreeFold Dashboard, what can I do?](#my-3node-does-show-on-the-threefold-node-finder-but-not-on-the-threefold-dashboard-what-can-i-do) + - [If I upgrade my 3Node, will it increase my rewards?](#if-i-upgrade-my-3node-will-it-increase-my-rewards) + - [I booted my 3Node for the first time at the beginning of the month, then I did some upgrade or downgrade, will the ThreeFold Grid recognize the new hardware? Will it still be the same 3Node ID?](#i-booted-my-3node-for-the-first-time-at-the-beginning-of-the-month-then-i-did-some-upgrade-or-downgrade-will-the-threefold-grid-recognize-the-new-hardware-will-it-still-be-the-same-3node-id) + - [Is it possible to ask the 3Node to refetch the node information on the monitor?](#is-it-possible-to-ask-the-3node-to-refetch-the-node-information-on-the-monitor) + - [When does Zero-OS detect the capacity of a 3Node?](#when-does-zero-os-detect-the-capacity-of-a-3node) + - [Where is the 3Node ID stored?](#where-is-the-3node-id-stored) + - [Is there a way to backup my node ID in order to restore a 3Node if the disk with the node ID gets corrupted or breaks down?](#is-there-a-way-to-backup-my-node-id-in-order-to-restore-a-3node-if-the-disk-with-the-node-id-gets-corrupted-or-breaks-down) + - [If I upgrade my 3Node, does it change the node ID?](#if-i-upgrade-my-3node-does-it-change-the-node-id) + - [Does it make sense to recreate my node when the price drops?](#does-it-make-sense-to-recreate-my-node-when-the-price-drops) + - [My 3Node lost power momentarily and I had to power it back on manually. Is there a better way to proceed?](#my-3node-lost-power-momentarily-and-i-had-to-power-it-back-on-manually-is-there-a-better-way-to-proceed) + - [Do I need to change the battery BIOS?](#do-i-need-to-change-the-battery-bios) + - [Do I need to enable UEFI Network Stack?](#do-i-need-to-enable-uefi-network-stack) + - [I want redundancy of power for my 3 nodes. I have two PSU on my Dell server. What can I do?](#i-want-redundancy-of-power-for-my-3-nodes-i-have-two-psu-on-my-dell-server-what-can-i-do) + - [Why isn't there support for RAID? Does Zero-OS work with RAID?](#why-isnt-there-support-for-raid-does-zero-os-work-with-raid) + - [Is there a way to bypass RAID in order for Zero-OS to have bare metals on the system - No RAID controller in between storage and the Grid ?](#is-there-a-way-to-bypass-raid-in-order-for-zero-os-to-have-bare-metals-on-the-system---no-raid-controller-in-between-storage-and-the-grid-) + - [I have a 3Node rack server. Is it possible to use a M.2 to SATA adapter in order to put the M.2 SATA disk in the HDD bay onboard storage?](#i-have-a-3node-rack-server-is-it-possible-to-use-a-m2-to-sata-adapter-in-order-to-put-the-m2-sata-disk-in-the-hdd-bay-onboard-storage) + - [My 3Node uses only PCIe adapters and SSD NVME disks. Do I need the RAID controller on?](#my-3node-uses-only-pcie-adapters-and-ssd-nvme-disks-do-i-need-the-raid-controller-on) + - [Can I change the name of my farm on polkadot.js?](#can-i-change-the-name-of-my-farm-on-polkadotjs) + - [How can I delete a farm on polkadot.js?](#how-can-i-delete-a-farm-on-polkadotjs) + - [I try to delete a node on the TF Dashboard, but it doesn’t work. Is there any other way to proceed that could work?](#i-try-to-delete-a-node-on-the-tf-dashboard-but-it-doesnt-work-is-there-any-other-way-to-proceed-that-could-work) + - [My 3Node has 2 ethernet ports in the back, with one written AMT above, what does it mean? Can I use this port to connect my 3Node to the ThreeFold Grid?](#my-3node-has-2-ethernet-ports-in-the-back-with-one-written-amt-above-what-does-it-mean-can-i-use-this-port-to-connect-my-3node-to-the-threefold-grid) + - [My 3Node is based on a the hardware Z600, Z620 or Z820, can I run it headless or without a GPU?](#my-3node-is-based-on-a-the-hardware-z600-z620-or-z820-can-i-run-it-headless-or-without-a-gpu) + - [Is it possible to add high-level GPU on rack servers to farm more TFT?](#is-it-possible-to-add-high-level-gpu-on-rack-servers-to-farm-more-tft) + - [If I change farm, will my node IDs change on my 3Node servers?](#if-i-change-farm-will-my-node-ids-change-on-my-3node-servers) + - [Troubleshooting and Error Messages](#troubleshooting-and-error-messages) + - [Is it possible to access the Error Screen or Log Screen?](#is-it-possible-to-access-the-error-screen-or-log-screen) + - [What does it mean when I see, during the 3Node boot, the message: error = context deadline exceeded?](#what-does-it-mean-when-i-see-during-the-3node-boot-the-message-error--context-deadline-exceeded) + - [I try to boot a 3Node, but I get the error: "No Route to Host on Linux". What does it mean?](#i-try-to-boot-a-3node-but-i-get-the-error-no-route-to-host-on-linux-what-does-it-mean) + - [How can I fix the error: "Network configuration succeed but Zero-OS kernel could not be downloaded" when booting a 3Node?](#how-can-i-fix-the-error-network-configuration-succeed-but-zero-os-kernel-could-not-be-downloaded-when-booting-a-3node) + - [Using SAS disks, I get the error; "No ssd found, failed to register". What can I do to fix this?](#using-sas-disks-i-get-the-error-no-ssd-found-failed-to-register-what-can-i-do-to-fix-this) + - [When booting a 3Node, how to fix the error: "no disks: registration failed"?](#when-booting-a-3node-how-to-fix-the-error-no-disks-registration-failed) + - [My SSD is sometimes detected as HDD by Zero-OS when there is a reboot. Is there a fix or a way to test the SSD disk?](#my-ssd-is-sometimes-detected-as-hdd-by-zero-os-when-there-is-a-reboot-is-there-a-fix-or-a-way-to-test-the-ssd-disk) + - [When booting a 3Node, I get the message: failed to register node: failed to create node: failed to submit extrinsic: Invalid Transaction: registration failed. What could fix this?](#when-booting-a-3node-i-get-the-message-failed-to-register-node-failed-to-create-node-failed-to-submit-extrinsic-invalid-transaction-registration-failed-what-could-fix-this) + - [I try to boot a 3Node, but I get the message no route with default gateway found. What does it mean?](#i-try-to-boot-a-3node-but-i-get-the-message-no-route-with-default-gateway-found-what-does-it-mean) + - [I have trouble connecting the 3Node to the Grid with a 10GB NIC card. What can I do?](#i-have-trouble-connecting-the-3node-to-the-grid-with-a-10gb-nic-card-what-can-i-do) + - [I switch the ethernet cable to a different port when my 3Node was running. Internet connection is lost. What can I do?](#i-switch-the-ethernet-cable-to-a-different-port-when-my-3node-was-running-internet-connection-is-lost-what-can-i-do) + - [I get the error Certificate is not yet valid when booting my 3Node server, what can I do?](#i--get-the-error-certificate-is-not-yet-valid-when-booting-my-3node-server-what-can-i-do) + - [When running wipefs to wipe my disks on Linux, I get either of the following errors: "syntax error near unexpected token" or "Probing Initialized Failed". Is there a fix?](#when-running-wipefs-to-wipe-my-disks-on-linux-i-get-either-of-the-following-errors-syntax-error-near-unexpected-token-or-probing-initialized-failed-is-there-a-fix) + - [I did a format on my SSD disk, but Zero-OS still does not recognize them. What's wrong?](#i-did-a-format-on-my-ssd-disk-but-zero-os-still-does-not-recognize-them-whats-wrong) + - [I have a Dell Rx10 server - R610, 710, 910. When I boot Zero-OS I get the message Probing EDD and the 3Node doesn't boot from there. What can I do?](#i-have-a-dell-rx10-server---r610-710-910-when-i-boot-zero-os-i-get-the-message-probing-edd-and-the-3node-doesnt-boot-from-there-what-can-i-do) + - [My 3Node doesn't boot properly without a monitor plugged in. What can I do?](#my-3node-doesnt-boot-properly-without-a-monitor-plugged-in-what-can-i-do) + - [My 3Node is running on the Grid, but when I plugged in the monitor, it states: Disabling IR #16. Is there a problem?](#my-3node-is-running-on-the-grid-but-when-i-plugged-in-the-monitor-it-states-disabling-ir-16-is-there-a-problem) + - [My 3Node won't boot without disabling the Secure Boot option, is it safe?](#my-3node-wont-boot-without-disabling-the-secure-boot-option-is-it-safe) + - [When I tried to boot my 3Node, at some point the screen went black, with or without a blinking hyphen or dash. What could cause this and what could I do to resolve the issue?](#when-i-tried-to-boot-my-3node-at-some-point-the-screen-went-black-with-or-without-a-blinking-hyphen-or-dash-what-could-cause-this-and-what-could-i-do-to-resolve-the-issue) + - [My 3Nodes go offline after a modem reboot. Is there a way to prevent this?](#my-3nodes-go-offline-after-a-modem-reboot-is-there-a-way-to-prevent-this) + - [When I boot my 3Node, it reaches the Welcome to Zero-OS window, but it doesn't boot properly and there's an error message: failed to load object : type substrate..., what can I do?](#when-i-boot-my-3node-it-reaches-the-welcome-to-zero-os-window-but-it-doesnt-boot-properly-and-theres-an-error-message-failed-to-load-object--type-substrate-what-can-i-do) + - [When I try to access iDRAC on a web browswer, even with protected mode off, I get the error The webpage cannot be found, what can I do?](#when-i-try-to-access-idrac-on-a-web-browswer-even-with-protected-mode-off-i-get-the-error-the-webpage-cannot-be-found-what-can-i-do) + - [When booting the 3Node, I get the error Network interface detected but autoconfiguration failed. What can I do?](#when-booting-the-3node-i-get-the-error-network-interface-detected-but-autoconfiguration-failed-what-can-i-do) + - [When I boot my Dell server, I get the message: All of the disks from your previous configuration are gone... Press any key to continue or 'C' to load the configuration utility. What can I do?](#when-i-boot-my-dell-server-i-get-the-message-all-of-the-disks-from-your-previous-configuration-are-gone-press-any-key-to-continue-or-c-to-load-the-configuration-utility-what-can-i-do) + - [I have a Dell R620. In Zero-OS, I get the failure message No network card found and then the 3Node reebots after few seconds. The same happens for every LAN input. What can I do?](#i-have-a-dell-r620-in-zero-os-i-get-the-failure-message-no-network-card-found-and-then-the-3node-reebots-after-few-seconds-the-same-happens-for-every-lan-input-what-can-i-do) + - [I am using freeDos to crossflash my raid controller on a Dell server, but I can't see the RAID controller with the Command Info. What can I do?](#i-am-using-freedos-to-crossflash-my-raid-controller-on-a-dell-server-but-i-cant-see-the-raid-controller-with-the-command-info-what-can-i-do) + - [Can I use a VGA to HDMI adaptor to connect a TV screen or monitor to the 3Node? I tried to boot a 3Node with a VGA to HDMI adaptor but the boot fails, what can I do?](#can-i-use-a-vga-to-hdmi-adaptor-to-connect-a-tv-screen-or-monitor-to-the-3node-i-tried-to-boot-a-3node-with-a-vga-to-hdmi-adaptor-but-the-boot-fails-what-can-i-do) + - [When I try to boot my 3Node, the fans start spinning fast with a loud noise and the screen is black. What can I do to resolve this?](#when-i-try-to-boot-my-3node-the-fans-start-spinning-fast-with-a-loud-noise-and-the-screen-is-black-what-can-i-do-to-resolve-this) + - [When booting Zero-OS with IPV6 configurations, I get the errors (1) dial tcp: address IPV6-address too many columns in address and (2) no pools matches key: not routable. What can I do to fix this issue?](#when-booting-zero-os-with-ipv6-configurations-i-get-the-errors-1-dial-tcp-address-ipv6-address-too-many-columns-in-address-and-2-no-pools-matches-key-not-routable-what-can-i-do-to-fix-this-issue) + - [When booting a 3Node, Zero-OS downloads fine, but then I get the message: error no route with default gateway found, and the message: info check if interface has a cable plugged in. What could fix this?](#when-booting-a-3node-zero-os-downloads-fine-but-then-i-get-the-message-error-no-route-with-default-gateway-found-and-the-message-info-check-if-interface-has-a-cable-plugged-in-what-could-fix-this) + - [How can I update Dell and HP servers to Intel E5-2600v2, E5-2400v2 and E5-4600v2, when applicable?](#how-can-i-update-dell-and-hp-servers-to-intel-e5-2600v2-e5-2400v2-and-e5-4600v2-when-applicable) + - [How can I update the firmware and driver of a Dell PowerEdge server?](#how-can-i-update-the-firmware-and-driver-of-a-dell-poweredge-server) + - [When I boot a 3Node in UEFI mode, it gets stuck at: Initializing Network Device, is there a way to fix this?](#when-i-boot-a-3node-in-uefi-mode-it-gets-stuck-at-initializing-network-device-is-there-a-way-to-fix-this) + - [When I boot my 3Node, it gets stuck during the Zero-OS download. It never reaches 100%. What can I do to fix this issue?](#when-i-boot-my-3node-it-gets-stuck-during-the-zero-os-download-it-never-reaches-100-what-can-i-do-to-fix-this-issue) + - [When booting a 3Node, I get the error=“context deadline exceeded” module=network error=failed to initialize rmb api failed to initialized admin mw: failed to get farm: farm not found: object not found. What can I do to fix this issue?](#when-booting-a-3node-i-get-the-errorcontext-deadline-exceeded-modulenetwork-errorfailed-to-initialize-rmb-api-failed-to-initialized-admin-mw-failed-to-get-farm-farm-not-found-object-not-found-what-can-i-do-to-fix-this-issue) + - [ThreeFold Grid and Data](#threefold-grid-and-data) + - [How is the farming minting reward calculated? Is the Grid always monitoring my 3Node?](#how-is-the-farming-minting-reward-calculated-is-the-grid-always-monitoring-my-3node) + - [How does communication happen on the ThreeFold Grid at the 3Node's level?](#how-does-communication-happen-on-the-threefold-grid-at-the-3nodes-level) + - [What is the ThreeFold Node Status bot Telegram link?](#what-is-the-threefold-node-status-bot-telegram-link) + - [How does the ThreeFold Node Status bot work? How can I use the ThreeFold Node Status bot to verify if my 3Node is online?](#how-does-the-threefold-node-status-bot-work-how-can-i-use-the-threefold-node-status-bot-to-verify-if-my-3node-is-online) + - [How does the Telegram Status Bot get information from my 3Node? My 3Node is online on the ThreeFold Node Finder, but offline on the Telegram Status Bot, is this normal?](#how-does-the-telegram-status-bot-get-information-from-my-3node-my-3node-is-online-on-the-threefold-node-finder-but-offline-on-the-telegram-status-bot-is-this-normal) + - [I noticed that when I reboot my 3Node, the uptime counter on the ThreeFold Node Finder goes back to zero. Does it mean I lose uptime and the uptime start over again when I reboot the 3Node?](#i-noticed-that-when-i-reboot-my-3node-the-uptime-counter-on-the-threefold-node-finder-goes-back-to-zero-does-it-mean-i-lose-uptime-and-the-uptime-start-over-again-when-i-reboot-the-3node) + - [One of my nodes is showing the wrong location. Any problem with that?](#one-of-my-nodes-is-showing-the-wrong-location-any-problem-with-that) + - [Memory](#memory) + - [Can I use different type of RAM for the same 3Node?](#can-i-use-different-type-of-ram-for-the-same-3node) + - [How can I know if the memory I am buying is correct for my specific hardware?](#how-can-i-know-if-the-memory-i-am-buying-is-correct-for-my-specific-hardware) + - [What do the terms RDIMM, LDIMM, UDIMM, LRDIMM, FBDIMM mean when it comes to RAM memory sticks?](#what-do-the-terms-rdimm-ldimm-udimm-lrdimm-fbdimm-mean-when-it-comes-to-ram-memory-sticks) + - [What is the difference between ECC and non-ECC memory?](#what-is-the-difference-between-ecc-and-non-ecc-memory) + - [How can I change the RAM memory sticks on my 3Nodes? How can I achieve dual channel configuration with sticks of RAM?](#how-can-i-change-the-ram-memory-sticks-on-my-3nodes-how-can-i-achieve-dual-channel-configuration-with-sticks-of-ram) + - [What does RAM mean?](#what-does-ram-mean) + - [What does DIMM mean when it comes to RAM sticks?](#what-does-dimm-mean-when-it-comes-to-ram-sticks) + - [I have 24 DIMMS ram slots on my server. Can I use them all?](#i-have-24-dimms-ram-slots-on-my-server-can-i-use-them-all) +- [Ask a Question to the ThreeFold Community](#ask-a-question-to-the-threefold-community) + +*** + +# GENERAL FAQ + +## Basic Facts + +### What is the the ThreeFold blockchain? + +ThreeFold blockchain is the layer 0 infrastructure for an open source peer-to-peer (P2P) Internet owned by humanity. + + + +### What is the architecture of the ThreeFold Grid in simple terms? + +Essentially, the ThreeFold Grid is composed of the people using it, the 3Node servers offering compute, storage and network resources, and the TF Chain, which is the blockchain of ThreeFold. + +Middlewares are also used, such as GraphQL and GrixProxy, to get and organize data from the ThreeFold Chain. They help to make data available and to manage load. + +3Nodes store workloads data and can report on their state to the TF Grid and to middlewares. + + +### What is the difference between Internet capacity and connectivity? Does ThreeFold replace my Internet service provider (ISP)? + +In simple terms, the Internet is composed of both capacity and connectivity. Capacity is where the data and resources are being handled, for example in servers. Connectivity is the infrastructure that transfer data and resources between servers. The latter is linked to the typical Internet service provider (ISP). + +ThreeFold’s technology enables distributed capacity generation, but ThreeFold doesn’t deal in connectivity. +3nodes offer Internet capacity, but farmers still rely on connectivity provider like the usual Internet service provider (ISP). + +### What are the priorities of ThreeFold - the Three P of ThreeFold? ThreeFold is a Planet first project, what does it mean? + +ThreeFold is working for the Planet, the People and Profit, in this very order of importance. Planet comes first as it is our home to us all. A humane enterprise always has people before profit, and serious entrepreneurs know profit cannot be left out of the equation of a thriving project. + + +### I want to help build the new Internet. How can I become a ThreeFold certified 3node partner? + +Apply [here](https://marketplace.3node.global/index.php?dispatch=companies.apply_for_vendor) to become a ThreeFold certified 3node partner. + + + +### How can I create a twin on the TF Grid? + +There are 2 ways to create a twin: + +You can create a twin via the [ThreeFold Dashboard](../dashboard/wallet_connector.md). + +You can also create a twin via the ThreeFold Connect app. Indeed, a twin is automatically generated while creating a farm. Note that, in this case, the twin will be created on mainnet. + + +## ThreeFold Communication + +### Is there a ThreeFold app for mobile? + +Yes! ThreeFold Connect App (TF Connect App) is available for [Android](https://play.google.com/store/apps/details?id=org.jimber.threebotlogin) and [iOS](https://apps.apple.com/us/app/threefold-connect/id1459845885). + +You can use this app to create a ThreeFold ID, a ThreeFold Wallet and also a ThreeFold Farm to link all your 3nodes. +The ThreeFold Connect Wallet, with its Stellar payout address, can be used for transactions as well as to receive farming rewards. +The News section gives you the latest information on the fast ThreeFold development and growth. + + +### I want to reach the ThreeFold community. What are ThreeFold social links? + +You can find links to the ThreeFold community at the bottom of the main page of the [ThreeFold website](https://www.threefold.io/). + + +### Could we reach out someone for publishing research work on ThreeFold? + +You can send an email to info@threefold.io for publishing research on ThreeFold. + + +### Who can I write to for a proposal? Where can I send a proposal email for a new partnership opportunity with ThreeFold? + +You can mail your proposal to info@threefold.io or write about your proposal on the [ThreeFold Forum](http://forum.threefold.io/). + + + +### How can I track and follow the progress and development of ThreeFold? + +There are two main places where you can track the progress of ThreeFold. ThreeFold is open source and its developments can be easily tracked on Github. + +* You can read about the ongoing ThreeFold Tech projects [here](https://github.com/orgs/threefoldtech/projects). +* You can read about the ongoing ThreeFold Foundation projects [here](https://github.com/orgs/threefoldfoundation/projects?query=is%3Aopen). + + + +### Why do some forum posts need to be approved? + +The configurations of the ThreeFold forum make so that some posts need approval, depending on where they are posted. Like posting from meta-sections, and some specific sections. + +Also, note that certain posts can automatically get flagged for moderation based on their content. + + + +## The Technology of ThreeFold + +### What is a 3Node? + +It is essentially a single server that makes up a larger network of servers which together form the ThreeFold Grid. Essentially any modern computer can be turned into a 3node (DIY Farming) and you can [buy plug and play 3nodes](https://marketplace.3node.global/index.php) as state of the art modern computer. + + + +### What is the difference between a 3node and a ThreeFold farm? + +A 3node is a single server connected to the Grid. Each 3node is linked to a farm. A farm can be composed of multiple 3nodes. + + +### What is Zero-OS from ThreeFold? + +Zero-OS is a stateless and lightweight operating system designed to host anything that runs on Linux, in a decentralized way. Once installed, Zero-OS locks the hardware and dedicates its capacity to the People’s Internet via the ThreeFold Blockchain. + + + +### ThreeFold uses Quantum Safe Storage technology, what does it mean? + +Quantum computers are theoretically capable of doing huge calculations in a short period of time. By this fact alone, it is a great potential threat to future online safety. ThreeFold solves this future problem before it even becomes a reality. Indeed, Zero-os can compress, encrypt, and disperse data across the Grid. + + + +### Quantum Safe File System (QSFS) allows for part of the storage to go down and it can self repair, however it’s still attached to a single VM and a single point of failure. Can a QSFS instance be reattached to another VM to recover it? + +QSFS is built from storage devices which are distributed and decentralized. + +The storage engine is a software running on a VM that can run everywhere. +If the storage engine needs to run on a different VM the config needs to pushed to the new VM. +In short, yes Quantum safe file system (QSFS) can be recovered on a different VM. It is not automated yet on Zero-OS. A video tutorial will be shared soon. + + + + +### Where does the ThreeFold Explorer take its data from? + +The ThreeFold Explorer takes its data from this website: [https://gridproxy.grid.tf/](https://gridproxy.grid.tf/). + +To explore Grid Proxy, you can use Swagger: [https://gridproxy.grid.tf/swagger/index.html](https://gridproxy.grid.tf/swagger/index.html). You will then be able to query the TF Grid and extract data. + +See the next Q&A for more information on Swagger. + + + +### How can I use the Gridproxy to query information on the TF Grid? + +You can go to the Gridproxy Swagger index: [https://gridproxy.grid.tf/swagger/index.html](https://gridproxy.grid.tf/swagger/index.html). + +There you can query information such as information on a 3node. + +For example, asking the Gridproxy for the nodeID 466, you get the following URL: `https://gridproxy.grid.tf/nodes/466`. + +To get specific information, you can add parameters, for example: `https://gridproxy.grid.tf/nodes/466/status`. + +When you know the URL representation of the query, you can simply use the URL directly on a web browser. + + + +### How can I see the stats of the ThreeFold Grid? + +You can go to think link: [https://stats.grid.tf/](https://stats.grid.tf/) to see the stats of the ThreeFold Grid. + +You can also check this [thread](https://forum.threefold.io/t/grid-stats-new-nodes-utilization-overview/3291/) on the ThreeFold forum. + + +### What is the difference between a seed phrase (mnemonics) and an HEX secret? + +A seed phrase (also called mnemonics) is a set of words from a carefully selected pool that can be used to derive cryptographic secrets. A HEX secret is a more direct representation of such secret that the computer uses. In the case of an HEX secret, there is no extra information present to form complete words of the seed phrase. + +In typical usage, multiple secrets can be derived from a seed phrase via a one-way operation. The secret and its derived public key are sufficient to do any cryptographic operation like signing transactions or encrypting data, but it can't be used to get back the words of the seed phrase. + + + +## Buying and Transacting TFT + + +### How long does it take when you use the BSC-Stellar Bridge? + +The bridge will process deposits/withdrawals within 48 hours. + + + +### On my website, users can donate TFT on the Stellar Chain. Is there a way for users on my website to easily track the total sum of TFT donated? + +There is a simple way to do this. The [Stellar Explorer](https://stellar.expert/explorer/public) has an embeddable widget that you can insert on any website, including WordPress. + +Simply go to the account you’re interested in showing the balance of, look for “Balance History”, select TFT, and finally click the small icon next to the heading to reveal the embed code. In your WordPress page editor, in HTML mode, paste the embed code. + + +## 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? + +The TF Connect App supports Stellar and TF Chain wallets. The app by default can create one wallet. To add any number of additional wallets, you must create a wallet on Stellar or TF Chain and then import it with the import function. + + + +### 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? + +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? + +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. + +For Stellar based TFT’s there is an explorer here: https://stellar.expert/explorer/public. Enter you wallet address in the top left search box, and after pressing enter you should see every transaction related to your account. + +If you are not deploying/doing things on the TF Grid (dev, test or mainnet) you will not have transferred any tokens to the TF Chain, therefore all your tokens/wallets will be on the Stellar Chain. + + +### How can I use GraphQl to find information on the ThreeFold Grid? + +To find information on the ThreeFold Grid with GraphQL, go to this [link](https://graphql.grid.tf/graphql). On the left menu, choose the parameters you want to search and write the necessary information, if needed, then click on the Play button in the middle section, at the top. + +Here's an example of a query, where we want to find all the farms containing "duck" in their name. + +query MyQuery { + farms(where: {name_contains: "duck"}) { + name + farmID + } +} + +This code can be written automatically if you simply select the proper parameters in the left menu. +For the previous example, we had to click on "farms", then "where", and then "name_contains". After clicking on "name_contains", you need to add the words you are looking for, in this example we had "duck". Further down the menu, we simply had to click on "farmID" and "name", and then click the Play button. The results of the query appear on the right screen. + + + +### What are the different links to ThreeFold's Graph QL depending on the network? + +The links for the Development, Test and Main Networks are the following: + +* Main Net Graph QL + * [https://graphql.grid.tf/graphql](https://graphql.grid.tf/graphql) +* Test Net Graph QL + * [https://graphql.test.grid.tf/graphql](https://graphql.test.grid.tf/graphql) +* Dev Net Graph QL + * [https://graphql.dev.grid.tf/graphql](https://graphql.dev.grid.tf/graphql) + + + +### How can I find 3Nodes with IPv6 addresses? + +You can use [GraphQL](https://graphql.grid.tf/graphql) for such queries. + +Use the following code to search for 3Nodes with IPv6 addresses. +Enter the following code on the middle window and click on the "Play" button. + +``` +query MyQuery { + publicConfigs { + ipv6 + node { + nodeID + } + } +} +``` + +The 3nodes with IPv6 addresses will appear on the right window. + +For more information on how to use Graph QL, read [this Q&A](#how-can-i-use-graphql-to-find-information-on-the-threefold-grid). + + + +### How can I use GraphQL to see contracts on my 3Nodes? + +Go to [ThreeFold's GraphQL](https://graphql.grid.tf/graphql) and write the following query: + +``` +query MyQuery { + nodeContracts(where: {state_eq: Created, nodeID_eq: 42}) { + resourcesUsed { + cru + hru + mru + sru + } + contractID + twinID + nodeID + } +} + +``` + +This will show you contracts on the 3Node as well as resources used. You can play with the different parameters. + +How can I see the farm associated with a node? + +``` +query MyQuery { + nodes(where: {nodeID_eq: 57}) { + farmID + nodeID + } +} +``` + + + +### How can I use Grid Proxy to find information on the ThreeFold Grid and 3Nodes? + +To find information on the ThreeFold Grid with GraphQL, you need to write this URL: https://gridproxy.grid.tf/, followed by your specific query. Here's an example if we wanted to see all the available farm on the TF Grid that has "duck" in its name: + +https://gridproxy.grid.tf/farms?name_contains=duck + +The Grid Proxy is appropriate for high volume application. +You can find the parameters to be written in the URL when visiting the [GraphQL explorer](https://graphql.grid.tf/graphql). + + + +### Who is hosting GraphQL and Grid Proxy on the ThreeFold Grid? + +GraphQL and Grid Proxy are hosted by ThreeFold for everyone to use. + +Note that it is also possible to run your own instance of those tools. + + + +### What is the difference between uptime, status and power state? + +There are three distinctly named endpoints or fields that exist in the back end systems: + +* Uptime + * number of seconds the node was up, as of it's last uptime report. This is the same on GraphQL and Grid Proxy. +* Status + * this is a field that only exists on the Grid Proxy, which corresponds to whether the node sent an uptime report within the last 40 minutes. +* 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. + + + +### 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 + +## TF Grid Functionalities + + +### What are the type of storage available on TF Grid? + +There’s two type of storage that van de used on the TF Grid. + +1. VM which has a virtual disk. The virtual disk is a straightforward volume on a local hard disk. Everything stored on this virtual disk is stored only on this virtual (and thus physical) disk. Delete the VM and the virtual disk and the content is gone. +2. Quantum safe storage. Quantum safe storage uses a “Storage Engine” that parts, compresses, encrypts and then mathematically describes the data. + + +## Deployments on the ThreeFold Grid + + +### Does the ThreeFold Grid charge the total resources rented or it only charges the resources used during deployment? + +Billing is based on how many resources you reserve, not how much you use them. For this reason, it can be a good idea to deploy the minimim resources needed per project. + + + +### Do I pay for Internet traffic while deploying workloads on IPv4, IPv6 or Planetary Network? + +You do pay for internet traffic while deploying on the ThreeFold Grid. It is calculated during deployment and paid with ThreeFold tokens (TFT). + +Note that the private overlay network traffic is not billed. + + + +### What is the monthly cost for an IPv4 or an IPv6 public address on the ThreeFold Grid? + +The cost for an IPv4 public address is around 3$/month (USD). + +For an IPv6 address, there is no cost. + + + +### What are the differences between a container, a micro virtual machine and a full virtual machine (VM)? + +The following is a list of certain features related to containers as well as full and micro virtual machines. + +* Container + * generally designed to run a single application + * doesn't need to include a full operating system + * relies on the kernel of the host system, no hypervisor needed + * isolated from the rest of the host system for security and can be limited in resources used + * examples: on the [Playground](https://playground.grid.tf/), we have [Kubernetes](https://library.threefold.me/info/manual/#/manual__weblets_k8s?id=kubernetes) and [Caprover](https://library.threefold.me/info/manual/#/manual__weblets_caprover?id=caprover), which are both environments that host containers +* Micro VM + * a container image promoted to run as a VM by pairing with a generic kernel + * more isolated than a container, thus more secure + * generally lighter than a full VM + * can be created from any Docker container image by uploading it to the [TF Hub](https://hub.grid.tf/) + * examples: on the [Playground](https://playground.grid.tf/), we have Ubuntu 20.04, Alpine-3, CentOS-8 and more. +* Full VM + * contains a complete operating system including kernel + * capable of anything that can be done with a Linux server + * compatible with any guides and tutorials written for the same version of the distribution they are running + * normally contains systemd, unlike containers which normally do not + * can load kernel modules or replace the kernel entirely, so has best compatibility + * generally heavier than micro VM + * examples: on the [Playground](https://playground.grid.tf/), we have Ubuntu 18.04, 20.04, 22.04 and more + +Note that you can run Kubernetes on a micro VM and you can run a very minimal operating system in a full VM. There are many possibilities when using those technologies. + + + +### What is a 3Node gateway? How can I configure a 3Node as a gateway node? + +A 3Node becomes a gateway when a ThreeFold farmer adds a public IP address to the node itself on the [ThreeFold Dashboard](https://dashboard.grid.tf/). In doing so, the IP address is then handed over to the base operating system of the node itself. The IP address can then be used in the overall functions of the TF Grid. + +Note that this process differs from when an IP address that has been added to a farm is deployed with a workload in order for that workload to be accessible on the Internet. + +To configure a 3Node as a gateway node, you need a public IP block from your internet service provider (ISP). + +You can configure a 3Node as a gateway node on the [TF mainnet](https://dashboard.grid.tf/), [TF testnet](https://dashboard.test.grid.tf/) and [TF devnet](https://dashboard.dev.grid.tf/). You thus need to choose the correct TF Dashboard link (main, test, dev). + +To configure a 3Node as a gateway node, follow these steps: + +* Configure your DNS records + * Type: A + * Name: + * Value: + * Type: NS + * Name: _acme-challenge. + * Value: . + * Type: CNAME + * Name: *.. + * Value: + * Type: AAAA + * Name: + * Value: +* Configure your 3Node parameters on the TF Dashboard + * Go to the [ThreeFold Dashboard](https://dashboard.grid.tf/) + * Go to the section **Portal** + * Go to the subsection **Farms** + * Choose the 3Node you want to turn into a gateway node and click on **Actions** (Add a public config) on the right + * Enter the necessary information and click **Save** + * IPV4: Enter the IPv4 address of your public IP block + * Gateway: Enter the gateway of your public IP block + * IPV6: Enter the IPv6 address of your public IP block + * Gateway IPV6: Enter the gateway of your public IP block + * Domain: . + +Once this is done, you should see the IPv4 and IPv6 addresses in the section **PUB** of your 3Node screen. + +To learn more about this process, [watch this great video](https://youtu.be/axvKipK7MQM). + + + +### When connecting remotely with SSH, I get the following error: "WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!...". What can I do to fix this? + +If you've already done an SSH connection on your computer, the issue is most probably that the "host key has just been changed". To fix this, try one of those two solutions: + +* Linux and MAC: + * ``` + sudo rm ~/.ssh/known_hosts + ``` +* Windows: + * ``` + rm ~/.ssh/known_hosts + ``` + +To be more specific, you can remove the probematic host: + +* Windows, Linux and MAC: + * ``` + ssh-keygen -R + ``` + +Once this is done, you should be able to SSH into your 3Node deployment. + + + +### How can I remove one host from known_hosts? + +You can write the following command +``` +ssh-keygen -R hostname +``` + +Where hostname would be the IPv4 or IPv6 address for example. +In the case of the ThreeFold Grid, it can also be the Planetary Network address. + + + +### How can I add ThreeFold peers in the Yggdrasil configuration file? + +In the file /etc/yggdrasil.conf, write the following in the "Peers" section: + +``` + Peers: [ + # Threefold Lochrist + tcp://gent01.grid.tf:9943 + tcp://gent02.grid.tf:9943 + tcp://gent03.grid.tf:9943 + tcp://gent04.grid.tf:9943 + tcp://gent01.test.grid.tf:9943 + tcp://gent02.test.grid.tf:9943 + tcp://gent01.dev.grid.tf:9943 + tcp://gent02.dev.grid.tf:9943 + # GreenEdge + tcp://gw291.vienna1.greenedgecloud.com:9943 + tcp://gw293.vienna1.greenedgecloud.com:9943 + tcp://gw294.vienna1.greenedgecloud.com:9943 + tcp://gw297.vienna1.greenedgecloud.com:9943 + tcp://gw298.vienna1.greenedgecloud.com:9943 + tcp://gw299.vienna2.greenedgecloud.com:9943 + tcp://gw300.vienna2.greenedgecloud.com:9943 + tcp://gw304.vienna2.greenedgecloud.com:9943 + tcp://gw306.vienna2.greenedgecloud.com:9943 + tcp://gw307.vienna2.greenedgecloud.com:9943 + tcp://gw309.vienna2.greenedgecloud.com:9943 + tcp://gw313.vienna2.greenedgecloud.com:9943 + tcp://gw324.salzburg1.greenedgecloud.com:9943 + tcp://gw326.salzburg1.greenedgecloud.com:9943 + tcp://gw327.salzburg1.greenedgecloud.com:9943 + tcp://gw328.salzburg1.greenedgecloud.com:9943 + tcp://gw330.salzburg1.greenedgecloud.com:9943 + tcp://gw331.salzburg1.greenedgecloud.com:9943 + tcp://gw333.salzburg1.greenedgecloud.com:9943 + tcp://gw422.vienna2.greenedgecloud.com:9943 + tcp://gw423.vienna2.greenedgecloud.com:9943 + tcp://gw424.vienna2.greenedgecloud.com:9943 + tcp://gw425.vienna2.greenedgecloud.com:9943 + ] +``` + + + +### How can I see Yggdrasil/Planetary Network's peers? + +On MAC and Linux, write the following line in the terminal: + +``` +/etc/yggdrasil.conf +``` + +On Windows, one of the two following lines should work: + +``` +%ALLUSERSPROFILE%\Yggdrasil\yggdrasil.conf +``` + +``` +C:\ProgramData\Yggdrasil\ +``` + +These are the general location of Yggdrasil. It can change depending on how you installed Yggdrasil. + + + +### How can I ping an Yggdrasil IP or IPv6 address? + +Usually, using the command `ping` works. + +If the typical `ping` doesn't work, try this instead: `ping6` + +For example, the following will send 2 pings: + +``` +ping6 -c 2 yggdrasil_address +``` + + + + +### Is there a way to test if I am properly connected to the Yggdrasil network - Planetary Network? + +To check if you are properly connected to the Yggdrasil network, try reaching this website: + +``` +http://[319:3cf0:dd1d:47b9:20c:29ff:fe2c:39be]/ +``` + +If you can reach this website, it means that you are properly connected. + +For more information on how to connect to Yggrasil (and the Planetary Network), read [this guide](../system_administrators/getstarted/ssh_guide/ssh_guide.md). + + + + +### How can I change the username of my SSH key? + +In the terminal, write the following line: + +``` +ssh-keygen -C newname +``` + +Make sure to replace "newname" by the name you want. + + +### What is ThreeFold's stance on sharded workload? Will ThreeFold embrace and move towards distributed data chunks or stay with the one deployment, one node model? + +The ThreeFold Grid is basically agnostic when it comes to how you structure your deployment. + +If you want to put all your storage and compute on one node and lose everything if it goes down, you can do so. + +If you want a highly distributed and fault tolerant system with high availability where data is never lost, you can also do so. You could build an architecture with single nodes running single workloads as the building blocks. + +Containerized micro service architectures running on e.g. Kubernetes are basically the way that compute is being "sharded" already in the mainstream of IT, especially at large scales. Such applications fit well on the ThreeFold Grid today, since they account for the possibility that individual nodes may fail. However, many applications aren't built this way and it takes work to adapt them. + +Self driving and self healing IT is one of the core concepts of ThreeFold. What we've built so far is an excellent foundation for making this reality. Some additional features might come into TF Chain and the network itself to enable such features. That being said, a lot is already possible using the existing system. It's just a matter of gluing things together in the right way. + + + +## Tutorials and Guides + + +### What is the minimum amount of TFT to deploy a Presearch node? How can I get a TFT discount when I deploy a Presearch node? + +The minimum amount of TFT that needs to be in your ThreeFold Profile before you can deploy a Presearch node is 2 TFT. But this would not last very long. + +To benefit from the biggest reduction in price (-60%), you need to have a sufficient amount of TFT in your wallet. The TFT is not locked and simply needs to be present in your wallet. + + +For the capacity of a Presearch node, the amount is around 5000 TFT, covering 3 years that the workload could run. + +Note that a Presearch node requires about 3 days to stabilize. + + + + +### Can I use the same seed phrase for my mainnet and testnest accounts? How can I transfer my TFT from mainnet to testnet or vice versa? + +Yes, you can use the same seed phrase for you main and testnet accounts. They will have the same address on each chain but they are really separate accounts. It is much like using the same wallet on Ethereum and BSC for example. + +To transfer your TFT from mainnet to testnet or vice versa, you need to send your TFT to the Stellar chain first. Let's say you want to transfer TFT from the mainnet to the testnet. Here are the steps: + +* Open your mainnet profile on the [mainnet Dashboard](https://dashboard.grid.tf/), on the left menu, choose Portal and then Swap. Click the button Withdraw. Send your TFTs from the mainnet address to your Stellar address. + +* Open your testnet profile on the [testnet Dashboard](https://dashboard.test.grid.tf/), on the left menu, choose Portal and then Swap. Click the button Deposit. Send your TFTs from your Stellar address to the testnet address. You can use the QR code option to make the transfer. + +To go from testnet to mainnet, simply use the URLs in the opposite order. + +> Note that the fees are of 1 TFT per transfer. + + + +### Do I need a full or micro virtual machine (VM) when I run QSFS, quantum safe file system, on the ThreeFold Grid? + +QSFS can be run on both a full virtual machine or a micro virtual machine (VM). The QSFS is a "mountable" object, like a disk. It's defined in its own block, then specified as a mount within a VM. + + +## Linux, Github, Containers and More + +### Where should I start to learn more about Linux? + +While the [ThreeFold Manual](https://www.manual.grid.tf/) would be a good place to learn about ThreeFold and how to deploy on the TF Grid, to learn specifically about Linux, a good place to start is the [Linux website](https://www.linux.org/). There you will find [many tutorials](https://www.linux.org/forums/#linux-tutorials.122). + +A general advice to learn Linux, and computers in general, is to develop the skill of finding answers by following your natural curiosity: most of the questions have been asked before and answers can be found through search engines. + +Before doing any web search, you can use the resources already on hand in the terminal. For any command, you can try adding `-h` or `--help` for a brief description of what it does and to see some commonly used arguments. Typing `man` and then the command name will bring up a more detailed manual, assuming it exists and is installed (e.g. `man sudo`). + +Some ThreeFold users also point out that using different AI and LLM can be very helpful in the process of learning Linux and computers in general. + + +### How can I clone a single branch of a repository on Github? + +You can clone a single branch of a repository with the following line: + +``` +git clone --single-branch --branch branch_name https://github.com/GITHUB_ACCOUNT/REPOSITORY_NAME +``` + + + +## Grace Period - Status Paused + +### The status of my deployment is paused, in grace period, how can I resume the deployment? + +When your wallet is running out of TFT to pay for deployments, your deployments will be paused. +To resume your deployments, simply fill up your wallet with more TFT. + + + +### Once I refund my TF wallet, how long does it take for the deployment to resume from grace period? + +It can take around one hour to change the status from "paused" to "ok" and thus for the deployment to resume. + + + +### Can I SSH into my deployments when they are in grace period - i.e. when their status is paused? + +While in grace period, you might not be able to SSH into your deployment. Refund your wallet to resume deployments. + + + +### How long is the grace period - i.e. when the deployment status is paused? + +The grace period is 2 weeks. During this period, you can refill your wallet to resume your deployment. + + + +## Terraform + +### Working with Terraform, I get the following error: failed to create contract: ContractIsNotUnique. Is there a fix to this issue? + +This error happens when a contract with the same data is already active. For example, two conflicting contracts are not in the same deployment. You can try to change the data on the main.tf file to make sure it's not a self-conflicting terraform deployment. + + + +### I am working with Terraform. What do I have to write in the file env.tfvars? + +This env.tfvars should look like the following, with the proper content within the quotes: + +> MNEMONICS = "write your seed phrase" +> +> NETWORK = "write the main network" +> +> SSH_KEY = "write your ssh-key" + +Note that this could change based on your specific Terraform deployment. + + + +### I am working with Terraform and I am using the example in Terraform Provider Grid. How can I use the example main.tf file with environment variables? Why am I getting the message Error: account not found, when deploying with Terraform? + +This Q&A is linked with the main.tf file in the [QSFS section of the ThreeFold Tech repository](https://github.com/threefoldtech/terraform-provider-grid/blob/development/examples/resources/qsfs/main.tf). + +This error happens when you did not properly set your environment variables. +In the main.tf file, add those lines at the top: + +> variable "MNEMONICS" { +> +> type = string +> +> description = "The mnemonic phrase used to generate the seed for the node." +> +> } + +> variable "NETWORK" { +> +> type = string +> +> default = "main" +> +> description = "The network to connect the node to." +> +> } + +> variable "SSH_KEY" { +> +> type = string +> +> } + +Within the file main.tf, set those lines: + +> provider "grid" { +> +> mnemonics = "${var.MNEMONICS}" +> +> network = "${var.NETWORK}" +> +> } + +> env_vars = { +> +> SSH_KEY = "${var.SSH_KEY}" +> +> } + +Note: Make sure that you properly set your variables in the file env.tfvars. + + +## 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 and doing a full system update and upgrade (apt update, apt upgrade), if you get the error: GRUB failed to install to the following devices /dev/vda15, try this to fix it: + +> apt-mark hold grub-efi-amd64-signed + +This should fix the 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? + +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? + +The addresses 10.x.y.z and 192.168.x.y are on the private network. + +A 10.x.y.z address is just as valid as a 192.168.x.y address for a private network. If all the devices get a 10.x.y.z network, your private network should work properly. But if some of your devices are getting 10.x.y.z addresses while others are getting 192.168.x.y addresses, then you have two conflicting DHCP servers in your network. + + + +# DEVELOPERS FAQ + +## General Information for Developer + +### Does Zero-OS assign private IPv4 addresses to workloads? + +No. Zero-OS will request two IP address from the DHCP. If you only have one physical NIC connected, Zero-OS will assign the second IP address as a virtual device. + + + +### Why does each 3Node server have two IP addresses associated with it? + +Each node has two IP adresses. + +One is for for Zero-OS and one is for for the DMZ (demilitarized zone, sometimes referred to as a perimeter network or screened subnet). This separates public/private traffic from each other. + +Note: Zero-OS will request two IP address from the DHCP. If you only have one physical NIC connected, Zero-OS will assign the second IP address as a virtual device. + +### Can Zero-OS assign public IPv4 or IPv6 addresses to workloads? +Yes it can provide both standard and Yggdrasil connections. + + +### What does MAC mean when it comes to networking? +MAC means *media access control*. It is a unique hardware ID. It helps the network to recognize your machine. It is then, for example, possible to assign a specific and fixed IP address to your hardware. + + + + +### I am a developer looking for a way to automatically convert BSC tokens into TFT. Could you please share tips on how to swap regular tokens into TFT, on backend, without and browser extensions, via any platform API? + +TFT is implemented as a cross-chain asset (BToken) on BSC. + +Swapping via Pancakeswap directly without a browser and extension can be done by calling the Pancakeswap's BSC contract directly. Note that this requires some EVM knowledge on calling contracts. + +TFT is a standard ERC-20 contract, called BEP20 on BSC. You will thus need to call the approved method in the TFT contract to allow Pancakeswap to transfer TFTs from your account. + +The TFT contract allows you to approve a large amount and when Pancakeswap makes the transfer, the TFT will be deducted from the transaction. This will not reset so you will not have to make a call to approve every swap. This will thus save some gas. + + + +## Test Net + +### Can I get some free TFT to test on Test Net + +The TFT on Test Net is real TFT. There are ways to get free TFT to explore Test Net, such as joining the Beta Tester Group. More information [here](https://forum.threefold.io/t/join-the-grid-3-0-beta-testers-group/1194/21). + + + +# FARMERS FAQ + +## TFT Farming Basics + +### My Titan is v2.1 and the ThreeFold Grid is v3., what is the distinction? + +Titan v2.1 is the hardware. Before v2.1, there was 2.0. The hardware currently being shipped is the Titan v2.1. + +When you read v3, it refers to the ThreeFold Grid. Titans are now being sent ready for TF Grid v3 so they are being referred to as Titan v3. In short, the current Titans are v2.1 hardware ready for ThreeFold Grid v3. + + + +### When will I receive the farming rewards for my 3Nodes? + +Farming rewards are usually sent around the 8th of each month. This can vary slightly because the verification process is not yet fully automated. + +For more information on the minting process, read the next [QnA](#what-is-the-tft-minting-process-is-it-fully-automated). + + + +### What is the TFT minting process? Is it fully automated? + +Minting is based on blockchain data according to strict rules that are carried out by computers with humans involved only to check for errors and to sign the resulting transactions. + +There is a human verification mechanism through multisignatures for calculations done on the data as stored in the blockchain. This explains the timing differences when it comes to the monthly farming rewards distribution, since enough people need to sign off. + +The detailed minting process for V3 is as follow: + +- TFChain, ThreeFold's blockchain, has all the details about capacity provided by the nodes. +- TFChain is used to track uptime. +- Zero-OS reports to TFChain. +- The code in [this repo](https://github.com/threefoldtech/minting_v3) uses the information from the blockchain to calculate the TFT to be minted. +- A proof of what needs to be minted and why is created. This proof is then sent to our guardians. +- The guardians need to double check the execution and the minting report. This is like a human check on the automated process. +- The guardians need to sign. Only when consensus is achieved the minting as suggested will happen. This allows human to check the code. + +It is important to understant that TFChain tracks the capacity and uptime and is the source for the minting. + +Note: Additional auditing code will be added in V4 (i.e. special code generated at runtime for verification) using security primitives on motherboards. + +For more information on the minting periods, read this [QnA](#what-is-the-start-and-end-of-the-current-minting-period-what-are-the-minting-periods-for-threefold-farming-in-2023). + + + +### What should I do if I did not receive my farming rewards this month? + +If you did not receive your farming rewards, please contact us via our live chats. We will then investigate the situation. + +You can find our live chat option on the TF Connect App ([Android](https://play.google.com/store/apps/details?id=org.jimber.threebotlogin&hl=en_CA&gl=US), [iOS](https://apps.apple.com/us/app/threefold-connect/id1459845885)), the [TF Forum](http://forum.threefold.io/), [TF Dashboard](https://dashboard.grid.tf/) and the [TF website](https://threefold.io/). +For the TF Connect app, select the Support option. +For the other websites, it is a blue icon on the right bottom part of the page. + +The easiest way to contact the ThreeFold support is to use [this link](https://threefoldfaq.crisp.help/en/) and click on the chat icon. + +### What is the TFT entry price of my 3Node farming rewards? + +Currently, the TFT entry price of the 3Nodes' farming rewards is 8 cents (0.08 USD). + + + +### What is the necessary uptime for a 3Node per period of one month? + +Note that as of now, rewards are proportional to the uptime, so (e.g.) 40% uptime farms 40% of the total uptime period. + +When implemented : For certified Titans 3Nodes, it is 97% uptime per month (21.6h). For DIY 3Nodes, it is 95% uptime per month (36h). For professional certified 3 nodes, it is 99.5% uptime per month (3.6h). + + +### How can I check the uptime of my 3Nodes? Is there a tool to check the uptime of 3Node servers on the ThreeFold Grid? + +You can go on the [ThreeFold Dashboard](https://dashboard.grid.tf/), and select "Farms" in the Portal menu. When you select a specific 3Node in your farm, you can see a visual graph of the 3Node's uptime of the last month. By clicking on "Node Statistics", you can see past and present uptime periods. + + + +### I set up a 3Node in the middle of the month, does it affect uptime requirements and rewards? + +You will still need to meet the required uptime (95% for DIY, etc.3), but the period starts when you connected the 3Node for the first time, instead of the usual start of the month. This only applies the first month. Afterwards, the uptime is calculated on the whole month. *Read last Q+A + + +### What is the difference between a certified and a non-certified 3Node? + +A certified 3Node will receive 25% more reward compared to a non-certified 3Node. +You can visit the [ThreeFold Marketplace](https://marketplace.3node.global/) for more information on certified 3Nodes. +DIY certified 3Nodes are a future possibility. + + + +### What are the different certifications available for 3Node servers and farms? What are the Gold and Silver certifications? + +3Nodes can be certified. You can buy certified 3Nodes [here](https://marketplace.3node.global/). + +Farms can also be certified. The certifications are: [gold certified farming](https://forum.threefold.io/t/gep-gold-certified-farming-specs-closed/2925) and [silver certified farming](https://forum.threefold.io/t/silver-booster-request-for-comments/3416). + +Note that gold and silver certifications are still being discussed. Join the discussion on the [ThreeFold Forum](http://forum.threefold.io/). + + +### What is the difference between V2 and V3 minting? + +V2 is being sunset. New miners should directly onboard to V3. +On the tokenomics side, V2 rewards decrease as the difficulty level increases. For the V3 rewards, the rewards are constant for 5 years. In short, V3 is more profitable in the long run. For more information, read [this post](https://forum.threefold.io/t/comparison-v2-vs-v3-minting/2122). + + + +### What is the TFT minting address on Stellar Chain? + +The TFT minting address on Stellar Chain is the following: GBOVQKJYHXRR3DX6NOX2RRYFRCUMSADGDESTDNBDS6CDVLGVESRTAC47 + +You can see it on the Stellar Explorer [here](https://stellar.expert/explorer/public/account/GBOVQKJYHXRR3DX6NOX2RRYFRCUMSADGDESTDNBDS6CDVLGVESRTAC47). + + + +### Can Titans and DIY 3Nodes share the same farm? + +Yes. It's one big ThreeFold family! A farm can have several 3Nodes (Titans or DIY) and each 3Node can be linked to only one farm. + + + +### Do I need one farm for each 3Node? + +No. You only need one farm. One farm can have multiple 3Nodes. When setting your farm, you will add an address for the farming rewards. All farming rewards from each 3Node of your farm will be sent to this address. Note that you can choose to have more than one farm. It is up to you. + + + +### Can a single farm be composed of many 3Nodes? + +Yes. You can have many 3Nodes on the same farm. + + + +### Can a single 3Node be on more than one farm? + +No, this is not possible. + + + +### Do I need one reward address per 3Node? + +You do not need more than one address linked to one farm. All of your 3Nodes can be connected to the same farm. Rewards per each 3Nodes will all be sent to the address linked to your farm. + + + +### How can I access the expert bootstrap mode for Zero-OS? + +You can access the expert bootstrap mode for Zero-OS at this link: [https://bootstrap.grid.tf/expert](https://bootstrap.grid.tf/expert). + + + +### When it comes to the Zero-OS bootstrap image, can I simply duplicate the first image I burnt when I build another 3Node? + +Yes. What is needed on this bootstrap image is to have the proper farm ID. The bootstrap image will be the same for all your different 3Nodes. It's a good TF farming practice to leave the bootstrap image plugged in the 3Node at all time. + + + +### If a node is unused for certain time, e.g. many months offline, will it be erased by the Grid? + +No, nodes only get deleted if the farm owner chooses to do so. Old "nodes" are really just entries in TF Chain and TF Chain does not modify or delete this data without external input. + + + +### Can a farm be erased from TF Grid? + +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? + +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. + + + +### What does the pricing policy ID of a farm represent? + +The pricing policy is the definition of how the network bills for workloads (pricing for each resource type, discounts, etc.). + + + +### What is the difference between TiB and TB? Why doesn't the TF Explorer shows the same storage space as my disk? + +Terabyte (TB) and Tebibyte (TiB) are units of digital information used to measure storage capacity and data transfer rate. While terabyte is a decimal standard unit, Tebibyte is binary. + +* 1 TB = 1000^4 bytes +* 1 TiB = 1024^4 bytes. + +There are thus more bytes in 1 TiB than in 1 TB. +1 TiB is equal to 1.099511627776 TB. + +You can play around these 2 notions by exploring this [TiB-TB converter](https://www.dataunitconverter.com/tebibyte-to-terabyte/). + +You can also check [this table](https://www.seagate.com/ca/en/support/kb/why-does-my-hard-drive-report-less-capacity-than-indicated-on-the-drives-label-172191en/) to compare different OS system's storage representation. + + + +## Farming Rewards and Related Notions + +### What are the rewards of farming? Can I get more rewards when my 3Node is being utilized? + +By connecting a 3Node to the Grid, you get Farming Rewards. If you set a public IP address for the Grid to use, you will receive additional rewards when your 3Node is being utilized by users on the Grid. All rewards are paid in TFT. To know the potential rewards, use the [simulator](https://simulator.grid.tf/). More information on sales channel will be communicated in the future. + + + +### How can I know the potential farming rewards for Grid Utilization? + +Go on the [ThreeFold simulator](https://simulator.grid.tf/), enter your 3Node resources, check the Public IP address. This will enable farming rewards from the parameter NU Required Per CU. Check the difference in the farming rewards per month. Note that you will need a Public IP address. + + + +### What is the easiest way to farm ThreeFold tokens (TFT)? + +Buy a [certified 3Node](https://marketplace.3node.global/index.php). This is more or less *plug n play*! You can also build a [DIY 3Node](#what-are-the-general-requirements-for-a-diy-3node-server). It's fun and there are many resources to help you along the way. + + + +### When do I receive my rewards? + +They are distributed once a month, around the 8th*. Distributions are not daily, or after a certain threshold. Note that upcoming minting rules may have a 24 month lockup or until 30% utilization for 3 months on your 3Node. + +*This can change slightly depending on the current situation. + + + +### Do farming rewards take into account the type of RAM, SSD, HDD and CPU of the 3Node server? + +No. The farming rewards do not take into account the specific type of RAM, SSD, HDD and CPU. The farming rewards take into account the quantity of storage and compute units (e.g. TB of SSD/HDD, GB of RAM, # of virtual cores). + + +### Can I send my farming rewards directly to a crypto exchange? + +This is not possible. When you send tokens to a crypto exchange, you need to include a memo with your wallet address and the current farming rewards system of ThreeFold is already using that memo space to send the correct farming information. + + +### Do I need collateral to farm ThreeFold tokens? + +Many decentralized data projects require collateral, but not ThreeFold. There is an ongoing discussion on collateral. Join the discussion [here](https://forum.threefold.io/t/should-tft-collateral-be-required-for-3nodes/3724). + + +### Can I add external drives to the 3Nodes to increase rewards and resources available to the ThreeFold Grid? + +As of now, you cannot add external drives to a 3Nodes. It is not yet supported. It might be in the future and we will update the FAQ if/when this happens. + + + +### Do I have access to the TFT rewards I receive each month when farming? + +For now, V3 farming rewards are distributed as TFT on Stellar and they are immediately available. The lock system will be implemented on chain. Tokens will be staked to your address until unlock conditions are met. Conditions are: 2 years of farming or 30% of proof-of-utilization for 3 months per 3Node. + + + +### What is TFTA? Is it still used? + +Note that on V3, TFTA will not be issued anymore. + + + +### Is there a way to certify a DIY 3Node? How can I become a 3Node certified vendor and builder? + +As of now, only certified ThreeFold partners can certify a 3Node. You could become a ThreeFolder vendor and offer certified 3Node. Read more [here](https://marketplace.3node.global/index.php?dispatch=companies.apply_for_vendor). + + + +### Does it make sense to make my farm a company? + +There is no general answer to this. Here's what a ThreeFold member thinks about this if you are living in the USA. Check for your current location if this makes sense for you. DYOR. + +> "Definitely do this project as a business entity. You can write off equipment, utilities and a portion of your home's square footage if your are hosting the equipment at home." TFarmer + + + +### What is the difference between uptime and downtime, and between online and offline, when it comes to 3Nodes? + +Uptime and status are two different things. As long as the 3Node is powered on, its uptime does not reset. Its status changes to offline if it hasn't made an uptime report in the last two hours. Even if after more than two hours, the 3Node isn't yet online, the uptime does not reset. Uptime is a function of the system being powered on. + + +### My 3Node server grid utilization is low, is it normal? + +This is normal. Currently, not all 3Nodes are being utilized by users on the ThreeFold Grid. Each month, more and more utilization happens and the ThreeFold Grid continually expans. To read on the ThreeFold Grid utilization and expansion, check this [TF Forum post](https://forum.threefold.io/t/grid-stats-new-nodes-utilization-overview/3291). + + + + +## 3Node Farming Requirements + + +### Can I host more than one 3Node server at my house? + +Yes, but do not host more than your bandwidth can support. + + + +### Is Wifi supported? Can I farm via Wifi instead of an Ethernet cable? + +No. Wifi is not supported by Zero-OS due to a number of issues, like reliability, performance, configuration requirements and driver support. It's all about Ethernet cables here. + + + +### I have 2 routers with each a different Internet service provider. I disconnected the ethernet cable from one router and connected it to the other router. Do I need to reboot the 3Node? + +You do not need to reboot. The 3Node will be able to reconnect to the ThreeFold Grid. + + + + +### Do I need any specific port configuration when booting a 3Node? + +No, as long as the 3Node is connected to the Internet via an ethernet cable (wifi is not supported), Zero-OS will be able to boot. Usually with the DHCP, it automatically assigns an IP address. + + + +### How much electricity does a 3Node use? + +A small DIY 3Node based on a compact office computer will draw under 20W. A full size server will draw around 100W idling. Note that a 3Node actively used on the Grid (proof-of-utilization) will draw more power, but also generate passive income on top of farming if you have a public IP address. + +For more information, read thes section [Calculate the Total Electricity Cost of Your Farm](../farmers/farming_optimization/farming_costs.md#calculate-the-total-electricity-cost-of-your-farm) of the Farming Guide. + + + +### Has anyone run stress tests to know the power consumption at heavy load of certain 3Nodes? + +The community is starting to gather some data on this. As of now, we know that a R720 with 2x2690v2 cpu, 4TB NVME SSE P4510 and 320GB ram will draw 390W @100% load. With 2x2650L v2, it's around 300W with fans at full speed. More info will be added as we gather more data. + +### Can the Titan 3Node be run on Power Over Ethernet, PoE? + +Titans don't come equipped for Power Over Ethernet (PoE). If you have a NUC based Titan there are some PoE lids that might be compatible. + + + +### What is the relationship between the 3Node's resources and bandwidth? + +A 3Node connects to the ThreeFold Grid and transfers information, whether it is in the form of compute, storage or network units (CU, SU, NU respectively). The more resources your 3Nodes offer to the Grid, the more bandwidth will be needed to transfer the additional information. + + +### What is the bandwidth needed when it comes to running 3Nodes on the Grid? + +The strict minimum for one Titan is 1 mbps of bandwidth. + +If you want to expand your ThreeFold farm, you should check the following to make sure your bandwidth will be sufficient when there will be Grid utilization. + +> min Bandwidth per 3Node (mbps) = 10 * max((Total SSD TB / 1 TB),(Total Threads / 8 Threads),(Total GB / 64 GB)) + 10 * (Total HDD TB / 2) + +This equation means that for each TB of HDD you need 5 mbps of bandwidth, and for each TB of SSD, 8 Threads and 64GB of RAM (whichever is higher), you need 10 mbps of bandwidth. + +This means a proper bandwidth for a Titan would be 10 mbps. As stated, 1 mbps is the strict minimum for one Titan. + +The bandwidth needed for a given 3Node is not yet set in stone and you are welcome to participate in ongoing the [discussion on this subject](https://forum.threefold.io/t/storage-bandwidth-ratio/1389) on the Forum. + + + +### Can I run Zero-OS on a virtual machine? + +You can. But you won't farm TFT. To farm TFT, Zero-OS needs to be on bare metal. + + +### Is it possible to build a DIY 3Node with VMWare VM ? + +It wouldn't be possible to get farming rewards from such configuration. You need to run a 3Node Zero-OS on bare metal and no virtual machine is permitted. Indeed, to farm TFT you need bare metal. Virtual Machine will not work. Furthermore, all disks of a 3Node need to be wiped completely, thus no other OS can be on the 3Node. + +It would be possible to simply set Zero-OS as a VM on VMWare VM, but it wouldn't farm as stated. + + +### Can I run a 3Node on another operating system, like Windows, MAC or Linux? + +No. ThreeFold runs its own operating system (OS), which is Zero-OS. You thus need to start with completely wiped disks. + +### What is the minimum SSD requirement for a 3Node server to farm ThreeFold tokens (TFT)? + +You need a theoretical minimum of 500 GB SSD on a desktop or server. Less could work. + + + +### Is it possible to have a 3Node server running on only HDD disks? + +This is not possible. A 3Node needs at least one SSD disk of 500 GB. + + + +## Building a 3Node - Steps and Details + + +### How can I be sure that I properly wiped my disks? + +A wiped disk has: +- no label +- no partition +- no filesystem +- only zeroes + +On Linux to see if the disk is only composed of zeroes, use the command line (example with disk sda): + +> cmp /dev/sda /dev/zero + +If there is only zeroes, you should get the output: + +> cmp: EOF on /dev/sda + +You can also use the command line: + +> sudo pv /dev/sda | od | head + +Here are some useful command lines for Linux to make sure there are no partitions, no labels, no filesystems and that the disks are filled with zeroes only: + +> sudo fdisk -l +> +> sudo fdisk -lf +> +> sudo parted -l +> +> sudo parted /dev/sda 'print’ +> +> lsblk --f +> +> lsblk --raw + + + +### If I wipe my disk to create a new node ID, will I lose my farming rewards during the month? + +No, you wouldn't lose any farming rewards. You will get both the rewards for your previous node ID's uptime and also the new node ID's uptime. + +Note that this is the case with the current farming rewards based on total uptime, without any minimum threshold. + + + +### My disks have issues with Zero-OS and my 3Nodes. How can I do a factory reset of the disks? + +> Warning: this is destructive. It erases the disk sda in this example. + +Boot a Linux in Try mode and run the following command: + +> sudo badblocks -svw -b 512 -t 0x00 /dev/sda + +*In this example, the disk selected is sda. Choose the proper disk name in your current situation, e.g. sdb, sdc..). + +This line will read and (over)write zeroes (0x00) everywhere on the disk. + +To understand the line of code, note that 512 is the block size and that without -b BLOCKSIZE, the process would simply go slower. +0x00 represents the zero byte. + + + +This will take some time, but it should reset the disk and hopefully fix any issues. + +Note: it takes the 3Node server around 1 percentage per minute for a 2TB SSD disk to accomplish the badblock operation. + + + +### Before doing a bootstrap image, I need to format my USB key. How can I format my USB key? + +*Note that BalenaEtcher will format and burn your bootstrap image in the same process. See next Q+A for more details. + +Windows: This is done easily with diskpart. Here's all the coding needed (with disk X as an example, make sure you choose the correct disk): run Command Prompt as an administrator (right-click option), write *diskpart*, then in diskpart write *list disk*, choose your disk and write *select disk X*, write *clean*, write *create partition primary*, write *format fs=fat32*, then write *assign*. If for any reason, the process doesn't work, quit diskpart and redo the whole thing. This should fix any bug. Cautious with diskpart, it's destructive. + +MAC: This is done easily with Disk Utility. Go in Disk Utility. Select your USB key, click on *erase* on the top, write a name for your USB key, then choose a format (MS-DOS (FAT) if USB key < 32GB, exFAT if USB key > 32GB), then click *erase*, then click *done*. + +LINUX: In the Terminal, write *df*, find your disk (here we use sdX), write *sudo umount /dev/sdX*, write this line (with the proper FORMAT) *sudo mkfs.FORMAT /dev/sdX* [FORMAT= vfat for FAT32, ntfs for NTFS, exfat for exFAT], then finally verify the formatting by writing *sudo fsck /dev/sdX*. + +### What do you use to burn or to load the Zero-OS bootstrap image onto a USB stick? + +For MAC, Linux and Windows, you can use [BalenaEtcher](https://www.balena.io/etcher/) to load/flash the image on a USB stick. This program also formats the USB in the process. Rufus can also be used for Windows. + +Also, got Linux systems, you can transfer the dowloaded image with the dd command: *dd if=created_boot_loader_file.img of=/dev/sd?* where the input file is the downloaded file from http:/bootloader.grid.tf and the output file (device) is the USB stick device. + + +### Should I do a UEFI image or a BIOS image to bootstrap Zero-OS? + +It depends on your 3Node's system. Newer computers and servers will accept UEFI. If it does not work with UEFI, please try with the options ISO (BIOS CD/DVD) or USB (BIOS image) on the [ThreeFold bootstrap website](https://bootstrap.grid.tf). Read the next Q+A for more information on BIOS/UEFI. + + + +### How do I set the BIOS or UEFI of my 3Node? + +You can read this [documentation](../farmers/3node_building/5_set_bios_uefi.md) to learn more about BIOS and UEFI settings for a DIY 3Node. + + + +### For my 3Node server, do I need to enable virtualization in BIOS or UEFI? + +Yes, you should enable virtualization. On Intel, it is denoted as *CPU virtualization* and on ASUS, it is denoted as *SVM*. Make sure virtualization is enabled and look for the precise terms in your specific BIOS/UEFI. + + + +### How can I boot a 3Node server with a Zero-OS bootstrap image? + +Plug the USB key containing the Zero-OS bootstrap image with your farm ID then power on your 3Node. If the BIOS/UEFI is set correctly and the disks are all wiped, it should boot correctly the first time. If you have any problem booting your 3Node, read the section [Troubleshooting and Error Messages](#troubleshooting-and-error-messages) of the FAQ. + + + +### The first time I booted my 3Node server, it says that the node is not registered yet. What can I do? + +The first time you boot a 3Node, it will be written: “This node is not registered (farmer *: NameOfFarm). This is normal. The Grid will create a node ID and you will be able to see it on screen. This can take a couple of minutes. + +If after some time (couple hours), the 3Node doesn't get registered, there might be something off with the Grid connection. You can then try to reboot the 3Node, or wait and boot it later. If it persists, you can check the rest of the Troubleshooting section of the Farmer FAQ, or ask around the ThreeFold Telegram Farmer chat or the ThreeFold chat for help. + + + +### The first time I boot my 3Node, the node gets registered but it says cache disk : no ssd. What can I do? + +This probably means that you either haven't connected a SSD or that you need to wipe your SSD disk(s). Zero-OS runs on bare metal and needs a minimum of one SSD disk (min 500GB & 50 GB per CU). You will see "cache disk : OK" when it works. + + + +### The first time I boot my 3 node, the node gets registered and it says cache disk : OK, but the table System Used Capacity is empty. What can I do? + +Most of the time, just wait and data will appear. If you want to be sure your 3Node is online on the Grid, you can check the [Node Finder](https://dashboard.grid.tf/), which fetch information every 2 hours. If it persist, first try to simply reboot your 3Node. + + + +### I have a relatively old server. I have trouble booting Zero-OS. What could I do? + +Sometimes, Zero-OS will not boot in UEFI mode on older servers. In that case, try to boot in BIOS mode. Use either a USB key or the CD/DVD optical drive (the 4th and 5th option on https://bootstrap.grid.tf/) and make sure to select BIOS and not UEFI mode in your server settings. + + +### I connected a SATA SSD to a CD-DVD optical drive adaptor. My system does not recognize the disk. What can I do? + +Try to set AHCI mode instead of Legacy mode in SATA settings in the BIOS. + + +### Can someone explain what should I put in the Public IP part of my farm? Should I just insert my Public IP and Gateway given by my ISP? + +Assuming you are a DIY farmer and operate from your home, this field can be left blank. You do not have to fill in any details. + +The add IP option is for farmers that have a block of IP addresses routed to their router (in data centers mostly) and want to present “dedicated IP” addresses for deployments. For more information on how to set the public configuration, go to [this link](https://library.threefold.me/info/manual/#/manual__public_config). + + + + + +## Farming Optimization + +### What is the difference between a ThreeFold 3Node and a ThreeFold farm? What is the difference between the farm ID and the node ID? + +A farm is a composition of one or many 3Nodes. A 3Node is a computer connected to the ThreeFold Grid. Each farm has its farm ID and each 3Node has its node ID. + + + +### How can I know how many GB of SSD and RAM do I need? + +You need 50 GB of SSD per compute units (CU) and a minimum of 500 GB SSD and 2 GB of RAM per 3Node. + +A 3Node has, in general, 2 compute units (CU) per thread. Thus, for peak optimisation, you need 100 GB SSD and 8GB RAM per thread. + +### What is the optimal ratio of virtual cores - vcores or threads - SSD storage and RAM memory? What is the best optimization scenario for a 3Node, in terms of TFT farming rewards? + +In short, for peak optimization, aim for 100 GB SSD of storage and 8GB RAM of memory per virtual core (vcore or thread). + +For example, a 32 threads (32 vcores) 3Nodes would need 3.2 TB SSD and 256GB RAM to be optimal, reward-wise. +That is: 32 * 100 = 3200 GB SSD = 3.2TB SSD, and 32 * 8 = 256 GB RAM total. + +Adding more GB of RAM would not increase your TFT rewards. You would need more vcores if you want to expand. + +NB: This is purely based on reward considerations. Some users might need different ratios for different specific uses of the Grid. + + + +### What does TBW mean? What is a good TBW level for a SSD disk? + +TBW means Terabytes Written. TBW directly measures how much you can write cumulatively into the drive over its lifetime. For your 3Node, it can be a good idea to prioritize a minimum ratio of 500 TBW per 1TB for SSD. + +*Note that TBW is not a technical specification, but a general claim from the manufacturer. For this reason, it can also be good to check the warranty of the disk. For example, if a manufacturer offers a 5-year warranty to its product, it indicates that the company thinks its product will last a long time. + + +### Are SATA and SAS drives interchangeable? + +This goes only one way. You can put a SATA drive in a SAS slot, but you can’t put a SAS drive in a SATA slot. See the [next question](#what-is-the-speed-difference-between-sas-and-sata-disks) for more information. + + +### What is the speed difference between SAS and SATA disks? + +One of the big differences between SATA and SAS is the transfer speed. Using SATA disks with SAS cables, you will be limited by the SATA transfer speed. + +* Sata I : 150 MB/s +* Sata II : 300 MB/s +* Sata III : 600 MB/s +* SAS : 600-1500 MB/s + +Note: You will most probably need to re-flash the raid card if you use the front panel disks (onboard storage) of your server. + + + + +### Is it possible to do a graceful shutdown to a 3Node server? How can you shutdown or power off a 3Node server? + +There are no "graceful" shutdowns of 3Nodes. You can shutdown a 3Node from the software side. You need to shut it down manually directly on the hardware. 3Nodes are self-healing and if they suddenly power down, no data or information will be lost. + + + + +### Is it possible to have direct access to Zero-OS's core to force a reboot? + +No, this is not possible. The general philosophy with Zero-OS is: no shell, no GUI, and no remote control. In other words, anything that could potentially provide attack surface is off the table. This ensures a high security level to Zero-OS and the ThreeFold Grid in general. To reboot a 3Node, you have to do it manually. + + + +### Do I need some port forwarding in my router for each 3Node server? + +No, this is not needed. + + +### Are there ways to reduce 3Node servers' noises? + +To reduce the noise, you can remove all the unnecessary cards in the servers as well as the HDD disks if you don't use them. Unplugging the SAS cables can also help. You can also set the fans to adjust their speed instead of being constant. + +At the end of the day, servers were manufactured for durability and efficiency, and not for being quiet. Most servers are placed in server rooms where noise doesn't matter much. + + + +### I built a 3Node out of old hardware. Is it possible that my BIOS or UEFI has improper time and date set as factory default? + +Yes. Make sure you have the correct time and date in BIOS to avoid errors when trying to boot Zero-OS. It might not cause any problems, but sometimes it does. + + + +### I have rack servers in my ThreeFold farm. Can I set rack servers vertically? + +In general, it is not recommended to set rack servers vertically as they were designed to be laid flat in racks. That being said, if you want to set your rack vertically, here are some general rules to follow. Do so at your own risk. + +First, make sure the parts in the servers are well installed and that they will not fall if laid vertically. Second, and foremost, you want to make sure that there will not be any overheating. This means to make sure you don't block the front and rear of the unit, so heat can dissipate thought the vents. + +If you want to put the rack vertically with the longest side of the rack laying upward, having the power supply units (PSUs) on the very top will ensure that heat dissipate well. + + + + +## Farming and Maintenance + +### How can I check if there is utilization on my 3Nodes? + +To see if there is utilization on your 3Node, you can consult the [TF Dashboard](https://dashboard.grid.tf/), go to the Farm section and consult the information under your 3Nodes. Note that the quickest way is to check if there are CPUs reserved. + + + +### Do I need the Zero-OS bootstrap image drive when I reboot, or can I boot Zero-OS from the 3Node main hard drive? + +It is advised to keep the bootstrap image plugged in your 3Node. Once your node has been booted with Zero-OS via the USB key, you can remove the USB key, but if something happens and the node needs to reconnect with the network, it won’t be able to do so. We advise people to let the USB key always in so the node can reconnect with the network if needed. + +You need the bootstrap image device plugged in every time you reboot a 3Node and it's a good practice to keep it plugged in all the time. The technical explanation is: (1) at first boot, it creates a minimum requirement on SSD which is used as cache (2) each time the system restarts it reuses this SSD piece but Zero-OS bootstrap is also needed to download the last image. Indeed, image is not stored on the machine and also no boot loader is installed. + + +### It's written that my node is using 100% of HRU. What does it mean? + +HRU stands for your HDD space available. It means that you are using 100% of the HDD space available, or equivalently that you have no HDD on your system. + + +### On the ThreeFold Node Finder, I only see half of the virtual cores or threads my 3Node has, what can I do? + +Check in the BIOS settings and make sure you have enabled Virtual Cores (or Hyper Threading/Logical Cores). + + + +### Why are the 3Nodes' resources different on the ThreeFold Node Finder and the ThreeFold Dashboard? + +There is a difference because one shows the resources in GiB and the other in GB. It's just a way to display information, the resources are ultimately the same, but shown differently. 1 GiB = 1.073741824 GB. + + + +### How can I test the health of my disks? + +There are many ways to test the health of your disks. For some information on this, you can have a look at this [TF forum post](https://forum.threefold.io/t/testing-ssd-health/3436). + + + +### How can I transfer my 3Node from one farm to another? + +To transfer your 3Node from one farm to another, simply make a new bootstrap image of the new farm, connect the new bootstrap image to the 3Node and restart the node. + +Note that you can use [balenaEtcher](https://etcher.balena.io/) to format and burn the bootstrap image at the same time. + + + +### What do CRU, MRU, HRU and SRU mean on the ThreeFold Node Finder? + +CRU means the number of virtual cores. MRU means the GB of ram (memory). HRU means the HDD capacity storage and SRU means the SSD capacity storage. + + + +### I have more than one ThreeFold 3Node farm, but I want all my 3Nodes on only one farm. How can I put all my 3Nodes on one farm? How can I change the farm ID of my 3Node? + +If you have more than one 3Node associated with more than one farm, it is possible to put all the 3Nodes under only one farm. +The following shows how to change the farm ID of your 3Node. + +For each 3Node, you need to create a new USB key Zero-OS boostrap image associated with the chosen farm ID. This will ensure your 3Node links to the chosen farm. +To create a new USB key Zero-OS bootstrap image, you can download the bootstrap image [here](https://v3.bootstrap.grid.tf/) or you can clone an existing USB key bootstrap image associated with the chosen farm ID. In both case, you can use a software like [BalenaEtcher](https://www.balena.io/etcher/). +Once you have the new USB key bootstrap image, plug it into the 3Node and reboot the server. +After reboot, the 3Node will have the same node ID as before, but it will now be associated with the chosen farm ID. + +Note: If you want a new node ID for your 3Node, you will need to wipe the main SSD of your 3Node. + + + +### How can I know if my 3Node is online on the Grid? + +There are multiple answers to this. + +(1) You can plug a monitor to your 3Node and check directly its status. + +(2) You can check your 3Node status by using the Node Finder of the [ThreeFold Dashboard](https://dashboard.grid.tf/). + +(3) You can also use the unofficial, but highly useful [ThreeFold Node Status Bot](https://t.me/tfnodestatusbot) on Telegram. + + + +### I booted my 3Node and the monitor says it's online and connected to the Grid. But the ThreeFold Node Finder says it is offline? What can I do? + +The Node Finder refetches information every 2 hours. You can wait 2 hours and see if the problem persists. Then/or, you could reboot the 3Node and see if the Node Finder sees it as online. + + + +### My 3Node does show on the ThreeFold Node Finder, but not on the ThreeFold Dashboard, what can I do? + +If you're 3Node is correctly registered on the ThreeFold Grid but you cannot see it on the ThreeFold Dashboard, there can be many different ways to solve this issue. + +One way to fix this is to go in the TF Dashboard, select *change the address* and then simply re-paste the same address, then the extension will ask you to resign. Usually this fixes the issue. + +If the first method did not work, you can try to remove the account and add it back up on the Polkadot.js extension. Before doing so, make sure you have a back up of your seed phrase as you will need it to re-enter the account. Your 3Node should then appear. + + +### If I upgrade my 3Node, will it increase my rewards? + +Yes. Use the simulator to verify the additional rewards. But note that, currently, upgrades are not recognized until the next minting cycle. + + +### I booted my 3Node for the first time at the beginning of the month, then I did some upgrade or downgrade, will the ThreeFold Grid recognize the new hardware? Will it still be the same 3Node ID? + +Downgrades are counted in the current minting cycle. So you mint for the entire cycle at the downgraded specs. + +Minting only considers a single configuration per node per cycle, and that is the minimum configuration seen at any point during the cycle. With this logic in mind, upgrades will only be recognized at the next minting cycle. Note that your 3Node will have a new ID and new price entry if you changed the SSD containing the 3Node ID. + + + + + + +### Is it possible to ask the 3Node to refetch the node information on the monitor? + +To refetch information, press " q " on the keyboard. + + + +### When does Zero-OS detect the capacity of a 3Node? + +Zero-OS only detects capacity right after it boots. + + + + +### Where is the 3Node ID stored? + +For the current Zero-OS version, the node ID is stored in the first SSD you install on your 3Node*. If you change or erase this disk, this disk will lose its current 3Node ID. + +*Note that if, at the first boot, you put a SSD SATA and a SSD NVME at the same time, the node ID will be registered on the SSD SATA. + + + + +### Is there a way to backup my node ID in order to restore a 3Node if the disk with the node ID gets corrupted or breaks down? + +Yes, you can do a backup, but as of now this process must be done manually. + +One way is to boot a Linux USB image in *Try* mode, open up the *File* folder of your disk that contains the node ID. Click on *+ Other Locations.* Then, open the folder that contains the folder *zos-cache* and open the folder *identityd.* In this folder, select the file *seed.txt* and make a copy of it in a safe place (USB key, notebook, e-mail, etc.). If the disk which contains your node ID is damaged, simply reboot the 3Node with a new disk and the Zero-OS bootstrap image. Your 3Node will connect to the Grid and assign a new node ID. Once this is done, reboot the 3Node, but this time with the Linux USB image, go in the same folder as stated before and replace the new *seed.txt* file with the old file. Reboot your 3Node with the Zero-OS bootstrap and you're done. + + + +### If I upgrade my 3Node, does it change the node ID? + +Upgrades won't change the node ID, unless you replace the SSD where the node ID is stored (see above for more info on this). + + + + +### Does it make sense to recreate my node when the price drops? + +Short answer: no. Long answer: [click here](https://forum.threefold.io/t/does-it-make-sense-to-recreate-my-node-when-the-price-drops/). + + +### My 3Node lost power momentarily and I had to power it back on manually. Is there a better way to proceed? + +In your BIOS, go in *Security Settings* and choose *Last* for *AC Power Recovery*. If you want, set a delay between 60 and 240 seconds. This will ensure your 3Node does not power on and off frantically if your power flickers on and off, thus potentially damaging the unit. On other BIOS, it's *After Power Loss*, and you should choose *Previous State*. + +*Depending on your 3Node, the parameter might have a different name. + + +### Do I need to change the battery BIOS? + +It can be a good thing to change it when you buy an old desktop or server to make sure it lasts long. When the battery goes out of power, the 3Node won't have access to the BIOS settings if it loses power momentarily. + + + +### Do I need to enable UEFI Network Stack? + +You don't need to if you use a removable media (e.g. USB key) as a booting image. It is needed only if you boot from a PXE server on your network. You should keep this feature disabled. Enable it only if you know 100% what you are doing. Otherwise it might bring vulnerabilities in terms of network security. + + +### I want redundancy of power for my 3 nodes. I have two PSU on my Dell server. What can I do? + +Make sure you enable the Hot Spare feature. This feature is accessible in iDRAC Settings - Power Configuration. Other servers might have this function, with a different name and configuration. Check the server's manual for more details. + + + +### Why isn't there support for RAID? Does Zero-OS work with RAID? + +RAID is a technology that has brought resilience and security to the IT industry. But it has some limitations that we at ThreeFold did not want to get stuck in. We developed a different (and more efficient way to store data reliably. Please have a look [here](https://library.threefold.me/info/threefold#/cloud/threefold__cloud_products?id=storage-quantum-safe-filesystem). + +This Quantum Safe Storage overcomes some of the shortfalls of RAID and is able to work over multiple nodes geographically spread on the TF Grid. + + +### Is there a way to bypass RAID in order for Zero-OS to have bare metals on the system - No RAID controller in between storage and the Grid ? + +Yes it is possible. "You can use the on board storage on a server without RAID. You can [re-flash](https://fohdeesha.com/docs/perc.html) the RAID card, turn on HBA/non-RAID mode, or install a different card. No need for RAID." @FLnelson It's usually easy to set servers such as a HP Proliant with the HBA mode. For Dell servers, you can either cross-flash the RAID controller with an “IT-mode-Firmware” (see this [video](https://www.youtube.com/watch?v=h5nb09VksYw)) or get a DELL H310-controller (which has the non-RAID option). Otherwise, you can install a NVME SSD with a PCIe adaptor, and turn off the RAID controller. + + + +### I have a 3Node rack server. Is it possible to use a M.2 to SATA adapter in order to put the M.2 SATA disk in the HDD bay onboard storage? + +Yes, it is possible. You will most probably need to bypass the RAID controller for Zero-OS to access properly the onboard storage. See previous question. + + + +### My 3Node uses only PCIe adapters and SSD NVME disks. Do I need the RAID controller on? + +The onboard RAID controller is not linked to your PCIe SSDs. In this case, you can switch the RAID controller off. + + + +### Can I change the name of my farm on polkadot.js? + +It’s possible to rename farms through the Polkadot UI. For mainnet, use [this link](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Ftfchain.grid.tf#/extrinsics). + +1. Under *using the selected account*, select the account that owns the farm +2. Choose *tfgridModule* from the dropdown menu *submit the following extrinsic*, +3. Select *updateFarm(id, name, pricingPolicyId)* +4. Under *name: Bytes*, write the new farm name +5. Finally, click on the bottom *Submit Transaction* at the bottom right of the screen + + + +### How can I delete a farm on polkadot.js? + +The ability to delete a farm was removed from TF Chain due to concerns that nodes could be left without a farm and thus cause problems with billing. + + + +### I try to delete a node on the TF Dashboard, but it doesn’t work. Is there any other way to proceed that could work? + +It’s possible to delete nodes through the Polkadot UI. For mainnet, use [this link](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Ftfchain.grid.tf#/extrinsics). + +1. Under *using the selected account*, select the account that owns the farm, +2. Choose *tfgridModule* from the dropdown menu *submit the following extrinsic* +3. Select *deleteNodeFarm(nodeId)* +4. Under *id: u32*, write the ID of the 3Node you want to delete +5. Finally, click on the bottom *Submit Transaction* at the bottom right of the screen + + + +### My 3Node has 2 ethernet ports in the back, with one written AMT above, what does it mean? Can I use this port to connect my 3Node to the ThreeFold Grid? + +First, let's define the term AMT. It means: Active Management Technology. Without going into too much details, it is to remotely access servers via the network at the BIOS level. Thus, you should plug the ethernet cable in the port next to AMT, and not into the AMT port. You can explore AMT properties if you want remote access to your server. + + + +### My 3Node is based on a the hardware Z600, Z620 or Z820, can I run it headless or without a GPU? + +For the Z600, there is a great [video on youtube](https://www.youtube.com/watch?app=desktop&v=JgBYbaT-N-w). + +For the Z620 and the Z820, you need to do some variation on the video above. In the BIOS, go in File, then Replicated Setup, and select Save to Removable Storage Device. This will save a text file on your USB key. Then, in the text file, go to Headless Mode and remove the * in front of Disable and put it in front of Enable. Save the file and then go back into BIOS. Now go in File, then Replicated Setup, and select Restore from Removable Storage Device. + +Running your 3Node without the GPU can save some power consumption as well as giving you one more extra slot for other hardware. + + +### Is it possible to add high-level GPU on rack servers to farm more TFT? + +Some farmers had success installing GPUs such as the RTX3080 in servers as small as 2U (such as R730). Connections such as 250W 8-pin plug are needed on each riser. Generally, tower servers have more space to add high-level GPU. + +Note: GPU farming will be implemented in the future. + + + +### If I change farm, will my node IDs change on my 3Node servers? + +You can move 3Nodes between farms without losing the node IDs. You simply need to change the boot media with the new farm ID and then reboot the 3Node. The 3Node will have the same node ID but it will now be associated with the new farm ID. + + +## Troubleshooting and Error Messages + +### Is it possible to access the Error Screen or Log Screen? + +Yes! On the Zero-OS console, hit alt-F2 to open up the Error/Log Screen, and hit alt-F3 to go back to the main screen. + + +### What does it mean when I see, during the 3Node boot, the message: error = context deadline exceeded? + +In general, this message means that the ThreeFold Grid asked something to your 3Node, and your 3Node could not respond fast enough. It is usually necessary to read the following error message to understand the situation more specifically. + + +### I try to boot a 3Node, but I get the error: "No Route to Host on Linux". What does it mean? + +There are many potential answers to this. Perhaps the Host is offline, the service isn't running. This is usually the reason with TF Grid. It means the Grid is not responsive. In this case, try to boot the 3Node later. If it persists ask TF Support. + +There can also be other reasons. You might have connected to the wrong port. Perhaps you have configured iptables to block connections on that port. Your DNS might be improperly configured. You might have an Incorrect Network or Host Configuration. Many troubleshoots are possible. Here's a [good place to start](https://www.maketecheasier.com/fix-no-route-to-host-error-linux/). + + + +### How can I fix the error: "Network configuration succeed but Zero-OS kernel could not be downloaded" when booting a 3Node? + +To fix the error "Network configuration succeed but Zero-OS kernel could not be downloaded", you can try to restart the router and reboot the 3Node. This usually fixes the issue. If this doesn't work, check if the router is still functional. The cause of this issue might be that your router is broken. + + + +### Using SAS disks, I get the error; "No ssd found, failed to register". What can I do to fix this? + +First make sure to wipe the disks and then boot your 3Node. If you've wiped the disks and it doesn't work, it's been reported that using the command "diskpart clean command" on Windows can fix this issue. + + + +### When booting a 3Node, how to fix the error: "no disks: registration failed"? + +There can be many different fixes for this error. Here are some troubleshooting tips to test separately: + +* In BIOS, enable AHCI +* Make sure to [wipe the disks](../farmers/3node_building/4_wipe_all_disks.md) of the 3Nodes +* If the 3Node has a RAID Controller: + * Disabled the RAID controller, OR; + * [Flash the RAID controller](https://fohdeesha.com/docs/perc.html) (i.e. crossflashing), OR; + * Change the controller to a Dell H310 controller (for Dell servers) +* Try the command **badblocks** (replace **sda** with your specific disk). Note that this command will delete all the data on the disk + * ``` + sudo badblocks -svw -b 512 -t 0x00 /dev/sda + ``` + + +### My SSD is sometimes detected as HDD by Zero-OS when there is a reboot. Is there a fix or a way to test the SSD disk? + +If your SSD disk shows as HDD, usually you can reboot the 3Node and Z-OS adjusts correctly. + +Anyone experiencing frequently this issue where Z-OS sometimes detects an SSD as HDD can try the following: + +* Boot up a live Ubuntu Desktop image +* Run the benchmark utility within the Disks app +* Check if the seektime of the disk is sufficient for Z-OS + * If the seektime is above 0.5ms, Z-OS will consider your SSD as HDD + +**Detailed Steps:** + +* Boot a Ubuntu Linux live USB +* Install **gnome-disks** if it isn't already installed: + * ``` + sudo apt install gnome-disks + ``` +* Open the application launcher and search for **Disks** +* Select your disk +* Click on the tree dots menu +* Select **Benchmark Disk...** + * Use the default parameters + * **Transfer rate**: This is not relevant for our current test + * You can set to it to minimum (e.g. 2) + * **Sample size**: 10 MB is sufficient +* Check the average access time on the [ThreeFold repository](https://www.github.com/threefoldtech/seektime) + * Check seek time for HDD and SSD + * A SSD needs to be <=0.5ms +* If the result is above 0.5ms, this is why Z-OS doesn't recognize the disk properly + * You can then run diagnostics (e.g. smartmontools) + * If this is not fixable, you should change disk (e.g. take a more performing disk) + +Note: The green dots on the output represent seektime and that's what Z-OS is looking at. Specifically, it checks that the average seektime is below 0.5ms. If the seektime is above this, Z-OS will consider your SSD as HDD. + + + +### When booting a 3Node, I get the message: failed to register node: failed to create node: failed to submit extrinsic: Invalid Transaction: registration failed. What could fix this? + +The most probable fix to this error is simply to properly wipe your disk(s): + +* [Wipe your disks on Linux](#what-can-you-do-to-zero-out-your-disks-how-can-i-wipe-the-disks-of-my-3node-server-with-linux) + +* [Wipe your disks on Windows](#how-can-i-wipe-a-disk-with-windows) + + +### I try to boot a 3Node, but I get the message no route with default gateway found. What does it mean? + +First, let's see the main terms. Default gateway act as an access point to other networks, in this case the TF Grid, when there is a back and forth exchange of data packets. + +While the last question implied a communication problem from the Grid, this error message usually means that the 3Node has communication problem. In short, it has difficulty reaching the TF Grid. There are many ways to troubleshoot this error. First, let's give the most direct solution. Make sure you have a direct connection with your Internet Service Provider (ISP): your 3Node should be connected to a router or a switch via an ethernet cable. Wifi doesn't work. Make sure your DHCP is set correctly. + +If the problem persists, check the default gateway of your 3Node and then make sure your router can reach it. + +*See next Q+A for more a possible solution. + + + +### I have trouble connecting the 3Node to the Grid with a 10GB NIC card. What can I do? + +As of now, Zero-OS sometimes has trouble with 10GB NIC card. The easiest solution to this is to connect your 3Node with the 1GB NIC card. This should solve the issue. More fine tuning might be needed to get your 3Node to work with a 10GB NIC card. Future Zero-OS version might solve this issue. + + + +### I switch the ethernet cable to a different port when my 3Node was running. Internet connection is lost. What can I do? + +When your 3Node boots, Zero-OS marks the NIC port. This means you cannot change NIC port when your 3Node is running. You can either put back the ethernet cable in the initial NIC port, or reboot the 3Node. At boot, Zero-OS will marks the new NIC port as the main entry. + + + +### I get the error Certificate is not yet valid when booting my 3Node server, what can I do? + +Make sure your firmware is up to date. If necessary, reinstall it. You might have to install then re-install the firmware if your system is very old. + + + +### When running wipefs to wipe my disks on Linux, I get either of the following errors: "syntax error near unexpected token" or "Probing Initialized Failed". Is there a fix? + +Many different reasons can cause this issue. When you get that error, sometimes it is because your are trying to wipe your boot USB by accident. If this is not the case, and you really are trying to wipe the correct disk, here are some fixes to try out, with the disk `sda` as an example: + +* Fix 1: + * Force the wiping of the disk: + * ``` + sudo wipefs -af /dev/sda + ``` +* Fix 2: + * Unmount the disk then wipe it: + * ``` + sudo umount /dev/sda + ``` + * ``` + sudo wipefs -a /dev/sda + ``` + + + +### I did a format on my SSD disk, but Zero-OS still does not recognize them. What's wrong? + +Formatting is one thing, but to boot properly, Zero-OS needs to work on a completely wipe disk. Thus, make sure you [wipe your disks](#what-can-you-do-to-zero-out-your-disks-how-can-i-wipe-the-disks-with-linux). Formatting is not enough. + + + +### I have a Dell Rx10 server - R610, 710, 910. When I boot Zero-OS I get the message Probing EDD and the 3Node doesn't boot from there. What can I do? + +For the R610 and 710, you can simply re-flash the card. See [this link](https://fohdeesha.com/docs/perc.html) for more information. For the 910, you can’t re-flash the card. In this case, get a LSI Dell card and it should work. (They are cheap when you buy them used online.) + + +### My 3Node doesn't boot properly without a monitor plugged in. What can I do? + +First, try to disable the "Halt On" mode in BIOS. If you do not have this option, try simply enabling the Legacy Support (Dell BIOS for example). If this doesn't work, try to plug in a Dummy Plug/Headless Ghost/Display Emulator in your 3Node. This will simulate a plugged monitor. This should fix the problem. + + +### My 3Node is running on the Grid, but when I plugged in the monitor, it states: Disabling IR #16. Is there a problem? + +In general, you can simply ignore this error statement. This error is linked to the Nvidia binary driver. It simply means that your 3Node lost connection with the graphic card (by unplugging and replugging the monitor for example). + + +### My 3Node won't boot without disabling the Secure Boot option, is it safe? + +In the case where you want to boot Zero-OS, disabling Secure Boot option is safe. With Secure Boot disabled, it can be easier or even necessary when it comes to booting Zero-OS. Secure Boot is used when you want to lock the BIOS/UEFI settings. + + + +### When I tried to boot my 3Node, at some point the screen went black, with or without a blinking hyphen or dash. What could cause this and what could I do to resolve the issue? + +There is a possibility that this happens because you are booting your 3Node on a HDD. A 3Node needs a minimum of 500GB of SSD to work properly. + +Also, make sure that you are using the correct boot option (Legacy BIOS or UEFI) in the Settings and that it corresponds to the correct booting image on the ThreeFold Bootstrap page. + +This problem often arises when you plugged your disks in the wrong controller. For example, try unpluging the disks from the SAS controller, and plug them in the SATA controller. Also, disable the SAS controller if needed. + +In a Legacy BIOS boot, make sure Legacy is enabled and disable *Data Execution Prevention* if possible. + +Also, it might have to do with your RAID controller configuration. Make sure this is properly set. For example, configuring all the HDD disks into one logical disk can fix this problem, or re-flashing the RAID card can also help. + + + +### My 3Nodes go offline after a modem reboot. Is there a way to prevent this? + +Yes, there are many ways to prevent this. An easy solution is to set the DHCP server to reserve local IPs for the 3Nodes MAC addresses. + +This problem is also preventable if your router stays online during the modem reboot. + +Indeed, rebooting the 3Nodes is necessary when there are local IP changes, as 3Nodes are addressed a local IP addresses when they are booted. + +The DHCP will addresses any local IP address that is available when you are booting a 3Node. Reserving local IP addresses is a good TF farming practice. + + + +### When I boot my 3Node, it reaches the Welcome to Zero-OS window, but it doesn't boot properly and there's an error message: failed to load object : type substrate..., what can I do? + +Usually simply rebooting the 3Node fixes this problem. + + + +### When I try to access iDRAC on a web browswer, even with protected mode off, I get the error The webpage cannot be found, what can I do? + +Open iDRAC in the Internet Explorer emulator extension (IE Tab) in Chrome, then update iDRAC. It should work elsewhere then. Sometimes, it will be needed to add "ST1=code" at the end of the IE Tab url. + + + +### When booting the 3Node, I get the error Network interface detected but autoconfiguration failed. What can I do? + +First make sure your network cable is plugged in and that your DHCP is working and responding. If you change the NIC port of the ethernet cable, make sure to reboot the 3Node so Zero-OS can change the NIC port attribution. + +Some farmers reported that this got fixed by simply powering off the 3Node(s), the router and modem for 2 minutes then powering it all back on. Resetting the modem and router (switch on the hardware) in the process can also help. + +If this doesn't work, try to upgrade the firmware of the NIC and the motherboard. If this still doesn't work, the NIC card might be broken. Try with another NIC card. + + + +### When I boot my Dell server, I get the message: All of the disks from your previous configuration are gone... Press any key to continue or 'C' to load the configuration utility. What can I do? + +Many changes to your server can lead to this message. + +Usually, the easiest solution is to reset the disk configuration in iDRAC's configuration utility. + +What can causes this message: + +1. During a new installation, the cables connecting to your external storage are not wired to the correct ports. +2. Your RAID adapter has failed. +3. Your SAS cables are not plugged properly or are malfunctioning. + +Note: Resetting the configuration will destroy all data on all virtual disks. Make sure you know what you are doing! In doubt, ask the TF community. + + + +### I have a Dell R620. In Zero-OS, I get the failure message No network card found and then the 3Node reebots after few seconds. The same happens for every LAN input. What can I do? + +The first thing to try here is to boot the server in BIOS mode instead of UEFI mode. If this doesn't fix the problem, try the following. + +Sometimes, this happens when the firmwares of BIOS, iDRAC, Lifecycle Controller and NIC are incompatible to each other. The solution is then to update them all correctly. Some problems can arise in the process. + +First, you should try to do the updates using iDRAC as you can update both iDRAC and BIOS there. If this does not work, try to update separate, with a live-linux distro, the BIOS, iDRAC and Lifecycle Controller. Once this is done, the server should be able to do a liveupdate, https to dell support website, via lifecycle-controller. This would update the other components. For more details on this method, watch [this video](https://www.youtube.com/watch?v=ISA7j2BKgjI). + +Note: Some farmers have reported that the Broadcom NIC card does not work well for Zero-OS and that a standard Intel PCI NIC card replacement resolved the issue. This could be a more straightforward method if updating the firmwares doesn't resolve the issue. + + + +### I am using freeDos to crossflash my raid controller on a Dell server, but I can't see the RAID controller with the Command Info. What can I do? + +Turn on the raid controller in the BIOS, otherwise freeDos does not show you the raid controller with the command Info. + + + +### Can I use a VGA to HDMI adaptor to connect a TV screen or monitor to the 3Node? I tried to boot a 3Node with a VGA to HDMI adaptor but the boot fails, what can I do? + +This might work, but it has been reported by farmers that Zero-OS might have difficulties booting when this is done with a VGA/HDMI adaptor on a TV screen. This is most likely due to the TV screen not supporting the output once the system loaded into Zero-OS. The easy fix to this issue is to use a standard computer monitor with a VGA plug. + + + +### When I try to boot my 3Node, the fans start spinning fast with a loud noise and the screen is black. What can I do to resolve this? + +There may be several causes to this issue. You can try to remove all the RAM sticks, to clean the dust and then to reseat the RAM sticks. If it still doesn't resolve the issue, you can check the RAM sticks one by one to see if one is malfunctioning. This often resolves the issue. Also, some cables might not be properly connected. + + + +### When booting Zero-OS with IPV6 configurations, I get the errors (1) dial tcp: address IPV6-address too many columns in address and (2) no pools matches key: not routable. What can I do to fix this issue? + +This usually means that the IPV6 attributed is not valid. It is also often caused when the DNS configuration does not resolve IPV6 correctly. + +To fix this issue, it is often necessary to adjust the IPV6 settings related to the router and the modem. Confirming with your Internet service provider (ISP) that the IPV6 settings are properly configured could also be necessary to fix the issue. + + + + +### When booting a 3Node, Zero-OS downloads fine, but then I get the message: error no route with default gateway found, and the message: info check if interface has a cable plugged in. What could fix this? + +Make sure you have network stack enabled in BIOS. If so, check you ethernet port and make sure that it's clean. Also make sure the ethernet rj45 connectors are clean on both ends. If that does not work, verify the state of your SATA cables. If all this doesn't work, download and re-install Zero-OS. + + + +### How can I update Dell and HP servers to Intel E5-2600v2, E5-2400v2 and E5-4600v2, when applicable? + +There are many ressources online with steps on how to do this. You can check this [youtube video](https://www.youtube.com/watch?v=duzrULLtonM) on Dell and HP servers, as welll as this [documentation](https://ixnfo.com/en/hp-proliant-gen8-update-to-support-cpu-e5-2600v2-e5-2400v2-e5-4600v2.html) for HP Proliant Gen8. + + + +### How can I update the firmware and driver of a Dell PowerEdge server? + +Dell has excellen documentation for this. Read [this](https://www.dell.com/support/kbdoc/en-us/000128194/updating-firmware-and-drivers-on-dell-emc-poweredge-servers) for the detailed steps. + + + +### When I boot a 3Node in UEFI mode, it gets stuck at: Initializing Network Device, is there a way to fix this? + +In short, booting the 3Node in BIOS mode instead of UEFI mode usually fixes this issue. + +You can make bootable USB with the USB option of the [Zero-OS bootstrap image page](https://bootstrap.grid.tf/). Make sure to boot your server using BIOS and not UEFI. In the boot sequence, make the USB as your first choice to boot. + + + +### When I boot my 3Node, it gets stuck during the Zero-OS download. It never reaches 100%. What can I do to fix this issue? + +Here are some ways to troubleshoot your 3Node when it cannot download Zero-OS completely (to 100%): + +* Sometimes, just rebooting the 3Node and/or trying a little bit later can work. +* It can help to reboot the modem and the router. +* Make sure your BIOS/UEFI is up to date. Updating the BIOS/UEFI can help. +* It can also help to set the correct date and time. + + + +### When booting a 3Node, I get the error=“context deadline exceeded” module=network error=failed to initialize rmb api failed to initialized admin mw: failed to get farm: farm not found: object not found. What can I do to fix this issue? + +Usually, the simple fix to this issue is to make sure that your bootstrap image is on the same network as your farm. For example, if you created your farm on the Main net, you should use a Main net Zero-OS bootstrap image. + + + +## ThreeFold Grid and Data + + +### How is the farming minting reward calculated? Is the Grid always monitoring my 3Node? + +The Grid uses an algorithm that does not continually monitor the 3Node. It does its best to determine uptime through occasional checking in, which we call ping. The 3Node sends a ping to the Grid and the Grid sends a ping to the 3Node to confirm the reception. (Ping-Pong!) + +It’s helpful to understand that the Grid is really just 3Nodes and TF Chain (which itself is a collection of nodes). Nodes report their uptime by writing an entry on TF Chain, about once every two hours. These reports are used for minting. + + + +### How does communication happen on the ThreeFold Grid at the 3Node's level? + +There are two ways to get information about nodes. Once is to query TF Chain, and the other is to communicate with nodes directly. + + + +### What is the ThreeFold Node Status bot Telegram link? + +The link is the following: https://t.me/tfnodestatusbot. + + + +### How does the ThreeFold Node Status bot work? How can I use the ThreeFold Node Status bot to verify if my 3Node is online? + +1. Click on this link: https://t.me/tfnodestatusbot + +2. To subscribe a node, write the command */subscribe nodeID*. With the ID 100 as example, write: */subscribe 100* + +3. To verify the status of all your 3Nodes, write: */status* + +4. To verify the status of all your 3Nodes through Yggdrasil, write: */ping* + +Note: The bot should send you alerts when it considers any registered node to be offline. + + + +### How does the Telegram Status Bot get information from my 3Node? My 3Node is online on the ThreeFold Node Finder, but offline on the Telegram Status Bot, is this normal? + +The status bot communicates directly by sending pings to the nodes over Yggdrasil every five minutes. Therefore, it will report on temporary network interruptions that might not affect your total uptime calculation as used for minting. + + + +### I noticed that when I reboot my 3Node, the uptime counter on the ThreeFold Node Finder goes back to zero. Does it mean I lose uptime and the uptime start over again when I reboot the 3Node? + +No. The only uptime you lose is the time your 3Node was offline from the ThreeFold Grid. This ThreeFold Grid still has the data of your total uptime of the month. The Node Finder only shows this statistics as: "*This node has been up non-stop without being rebooted for now* [insert time]". If you maintain a total uptime above the minimum uptime, you're fine. + +*For now the farming rewards are proportional to the total uptime. + + +### One of my nodes is showing the wrong location. Any problem with that? +The ThreeFold Node Finder is showing your ISP location. This is perfectly normal. + + +## Memory + +### Can I use different type of RAM for the same 3Node? + +No. Always use the same type of RAM per 3Node. If you use RDIMM, go all RDIMM, etc. Check your hardware specifications to make sure you have the right type of memory. + + + +### How can I know if the memory I am buying is correct for my specific hardware? + +To be sure, look into the owner's manual of your specific computer. + +In general, you can go to [Memory.net](https://memory.net/) and look for your specific computer model. As general steps, select your computer's system in *By system*, then select the series and then select the specific model of the series. You will then see available memories to buy from memory.net. You can also simply read the documentation at the bottom. The memory type supported by your computer will be explained. Then you can buy the memory needed from any other computer store. + +For servers, you can check with Cloudninja's documentation [here](https://cloudninjas.com/pages/server-memory). Search for your specific hardware and look for the compatible memory. This reference is good for rack and tower servers. + + + +### What do the terms RDIMM, LDIMM, UDIMM, LRDIMM, FBDIMM mean when it comes to RAM memory sticks? + +Well first, the DIMM means dual inline memory module. + +* U stands for or unregistered (or unbuffered). + +* R stands for registered memory. + +* LR stands for load-reduced. + +* FB stands for fully-buffered. + + + +### What is the difference between ECC and non-ECC memory? + +ECC means error correction code memory. This type of memory can detect and correct data corruption. Non-ECC mostly cannot detect nor correct, but some can detect, but never correct data corruption. Check your hardware specifications to make sure you have the right type of memory (ECC or non-ECC). + + +### How can I change the RAM memory sticks on my 3Nodes? How can I achieve dual channel configuration with sticks of RAM? + +First, always use RAM sticks of the same size and type. It should be noted on your motherboard which slots to populate first. As a general guide, there is usually 2 slots A and B, with each 2 memory stick entries. You must then install the ram sticks on A1 and B1 in order to achieve dual channel, then A2 and B2 if you have more (visual order: A1 A2 B1 B2). + +> Example: You want to start with your largest sticks, evenly distributed between both processors and work your way down to your smallest. Let's take an example with 2 processors as well as 4x 16GB sticks and 4x 8GB sticks. The arrangement would be A1-16GB, B1-16GB, A2-16GB, B2-16GB, A3-8GB, B3-8GB, A4-8GB, B4-8GB. Avoid odd numbers as well. You optimally want pairs. So if you only have 5x 8GB sticks, only install 4 until you have an even 6. + + + +### What does RAM mean? + +RAM means random access memory. Those type of memory can be read and changed in any order. + + + + +### What does DIMM mean when it comes to RAM sticks? + +It means *dual in-line memory module*. This type of computer memory is natively 64 bits, enabling fast data transfer. + + + +### I have 24 DIMMS ram slots on my server. Can I use them all? + +Be careful when installing memory on a server. Always check your server's documentation to make sure your RAM sticks combination are correct. + +For example, on the Dell R720, you can have 24x16gb RAM ECC sticks, but it can only handle 16 Quad ranked DIMMs. In this case, you can fill up all slots with registered DIMMs if you have a maximum of 4 quad DIMMS ranked on each CPU. + +# Ask a Question to the ThreeFold Community + +If you have any question, you can ask the ThreeFold community via the ThreeFold forum or the ThreeFold Telegram channels: + +* [ThreeFold Forum](https://forum.threefold.io/) +* [ThreeFold General TG Channel](https://t.me/threefold) +* [ThreeFold Farmer TG Channel](https://t.me/threefoldfarmers) +* [TF Grid Tester TG Channel](https://t.me/threefoldtesting) + +> Note 1: If we wrote something wrong, tell us! + +> Note 2: This is a collective effort. A big *Thank You* to the great ThreeFold Community. Many Q+A are contributions from the enthusiast farmers, users and developers of the ever-growing ThreeFold community. \ No newline at end of file diff --git a/collections/manual/documentation/faq/img/3nodes.png b/collections/manual/documentation/faq/img/3nodes.png new file mode 100644 index 0000000..c7fe437 Binary files /dev/null and b/collections/manual/documentation/faq/img/3nodes.png differ diff --git a/collections/manual/documentation/faq/img/faq_img_readme.md b/collections/manual/documentation/faq/img/faq_img_readme.md new file mode 100644 index 0000000..5c71297 --- /dev/null +++ b/collections/manual/documentation/faq/img/faq_img_readme.md @@ -0,0 +1 @@ +# Image folder for the FAQ of the Threefold Manual 3.0 diff --git a/collections/manual/documentation/faq/img/minting2022.png b/collections/manual/documentation/faq/img/minting2022.png new file mode 100644 index 0000000..3335f69 Binary files /dev/null and b/collections/manual/documentation/faq/img/minting2022.png differ diff --git a/collections/manual/documentation/faq/img/tf_general.jpg b/collections/manual/documentation/faq/img/tf_general.jpg new file mode 100644 index 0000000..9925a1d Binary files /dev/null and b/collections/manual/documentation/faq/img/tf_general.jpg differ diff --git a/collections/manual/documentation/faq/img/tf_grid.png b/collections/manual/documentation/faq/img/tf_grid.png new file mode 100644 index 0000000..3996369 Binary files /dev/null and b/collections/manual/documentation/faq/img/tf_grid.png differ diff --git a/collections/manual/documentation/faq/img/tf_grid_3nodes.png b/collections/manual/documentation/faq/img/tf_grid_3nodes.png new file mode 100644 index 0000000..49f5a98 Binary files /dev/null and b/collections/manual/documentation/faq/img/tf_grid_3nodes.png differ diff --git a/collections/manual/documentation/faq/img/wethreepedia_developer.png b/collections/manual/documentation/faq/img/wethreepedia_developer.png new file mode 100644 index 0000000..58a1967 Binary files /dev/null and b/collections/manual/documentation/faq/img/wethreepedia_developer.png differ diff --git a/collections/manual/documentation/faq/img/wethreepedia_faq_poster.jpg b/collections/manual/documentation/faq/img/wethreepedia_faq_poster.jpg new file mode 100644 index 0000000..bf43918 Binary files /dev/null and b/collections/manual/documentation/faq/img/wethreepedia_faq_poster.jpg differ diff --git a/collections/manual/documentation/faq/img/wethreepedia_validator.jpg b/collections/manual/documentation/faq/img/wethreepedia_validator.jpg new file mode 100644 index 0000000..f23a7cf Binary files /dev/null and b/collections/manual/documentation/faq/img/wethreepedia_validator.jpg differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/albedo_buy.md b/collections/manual/documentation/threefold_token/buy_sell_tft/albedo_buy.md new file mode 100644 index 0000000..ef6d18e --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/albedo_buy.md @@ -0,0 +1,50 @@ +

Get TFT (Stellar) on Albedo Wallet

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Get Started](#get-started) + - [Get TFT By Token Swapping](#get-tft-by-token-swapping) +- [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) +*** +## Introduction + +Welcome to our guide on how to buy TFT tokens (Stellar) via the [Albedo wallet](https://albedo.link/)! Albedo is a secure and trustworthy keystore web app and browser extension designed for Stellar token accounts. With Albedo, you can safely manage and transact with your Stellar account without having to share your secret key with any third parties. + +In this tutorial, we will walk you through the process of buying Stellar TFT tokens using the Albedo wallet. +*** +## Prerequisites + +- **XLM**: When buying TFT tokens using the Albedo wallet, the process involves swapping XLM (Stellar Lumens) or other Stellar tokens into TFT. Please note that a certain amount of XLM funding is required to facilitate the sending and receiving of assets on the Stellar network. + +- **Create a Wallet and Add TFT Asset**: Create an Albedo Wallet Account and add TFT as an asset. Read [**here**](../storing_tft/storing_tft.md) for the complete manual of how to create an Albedo Wallet. +*** +## Get Started + +### Get TFT By Token Swapping + +Once you have completed the prerequisites, you can get TFT on Albedo by clicking 'Swap' and swapping your existing tokens to TFT, for example, XLM or USDC. + +Insert the amount of TFT you'd like to buy or the amount of XLM you'd like to swap for TFT. Click 'Swap' to confirm the transaction. + +Congratulations. You just swapped some XLM to TFT. Go to 'Balance' page to see your recently purchased TFT tokens. +*** +## Important Notice + +If you are looking for ways to provide liquidity for TFT (Stellar) on Albedo, you will find the according information [here](../liquidity/liquidity_albedo.md). +*** +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. + + + + + + + + diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/bettertoken.md b/collections/manual/documentation/threefold_token/buy_sell_tft/bettertoken.md new file mode 100644 index 0000000..3dafa10 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/bettertoken.md @@ -0,0 +1,36 @@ +

Get TFT Stellar via BetterToken

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Get Started](#get-started) +- [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) + +*** +## Introduction + +Alternatively, you can get TFT from Mazraa [BetterToken](https://bettertoken.com/) farmers. + +**BetterToken** is the first-ever ThreeFold Farming Cooperative in Europe that aims to make it easy for individuals to engage and become part of the ThreeFold Movement. Their primary goal is to enable anyone to become a farmer in simple ways and assist customers in getting started with their services and applications on the ThreeFold Grid. + +As a ThreeFold Farming Cooperative, BetterToken is dedicated to promoting participation in the ThreeFold ecosystem. They provide support and resources for individuals who want to join the farming community and contribute to the decentralized and sustainable ThreeFold Grid. +*** +## Get Started + +If you are interested in purchasing TFT as a future capacity reservation through BetterToken.com, you can do so using a wire transfer. It's important to note that BetterToken handles orders of $1000 or more. To explore purchase possibilities, you can contact BetterToken directly at **orders@bettertoken.com**. + +By reaching out to them, you can inquire about the process, requirements, and any additional details related to purchasing TFT as a future capacity reservation. BetterToken will be able to provide you with the necessary information and assist you throughout the purchase process. + +Remember to provide them with your specific requirements and any relevant details to ensure a smooth transaction. +*** +## Important Notice + +Remember to exercise caution and verify the authenticity of any communication or transaction related to purchasing TFT. Scammers may try to impersonate BetterToken or ThreeFold representatives, so it's crucial to ensure you are dealing with the official channels and contacts provided by BetterToken. +*** +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. + diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/btc_alpha.md b/collections/manual/documentation/threefold_token/buy_sell_tft/btc_alpha.md new file mode 100644 index 0000000..c80d633 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/btc_alpha.md @@ -0,0 +1,125 @@ +

Get TFT (Stellar) on BTC-Alpha

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Get Started](#get-started) + - [Sign up for an Account](#sign-up-for-an-account) + - [Secure Your Account](#secure-your-account) + - [Deposit Funds to Account](#deposit-funds-to-account) + - [Start Trading](#start-trading) + - [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +Welcome to our tutorial on how to get TFT (Stellar) using [**BTC-Alpha**](https://btc-alpha.com/en)! + +BTC-Alpha is a cryptocurrency exchange platform that provides a secure and user-friendly environment for trading various digital assets, including TFT (Stellar). With its robust features and intuitive interface, BTC-Alpha offers a convenient way to buy and sell cryptocurrencies. + +In this guide, we will walk you through the process of buying TFT on the BTC-Alpha exchange. + +## Prerequisites + +- **ID for verification:** To get TFT (Stellar) on the BTC-Alpha exchange, you will need to have your identification (ID) ready for the verification process. This is a standard requirement to ensure compliance with regulatory guidelines and maintain a secure trading environment. Your ID may include documents such as a valid passport or government-issued identification card. + +- **BTC-Alpha Account**: You must have an active account on the BTC-Alpha exchange. If you don't have one, you can sign up on their website and complete the registration process. Make sure to secure your account with strong passwords and two-factor authentication for enhanced security. + +- **Funds for Deposit**: To buy TFT (Stellar), you will need to have funds in your BTC-Alpha account. BTC-Alpha supports various deposit options, including USDT (Tether), USDC (USD Coin), BTC (Bitcoin), and other tokens listed on the exchange. You can deposit these tokens from your external wallet or exchange into your BTC-Alpha account to use for purchasing TFT. + +## Get Started + +### Sign up for an Account + +**Sign up for a BTC-Alpha Account:** Visit the BTC-Alpha website [https://btc-alpha.com/](https://btc-alpha.com/) and click on the "**Sign up**" button. Fill in the required information, including your email address, a secure password, and any additional details requested for the account creation process. + +**Login to your account**: You will then receive a notification that allow you to login to your new account. + +Now, you can proceed to log in to your account and start exploring the platform. Follow these steps to log in: + +Visit the BTC-Alpha website (https://btc-alpha.com/) on your web browser. Click on the "Login" button located on the top-right corner of the website. + +Enter the email address and password you used during the registration process in the respective fields. + +**Verify Your Account:** After completing the registration, you may need to verify your account by providing some personal identification information. This is a standard procedure for most cryptocurrency exchanges to ensure compliance with regulations and security measures. Follow the instructions provided by BTC-Alpha to complete the verification process. + +Congratulations on completing the registration process for your BTC-Alpha account and are logged in to your account successfully! + +### Secure Your Account + +**Secure Your Account**: Set up two-factor authentication (2FA) to add an extra layer of security to your BTC-Alpha account. This typically involves linking your account to a 2FA app, such as Google Authenticator or Authy, and enabling it for login and transaction verification. + +To enable two-factor authentication (2FA) on your BTC-Alpha account, follow these steps: + +Install either the [2FA Alp Authenticator](https://play.google.com/store/apps/details?id=com.alp.two_fa) or [Google Authenticator](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=en&gl=US) app on your mobile phone. You can find Authy on the App Store or Google Play, and Google Authenticator on the Google Play Store or Apple App Store. + +Once you have installed the app, log in to your BTC-Alpha account. + +Right-Click on your name or profile icon located at the top-right corner of the website to access the account settings, and look for the option "**Enable Two-factor Authentication**" and click on it. + +Follow the instructions provided to link your BTC-Alpha account with the Authy or Google Authenticator app. This usually involves scanning a QR code or manually entering a code provided by the app. + +Once the link is established, the app will start generating unique codes that you will need to enter during the login process for additional security. + +By enabling two-factor authentication, you add an extra layer of security to your BTC-Alpha account, helping to protect your funds and personal information. Make sure to keep your mobile device with the authenticator app secure, as it will be required each time you log in to your BTC-Alpha account. + +### Deposit Funds to Account + +To begin trading and acquiring TFT on the BTC-Alpha exchange, you will first need to deposit funds into your account. The specific token you choose to deposit will depend on your preference and the available options on the exchange. + +In this guide, we will focus on depositing BTC (Bitcoin) into your BTC-Alpha account. BTC is a widely recognized and popular cryptocurrency, making it a convenient choice for funding your account. + +To deposit BTC into your BTC-Alpha account, follow these steps: + +Log in to your BTC-Alpha account and Click on the "Wallets" tab located in the top menu. + +Search for "**BTC**" or "Bitcoin" in the list of available cryptocurrencies. + +You will be provided with a BTC deposit address. Copy this address or scan the QR code associated with it. + +Use your personal external BTC wallet or the wallet of another exchange to initiate a withdrawal to the provided deposit address. +Ensure that you specify the correct deposit address and double-check it before confirming the transaction. + +Wait for the transaction to be confirmed on the Bitcoin network. This may take some time depending on network congestion. +Once the transaction is confirmed, the BTC will be credited to your BTC-Alpha account balance. + +You can check your account balance by clicking on the "**Wallets**" tab or by navigating to the "**Balances**" section. + +Please note that the exact steps for depositing BTC may vary depending on the specific wallet or exchange you are using to send the funds. It is essential to double-check the deposit address and follow the instructions provided by your wallet or exchange to ensure a successful deposit. + +### Start Trading + +Once you have signed up for a BTC-Alpha account and completed the necessary verification steps, you will be ready to proceed with depositing funds and buying TFT (Stellar) on the exchange. On this example we will be buying TFT using BTC on BTC-Alpha Exchange. + +To trade BTC for TFT on the BTC-Alpha exchange, follow these steps: + +Log in to your BTC-Alpha account and Click on the "**Trade**" > "**Spot Trading Terminal**" tab located in the top menu. + +In the trading interface, find and select the trading pair that represents the BTC-TFT market at the top right corner. For example, it could be "BTC/TFT" or "TFT/BTC". + +You will be presented with the trading chart and order book for the selected market on the left bottom of the page. Take some time to familiarize yourself with the interface and the available options. In the "Limit" section, enter the desired amount of TFT you want to acquire. You can choose to specify the quantity or the total value in BTC. + +Review the order details, including the price and fees, before proceeding. + +Click on the "**Limit Buy TFT**" button to place your order. Once the order is placed, it will be processed by the exchange. You can monitor the status of your order in the "Open Orders" or "Order History" section. + +If your order is successfully executed, the TFT tokens will be credited to your BTC-Alpha account balance. You can check your account balance by clicking on the "**Wallets**" tab or by navigating to the "**Balances**" section. + +### Important Notice + +While it is possible to keep your TFT in your exchange wallet on BTC-Alpha, it is generally not recommended to store your funds there for an extended period. Public exchanges are more susceptible to security breaches and hacking attempts compared to personal wallets. + +To ensure the safety and security of your TFT holdings, it is advisable to transfer them to a dedicated TFT wallet. There are several options available for creating a TFT wallet, each with its own unique features and benefits. + +To explore different TFT wallet options and choose the one that best suits your needs, you can refer to our comprehensive [**TFT Wallet guide**](../storing_tft/storing_tft.md) that provides a list of recommended TFT wallets. This guide will help you understand the features, security measures, and compatibility of each wallet, enabling you to make an informed decision on where to store your TFT securely. + +Remember, maintaining control over your private keys and taking precautions to protect your wallet information are essential for safeguarding your TFT investments. + +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/buy_sell_tft.md b/collections/manual/documentation/threefold_token/buy_sell_tft/buy_sell_tft.md new file mode 100644 index 0000000..a97b90c --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/buy_sell_tft.md @@ -0,0 +1,20 @@ +

Buy and Sell TFT

+ +> If you're looking for a simple way to get TFT with crypto or fiat, check out the [Quick Start guide](./tft_lobstr/tft_lobstr_short_guide.md)! + +There are multiple ways to buy and sell TFT depending on your preferences and the blockchain network you choose to transact on. + +You can buy and sell TFT on Stellar Chain, Ethereum Chain and BNB Smart Chain, and you can use the [TFT bridges](../tft_bridges/tft_bridges.md) to go from one chain to another. + +With TFTs, you can [deploy workloads](../../system_administrators/getstarted/tfgrid3_getstarted.md) on the ThreeFold Grid and benefit from [staking discounts](../../../knowledge_base/cloud/pricing/staking_discount_levels.md) up to 60%! + +

Table of Contents

+ +- [Quick Start (Stellar)](./tft_lobstr/tft_lobstr_short_guide.md) +- [Lobstr Wallet (Stellar)](./tft_lobstr/tft_lobstr_complete_guide.md) +- [MetaMask (BSC & ETH)](./tft_metamask/tft_metamask.md) +- [Pancake Swap (BSC)](./pancakeswap.md) + +## More on TFT + +The [Threefold token (TFT)](../threefold_token.md) is the token of the Threefold Grid, a decentralized and open-source project offering network, compute and storage capacity. TFTs are created by TFChain, the ThreeFold blockchain, only when new Internet capacity is added to the ThreeFold Grid by cloud service providers (farmers) deploying 3Nodes, a process we call [farming](../../farmers/farmers.md). \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/buy_sell_tft_archive.md b/collections/manual/documentation/threefold_token/buy_sell_tft/buy_sell_tft_archive.md new file mode 100644 index 0000000..9e16570 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/buy_sell_tft_archive.md @@ -0,0 +1,37 @@ + +

Buy and Sell TFT: Getting Started

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Set up a Stellar Address](#set-up-a-stellar-address) +- [Methods to Get TFT](#methods-to-get-tft) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +There are multiple ways to acquire [TFT](../threefold_token.md) depending on your preferences and the blockchain network you choose to transact on. Note that you can use the [TFT bridges](../tft_bridges/tft_bridges.md) to go from one chain to another. To start, you need to have a supporting wallet to [store your TFT](../storing_tft/storing_tft.md). + +It's important to explore the available options and select the most convenient and secure method for acquiring TFT. Always exercise caution and ensure the legitimacy and reliability of the platforms or individuals you engage with to obtain TFT. + +## Set up a Stellar Address + +In general, to set up a Stellar address to transact TFT on Stellar chain, you can use any Stellar wallet that has a TFT trustline enabled. Note that on Stellar chain, fees are paid in XLM. + +The easiest way is to simply create an account on the [ThreeFold Connect App](../storing_tft/tf_connect_app.md) (for [Android](https://play.google.com/store/apps/details?id=org.jimber.threebotlogin) and [iOS](https://apps.apple.com/us/app/threefold-connect/id1459845885)) and to then use the TFT wallet of the app, which has by default a TFT trustline on Stellar chain and also comes with 1 XLM sponsored by Threefold for transaction fees. + +## Methods to Get TFT + +The ThreeFold manual covers numerous methods [to buy and sell TFT](./buy_sell_tft_methods.md). For a complete tutorial on getting TFT with crypto or fiat, read the [Lobstr guide](./tft_lobstr/tft_lobstr_complete_guide.md). + +If you're interested in trading or swapping other cryptocurrencies for TFT, you can visit various crypto exchanges that list TFT. Additionally, you can leverage swapping services available on decentralized exchanges (DEXs) or automated market makers (AMMs) to exchange your tokens for TFT (BSC). + +Moreover, you can purchase TFT using fiat currency directly from TFT Official's Live Desk, or [ThreeFold's official TFT Shop](https://gettft.com/). Another option is to obtain TFT from ThreeFold Farmers. You can engage with Farmers to purchase TFT directly from them, contributing to the growth and decentralization of the ThreeFold network. + +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/buy_sell_tft_methods.md b/collections/manual/documentation/threefold_token/buy_sell_tft/buy_sell_tft_methods.md new file mode 100644 index 0000000..f7d7175 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/buy_sell_tft_methods.md @@ -0,0 +1,36 @@ +# All Methods + +There are many ways to buy and sell TFT on the different chains where it lives. Explore the possibilities and find the best way for you to transact the token. + +

Table of Contents

+ +- Ethereum and BSC + - [MetaMask](./tft_metamask/tft_metamask.md) + - [1inch.io](./oneinch.md) + + +- BSC + - [Pancake Swap](./pancakeswap.md) + +- Stellar Chain + - [Lobstr Wallet](./tft_lobstr/tft_lobstr.md) + - [Lobstr Wallet: Short Guide](./tft_lobstr/tft_lobstr_short_guide.md) + - [Lobstr Wallet: Complete Guide](./tft_lobstr/tft_lobstr_complete_guide.md) + - [GetTFT.com](./gettft.md) + - [Albedo Wallet](./albedo_buy.md) + - [Solar Wallet](./solar_buy.md) + - [Coinbase (XLM)](./coinbase_xlm.md) + - [StellarTerm](./stellarterm.md) + - [Interstellar](./interstellar.md) + +- CEX + - [BTC-Alpha](./btc_alpha.md) + +- OTC + - [ThreeFold Live Desk](./tf_otc.md) + +- Farmers + - [BetterToken Farmers](./bettertoken.md) + - [Mazraa Farmers](./mazraa.md) + +> Note: You can [use TFT bridges](../tft_bridges/tft_bridges.md) to move from one chain to another. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/coinbase_xlm.md b/collections/manual/documentation/threefold_token/buy_sell_tft/coinbase_xlm.md new file mode 100644 index 0000000..a9113cc --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/coinbase_xlm.md @@ -0,0 +1,47 @@ +

Buy XLM on Coinbase

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Tutorial](#tutorial) +- [Important Notice](#important-notice) +- [Withdrawing XLM From Coinbase to Your Stellar Wallet](#withdrawing-xlm-from-coinbase-to-your-stellar-wallet) +*** +## Introduction + +In order to engage in seamless TFT transactions on the Stellar network, it is essential to acquire XLM (Stellar Lumens) as a prerequisite. XLM serves as the native cryptocurrency of the Stellar network, enabling fast and low-cost cross-border transactions. + +This section of the manual will guide you through the process of obtaining XLM using [**Coinbase Exchange**](https://www.coinbase.com/exchange/), a reputable cryptocurrency exchange service. Coinbase offers a user-friendly platform that simplifies the buying, selling, and storing of various cryptocurrencies, including XLM. + +By acquiring XLM, you will have the necessary funds to cover transaction fees on the Stellar network, ensuring smooth and efficient TFT transactions within your chosen Stellar wallet. While this guide focuses on **Coinbase Exchange** as the preferred exchange platform, please note that XLM can also be purchased from other exchanges that support it. + +Follow the steps outlined in this manual to acquire XLM on Coinbase and lay the foundation for your TFT transactions. Let's get started on this crucial prerequisite to enable your seamless engagement with TFT on the Stellar network. +*** +## Prerequisites + +- **Coinbase Exchange Account**: You will need a Coinbase Exchange account to get started using Coinbase. Click [here](https://help.coinbase.com/en/coinbase/getting-started) for the complete guide of getting started with Coinbase. + +- **Fiat Payment Methods**: Additionally, to purchase XLM (Stellar Lumens) on Coinbase Exchange, you will need link a fiat payment method to your Coinbase account, such as a linked bank account or a credit card. This fiat currency will be used to exchange for XLM. Click [here](https://help.coinbase.com/en/coinbase/getting-started/add-a-payment-method/how-do-i-add-a-payment-method-when-using-the-mobile-app) for the complete guide of adding payment method to Coinbase. +*** +## Tutorial + +Coinbase Exchange has taken steps to simplify the process of purchasing Stellar Lumens (XLM) by providing a this [**comprehensive XLM Purchase guide**](https://www.coinbase.com/how-to-buy/stellar). + +This guide offers detailed instructions on how to buy XLM directly from the Coinbase platform. By following the steps outlined in the guide, you can navigate through the buying process seamlessly. + +> Read about the difference in between Coinbase vs Coinbase Wallet [here](https://help.coinbase.com/en/wallet/getting-started/what-s-the-difference-between-coinbase-com-and-wallet) +*** +## Important Notice + +Important Notice: Please be aware that this tutorial specifically focuses on buying XLM (Stellar Lumens) from the **Coinbase Exchange** on [https://www.coinbase.com/exchange/](https://www.coinbase.com/exchange/), not the Coinbase Wallet. It is important to note that as of February 2023, [Coinbase Wallet no longer supports XLM](https://help.coinbase.com/en/wallet/other-topics/move-unsupported-assets). However, rest assured that these two platforms, Coinbase exchange and Coinbase Wallet, are distinct and serve different purposes. + +Remember to exercise caution and verify the compatibility of your chosen wallet or exchange with XLM before initiating any transactions. Keeping this distinction in mind will help ensure a seamless experience and prevent any potential confusion between the different platforms. +*** +## Withdrawing XLM From Coinbase to Your Stellar Wallet + +After successfully purchasing XLM from Coinbase, you can begin the process of withdrawing your XLM to another Stellar wallet of your choice. This allows you to have full control over your XLM and engage in transactions within the Stellar network. + +To learn more about the steps involved in withdrawing XLM from Coinbase to another Stellar wallet, click [here](https://help.coinbase.com/en/exchange/trading-and-funding/withdraw-funds). This resource will provide you with detailed instructions and guidelines on how to initiate the withdrawal process and ensure a smooth transfer of your XLM to your preferred Stellar wallet. + +> Get a TFT (Stellar) Wallet of your choice [here](../storing_tft/storing_tft.md)! diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/gettft.md b/collections/manual/documentation/threefold_token/buy_sell_tft/gettft.md new file mode 100644 index 0000000..8153ce8 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/gettft.md @@ -0,0 +1,76 @@ +

Get TFT (Stellar) on GetTFT.com

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Get Started](#get-started) + - [Link TF Wallet to GetTFT.com](#link-tf-wallet-to-gettftcom) + - [Get TFT using BTC](#get-tft-using-btc) + - [Get TFT using Fiat Currency (USD / EUR)](#get-tft-using-fiat-currency-usd--eur) +- [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) +*** +## Introduction + +Welcome to our tutorial on how to buy TFT tokens (Stellar / Native) via [GetTFT.com](https://gettft.com/)! + +GetTFT.com provides a seamless experience for purchasing TFT tokens (Stellar / Native), allowing you to be a part of the ThreeFold ecosystem. As a product developed by the ThreeFold team, GetTFT.com ensures a reliable and secure platform to facilitate the acquisition of TFT tokens. Whether you're an investor looking to support the ThreeFold mission or a technology enthusiast interested in participating in the decentralized internet revolution, this guide will walk you through the process of buying TFT tokens on GetTFT.com. + +On GetTFT.com, you have the flexibility to buy TFT tokens using either Bitcoin (BTC), or fiat currency like US Dollars (USD), or Euros (EUR). This allows you to choose the currency that is most convenient for you. Whether you already hold Bitcoin, prefer to use traditional fiat currencies, or want to explore various options, GetTFT.com caters to your needs. +*** +## Prerequisites + +Before you can buy TFT on [GetTFT.com](https://gettft.com/), there are a few prerequisites you need to fulfill. Here's what you'll need: + +- **TF Connect Wallet on TF Connect App**: Download and install the TF Connect app on your iOS or Android device. Create a TF Connect wallet within the app, following the provided instructions [here](../storing_tft/tf_connect_app.md#create-a-wallet). This wallet will be used to receive and store your TFT tokens purchased on GetTFT.com. + +- **BTC Wallet**: If you prefer to purchase TFT tokens using Bitcoin (BTC), make sure you have a BTC wallet of your own preference. This can be a hardware wallet, software wallet, or any other secure wallet that supports BTC transactions. You will need this wallet to send BTC from your personal wallet to GetTFT.com for the purchase. + +- **Mercuryo.io Account**: If you plan to buy TFT tokens using fiat currency (such as USD or EUR), you will need to create an account on [Mercuryo.io](https://mercuryo.io). Mercuryo.io is a fiat payment provider that allows you to purchase cryptocurrencies using traditional fiat currencies. This account will enable you to complete the fiat-to-TFT purchase process on GetTFT.com. +*** +## Get Started + +### Link TF Wallet to GetTFT.com + +After completing the prerequisites, you can directly go to [GetTFT.com](https://gettft.com/) and click on the 'Get TFT' button to start the process. + +You will be then redirected to the TF wallet connection page. Link your mobile TF Connect App wallet to the transaction page by clicking the 'Login via ThreeFold Connect'. Follow the further instructions on your TFConnect App and complete the linking process. + +#### Get TFT using BTC + +After successfully logged in, you will be redirected to the transaction page. select the amount of TFT you would like to buy and choose the 'BTC' icon as your payment method. Verify that you're providing the correct Stellar TFT wallet address (the wallet you have previously linked), read the t&c of the purchase and hit 'Submit' once everything is verified. + +You will then be redirected to the transfer BTC Page. On this page you will see the instruction on how much BTC you should send and the BTC deposit address for your TFT purchase. transfer the exact BTC amount via your BTC wallet by entering this information manually or by scanning the QR Code provided. + +After completing your transfer, you will receive a notification on the page confirming the successful transaction. It is important to stay on the page until you receive this confirmation to ensure that the transaction is processed correctly. Go to TF Connect App on your mobile to check the successfully purchased TFT. + +Please note that it may take some time, typically up to 30 minutes, for the TFT tokens to appear in your TF Connect wallet app after the transfer process. This delay is normal and can be attributed to various factors, including network congestion and blockchain confirmations. + +During this waiting period, it is important to remain patient and refrain from making multiple purchase attempts or transactions. Rest assured that the TFT tokens will be delivered to your TF Connect wallet as soon as the process is completed. + +#### Get TFT using Fiat Currency (USD / EUR) + +When purchasing TFT tokens using fiat currency on GetTFT.com, the transaction is facilitated through the Mercuryo.io exchange platform. The process involves with firstly buying Bitcoin (BTC) through the fiat gateway provided by Mercuryo.io. After the successful purchase of BTC, GetTFT.com will automatically convert the BTC amount into TFT tokens and send them to your TF Connect wallet. Please note that there is a minimum purchase amount of 110 USD for TFT tokens when using this platform. + +To get started, complete the same login process described on '**Get Started: Link TF Wallet to GetTFT.com**' section above. After successfully logged in, you will be redirected to the transaction page. select the amount of TFT you would like to buy and choose the 'USD' or 'EUR' icon as your payment method. Verify that you're providing the correct Stellar TFT wallet address (the wallet you have previously linked), read the t&c of the purchase and hit '**Submit**' once everything is verified. + +Once clicked, you will be redirected to [https://exchange.mercuryo.io/](https://exchange.mercuryo.io/) widget. Please read [Mercuryo.io's FAQ](https://help.mercuryo.io/) to learn more about Mercuryo widget. Follow the prompts to complete the purchase, which typically involves connecting your bank account or using a supported payment method to transfer the USD equivalent for the desired amount of BTC tokens. + +Once the BTC purchase is complete, the GetTFT.com platform will automatically convert the BTC amount into TFT tokens based on the prevailing exchange rate. The TFT tokens will be sent directly to your TF Connect wallet on the TF Connect app. + +Please note that it may take some time, typically up to 30 minutes, for the TFT tokens to appear in your TF Connect wallet app after the automatic conversion and transfer process. This delay is normal and can be attributed to various factors, including network congestion and blockchain confirmations. + +During this waiting period, it is important to remain patient and refrain from making multiple purchase attempts or transactions. Rest assured that the TFT tokens will be delivered to your TF Connect wallet as soon as the process is completed. +*** +## Important Notice + +If, for any reason, you encounter any issues or face difficulties during the purchase process, we recommend contacting the our customer support team via the popup chat box on the page or by going to [support.grid.tf](https://support.grid.tf/). They will be able to assist you and provide the necessary guidance to resolve any problems you may encounter. + +Remember to reach out to the support team promptly and provide them with relevant details regarding your issue, such as your account information, public wallet address and transaction details. +*** +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/interstellar.md b/collections/manual/documentation/threefold_token/buy_sell_tft/interstellar.md new file mode 100644 index 0000000..e12ef25 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/interstellar.md @@ -0,0 +1,51 @@ +

Get TFT (Stellar) on Interstellar

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Get Started](#get-started) + - [Get TFT By Trading](#get-tft-by-trading) +- [Store TFT on Interstellar](#store-tft-on-interstellar) +- [Disclaimer](#disclaimer) + +*** + +## Introduction +Welcome to our guide on how to get TFT tokens (Stellar) via the [**Interstellar**](https://interstellar.exchange/)! + +Interstellar is a decentralized exchange built on the Stellar network that enables users to trade various assets, including TFT (Stellar). As an intuitive and user-friendly platform, Interstellar provides a seamless trading experience for Stellar users. With its focus on security and privacy, Interstellar ensures that users maintain control over their funds and private keys. + +In this guide, we will walk you through the process of buying TFT on the Interstellar exchange, allowing you to participate in the vibrant Stellar ecosystem. + +## Prerequisites + +- **XLM**: To get TFT tokens using Interstellar, a certain amount of XLM funding is required to facilitate the sending and receiving of assets on the Stellar network. + +- **Create Interstellar Account and Add TFT Asset**: Create an Interstellar Account via desktop, and add TFT as an asset. Read [**here**](../storing_tft/interstellar_store.md) for the complete manual of how to create an Interstellar Account. + +## Get Started + +### Get TFT By Trading + +Once you have completed the prerequisites, signed up and added TFT as an asset, you can get TFT on Interstellar by clicking the menu bar and clicking '**Trading**' on the left menu on your homepage. + +On this page, we will try to trade some XLM into TFT. Click on the **custom** icon as shown + +Find **XLM** and **TFT** asset on the '**All (unverified)**' list. + +Once all is set (XLM and TFT), click on '**Go**' to start trading + +You can choose to fullfill sell orders, or create your own buy order. Once the buy order or trade has been fulfilled your TFT will show up in your wallet. Please Remember to review and double-check all order details before confirming the trade. + +## Store TFT on Interstellar + +If you are looking for ways to store TFT on Interstellar, you will find the according information [here](../storing_tft/interstellar_store.md). + +To explore different TFT wallet options and choose the one that best suits your needs, you can refer to our comprehensive [**TFT Wallet guide**](../storing_tft/storing_tft.md) that provides a list of recommended TFT wallets. This guide will help you understand the features, security measures, and compatibility of each wallet, enabling you to make an informed decision on where to store your TFT securely. + +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/mazraa.md b/collections/manual/documentation/threefold_token/buy_sell_tft/mazraa.md new file mode 100644 index 0000000..9d1af85 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/mazraa.md @@ -0,0 +1,73 @@ +

Get TFT (Stellar) from Mazraa Farmers

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Get Started](#get-started) + - [Get TFT via Mazraa.io Website](#get-tft-via-mazraaio-website) + - [Get TFT via Wire Transfer](#get-tft-via-wire-transfer) + - [Get TFT via PaypPal](#get-tft-via-payppal) + - [Get TFT via Credit Card (Transcoin)](#get-tft-via-credit-card-transcoin) +- [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) +*** +## Introduction + +Alternatively, you can get TFT from [Mazraa](https://mazraa.io) farmers. + +Mazraa is a pioneering provider of Peer2Peer Internet capacity on the ThreeFold Grid. Founded in the United Arab Emirates in early 2016, Mazraa has been at the forefront of leveraging the ThreeFold technology to offer decentralized and peer-to-peer compute and storage resources. + +Through Mazraa, individuals and organizations can access the capacity pool of storage and compute resources on the ThreeFold Grid. These resources can be utilized for various purposes, such as developing workloads, running applications, or storing data in a secure and decentralized manner. + +By purchasing TFT (ThreeFold Tokens) from Mazraa, individuals can not only support the growth and expansion of the ThreeFold Grid but also gain access to the capacity pool provided by Mazraa. This allows them to leverage the decentralized computing resources for their specific needs. +*** +## Get Started + +If you are interested in purchasing TFT from Mazraa, there are a few options available: + +### Get TFT via Mazraa.io Website + +Go to Mazraa.io and click on 'Purchase TFT' button. + +From there, you will be redirected to the '**Contact**' Page where you can send Mazraa staff the details of your TFT Purchase request. +You will then be contacted from Mazraa's official email **connect@Mazraa.io** to proceed to further steps. + +### Get TFT via Wire Transfer +Wire Transfer: To make a purchase via wire transfer, you can reach out to Mazraa directly at connect@Mazraa.io. They will provide you with the necessary instructions and facilitate the process for you. + +### Get TFT via PaypPal +PayPal (Soon): Mazraa is planning to introduce the option to buy tokens using PayPal. If you prefer this payment method, you can express your interest by contacting Mazraa at connect@Mazraa.io. They will provide you with further details once the option becomes available. + +It's important to note that if you are from the U.S.A., specific instructions may apply. In such cases, it is recommended to reach out to Mazraa directly at connect@Mazraa.io for further guidance and support. + +### Get TFT via Credit Card (Transcoin) + +If you prefer to pay for TFT using a credit card, Mazraa has partnered with Transcoin to offer a convenient and quick purchasing process. Here are the steps to follow: + +Visit Mazraa's Official Transcoin Checkout on [**https://transcoin.me/pay_from_api**](https://transcoin.me/pay_from_api) and enter Contact Details. Fill in your contact details and click on "**Send Verification Code**." This step is necessary for account verification. + +Please keep in mind to double check that you are entering the exact web address provided. Beware of scammers pretending to be Mazraa's Transcoin. + +Verification Code: Check your email for the verification code and enter it on the Transcoin Checkout page. + +Step 4: KYC Procedure: Complete the KYC (Know Your Customer) procedure by providing the required documents to Transcoin for verification. The specific documents needed will vary for each user. + +Specify the amount in euros (€) that you would like to purchase and provide the TFT wallet address where you want to receive the TFT. Your wallet address can be found in the [ThreeFold Connect a wallet](../storing_tft/tf_connect_app.md#create-a-wallet) or any other [TFT (Stellar) Wallet](../storing_tft/storing_tft.md) you prefer. + +Select your preferred payment method from the options provided by Transcoin. + +Once Mazraa receives the transaction details from Transcoin, they will initiate the transfer of TFT tokens to the wallet address you provided. Please note that it may take some time for the tokens to be received in your wallet. + +It's important to keep in mind that the process and timeline may vary, and additional verification steps may be required based on the regulations and policies of both Mazraa and Transcoin. +*** +## Important Notice + +Remember to exercise caution and verify the authenticity of any communication or transaction related to purchasing TFT. Scammers may try to impersonate Mazraa or ThreeFold representatives, so it's crucial to ensure you are dealing with the official channels and contacts provided by Mazraa. +*** +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. + + diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/oneinch.md b/collections/manual/documentation/threefold_token/buy_sell_tft/oneinch.md new file mode 100644 index 0000000..b0aef23 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/oneinch.md @@ -0,0 +1,69 @@ +

Get TFT on 1inch.io (TFT-BSC)

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [How to Get TFT on 1inch.io (TFT-BSC)](#how-to-get-tft-on-1inchio-tft-bsc) + - [Connect a BSC Wallet to 1inch.io](#connect-a-bsc-wallet-to-1inchio) + - [Swapping tokens to TFT](#swapping-tokens-to-tft) + - [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) +*** +## Introduction + +Welcome to our tutorial on how to buy TFT on Binance Smart Chain (BSC) using [1inch.io](https://1inch.io/)! + +1inch is a decentralized exchange (DEX) aggregator that aims to provide the best possible trading rates for users by sourcing liquidity from various DEX platforms. It combines smart contract technology with an intuitive user interface to enable users to swap tokens at the most favorable rates with minimal slippage and fees. 1inch.io scans multiple liquidity sources, including popular DEXs like Uniswap and SushiSwap, to ensure users get the most competitive prices for their trades. For more details about 1inch you can find a review of the 1inch exchange [here](https://www.coinbureau.com/review/1inch-exchange/) + +By following the steps outlined in this guide, you'll be able to purchase TFT tokens on 1inch.io seamlessly and take advantage of the benefits offered by the Binance Smart Chain network. +*** +## Prerequisites + +Before you can buy TFT on 1inch.io, there are a few prerequisites you need to fulfill. Here's what you'll need: + +- **BSC Wallet**: To interact with the Binance Smart Chain and 1inch.io, you'll need a BSC-compatible wallet. [Trust Wallet](https://trustwallet.com/) and [MetaMask](https://metamask.io/) are popular options that support BSC. Make sure to set up and secure your wallet before proceeding. On this tutorial, we will use Metamask as our connecting wallet. + +> [Set up a Metamask Wallet](../storing_tft/metamask.md) +> +> [Set up a Trust Wallet](../storing_tft/trustwallet.md) + +- **Get BNB Tokens**: As the native cryptocurrency of Binance Smart Chain, BNB is required to pay for transaction fees on the network. You will need to have Ensure you have some BNB tokens in your BSC wallet to cover these fees when buying TFT on 1inch.io. Read [this tutorial](https://fortunly.com/articles/how-to-buy-bnb/) to know where you can buy BNB and transfer them to your BSC Wallet. + +> [Get BNB Tokens](https://docs.pancakeswap.finance/readme/get-started/bep20-guide) +*** +## How to Get TFT on 1inch.io (TFT-BSC) + +By utilizing 1inch.io, you can easily convert your existing crypto assets on BSC network into TFT-BSC by using the Swap function. Once you have obtained TFT-BSC, you have the option to bridge it into TFT Native on the Stellar network by utilizing the [TFT-Stellar bridge](../tft_bridges/tfchain_stellar_bridge.md). Let's swap some tokens! + +### Connect a BSC Wallet to 1inch.io + +To get started, head to 1inch.io and click on '**Launch dApp**' icon on the homepage as shown below + +Click on '**Connect Wallet**' account to connect your BSC Wallet. + +A pop up window will appear, and you will be asked to select the network and wallet you would like to use connect to your 1inch.io account. In this case, since we would like to trade TFT on BSC , we would choose the '**BNB Chain**' icon (other name for BSC), for the network, and **Metamask** for the wallet. You can also connect other BSC supported wallet of your preference, such as Trust Wallet, etc. + +You will now be redirected to your Metamask wallet page, or you can click on the 'Metamask' icon on your browser manually to accept the 1inch.io connection request. Select the BSC Wallet you'd like to connect to your 1inch.io account, and click '**Next**'. On the next step, Click '**Connect**' to finalize the connection. + +Once your wallet is connected, you will see that you have your wallet connected on 1inch.io homepage shown as Metamask icon on the top right corner of the 1inch.io homepage. To start swapping tokens to TFT, make sure that BNB Chain icon is shown as selected network on the top right corner of your page, usually it's automatically shown as BNB if you previously connected your Metamask's BNB Wallet. If not, you can change it by clicking on the icon and selecting BNB Chain from the list. + +### Swapping tokens to TFT + +To start swapping tokens to TFT, click on the '**Select Token**' button on the Swap page. Depending which existing BSC-supported tokens that you have in your Metamask wallet, you can swap them to to TFT as long as they're listed on 1inch.io. On this tutorial we will try to swap some BUSD tokens to TFT. + +Type '**TFT on BSC**' on the listing page, and clicked on the result shown as below + +Once selected, define the amount of BNB you'd like to swap to TFT and click '**Confirm Swap**' button. + +Wait for the banner in the upper-right corner informing you about the success of your transaction. You will be notified once the swap is successful, and Congrats! You have just swapped some BUSD to TFT. + +### Important Notice + +If you are looking for ways to provide liquidity for TFT on Binance Smart Chain on 1inch.io, you will find the according information [here](../liquidity/liquidity_1inch.md). +*** +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/pancakeswap.md b/collections/manual/documentation/threefold_token/buy_sell_tft/pancakeswap.md new file mode 100644 index 0000000..ed09435 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/pancakeswap.md @@ -0,0 +1,55 @@ +

Get TFT: Pancake Swap (BSC)

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Buy TFT on PancakeSwap](#buy-tft-on-pancakeswap) +- [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +In this guide, we present how to buy and sell ThreeFold Tokens on BNB Smart Chain (BSC) using [Pancake Swap](https://pancakeswap.finance/). + +**BNB Smart Chain** is a blockchain network that enables the execution of smart contracts and decentralized applications, while **Pancake Swap** is a popular decentralized exchange (DEX) built on BSC. + +## Prerequisites + +Before you can buy TFT on Pancake Swap, there are a few prerequisites you need to fulfill. Here's what you'll need: + +- **BSC Wallet**: To interact with the BNB Smart Chain and Pancake Swap, you'll need a BSC-compatible wallet. [MetaMask](https://metamask.io/) is a popular option that supports BSC. Make sure to set up and secure your wallet before proceeding. + +> [Set up a MetaMask Wallet](../storing_tft/metamask.md) + +- **Connect BSC Wallet to Pancake Swap**: Visit the Pancake Swap website and connect your BSC wallet to your Pancake Swap account. + +> [Connect Wallet to Pancake Swap](https://docs.pancakeswap.finance/readme/get-started/connection-guide) + +- **Get BNB Tokens**: As the native cryptocurrency of BNB Smart Chain, BNB is required to pay for transaction fees on the network. Ensure you have some BNB tokens in your BSC wallet to cover these fees when buying TFT on Pancake Swap. Read [this tutorial](https://fortunly.com/articles/how-to-buy-bnb/) to know where you can buy BNB and transfer them to your BSC Wallet. + +> [Get BNB Tokens](https://docs.pancakeswap.finance/readme/get-started/bep20-guide) + +## Buy TFT on PancakeSwap + +On Pancake Swap, you can easily convert your existing crypto assets on BSC network into TFT-BSC by using the Swap function. Once you have obtained TFT-BSC, you have the option to bridge it into TFT Native on the Stellar network by utilizing the [TFT-Stellar bridge](../tft_bridges/tfchain_stellar_bridge.md). Let's swap some tokens! + +Now that you're all set, go to your [PancakeSwap homepage](https://pancakeswap.finance/) and click on **Trade > Swap** button as shown. Please Make sure you're on **BNB Smart Chain** network. + +On the Swap Page, you would see that it displays swapping from BNB to CAKE as default. Here we'd like to change that to BNB (or any other tokens you have) to TFT. click on '**CAKE**' and find TFT on the token listing pop up page, and click '**Import**'. + +Once selected, define how much BNB or other token you would like to swap into TFT, and click on the '**Swap**' button. + +That's it! You have officially swapped BNB into TFT. + +## Important Notice + +If you are looking for ways to provide liquidity for TFT on BNB Smart Chain on Pancake Swap, you will find the according information [here](../liquidity/liquidity_pancake.md). + +## 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](../../../knowledge_base/legal/disclaimer.md) and seek advice from a qualified financial professional if needed. diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/quick_start_lobstr.md b/collections/manual/documentation/threefold_token/buy_sell_tft/quick_start_lobstr.md new file mode 100644 index 0000000..05cf8c1 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/quick_start_lobstr.md @@ -0,0 +1 @@ +# Quick Start diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/solar_buy.md b/collections/manual/documentation/threefold_token/buy_sell_tft/solar_buy.md new file mode 100644 index 0000000..5155d82 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/solar_buy.md @@ -0,0 +1,47 @@ +

Get TFT(Stellar) on Solar Wallet

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Get Started](#get-started) + - [Get TFT by Trading](#get-tft-by-trading) +- [Disclaimer](#disclaimer) +*** +## Introduction + +Welcome to our guide on how to buy TFT tokens (Stellar) via the [**Solar Wallet**](https://solarwallet.io/)! + +**Solar Wallet** is a user-friendly wallet designed for storing and managing Stellar-based assets like the ThreeFold Token (TFT). It provides a secure way to store your TFT tokens and access them conveniently. With Solar Wallet, you have full control over your assets and can interact with various Stellar services and decentralized applications. Solar Wallet is available as a web-based wallet and also offers mobile versions for iOS and Android devices. This guide will explain how to store TFT (Stellar) on Solar Wallet, including setup, adding tokens, and important security tips. +*** +## Prerequisites + +- **XLM**: When getting TFT tokens using the Solar wallet, the process involves swapping XLM (Stellar Lumens) or other Stellar tokens into TFT. Please note that a certain amount of XLM funding is required to facilitate the sending and receiving of assets on the Stellar network. + +- **Create a Wallet and Add TFT Asset**: Create a Solar Wallet Account via the mobile app or desktop, and add TFT as an asset. Read [**here**](../storing_tft/storing_tft.md) for the complete manual of how to create an Albedo Wallet. + +## Get Started + +### Get TFT by Trading + + you can start trading TFT on Solar by clicking the menu bar and clicking '**TFT**' icon or 'My Account' on your wallet homepage to start trading your existing tokens to TFT, for example, XLM or USDC. + +You will now be redirected to your Asset List. Click on the **TFT asset** to start trading. + +You will now be redirected to TFT asser info page. Start trading TFT by clicking '**Trade**'. + +To start buying TFT, click '**Buy**' on the asset trading page. + +Choose the trading pair token that you want to trade with, in this tutorial we will be trading XLM to TFT. Specify the amount of XLM you would like to sell, and click '**Place order**' to start trading. + +Confirm your trade on the pop up box shown. + +Wait until your order is successfully made. You will then be redirected to the wallet homepage, and Congratulations! The new TFT asset has been successfully added to your Solar Wallet account. + +> Read the full details about Solar trading feature on [Lobstr's knowledge base](https://docs.solarwallet.io/guide/08-dex.html#trade-view). +*** +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/stellarterm.md b/collections/manual/documentation/threefold_token/buy_sell_tft/stellarterm.md new file mode 100644 index 0000000..be4aba0 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/stellarterm.md @@ -0,0 +1,72 @@ +

Get TFT(Stellar) on StellarTerm

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Get Started](#get-started) + - [Login with an Existing Wallet](#login-with-an-existing-wallet) + - [Adding TFT as an Asset](#adding-tft-as-an-asset) + - [Get TFT by Trading](#get-tft-by-trading) + - [Get TFT by Swapping](#get-tft-by-swapping) +- [Disclaimer](#disclaimer) +*** +## Introduction + +Welcome to our tutorial on how to get TFT (Stellar) using [**Stellarterm**](https://stellarterm.com/)! + +Stellarterm is a user-friendly decentralized exchange (DEX) built on the Stellar blockchain. It allows you to trade and manage various assets directly from your Stellar wallet. With Stellarterm, you have full control over your funds as it operates in a non-custodial manner, meaning you retain ownership of your private keys and maintain complete security. + +In this tutorial, we will walk you through the process of buying TFT (ThreeFold Token) on Stellarterm by connecting your preferred Stellar wallet. By following the steps outlined in this guide, you will be able to access the Stellarterm DEX, navigate the trading interface, and execute transactions to acquire TFT tokens seamlessly. +*** +## Prerequisites + +- **An external Stellar Wallet**: You should have a Stellar wallet of your choice set up for it to be connected to StellarTerm. Read [**here**](../storing_tft/storing_tft.md) for the complete list of Stellar Wallet you can use. + +- **XLM**: When buying TFT tokens using StellarTerm, the process involves swapping XLM (Stellar Lumens) or other Stellar tokens into TFT. Please note that a certain amount of XLM funding is required to facilitate the sending and receiving of assets on the Stellar network. +*** +## Get Started + +### Login with an Existing Wallet + +Once you have completed the prerequisites, you can get TFT on StellarTerm by going to [https://stellarterm.com/](https://stellarterm.com/), click '**LOGIN**' button in the top right corner and welect your desired wallet provider from the list of options. + +Once connected, you will see your wallet's account details and balances on the dashboard. If you already have added TFT as an asset in your wallet, it will show TFT on the asset list. + +### Adding TFT as an Asset + +- IF you didn't already have TFT asset on your wallet, you can add it by going to [https://stellarterm.com/markets/](https://stellarterm.com/markets/) , go to the very bottom of the page, find the '**Exchange Pair**' section, and Select the trading pair you wish to trade. For example, if you want to trade TFT for XLM, choose the TFT/XLM pair, and click on '**Start Trading**'. + +- You can also add TFT by manually entering TFT asset infos on 'Markets' > 'Custom Exchange Pair' at the very bottom of the page, + - Asset Code: TFT + - Issuer Account ID or federation: `GBOVQKJYHXRR3DX6NOX2RRYFRCUMSADGDESTDNBDS6CDVLGVESRTAC47` + +Select the trading pair you wish to trade. For example, XLM and click on the trading pair. + +- Or you can also start trading by directly going to [https://stellarterm.com/exchange/TFT-threefold.io/XLM-native](https://stellarterm.com/exchange/TFT-threefold.io/XLM-native) + +**IMPORTANT**: It is important to ensure that you also see the name "**threefold.io**" next to the logo, the correct Asset code, or the correct Issuer Account ID or federation, as this verifies that you are selecting the genuine TFT asset associated with ThreeFold. **Beware of imposters or fraudulent assets that may attempt to mimic TFT.** ThreeFold cannot assume responsibility for any errors or mistakes made during the trustline creation process done by users. If you have any uncertainties or doubts, it is always recommended to seek assistance from official support channels or trusted sources to ensure the accuracy of the trustline configuration. + + ### Get TFT by Trading + +Once you completed the previous step, you can start trading TFT on StelarTerm by placing a new trade offer on the 'Create new offer' section of the TFT/XLM exchange page, or any other trading pair you prefer. Please Remember to review and double-check all order details before confirming the trade. + +> Read the full details about StellarTerm's trading feature on [StellarTerm's knowledge base](https://stellarterm.freshdesk.com/support/solutions/articles/151000012428-basics-how-to-place-an-offer-on-sdex-with-stellarterm). + +### Get TFT by Swapping + +You can also get TFT on StellarTerm by using it's '**Swap**' feature by going to [https://stellarterm.com/swap/](https://stellarterm.com/swap/) and Select the trading pair you wish to trade. For example, if you want to trade TFT for XLM, choose the TFT/XLM pair. + +Enter the amount of the selected token you wish to swap from XLM to TFT. Review the details of the swap, including the estimated rate and any applicable fees. + +Click on the "Swap" button to initiate the swap. + +Stellarterm will generate a transaction for you to review. Confirm the transaction details, including the amount and destination address. If everything appears correct, approve and sign the transaction using your connected wallet. + +Stellarterm will process the swap transaction on the Stellar network. Once the transaction is confirmed, you will see the acquired TFT tokens in your wallet's balance. +*** +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tf_otc.md b/collections/manual/documentation/threefold_token/buy_sell_tft/tf_otc.md new file mode 100644 index 0000000..137bd80 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/tf_otc.md @@ -0,0 +1,40 @@ +

Get TFT (Stellar) via ThreeFold's Live Desk

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Get Started](#get-started) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +If you have a large sum TFT purchase or non-standard purchase/sell requests that may be challenging to process through other methods, ThreeFold offers an Over the Counter (OTC) service. The OTC service allows you to make custom purchases or sell requests for TFT directly through ThreeFold. + +## Get Started + +Here's how you can proceed with an OTC purchase or sell request: + +**Contact the OTC Team**: To initiate an OTC purchase/sell request, send an email to **otc@gettft.com**. Make sure to cc: **info@threefold.io** as well. + +Provide Required Information: In your email, include the following details: + +**Your Name:** Provide your full name for identification purposes. +**Residency:** Specify your country of residency. +**Amount of TFT:** Indicate the quantity of TFT you wish to purchase or sell. +**Preferred Purchase/Sell Options**: State your preferred method or options for the transaction. +**Preferred Price:** If applicable, mention your desired price for the purchase or sell. +**Double-check the Email Address:** It's essential to ensure that you send your email to the correct address, which is **otc@gettft.com** cc to **info@threefold.io**. + +Be cautious and vigilant of potential scams or fraudulent individuals pretending to be ThreeFold employees. Please note that ThreeFold's employees never sells TFT personally on a 1-1 basis, and **sales are not conducted via Telegram, WhatsApp, or any other chat platform.** + +Take necessary precautions and exercise due diligence when engaging in any financial transactions. ThreeFold is committed to maintaining the security and integrity of its services, and the OTC service is only designed to handle larger or non-standard TFT transactions efficiently. + +Remember to follow the provided instructions, include accurate information, and be cautious of potential fraudulent activities. By adhering to the official process, you can proceed with your TFT purchase/sell request through the OTC service provided by ThreeFold. + +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_getting_started.md b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_getting_started.md new file mode 100644 index 0000000..0667376 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_getting_started.md @@ -0,0 +1,53 @@ + +

Getting Started

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Buying and Storing TFTs](#buying-and-storing-tfts) +- [How to set up a Stellar address for TFT transactions](#how-to-set-up-a-stellar-address-for-tft-transactions) +- [Disclaimer](#disclaimer) + - [Learn All the Methods](#learn-all-the-methods) + +*** + +## Introduction + +There are multiple ways to acquire TFT depending on your preferences and the blockchain network you choose to transact on. To start, you need to have a supporting wallet to store your TFTs. Read more about how to store your TFTs [here](../storing_tft/storing_tft.md) + +If you're interested in trading or swapping other cryptocurrencies for TFT, you can visit various crypto exchanges that list TFT as shown on te next section of this page. Additionally, you can leverage swapping services available on decentralized exchanges (DEXs) or automated market makers (AMMs) to exchange your tokens for TFT (BSC). + +Moreover, you can purchase TFT using fiat currency directly from TFT Official's Live Desk, or [ThreeFold's official TFT Shop](https://gettft.com/). Another option is to obtain TFT from ThreeFold Farmers. You can engage with Farmers to purchase TFT directly from them, contributing to the growth and decentralization of the ThreeFold network. + +It's important to explore the available options and select the most convenient and secure method for acquiring TFT. Always exercise caution and ensure the legitimacy and reliability of the platforms or individuals you engage with to obtain TFT. + + + +## Buying and Storing TFTs + +Discover step-by-step instructions on buying and storing TFTs across different platforms. + +If you're looking to navigate the [TFT Ecosystem](https://library.threefold.me/info/manual/#/tokens/threefold__tft_ecosystem), this collection of tutorials and manuals is here to help. Learn how to purchase, trade, and securely store your TFTs with ease. + +For a comprehensive introduction to TFT, we recommend exploring the [TFT Home Section in the ThreeFold Library](https://library.threefold.me/info/threefold#/tokens/threefold__tokens_home). + + + +## How to set up a Stellar address for TFT transactions + +In general, to set up a Stellar address to transact TFT on Stellar chain, you can use any Stellar wallet that has a TFT trustline enabled. Note that on Stellar chain, fees are paid in XLM. + +The easiest way is to simply create an account on the ThreeFold Connect App (for [Android](https://play.google.com/store/apps/details?id=org.jimber.threebotlogin) and [iOS](https://apps.apple.com/us/app/threefold-connect/id1459845885)) and to then use the TFT wallet of the app, which has by default a TFT trustline on Stellar chain and also comes with 1 XLM sponsored by Threefold for transaction fees. + + + +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. + + +### Learn All the Methods + +You can learn [all the different ways to transact TFT](./buy_sell_tft.md). \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_1.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_1.png new file mode 100644 index 0000000..265dcc1 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_1.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_10.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_10.png new file mode 100644 index 0000000..37e04bb Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_10.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_11.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_11.png new file mode 100644 index 0000000..6f05038 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_11.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_12.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_12.png new file mode 100644 index 0000000..ad81a3d Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_12.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_13.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_13.png new file mode 100644 index 0000000..8d808cc Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_13.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_14.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_14.png new file mode 100644 index 0000000..014edde Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_14.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_15.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_15.png new file mode 100644 index 0000000..895d432 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_15.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_16.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_16.png new file mode 100644 index 0000000..b8ca3c9 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_16.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_17.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_17.png new file mode 100644 index 0000000..5919d0c Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_17.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_18.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_18.png new file mode 100644 index 0000000..8ea142f Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_18.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_19.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_19.png new file mode 100644 index 0000000..14688ab Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_19.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_2.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_2.png new file mode 100644 index 0000000..cb638bd Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_2.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_20.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_20.png new file mode 100644 index 0000000..b072502 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_20.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_21.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_21.png new file mode 100644 index 0000000..709e50a Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_21.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_22.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_22.png new file mode 100644 index 0000000..6e588cd Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_22.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_23.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_23.png new file mode 100644 index 0000000..b47c4f0 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_23.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_24.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_24.png new file mode 100644 index 0000000..df06bec Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_24.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_25.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_25.png new file mode 100644 index 0000000..7ba5402 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_25.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_26.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_26.png new file mode 100644 index 0000000..f34d4ff Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_26.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_27.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_27.png new file mode 100644 index 0000000..1de6ee5 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_27.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_28.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_28.png new file mode 100644 index 0000000..c3e8cd0 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_28.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_29.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_29.png new file mode 100644 index 0000000..888067f Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_29.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_3.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_3.png new file mode 100644 index 0000000..4a18f4c Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_3.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_30.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_30.png new file mode 100644 index 0000000..f28e697 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_30.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_31.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_31.png new file mode 100644 index 0000000..84fe32e Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_31.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_32.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_32.png new file mode 100644 index 0000000..3ab05eb Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_32.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_33.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_33.png new file mode 100644 index 0000000..b30050a Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_33.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_34.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_34.png new file mode 100644 index 0000000..553db13 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_34.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_4.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_4.png new file mode 100644 index 0000000..b2a0d03 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_4.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_5.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_5.png new file mode 100644 index 0000000..2b28aef Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_5.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_6.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_6.png new file mode 100644 index 0000000..a3601b3 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_6.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_7.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_7.png new file mode 100644 index 0000000..879a735 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_7.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_8.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_8.png new file mode 100644 index 0000000..b1a9321 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_8.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_9.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_9.png new file mode 100644 index 0000000..eb2e80e Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/gettft_9.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/lobstr_swap.jpg b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/lobstr_swap.jpg new file mode 100644 index 0000000..0ca13b9 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/lobstr_swap.jpg differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/lobstr_trade.jpg b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/lobstr_trade.jpg new file mode 100644 index 0000000..28a5ad0 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/lobstr_trade.jpg differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/threefold_lobstr_swap_tft_.jpg b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/threefold_lobstr_swap_tft_.jpg new file mode 100644 index 0000000..d8955a6 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/img/threefold_lobstr_swap_tft_.jpg differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/tft_lobstr.md b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/tft_lobstr.md new file mode 100644 index 0000000..25fdda7 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/tft_lobstr.md @@ -0,0 +1,10 @@ +

Get TFT on Lobstr Wallet

+ +It is very easy to purchase TFT on Lobstr Wallet. + +We present here a quick guide to give you the essential information to purchase TFT and a complete guide to guide you step-by-step in the process. + +

Table of Contents

+ +- [Quick Guide](./tft_lobstr_short_guide.md) +- [Complete Guide](./tft_lobstr_complete_guide.md) \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/tft_lobstr_complete_guide.md b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/tft_lobstr_complete_guide.md new file mode 100644 index 0000000..e1fd2f6 --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/tft_lobstr_complete_guide.md @@ -0,0 +1,200 @@ +

Get TFT: Lobstr Wallet (Stellar)

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Download the App and Create an Account](#download-the-app-and-create-an-account) +- [Connect Your TF Connect App Wallet](#connect-your-tf-connect-app-wallet) +- [Buy XLM with Fiat Currency](#buy-xlm-with-fiat-currency) +- [Swap XLM for TFT](#swap-xlm-for-tft) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +In this guide, you'll learn how to buy ThreeFold Tokens with [Lobstr](https://lobstr.co/) using a credit or a debit card and a TF Connect wallet. This is a simple method that works well for small to medium purchases. + +Lobstr is an app for managing digital assets like TFT on the Stellar blockchain. In this case, we'll first obtain Stellar's native currency, Lumens (XLM) and swap them for TFT. + +> Note that it is possible to do these steps without connecting the Lobstr wallet to the TF Connect App wallet (read [docs](./tft_lobstr_short_guide.md)). But doing this has a clear advantage: when we buy and swap on Lobstr, the TFT is directly accessible on the TF Connect app wallet. + +## Download the App and Create an Account + +Go on [www.lobstr.co](https://www.lobstr.co) and download the Lobstr app. +You can download it for Android or iOS. + +![image](./img/gettft_1.png) + +We will show here the steps for Android, but it is very similar with iOS. +Once you've clicked on the Android button, you can click install on the Google Store page: + +![image](./img/gettft_2.png) + +Once the app is downloaded, open it: + +![image](./img/gettft_3.png) + +On the Lobstr app, click on **Create Account**: + +![image](./img/gettft_4.png) + +You will then need to enter your email address: + +![image](./img/gettft_5.png) + +Then, choose a safe password for your account: + +![image](./img/gettft_6.png) + +Once this is done, you will need to verify your email. + +Click on **Verify Email** and then go check your email inbox. + +![image](./img/gettft_7.png) + +Simply click on **Verify Email** on the email you've received. + +![image](./img/gettft_8.png) + +Once your email is verified, you can sign in to your Lobstr account: + +![image](./img/gettft_9.png) + +![image](./img/gettft_10.png) + + + +## Connect Your TF Connect App Wallet + +You will then need to either create a new wallet or connect an existing wallet. + +For this guide, we will show how to connect your TF Connect app wallet, but please note that you can create a new wallet on Lobstr by clicking **Create Stellar Wallet**. + +Since we are working with the Threefold ecosystem, it is very easy and practical to simply connect your TF Connect app wallet to Lobstr. This way, when you buy XLM and swap XLM tokens for TFTs, they will be directly available on your TF Connect app wallet. + +![image](./img/gettft_11.png) + +To connect your TF Connect app wallet, you will need to find your Stellar address and chain secret key. +This is very simple to do. + +Click on **I have a public or secret key**. + +![image](./img/gettft_12.png) + +As you can see on this next picture, you need the Stellar address and secret key to properly connect your TF Connect app wallet to Lobstr: + +![image](./img/gettft_18.png) + +To find your Stellar address and secret key, go on the TF Connect app and select the **Wallet** section: + +![image](./img/gettft_13.png) + +At the top of the section, click on the **copy** button to copy your Stellar Address: + +![image](./img/gettft_17.png) + +Now, we will find the Stellar secret key. +At the botton of the section, click on the encircled **i** button: + +![image](./img/gettft_14.png) + +Next, click on the **eye** button to reveal your secret key: + +![image](./img/gettft_15.png) + +You can now simply click on the **copy** button on the right: + +![image](./img/gettft_16.png) + +That's it! You've now connected your TF Connect app wallet to your Lobstr account. + +## Buy XLM with Fiat Currency + +Now, all we need to do, is buy XLM and then swap it for TFT. +It will be directly available in your TF Connect App wallet. + +On the Lobstr app, click on the top right menu button: + +![image](./img/gettft_19.png) + +Then, click on **Buy Crypto**: + +![image](./img/gettft_20.png) + +By default, the crypto selected is XLM. This is alright for us as we will quickly swap the XLM for TFT. + +On the Buy Crypto page, you can choose the type of Fiat currency you want. +By default it is in USD. To select some othe fiat currency, you can click on **ALL** and see the available fiat currencies: + +![image](./img/gettft_21.png) + +You can search or select the current you want for the transfer: + +![image](./img/gettft_22.png) + +You will then need to decide how much XLM you want to buy. Note that there can be a minimum amount. +Once you chose the desired amount, click on **Continue**. + +![image](./img/gettft_23.png) + +Lobstr will then ask you to proceed to a payment method. In this case, it is Moonpay. +Note that in some cases, your credit card won't accept Moonpay payments. You will simply need to confirm with them that you agree with transacting with Moonpay. This can be done by phone. Check with your bank and credit card company if this applies. + +![image](./img/gettft_24.png) + +Once you've set up your Moonpay payment method, you will need to process and confirm the transaction: + +![image](./img/gettft_25.png) +![image](./img/gettft_26.png) + +You will then see a processing window. +This process is usually fast. Within a few minutes, you should receive your XLM. + +![image](./img/gettft_27.png) + +Once the XLM is delivered, you will receive a notification: + +![image](./img/gettft_28.png) + +When your transaction is complete, you will see this message: + +![image](./img/gettft_29.png) + +On the Trade History page, you can choose to download the csv file version of your transaction: + +![image](./img/gettft_30.png) + +That's it! You've bought XLM on Lobstr and Moonpay. + +## Swap XLM for TFT + +Now we want to swap the XLM tokens for the Threefold tokens (TFT). +This is even easier than the previous steps. + +Go to the Lobstr Home menu and select **Swap**: + +![image](./img/gettft_31.png) + +On the **Swap** page, write "tft" and select the Threefold token: + +![image](./img/gettft_32.png) + +Select the amount of XLM you want to swap. It is recommended to keep at least 1 XLM in your wallet for transaction fees. + +![image](./img/gettft_33.png) + +Within a few seconds, you will receive a confirmation that your swap is completed: +Note that the TFT is directly sent on your TF Connect app wallet. + +![image](./img/gettft_34.png) + +That's it. You've swapped XLM for TFT. + +You can now use your TFT to deploy workloads on the Threefold Grid. + +## 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](../../../../knowledge_base/legal/disclaimer.md) and seek advice from a qualified financial professional if needed. diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/tft_lobstr_short_guide.md b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/tft_lobstr_short_guide.md new file mode 100644 index 0000000..eb1d86e --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/tft_lobstr_short_guide.md @@ -0,0 +1,76 @@ +

Get TFT: Quick Start (Stellar)

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Install Lobstr](#install-lobstr) +- [Create Wallet](#create-wallet) +- [Buy XLM](#buy-xlm) +- [Swap XLM for TFT](#swap-xlm-for-tft) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +In this guide, we show how to buy and sell ThreeFold Tokens with [Lobstr wallet](https://lobstr.co/) using a credit or a debit card. This is a simple method that works well for small to medium purchases. You can buy TFT on Lobstr with your smartphone (Android and iOS) and your computer. + +Lobstr is an app for managing digital assets like TFT on the Stellar blockchain. In this case, we'll first obtain Stellar's native currency, Lumens (XLM) and swap them for TFT. + +> [Moonpay](https://www.moonpay.com/) is the service integrated in Lobstr to enable users to buy digital assets like XLM with fiat currencies like US Dollars and Euros. Moonpay is available in most regions, but there are some [exceptions](https://support.moonpay.com/hc/en-gb/articles/6557330712721-What-are-our-non-supported-countries-states-and-territories-for-on-ramp-product). If your country or state isn't supported by Moonpay, you will need to find another cryptocurrency exchange or on ramp to obtain XLM. From there, you can follow the rest of this guide. + +## Install Lobstr + +To get Lobstr, just head to [lobstr.co](https://lobstr.co/) where you'll find buttons to download the app for both Android and iOS. Once the app is installed, open it to continue. To use Lobstr directly on your browser, simply click on **Get Started** in the top menu of the Lobstr website. This allows you to use Lobstr on your computer instead of your smartphone. + +Hit the **Create Account** button and proceed to create an account by entering your email address and choosing a password. Verify your email address and then sign in. + +## Create Wallet + +After you sign in to Lobstr for the first time, you'll be prompted to create or connect a Stellar wallet. If you already have the TF Connect App, follow the instructions at [this link](./tft_lobstr_complete_guide.html#connect-your-tf-connect-app-wallet) to import your existing wallet into Lobstr. Otherwise, just press the **Create Stellar Wallet** button. + +Lobstr will then present you with 12 words to write down and store safely. Keep in mind that anyone who can access these words can also access any funds in your account. They can also be used to recover your account later. Be sure not to lose them. + +## Buy XLM + +In this step, we'll buy XLM with a credit or debit card (actually a few forms of bank transfer and other payment methods are [supported](https://support.moonpay.com/customers/docs/moonpays-supported-payment-methods-1) too). + +On the Lobstr app, click on the hamburger menu button: + +![image](./img/gettft_19.png) + +Then click on **Buy Crypto**: + +![image](./img/gettft_20.png) + +By default XLM is selected to buy, which is what we want. Above you can choose how much to buy in the currency of your choosing. Press **ALL** to see a full list of available currencies. + +Once you've entered the amount you want to buy, hit **Continue** and proceed through the checkout process with Moonpay. On the final screen, you'll see a message that it can take some time to complete the order: + +![image](./img/gettft_27.png) + +Usually this happens quickly and you'll receive a notification if notifications are enabled for the Lobstr app. + +## Swap XLM for TFT + +Once you have the XLM, use the hamburger menu again and this time select **Swap**: + +![image](./img/gettft_31.png) + +Enter TFT in the search bar and select the entry that includes **threefold.io**. + +> Be careful at this step! There are fake scam coins using the ThreeFold logo. We can't remove these tokens from Stellar, unfortunately, so you will need to be sure to choose the right one. + +![image](./img/gettft_32.png) + +On the next screen, XLM will be automatically selected as the currency to trade for TFT. The amount that's available to trade will be shown in blue. You can just tap this amount to trade the maximum amount. A couple XLM will be reserved to keep your account open and pay for future Stellar transaction fees. + +Hit the green button at the bottom to complete the trade. There will be a few more prompts and potentially some warnings about scam tokens (again, look for **threefold.io**). + +When you're finished you'll see a screen that says **Swap completed**. Congrats, you just bought TFT! + +## 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](../../../../knowledge_base/legal/definitions_legal.md) and seek advice from a qualified financial professional if needed. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/tft_lobstr_short_guide_archive.md b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/tft_lobstr_short_guide_archive.md new file mode 100644 index 0000000..7d30e5e --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_lobstr/tft_lobstr_short_guide_archive.md @@ -0,0 +1,58 @@ +

Lobstr Wallet: Quick Guide

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Get Started](#get-started) + - [Get TFT By Swapping](#get-tft-by-swapping) + - [Get TFT by Trading](#get-tft-by-trading) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +In this tutorial, we will guide you through the process of getting TFT on the [Lobstr Wallet](https://lobstr.co/). The wallet is available for both desktop and mobile as a web and mobile app. + +Lobstr Wallet is a secure and user-friendly wallet designed specifically for the Stellar blockchain. It allows you to store, manage, and transact with your Stellar-based assets, including TFT (ThreeFold Token). + +## Prerequisites + +- **XLM**: When getting TFT tokens using the Lobstr wallet, the process involves swapping XLM (Stellar Lumens) or other Stellar tokens into TFT. Please note that a certain amount of XLM funding is required to facilitate the sending and receiving of assets on the Stellar network. + +- **Create a Lobstr Wallet and Add TFT Asset**: Create a [Lobstr Wallet](https://lobstr.co/) account via the mobile app or desktop, and [add TFT as an asset](https://lobstr.freshdesk.com/support/solutions/articles/151000001061-adding-custom-assets-on-lobstr) (with either the code `TFT` or the home domain `threefold.io`). + +## Get Started + +### Get TFT By Swapping + +On this tutorial, we will be using the mobile app to guide you through the process of buying TFT via Lobstr. + +Once you have completed the prerequisites, you can get TFT on Lobstr by clicking the menu bar and clicking '**Swap**' to start swapping your existing tokens to TFT, for example, XLM or USDC. + +![](IMG/../img/lobstr_swap.jpeg) + +Insert the amount of TFT you'd like to buy or the amount of XLM you'd like to swap for TFT. Click '**Swap XLM to TFT**' to confirm the transaction. + +![](img/threefold__lobstr_swap_tft_.jpg) + + Congratulations. You just swapped some XLM to TFT. Go to 'Assets' page from the menu bar to see your recently purchased TFT tokens. + +### Get TFT by Trading + +For advanced traders, Lobstr provides access to the full orderbook trading functionality in the Trade section. + +You can start trading TFT on Lobstr by clicking the menu bar and clicking '**Trade**' to start trading your existing tokens to TFT, for example, XLM or USDC. + +![](IMG/../img/lobstr_trade.jpeg) + +You can choose to fullfill sell orders, or create your own buy order. Once the buy order or trade has been fulfilled your TFT will show up in your wallet. + +> Read the full details about Lobstr trading feature on [Lobstr's knowledge base](https://lobstr.freshdesk.com/support/solutions/articles/151000001080-trading-in-lobstr-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](../../../wiki/disclaimer.md) and seek advice from a qualified financial professional if needed. diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_1.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_1.png new file mode 100644 index 0000000..0db09d3 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_1.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_2.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_2.png new file mode 100644 index 0000000..b7b21f2 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_2.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_3.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_3.png new file mode 100644 index 0000000..85b01b2 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_3.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_4.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_4.png new file mode 100644 index 0000000..753c0dd Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_4.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_5.png b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_5.png new file mode 100644 index 0000000..073a4a7 Binary files /dev/null and b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/img/tft_on_ethereum_image_5.png differ diff --git a/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/tft_metamask.md b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/tft_metamask.md new file mode 100644 index 0000000..99fea4c --- /dev/null +++ b/collections/manual/documentation/threefold_token/buy_sell_tft/tft_metamask/tft_metamask.md @@ -0,0 +1,91 @@ +

Get TFT: MetaMask (BSC & ETH)

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [TFT Addresses](#tft-addresses) + - [Ethereum Chain Address](#ethereum-chain-address) + - [BSC Address](#bsc-address) +- [Add TFT to Metamask](#add-tft-to-metamask) +- [Buy TFT on Metamask](#buy-tft-on-metamask) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +In this guide, we present how to buy and sell ThreeFold Tokens on BNB Smart Chain and Ethereum using [Metamask](https://metamask.io/). + +**BNB Smart Chain** and **Ethereum** chain are blockchain networks that enable the execution of smart contracts and decentralized applications, while **MetaMask** is a software cryptocurrency wallet used to interact with Ethereum and BNB Smart Chain. + +## TFT Addresses + +With MetaMask, you can buy and sell TFT on both BNB Smart Chain and the Ethereum chain. Make sure to use the correct TFT address when doing transactions. + +### Ethereum Chain Address + +The ThreeFold Token (TFT) is available on Ethereum. +It is implemented as a wrapped asset with the following token address: + +``` +0x395E925834996e558bdeC77CD648435d620AfB5b +``` + +### BSC Address + +The ThreeFold Token (TFT) is available on BSC. +It is implemented as a wrapped asset with the following token address: + +``` +0x8f0FB159380176D324542b3a7933F0C2Fd0c2bbf +``` + +## Add TFT to Metamask + +We present the steps on Ethereum chain. Make sure to switch to BSC and to use the TFT BSC address if you want to proceed on BSC. + +Open Metamask and import the ThreeFold Token. First click on `import tokens`: + +![Metamask-Main|297x500](./img/tft_on_ethereum_image_1.png) + +Then, choose `Custom Token`: + +![Metamask-ImportToken|298x500](./img/tft_on_ethereum_image_2.png) + +To add the ThreeFold Token, paste its Ethereum address in the field `Token contract address field`. The address is the following: + +``` +0x395E925834996e558bdeC77CD648435d620AfB5b +``` + +Once you paste the TFT contract address, the parameter `Token symbol` should automatically be filled with `TFT`. + +Click on the button `Add Custom Token`. + +![Metamask-importCustomToken|297x500](./img/tft_on_ethereum_image_3.png) + +To confirm, click on the button `Import tokens`: + +![Metamask-ImporttokensQuestion|298x500](./img/tft_on_ethereum_image_4.png) + +TFT is now added to Metamask. + + +## Buy TFT on Metamask + +Liquidity is present on Ethereum so you can use the "Swap" functionality from Metamask directly or go to [Uniswap](https://app.uniswap.org/#/swap) to swap Ethereum, or any other token, to TFT. + +When using Uniswap, paste the TFT token address in the field `Select a token` to select TFT on Ethereum. The TFT token address is the following: + +``` +0x395E925834996e558bdeC77CD648435d620AfB5b +``` + +![Uniswap-selecttoken|315x500](./img/tft_on_ethereum_image_5.png) + + +## 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](../../../../knowledge_base/legal/disclaimer.md) and seek advice from a qualified financial professional if needed. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/img/albedo_balance.png b/collections/manual/documentation/threefold_token/img/albedo_balance.png new file mode 100644 index 0000000..52cef5e Binary files /dev/null and b/collections/manual/documentation/threefold_token/img/albedo_balance.png differ diff --git a/collections/manual/documentation/threefold_token/img/albedo_home.png b/collections/manual/documentation/threefold_token/img/albedo_home.png new file mode 100644 index 0000000..52cef5e Binary files /dev/null and b/collections/manual/documentation/threefold_token/img/albedo_home.png differ diff --git a/collections/manual/documentation/threefold_token/img/threefold_albedo_send_receive.png b/collections/manual/documentation/threefold_token/img/threefold_albedo_send_receive.png new file mode 100644 index 0000000..3f3b773 Binary files /dev/null and b/collections/manual/documentation/threefold_token/img/threefold_albedo_send_receive.png differ diff --git a/collections/manual/documentation/threefold_token/img/token_distribution.png b/collections/manual/documentation/threefold_token/img/token_distribution.png new file mode 100644 index 0000000..a05ad5a Binary files /dev/null and b/collections/manual/documentation/threefold_token/img/token_distribution.png differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/.done b/collections/manual/documentation/threefold_token/liquidity/img/.done new file mode 100644 index 0000000..d8cecb7 --- /dev/null +++ b/collections/manual/documentation/threefold_token/liquidity/img/.done @@ -0,0 +1,2 @@ +albedo_confirm.png +albedo_liquidity.png diff --git a/collections/manual/documentation/threefold_token/liquidity/img/1inch_pool_details.png b/collections/manual/documentation/threefold_token/liquidity/img/1inch_pool_details.png new file mode 100644 index 0000000..07521c7 Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/1inch_pool_details.png differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/1inch_pool_total.png b/collections/manual/documentation/threefold_token/liquidity/img/1inch_pool_total.png new file mode 100644 index 0000000..de818e7 Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/1inch_pool_total.png differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/1inch_provide.png b/collections/manual/documentation/threefold_token/liquidity/img/1inch_provide.png new file mode 100644 index 0000000..cb577ca Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/1inch_provide.png differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/1inch_submit.png b/collections/manual/documentation/threefold_token/liquidity/img/1inch_submit.png new file mode 100644 index 0000000..93dead2 Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/1inch_submit.png differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/1inch_tftpool.png b/collections/manual/documentation/threefold_token/liquidity/img/1inch_tftpool.png new file mode 100644 index 0000000..b8cd2ce Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/1inch_tftpool.png differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/albedo_confirm.png b/collections/manual/documentation/threefold_token/liquidity/img/albedo_confirm.png new file mode 100644 index 0000000..d09eefc Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/albedo_confirm.png differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/albedo_liquidity.png b/collections/manual/documentation/threefold_token/liquidity/img/albedo_liquidity.png new file mode 100644 index 0000000..b27aef6 Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/albedo_liquidity.png differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/assets.png b/collections/manual/documentation/threefold_token/liquidity/img/assets.png new file mode 100644 index 0000000..96ed489 Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/assets.png differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/liquidity_1inch_unlock.png b/collections/manual/documentation/threefold_token/liquidity/img/liquidity_1inch_unlock.png new file mode 100644 index 0000000..e449cce Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/liquidity_1inch_unlock.png differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/liquidity_approve.jpg b/collections/manual/documentation/threefold_token/liquidity/img/liquidity_approve.jpg new file mode 100644 index 0000000..e4fd5b6 Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/liquidity_approve.jpg differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/liquidity_busd.jpg b/collections/manual/documentation/threefold_token/liquidity/img/liquidity_busd.jpg new file mode 100644 index 0000000..6721463 Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/liquidity_busd.jpg differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/pancake_liquidity.png b/collections/manual/documentation/threefold_token/liquidity/img/pancake_liquidity.png new file mode 100644 index 0000000..c16b551 Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/pancake_liquidity.png differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/threefold_confirmation.jpg b/collections/manual/documentation/threefold_token/liquidity/img/threefold_confirmation.jpg new file mode 100644 index 0000000..b9c1f11 Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/threefold_confirmation.jpg differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/threefold_lp_tokens.jpg b/collections/manual/documentation/threefold_token/liquidity/img/threefold_lp_tokens.jpg new file mode 100644 index 0000000..a7b0432 Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/threefold_lp_tokens.jpg differ diff --git a/collections/manual/documentation/threefold_token/liquidity/img/threefold_supply.jpg b/collections/manual/documentation/threefold_token/liquidity/img/threefold_supply.jpg new file mode 100644 index 0000000..1b2eda6 Binary files /dev/null and b/collections/manual/documentation/threefold_token/liquidity/img/threefold_supply.jpg differ diff --git a/collections/manual/documentation/threefold_token/liquidity/liquidity_1inch.md b/collections/manual/documentation/threefold_token/liquidity/liquidity_1inch.md new file mode 100644 index 0000000..99845ad --- /dev/null +++ b/collections/manual/documentation/threefold_token/liquidity/liquidity_1inch.md @@ -0,0 +1,79 @@ +

Provide TFT (BSC) Liquidity on Pancake Swap

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Become a TFT LP on 1inch.io](#become-a-tft-lp-on-1inchio) +- [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +In the case of TFT on Binance Smart Chain (BSC) and [1inch.io](https://1inch.io/), becoming a liquidity provider involves providing TFT(BSC) and another token (such as BUSD) to the TFT- BSC liquidity pool on 1inch.io. + +By adding liquidity to this pool, the LP helps to ensure that there is a consistent and sufficient supply of TFT available for trading on the BSC network. This contributes to the overall liquidity of the TFT token on 1inch.io, making it easier for users to buy and sell TFT(BSC) without experiencing significant price slippage. + +By participating in the liquidity provision process, you actively contribute to the growth and adoption of the TFT token. As more users trade TFT(BSC) on 1inch.io, the liquidity and trading volume increase, which can attract more traders and investors to the token. This increased activity can lead to a broader awareness of TFT and potentially drive its value and market presence. + +## Prerequisites + +BBefore you can buy TFT on 1inch.io, there are a few prerequisites you need to fulfill. Here's what you'll need: + +- **BSC Wallet**: To interact with the Binance Smart Chain and 1inch.io, you'll need a BSC-compatible wallet. [MetaMask](https://metamask.io/) is a popular option that supports BSC. Make sure to set up and secure your wallet before proceeding. On this tutorial, we will use Metamask as our connecting wallet. + +> [Set up a Metamask Wallet](../storing_tft/metamask.md) + +- **Get BNB Tokens**: As the native cryptocurrency of Binance Smart Chain, BNB is required to pay for transaction fees on the network. You will need to have Ensure you have some BNB tokens in your BSC wallet to cover these fees when buying TFT on 1inch.io. Read [this tutorial](https://fortunly.com/articles/how-to-buy-bnb/) to know where you can buy BNB and transfer them to your BSC Wallet. + +> [Get BNB Tokens](https://docs.pancakeswap.finance/readme/get-started/bep20-guide) + +## Become a TFT LP on 1inch.io + +Anyone who fullfill the prerequisites can create a TFT(BSC) liquidity pool on 1inch.io. Currently as June 2023 on 1inch.io there is one existing BUSD - TFT(BSC) liquidity pool available where you can participate in providing liquidity into on address: + +[**https://app.1inch.io/#/56/earn/pools?filter=TFT**](https://app.1inch.io/#/56/earn/pools?filter=TFT). + +Click on the arrow as shown below to see the details of the BUSD - TFT pool. + +![](./img/1inch_tftpool.png) + +Next, click on the '**Provide Liquidity**' button in the lower right corner. A new window will open as shown below. Click on 'Provide Liquidity' icon to start the transaction process. + +![](./img/1inch_pool_details.png) + +A new window will open that will ask you to enter the amount of BUSD tokens or the amount of TFT(BSC) tokens you want to provide. As you can see in the screenshot below, before you can proceed, you have to unlock the tokens. This is required and will allow 1inch to execute smart contract transactions on your behalf. Unlocking tokens costs a small amount of BNB fees. +To unlock, click on the "Unlock" button and follow the instructions given by 1inch. You will have to confirm the transaction on your wallet. + +![](./img/liquidity_1inch_unlock.png) + +Once the tokens are unlocked, you can provide liquidity. To do so, enter the amount of BUSD tokens or the amount TFT(BSC) tokens you want to provide. The amount of the other token will adjust accordingly. + +To make the process a bit easier to understand, you can also enter the USD$ value in the corresponding field and it will adjust the token amounts automatically, according to the amount you specify. You can also click on the "Max:" link to provide the maximum amount you have available. + +On below screenshot example, we are providing $2100 into the pool, which means roughly 169354,8378 TFT(BSC) tokens, which also means we have to provide around 2100 BUSD tokens (note that these numbers will be different when you do this as prices fluctuate). +Once you have dialed in the number of tokens you want to provide to the pool, click on the "**Provide liquidity**" button. + +![](./img/1inch_provide.png) + +In the next step, you will have to confirm the transaction with your wallet. Once confirmed, you will get this screen as shown below. Make sure you bookmark the link to the Etherscan transaction, you will need it to confirm everything went according to plan. Once the transaction is confirmed on chain (see Etherscan), you are basically done. + +![](./img/1inch_submit.png) + +Once done, you can go back to the TFT pool section on 1inch.io Pools page on [**https://app.1inch.io/#/56/earn/pools?filter=TFT**](https://app.1inch.io/#/56/earn/pools?filter=TFT). and expand the BUSD-TFT pool entry. There you can see your liquidity in the pool. + +![](./img/1inch_pool_total.png) + +Note that the number of TFT and BUSD tokens will change constantly and will not be the same as you initially provided. This is because of the way liquidity pools work and is absolutely normal. + +## Important Notice + +It's important to note that being a liquidity provider involves certain risks, such as impermanent loss, which occurs when the value of the tokens in the liquidity pool fluctuates. However, if you believe in the potential of TFT and want to actively contribute to the liquidity ecosystem on 1inch.io, becoming a liquidity provider can be a rewarding opportunity to earn fees and support the growth of the platform. + +## 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](../../../knowledge_base/legal/disclaimer.md) and seek advice from a qualified financial professional if needed. diff --git a/collections/manual/documentation/threefold_token/liquidity/liquidity_albedo.md b/collections/manual/documentation/threefold_token/liquidity/liquidity_albedo.md new file mode 100644 index 0000000..7528868 --- /dev/null +++ b/collections/manual/documentation/threefold_token/liquidity/liquidity_albedo.md @@ -0,0 +1,58 @@ +

Provide TFT (Stellar) Liquidity on Albedo Wallet

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Get Started](#get-started) + - [Provide Liquidity](#provide-liquidity) +- [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +Becoming a TFT liquidity provider on the Albedo wallet allows you to actively participate in the ecosystem by contributing to the liquidity of TFT tokens. As a liquidity provider, you play a crucial role in facilitating efficient trading and swapping of TFT tokens for other assets. By providing liquidity, you can earn rewards in the form of transaction fees and other incentives. This tutorial will guide you through the process of becoming a TFT liquidity provider on the Albedo wallet, enabling you to contribute to the vibrant TFT ecosystem while potentially earning additional benefits for your participation. + +## Prerequisites + +To become a liquidity provider on Albedo and join Stellar DEX Liquidity Pools, you'll need the following prerequisites: + +- **Albedo Wallet and TFT asset setup**: Set up an Albedo wallet and add the TFT (ThreeFold Token) asset to your Albedo wallet. + +- **XLM for Transactions**: Have a sufficient amount of XLM (Stellar Lumens) in your Albedo wallet to cover transaction fees. XLM is required to execute transactions and interact with the Stellar network. + +- **Sufficient TFT**: To become a liquidity provider on Albedo, you will need a sufficient amount of TFT (Stellar) tokens. You can acquire these tokens by either depositing them from another wallet into your Albedo wallet or swapping other tokens within your Albedo wallet to obtain TFT. Additionally, you'll need an equivalent value of another token that you want to contribute to the desired liquidity pool. TFT tokens represent your share in the liquidity pool and allow you to earn a portion of the trading fees. + +## Get Started + +Anyone who fullfill the prerequisites can create a liquidity pool on Albedo wallet. In this guide, we will focus on depositing TFT and USDC to provide liquidity for the pool as an example. + +After creating and activating your account on Albedo, the next step is to activate both the TFT and USDC assets within your Albedo wallet. Ensure that you have an adequate balance of both assets for the liquidity provision. Once you have activated and balanced your assets, you are ready to add liquidity to the TFT <> USDC pool on Albedo. + +### Provide Liquidity + +You can become an LP by signing into your [Albedo wallet homepage](https://albedo.link/) and click on **Liquidity** button on the navbar as shown. Please Make sure you're on **Public** network. select the two assets you’d like to provide liquidity to, in this case, TFT & USDC. + +Set the amount of TFT and USDC you would like to provide to this pool. + +![](./img/albedo_liquidity.png) + +Click '**Deposit Liquidity to the Pool**' button to confirm the transaction. + +![](./img/albedo_confirm.png) + +Congrats, you’ve just added liquidity to the TFT <> USDC pool on Albedo Wallet. + +## Important Notice + +It's important to note that being a liquidity provider involves certain risks, such as impermanent loss, which occurs when the value of the tokens in the liquidity pool fluctuates. However, if you believe in the potential of TFT and want to actively contribute to the liquidity ecosystem on PancakeSwap, becoming a liquidity provider can be a rewarding opportunity to earn fees and support the growth of the platform. + +## 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](../../../knowledge_base/legal/disclaimer.md) and seek advice from a qualified financial professional if needed. + + diff --git a/collections/manual/documentation/threefold_token/liquidity/liquidity_pancake.md b/collections/manual/documentation/threefold_token/liquidity/liquidity_pancake.md new file mode 100644 index 0000000..b2d378f --- /dev/null +++ b/collections/manual/documentation/threefold_token/liquidity/liquidity_pancake.md @@ -0,0 +1,73 @@ +

Provide TFT Liquidity on Pancake Swap

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Become a TFT - BSC LP](#become-a-tft---bsc-lp) +- [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) +*** +## Introduction + +In the case of TFT on Binance Smart Chain (BSC) and PancakeSwap, becoming a liquidity provider involves providing TFT and another token (such as BNB) to the TFT-BNB liquidity pool on PancakeSwap. + +By adding liquidity to this pool, the LP helps to ensure that there is a consistent and sufficient supply of TFT(BSC) available for trading on the BSC network. This contributes to the overall liquidity of the TFT token on PancakeSwap, making it easier for users to buy and sell TFT(BSC) without experiencing significant price slippage. + +Becoming a liquidity provider for TFT(BSC) on PancakeSwap can have several benefits. Firstly, as an LP, you earn trading fees proportional to the amount of liquidity you have provided. **Anyone interested in providing Liquidity to the ThreeFold pools on PancakeSwap will be incentivized and rewarded with trading fees. 0.17% of all trading fees of all transactions go to Liquidity providers.** These fees are distributed to LPs based on their share of the total liquidity pool. + +Additionally, by participating in the liquidity provision process, you actively contribute to the growth and adoption of the TFT token. As more users trade TFT on PancakeSwap, the liquidity and trading volume increase, which can attract more traders and investors to the token. This increased activity can lead to a broader awareness of TFT and potentially drive its value and market presence. + +## Prerequisites + +Before you can become a TFT(BSC) LP on Pancake Swap, there are a few prerequisites you need to fulfill. Here's what you'll need: + +- **BSC Wallet**: To interact with the Binance Smart Chain and Pancake Swap, you'll need a BSC-compatible wallet. [MetaMask](https://metamask.io/) is a popular option that supports BSC. Make sure to set up and secure your wallet before proceeding. + +> [Set up a Metamask Wallet](../storing_tft/metamask.md) + +- **Connect BSC Wallet TO Pancake Swap**: Visit the Pancake Swap website and connect your BSC wallet to your Pancake Swap account. + +> [Connect Wallet to Pancake Swap](https://docs.pancakeswap.finance/readme/get-started/connection-guide) + +- **Get BNB Tokens**: As the native cryptocurrency of Binance Smart Chain, BNB is required to pay for transaction fees on the network. Ensure you have some BNB tokens in your BSC wallet to cover these fees when buying TFT(BSC) on Pancake Swap. Read [this tutorial](https://fortunly.com/articles/how-to-buy-bnb/) to know where you can buy BNB and transfer them to your BSC Wallet. + +> [Get BNB Tokens](https://docs.pancakeswap.finance/readme/get-started/bep20-guide) + +- **Sufficient TFT**: To participate as a liquidity provider on PancakeSwap, you will need to acquire **TFT(BSC)** tokens and deposit them into your BSC Wallet, along with an equivalent value of another token, into the desired liquidity pool. The TFT tokens act as your share of the liquidity pool and entitle you to a portion of the trading fees generated by the platform. + +## Become a TFT - BSC LP + +Anyone who fullfill the prerequisites can create a liquidity pool on Pancake Swap. + +Now that you're all set, you can become an LP by going to your [PancakeSwap homepage](https://pancakeswap.finance/) and click on **Trade > Liquidity** button on the navbar as shown. Please Make sure you're on **BNB Smart Chain** network. + +![](./img/pancake_liquidity.png) + +You will now be directed to the Liquidity page. When providing liquidity for TFT(BSC) on PancakeSwap, we recommend you to pair it with BUSD (Binance USD), which already has significant liquidity. The ratio between TFT(BSC) and BUSD in the existing pool is fixed by market prices. Simply choose the amount of liquidity you want to provide for both currencies. Consider the potential risks associated with impermanent loss. Join the TFT pool on PancakeSwap to contribute and trade TFT(BSC) tokens. + +![](./img/liquidity_busd.jpeg) + +Click “approve” for both currencies, then c;ick 'confirm' to accept the wallet prompts and fees. + +![](./img/liquidity_approve.jpeg) + +![](./img/threefold__confirmation.jpg) + +Click “supply” and confirm the wallet prompt and fee. + +![](./img/threefold__supply.jpg) + +Congratulations! You have now exchanged the selected amounts for both currencies for LPs (Liquidity Tokens) and you are providing liquidity and earning a part of the transaction fees. + +![](./img/threefold__lp_tokens.jpg) + +## Important Notice + +It's important to note that being a liquidity provider involves certain risks, such as impermanent loss, which occurs when the value of the tokens in the liquidity pool fluctuates. However, if you believe in the potential of TFT and want to actively contribute to the liquidity ecosystem on PancakeSwap, becoming a liquidity provider can be a rewarding opportunity to earn fees and support the growth of the platform. + +## 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](../../../knowledge_base/legal/disclaimer.md) and seek advice from a qualified financial professional if needed. diff --git a/collections/manual/documentation/threefold_token/liquidity/liquidity_readme.md b/collections/manual/documentation/threefold_token/liquidity/liquidity_readme.md new file mode 100644 index 0000000..3a1d592 --- /dev/null +++ b/collections/manual/documentation/threefold_token/liquidity/liquidity_readme.md @@ -0,0 +1,33 @@ +

Become a TFT Liquidity Provider

+ +

Table of Contents

+ +- [Liquidity Provider on Pancake Swap](./liquidity_pancake.md) +- [Liquidity Provider on 1inch.io](./liquidity_1inch.md) +- [Liquidity Provider on Albedo](./liquidity_albedo.md) + + +*** + +## Introduction + +A **liquidity provider** (LP) is an individual or entity that contributes liquidity to a decentralized exchange or automated market maker (AMM) platform. In the context of cryptocurrency, a liquidity provider typically deposits an equal value of two different tokens into a liquidity pool. By doing so, they enable traders to easily swap between these tokens at any time, ensuring there is sufficient liquidity in the market. + +Indeed, becoming a TFT liquidity provider can vary based on the platform, wallet, or exchange, as well as the underlying blockchain. The pairing token also plays a role in determining the available liquidity pools for TFT. + +For instance, on PancakeSwap, you can become a TFT(BSC) liquidity provider by pairing it with BNB (Binance Coin) on the Binance Smart Chain (BSC). On the other hand, platforms like 1inch.io may offer different pairing options, such as TFT(BSC) with BUSD (Binance USD) or other compatible tokens. + +Similarly, the blockchain being used can affect the liquidity provision options. For example, you can become a TFT liquidity provider on the Stellar blockchain using wallets like Albedo, specifically designed for Stellar assets. However, you cannot become a TFT(Stellar) liquidity provider on PancakeSwap, but you can become a TFT(BSC) liquidity provider instead, since it currently supports assets on the Binance Smart Chain (BSC), not the Stellar blockchain. + +It is important to consider the specific platform, wallet, or exchange you are using, as well as the blockchain and available pairing tokens, to determine the appropriate method for becoming a TFT liquidity provider. Ensure you follow the guidelines and instructions provided by the respective platforms to successfully participate in the desired liquidity pool. + +*** +## Important Notice + +It's important to note that being a liquidity provider involves certain risks, such as impermanent loss, which occurs when the value of the tokens in the liquidity pool fluctuates. However, if you believe in the potential of TFT and want to actively contribute to the liquidity ecosystem on PancakeSwap, becoming a liquidity provider can be a rewarding opportunity to earn fees and support the growth of the platform. +*** +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/storing_tft/albedo_store.md b/collections/manual/documentation/threefold_token/storing_tft/albedo_store.md new file mode 100644 index 0000000..b849c0b --- /dev/null +++ b/collections/manual/documentation/threefold_token/storing_tft/albedo_store.md @@ -0,0 +1,102 @@ +

Store TFT (Stellar) on Albedo Wallet

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Get Started](#get-started) + - [Create and Fund Albedo Wallet](#create-and-fund-albedo-wallet) + - [Add TFT asset to Albedo Wallet](#add-tft-asset-to-albedo-wallet) + - [Storing / Receiving and Sending TFT](#storing--receiving-and-sending-tft) +- [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) +*** +## Introduction + +Welcome to our guide on how to store TFT tokens (Stellar) via the [Albedo wallet](https://albedo.link/)! + +Albedo is a secure and trustworthy keystore web app and browser extension designed for Stellar token accounts. With Albedo, you can safely manage and transact with your Stellar account without having to share your secret key with any third parties. +Developed by the creators of stellar.expert explorer, Albedo offers a range of features, including storage, swaps, and participation in liquidity pools. It is an open-source solution that can be accessed directly from your browser or installed as a browser add-on, currently available for Chrome and Firefox. + +In this tutorial, we will walk you through the process of storing Stellar TFT tokens using the Albedo wallet. +*** +## Prerequisites + +- **XLM**: When storing TFT tokens using the Albedo wallet, a certain amount of XLM funding is required to facilitate the sending and receiving of assets on the Stellar network. + +There are multiple ways to acquire XLM and send it to your wallet. One option is to utilize XLM-supported exchanges, which provide a convenient platform for purchasing XLM. Click [here](https://www.coinlore.com/coin/stellar/exchanges) to access a comprehensive list of exchanges that support XLM. + +As an example, we have created a tutorial specifically focusing on how to buy XLM on Coinbase, one of the popular cryptocurrency exchanges. This tutorial provides step-by-step instructions on the process of purchasing XLM on **Coinbase Exchange**. You can find the tutorial [**here**](../buy_sell_tft/coinbase_xlm.md). +*** +## Get Started + +### Create and Fund Albedo Wallet + +Go to [https://albedo.link/signup](https://albedo.link/signup) to start your sign up process. + +![](img/albedo_signup.png) + +Ensure you save your 24-word recovery passphrase. This is very important! +Click “**I saved recovery phrase**” (Again, it is critical that you save this recovery phrase somewhere, and do so securely). This key is the only way you could recover your account if you ever lose access to it. + +![](img/albedo_secret.png) + +Congrats! You just created an Albedo wallet. To get started swapping tokens into TFT, firstly we would need to fund your wallet with XLM by clicking '**fund it**' on the homepage. + +![](img/albedo_fund.png) + +Send some XLM for a third party wallets or stellar exchanger of your choice to your Albedo XLM wallet. + +![](img/albedo_receive.png) + +Once you sent the XLM, you will see the balance added to the homepage. now we are ready to do some token transactions! + +![](img/albedo_home.png) + +### Add TFT asset to Albedo Wallet + +To store TFT in our Albedo Wallet, we will need to have a TFT wallet added into our account. This is done by creating a trustline for TFT. Creating a trustline means granting permission for your Albedo wallet to recognize and interact with TFT tokens on the Stellar network. It allows you to view your TFT balance, send and receive TFT tokens, and engage in swapping or trading activities involving TFT within the Albedo wallet. + +To add a trustline, go to the “**Balance**” section, and click “**Add trustline**” button. + +![](img/albedo_activate.png) + +A popup window will appear presenting Albedo's asset list. In the search field that appears, type in '**TFT**' as the asset you want to add. + +**It is important to ensure that you also see the name "threefold.io" next to the logo** , as this verifies that you are selecting the genuine TFT asset associated with ThreeFold. **Beware of imposters or fraudulent assets that may attempt to mimic TFT.** ThreeFold cannot assume responsibility for any errors or mistakes made during the trustline creation process done by users. If you have any uncertainties or doubts, it is always recommended to seek assistance from official support channels or trusted sources to ensure the accuracy of the trustline configuration. + +![](img/albedo_select_asset.png) + +Confirm the selected asset by pressing “**Add trustline**”. + +![](img/albedo_trustline.png) + +Congrats! You have now successfully added TFT as an asset to your Albedo wallet. + +### Storing / Receiving and Sending TFT + +You can now store TFT by depositing it from another wallet by copying your public Albedo wallet address and sending it to the withdrawer. + +You can also transfer TFT to another stellar wallet by clicking the '**Transfer**' icon on your wallet navbar and specify the amount of TFT and the receipient's wallet address and memo (if any), and click 'Transfer' button to finish the transaction. + +![](img/albedo_send_receive.png) +*** +## Important Notice + +If you are looking for ways to get / purchase TFT (Stellar) on Albedo, you will find the according information [here](../buy_sell_tft/albedo_buy.md). +*** +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. + + + + + + + + + + diff --git a/collections/manual/documentation/threefold_token/storing_tft/btc_alpha_deposit.md b/collections/manual/documentation/threefold_token/storing_tft/btc_alpha_deposit.md new file mode 100644 index 0000000..bd65ebc --- /dev/null +++ b/collections/manual/documentation/threefold_token/storing_tft/btc_alpha_deposit.md @@ -0,0 +1,131 @@ +

Store TFT on BTC-Alpha Exchange

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Get Started](#get-started) + - [Sign up for an Account](#sign-up-for-an-account) + - [Secure Your Account](#secure-your-account) +- [Deposit TFT(Stellar) to Account](#deposit-tftstellar-to-account) + - [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) +*** +## Introduction + +Welcome to our tutorial on how to get TFT (Stellar) using [**BTC-Alpha**](https://btc-alpha.com/en)! + + +BTC-Alpha is a cryptocurrency exchange platform that provides a secure and user-friendly environment for trading various digital assets, including TFT (Stellar). With its robust features and intuitive interface, BTC-Alpha offers a convenient way to buy and sell cryptocurrencies. + +In this guide, we will walk you through the process of storing TFT on the BTC-Alpha exchange by depositing TFT from your external wallet to your BTC-Alpha Exchange. + +> If you are looking for ways to get / purchase TFT (Stellar) on BTC-Alpha by trading, you will find the according information [here](../buy_sell_tft/btc_alpha.md). +*** +## Prerequisites + +- **ID for verification:** To get TFT (Stellar) on the BTC-Alpha exchange, you will need to have your identification (ID) ready for the verification process. This is a standard requirement to ensure compliance with regulatory guidelines and maintain a secure trading environment. Your ID may include documents such as a valid passport or government-issued identification card. + +- **BTC-Alpha Account**: You must have an active account on the BTC-Alpha exchange. If you don't have one, you can sign up on their website and complete the registration process. Make sure to secure your account with strong passwords and two-factor authentication for enhanced security. +*** +## Get Started + +### Sign up for an Account + +**Sign up for a BTC-Alpha Account:** Visit the BTC-Alpha website [https://btc-alpha.com/](https://btc-alpha.com/) and click on the "**Sign up**" button. Fill in the required information, including your email address, a secure password, and any additional details requested for the account creation process. +![](img/alpha_signup.png) + +**Login to your account**: You will then receive a notification that allow you to login to your new account. + +![](img/alpha_login.png) + +Now, you can proceed to log in to your account and start exploring the platform. Follow these steps to log in: + +Visit the BTC-Alpha website (https://btc-alpha.com/) on your web browser. Click on the "Login" button located on the top-right corner of the website. + +Enter the email address and password you used during the registration process in the respective fields. + +![](img/alpha_email.png) + + +**Verify Your Account:** After completing the registration, you may need to verify your account by providing some personal identification information. This is a standard procedure for most cryptocurrency exchanges to ensure compliance with regulations and security measures. Follow the instructions provided by BTC-Alpha to complete the verification process. + +![](img/alpha_verify.png) + +Congratulations on completing the registration process for your BTC-Alpha account and are logged in to your account successfully! + +![](img/alpha_home.png) + +### Secure Your Account + +**Secure Your Account**: Set up two-factor authentication (2FA) to add an extra layer of security to your BTC-Alpha account. This typically involves linking your account to a 2FA app, such as Google Authenticator or Authy, and enabling it for login and transaction verification. + +To enable two-factor authentication (2FA) on your BTC-Alpha account, follow these steps: + +Install either the [2FA Alp Authenticator](https://play.google.com/store/apps/details?id=com.alp.two_fa) or [Google Authenticator](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=en&gl=US) app on your mobile phone. You can find Authy on the App Store or Google Play, and Google Authenticator on the Google Play Store or Apple App Store. + +Once you have installed the app, log in to your BTC-Alpha account. + +Right-Click on your name or profile icon located at the top-right corner of the website to access the account settings, and look for the option "**Enable Two-factor Authentication**" and click on it. + +![](img/alpha_auth.png) + +Follow the instructions provided to link your BTC-Alpha account with the Authy or Google Authenticator app. This usually involves scanning a QR code or manually entering a code provided by the app. + +![](img/alpha_2fa.png) + +Once the link is established, the app will start generating unique codes that you will need to enter during the login process for additional security. + +By enabling two-factor authentication, you add an extra layer of security to your BTC-Alpha account, helping to protect your funds and personal information. Make sure to keep your mobile device with the authenticator app secure, as it will be required each time you log in to your BTC-Alpha account. +*** +## Deposit TFT(Stellar) to Account + +To begin storing **TFT** on the BTC-Alpha exchange, you will need to deposit some TFT funds into your account. + +To deposit TFT into your BTC-Alpha account, follow these steps: + +Log in to your BTC-Alpha account and Click on the "Wallets" tab located in the top menu. + +![](img/alpha_wallet.png) + +Search for "**TFT**" in the list of available cryptocurrencies. + +![](./img/alpha_tft.png) + +You will be provided with a TFT deposit address. +Make sure you choose **ThreeFold Token (Stellar)** as your deposit method. + +To deposit, Copy this address or scan the QR code associated with it. As well as the Memo. + +Use your personal external TFT wallet or the wallet of another exchange to initiate a withdrawal to the provided deposit address. + +Ensure that you specify the correct deposit address and Memo. Double-check it before confirming the transaction. + +**IMPORTANT**: It is crucial to always include the correct memo when sending TFT (Stellar) tokens to ensure the transaction is processed accurately. Failing to include the memo or entering an incorrect memo can lead to the loss of TFT tokens. + +Wait for the transaction to be confirmed on the Stellar network. This may take some time depending on network congestion. +Once the transaction is confirmed, the TFT will be credited to your BTC-Alpha account balance. + +You can check your account balance by clicking on the "**Wallets**" tab or by navigating to the "**Balances**" section. + +Please note that the exact steps for depositing TFT may vary depending on the specific wallet or exchange you are using to send the funds. It is essential to double-check the deposit address and follow the instructions provided by your wallet or exchange to ensure a successful deposit. + +### Important Notice + +While it is possible to keep your TFT in your exchange wallet on BTC-Alpha, it is generally not recommended to store your funds there for an extended period. Public exchanges are more susceptible to security breaches and hacking attempts compared to personal wallets. + +To ensure the safety and security of your TFT holdings, it is advisable to transfer them to a dedicated TFT wallet. There are several options available for creating a TFT wallet, each with its own unique features and benefits. + +To explore different TFT wallet options and choose the one that best suits your needs, you can refer to our comprehensive [**TFT Wallet guide**](../storing_tft/tf_connect_app.md#create-a-wallet) that provides a list of recommended TFT wallets. This guide will help you understand the features, security measures, and compatibility of each wallet, enabling you to make an informed decision on where to store your TFT securely. + +Remember, maintaining control over your private keys and taking precautions to protect your wallet information are essential for safeguarding your TFT investments. + +If you are looking for ways to get / purchase TFT (Stellar) on BTC-Alpha by trading, you will find the according information [here](../buy_sell_tft/btc_alpha.md). +*** +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. + + diff --git a/collections/manual/documentation/threefold_token/storing_tft/hardware_wallet.md b/collections/manual/documentation/threefold_token/storing_tft/hardware_wallet.md new file mode 100644 index 0000000..a00c9f9 --- /dev/null +++ b/collections/manual/documentation/threefold_token/storing_tft/hardware_wallet.md @@ -0,0 +1,75 @@ + +

Hardware Wallet

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Setting up a TFT Trustline on Stellar Blockchain](#setting-up-a-tft-trustline-on-stellar-blockchain) +- [Conclusion](#conclusion) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +You can store TFT on a hardwallet for optimal security. + +Also, if you are a farmer, instead of using the ThreeFold Connect app to receive your farming rewards (TFTs), you can also have your farming rewards sent to a hardware wallet. In this case, you will need to enable a TFT trustline to receive TFT. + +You can store TFT on a hardware wallet on Stellar chain, BSC or the Ethereum chain. For this guide, we show how to store TFT on a hardware wallet on Stellar chain. + +To store TFT on Stellar, you can use any hardware wallet that supports the Stellar Blockchain, such as a [Ledger](https://www.ledger.com/). + +## Setting up a TFT Trustline on Stellar Blockchain + +Setting up a trustline is simple. + +We will show an example with a Ledger hardware wallet. The process is similar with other hardware wallets. Just make sure that your hardware wallet is compatible with the Stellar blockchain, as the TFT from farming rewards will be sent on the Stellar Blockchain. + +* First, [download Ledger Live](https://www.ledger.com/ledger-live/download) and download the Stellar application in **Manager**. +* Go on an official Stellar website such as [Stellarterm](https://stellarterm.com/) or [StellarX](https://www.stellarx.com/). For this example, we will be using Stellarterm.com. + +* Unlock your Ledger by entering your password. + +* Select the Stellar App. + * In our case, we do not need to create an account on Stellerterm, since we are using a hardware wallet. + +* On Stellarterm.com, click on the button **LOGIN**. + +![farming_wallet_7](./img/farming_wallet_7.png) + + +* At the bottom of the page, select the option **Ledger** or another option if you are using a different hardware wallet. + +![farming_wallet_8](./img/farming_wallet_8.png) + +* Click **Connect with Ledger**. + +![farming_wallet_9](./img/farming_wallet_9.png) + + +* Read and accept the Terms of Use. + +![farming_wallet_10](./img/farming_wallet_10.png) + + +* On the main page, click on **Assets**. + +![farming_wallet_11](./img/farming_wallet_11.png) + +* Scroll down and write **Threefold.io** in the Text box. Select **TFT Threefold.io**. Click **Accept**. Then follow the steps presented on your hardware wallet to confirm the trust line. + +![farming_wallet_12](./img/farming_wallet_12.png) +![farming_wallet_13](./img/farming_wallet_13.png) + +## Conclusion + +You now have a TFT trust line on the Stellar Blockchain. You can now receive TFT on this wallet. This is a perfect setup to farm TFT safely. + +When it comes to choosing where to send your farming rewards, you simply need to enter the address associated with your 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](../../../knowledge_base/legal/disclaimer.md) and seek advice from a qualified financial professional if needed. diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/.done b/collections/manual/documentation/threefold_token/storing_tft/img/.done new file mode 100644 index 0000000..1918246 --- /dev/null +++ b/collections/manual/documentation/threefold_token/storing_tft/img/.done @@ -0,0 +1,9 @@ +alpha_signup.png +alpha_trade.png +alpha_wallet.png +inter_funded.png +lobstr_assets.png +metamask_installed.png +metamask_new.png +metamask_pass.png +metamask_privatekey.png diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/albedo_activate.png b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_activate.png new file mode 100644 index 0000000..4fe338e Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_activate.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/albedo_fund.png b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_fund.png new file mode 100644 index 0000000..a0bcc0c Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_fund.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/albedo_receive.png b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_receive.png new file mode 100644 index 0000000..bf1f2a0 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_receive.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/albedo_secret.png b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_secret.png new file mode 100644 index 0000000..7e76183 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_secret.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/albedo_select_asset.png b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_select_asset.png new file mode 100644 index 0000000..f06f2e3 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_select_asset.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/albedo_send_receive.png b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_send_receive.png new file mode 100644 index 0000000..3f3b773 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_send_receive.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/albedo_signup.png b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_signup.png new file mode 100644 index 0000000..f70733b Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_signup.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/albedo_swap.png b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_swap.png new file mode 100644 index 0000000..f7e0943 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_swap.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/albedo_swap1.png b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_swap1.png new file mode 100644 index 0000000..d215a22 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_swap1.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/albedo_trustline.png b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_trustline.png new file mode 100644 index 0000000..8e43505 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/albedo_trustline.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/alpha_2fa.png b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_2fa.png new file mode 100644 index 0000000..2714d3e Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_2fa.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/alpha_auth.png b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_auth.png new file mode 100644 index 0000000..df46d5a Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_auth.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/alpha_deposit.png b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_deposit.png new file mode 100644 index 0000000..8039284 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_deposit.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/alpha_email.png b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_email.png new file mode 100644 index 0000000..84fceea Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_email.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/alpha_home.png b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_home.png new file mode 100644 index 0000000..faacb0b Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_home.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/alpha_limit.png b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_limit.png new file mode 100644 index 0000000..f0b361a Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_limit.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/alpha_login.png b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_login.png new file mode 100644 index 0000000..3c93fdb Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_login.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/alpha_search.png b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_search.png new file mode 100644 index 0000000..3880273 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_search.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/alpha_signup.png b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_signup.png new file mode 100644 index 0000000..95419d2 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_signup.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/alpha_tft.png b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_tft.png new file mode 100644 index 0000000..227bff3 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_tft.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/alpha_trade.png b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_trade.png new file mode 100644 index 0000000..ef7c9cb Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_trade.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/alpha_verify.png b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_verify.png new file mode 100644 index 0000000..8065339 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_verify.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/alpha_wallet.png b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_wallet.png new file mode 100644 index 0000000..081e25a Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/alpha_wallet.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_1.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_1.png new file mode 100644 index 0000000..6e1f766 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_1.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_10.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_10.png new file mode 100644 index 0000000..d990568 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_10.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_11.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_11.png new file mode 100644 index 0000000..1a0d5b9 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_11.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_12.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_12.png new file mode 100644 index 0000000..9ffb19d Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_12.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_13.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_13.png new file mode 100644 index 0000000..1b96f81 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_13.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_14.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_14.png new file mode 100644 index 0000000..c0b301f Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_14.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_15.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_15.png new file mode 100644 index 0000000..120be6a Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_15.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_16.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_16.png new file mode 100644 index 0000000..781bf30 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_16.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_17.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_17.png new file mode 100644 index 0000000..51130a3 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_17.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_18.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_18.png new file mode 100644 index 0000000..8fe5d2f Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_18.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_19.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_19.png new file mode 100644 index 0000000..6c6796c Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_19.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_2.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_2.png new file mode 100644 index 0000000..564b312 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_2.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_20.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_20.png new file mode 100644 index 0000000..da5c0ca Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_20.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_21.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_21.png new file mode 100644 index 0000000..27abf0c Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_21.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_22.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_22.png new file mode 100644 index 0000000..adde6b0 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_22.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_23.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_23.png new file mode 100644 index 0000000..aabf0a0 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_23.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_24.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_24.png new file mode 100644 index 0000000..01ea640 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_24.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_25.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_25.png new file mode 100644 index 0000000..72566b2 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_25.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_26.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_26.png new file mode 100644 index 0000000..e9931d3 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_26.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_27.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_27.png new file mode 100644 index 0000000..b20e7c1 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_27.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_28.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_28.png new file mode 100644 index 0000000..ddace3b Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_28.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_29.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_29.png new file mode 100644 index 0000000..52a66cd Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_29.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_3.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_3.png new file mode 100644 index 0000000..0a45687 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_3.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_30.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_30.png new file mode 100644 index 0000000..2e30308 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_30.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_31.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_31.png new file mode 100644 index 0000000..ff1b9ac Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_31.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_32.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_32.png new file mode 100644 index 0000000..ab617bf Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_32.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_33.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_33.png new file mode 100644 index 0000000..3c6d591 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_33.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_34.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_34.png new file mode 100644 index 0000000..944688f Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_34.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_35.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_35.png new file mode 100644 index 0000000..845bd35 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_35.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_36.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_36.png new file mode 100644 index 0000000..b294bcb Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_36.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_37.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_37.png new file mode 100644 index 0000000..c61e06e Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_37.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_38.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_38.png new file mode 100644 index 0000000..732f98a Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_38.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_39.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_39.png new file mode 100644 index 0000000..0c78bc0 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_39.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_4.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_4.png new file mode 100644 index 0000000..11ef6d7 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_4.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_40.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_40.png new file mode 100644 index 0000000..6651627 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_40.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_41.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_41.png new file mode 100644 index 0000000..839e929 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_41.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_42.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_42.png new file mode 100644 index 0000000..5f84480 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_42.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_43.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_43.png new file mode 100644 index 0000000..eb3a017 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_43.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_44.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_44.png new file mode 100644 index 0000000..4a10071 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_44.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_45.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_45.png new file mode 100644 index 0000000..0d6e86d Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_45.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_46.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_46.png new file mode 100644 index 0000000..2039941 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_46.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_47.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_47.png new file mode 100644 index 0000000..71ea72e Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_47.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_48.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_48.png new file mode 100644 index 0000000..fd357c7 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_48.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_49.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_49.png new file mode 100644 index 0000000..0f82c97 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_49.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_5.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_5.png new file mode 100644 index 0000000..2dd845d Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_5.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_50.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_50.png new file mode 100644 index 0000000..0ecbc06 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_50.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_51.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_51.png new file mode 100644 index 0000000..86ecf04 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_51.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_52.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_52.png new file mode 100644 index 0000000..9d2b5a4 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_52.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_53.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_53.png new file mode 100644 index 0000000..141c24d Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_53.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_54.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_54.png new file mode 100644 index 0000000..2c97d1b Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_54.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_55.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_55.png new file mode 100644 index 0000000..2d7fe0e Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_55.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_56.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_56.png new file mode 100644 index 0000000..e090e08 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_56.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_57.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_57.png new file mode 100644 index 0000000..b9289a4 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_57.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_58.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_58.png new file mode 100644 index 0000000..a78d6d8 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_58.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_59.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_59.png new file mode 100644 index 0000000..4f6e7f2 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_59.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_6.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_6.png new file mode 100644 index 0000000..5766b18 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_6.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_7.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_7.png new file mode 100644 index 0000000..c9256be Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_7.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_8.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_8.png new file mode 100644 index 0000000..0901cf6 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_8.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_9.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_9.png new file mode 100644 index 0000000..a913e4b Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_tf_wallet_9.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_10.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_10.png new file mode 100644 index 0000000..7ae95fc Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_10.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_11.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_11.png new file mode 100644 index 0000000..6ce3313 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_11.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_12.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_12.png new file mode 100644 index 0000000..b26559e Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_12.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_13.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_13.png new file mode 100644 index 0000000..9486799 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_13.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_5.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_5.png new file mode 100644 index 0000000..9a83dd3 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_5.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_7.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_7.png new file mode 100644 index 0000000..ce1f1ba Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_7.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_8.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_8.png new file mode 100644 index 0000000..b8039d9 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_8.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_9.png b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_9.png new file mode 100644 index 0000000..882bcf7 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/farming_wallet_9.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/inter_deposit.png b/collections/manual/documentation/threefold_token/storing_tft/img/inter_deposit.png new file mode 100644 index 0000000..e59bb17 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/inter_deposit.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/inter_funded.png b/collections/manual/documentation/threefold_token/storing_tft/img/inter_funded.png new file mode 100644 index 0000000..0c4dc43 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/inter_funded.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/inter_home.png b/collections/manual/documentation/threefold_token/storing_tft/img/inter_home.png new file mode 100644 index 0000000..382c8c3 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/inter_home.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/inter_home1.png b/collections/manual/documentation/threefold_token/storing_tft/img/inter_home1.png new file mode 100644 index 0000000..fb71577 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/inter_home1.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/inter_key.png b/collections/manual/documentation/threefold_token/storing_tft/img/inter_key.png new file mode 100644 index 0000000..42ec8ea Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/inter_key.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/inter_login.png b/collections/manual/documentation/threefold_token/storing_tft/img/inter_login.png new file mode 100644 index 0000000..108bced Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/inter_login.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/inter_ok.png b/collections/manual/documentation/threefold_token/storing_tft/img/inter_ok.png new file mode 100644 index 0000000..8c3cc6d Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/inter_ok.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/inter_pass.png b/collections/manual/documentation/threefold_token/storing_tft/img/inter_pass.png new file mode 100644 index 0000000..d3a3fce Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/inter_pass.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/inter_popup.png b/collections/manual/documentation/threefold_token/storing_tft/img/inter_popup.png new file mode 100644 index 0000000..5954232 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/inter_popup.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/inter_success.png b/collections/manual/documentation/threefold_token/storing_tft/img/inter_success.png new file mode 100644 index 0000000..dc3ad7a Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/inter_success.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/inter_tft.png b/collections/manual/documentation/threefold_token/storing_tft/img/inter_tft.png new file mode 100644 index 0000000..6d2ff0a Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/inter_tft.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_asset.jpg b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_asset.jpg new file mode 100644 index 0000000..6ffbf2b Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_asset.jpg differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_assets.png b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_assets.png new file mode 100644 index 0000000..f7a6715 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_assets.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_download.png b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_download.png new file mode 100644 index 0000000..3dd7f3c Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_download.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_fed.png b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_fed.png new file mode 100644 index 0000000..74b1d5d Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_fed.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_key.png b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_key.png new file mode 100644 index 0000000..af2322e Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_key.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_new.png b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_new.png new file mode 100644 index 0000000..7994dad Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_new.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_pass.png b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_pass.png new file mode 100644 index 0000000..b72a626 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_pass.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_verify.png b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_verify.png new file mode 100644 index 0000000..846de25 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_verify.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_web.png b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_web.png new file mode 100644 index 0000000..318c0cc Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/lobstr_web.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_add.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_add.png new file mode 100644 index 0000000..bae4fd7 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_add.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_choose.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_choose.png new file mode 100644 index 0000000..d86ac35 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_choose.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_confirm.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_confirm.png new file mode 100644 index 0000000..dd75dea Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_confirm.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_custom.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_custom.png new file mode 100644 index 0000000..8255593 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_custom.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_import.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_import.png new file mode 100644 index 0000000..5c02164 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_import.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_installed.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_installed.png new file mode 100644 index 0000000..8fc1c32 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_installed.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_new.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_new.png new file mode 100644 index 0000000..4efc236 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_new.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_pass.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_pass.png new file mode 100644 index 0000000..069a091 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_pass.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_privatekey.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_privatekey.png new file mode 100644 index 0000000..d584de2 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_privatekey.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_success.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_success.png new file mode 100644 index 0000000..dd75dea Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_success.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_switch.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_switch.png new file mode 100644 index 0000000..0d05255 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_switch.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_tft.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_tft.png new file mode 100644 index 0000000..dd75dea Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_tft.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_tft_auto.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_tft_auto.png new file mode 100644 index 0000000..996499c Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_tft_auto.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/metamask_tft_home.png b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_tft_home.png new file mode 100644 index 0000000..d0a2dda Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/metamask_tft_home.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_account.png b/collections/manual/documentation/threefold_token/storing_tft/img/solar_account.png new file mode 100644 index 0000000..55d157f Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_account.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_add.png b/collections/manual/documentation/threefold_token/storing_tft/img/solar_add.png new file mode 100644 index 0000000..10e5eca Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_add.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_asset.png b/collections/manual/documentation/threefold_token/storing_tft/img/solar_asset.png new file mode 100644 index 0000000..c47ede4 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_asset.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_confirm.png b/collections/manual/documentation/threefold_token/storing_tft/img/solar_confirm.png new file mode 100644 index 0000000..e5a03b8 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_confirm.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_copy.jpg b/collections/manual/documentation/threefold_token/storing_tft/img/solar_copy.jpg new file mode 100644 index 0000000..266484f Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_copy.jpg differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_desktop.jpg b/collections/manual/documentation/threefold_token/storing_tft/img/solar_desktop.jpg new file mode 100644 index 0000000..27f14f5 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_desktop.jpg differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_home.jpg b/collections/manual/documentation/threefold_token/storing_tft/img/solar_home.jpg new file mode 100644 index 0000000..4898bbf Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_home.jpg differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_home.png b/collections/manual/documentation/threefold_token/storing_tft/img/solar_home.png new file mode 100644 index 0000000..530adb4 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_home.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_install.png b/collections/manual/documentation/threefold_token/storing_tft/img/solar_install.png new file mode 100644 index 0000000..380f6d1 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_install.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_receive.jpg b/collections/manual/documentation/threefold_token/storing_tft/img/solar_receive.jpg new file mode 100644 index 0000000..4898bbf Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_receive.jpg differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_search.png b/collections/manual/documentation/threefold_token/storing_tft/img/solar_search.png new file mode 100644 index 0000000..0247b7e Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_search.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_secret.jpg b/collections/manual/documentation/threefold_token/storing_tft/img/solar_secret.jpg new file mode 100644 index 0000000..7a677a6 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_secret.jpg differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_success.png b/collections/manual/documentation/threefold_token/storing_tft/img/solar_success.png new file mode 100644 index 0000000..57eb039 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_success.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_tft.png b/collections/manual/documentation/threefold_token/storing_tft/img/solar_tft.png new file mode 100644 index 0000000..b94af2a Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_tft.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_tftinfo.png b/collections/manual/documentation/threefold_token/storing_tft/img/solar_tftinfo.png new file mode 100644 index 0000000..a5df0f1 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_tftinfo.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_verify.png b/collections/manual/documentation/threefold_token/storing_tft/img/solar_verify.png new file mode 100644 index 0000000..39a462e Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_verify.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/solar_xlm.jpg b/collections/manual/documentation/threefold_token/storing_tft/img/solar_xlm.jpg new file mode 100644 index 0000000..75612ea Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/solar_xlm.jpg differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/threefold_trustwallet_overview.jpg b/collections/manual/documentation/threefold_token/storing_tft/img/threefold_trustwallet_overview.jpg new file mode 100644 index 0000000..e8e84e4 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/threefold_trustwallet_overview.jpg differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/threefold_trustwallet_tft_added.jpg b/collections/manual/documentation/threefold_token/storing_tft/img/threefold_trustwallet_tft_added.jpg new file mode 100644 index 0000000..23cc0a3 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/threefold_trustwallet_tft_added.jpg differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/threefold_trustwallet_tft_config.jpg b/collections/manual/documentation/threefold_token/storing_tft/img/threefold_trustwallet_tft_config.jpg new file mode 100644 index 0000000..a62a447 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/threefold_trustwallet_tft_config.jpg differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/threefold_xlm_solar_tft_manual_image_19.jpg b/collections/manual/documentation/threefold_token/storing_tft/img/threefold_xlm_solar_tft_manual_image_19.jpg new file mode 100644 index 0000000..7a677a6 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/threefold_xlm_solar_tft_manual_image_19.jpg differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/trust_backup.png b/collections/manual/documentation/threefold_token/storing_tft/img/trust_backup.png new file mode 100644 index 0000000..8d2d170 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/trust_backup.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/trust_create.png b/collections/manual/documentation/threefold_token/storing_tft/img/trust_create.png new file mode 100644 index 0000000..f98174a Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/trust_create.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/trust_created.png b/collections/manual/documentation/threefold_token/storing_tft/img/trust_created.png new file mode 100644 index 0000000..f1a9fc5 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/trust_created.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/trust_notfound.jpg b/collections/manual/documentation/threefold_token/storing_tft/img/trust_notfound.jpg new file mode 100644 index 0000000..fe46b8b Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/trust_notfound.jpg differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/trust_notfound.png b/collections/manual/documentation/threefold_token/storing_tft/img/trust_notfound.png new file mode 100644 index 0000000..c70f2af Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/trust_notfound.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/trust_recover.png b/collections/manual/documentation/threefold_token/storing_tft/img/trust_recover.png new file mode 100644 index 0000000..7b4a869 Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/trust_recover.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/img/trust_verify.png b/collections/manual/documentation/threefold_token/storing_tft/img/trust_verify.png new file mode 100644 index 0000000..5600e1a Binary files /dev/null and b/collections/manual/documentation/threefold_token/storing_tft/img/trust_verify.png differ diff --git a/collections/manual/documentation/threefold_token/storing_tft/interstellar_store.md b/collections/manual/documentation/threefold_token/storing_tft/interstellar_store.md new file mode 100644 index 0000000..3c85bd5 --- /dev/null +++ b/collections/manual/documentation/threefold_token/storing_tft/interstellar_store.md @@ -0,0 +1,116 @@ +

Interstellar (TFT-Stellar)

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Get Started](#get-started) + - [Create a New Interstellar account](#create-a-new-interstellar-account) + - [Create a New Wallet](#create-a-new-wallet) + - [Adding TFT as an Asset](#adding-tft-as-an-asset) +- [Purchase TFT on Interstellar](#purchase-tft-on-interstellar) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +Welcome to our guide on how to store TFT tokens (Stellar) via the [**Interstellar**](https://interstellar.exchange/)! + +Interstellar is a decentralized exchange built on the Stellar network that enables users to trade various assets, including TFT (Stellar). As an intuitive and user-friendly platform, Interstellar provides a seamless trading experience for Stellar users. With its focus on security and privacy, Interstellar ensures that users maintain control over their funds and private keys. + +In this guide, we will walk you through the process of buying TFT on the Interstellar exchange, allowing you to participate in the vibrant Stellar ecosystem. + +> If you are looking for ways to get / purchase TFT (Stellar) on Interstellar by trading, you will find the according information [here](../buy_sell_tft/interstellar.md). + +## Prerequisites + +- **XLM**: To get TFT tokens using Interstellar, a certain amount of XLM funding is required to facilitate the sending and receiving of assets on the Stellar network. + +If you already have some XLMs stored in another Stellar wallet or exchange, you could simply withdraw them to your new Interstellar account after you complete the signup process (we will explain how to do it later on). If not, there are multiple ways to acquire XLM and send it to your wallet. One option is to utilize XLM-supported exchanges, which provide a convenient platform for purchasing XLM. Click [**here**](https://www.coinlore.com/coin/stellar/exchanges) to access a comprehensive list of exchanges that support XLM. + +As an example, we have created a tutorial specifically focusing on how to buy XLM on Coinbase, one of the popular cryptocurrency exchanges. This tutorial provides step-by-step instructions on the process of purchasing XLM on **Coinbase Exchange**. You can find the tutorial [**here**](../buy_sell_tft/coinbase_xlm.md). + + +## Get Started + +### Create a New Interstellar account + +For this guide, we will focus on creating the desktop version of Interstellar account. Go to [https://interstellar.exchange/](https://interstellar.exchange/) from your desktop and click the '**Login/signup**' button. + +![](img/inter_login.png) + +after selecting the preferred language and theme (dark/light) by following the login dialogue, you will be redirected to Interstellar homepage. Click '**Enter Account**' to start the signup process. + +![](img/inter_home.png) + +Create a new password for your new Interstellar account, and click '**Login**' + +![](img/inter_pass.png) + +### Create a New Wallet + +You are now redirected to your new Interstellar wallet homepage. You can either generate a new wallet randomly, or creating a new custom wallet. On this case, we will generate a new wallet randomly by clicking '**Generate Random Wallet**' button. + +![](img/inter_home1.png) + +Write down your Secret Key, which is needed to recover access to your account in case of a password loss or if your phone is lost or stolen. The word order is very important. + +Note: It is essential to save your secret key securely during the process of creating a new account or importing an existing one. The secret key is a critical component that grants access to your wallet and funds. Make sure to store it in a safe and offline location, such as a password manager or a physical backup, to prevent unauthorized access. Do not share your secret key with anyone and exercise caution to protect your assets. + +Tick all the boxes and click '**Go to Account**' to proceed. + +![](img/inter_key.png) + +Congratulations! You have successfully created a new Interstellar wallet. + +![](img/inter_success.png) + +you will have to send funds (digital currencies that run on the Stellar Blockchain only) to one of the wallets attached to your account. + +We have funded our wallet with $408 or 10.000 XLMs for this manual as you can see these are now shown in the account overview. + +![](img/inter_funded.png) + +This step is obligatory because you will need to pay some XLM in order to start adding TFT asset to your wallet in the following tutorial below. + +### Adding TFT as an Asset + +To store and trade TFT in your Interstellar wallet, we will need to have a TFT wallet added into our account. This is done by adding TFT Asset. This will allow you to view your TFT balance, send and receive TFT tokens, and engage in trading activities involving TFT within the Solar wallet. + +To add the TFT (ThreeFold Token) asset to your Solar Wallet account, follow these steps: + +Click on '**Add Token**' button on your wallet homepage. + +![](img/inter_success.png) + +At the pop-up 'Select Asset; window, and click on All (unverified) option. From there you can search for **TFT** and it will show TFT and Click on the TFT icon. + +**IMPORTANT**: It is important to ensure that you also see the name "**threefold.io**" next to the logo , as this verifies that you are selecting the genuine TFT asset associated with ThreeFold. **Beware of imposters or fraudulent assets that may attempt to mimic TFT.** ThreeFold cannot assume responsibility for any errors or mistakes made during the trustline creation process done by users. If you have any uncertainties or doubts, it is always recommended to seek assistance from official support channels or trusted sources to ensure the accuracy of the trustline configuration. + +![](img/inter_popup.png) + + +Click '**Trust Asset**' once you have confirmed that the TFT asset you're adding is the official one from https://threefold.io. Remember that you have to firstly fund your wallet with some XLM, otherwise, this step won't be done successfully. + + +![](img/INTER_TFT.png) + +Congratulations! TFT asset has been successfully added to your account. + +![](img/inter_ok.png) + +You can now store TFT into your Interstellar account by clicking on the TFT Asset icon, and clicking 'Receive' to deposit some TFT from another wallet to your TFT Asset wallet. + +![](img/inter_deposit.png) + +## Purchase TFT on Interstellar + +If you are looking for ways to get / purchase TFT (Stellar) on Interstellar by trading, you will find the according information [here](../buy_sell_tft/interstellar.md). + +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. + diff --git a/collections/manual/documentation/threefold_token/storing_tft/lobstr_wallet.md b/collections/manual/documentation/threefold_token/storing_tft/lobstr_wallet.md new file mode 100644 index 0000000..f43f174 --- /dev/null +++ b/collections/manual/documentation/threefold_token/storing_tft/lobstr_wallet.md @@ -0,0 +1,103 @@ +

Lobstr Wallet

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Get Started](#get-started) + - [Create a New Lobstr Wallet](#create-a-new-lobstr-wallet) + - [Fund XLM to Wallet](#fund-xlm-to-wallet) + - [Adding TFT Asset to Lobstr Wallet](#adding-tft-asset-to-lobstr-wallet) +- [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +Welcome to our guide on how to store TFT tokens (Stellar) via the [**Lobstr Wallet**](https://lobstr.co/)! + +Lobster Wallet is a secure and user-friendly wallet designed specifically for the Stellar blockchain. It allows you to store, manage, and transact with your Stellar-based assets, including TFT (ThreeFold Token). In this tutorial, we will guide you through the process of setting up Lobster Wallet and storing your TFT (Stellar) tokens. By following the steps outlined in this guide, you will be able to access and manage your TFT assets with ease and confidence using the Lobster Wallet platform. + +## Prerequisites + +- **XLM**: When storing TFT tokens using Lobstr wallet, a certain amount of XLM funding is required to facilitate the sending and receiving of assets on the Stellar network. + +If you already have some XLMs stored in another Stellar wallet or exchange, you could simply withdraw them to your new Lobstr wallet account after you complete the signup process. If not, there are multiple ways to acquire XLM and send it to your wallet. One option is to utilize XLM-supported exchanges, which provide a convenient platform for purchasing XLM. Click [**here**](https://www.coinlore.com/coin/stellar/exchanges) to access a comprehensive list of exchanges that support XLM. + +You could also purchase some XLMs directly inside yor new Lobstr wallet account by using Fiat currency payment like credit and debit cards. + +## Get Started + +### Create a New Lobstr Wallet + +For this guide, we will focus on creating the mobile app version of Lobstr Wallet. Go to [https://lobstr.co/](https://lobstr.co/) from your mobile app and download the Lobstr Wallet App to your mobile phone. + +![](./img/lobstr_download.png) + +You can also create and use the web version of Lobstr wallet by signing up on the official website at [hhttps://lobstr.co/](https://lobstr.co/). Go to [Lobstr's knowledge base](https://lobstr.freshdesk.com/support/solutions/articles/151000001052-how-to-create-an-account-in-lobstr-) for the web sign up tutorial. + +Insert your email address and choose a strong and unique password. + +![](./img/lobstr_pass.png) + +Verify your account by clicking on the '**Verify Email**' button in the message sent to your email address. + +![](./img/lobstr_verify.png) + +Press the '**Create Wallet**' button if you'd like to create a new Stellar wallet. + +![](./img/lobstr_new.png) + +Write down your Recovery Phrase, which is needed to recover access to your account in case of a password loss or if your phone is lost or stolen. The word order is very important. + +Note: It is essential to save your secret key securely during the process of creating a new account or importing an existing one. The secret key is a critical component that grants access to your wallet and funds. Make sure to store it in a safe and offline location, such as a password manager or a physical backup, to prevent unauthorized access. Do not share your secret key with anyone and exercise caution to protect your assets. + +![](./img/lobstr_key.png) + +(Optional) Set a federation address, which is the unique name of your new Stellar wallet that can be shared with others to receive funds and click '**Save**'. + +![](./img/lobstr_fed.png) + +Congratulations! You just created a new Lobstr wallet account. + +### Fund XLM to Wallet + +To initiate the process of storing TFT in Solar, the first step is to fund your wallet with XLM (Stellar Lumens). Transfer at least 1 XLM to your wallet to activate it. + +To purchase Stellar lumens with Lobstr using credit / debit card, you can use the ‘[**Buy Lumens**](https://lobstr.co/buy-xlm/)’ option on the LOBSTR web and mobile apps. + +Note: Services relating to credit card payments are provided by[Moonpay](https://www.moonpay.com/), which is a separate platform owned by a third party. Click [here](https://lobstr.freshdesk.com/support/solutions/articles/151000001053-buying-crypto-with-lobstr-wallet) to read the full tutorial. + +Once XLM is successfuly sent, it will appear on your Lobstr wallet homepage. + +### Adding TFT Asset to Lobstr Wallet + +To store TFT in your Lobstr Wallet, we will need to have a TFT wallet added into our account. This is done by adding TFT Asset. This will allow you to view your TFT balance, send and receive TFT tokens, and engage in trading activities involving TFT within the Solar wallet. + +To add the TFT (ThreeFold Token) asset to your Solar Wallet account, follow these steps: + +Open the "Assets" screen from the left side menu + +![](./img/lobstr_assets.png) + +Use the search at the top of the "Assets" screen. From there you can search for TFT and it will show TFT and Click on Add button. + +**IMPORTANT**: It is important to ensure that you also see the name "**threefold.io**" next to the logo , as this verifies that you are selecting the genuine TFT asset associated with ThreeFold. **Beware of imposters or fraudulent assets that may attempt to mimic TFT.** ThreeFold cannot assume responsibility for any errors or mistakes made during the trustline creation process done by users. If you have any uncertainties or doubts, it is always recommended to seek assistance from official support channels or trusted sources to ensure the accuracy of the trustline configuration. + +![](./img/lobstr_asset.jpeg) + +Congratulations! TFT asset has been successfully added to your Lobstr Wallet account. If you've performed the steps above correctly and there are no assets displayed, contact [Lobstr support](https://lobstr.freshdesk.com/support/tickets/new) with the details and the home domain of the asset. + +You can now store TFT by depositing it from another wallet on your TFT Asset page. + +## Important Notice + +If you are looking for ways to get / purchase TFT (Stellar) on Lobstr Wallet by trading or swapping, you will find the according information [here](../buy_sell_tft/tft_lobstr/tft_lobstr_complete_guide.md). + + +## 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](../../../knowledge_base/legal/disclaimer.md) and seek advice from a qualified financial professional if needed. diff --git a/collections/manual/documentation/threefold_token/storing_tft/metamask.md b/collections/manual/documentation/threefold_token/storing_tft/metamask.md new file mode 100644 index 0000000..a70c8d6 --- /dev/null +++ b/collections/manual/documentation/threefold_token/storing_tft/metamask.md @@ -0,0 +1,142 @@ +

MetaMask Wallet

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [TFT Addresses](#tft-addresses) + - [Ethereum Chain Address](#ethereum-chain-address) + - [BSC Address](#bsc-address) +- [Get Started](#get-started) + - [Install \& Create Metamask Account](#install--create-metamask-account) + - [Configure a BSC Wallet (Mainnet) for your TFT](#configure-a-bsc-wallet-mainnet-for-your-tft) + - [Switch Network from ETH to BSC (Auto Add)](#switch-network-from-eth-to-bsc-auto-add) + - [Add TFT Asset to BSC Wallet (Mainnet)](#add-tft-asset-to-bsc-wallet-mainnet) +- [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) + +*** + +## Introduction + +[MetaMask](https://metamask.io/) is a popular browser extension wallet that allows users to interact with various blockchain networks, including BSC and the Ethereum networks. By following the steps outlined in this guide, you'll be able to configure your MetaMask wallet to support TFT tokens on BSC and seamlessly participate in the TFT ecosystem. So let's dive in and explore how to set up TFT on MetaMask with Binance Smart Chain. + +## TFT Addresses + +With MetaMask, you can store TFT on both Binance Smart Chain and the Ethereum chain. Make sure to use the correct TFT address when doing transactions. + +### Ethereum Chain Address + +The ThreeFold Token (TFT) is available on Ethereum. +It is implemented as a wrapped asset with the following token address: + +``` +0x395E925834996e558bdeC77CD648435d620AfB5b +``` + +### BSC Address + +The ThreeFold Token (TFT) is available on BSC. +It is implemented as a wrapped asset with the following token address: + +``` +0x8f0FB159380176D324542b3a7933F0C2Fd0c2bbf +``` + +## Get Started + +We present the steps on BSC. Make sure to switch to Ethereum and to use the TFT Ethereum address if you want to proceed on Ethereum. + +### Install & Create Metamask Account + +Go to the [Metamask website](https://metamask.io/) to download and install the Metamask extension for your browser. Follow [this tutorial](https://support.metamask.io/hc/en-us/articles/360015489531-Getting-started-with-MetaMask) to install metamask to your preferred browser and create. + +Once you’ve installed MetaMask, you’ll see the small fox icon at the top right of your screen, and a notification will appear, letting you know that the install was successful. + +![](./img/metamask_installed.png) + +**Create a Metamask account** + +![](./img/metamask_new.png) + +Assuming you are a new user, click the “**Create a Wallet**” button on the right to get started with a new wallet. + +![](./img/metamask_pass.png) + +This is your password for access to your wallet on your local device. As with all online accounts, you should ensure that you are using a strong password. On the next page, you’ll be given a set of 12 words that act as your **private key**. + +![](./img/metamask_privatekey.png) + +You can think of these words as your master key to all your digital assets. If you have lost or forgotten your password, you can use this set of 12 words to restore your wallet on any device. However, if anyone were to gain access to these 12 words, they could do the same. + +This passphrase is very important, so be sure to keep it safe. Once you have written them down, you can click the “Next” button. Then, just to make sure that you have written them down, MetaMask asks you to confirm your secret recovery phrase by selecting the words in the order they were originally given. You must write down your 12 words in the correct order. + +Once you’ve entered those words, you can click “Continue.” Then, you’re done! It’s that easy. + +### Configure a BSC Wallet (Mainnet) for your TFT + +MetaMask supports various wallet networks, including Ethereum, Binance Smart Chain (BSC), and more. By adding the BSC network, you can seamlessly manage and transact with BSC-based assets like TFT tokens directly within your MetaMask wallet. + + To configure a BSC wallet on MetaMask, you can add the BSC network by specifying the network details such as the chain ID, RPC URL, and symbol. + +### Switch Network from ETH to BSC (Auto Add) + +You might notice straight away that we’re still dealing with an Ethereum wallet. But we want to have a Wallet on BSC Network. To add a new network, click it to access a drop-down menu and hit the "**Add Network**” tab to proceed to the next step. + +![](./img/metamask_add.png) + +You can add BNB Smart Chain from the list of popular networks by clicking "Add", and approving the request once it pops up. + +![](./img/metamask_choose.png) + +After it's added. you will realize that your mainnet network has turned into “**Smart Chain**.” If you wish to change back to the Ethereum network, simply press on the “Smart Chain” menu on the top. + +![](./img/metamask_switch.png) + + +### Add TFT Asset to BSC Wallet (Mainnet) + +Now that you have successfully created a BSC Wallet, we will need to add TFT onto your BSC Wallet. + +To add, go to your 'assets' page and click on '**Import Tokens**' at the bottom of the page. + +![](./img/metamask_import.png) + +You can add TFT onto your wallet by either automatically adding it by typing '**TFT ON BSC (TFT)**' on '**search**' page, + +![](./img/metamask_tft_auto.png) + +or by going to '**custom token**' page and entering TFT details manually. Make sure you enter the right details below to add TFT to your wallet successfully: + +- **Token Contract Address**: ```0x8f0fb159380176d324542b3a7933f0c2fd0c2bbf``` + +Metamask will add the rest of the details, once added, click 'Add custom token'. + +![](./img/metamask_custom.png) + +After the click, you will be asked by Metamask to confirm the token import. Click '**Import Tokens**'. + +![](./img/metamask_confirm.png) + +Congratulations, you have successfully added TFT to your BSC Wallet on Metamask. + +![](./img/metamask_tft.png) + +You should be seeing TFT listed on your Wallet homepage's 'Assets' section. Now that we've successfully listed TFT, we can go ahead and do TFT transactions via Metamask. + +![](./img/metamask_tft_home.png) + +## Important Notice + +To deposit TFT tokens to your MetaMask BSC wallet, **you can only initiate a transfer or swap from any other wallet or exchange platform that operates on the Binance Smart Chain (BSC) network.** Ensure that the platform you are using is on BSC to avoid the risk of losing tokens. + +For example, you cannot transfer TFT tokens directly from the TFConnect app to MetaMask, because TFT tokens on TFT Connect operate on the Stellar network, while TFT on MetaMask lives on Binance Smart Chain (BSC) Network. + +But don't worry! You can still swap your Stellar TFT into BSC TFT and vice versa by bridging them using our [TFT BSC Bridge](https://bridge.bsc.threefold.io/). See tutorial [here](../tft_bridges/bsc_stellar_bridge.md). + +You can also buy TFTs on BSC-supported exchangers like [Pancake Swap](https://pancakeswap.finance/). See tutorial [here](../buy_sell_tft/pancakeswap.md) + +## 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](../../../knowledge_base/legal/disclaimer.md) and seek advice from a qualified financial professional if needed. diff --git a/collections/manual/documentation/threefold_token/storing_tft/solar_wallet.md b/collections/manual/documentation/threefold_token/storing_tft/solar_wallet.md new file mode 100644 index 0000000..3cd8d62 --- /dev/null +++ b/collections/manual/documentation/threefold_token/storing_tft/solar_wallet.md @@ -0,0 +1,122 @@ +

Solar Wallet (TFT-Stellar)

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Prerequisites](#prerequisites) +- [Get Started](#get-started) + - [Create a New Solar Wallet](#create-a-new-solar-wallet) + - [Fund XLM to New Wallet](#fund-xlm-to-new-wallet) + - [Adding TFT Asset to Solar Wallet](#adding-tft-asset-to-solar-wallet) +- [Storing / Receiving and Sending TFT](#storing--receiving-and-sending-tft) +- [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) +*** +## Introduction + +Welcome to our guide on how to store TFT tokens (Stellar) via the [**Solar Wallet**](https://solarwallet.io/)! + +**Solar Wallet** is a user-friendly wallet designed for storing and managing Stellar-based assets like the ThreeFold Token (TFT). It provides a secure way to store your TFT tokens and access them conveniently. With Solar Wallet, you have full control over your assets and can interact with various Stellar services and decentralized applications. Solar Wallet is available as a web-based wallet and also offers mobile versions for iOS and Android devices. This guide will explain how to store TFT (Stellar) on Solar Wallet, including setup, adding tokens, and important security tips. +*** +## Prerequisites + +- **XLM**: When storing TFT tokens using the Solar wallet, a certain amount of XLM funding is required to facilitate the sending and receiving of assets on the Stellar network. + +There are multiple ways to acquire XLM and send it to your wallet. One option is to utilize XLM-supported exchanges, which provide a convenient platform for purchasing XLM. Click [**here**](https://www.coinlore.com/coin/stellar/exchanges) to access a comprehensive list of exchanges that support XLM. + +As an example, we have created a tutorial specifically focusing on how to buy XLM on Coinbase, one of the popular cryptocurrency exchanges. This tutorial provides step-by-step instructions on the process of purchasing XLM on **Coinbase Exchange**. You can find the tutorial [**here**](../buy_sell_tft/coinbase_xlm.md). +*** +## Get Started + +### Create a New Solar Wallet + +For this guide, we will focus on using the desktop wallet version of Solar Wallet for MacOS. You can download the appropriate version for your operating system by visiting the official website at [https://solarwallet.io/](https://solarwallet.io/) and clicking '**Get Wallet Now**'. + +![](img/solar_home.png) + +![](img/solar_desktop.jpeg) + +Note: It is essential to save your secret key securely during the process of creating a new account or importing an existing one. The secret key is a critical component that grants access to your wallet and funds. Make sure to store it in a safe and offline location, such as a password manager or a physical backup, to prevent unauthorized access. Do not share your secret key with anyone and exercise caution to protect your assets. + +![](img/solar_secret.jpeg) + +After the download is finished, locate the downloaded file on your computer and double-click on it to initiate the installation process. Follow the on-screen instructions to install Solar Wallet on your macOS device. This may involve dragging the application to your Applications folder or following prompts from the installation wizard. + +![](img/solar_install.png) + +Once downloaded, open your Solar wallet and congratulations! You just created a new Solar wallet account. + +![](img/solar_home.jpeg) + +### Fund XLM to New Wallet + +To initiate the process of storing TFT in Solar, the first step is to fund your wallet with XLM (Stellar Lumens). By funding your wallet with XLM, you will have the necessary cryptocurrency to cover future transaction fees and engage in token transaction activities on Solar Wallet. Follow these steps: + +On the Solar Wallet homepage, click on the '**Receive**' button. This will provide you with a wallet address to receive XLM. + +![](img/solar_receive.jpeg) + +Copy the generated wallet address or use the provided QR code to receive XLM from your preferred source. You can use an external exchange, another wallet, or any platform that supports XLM transfers. + +![](img/solar_copy.jpeg) + +Send the desired amount of XLM to the generated wallet address. Ensure that you are sending XLM from a compatible source, and double-check the address to prevent any errors. Wait for the XLM transaction to be confirmed on the Stellar network. This typically takes a few moments, but it may vary depending on network congestion. + +Once XLM is successfuly sent, it will appear on your Solar homepage. + +![](img/solar_xlm.jpeg) + +### Adding TFT Asset to Solar Wallet + +To store TFT in our Solar Wallet, we will need to have a TFT wallet added into our account. This is done by adding TFT Asset. This will allow you to view your TFT balance, send and receive TFT tokens, and engage in trading activities involving TFT within the Solar wallet. + +To add the TFT (ThreeFold Token) asset to your Solar Wallet account, follow these steps: + +Click on the top-right menu icon in your Solar Wallet interface. This will open a dropdown menu with various options. From the dropdown menu, select "**Assets & Balances.**" This will navigate you to the Assets & Balances section of your wallet. + +![](img/solar_asset.png) + +In the Assets & Balances section, click on the "**+ Add Asset To Your Account" button**. This will allow you to add a new asset to your wallet. + +![](img/solar_account.png) + +A search box will appear. Type "**TFT**" in the search box to find the ThreeFold Token asset. Click on the search result as shown below. + +![](img/solar_search.png) + +**IMPORTANT**: It is important to ensure that you also see the name "**threefold.io**" next to the logo , as this verifies that you are selecting the genuine TFT asset associated with ThreeFold. **Beware of imposters or fraudulent assets that may attempt to mimic TFT.** ThreeFold cannot assume responsibility for any errors or mistakes made during the trustline creation process done by users. If you have any uncertainties or doubts, it is always recommended to seek assistance from official support channels or trusted sources to ensure the accuracy of the trustline configuration. + +Once you see the TFT asset, click on the "**Add Asset To Account**" button. Please note that adding the asset will require a small amount of XLM to set up a trustline for the TFT asset. + +![](img/solar_tftinfo.png) + +Confirm Adding TFT Asset to your wallet. + +![](img/solar_confirm.png) + +After confirming the transaction, wait until the process is successful. + +![](img/solar_success.png) + +the TFT icon will now be displayed in your wallet overview. + +![](img/solar_tft.png) + +Congratulations! TFT asset has been successfully added to your Solar Wallet account. +*** +## Storing / Receiving and Sending TFT + +You can now store TFT by depositing it from another wallet by clicking '**Receive**' on your TFT Asset page, and copying your public TFT Solar wallet address and sending it to the withdrawer. + +You can also transfer TFT to another stellar wallet by clicking the '**Send**' icon on your wallet navbar and following further instructions. +*** +## Important Notice + +If you are looking for ways to get / purchase TFT (Stellar) on Solar Wallet, you will find the according information [here](../buy_sell_tft/solar_buy.md). +*** +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. + diff --git a/collections/manual/documentation/threefold_token/storing_tft/storing_tft.md b/collections/manual/documentation/threefold_token/storing_tft/storing_tft.md new file mode 100644 index 0000000..7d05dd6 --- /dev/null +++ b/collections/manual/documentation/threefold_token/storing_tft/storing_tft.md @@ -0,0 +1,16 @@ +

Storing TFT

+ +In this section, we present different ways to store ThreeFold tokens. + +The simplest way is to use the ThreeFold Connect app to store your TFT. You can also use a hardware wallet for additional security. + +There are various options available to store TFTs, each with its own benefits and considerations. When it comes to storing TFTs (ThreeFold Tokens), users have the flexibility to choose between different wallet options depending on the blockchain platform on which the tokens are issued. + +If TFTs are issued on the Stellar blockchain, users can opt to store them in Stellar-compatible wallets. On the other hand, if TFTs are bridged and swapped from Stellar to the Binance Smart Chain (BSC) or Ethereum Network, users can utilize BSC-compatible and ETH-compatible wallets to store their tokens. + +

Table of Contents

+ +- [ThreeFold Connect App (Stellar)](./tf_connect_app.md) +- [Lobstr Wallet (Stellar)](./lobstr_wallet.md) +- [MetaMask (BSC & ETH)](./metamask.md) +- [Hardware Wallet](./hardware_wallet.md) \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/storing_tft/tf_connect_app.md b/collections/manual/documentation/threefold_token/storing_tft/tf_connect_app.md new file mode 100644 index 0000000..03bcdda --- /dev/null +++ b/collections/manual/documentation/threefold_token/storing_tft/tf_connect_app.md @@ -0,0 +1,312 @@ +

ThreeFold Connect App Wallet

+ +

Table of Contents

+ +- [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) +- [Connect to the Planetary Network](#connect-to-the-planetary-network) +- [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 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 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 important. 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 on 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 changing 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) + +## Connect to the Planetary Network + +To connect to the Planetary Network, click on the Planetary Network on the TF menu as shown below. + +![farming_tf_wallet_30](./img/farming_tf_wallet_30.png) + +Connecting to the Planetary Network couldn't be easier. Simply click on the connection button and you will see *Connected* on the screen once the connection is settled. + +![farming_tf_wallet_31](./img/farming_tf_wallet_31.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. You will need to use the old version of the Dashboard for this ([https://old.dashboard.grid.tf](https://old.dashboard.grid.tf)). + +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 browser with your polkadot.js extension. For more information on this, check the section [Creating a Polkadot.js account](#1-creating-a-polkadotjs-account). + +On your browser, click on the extension button (in green). + +![farming_tf_wallet_48](./img/farming_tf_wallet_48.png) + +Select the polkadot{.js} extension. + +![farming_tf_wallet_49](./img/farming_tf_wallet_49.png) + +Click on the *plus* button as shown in green. + +![farming_tf_wallet_50](./img/farming_tf_wallet_50.png) + +Choose the option *Import account from pre-existing seed*. + +![farming_tf_wallet_51](./img/farming_tf_wallet_51.png) + +In the box *EXISTING 12 OR 24-WORD MNEMONIC SEED*, paste the TF Chain Secret. Note that this Secret is a HEX version of your seed phrase. + +![farming_tf_wallet_52](./img/farming_tf_wallet_52.png) + +Choose a name for your account. Choose a password. + +![farming_tf_wallet_53](./img/farming_tf_wallet_53.png) + +When you go on the [ThreeFold Dashboard](https://old.dashboard.grid.tf), you will now see your newly added account. Click on it. + +![farming_tf_wallet_54](./img/farming_tf_wallet_54.png) + +In the Farm section, you can now see your farm. You have successfully move the farm from the ThreeFold Connect app to the ThreeFold Dashboard. + +![farming_tf_wallet_55](./img/farming_tf_wallet_55.png) + +You can see here that the farming reward address is the same as before. + +![farming_tf_wallet_56](./img/farming_tf_wallet_56.png) + +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](./hardware_wallet.md). + +## 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](../../../knowledge_base/legal/disclaimer.md) and seek advice from a qualified financial professional if needed. diff --git a/collections/manual/documentation/threefold_token/storing_tft/trustwallet.md b/collections/manual/documentation/threefold_token/storing_tft/trustwallet.md new file mode 100644 index 0000000..bbd044d --- /dev/null +++ b/collections/manual/documentation/threefold_token/storing_tft/trustwallet.md @@ -0,0 +1,84 @@ +

Store TFT-BSC on Trust Wallet (BSC)

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [How to Store TFT on Trust Wallet (BSC)](#how-to-store-tft-on-trust-wallet-bsc) + - [Download and Create a Trust Wallet Account](#download-and-create-a-trust-wallet-account) + - [Add TFT to Trust Wallet](#add-tft-to-trust-wallet) +- [Important Notice](#important-notice) +- [Disclaimer](#disclaimer) +*** +## Introduction + +[Trust Wallet](https://trustwallet.com/) is a widely used, free, and non-custodial mobile wallet designed for storing cryptocurrencies and non-fungible tokens (NFTs). It operates as a hot wallet, meaning it is connected directly to the internet, and is available on both iOS and Android devices. Since its acquisition by Binance in 2018, Trust Wallet has become Binance's official decentralized wallet. It supports a vast array of digital assets, with over 4.5 million supported, and is compatible with more than 65 blockchains. Trusted by millions of users, Trust Wallet stands out for its seamless integration with platforms on the Binance Smart Chain (BEP-20), including popular ones like PancakeSwap. +*** +## How to Store TFT on Trust Wallet (BSC) + +### Download and Create a Trust Wallet Account + +Once you have downloaded the app (iOS / Android) via [https://trustwallet.com/](https://trustwallet.com/), Select “Create a new wallet” and press “Continue” to accept the terms. Get a pencil and paper ready because the warning Trust Wallet gives you is real: If you lose your recovery words (sometimes also known as a seed phrase or recovery phrase) you may lose access to your wallet and the crypto within it forever. + +![](./img/trust_create.png) + +A new screen will appear, prompting you to write down your recovery phrase. It is important you manually write it down and keep it in a safe, private place. Keeping the words in digital form is less secure and not recommended. + +![](./img/trust_backup.png) + +The recovery phase for Trust Wallet consists of 12 words. These words will be used in case you lose access to your wallet – and they are the only way to regain access to the wallet. So we’ll say it again: Keep them in a safe, private place. + +![](./img/trust_recover.png) + +To verify that you backed up your recovery phrases, Trust Wallet will prompt you to write them in sequential order as you’ve received them. + +![](./img/trust_verify.png) + +You will get a screen stating, “Your wallet was successfully created.” + +![](./img/trust_created.png) + +### Add TFT to Trust Wallet + +To add TFT to your Trust Wallet, you need to configure it manually as a 'custom token'. In Trust Wallet, a custom token refers to a token that is not natively supported or pre-listed on the wallet's default token list. + +In the 'Tokens' page, click on the 'settings' icon on the upper right corner to start adding a custom token. + +![](./img/threefold__trustwallet_overview.jpg) + +Search for TFT, and you will see a “No Asset Found” message with a Add Custom Token button. Click on the 'Add Custom Token' button. You will be directed to the Custom Token page. + +![](./img/trust_notfound.png) + +On the Custom Token page, configure TFT in the wallet by completing following info : + +Network: Smart Chain +**Contract Address: 0x8f0FB159380176D324542b3a7933F0C2Fd0c2bbf** +Name: TFT +Symbol: TFT +Decimals: 7 + +![](./img/threefold__trustwallet_tft_config.jpg) + +Once this configuration is done, your TFT wallet is ready. + +![](./img/threefold__trustwallet_tft_added.jpg) +*** +## Important Notice + +To deposit TFT tokens to your Trust BSC wallet, **you can only initiate a transfer or swap from any other wallet or exchange platform that operates on the Binance Smart Chain (BSC) network.** Ensure that the platform you are using is on BSC to avoid the risk of losing tokens. + +For example, you cannot transfer TFT tokens directly from the TFConnect app to MetaMask, because TFT on TFT Connect Wallet operate on the Stellar network, while TFT on MetaMask lives on Binance Smart Chain (BSC) Network. + +But don't worry! You can still swap your Stellar TFT into BSC TFT and vice versa by bridging them using our [Stellar-BSC Bridge](https://bridge.bsc.threefold.io/). See tutorial [here](../tft_bridges/bsc_stellar_bridge.md). + +You can also buy and swap TFTs on BSC-supported exchangers by connecting your Trust Wallet to platforms like [Pancake Swap](https://pancakeswap.finance/). See the tutorial [here](../buy_sell_tft/pancakeswap.md) +*** +## 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](https://library.threefold.me/info/legal/#/legal__disclaimer) and seek advice from a qualified financial professional if needed. + + + + diff --git a/collections/manual/documentation/threefold_token/tft_bridges/bsc_stellar_bridge.md b/collections/manual/documentation/threefold_token/tft_bridges/bsc_stellar_bridge.md new file mode 100644 index 0000000..88f5152 --- /dev/null +++ b/collections/manual/documentation/threefold_token/tft_bridges/bsc_stellar_bridge.md @@ -0,0 +1,116 @@ +

BSC-Stellar Bridge

+ +

Table of Contents

+ +- [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/). diff --git a/collections/manual/documentation/threefold_token/tft_bridges/bsc_stellar_bridge_verification.md b/collections/manual/documentation/threefold_token/tft_bridges/bsc_stellar_bridge_verification.md new file mode 100644 index 0000000..92948a3 --- /dev/null +++ b/collections/manual/documentation/threefold_token/tft_bridges/bsc_stellar_bridge_verification.md @@ -0,0 +1,98 @@ +

BSC-Stellar Bridge Verification

+ +

Table of Contents

+ +- [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: + +![](./img/bsc_stellar_picture_1.png) + +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): + +![](./img/bsc_stellar_picture_2.png) + +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**: + +![](./img/bsc_stellar_picture_3.png) + +Then on the row **Mint** events, click on the icon aligned with the **Event Count** column: + +![](./img/bsc_stellar_picture_4.png) + +We then arrive at [this page](https://explorer.bitquery.io/bsc/txs/events?contract=0x8f0fb159380176d324542b3a7933f0c2fd0c2bbf&event=85a66b9141978db9980f7e0ce3b468cebf4f7999f32b23091c5c03e798b1ba7a): + +![](./img/bsc_stellar_picture_5.png) + +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: + +![](./img/bsc_stellar_picture_6.png) + +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: + +![](./img/bsc_stellar_picture_7.png) + +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⁷): + +![](./img/bsc_stellar_picture_8.png) + +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: + +![](./img/BSC%20to%20Stellar1.jpeg) + +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: + +![](./img/BSC%20to%20Stellar2.png) + +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: + +![](./img/BSC%20to%20Stellar3.png) + +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): + +![](./img/BSC%20to%20Stellar4.png) + +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. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_1.png b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_1.png new file mode 100644 index 0000000..a429ecd Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_1.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_2.png b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_2.png new file mode 100644 index 0000000..3594fd2 Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_2.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_3.png b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_3.png new file mode 100644 index 0000000..4034630 Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_3.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_4.png b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_4.png new file mode 100644 index 0000000..e0b9e59 Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_4.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_5.png b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_5.png new file mode 100644 index 0000000..19706aa Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_5.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_6.png b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_6.png new file mode 100644 index 0000000..3400567 Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_6.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_7.png b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_7.png new file mode 100644 index 0000000..b53b23f Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_7.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_8.png b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_8.png new file mode 100644 index 0000000..b0297fe Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_stellar_picture_8.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_to_stellar1.jpg b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_to_stellar1.jpg new file mode 100644 index 0000000..4a8d7ab Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_to_stellar1.jpg differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_to_stellar2.png b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_to_stellar2.png new file mode 100644 index 0000000..fe848ed Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_to_stellar2.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_to_stellar3.png b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_to_stellar3.png new file mode 100644 index 0000000..ab0c2c3 Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_to_stellar3.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_to_stellar4.png b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_to_stellar4.png new file mode 100644 index 0000000..7720da1 Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/img/bsc_to_stellar4.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/img/tft_bridges_diagram.png b/collections/manual/documentation/threefold_token/tft_bridges/img/tft_bridges_diagram.png new file mode 100644 index 0000000..b2d666f Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/img/tft_bridges_diagram.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/tfchain_stellar_bridge.md b/collections/manual/documentation/threefold_token/tft_bridges/tfchain_stellar_bridge.md new file mode 100644 index 0000000..a09fd29 --- /dev/null +++ b/collections/manual/documentation/threefold_token/tft_bridges/tfchain_stellar_bridge.md @@ -0,0 +1,43 @@ +

TFChain-Stellar Bridges: Main Net and Test Net

+ +

Table of Contents

+ +- [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/). + diff --git a/collections/manual/documentation/threefold_token/tft_bridges/tft_bridges.md b/collections/manual/documentation/threefold_token/tft_bridges/tft_bridges.md new file mode 100644 index 0000000..509c380 --- /dev/null +++ b/collections/manual/documentation/threefold_token/tft_bridges/tft_bridges.md @@ -0,0 +1,69 @@ +

TFT Bridges

+ +

Table of Contents

+ +- [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. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_1.png b/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_1.png new file mode 100644 index 0000000..0db09d3 Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_1.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_2.png b/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_2.png new file mode 100644 index 0000000..b7b21f2 Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_2.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_3.png b/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_3.png new file mode 100644 index 0000000..85b01b2 Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_3.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_4.png b/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_4.png new file mode 100644 index 0000000..753c0dd Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_4.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_5.png b/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_5.png new file mode 100644 index 0000000..073a4a7 Binary files /dev/null and b/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/img/tft_on_ethereum_image_5.png differ diff --git a/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/tft_ethereum.md b/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/tft_ethereum.md new file mode 100644 index 0000000..def5d6a --- /dev/null +++ b/collections/manual/documentation/threefold_token/tft_bridges/tft_ethereum/tft_ethereum.md @@ -0,0 +1,36 @@ +

Ethereum-Stellar Bridge

+ +

Table of Contents

+ +- [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/). \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/tft_intro.md b/collections/manual/documentation/threefold_token/tft_intro.md new file mode 100644 index 0000000..2472a94 --- /dev/null +++ b/collections/manual/documentation/threefold_token/tft_intro.md @@ -0,0 +1,13 @@ +# An Introduction to the ThreeFold Token (TFT) + +ThreeFold tokens, or TFTs, are exclusively generated when new capacity is added to the TF Grid. There are no centralized issuers. Tokens have not been created out of thin air. + +While the ThreeFold Grid can expand, a maximum of 4 Billion TFTs can ever be in circulation. This limit ensures stability of value and incentivization for all stakeholders. + +TFT lives on the Stellar Blockchain. TFT holders benefit from a big ecosystem of proven wallets and mediums of exchange. + +By employing Stellar technology, TFT transactions and smart contracts are powered by one of the most energy-efficient blockchains available. Furthermore, TFT is the medium of exchange on the greenest internet network in the world. The market for farming, cultivating and trading TFT is open to all. + +Anyone with internet connection, power supply and necessary hardware can become a Farmer or trade ThreeFold tokens (TFT). + +By farming, buying, holding, and utilizing ThreeFold Tokens, you are actively supporting the expansion of the ThreeFold Grid and its use cases — creating a more sustainable, fair, and equally accessible Internet. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/threefold_token.md b/collections/manual/documentation/threefold_token/threefold_token.md new file mode 100644 index 0000000..de0079f --- /dev/null +++ b/collections/manual/documentation/threefold_token/threefold_token.md @@ -0,0 +1,95 @@ +

ThreeFold Token

+ +

Table of Contents

+ +- [Introduction to TFT](#introduction-to-tft) +- [Chains with TFT](#chains-with-tft) +- [TFT Contract Addresses on Chains](#tft-contract-addresses-on-chains) +- [Bridges Between Chains](#bridges-between-chains) +- [Storing TFT](#storing-tft) +- [Buy and Sell TFT](#buy-and-sell-tft) +- [Liquidity Provider (LP)](#liquidity-provider-lp) +- [Transaction Fees](#transaction-fees) +- [Deploy on the TFGrid with TFT](#deploy-on-the-tfgrid-with-tft) +- [Disclaimer](#disclaimer) + +*** + +## Introduction to TFT + +The ThreeFold Token (TFT) is a decentralized digital currency used to buy autonomous and decentralized Internet services (compute, storage, and application) on the ThreeFold Grid. + +ThreeFold Tokens are generated through a process called “Farming”. Farming happens when active internet capacity is added to the ThreeFold Grid. Independent farmers earn ThreeFold Tokens (TFT) by providing neutral and decentralized internet capacity, thus expending the usable TF Grid. Therefore no central entity controls the internet. + +> [Get an overview of the ThreeFold token](../../knowledge_base/about/token_overview/token_overview.md) + +## Chains with TFT + +TFT lives on 4 different chains: TFChain, Stellar chain, Ethereum chain and Binance Smart Chain. + +- TFT are minted on the Stellar chain. +- TFT are used to deploy workloads on TFChain. +- TFT can be transacted on Ethereum chain, Binance Smart Chain and Stellar chain. + +## TFT Contract Addresses on Chains + +The TFT contract address on different chains are the following: + +- [TFT Contract address on Stellar](https://stellarchain.io/assets/TFT-GBOVQKJYHXRR3DX6NOX2RRYFRCUMSADGDESTDNBDS6CDVLGVESRTAC47) + - ``` + TFT-GBOVQKJYHXRR3DX6NOX2RRYFRCUMSADGDESTDNBDS6CDVLGVESRTAC47 + ``` +- [TFT Contract address on Ethereum](https://etherscan.io/token/0x395E925834996e558bdeC77CD648435d620AfB5b) + - ``` + 0x395E925834996e558bdeC77CD648435d620AfB5b + ``` +- [TFT Contract address on BSC](https://bscscan.com/address/0x8f0FB159380176D324542b3a7933F0C2Fd0c2bbf) + - ``` + 0x8f0FB159380176D324542b3a7933F0C2Fd0c2bbf + ``` + +## Bridges Between Chains + +[Bridges](./tft_bridges/tft_bridges.md) are available to easily navigate between the chains. + +- [TFChain-Stellar Bridge](./tft_bridges/tfchain_stellar_bridge.html) +- [BSC-Stellar Bridge](./tft_bridges/bsc_stellar_bridge.html) +- [Ethereum-Stellar Bridge](./tft_bridges/tft_ethereum/tft_ethereum.html) + +## Storing TFT + +There are many ways to store TFT. The [TF Connect app wallet](./storing_tft/tf_connect_app.md) and a [hardwallet wallet](./storing_tft/hardware_wallet.md) are two of the many possibilities. + +> [Easily Store TFT](./storing_tft/storing_tft.md) + +## Buy and Sell TFT + +You can [buy and sell TFT](./buy_sell_tft/buy_sell_tft.md) with cryptocurrencies on Stellar Chain, Ethereum Chain and BNB Smart Chain. + +Using Lobstr is very effective to buy TFT with fiat or crypto in no time: + +> [Get TFT: Quick Guide](./buy_sell_tft/tft_lobstr/tft_lobstr_short_guide.md) + +## Liquidity Provider (LP) + +A liquidity provider (LP) is an individual or entity that contributes liquidity to a decentralized exchange or automated market maker (AMM) platform + +> [Become a Liquidity Provider](./liquidity/liquidity_readme.md) + +## Transaction Fees + +Each time transactions are done on chains, transaction fees apply. + +> Learn about [Transaction Fees](./transaction_fees.md) + +## Deploy on the TFGrid with TFT + +You can do almost anything on the TFGrid: as long as you're doing Linux stuff, ZOS got your back! + +> [Get Started on the TFGrid](../system_administrators/getstarted/tfgrid3_getstarted.md) + +## 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](../../knowledge_base/legal/disclaimer.md) and seek advice from a qualified financial professional if needed. \ No newline at end of file diff --git a/collections/manual/documentation/threefold_token/transaction_fees.md b/collections/manual/documentation/threefold_token/transaction_fees.md new file mode 100644 index 0000000..0684559 --- /dev/null +++ b/collections/manual/documentation/threefold_token/transaction_fees.md @@ -0,0 +1,56 @@ +

TFT Transaction Fees

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Bridge Fees](#bridge-fees) +- [Chain Fees](#chain-fees) +- [Notes](#notes) + +*** + +## Introduction + +Here are the TFT transaction fees. Note that these values can be subject to change. We will do our best to update this section of the manual as needed. + +## Bridge Fees + +The following are the fees for each type of bridge transfer. + +- BSC-Stellar bridge + - From Stellar to BSC + - 100 TFT + - From BSC to Stellar + - 1 TFT +- Eth-Stellar bridge + - From Stellar to Eth + - 2000 TFT + - From Eth to Stellar + - 1 TFT +- TFChain-Stellar bridge + - From Stellar to TFChain + - 1 TFT + - From TFChain to Stellar + - 1 TFT + +## Chain Fees + +The following are the transaction fees for each chain. Every time a transaction is done on a given chain, there are fees for the operation on chain. + +- Stellar chain + - 0.01 TFT +- TFChain + - 0.001 TFT +- Ethereum chain + - Fees are the gas price + - Consult the Ethereum official documentation for more details +- BSC + - Fees are the gas price + - Consult the BSC official documentation for more details + +## Notes + +Here are some notes to take into account when doing TFT transfers: + +* The fees paid directly by the users will be shown in the user's wallet at transaction time, not on the bridge page. +* The bridge fees can vary based on current on-chain gas prices. The current fee will always be shown on the bridge page before a transaction is initiated. \ No newline at end of file