Skip to main content

Install Ombra Wallet extension

Extensia Chrome/Edge injectează window.ombra în orice pagină — necesar pentru dApp-uri care folosesc OmbraChain.

Status​

  • Chrome/Edge: disponibil (manual install)
  • Firefox: roadmap
  • Brave: funcționează (Chromium-based)

Chrome Web Store: în pending review. Până atunci, install manual din build local sau release.

Install din build local​

Prerequisites​

  • Repo OmbraChain clonat
  • Node 22+, pnpm 9+

Build extension​

cd OmbraBlockChain
pnpm install
pnpm --filter @ombrachain/extension build
# → apps/extension/dist/ cu manifest.json + assets

Load în Chrome​

  1. Deschide chrome://extensions/
  2. Toggle Developer mode (top right)
  3. Click Load unpacked
  4. Navighează la apps/extension/dist/
  5. Select folder

Extensia apare în lista. Pin-o pe toolbar pentru access rapid.

Load în Edge​

  1. edge://extensions/
  2. Toggle Developer mode
  3. Load unpacked → select apps/extension/dist/

Load în Brave​

Identic cu Chrome — brave://extensions/.

Prim setup​

La primul click pe iconița extensiei:

  1. Welcome screen
  2. Alegi:
    • Create new wallet → generează 12-word seed
    • Import existing → paste seed existent
  3. Setează password local (criptează seed în storage)
  4. Confirmă

Extension e ready. window.ombra injectat automat în toate tab-urile noi.

Permissions​

Extensia cere:

  • Storage — pentru seed criptat + settings
  • Active tab — pentru injecție window.ombra
  • Network — comunicare cu mainnet api.ombra-net.com

NU cere:

  • All sites access (doar tab activ când deschizi popup)
  • Browsing history
  • Bookmarks

DApp connection flow​

Când un dApp apelează window.ombra.request({ method: "ombra_connect" }):

  1. Extension popup apare
  2. Afișează: numele site-ului, ce permisiuni cere
  3. User click Connect sau Reject
  4. Dacă connect → site-ul e adăugat în whitelist
  5. Future request-uri de la acel site nu mai cer connect

User poate revoca în Settings → Connected Sites.

Settings​

Extension popup → ⚙ Settings:

SettingDefaultDetalii
NetworkmainnetSwitch la testnet (când disponibil)
Auto-confirm small txOFFTx < 0.1 OMBRA auto-confirm
Notification on txONToast la confirmation
Connected sites(empty)List + revoke
Lock timeout15 minAuto-lock după inactivitate

Lock / Unlock​

Extension se lock-uiește automat după 15 min de inactivitate sau la close browser. Pentru a unlock:

  1. Click iconița extensiei
  2. Introdu password
  3. Decryptează seed pentru sesiunea curentă

DApp-uri primesc disconnect event când extension e locked.

Update​

Pentru a updata la versiunea nouă (build local):

  1. git pull în repo
  2. pnpm --filter @ombrachain/extension build
  3. chrome://extensions/ → click Reload pe Ombra Wallet
  4. Settings/wallet păstrate (storage local persistent)

Multi-account​

Roadmap. Momentan un singur wallet per extensie. Pentru a folosi multiple wallets, instalează multiple Chrome profiles, fiecare cu extension separat.

Debug​

Erori extension:

  1. chrome://extensions/ → Ombra Wallet → Inspect views: service worker
  2. Console-ul background script apare → vezi erori
  3. Pentru popup: click dreapta pe popup → Inspect

Vezi și​