本文へ移動
Engineer
メニュー
デザイン
日本語

Engineer / ブログ

Solanaのモバイルウォレット内でdAppを開く

Phantom、Solflare、Backpackの閲覧用ディープリンクがモバイルで失敗する理由と、正しい形式、起動条件、修正方法を説明します。

@solana/wallet-adapter-reactで構築したReactのdAppは、パソコンのウォレットには問題なく接続します。しかしスマートフォンでは、同じ手順がうまくいきません。ウォレット内のブラウザーでdAppを開く必要があるのに、それを行うはずのディープリンクが、何も言わず失敗します。Backpackでは「アプリをダウンロード」のページになり、Solflareではアプリは開いてもサイトが開きません。どの変形も失敗するように見えました。問題を分解すると、一つの症状に見える、四つの別々の問題でした。

四つの問題

  • Backpackのリンク形式が誤っていました。 文書にある形式はhttps://backpack.app/ul/v1/browse/<url>?ref=<ref>だけです。対象URLをパスに置き、refを必須とするユニバーサルリンクです。推測したbackpack://ul/v1/browse?url=...のような独自スキームは、アプリが登録するどのルートにも一致せず、ウォレットのインストールページに着きます。
  • Solflareにもユニバーサルリンクが必要です。 https://solflare.com/ul/v1/browse/<url>?ref=<ref>を使い、単なるsolflare://スキームは使いません。スキームだけでは、アプリを起動しても移動先を指定できない場合があります。まさに「アプリは開くが、サイトのタブは手動で開く必要がある」という状態です。
  • 両方のパラメーターをエンコードする必要があります。 urlはdAppの完全な絶対アドレス、refは要求元のオリジンで、それぞれencodeURIComponentを通します。対象URLにエンコードしていない?や&があると解析が崩れ、ウォレットはブラウザータブではなくホーム画面を開きます。
  • 起動のきっかけも、リンク自体と同じくらい重要です。 ユニバーサルリンクがアプリを切り替えるのは、OSが信頼する移動操作のときだけです。アドレスバーに貼り付けても、意図的に何もしません。そのため、完全に正しいリンクもテスト中に「失敗」します。

文書にある形式

  • Phantom:https://phantom.app/ul/browse/<url>?ref=<ref>。この形式に/v1はありません。
  • Solflare:https://solflare.com/ul/v1/browse/<url>?ref=<ref>
  • Backpack:https://backpack.app/ul/v1/browse/<url>?ref=<ref>

三つとも、同じパターンで扱えます。

const WALLET_BROWSE = {
  phantom: (url, ref) =>
    `https://phantom.app/ul/browse/${url}?ref=${ref}`,
  solflare: (url, ref) =>
    `https://solflare.com/ul/v1/browse/${url}?ref=${ref}`,
  backpack: (url, ref) =>
    `https://backpack.app/ul/v1/browse/${url}?ref=${ref}`,
};

function walletBrowseLink(
  walletName,
  targetUrl = window.location.href,
) {
  const build = WALLET_BROWSE[walletName.toLowerCase()];
  if (!build) return null;
  return build(
    encodeURIComponent(targetUrl),
    encodeURIComponent(window.location.origin),
  );
}

iOSとAndroidが受け入れる方法でリンクを開く

  • 事前計算した、本物のリンク要素を描画します。 単純な<a href={walletBrowseLink('phantom')}>が、両方の環境で最も確実な起動方法です。
  • プログラムから行う必要がある場合は、タップのハンドラー内で、同期的にwindow.location.hrefへ代入します。その前にawait、fetch、setTimeoutを挟みません。非同期処理の後では操作の文脈が失われ、iOSはウォレットのウェブサイトへ移動します。window.openは使いません。
  • アドレスバーへの貼り付けでは、決してテストしません。 ユニバーサルリンクは、そこでは意図的に動作しません。リンクをタップするか、カメラでQRコードを読み取ってテストします。
  • メッセージアプリ内のウェブビューに注意します。 TelegramやInstagramのアプリ内ブラウザーでは、ユニバーサルリンクがしばしば処理されず、ウォレットの通常のウェブサイトが読み込まれます。ユーザーエージェントによる判定は、よくても推測にとどまります。そのため、「SafariまたはChromeで開いてから接続してください」という、見える回避方法も利用者に示します。

Androidでの、より根本的な修正

独自のディープリンクを組み立てる方法は、iOS向けの話です。Androidでは、Solana MobileのMobile Wallet Adapterにより、モバイルブラウザーで動くdAppから、インストール済みのウォレットアプリへ直接接続でき、アプリ内ブラウザーを経由する必要はありません。最近の@solana/wallet-adapter-reactは、モバイルアダプターを自動登録するため、wallet-adapter関連パッケージの更新だけでAndroidの問題が解消する場合もあります。目標の構成は、AndroidではMobile Wallet Adapter、相当する仕組みをAppleが認めていないiOSでは閲覧用ユニバーサルリンクです。

実機での検証

  1. ウォレットをインストールした実機で、メッセージアプリではなくOSのブラウザーからリンクを開きます。
  2. 描画されたリンクをタップするか、QRコードを読み取ります。アドレスバーには貼り付けません。
  3. ウォレットが開き、そのアプリ内ブラウザーのタブにdAppが読み込まれることを確認します。失敗するのは、この後半です。
  4. ウォレットをインストールしていない状態でも繰り返します。ユニバーサルリンクは、ウォレットのウェブサイトに移動するはずです。インストール済みなのにそのページが出る場合は、リンクか起動方法がまだ誤っています。
  5. その後で、メッセージアプリ経由の動作をテストし、そこで失敗する場合は「ブラウザーで開く」案内を追加します。

出典

サービス

お問い合わせ

必要なことを整理している段階ですか?

うまくいっていないことや、つくりたいものをお聞かせください。何が必要か、おおよそいくらかかるか、私たちが適任かどうかをお伝えします。

時間単価は1,400 DKKから(VAT別)で、ご依頼期間が長いほど下がります。

welcome@engineer.company +45 50 10 61 84 デンマーク、コペンハーゲン