Tonkeeper を TON dApp に接続する方法

ウォレットの準備とネットワーク検証

1.tonkeeper.com または iOS、Android、またはデスクトップ プラットフォーム用の検証済みアプリ ストアから公式 Tonkeeper アプリケーションをインストールします。

2. Tonkeeper を起動し、TON メインネット上で動作していることを確認します。これを確認するには、上部バーのネットワーク インジケーターをチェックします。 「Testnet」と表示されている場合は、設定にアクセスし、Tonkeeper ロゴを 5 回タップして開発者メニューを開き、メインネットに切り替えます。

3. ほとんどの dApp で必要な初期取引手数料と契約展開コストをカバーするために、ウォレットに少なくとも 0.1 TON が含まれていることを確認します。

4. 24 ワードのリカバリ フレーズを安全なオフラインの場所にバックアップします。この手順は元に戻すことができず、オンチェーン インタラクションの前に必須です。

5. サードパーティの拡張機能やオーバーレイがウォレットの UI レンダリングや署名プロンプトを妨げていないことを確認します。

dAppインターフェース経由の接続開始

1. JavaScript が有効になっている Chrome、Edge、Safari などのサポートされているブラウザを使用して、ターゲットの TON ベースの dApp に移動します。

2. [ウォレットに接続] ボタンを見つけてクリックします。通常は dApp インターフェイスの右上隅にあります。

3. 表示されたウォレットリストから「Tonkeeper」を選択します。 dApp の接続フローで明示的に指示されない限り、QR コードのスキャンは避けてください。

4. Tonkeeper 内にポップアップ モーダルが表示され、パブリック アドレスを共有してセッション リクエストに署名する許可を求めます。[承認] をタップします。

5. dApp には接続されているアドレスが表示され、自動残高同期がトリガーされる場合があります。秘密キーやシードフレーズは送信されません。

アドレス形式と互換性の処理

1. Tonkeeper はデフォルトでバウンス可能な形式 (例: EQB4c1b2ede12aa76f4a44353944258bcc8f99e9c7c474711a152c78b43218e296 ) でアドレスを生成します。これは自動エラー修正をサポートしており、ユーザー向けの対話に推奨されます。

2. 一部の dApp では、スマート コントラクト呼び出しにバウンス不可のアドレスが必要です。Tonkeeper では、「アカウント情報」>「アドレスのコピー」> トグル オプションで両方のバージョンが提供されています。

3. dApp がワークチェーン ID (ベース チェーンの場合は 0) とアカウント ID コンポーネントを正しく解析していることを確認します。ワークチェーンの処理が一致しないと、サイレント接続エラーが発生します。

4. dApp が TonConnect プロトコル v2 を使用している場合は、Tonkeeper のバージョンが 4.12.0 以上であることを確認してください。古いバージョンでは、マルチシグネチャ セッション ハンドシェイクがサポートされていません。

5. アドレス文字列を手動で編集したり切り捨てたりしないでください。チェックサムとプレフィックスのエンコーディングは、基礎となる公開キーに暗号的にバインドされています。

署名とトランザクション認証のフロー

1. トランザクションまたはデータ署名リクエストを開始すると、dApp はメソッド名、パラメータ、有効期限タイムスタンプを含む構造化ペイロードを送信します。

2. Tonkeeper は、正確な操作タイプ ( sendMessageまたはSignData )、宛先アドレス、金額、および添付されたメモを示すネイティブ確認画面を表示します。

3. ユーザーは各アクションを明示的に承認する必要があります。設計上、バッチ承認や自動署名ポリシーは許可されていません。

4. 承認されると、Tonkeeper は正規化されたペイロードに対して Ed25519 署名を計算し、署名されたメッセージ ハッシュとともにそれを dApp に返します。

5. 署名に失敗すると、常にブロックチェーンレベルで即座に拒否されます。部分的な実行やフォールバック実行は発生しません。

一般的な接続障害のトラブルシューティング

1. ウォレットがコネクタ リストに表示されない場合は、ブラウザのキャッシュをクリアし、WebSocket や挿入されたスクリプトをフィルタリングする広告ブロッカーやプライバシー拡張機能を無効にします。

2. 継続的な「無効なセッション」エラーは、TonConnect ペアリングの期限が切れたことを示します。dApp で「ウォレットの切断」をクリックして再接続し、接続を再開します。

3. 空白またはフリーズした確認モーダルは通常、Tonkeeper のバージョンが古いことが原因です。公式アプリ ストアまたは Tonkeeper.com/download から更新してください。

4. dApp の表示と Tonkeeper の「アカウント情報」の間のアドレスの不一致は、ネットワーク コンテキストが正しくないことを示唆しています。dApp バックエンドとウォレットの両方が同一の TON ネットワーク エンドポイントで動作していることを再確認してください。

5. 署名リクエスト中にタイムアウト メッセージが繰り返される場合は、ローカル インターネットまたは ISP レベルの WebSocket ブロックが不安定であることを示しています。モバイル データに切り替えるか、Tonkeeper 設定で Tor モードを有効にしてください。

よくある質問

Q: 再承認なしで Tonkeeper を複数の dApps に同時に接続できますか? A: はい - Tonkeeper は dApp ドメインごとに永続的なセッション キーを維持します。新しいオリジンごとに 1 回限りのペアリングが必要ですが、手動で取り消さない限り、その後の対話では再認証がスキップされます。

Q: dApp に接続すると、取引履歴や残高詳細へのアクセスが許可されますか? A: いいえ、パブリック アドレスのみが共有されます。すべての残高と履歴のクエリは、ユーザーの同意と明示的な RPC 呼び出しによって制御される TON API エンドポイント経由で実行する必要があります。

Q: Tonkeeper が選択されている場合でも、一部の dApp に「サポートされていないウォレット」と表示されるのはなぜですか? A: これは、dApp が Tonkeeper の現在のアダプター層と互換性のないレガシー TonConnect v1 またはカスタム RPC ラッパーを強制する場合に発生します。サポートされる最小 SDK バージョンについては、dApp のドキュメントを確認してください。

Q: Tonkeeper を非 HTTPS ドメインでホストされている dApps に接続しても安全ですか? A: いいえ - Tonkeeper は HTTP オリジンへの接続を完全にブロックします。有効な証明書を持つ TLS で保護されたドメインのみがウォレット セッションの開始を許可されます。