October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk3 min

How to Reuse an Existing TON Connect Instance with Omniston Widget Integrated Mode

Pass your app’s existing initialized TON Connect instance to Omniston in integrated mode. Learn the setup, manifest requirement, mounting steps, and React lifecycle pattern.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

If your app already manages TON Connect, configure the Omniston widget in integrated mode and pass it that same initialized instance. Do not create a second TonConnect object for the widget: STON.fi warns that the TON Connect SDK permits only one instance in an application and that multiple instances can crash it. See the STON.fi widget guide for the documented configuration.

Choose integrated mode when your app already owns wallet state

Omniston documents two connection modes. In standalone mode, the widget initializes TON Connect from a manifest URL. In integrated mode, your application supplies its existing TON Connect instance so the app and widget can share the wallet connection. If your app already has an initialized instance, use integrated mode.

As an Amazon Associate I earn from qualifying purchases.

Mode Who initializes TON Connect? When it fits
standalone The widget, using a manifest URL A simpler site that does not otherwise manage TON Connect
integrated Your application An app that already manages TON Connect and needs the widget to share that connection

Pass the existing instance to the widget

Use the app’s initialized object in the widget configuration. The following pattern follows STON.fi’s documented loader example; in an existing app, replace the example’s tonconnect variable with the instance the app already uses.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
import OmnistonWidgetLoader from '@ston-fi/omniston-widget-loader';

// Reuse the TonConnect instance already initialized by your application.
const existingTonConnect = tonconnect;

const OmnistonWidget = await OmnistonWidgetLoader.load();
const widget = new OmnistonWidget({
  tonconnect: {
    type: 'integrated',
    instance: existingTonConnect,
  },
});

const container = document.querySelector('#omniston-widget-container');
widget.mount(container);

The widget configuration also accepts a TonConnectUI instance from @tonconnect/ui-react. Use the instance type already supplied by your app rather than creating a parallel connection object.

#1 Best Overall
TANGEM Crypto Wallet Pack of 2 – Trusted Cold Storage Hardware Wallet | 100% offline; Bitcoin, Ethereum, NFTs & altcoins; No seed phrase; NFC, Self custody wallet
  • Proven security at scale: Over 9 years and millions of cards issued with no known remote hacks, while military‑grade EAL6+ security keeps your private keys locked inside the chip. Your cryptocurrencies stay strongly protected from online attackers.
  • Tap once to manage your entire crypto wallet across 90 blockchains - no USB cables or Bluetooth, no batteries, no setup. Access 14,100+ coins & tokens, DeFi, NFTs, and staking instantly from your phone
  • Smart backup: Use your second Tangem Wallet as your Backup keys with end‑to‑end encryption; no more papers, pictures. If one card is lost, the remaining can still restore full access, with an optional seed phrase available for advanced users.
  • Engineered to last up to 25 years: Waterproof (IP69K), shockproof and tested for extreme temperatures from −25°C to 50°C. A durable cold wallet with long‑term protection and independently audited security.
  • Trusted by 6 million users worldwide - buy, sell, swap, stake, and spend cryptocurrency directly. The secure offline storage wallet designed for how people actually use crypto wallets

Prepare the package, manifest, and mount point

  1. Add the widget loader. Install @ston-fi/omniston-widget-loader. If the app does not already depend on @tonconnect/sdk, STON.fi’s guide says to install it; otherwise reuse the existing dependency.
  2. Configure the app’s manifest. Create and host a TON Connect manifest for the application, then configure the existing instance or provider with that manifest. STON.fi says the manifest URL must be hosted on the same domain as the application; wallets reject connections when the domains do not match.
  3. Load and construct the widget. Load the widget constructor, then pass the existing instance in tonconnect.instance with type: 'integrated'.
  4. Mount only after the container exists. Ensure the target DOM node is available before calling mount. The guide’s example uses #omniston-widget-container.

The npm loader fetches the widget bundle at runtime. STON.fi also documents a CDN script option; the npm loader is the documented recommendation for bundled applications, while CDN paths are major-versioned, so update the major-version path when adopting a breaking version. The widget loads its styles automatically.

Mount it safely in React

In React, retrieve the TON Connect UI instance from the provider with useTonConnectUI(), load the widget constructor asynchronously, and mount it into a ref-backed container. Unmount the widget during effect cleanup. This keeps the widget aligned with the component lifecycle and passes through the provider’s instance rather than creating another connection.

Rank #2
Sale
TANGEM Crypto Wallet Pack of 3 – Trusted Cold Storage Hardware Wallet | 100% offline; Bitcoin, Ethereum, NFTs & altcoins; No seed phrase; NFC; Pack of 3, Self custody wallet
  • Proven security at scale: Over 9 years and millions of cards issued with no known remote hacks, while military‑grade EAL6+ security keeps your private keys locked inside the chip. Your cryptocurrencies stay strongly protected from online attackers.
  • Tap once to manage your entire crypto wallet across 90 blockchains - no USB cables or Bluetooth, no batteries, no setup. Access 14,100+ coins & tokens, DeFi, NFTs, and staking instantly from your phone
  • Smart backup: Use your second Tangem Wallet as your Backup keys with end‑to‑end encryption; no more papers, pictures. If one card is lost, the remaining can still restore full access, with an optional seed phrase available for advanced users.
  • Engineered to last up to 25 years: Waterproof (IP69K), shockproof and tested for extreme temperatures from −25°C to 50°C. A durable cold wallet with long‑term protection and independently audited security.
  • Trusted by 6 million users worldwide (4.9 App Store, 4.8 Google Play) - buy, sell, swap, stake, and spend cryptocurrency directly. The secure offline storage wallet designed for how people actually use crypto wallets
