{"canonical_url":"https://engineer.company/nb/notes/solana-mobile-wallet-deeplinks/","content_markdown":"# Å åpne en dApp i Solana-lommebøker på mobil\n\n2026-08-10\n\nEn React-dApp bygd på `@solana/wallet-adapter-react` kobler seg til lommebøker\npå datamaskinen uten problemer, men på en telefon faller den samme flyten fra\nhverandre: lommeboken må åpne dApp-en i sin egen innebygde nettleser, og\ndyplenkene som skulle få det til, svikter i det stille. Backpack havner på en\n«last ned appen»-side; Solflare åpner appen, men aldri nettstedet; hver variant\nser ut til å svikte. Vi tok problemet fra hverandre, og det viste seg å være\nfire separate problemer med ett felles symptom.\n\n## De fire problemene\n\n- **Backpack-lenken var feil bygd.** Det eneste dokumenterte formatet er\n  `https://backpack.app/ul/v1/browse/\u003curl\u003e?ref=\u003cref\u003e` — en universell lenke med\n  mål-URL-en i stien og en påkrevd `ref`. Et gjettet eget skjema som\n  `backpack://ul/v1/browse?url=...` treffer ingen rute appen registrerer, så\n  brukeren havner på installasjonssiden til lommeboken.\n- **Solflare trenger også sin universelle lenke:**\n  `https://solflare.com/ul/v1/browse/\u003curl\u003e?ref=\u003cref\u003e`, ikke det nakne\n  `solflare://`-skjemaet. Et nakent skjema kan starte appen uten å rute den\n  videre — og det er nøyaktig «appen åpnes, men fanen med nettstedet må åpnes\n  for hånd».\n- **Begge parameterne må kodes.** `url` er den fullstendige, absolutte adressen\n  til dApp-en, og `ref` er origin for siden som sender forespørselen, begge sendt\n  gjennom `encodeURIComponent`. Et ukodet `?` eller `\u0026` i målet ødelegger\n  tolkningen, og lommeboken åpner på startskjermen sin i stedet for i\n  nettleserfanen.\n- **Utløseren betyr like mye som lenken.** Universelle lenker bytter bare app\n  ved en navigasjon operativsystemet stoler på — og de gjør med vilje ingenting\n  når de limes inn i adressefeltet, som også er måten en helt korrekt lenke\n  «svikter» på under testing.\n\n## De dokumenterte formatene\n\n- Phantom: `https://phantom.app/ul/browse/\u003curl\u003e?ref=\u003cref\u003e` — ingen `/v1` i\n  akkurat denne.\n- Solflare: `https://solflare.com/ul/v1/browse/\u003curl\u003e?ref=\u003cref\u003e`\n- Backpack: `https://backpack.app/ul/v1/browse/\u003curl\u003e?ref=\u003cref\u003e`\n\nEtt mønster dekker alle tre:\n\n```js\nconst WALLET_BROWSE = {\n  phantom: (url, ref) =\u003e\n    `https://phantom.app/ul/browse/${url}?ref=${ref}`,\n  solflare: (url, ref) =\u003e\n    `https://solflare.com/ul/v1/browse/${url}?ref=${ref}`,\n  backpack: (url, ref) =\u003e\n    `https://backpack.app/ul/v1/browse/${url}?ref=${ref}`,\n};\n\nfunction walletBrowseLink(\n  walletName,\n  targetUrl = window.location.href,\n) {\n  const build = WALLET_BROWSE[walletName.toLowerCase()];\n  if (!build) return null;\n  return build(\n    encodeURIComponent(targetUrl),\n    encodeURIComponent(window.location.origin),\n  );\n}\n```\n\n## Utløs lenken slik at iOS og Android godtar den\n\n- **Gjengi et ekte anker, beregnet på forhånd.** Et vanlig\n  `\u003ca href={walletBrowseLink('phantom')}\u003e` er den mest pålitelige utløseren på\n  begge plattformene.\n- **Må det skje programmatisk**, så sett `window.location.href` synkront\n  inne i håndtereren for trykket — ingen `await`, ingen `fetch`, ingen\n  `setTimeout` først. Etter asynkront arbeid er gestkonteksten borte, og iOS\n  faller tilbake til nettstedet til lommeboken. Aldri `window.open`.\n- **Test aldri ved å lime inn i adressefeltet.** Universelle lenker utløses med\n  vilje ikke der; test med en lenke du trykker på, eller en QR-kode som kameraet\n  skanner.\n- **Pass på webvisningene i meldingsapper.** Åpnet i den innebygde nettleseren\n  til Telegram eller Instagram blir universelle lenker ofte slukt, og det vanlige\n  nettstedet til lommeboken lastes i stedet. Gjenkjenning ut fra user agent er i\n  beste fall heuristisk, så gi også brukerne en synlig nødutgang: «åpne i Safari\n  eller Chrome, og koble til etterpå».\n\n## Den større løsningen på Android\n\nHåndlagde dyplenker er iOS-historien. På Android lar Solana Mobiles Mobile\nWallet Adapter en dApp som kjører i mobilnettleseren, koble seg rett til den\ninstallerte lommebokappen, helt uten omveien om en innebygd nettleser. Nyere\nversjoner av `@solana/wallet-adapter-react` registrerer mobiladapteren\nautomatisk, så en oppgradering av wallet-adapter-pakkene kan løse problemet på Android på\negen hånd. Målarkitekturen: Mobile Wallet Adapter på Android, universelle\nbrowse-lenker på iOS, der Apple ikke tillater noe tilsvarende.\n\n## Verifisering på en enhet\n\n1. Ekte enhet, lommebok installert, lenken åpnet fra systemnettleseren — ikke\n   fra en meldingsapp.\n2. Trykk på en gjengitt lenke eller skann en QR-kode; lim aldri inn i\n   adressefeltet.\n3. Bekreft at lommeboken åpnes og at dApp-en lastes i nettleserfanen i appen —\n   den andre halvdelen er den som svikter.\n4. Gjenta uten lommeboken installert: den universelle lenken skal falle tilbake\n   til nettstedet til lommeboken. Dukker den siden opp mens appen er\n   installert, er lenken eller utløseren fortsatt feil.\n5. Test deretter veien via meldingsappen, og legg til «åpne i\n   nettleseren»-hintet hvis den svikter der.\n\n## Kilder\n\n- [Phantom: dyplenker på iOS og Android](https://docs.phantom.com/phantom-deeplinks/deeplinks-ios-and-android)\n- [Solflare: Browse-dyplenken](https://docs.solflare.com/solflare/technical/deeplinks/other-methods/browse)\n- [Backpack: Browse-dyplenken](https://docs.backpack.app/deeplinks/other-methods/browse)\n- [Solana Mobile: Mobile Wallet Adapter](https://docs.solanamobile.com/mobile-wallet-adapter/mobile-apps)\n\n\u003chttps://engineer.company/nb/notes/solana-mobile-wallet-deeplinks/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hvorfor browse-dyplenker til Phantom, Solflare og Backpack svikter på mobil, og de nøyaktige formatene, utløserreglene og rettelsene som får dem til å virke.","formats":{"gemtext":"https://engineer.company/nb/notes/solana-mobile-wallet-deeplinks/index.gmi","gopher":"https://engineer.company/nb/notes/solana-mobile-wallet-deeplinks/gophermap","html":"https://engineer.company/nb/notes/solana-mobile-wallet-deeplinks/","json":"https://engineer.company/nb/notes/solana-mobile-wallet-deeplinks/index.json","markdown":"https://engineer.company/nb/notes/solana-mobile-wallet-deeplinks/index.md","pdf":"https://engineer.company/nb/notes/solana-mobile-wallet-deeplinks/index.pdf"},"kind":"page","language":"nb","title":"Å åpne en dApp i Solana-lommebøker på mobil","url":"https://engineer.company/nb/notes/solana-mobile-wallet-deeplinks/","version":1}