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 — powered by Manifest v3 and an event-driven background service worker.

​
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 requires Firefox 128 or later. 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 service worker (Manifest v3) with browser.alarms 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
The service worker is woken by browser.alarms on schedule. Firefox’s implementation respects the alarm interval reliably across Firefox 128+.

​
3. 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

​
4. 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.

​
5. 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.

​
6. 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

Background Service Worker (service-worker.js)
    │
    ├─ browser.alarms.create("checkDeposits", { periodInMinutes: 0.5 })
    ├─ browser.alarms.create("priceAlerts",   { periodInMinutes: 5 })
    │
    └─ browser.alarms.onAlarm.addListener(alarm => {
         if alarm === "checkDeposits":
             ├─ Fetch latest transactions via Yativo API
             ├─ Compare against last-seen IDs in browser.storage.local
             ├─ For each new deposit → browser.notifications.create(...)
             └─ Update stored IDs
         else if alarm === "priceAlerts":
             └─ Fetch SOL/XDC prices from CoinGecko → evaluate thresholds
       })
Notifications require the notifications permission declared in the manifest. Firefox prompts for this on install.

​
Firefox vs Chrome — Key Differences

AspectFirefoxChrome
Manifest versionv3v3
Background processService worker (browser.* namespace)Service worker (chrome.* namespace)
Storage APIbrowser.storage.localchrome.storage.local
Notifications APIbrowser.notificationschrome.notifications
Polling mechanismbrowser.alarmschrome.alarms
Polling reliabilityReliable (alarm-driven)Reliable (alarm-driven)
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 for account data
Price dataPrices for alerts are fetched from the CoinGecko public API (no auth required)
Minimal permissionsstorage, notifications, alarms — 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.