// Lifecycle outline based on STON.fi's React example:
// 1. Get the existing instance with useTonConnectUI().
// 2. Keep a container ref for the widget.
// 3. Load OmnistonWidgetLoader and construct in integrated mode,
//    passing that instance as tonconnect.instance.
// 4. Mount into the ref after it exists.
// 5. Unmount the widget in cleanup.

Consult the widget guide and React example for the complete framework-specific code. The reviewed documentation does not specify a compatibility matrix for every TON Connect SDK or UI version, so verify the versions used by your project against current package documentation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Optional widget configuration

These options are separate from the connection-mode decision and are not required just to reuse TON Connect:

Best Value
DCENT Hardware Wallet | Biometric Cold Storage, Bluetooth, Multi-Crypto
  • EAL5+ CERTIFIED SECURE ELEMENT + FINGERPRINT PROTECTION — Your private keys stay encrypted offline on a certified EAL5+ chip, the same security tier used in EMV bank cards. Built by DCENT, securing crypto since 2018. Fingerprint authentication adds a second layer no PIN-only wallet can match.
  • 10,000+ ASSETS NATIVE ON 100+ BLOCKCHAINS — Hold Bitcoin, Ethereum, XRP, Solana, Cardano, popular stablecoins (USDT, USDC), and NFTs in one wallet. No third-party apps, no fragmented setup — every supported asset works straight out of the box.
  • TAP-TO-SIGN MOBILE EXPERIENCE — Pair your wallet with the DCENT mobile app over Bluetooth. Manage tokens, review transactions, and access in-app swap features directly from your phone — no cables, no desktop required.
  • WEB3 & dAPP ACCESS VIA METAMASK — Connect to MetaMask and other browser extension wallets to manage NFTs, claim airdrops, and access dApps. A large screen and intuitive 4-button interface keep every transaction clearly visible before you sign.
  • SEAMLESS FIRMWARE UPDATES & 30-DAY MONEY-BACK GUARANTEE — Apply security updates without resetting your wallet or migrating funds. Backed by Amazon's 30-day money-back guarantee — your purchase is risk-free.
Rank #4
DCENT Hardware Wallet 2-Pack | Biometric Cold Storage, Bluetooth, Crypto
  • EAL5+ CERTIFIED SECURE ELEMENT + FINGERPRINT PROTECTION — Your private keys stay encrypted offline on a certified EAL5+ chip, the same security tier used in EMV bank cards. Built by DCENT, securing crypto since 2018. Fingerprint authentication adds a second layer no PIN-only wallet can match.
  • 10,000+ ASSETS NATIVE ON 100+ BLOCKCHAINS — Hold Bitcoin, Ethereum, XRP, Solana, Cardano, popular stablecoins (USDT, USDC), and NFTs in one wallet. No third-party apps, no fragmented setup — every supported asset works straight out of the box.
  • TAP-TO-SIGN MOBILE EXPERIENCE — Pair your wallet with the DCENT mobile app over Bluetooth. Manage tokens, review transactions, and access in-app swap features directly from your phone — no cables, no desktop required.
  • WEB3 & dAPP ACCESS VIA METAMASK — Connect to MetaMask and other browser extension wallets to manage NFTs, claim airdrops, and access dApps. A large screen and intuitive 4-button interface keep every transaction clearly visible before you sign.
  • SEAMLESS FIRMWARE UPDATES & 30-DAY MONEY-BACK GUARANTEE — Apply security updates without resetting your wallet or migrating funds. Backed by Amazon's 30-day money-back guarantee — your purchase is risk-free.
Rank #3
ELLIPAL X Card Crypto Wallet – Cold Wallet for Bitcoin, Ethereum, XRP, NFTs & 10,000+ Tokens – NFC Hardware Wallet for Cold Storage
  • READY IN 3 MINUTES – Set up your ELLIPAL X Card crypto wallet on the offline Starter device, then tap to the ELLIPAL mobile App and start using it. This 100% offline crypto wallet is a no battery crypto wallet with no charging, no firmware updates, and no complicated setup.
  • TURN ANY WALLET INTO A CARD – Already have a wallet? Import your recovery phrase from MetaMask, Trust Wallet, Ledger, Trezor, or any compatible seed phrase wallet. X Card works as a backup wallet and physical twin of your existing bitcoin wallet, ethereum wallet, NFT wallet, or altcoin wallet — no transfers, no new accounts, no starting over.
  • BUILT ON AN EAL6+ SECURE CHIP – Designed as a secure crypto wallet and private key wallet, X Card generates and stores your private keys inside the EAL6+ secure chip. Your keys never reach your phone, the App, USB, Bluetooth, or the internet, making it a true no bluetooth hardware wallet and no USB crypto wallet.
  • ONE APP, EVERYTHING CRYPTO – Manage more with one cold storage wallet. Buy, sell, swap, send, spend, and earn across 45+ blockchains and 10,000+ tokens. Use X Card as your cryptocurrency wallet, coins and tokens wallet, DeFi wallet, and staking wallet for everyday crypto management.
  • TAP TO CRYPTO – Carry your crypto cold wallet on a card and secure every transaction with one NFC tap. ELLIPAL X Card combines the simplicity of a crypto wallet with the protection of a cold storage hardware wallet.
  • defaultBidAsset and defaultAskAsset can identify default assets by ticker or token root address.
  • customAssets accepts token root address strings. defaultAssets controls whether the built-in asset list is retained or replaced; if it is false, provide a non-empty customAssets array or the asset selector will have no tradable assets.
  • referrerAddress and referrerFeeBps are optional referral configuration. STON.fi documents a fee range of 1–100 basis points (0.01%–1%); 50 basis points equals 0.5%. These are configuration values, not evidence of typical or guaranteed earnings.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.