ウォレットを作成

ボタンのクリックなど、ユーザーの操作に応じてregisterWalletを呼び出します。 SDKはパスキーの認証画面を開き、進行状況を通知します。 戻り値の分岐によって、利用できる機能を判断できます。

パスキーウォレットを登録

登録ボタンと結果のUIを自社で実装する場合は、フックを使います。 はじめにで設定したSeamsWebProviderの内側にCreateWalletButtonを配置してください。 registrationプロパティには、明示的なauthMethodを含む値を渡します。 authMethodでパスキー認証またはメール認証を選択します。

walletを省略すると、サーバーがウォレットIDを割り当てます。 IDを指定する場合は、wallet: { kind: 'provided', walletId }を渡します。 signerSelectionを省略すると、SDKは設定済みチェーンと有効なプロビジョニングの既定値に従って署名者を選択します。 NEARは設定済みのアカウント作成ポリシーを使います。署名者を独自に選ぶ場合はsignerSelectionを渡してください。

次の要求は、設定済みチェーン用のパスキーウォレットを作成します。

import type { SeamsWeb } from '@seams/wallet';
import { parseWebAuthnRpId } from '@seams/wallet/advanced';

const rpId = parseWebAuthnRpId('wallet.example.com');
if (!rpId.ok) throw new Error(rpId.error.message);

export const registration: Parameters<SeamsWeb['registration']['registerWallet']>[0] = {
  authMethod: { kind: 'passkey', rpId: rpId.value },
};

wallet.example.comを、ウォレットオリジンのRP ID（パスキーの登録先を識別するID）に置き換えてください。 registrationを次のボタンに渡すか、自社のUIからseams.registration.registerWallet(registration)を呼び出します。

import type { RegistrationFlowEvent, SeamsWeb } from '@seams/wallet';
import { useSeams, type SeamsContextType } from '@seams/wallet/react';

function logRegistrationEvent(event: RegistrationFlowEvent): void {
  console.log(event.phase, event.status, event.message);
}

function assertNever(value: never): never {
  throw new Error(`Unexpected NEAR readiness result: ${JSON.stringify(value)}`);
}

async function createWallet(
  registerWallet: SeamsContextType['registerWallet'],
  seams: SeamsWeb,
  registration: Parameters<SeamsContextType['registerWallet']>[0],
): Promise<void> {
  try {
    const result = await registerWallet({
      ...registration,
      options: { ...registration.options, onEvent: logRegistrationEvent },
    });
    if (!result.success) {
      console.error('Registration failed:', result.error);
      return;
    }
    // `walletId` is the stable identifier for every later wallet operation.
    console.log(`Wallet ${result.walletId} registered (${result.kind})`);

    if (
      result.kind === 'ecdsa_wallet_registered_near_pending' ||
      result.kind === 'near_wallet_registered_pending'
    ) {
      const near = await seams.registration.waitForNearAccount({ walletId: result.walletId });
      switch (near.kind) {
        case 'near_ready':
          console.log('NEAR account ready:', near.nearAccountId);
          break;
        case 'near_failed_retryable':
          console.warn('NEAR provisioning needs a retry:', near.reason);
          break;
        case 'timed_out':
          console.warn('NEAR is still pending. Keep this wallet id and check readiness again.');
          break;
        default:
          assertNever(near);
      }
    }
  } catch (error) {
    console.error('Wallet creation interrupted:', error);
  }
}

export function CreateWalletButton({ registration }: {
  registration: Parameters<SeamsContextType['registerWallet']>[0];
}) {
  const { registerWallet, seams } = useSeams();

  return (
    <button onClick={createWallet.bind(null, registerWallet, seams, registration)}>
      Create wallet
    </button>
  );
}

この例はresult.successを確認してから、結果のkindをログに出力します。 NEARのアカウント作成状況などのフィールドを読む前に、結果の分岐を確認してください。

結果を確認

• wallet_registered：ウォレットと、戻り値に含まれる機能の準備が完了しています。
• ecdsa_wallet_registered_near_pending：EVM系の機能は利用できます。NEARのアカウント作成は処理中、または再試行可能です。 この分岐にはNEARアカウントIDがありません。NEARで署名する前に、seams.registration.waitForNearAccount({ walletId })の完了を待ってください。
• near_wallet_registered_pending：NEARアカウントを参照するには、アカウント作成の準備完了を待つ必要があります。
• wallet_signer_added：既存のウォレットに署名者を追加しました。
• success: false：今回の試行について、表示またはログ出力するエラーテキストが含まれます。

戻り値のwalletIdは、署名、セッションの準備、そのウォレットのその他すべての操作に使う安定した識別子です。 アプリのアカウントレコードと一緒に保存してください。パスキーや署名シェアの保持者が持つ秘密情報を、アプリの状態に保存しないでください。

登録が中断した場合

パスキー認証をキャンセルすると、今回の試行が終了します。同じボタンから新しい試行を開始できるようにしてください。 NEARのアカウント作成が再試行可能な場合も、ウォレットの識別情報は維持されます。 再試行を案内する前に作成状況を確認し、別のウォレットを登録しないでください。

• seams.registration.waitForNearAccount({ walletId })は、アカウント作成の結果を待ち、 near_ready、near_failed_retryable、timed_outのいずれかを返します。 signalで中断した場合を除き、Promiseはrejectされません。
• seams.registration.getNearAccountState({ walletId })は、待機せずに現在の状態を取得します。

オリジン、公開可能キー、認証に関するエラーでは、再試行の前に設定またはアカウントを修正する必要があります。

次の手順

ポリシーに従って署名に進んでください。