Skip to main content

​
Firefox Extension

The Yativo Crypto Firefox extension provides the same feature set as the Chrome extension — wallet monitoring, real-time deposit notifications, card management, price alerts, and swap — adapted for Firefox using Manifest v2 and a persistent background script.

​
Installation

  1. Open Firefox Add-ons (AMO) and search for “Yativo Crypto”, or follow the direct link provided in your Yativo dashboard.
  2. Click “Add to Firefox”.
  3. When prompted, click “Add” to grant the requested permissions.
  4. The Yativo icon appears in your Firefox toolbar.
The extension is compatible with Firefox 78+ (ESR and standard releases). It also works in Firefox for Android, though the popup UI is optimised for desktop.

​
Initial Setup

  1. Click the Yativo toolbar icon to open the popup.
  2. On first launch you will see the Setup screen.
  3. Enter your API Key and API Secret from the Yativo dashboard.
  4. Click Save & Connect.
The extension verifies your credentials and switches to the main dashboard view on success.
Create a dedicated, minimal-permission API key for the extension (e.g. wallets:read, transactions:read, cards:read, swap:write) to limit exposure if credentials are ever compromised.

​
Features

​
1. Wallet Monitoring

The Wallets tab in the popup lists all wallets on your account with:
  • Asset type and network
  • Current balance
  • Deposit address (click to copy)
Balances are refreshed on every popup open, or manually via the Refresh button.

​
2. Real-Time Deposit Notifications

The Firefox extension uses a persistent background script (Manifest v2) with setInterval to poll the Yativo API every 30 seconds. When a new deposit is detected:
  1. A browser notification fires with the deposit amount, asset, and destination wallet.
  2. Clicking the notification opens the Yativo popup focused on the relevant wallet.

​
Notification Settings

Open the popup → Settings tab to configure:
SettingDescription
Enable notificationsToggle deposit polling on/off
Poll interval30 seconds (fixed)
Minimum deposit thresholdOnly notify for deposits above a set amount
Sound alertsPlay a chime when a notification fires
Unlike Chrome’s Manifest v3 service worker, the Firefox background script remains persistent as long as the browser is running. This means deposit polling is more reliable in Firefox because the script is never suspended between polls.

​
3. Auto-Forwarding Management

The Auto-Forward tab lets you view, create, and delete auto-forwarding rules:
  1. Click + New Rule.
  2. Select the source wallet.
  3. Enter the destination address.
  4. Set the forwarding percentage (1–100%).
  5. Click Save Rule.
Toggle the switch on any existing rule to enable/disable it, or click Delete to remove it.

​
4. Yativo Card Management

The Cards tab shows your virtual cards. For each card you can:
  • View label, last 4 digits, and expiry
  • Check the card balance
  • See recent card transactions (last 10)
  • Freeze or unfreeze the card
  • Copy the card funding address

​
5. Price Alerts (SOL and XDC)

The Alerts tab lets you set price threshold notifications for SOL and XDC:
  1. Select the asset.
  2. Choose Above or Below.
  3. Enter the USD price target.
  4. Click Set Alert.
Alerts are evaluated on every 30-second poll cycle. When the threshold is crossed, a browser notification fires and the alert is cleared. Multiple alerts per asset are supported.

​
6. Swap Functionality

The Swap tab offers a quick-access swap interface:
  1. Choose the From and To asset.
  2. Enter the amount.
  3. Click Get Quote — the extension fetches a live quote from the Yativo Swap API.
  4. Click Execute to submit the swap.
Swap quotes expire after approximately 30 seconds. Fetch a new quote if the timer runs out before you confirm.

​
7. Standalone IBAN Management

The IBAN tab lists all standalone IBANs on your account:
  • IBAN number (click to copy)
  • BIC/SWIFT code
  • Currency and label

​
How Notifications Work

Persistent Background Script (background.js)
    │
    ├─ setInterval(poll, 30_000)
    │
    └─ Every 30 seconds:
         ├─ Fetch latest deposits via Yativo API
         ├─ Compare against last-seen deposit IDs in browser.storage.local
         ├─ For each new deposit → browser.notifications.create(...)
         └─ Update stored deposit IDs
Manifest v2 vs v3: The Firefox extension uses Manifest v2, which supports a persistent background page/script. This is intentional: Firefox’s implementation of Manifest v3 service workers does not yet match Chrome’s, and using Manifest v2 ensures reliable background polling across all supported Firefox versions.
Notifications require the notifications permission declared in the manifest. Firefox prompts for this on install.

​
Firefox vs Chrome — Key Differences

AspectFirefoxChrome
Manifest versionv2v3
Background processPersistent background scriptService worker (can be suspended)
Storage APIbrowser.storage.localchrome.storage.local
Notifications APIbrowser.notificationschrome.notifications
Polling mechanismsetInterval in background scriptchrome.alarms
Polling reliabilityVery reliable (script always running)May have minor delays if worker sleeps
Installation sourceFirefox Add-ons (AMO)Chrome Web Store
Both extensions share the same feature set and connect to the same Yativo API endpoints.

​
Security

ConcernHow it is handled
Credential storageStored in browser.storage.local — isolated to the extension’s sandbox
Data in transitAll API calls use HTTPS to https://crypto-api.yativo.com/api/
No third partiesThe extension communicates only with crypto-api.yativo.com
Minimal permissionsstorage, notifications — no broad host permissions

​
Troubleshooting

Symptoms: “Invalid credentials” error or the popup spinner never resolves.Steps:
  1. Verify the API key and secret in your Yativo dashboard. Confirm they have not been revoked.
  2. Confirm the API key has at least wallets:read permission.
  3. Open Firefox → about:debugging#/runtime/this-firefox → find the Yativo extension → click Inspect. Check the console for error messages.
  4. Clear the stored credentials: popup → Settings → Clear Credentials, then re-enter them.

​
Updating the Extension

Firefox updates extensions automatically. To force an update:
  1. Open about:addons.
  2. Click the gear icon → Check for Updates.

​
Uninstalling

  1. Open about:addons.
  2. Find Yativo Crypto and click the three-dot menu → Remove.
All locally stored credentials and settings are deleted when the extension is removed.

​
Firefox for Android

The extension is available on Firefox for Android (Fenix). Features work identically, though the popup is displayed as a full-screen panel rather than a small overlay. Notifications use Android’s standard notification system. To install on Firefox for Android:
  1. Open Firefox for Android and navigate to the Firefox Add-ons page.
  2. Search for “Yativo Crypto” and tap Add to Firefox.
  3. Tap the Yativo icon in the toolbar menu to open the extension panel.