Guides & documentation

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.

⚑ Quick guide β€” every page πŸŒ€ Bridging β€” detailed steps πŸ“‘ Promo sync everywhere 🧩 Chrome & Edge extension 🩹 Widget button for apps

⚑ Quick guide β€” every page 3–4 steps each

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.

πŸ” Sign in & Create account

  • Create account: username + strong password (min 10 chars, 3 of: lower/upper/digits/symbols).
  • Your password IS the vault β€” it encrypts every wallet key (Argon2id + AES-256-GCM). It cannot be recovered.
  • Sign in with 2FA code only if you enrolled an authenticator.
  • 5 failed attempts β†’ 15-minute lockout; sessions expire after 7 days.
Open sign in β†’

🏠 Dashboard

  • See your vault: account chip, session lock state, fee banner.
  • Wallet overview: every hot/cold wallet, chains and balances.
  • Jump straight to Swap / Bridge / Meme / NFT from the tiles.
Open dashboard β†’

🧠 AI-NFT Studio featured

  • Mint Solana NFTs with attributes, image upload (catbox) and collections.
  • The AI helper composes metadata; the hot-wallet mint bot batches mints.
  • Browse your portfolio live; mint fee is disclosed in the fee banner.
Open AI-NFT Studio β†’

🎯 Sniper Bot featured

  • The 1ness vault live engine (node service on port 3001, served inside this page).
  • Run/stop the sniper; positions, logs, wallet balance stream over WebSocket.
  • Sells ride the dual-program engine (legacy SPL + Token-2022, derived-ATA probing)
  • The backend reads the key from the vault β€” you never paste it here.
Open Sniper Bot β†’

πŸ‘› Wallet

  • Create or import a Solana / Bitcoin wallet; label it, copy its address, show the QR.
  • Send funds β€” the 0.8% service fee rides atomically in the same transaction.
  • Export the private key only through the password-gated flow (audited, wiped from screen).
  • Cold-vault mode destroys the server-side key β€” view-only until restored.
Open wallet β†’

πŸ” Swap

  • Pick a venue: Raydium, Jupiter, Meteora β€” or β€œbest of the three”.
  • Search any token, set slippage, read the quote breakdown.
  • Execute from your hot wallet; the result panel shows the tx signature.
Open swap β†’

πŸŒ€ Bridge detailed guide below

  • Watch the network state: WBTC mint, escrow, BTC custody, wormhole fee.
  • Verify ANY guardian-signed VAA without logging in β€” quorum math is public.
  • Deposit/withdraw flows are operator-initiated from the admin console.
Open bridge β†’

⚑ Flash Loan

  • Choose the loan pair or let the random-pairs radar hunt spreads for you.
  • Borrow on Solend or Kamino, route through Raydium/Jupiter/Meteora, keep the spread.
  • Every flash loan charges a flat 0.01 SOL, proven on-chain; history is live.
Open flash loan β†’

🐸 Meme Coin launcher

  • Create (0.03 SOL), revoke mint/freeze/update authority (0.01 each).
  • Seed a Raydium CPMM pool, watch the live chart, run volume/market bot sessions (0.3 SOL / 15 min).
  • Build an AI landing page (0.2 SOL) β€” hosted automatically and shown in the Trending carousel.
  • Redeemed a promo code? every platform fee reads 0.
Open launcher β†’

πŸ”₯ Trending

  • Live boosted board: profile, image, description, links, pair stats per token.
  • Promote a profile: 0.5 / 1.0 / 1.5 SOL pin it to the top for 1–3 days.
  • The banner strip + landing-page carousel on this page are the SAME feed the extension and widget show β€” see β€œPromo sync”.
Open trending β†’

πŸ›‘ Security

  • Enroll TOTP; print the single-use recovery codes β€” shown exactly once.
  • Read your audit log (logins, unlocks, exports) and the fee ledger.
  • Fresh password unlock windows guard sends, swaps, exports and backups.
Open security β†’

πŸ’³ On-ramp

  • Buy crypto with a card through Stripe, bound to your address.
  • The session completes with the provider webhook; your balance updates.
Open on-ramp β†’

πŸ”­ Explorer

  • Inspect any Bitcoin address: confirmed balance + history (failover explorers).
  • Check tx status before attesting a deposit on the bridge.
Open explorer β†’

πŸ‘‘ Admin admins only

  • Operator console: users, system state, sessions and maintenance.
  • The link only renders in the bar for the admin role.
Open admin β†’

🩹 Ad banners & promos

  • Promo code β†’ every platform fee on the launcher reads 0 (revokes, pools, volume sessions, landing pages, trending pins, banner ads).
  • Publish a banner: 3 SOL / 7 days (free with a promo) on the Meme page or Trending board.
  • Banners rotate in wall-clock lock-step on every device worldwide.
See the board β†’

πŸ“š This page

  • Bridging walkthrough below β€” both directions, fees, timings, troubleshooting.
  • Extension + widget sections ship the one-line embeds.
Go to the bridge guide ↓

πŸŒ€ Bridging β€” detailed step-by-step guide WBTC ⇄ BTC

How the bridge works (read once, then follow the steps)

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):

