Connect & Get Started
Complete guide to connecting to FenixTrace via the IOTA wallet. Learn how to install the wallet, connect to the dApp, sign transactions, and interact with the IOTA blockchain for product traceability in the supply chain.
Requirements
Compatible Browser
Chrome, Brave, Edge, Opera, or any Chromium-based browser. Firefox and Safari are not currently supported.
IOTA Wallet Extension
The official IOTA Wallet extension, free to download from the Chrome Web Store.
IOTA Tokens
A small amount of IOTA tokens for transaction gas fees (fractions of a cent per transaction).
Internet Connection
A stable internet connection to communicate with the IOTA network and the FenixTrace platform.
Download IOTA Wallet
IOTA Wallet
The official extension developed by the IOTA Foundation. Allows you to manage your IOTA tokens, sign transactions, and connect to dApps like FenixTrace. Free and open-source.
Install from Chrome Web StoreSecurity Notice
ALWAYS download the wallet only from the official Chrome Web Store. Never install wallet extensions from unverified sources. Never share your seed phrase with anyone, including the FenixTrace team. No member of our team will ever ask for your seed phrase.
Step-by-Step Guide
Follow these 5 steps to set up your wallet and connect to FenixTrace. The entire process takes about 5 minutes.
Install IOTA Wallet
Visit the Chrome Web Store and search for "IOTA Wallet" or click the direct link below. Click "Add to Chrome" to install the extension. IOTA Wallet is the official extension developed by the IOTA Foundation to interact with the IOTA network.
Create or Import a Wallet
Open the IOTA Wallet extension by clicking the icon in the browser toolbar. Choose whether to create a new wallet or import an existing one via seed phrase (24 words). If creating a new wallet, SAVE THE SEED PHRASE in a safe place. Without it you cannot recover wallet access.
Select the Correct Network
Make sure you are connected to the correct IOTA network. Open wallet settings (gear icon) and select the network. FenixTrace runs on IOTA Rebased (the new L1 with Move VM) — currently on testnet. If your wallet supports multiple IOTA networks, pick the right one so you do not sign transactions on the wrong network.
Connect Wallet to FenixTrace
Go to FenixTrace and click the "Connect Wallet" button in the top-right navigation bar. An IOTA Wallet popup will open asking you to authorize the connection. Click "Approve" to link your wallet to the dApp. From this moment FenixTrace can read your public address (not private keys).
Start Operating
Once connected, your wallet address will be shown in the navbar. If your address has an active subscription, you will be redirected to the company dashboard. If you are a Super Admin or Red Flagger, you will have access to the respective dashboards. If you don't have a subscription yet, visit the Pricing page to subscribe to a plan.
Wallet Features
Sign Transactions
Every operation that modifies on-chain data (product registration, notarization, flag) requires a wallet signature. The wallet will show you a popup with transaction details before confirming.
Account Management
IOTA Wallet supports multiple accounts. You can have different accounts for different roles (e.g., one for company, one for Red Flagger). Each account has its own address and balance.
Balance View
View your IOTA token balance directly from the wallet. You can see both available tokens and those locked in pending transactions. A small amount of IOTA is needed for transaction gas fees.
Security
Private keys never leave the wallet. FenixTrace communicates with the wallet only through the standard dApp connection API. No sensitive data is ever transmitted to the platform.
Transaction Types
Here are all transactions you may need to sign while using FenixTrace. Each transaction requires your explicit approval through the wallet popup.
| Type | Description | Gas Fee |
|---|---|---|
| Plan Subscription | Payment for the chosen plan on the Pricing page | Low |
| DID Registration | Decentralized identity creation (automatic) | Low |
| DID Notarization | On-chain certification of DID identity | Low |
| Product Registration | Adding a new product with IPFS data | Medium |
| Product Notarization | On-chain certification of the product | Low |
| Red Flag | Reporting a product with irregularities | Low |
Troubleshooting
Wallet won't connect
Verify that the IOTA Wallet extension is installed and active. Try reloading the page (F5) and clicking "Connect Wallet" again. If the problem persists, disable and re-enable the extension from the browser's Extensions menu.
Transaction fails
Make sure you have enough IOTA in your wallet to cover gas fees. Verify you are on the correct network (IOTA Rebased testnet — mainnet coming). If the transaction keeps failing, there might be a temporary network issue: try again after a few minutes.
I can't see my dashboard after connecting
If you don't see the dashboard after connecting, it means your address doesn't have an active subscription. Go to the Pricing page to subscribe to a plan. If you already have a subscription, verify you are using the same wallet address you subscribed with.
I lost my seed phrase
Unfortunately without the seed phrase it's impossible to recover wallet access. You'll need to create a new wallet and, if you had an active subscription, contact FenixTrace support for the migration procedure to a new address.
The signing popup doesn't appear
Some browsers block popups by default. Check in your browser settings that popups from FenixTrace are allowed. Alternatively, look for the wallet icon in the browser toolbar: it might have a pending notification that needs attention.
Frequently Asked Questions
No. FenixTrace signs transactions through @iota/dapp-kit and the IOTA Wallet Standard: the app talks to compatible extensions such as IOTA Wallet or Firefly. MetaMask is an EVM wallet, is not exposed through the IOTA Wallet Standard, and cannot sign Move calls on Rebased.
Transactions on IOTA Rebased have a gas cost in the order of fractions of a cent. Upgrading the Move package (a rare admin action) costs a few tenths of an IOTA; add_product, notarization::record and did_registry::register cost much less, which keeps operating on FenixTrace sustainable for small businesses.
Absolutely not. FenixTrace never has access to your private keys. Every transaction requires your explicit approval through the wallet popup. The platform can only read your public address to verify your identity and subscription.
Yes, you can import the same wallet on multiple devices using the seed phrase. However, we recommend doing so with caution: every device where you import the seed phrase is a potential vulnerability point. Always use secure and updated devices.
Click on your wallet address in the top-right navbar, then click "Disconnect" in the dropdown menu. You can also disconnect from the IOTA Wallet extension settings, in the "Connected Sites" section.
Quick Links
Ready to Get Started?
Install the IOTA wallet, connect to FenixTrace and start tracking your products on the blockchain in minutes.