AI Copilot & Points
Embedded AI assistant and on-chain points system — contextual help for holders, partners, and developers, plus fee discounts earned through real usage.
1. IFR AI Copilot
The IFR AI Copilot is an embedded AI assistant available on the Inferno website. It provides contextual, role-aware guidance to every user type — from first-time token holders to integration developers. The copilot is powered by Claude Haiku 4.5 and answers exclusively from the curated IFR_KNOWLEDGE base.
The copilot appears as a floating widget in the bottom-right corner of every page. It understands the Inferno protocol, token mechanics, lock system, governance, and partner integrations — and adapts its responses based on the selected mode.
Always available: The AI Copilot widget is embedded on every page of the Inferno website and documentation wiki. Click the button in the bottom-right corner to open it.
2. Three Modes
The copilot operates in three distinct modes, each tailored to a specific audience. Users can switch modes at any time within the chat interface.
| Mode | Audience | Focus Areas |
|---|---|---|
| Customer | IFR Holders | Wallet setup, locking IFR, tier benefits, unlock process, fee mechanics |
| Partner | Businesses | Benefits Network onboarding, QR-flow integration, Docker deployment, PartnerVault |
| Developer | Developers | SDK usage, ethers.js / wagmi integration, Python examples, PartnerVault contract API |
Example: A holder in Customer mode asking "How do I lock my tokens?" gets a step-by-step wallet guide. A developer asking the same question in Developer mode gets the IFRLock.lock() function signature, ABI snippet, and ethers.js example code.
3. Safety Rules
The AI Copilot enforces strict safety rules to protect users from phishing, social engineering, and misinformation:
- Never asks for seed phrase or private key — under no circumstances will the copilot request sensitive credentials
- Seed phrase warning — if a user mentions or pastes anything resembling a seed phrase, the copilot immediately displays a warning and refuses to process it
- Source citation — every answer includes a
Source: ...reference pointing to the specific documentation page or contract - Knowledge-bound — the copilot only answers from
IFR_KNOWLEDGE; it will not hallucinate information about features, prices, or timelines that are not in the knowledge base - No financial advice — the copilot does not provide price predictions, investment advice, or trading recommendations
Security: The copilot runs in a sandboxed iframe with no access to the user's wallet, private keys, or browser storage. It is a read-only assistant that cannot initiate transactions.
4. Points System (IFR Points)
IFR Points are earned through real on-chain actions, not through chatting with the copilot. Points track genuine protocol engagement and unlock fee discounts when thresholds are reached.
Earning Points
Each qualifying action earns a fixed number of points, subject to daily limits to prevent abuse:
| Action | Points | Daily Limit |
|---|---|---|
wallet_connect |
10 | 1 |
guide_wallet_setup |
20 | 1 |
guide_add_token |
20 | 1 |
guide_lock |
30 | 1 |
partner_onboarding |
50 | 1 |
Discount Voucher
When a wallet accumulates 100 points, a Discount Voucher is automatically issued:
- Discount: 15 bps (0.15%) reduction on the IFR Protocol Fee
- Validity: 7 days from issuance
- Usage: Single use — consumed on the next qualifying transaction
Example: A user connects their wallet (10 pts), completes wallet setup (20 pts), adds the IFR token (20 pts), locks IFR (30 pts), and completes partner onboarding (50 pts) = 130 points. They receive a Discount Voucher after reaching 100 points.
5. Fee Discount (FeeRouter)
The Discount Voucher applies only to the IFR Protocol Fee. It does not affect Uniswap trading fees, gas costs, or the burn mechanism.
| Parameter | Value | Notes |
|---|---|---|
| Default Protocol Fee | 5 bps (0.05%) | Applied on FeeRouter transactions |
| Voucher Discount | up to 15 bps | Fee drops to 0 when discount exceeds fee |
| Hard Cap (MAX_PROTOCOL_FEE) | 25 bps (0.25%) | Enforced in contract — cannot be exceeded even via governance |
Important: The Protocol Fee (FeeRouter) is separate from the InfernoToken transfer fee (2% sender burn + 0.5% recipient burn + 1% pool fee = 3.5%). The Discount Voucher does not reduce the token transfer fee — only the Protocol Fee charged by the FeeRouter.
6. Important: Points Are Not a Token
IFR Points are an internal tracking mechanism, not a financial instrument. This distinction is critical:
- Not transferable — points are bound to the wallet that earned them and cannot be sent to another address
- No trading value — points cannot be bought, sold, or exchanged on any marketplace or DEX
- No promise of future rewards — points do not represent any claim on future tokens, airdrops, or financial value
- Single purpose — the only utility of points is earning a Discount Voucher on the IFR Protocol Fee
Legal clarity: IFR Points are explicitly not a token, security, or financial product. They are a usage-tracking mechanism that grants a temporary fee discount. No secondary market, no speculative value, no tokenization.
7. Anti-Sybil Protection
The points system implements multiple layers of protection against Sybil attacks and automated farming:
| Mechanism | Rule | Purpose |
|---|---|---|
| Voucher limit | Max 1 voucher per wallet per day | Prevents voucher farming from a single wallet |
| Daily caps | Each event type limited to 1x per day | Prevents repeated action spam |
| Rate limiting | 60 requests per minute per IP | Prevents automated bot flooding |
Combined with the fact that points require real on-chain actions (wallet connection, token locking, partner onboarding), the cost of Sybil attacks is significantly higher than the value of the discount obtained.
Design principle: The points system is intentionally low-value and high-friction for attackers. A 15 bps fee discount on a single transaction is not economically viable to farm at scale, especially when each qualifying action requires on-chain gas costs and real protocol interaction.