β‚ΏDirection 1 β€” BTC β†’ WBTC on Solana

  1. Get the custody address. Open the Bridge page β€” the Network state card shows the live BTC custody address, the WBTC mint and the wormhole fee (lamports).
  2. Send real BTC. From any Bitcoin wallet, transfer the intended amount to the custody address (mainnet). The sat amount you deposit becomes the sat amount minted β€” 1:1.
  3. Wait for confirmations. The deposit must be a confirmed transaction (finality = confirmed) β€” check its status in the Explorer or any block explorer.
  4. Attest the deposit operator β€” in the Operations console paste the 64-hex txid and the vout (usually 0) and press Attest BTC burn. The bridge emits the Wormhole attestation for that exact UTXO (status: attested).
  5. Guardians sign. The VAA appears once quorum is reached β€” minutes, typically.
  6. Settle + verify the VAA operator β€” press Settle + verify VAA with the operation ID. The service verifies the guardian quorum off-chain, then mints WBTC to the Solana recipient (optionally overridden in the settle form) and auto-creates the destination ATA. Status: settled.
  7. Confirm on your side. The wallet page shows WBTC; you can paste the VAA (base64) into the public VAA verifier card to check the quorum math yourself.

β—ŽDirection 2 β€” WBTC β†’ real BTC payout

  1. Where WBTC lives. Bridged WBTC sits in the bridge escrow ATA. A settle-burn releases it β€” the Solana-side burn is the β€œsignal”.
  2. Burn WBTC operator β€” in the Operations console enter the amount in raw satoshis and the BTC payout address (bc1p / bc1q / 3… / 1… are all accepted) and press Initiate SOL burn. One transaction burns the escrow WBTC and emits the Wormhole message.
  3. Guardians sign. Wait for the VAA β€” quorum takes minutes.
  4. Settle + verify the VAA operator β€” with the operation ID. Guardian quorum is verified off-chain, the payload is decoded (asset, amount, payout address), and the service broadcasts a real Bitcoin transaction from custody to the payout address, priced with a live fee recommendation.
  5. Track it. The Bridge ledger lists every operation (# Β· kind Β· status Β· amount Β· created). The settlement result includes the BTC payout txid β€” watch it confirm on any block explorer (1–2 blocks is typical).

β—ˆFees on the bridge

Service fee0.8% (rides in the settlement tx)
Wormhole message feeshown live on the page (lamports)
Bitcoin miner feepayout-sized, live fee-rate feed
Conversion1 sat = 1 sats worth of WBTC (1:1)

Fee destinations are published publicly at /api/fee; every charge is recorded in your fee ledger.

⏱Timelines you should expect

  • BTC deposit: confirmations of the custody chain network (mainnet β€” minutes to ~an hour, provider-dependent).
  • Attestation: immediate after operator attest; VAA quorum typically takes a couple of minutes.
  • Settle: runs as soon as the VAA verifies (seconds).
  • BTC payout: broadcast immediately at settle; confirmed with the next blocks (~10–30 min).

πŸš‘Troubleshooting the bridge

The settle form says the VAA was rejected

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).

An attestation stays β€œpending” for a long time

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.

Payout address errors

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.

WBTC did not arrive after settle

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.

Is the VAA verifier different from settling?

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.

Who can run attest/burn/settle?

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.

≣Cheat sheet β€” bridge API & statuses

GET /api/bridge/infocustody/mint/fee live state
POST /api/bridge/vaa/verifypublic quorum check
POST /api/bridge/btc-burnattest BTC deposit (op)
POST /api/bridge/sol-burnburn WBTC β†’ payout (op)
POST /api/bridge/settleverify VAA β†’ mint/payout (op)
GET /api/bridge/operationsbridge ledger (statuses)

Statuses: pending → attested → settled (sol→btc: pending → burned → settled on the ledger).

πŸ“‘ Promos in sync β€” every wallet, same second one feed

The single promo feed

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.

Why every wallet shows the same banner at the same second

  • The banner slot index is derived from the wall clock: floor(Date.now() / 6000) % banners.length β€” the identical formula in the app, the extension and the widget.
  • Rotation is a boundary-aligned timer re-locked to that clock grid β€” throttled tabs and sleeps never drift.
  • Publish a promo here β†’ every user wallet picks it up on the next poll (the app re-polls up to every 60 s; extension popup + widget the same; the extension background worker prefetches every 15 min so the popup opens already-synced and gets a β€œnew promo” badge dot).

Buying a slot (or redeeming a promo code) requires a signed-in vault; reading the feed needs nothing.

🧩 OneNess for Chrome & Edge MV3 β€” one codebase, both stores

What ships inside

  • Popup: your wallet quick-launch + the live synced banner strip + the top promoted tokens (wall-clock rotation, same as the web).
  • Index page β€” mirrors this app's home, with AI-NFT Studio and Sniper Bot featured front and center.
  • Every page of the vault via the in-extension shell: sign in / create account, dashboard, wallet, swap, bridge, flash loan, meme launcher, trending, AI-NFT, sniper, security, on-ramp, explorer, admin, guides.
  • Always in sync: the shell embeds the live app pages of your configured deployment β€” new features appear without touching the extension.

Install (load "unpacked")

  1. In Chrome: open chrome://extensions. In Edge: open edge://extensions.
  2. Enable Developer mode (top-right toggle).
  3. Click Load unpacked and select the extension/ folder of this repository (the folder containing manifest.json).
  4. Pin OneNess from the toolbar β€” the popup shows the live promo strip. Point the app to your deployment with βš™ if you self-host.

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 OneNess widget β€” a button any app can embed 20+ language versions

One line on any site

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.

OneNess Guides Β· v1.0.0 HomeTrending Widget centerAPI reference