Delegate Management
Delegates are wallets authorized to operate on behalf of a company on FenixTrace. They can register products, notarize labels, and access the dashboard — without ever sharing the main wallet. Essential for automated integrations and secure collaboration.
Delegate Types
Company Delegate
A wallet authorized by the company to register products and notarize labels on-chain. This is the most common delegate type, used for automated integrations (Integration Kit) or to allow collaborators to operate without sharing the main wallet.
PermissionsRegister new products (add_product)
Notarize labels on-chain
Access the company dashboard as delegate
View company products and history
Red Flagger Delegate
A wallet authorized by the Super Admin to create Red Flag reports on products. This delegate type operates within quality governance and has no access to company product management.
PermissionsCreate Red Flag reports on products
Attach documentary evidence via IPFS
Notarize flags on-chain
Access the Red Flagger dashboard
How to Add a Delegate
Generate a Delegate Wallet
Create a new IOTA wallet dedicated to the delegate. Never use the company's main wallet as a delegate — always generate a separate wallet. If using the Integration Kit, generate it with: node generate-wallet.js
Fund the Wallet (Testnet)
The delegate wallet needs IOTA to pay transaction gas fees. On testnet, request free tokens from the faucet. Each product costs about 0.2 IOTA (2 transactions).
Add the Delegate from the Dashboard
Log into the FenixTrace Company Dashboard with the owner wallet. Go to the "Delegate Management" tab, click "Add Delegate", enter the delegate wallet address, and confirm with your wallet signature. The transaction is recorded on-chain.
Verify and Test
After adding, the delegate appears in the dashboard list. Verify the status is "active". The delegate can now operate: register products, notarize labels, or be used in the Integration Kit.
Usage with Integration Kit
The main use case for delegates is the Integration Kit. When configuring the kit, the generated wallet (generate-wallet.js) must be added as a company delegate. This allows the kit to sign add_product transactions on-chain autonomously, without needing the owner wallet.
Frequently Asked Questions
There is no fixed limit on the number of delegates. Each company can add as many delegates as needed. However, it's good practice to keep the minimum number necessary and revoke delegates no longer in use.
No. Delegates can only register products and notarize labels. They cannot modify company settings, add or remove other delegates, or manage the subscription. These operations are reserved for the owner wallet.
From the Company Dashboard → Delegate Management, click the deactivation button next to the delegate. Revocation is immediate and recorded on-chain. The revoked wallet can no longer operate for the company.
Yes. Every transaction signed by the delegate is paid from the delegate wallet's balance, not from the company's. Make sure the delegate wallet has enough IOTA to cover planned operations.
Next Steps
After configuring delegates, you can integrate the system into your workflow. Check the Integration Gateway documentation for CRM and ERP integration.