SIWEのWeb3アプリケーションにおける適用と実践

SIWE(Ethereumでサインイン)は、ユーザーの身元を確認するためのEthereumベースの方法で、ウォレットからのトランザクションを開始することに似ており、ユーザーがウォレットを制御していることを証明するために使用されます。現在、主流のウォレットプラグインは、このシンプルな認証方法を広くサポートしており、プラグイン内で情報に署名するだけで済みます。本記事では、Ethereum上の署名シナリオについて主に議論し、他のパブリックチェーンには触れません。

! SIWEマニュアル:Dappをより強力にする方法は?

SIWEのシナリオ

SIWEは主にウォレットアドレスの認証問題を解決するために使用されます。あなたのアプリケーションが以下の要件を持っている場合、SIWEの使用を検討できます:

• 独立したユーザーシステムを持つ
• ユーザーのプライバシーに関する情報を確認する必要があります

クエリ機能を主とするアプリケーション、例えばブロックエクスプローラーなどでは、SIWEを使用する必要はありません。

アプリケーションのフロントエンドでウォレット接続を通じて身分を明示することは可能ですが、バックエンドサポートが必要なインターフェース呼び出しには、アドレスを渡すだけでは不十分です。なぜなら、アドレスは公開情報であり、他者に盗用されやすいからです。

SIWEの原理とプロセス

SIWEのプロセスは、ウォレットの接続、署名、IDの取得という3つのステップに要約できます。

ウォレットを接続する

これは一般的なWeb3操作であり、アプリケーション内でウォレットを接続するためにウォレットプラグインを使用します。

! SIWEマニュアル:Dappをより強力にする方法は?

サイン

署名手順には、Nonce値の取得、ウォレット署名、およびバックエンド署名検証が含まれます。

1. Nonce値を取得する: バックエンドインターフェースを呼び出してランダムなNonce値を取得し、現在のアドレスに関連付けます。

2. サイン内容の構築: Nonce値、ドメイン、チェーンID、サイン内容などを含み、ウォレットが提供する方法を使用してサインします。

3. 署名の送信: 署名をバックエンドに送信して検証します。

ID を取得する

バックエンドで署名が検証された後、ユーザーの識別子(（JWT)として）を返します。フロントエンドはその後のリクエストでアドレスと識別子を持って行き、ウォレットの所有権を証明できます。

! SIWEマニュアル:Dappをより強力にする方法は?

実践ガイド

以下は、アプリケーションでSIWEを迅速に導入する方法についての説明です。目標は、ユーザーの認証に使用されるJWTを返すことです。注意：この例は基本的な流れを示すためのものであり、製品環境での使用には安全上のリスクがある可能性があります。

###環境の準備

この記事では、Next.jsを使用してフルスタックアプリケーションを開発するために、Node.js環境を準備する必要があります。

依存関係のインストール

まずNext.jsをインストールします:

npx create-next-app@14

プロジェクトディレクトリに入ったら、次のコマンドを実行します:

npm run dev

SIWE関連の依存関係をインストール

npm install antd @ant-design/web3 @ant-design/web3-wagmi wagmi viem @tanstack/react-query --save

Wagmi の設定

layout.tsx に WagmiProvider を導入します。

JavaScriptの "クライアントを使用"; import { getNonce, verifyMessage } from "@/app/api"; インポート { メインネット、 メタマスク Okxウォレット、 トークンポケット、 WagmiWeb3ConfigProvider、 ウォレットコネクト、 } から "@ant-design/web3-wagmi"; import { QueryClient } from "@tanstack/react-query"; import React from "react"; import { createSiweMessage } from "viem/siwe"; import { http } from "wagmi"; import { JwtProvider } from "./JwtProvider";

const YOUR_WALLET_CONNECT_PROJECT_ID = "c07c0051c2055890eade3556618e38a6"; const queryClient = 新しいQueryClient();

