Fortytwo functions as a decentralized network of nodes. Fortytwo App, Fortytwo Container, and Fortytwo CLI applications run the Inference Nodes in this network, while Fortytwo Relay runs the Relay Nodes that aids the connectivity between the Inference Nodes. Participating nodes are identified with Web3 accounts.Main takeaways:
Your node is associated with your Web3 account.
Web3 authorization is required for rewards and reputation distribution across the network.
Your node’s Reputation is tied to your Web3 account.
You remain in full control over your node/wallet at all times. To move your node to another OS or device, simply authorize in the Fortytwo App of your choice on that device with your Web3 account.
You can use your wallet outside the Fortytwo network and control it with Web3 wallet apps, for example Phantom or MetaMask .
For the network to identify your node, have it as an active participant and provide you with rewards, you need to authorize first.We use Web3 accounts for authorization. This way, your node gets its unique ID by which is recognized by the network, it has its own reputation and can acquire rewards while remaining entirely under your control no matter what application or device you are using in the moment.This way, we treat one node as one Web3 account.
You can create a new wallet for your node directly within the Fortytwo App and CLI. You will have full ownership over this wallet, so make sure to save its credentials to retain access to it. This is a major difference from Web 2 accounts, as we will not be able to recover your access should you lose your credentials.
We recommend creating a new wallet for your node if you are new to Web3.
Any existing EVM Web3 wallet is compatible with the Fortytwo network. You can authorize in the Inference or Relay Nodes with an existing account by using your private key or Secret Recovery Phrase.
For example, one Web3 wallet can be simultaneously used on two different machines within different Fortytwo applications (Fortytwo CLI and Fortytwo App for example). However, only one instance of your node will be able to participate in the network. See this section of FAQ for details.
Each node in the Fortytwo network has a unique predetermined name consisting of three words. You can see examples on the leaderboard on Dashboard page.
You can run an unlimited number of nodes as long as it is one node/wallet per one device.
Each different node requires a unique Web3 wallet to avoid ID collisions.
You can install the same node (sign in with the same Web3 account) on multiple devices but can only run one instance of that node at any time. If running several nodes simultaneously under one account, only one node will perform at a time and it can lead to unexpected errors.
As an exception, you can run both Inference and Relay Nodes on the same machine as long as each node uses a unique wallet ID and unique ports.
A Web3 account is a unique identifier that works using blockchain technology, allowing for function and control in a decentralized manner.Since your node account is fundamentally a Web3 account, you need to know its 3 major identifiers:
Public Address
Secret Recovery Phrase
Private Key
Your node’s public address is primarily used for transactions, monitoring via blockchain explorers, determining leaderboard placements.
Fortytwo network requires it to:
Send rewards for participation.
Acknowledge your node’s participation history, reputation, and balance and determine a node’s reliability.
It is safe to share: it functions similarly to bank credentials if anybody wants to send a transaction your way. However, keep in mind that anybody can see the entire history of transactions and earnings related to this wallet.
Nobody can get access to your wallet with just your public address.
Nobody can tie your wallet’s public address to your identity until you acknowledge the ownership publicly. This way, your privacy depends on your own actions.
Your node’s Secret Recovery Phrase is a way to authenticate full access to your wallet. It is commonly a 12 or 24 word sequence.
Fortytwo network requires it as:
One of the two sign in methods for your Web3 account/node. Fortytwo client uses the very first account on this wallet and generates a private key for it. The private key is then used as your node’s signature on the blockchain. Secret Recovery Phrase is never stored or used aftewards.
It can never be exported out of the node applications because Fortytwo never stores is anywhere for security reasons.
Secret Recovery Phrase provides access to a series of accounts that can be created under one wallet. Note, that when you create a new wallet with Fortytwo App or CLI, you create a wallet with one EVM account on it, which is used inside the Fortytwo network. However if you sign into your wallet with a wallet managment app, like Phantom or MetaMask , you can add more accounts to it, be it in Ethereum network or other networks.
Never share it with anybody. Treat it like a password. Keep it written down somewhere offline.
Whoever has access to it has full control over your entire wallet.
If lost, your Secret Recovery Phrase cannot be recovered, not even if you have saved your private key.
It is best to securely keep both Secret Recovery Phrase and private key, as you have more ways to restore access to your assets.
Your node’s private key is another way to authenticate access to a single Web3 account. It is commonly exported and saved as a text file that holds a sequence of symbols similar to your public address.
Fortytwo network requires it as:
One of the two sign in methods for your Web3 account/node. The private key is then used as your node’s signature on the blockchain.
It can be exported out of the node applications.
Private key provides access only to one exact Web3 account. This doesn’t count as an entire wallet, and you will not be able to recover the wallet’s Secret Recovery Phrase with it.
Never share it with anybody. Treat it like a password. Keep it stored on an offline device for recovery purposes. Do not sync this file with cloud storage providers.
If lost, it can only be recovered if you have the Secret Recovery Phrase for the wallet that holds this account in it.
Whoever has access to it has full control over this account.
It is best to securely keep both Secret Recovery Phrase and private key, as you have more ways to restore access to your assets.
You can create a new EVM compatible wallet in any Web3 wallet application that supports Etherium networks, for example Phantom or MetaMask , or conveniently create a new Web3 wallet directly in the Fortytwo CLI or Fortytwo App.
When creating a new Web3 wallet outside of Fortytwo applications, note that only the first account in that wallet will be used at this time.
When starting the Fortytwo App for the first time, you are prompted to either:
Create identity
Recover with recovery phrase
Recover with private key
To create a new account, click on the Create identity button.
2
While Fortytwo is in devnet phase, you will be prompted to enter your activation code to begin your participation. To get one, submit an application to get a chance to join the first wave of node operators: Application Form
Put your activation code into the respective text field. Once it’s validated, click the Create identity button to proceed.
3
Once your identity is successfully created, the App will provide you with your Secret Recovery Phrase.To see the phrase, click the Reveal button. Each word in the phrase is placed in a numbered box → Write it down and keep it secure, as it is used to recover your identity.
4
The App will then ask you to verify that you have written down the Phrase correctly before you move on — enter the words from the Phrase provided previously into the correspondingly numbered boxes.
IMPORTANT: You can only see your Secret Recovery Phrase at this stage. Make sure you wrote it down. It is never shown again or stored anywhere. Fortytwo doesn’t have any information about your Secret Recovery Phrase and will not be able to help you if it is lost.
5
Next, the App will prompt you to export your private key outside of its directory → export it to a secure offline device. Once that is done, final confirmation screen is displayed and the node is ready to run.
6
Never share your Secret Recovery Phrase or private key with anyone.
WALLET CREATION IS CURRENTLY NOT SUPPORTED
1
When starting Fortytwo CLI for the first time, you are prompted to either:
Create a new identity with an activation code,
or
Recover an existing identity with a recovery phrase.
To create a new account, select option #1.
2
While Fortytwo is in devnet phase, you will be prompted to enter your activation code to begin your participation. To get one, submit an application to get a chance to join the first wave of node operators: Application Form
3
Your new account is now created.The following information about your identity is provided in the YOUR NEW IDENTITY CREATED box within the terminal window:
Public address of your node → Manually copy and store it to track your node’s perfomance on Dashboard or other explorers. You can also use it to refill your node’s balance. You can find it in the logs any time you restart your node.
Your Secret Recovery Phrase → Write it down and keep it secure, as it is used to recover your identity.
IMPORTANT: You can only see your Secret Recovery Phrase at this stage. Make sure you wrote it down. It is never shown again or stored anywhere. Fortytwo doesn’t have any information about your Secret Recovery Phrase and will not be able to help you if it is lost.If you skipped this step and forgot to write it down, we highly recommend you create a new account and write down your Secret Recovery Phrase.
Location of your private key on your computer → Go to the defined location and copy the key file to a secure offline device. Do not delete it from this folder as it is required for Fortytwo CLI to function properly.
4
Never share your Secret Recovery Phrase or private key with anyone.
WALLET CREATION IS CURRENTLY NOT SUPPORTED WITH FORTYTWO RELAY
If you want to monitor your node’s perfomance on the Dashboard or other explorers, or simply want to provide somebody with your node’s credentials so that they can send assets your way, you need to know your node’s public address.
Fortytwo App
Fortytwo Container
Fortytwo CLI
Fortytwo Relay
1
Launch the Fortytwo App.
2
Right click on the Fortytwo App icon in the Tray/Menu Bar or in the Dock → Navigate to Account → click Copy Wallet Address.
1
Two options for the first step:
A: Open Docker applicaiton
Look for the inference process that you are running. By default, should be called fortytwo-inference-node-setup.
If you launched in “Multi-node setup on a single machine”, its name will depend on the name of your custom docker-compose.yml.Unwrap it and go to fortytwo-protocol container.
When Capsule launches, fortytwo-protocol begins to post.
B: Export logs
See ‘Quick Start section “Export Logs”’ for more.If your log file is empty, either there is a problem with the launch or protocol has not started yet. Try to export the log a bit later when Capsule has successfully downloaded and launched the AI model.
2
Your public address is written at the beginning of the logs and at every re-connection with the Swarm. Look for the following block of information:
Copy
Check current versionLatest version is vX.XX.XUp to dateUTC 20XX-XX-XX 18:40:27.036628 INFO Fortytwo Protocol Node is starting upUTC 20XX-XX-XX 18:40:27.036656 INFO Fortytwo Protocol Node current version: X.XX.X<...>UTC 20XX-XX-XX 23:32:35.728871 INFO Public key: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"UTC 20XX-XX-XX 23:32:35.729190 INFO Operator Wallet Address: 0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Your wallet address is defined in the Operator Wallet Address: line and begins with 0x.
1
Go through the standard CLI launch procedure, pick your desired model and launch your node.
2
After the Fortytwo logotype appears, look for the following block of information:
Copy
⏃ Starting Protocol...Joining ::||UTC 20XX-XX-XX 23:32:27.344073 INFO Fortytwo Protocol Node is starting upUTC 20XX-XX-XX 23:32:27.344169 INFO Fortytwo Protocol Node current version: X.XX.X<...>UTC 20XX-XX-XX 23:32:35.728871 INFO Public key: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"UTC 20XX-XX-XX 23:32:35.729190 INFO Operator Wallet Address: 0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Your wallet address is defined in the Operator Wallet Address: line and begins with 0x.
1
Open Docker application and see the fortytwo-relay-setup process running.If you unwrap it and go to fortytwo-relay container, you can see the logging of the node running successfully.
2
Your public address is written at the beginning of the logs and at every re-connection with the Swarm. Look for the following block of information:
Copy
UTC 20XX-XX-25 12:25:29.769031 INFO Fortytwo Protocol Relay is starting upUTC 20XX-XX-25 12:25:29.769052 INFO Fortytwo Protocol Relay current version: X.X.XUTC 20XX-XX-25 12:25:29.769118 INFO Public key: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"UTC 20XX-XX-25 12:25:29.769179 INFO Operator Wallet Address: 0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Your wallet address is defined in the Operator Wallet Address: line and begins with 0x.
If you want to move your node to another device, transfer your node identity between appliactions, or want to access your account through third-party Web3 wallets, you will need either your Secret Recovery Phrase or your private key.
If you have lost both the Secret Recovery Phrase and the private key your account can never be restored.
Secret Recovery Phrase
Private Key
Your node’s Secret Recovery Phrase can never be exported or extracted out of the node applications because Fortytwo never stores is anywhere for security reasons.If you have lost it but still have access to your node’s private key, then it we recommended you create another account, write down the Secret Recovery Phrase, save your new private key, and transfer your funds to that account.
It is best to have secure access to both Secret Recovery Phrase and private key as this way you have more methods to restore access to your assets.
Fortytwo App
Fortytwo Container
Fortytwo CLI
Fortytwo Relay
The private key is encrypted and should not be copied from the Finder/Explorer directly. It will appear as broken if you try to use it after copying this way.
1
Launch the Fortytwo App.
2
Press the right mouse button on the Fortytwo App icon on Menu Bar or on the Dock → Navigate to the option Account → Export Private Key.
3
Choose a directory to save the private key file in. Use a secure offline location. Your private key is the text written inside this file.
Do not synchronize this location to cloud storage.
1
Locate your node installation folder.If you have trouble finding it, refer to this FAQ entry.
2
Inside it, find the .env file. Your private key is defined in it.
1
Locate your node installation folder.If you have trouble finding it, refer to this FAQ entry.
2
Inside it, open the FortytwoNode subfolder.
3
Copy the file named .account_private_key.It is a hidden file by default.Platform-specific notes on how to reveal hidden files:
Hidden files and folders (including .account_private_key) will now be visible.
4
Save the .account_private_key to a secure offline location. Your private key is the text written inside this file.
Do not synchronize this location to cloud storage.
Relay Nodes do not support generation of Web3 accounts. Relay Noderunners already know their private keys.
Migrating Your Wallet or Signing In with an Existing Web3 Account
Migrating your account between devices or applications follows the same procedure as signing in with an already existing Web3 account. For that you’ll need your wallet’s Secret Recovery Phrase or your account’s private key.If you are installing a new instance of the Fortytwo node and want to migrate your existing account to retain access to your previous identity and rewards, first you need to either already have access to your Secret Recovery Phrase or your private key since you saved them when creating a new account, or you need to export your credentials first.Authorization options:
Fortytwo App
Fortytwo Container
Fortytwo CLI
Fortytwo Relay
Secret Recovery Phrase
Private Key
1
When starting the Fortytwo App for the first time, you are prompted to either:
Create identity
Recover with recovery phrase
Recover with private key
To recover with a Secret Recovery Phrase, click on the Recover with recovery phrase button.
1
You are now prompted to enter your Secret Recovery Phrase.Type it separating each word with a single space and press Enter.
Currently, the account Fortytwo CLI/Fortytwo App imports when signing in with the Secret Recovery Phrase is the account which is the first by order in the wallet. So, though technically one wallet can have several accounts on it, only the first account is used at all times. Due to this limitation, each unique node requires a unique Web3 wallet.
1
If done correctly, the App should recognize and restore your account.
1
When starting the Fortytwo App for the first time, you are prompted to either:
Create identity
Recover with recovery phrase
Recover with private key
To recover with a private key, click the Recover with private key button.
2
You are now prompted to either drop your private key into the highlighted area or click a button to navigate to the directory where your private key is stored.
If your application has already collapsed into the Menu Bar/System Tray state, it might be challenging to drag and drop your private key onto the app window. To make it easier, right click the application icon → select Open in Window.
Note that the private key file should not have a .txt or a similar text editor file extension. If you are experiencing issues, make sure that your file is named .account_private_key exactly.
3
If done correctly, the App should encrypt and securely store your private key, then recognize and restore your account.
When starting Fortytwo CLI for the first time, you are prompted to either:
Create a new identity with an activation code,
or
Recover an existing identity with a recovery phrase.
To create a new account, select option #2.
1
You are now prompted to enter your Secret Recovery Phrase.Type it separating each word with a single space and press Enter.
Currently, the account Fortytwo CLI/Fortytwo App imports when signing in with the Secret Recovery Phrase is the account which is the first by order in the wallet. So, though technically one wallet can have several accounts on it, only the first account is used at all times. Due to this limitation, each unique node requires a unique Web3 wallet.
1
If done correctly, CLI should recognize and restore your existing account.
1
Locate your private key file. Copy it.
2
Locate your new node installation folder.If you have trouble finding it, refer to this FAQ entry.
3
Inside it, open the FortytwoNode subfolder. Create it if it doesn’t exist.
4
Paste your prive key inside this folder.
5
Rename your file to .account_private_key.
6
Launch Fortytwo CLI. If done correctly, it should recognize the provided identity.
Fortytwo App
Fortytwo Container
Fortytwo CLI
Fortytwo Relay