A detailed step-by-step bridging guide, a quick guide for every page, how the promos stay in sync across every user wallet, and how to install the Chrome/Edge extension or embed the widget anywhere.
One card per page of the vault β the same pages you find in the Chrome/Edge extension. Open any with the button on its card.
OneNess bridges value 1:1 between Bitcoin and Wrapped BTC (WBTC) on Solana with a burn-and-mint design signalled by Wormhole guardian signatures (VAAs):
Fee destinations are published publicly at /api/fee; every charge is recorded in your fee ledger.
Guardian VAAs carry a maximum age. If settlement happens too late the signatures no longer count; re-run the attest/settle flow β the operation re-emits and the fresh VAA verifies. Nothing is lost in between: WBTC stays escrowed (or the deposit stays attested).
Check that the BTC txid is 64-hex and the vout index matches the actual output carrying the deposit. The deposit must be CONFIRMED first β pending mempool transactions cannot be attested. The Explorer page shows the live status.
The payout must be a valid Bitcoin address β bc1p (Taproot), bc1q (bech32), 3(P2SH) or 1(legacy). One character off and the decode refuses the operation; nothing was burned in that case.
Open the Bridge ledger and press View on the operation: settlement returns the mint signature. If the recipient ATA had to be created, the rent lands in the same transaction. Refresh the Wallet page; if the VAA verify rejects with an expiry, re-settle.
Yes β the verifier card is public and read-only: paste ANY base64 VAA and it decodes the payload and checks the guardian signatures/quorum without touching funds. Settle consumes an operation and performs the mint/payout.
Bridge mutations are operator-gated (admin role + fresh unlock); this protects the custody keys. Verification is open to everyone. Self-hosters hold the admin login themselves.
Statuses: pending β attested β settled (solβbtc: pending β burned β settled on the ledger).
Every OneNess surface β the trend board, the extension popup + index, the embeddable widget and any third-party app β reads one public feed:
GET /api/promo/feed β
{
"banners": [ β¦active paid banner adsβ¦ ],
"promoted": [ β¦pinned trending profilesβ¦ ],
"tokens": [ β¦top of the boost boardβ¦ ],
"carousel": [ β¦built landing pagesβ¦ ],
"pricing": { β¦current price sheetβ¦ },
"generated_at": 1717400000, "ttl_seconds": 60
}
It is public (nothing in it is user-private), cross-origin open (any app may embed it) and marked Cache-Control: no-store so no CDN, proxy or service worker can ever serve a forked copy.
Live broadcast β surfaces can subscribe instead of polling: GET /api/promo/live streams the same snapshot as server-sent events the moment it changes. The trending board is THE page this broadcast keeps in lockstep across the website, the mobile app and the Chrome/Edge extension.
Buying a slot (or redeeming a promo code) requires a signed-in vault; reading the feed needs nothing.
Store builds: python extension/pack.py β zips under extension/dist/ (Chrome zip + Edge zip). On Windows the installer does the shuffling for you: python extension/pack.py --installer builds 1nessWalletExtension-Setup-2.0.0.exe β it copies the extension into %LOCALAPPDATA%\1nessWalletExtension\Extension, opens chrome://extensions / edge://extensions, registers a Settings βΈ Apps uninstaller and supports --dry-run / --silent / --uninstall. Grab it from the cover page (Windows .exe installer).
The widget renders a floating OneNess button (the ring logo) with the live synced promo feed inside β banners, promoted tokens, landing-page previews β plus quick actions straight into the wallet. Zero dependencies, shadow-DOM isolated, CSP-friendly.
<script defer
src="https://1ness-wallet.onrender.com/widget/oneness-widget.js"
data-base="https://1ness-wallet.onrender.com"></script>
Also shipped as ready-to-paste files in app/static/widget/embeds/: React / Next.js / Vue / Angular / Svelte, Python (Flask Β· Django Β· FastAPI Β· Jinja), PHP & WordPress, Laravel, Ruby on Rails, Java (JSP Β· Thymeleaf), C# ASP.NET Razor, Go, Node/Express, Elixir Phoenix, Clojure, Rust, Shopify Liquid β and native bridges for Flutter / Android / iOS.