const WagmiProvider: React.FC = ({ children }) => { const [jwt, setJwt] = React.useState(null);

リターン( <wagmiweb3configprovider siwe="{{" getnonce:="" async="" (address)=""> (非同期でノンスを取得(アドレス)).data, createMessage: (props) => { 戻り値 createSiweMessage({ ... props, statement: "Ant Design Web3" }); }, verifyMessage:非同期(message、signature) = > { const jwt = (await verifyMessage(message、signature)).data; setJwt(jwt); 帰る！！ JWTの; }, ｝｝ chains={[Mainnet]} transports={{ [Mainnet.id]:http()、 ｝｝ walletConnect={{ projectId: YOUR_WALLET_CONNECT_PROJECT_ID、 ｝｝ wallets={[ MetaMask()、 WalletConnect()、 TokenPocket({ グループ: "人気", }), OkxWallet()、 ]} queryClient={クエリクライアント} > {子供} ); };

export default WagmiProvider;

! SIWEマニュアル:Dappをより強力にする方法は?

接続ボタンを追加

JavaScriptの "クライアントを使用する"; import type { Account } from "@ant-design/web3"; import { ConnectButton, Connector } from "@ant-design/web3"; import { Flex, Space } from "antd"; import React from "react"; import { JwtProvider } from "./JwtProvider";

export default 関数 App() { const jwt = React.useContext(JwtProvider);

const renderSignBtnText = ( defaultDom: React.ReactNode, アカウント?: アカウント ) => { const { アドレス } = アカウント ?? {}; const ellipsisAddress = アドレス ? ${address.slice(0, 6)}...${address.slice(-6)} : ""; ${ellipsisAddress}としてサインインします; };

リターン( <>

! SIWEマニュアル:Dappをより強力にする方法は?

インターフェース実装

ノンスインターフェース

JavaScriptの import { randomBytes } from "crypto"; import { addressMap } from ".. /cache";

非同期関数 GET(リクエスト: リクエスト) { const { searchParams } = 新しいURL(request.url); constアドレス= searchParams.get("アドレス");

if (!address) { 新しいError("無効なアドレス")をスローします。 } const nonce = randomBytes(16).toString("hex"); addressMap.set(住所、nonce); 戻り値 Response.json({ データ:nonce、 }); }

メッセージ検証インターフェース

JavaScriptの import { createPublicClient, http } from "viem"; import { mainnet } from "viem/chains"; "jsonwebtoken"からjwtをインポートする; import { parseSiweMessage } from "viem/siwe"; import { addressMap } from ".. /cache";

const JWT_SECRET = "あなたの秘密鍵"; より安全なキーを使用し、有効期限チェックなどを追加する

const publicClient = createPublicClient({ チェーン: メインネット, トランスポート: http(), });

export async 関数 POST(request: Request) { const {署名、メッセージ} = await request.json();

const { nonce, アドレス = "0x" } = parseSiweMessage(message);

if (!nonce || nonce !== addressMap.get(アドレス)) { 新しいError("無効なナンス")をスローします。 }

const valid = await publicClient.verifySiweMessage({ メッセージ、 アドレス、 署名 });

if (!valid) { 新しいError("無効な署名")をスローします。 }

const token = jwt.sign({ アドレス }, JWT_SECRET, { expiresIn: "1h" }); 戻り値 Response.json({ データ: トークン, }); }

! SIWEマニュアル:Dappをより強力にする方法は?

パフォーマンス最適化

SIWEログインの応答速度を向上させるために、デフォルトのRPCノードの代わりに専用のノードサービスを使用することをお勧めします。本記事ではZANのノードサービスを使用し、そのコントロールパネルでRPC接続を取得できます。

publicClientのデフォルトRPCを置き換える:

JavaScriptの const publicClient = createPublicClient({ チェーン: メインネット, transport: http('), //ZAN ノードサービス RPC });

これにより、検証時間を大幅に短縮し、インターフェースの速度を向上させることができます。

! SIWEマニュアル:Dappをより強力にする方法は?