UIコンポーネント
@seams/wallet/reactは、サインイン、ウォレット設定、デバイスのリンク、取引の確認に使う既製のコンポーネントを提供します。 スタイルシートを一度だけインポートします。モック以外のコンポーネントは、すべてSeamsWebProvider内に配置します。
import { SeamsWebProvider, HostedSeamsAuthMenu, AccountMenuButton } from '@seams/wallet/react';
import '@seams/wallet/react/styles';コンポーネントの一覧
| コンポーネント | 表示する内容 | プロバイダー |
|---|---|---|
HostedSeamsAuthMenu | ウォレットオリジン上の、サインイン、登録、復旧の完全なメニュー。 | 必要 |
SeamsAuthMenuMock | 操作できない、認証メニューの静的なプレビュー。 | 不要 |
AccountMenuButton | ウォレット設定をドロップダウン、モーダル、ドロワーで開くアカウントボタン。 | 必要 |
ProfileSettingsButton | AccountMenuButtonと同じコンポーネントの別名。 | 必要 |
AccountMenuButtonMock | サンプルデータを使う、操作できるアカウントメニューのプレビュー。 | 不要 |
WalletSettingsPage | ページ全体のウォレット設定。未サインインの場合はホストする認証を表示。 | 必要 |
WalletBalances | アプリ独自のウォレットパネル用の、設定の残高カード。 | 必要 |
ShowQRCode | 新しいデバイスのリンクコード。開始から期限切れまでを処理。 | 必要 |
QRCodeScanner | 既存デバイスのカメラスキャナーとリンクの承認。 | 必要 |
TransactionReviewHost | ウォレットの承認前に独自の確認内容を表示するダイアログ。 | 必要 |
ExternalEvmWalletPicker | ブラウザーに注入されたEVMウォレットのセレクター。 | 不要 |
Theme | 配下のすべてのコンポーネントにテーマトークンを提供。 | 不要 |
独自のコントロールに使う小さなアイコンとして、TouchIcon、QRCodeIcon、SunIcon、MoonIconも提供します。
インポートを小さくする場合や、SSRで使う場合は、個別のエントリーポイントを使います。
@seams/wallet/react/hosted-seams-auth-menu:認証メニューとそのモック。@seams/wallet/react/profile:アカウントメニュー、そのモック、設定ページ。@seams/wallet/react/provider:SeamsWebProvider。@seams/wallet/react/external-near:外部NEARウォレットのセレクター(開発プレビュー)。
サインイン
HostedSeamsAuthMenuは、認証体験全体をウォレットオリジン上に表示します。 アプリのページは、マウントしたセッションごとに1つの結果をonOutcomeで受け取ります。 主な任意のプロパティは次のとおりです。
initialMode:最初の画面を選択します。既定はサインインです。walletAlternatives:外部のNEARウォレットとEVMウォレットをメニューに追加します。recoveryOptions:復旧とデバイスのリンクを表示、折りたたみ、非表示にします。footerBrand:「Secured by seams」の行をアプリのロゴに置き換えます。copy:メニューの文言を変更します。placeholder:メニューの読み込み中に、操作できない独自の内容を表示します。
各プロパティはホストする認証メニューを、サインインの流れは認証を参照してください。
ウォレット設定
AccountMenuButtonは、残高、アカウント、認証方式、復旧コード、リンク済みデバイス、エクスポート、取引の設定を開きます。 nearAccountIdが必要です。既定のpresentation="dropdown"は、SDKのトリガーボタンを含みます。 "modal"または"drawer"の場合は、isMenuOpenとonMenuOpenChangeを使い、アプリ独自のボタンから設定を開きます。
WalletSettingsPageは、同じ設定をページ全体に表示します。ウォレットのリージョン設定も表示します。 表示方法、ドロワーの動作、リージョン設定はReactコンポーネントを参照してください。
残高、受け取り、送金
設定の概要は残高カードから始まります。主な3つの残高、すべての資産のリンク、受け取りと送金を表示します。
- 資産は、設定したチェーンについて、ウォレット独自のリストにある資産を表示します。NEARメインネットでは、NEAR、stNEAR、USDC、USDt、ETH、BTC、SOL、ZECです。BTC、SOL、ZECはNEAR上のNEAR Intentsトークンです。NEARテストネットでは、NEAR、stNEAR、USDCです。EVMチェーンでは、ネイティブコインと登録済みのトークンを追加します。
- 受け取りは、1つの資産について、ウォレットのアドレス、QRコード、到着する必要があるネットワークを表示します。そのネットワークでのみ受け取ります。
- 送金は、金額と送金先を確認してから、ウォレットの確認カードを開きます。ユーザーが確認するまで何も署名しません。トークンのストレージがない送金先には、同じ取引で
storage_depositを追加します。金額が残高を超える場合は、同じ資産の受け取りを表示します。
読み取れない残高は、ゼロではなく取得できませんと表示します。金額は価格なしで表示します。WalletBalancesは同じカードをアプリ独自のパネルに表示します。ハンドラーがない場合、ボタンは表示中の設定パネルの対応する画面を開きます。アプリ独自のフローを開くには、onReceive、onSend、onOpenAssetsを渡します。アプリのコードからこれらの画面を開くにはseams.assets.openScreen()を使います。UIなしで同じデータを使うにはseams.assetsを使います。コアリファレンスを参照してください。
デバイスのリンク
デバイスのリンクには、各デバイスに1つずつ、2つのコンポーネントを使います。
- 新しいデバイスでは、
ShowQRCodeがリンクセッションを開始し、コードを表示します。 - 既存のデバイスでは、
QRCodeScannerがコードを読み取り、承認を実行します。
import { useState } from 'react';
import { QRCodeScanner } from '@seams/wallet/react';
import type { LinkDeviceFlowEvent } from '@seams/wallet';
function logLinkEvent(event: LinkDeviceFlowEvent): void {
console.log(event.phase, event.status, event.message);
}
// Device 1: `QRCodeScanner` opens the camera, reads the code that `ShowQRCode`
// displays on Device 2, and runs the approval. Mount it inside SeamsWebProvider.
export function ScanLinkCode() {
const [isOpen, setIsOpen] = useState(false);
return (
<>
<button onClick={() => setIsOpen(true)}>Link a new device</button>
{isOpen && (
<QRCodeScanner
isOpen={isOpen}
onQRCodeScanned={(qrData) => console.log('Linked device', qrData)}
onEvent={logLinkEvent}
onError={(error) => console.error('Device link failed', error)}
onClose={() => setIsOpen(false)}
/>
)}
</>
);
}QRCodeScannerは、新しいデバイスが有効になった後にonQRCodeScannedを呼び出し、その後onCloseを呼び出します。 onEventは、リンクの進行イベントを1つずつ受け取ります。 セッションが期限切れになると、スキャナーは期限切れの画面を表示します。 リンクの途中でスキャナーを閉じると、スキャナーはリンクを取り消します。
| プロパティ | 目的 |
|---|---|
isOpen | カメラを開始・停止します。既定はtrueです。 |
presentation | ダイアログには"modal"(既定)、ページ内表示には"embedded"。 |
cameraId | カメラを選択します。既定ではブラウザーが選択します。 |
showCamera | falseにすると、カメラを停止したままにします。 |
onQRCodeScanned | リンクの成功後に、読み取ったペイロードを受け取ります。 |
onEvent | 各LinkDeviceFlowEventを受け取ります。 |
onError | カメラとリンクの失敗を受け取ります。 |
onClose | スキャナーが閉じたときに一度だけ実行します。 |
アカウントメニューには、スキャナーがすでに含まれています。 そのイベントを受け取るには、AccountMenuButtonのdeviceLinkingScannerParamsを使います。 流れはリンク済みデバイスを、ShowQRCodeの実装例はウォレットの高度な操作を参照してください。
外部ウォレット
ExternalEvmWalletPickerは、useExternalEvmが検出した、ブラウザーに注入されたEVMウォレットを表示します。 コントローラーとそのスナップショットを受け取ります。外部EVMウォレットを参照してください。
取引の確認
TransactionReviewHostは、ウォレットの承認前にアプリ独自のReactの内容を表示します。 useSeams().walletの署名メソッドにreviewを渡します。独自の確認コンポーネントを参照してください。
ウォレットなしのプレビュー
SeamsAuthMenuMockとAccountMenuButtonMockには、プロバイダーが不要です。 セッションの作成、署名、鍵のエクスポート、ウォレットストレージの読み取りは行いません。 デザインの確認、読み込み中の表示、マーケティングページに使います。
import { AccountMenuButtonMock } from '@seams/wallet/react/profile';
import '@seams/wallet/react/styles';
<AccountMenuButtonMock username="Alex Chen" walletId="alex.near" theme="light" />;外観
すべてのコンポーネントはThemeのトークンを使います。 認証メニューや取引の確認画面などのウォレットオリジン側の画面は、SDKに送った外観の設定を使います。 両方を同じプリセットから設定します。テーマの設定とUIのカスタマイズを参照してください。