オンチェーンでの型付きデータと署名メッセージの検証

所要時間：10～20分

このガイドでは、EVMベースのコントラクト用に提供されたソースコードの使い方を順を追って解説し、Universal Signature Validator（ERC-6492）を組み込んだカスタムオンチェーンメッセージバリデータコントラクトの仕組みや、型付きデータによるアプリ内署名検証の方法を説明します。

これは6つのステップで実現できます：

このアプリケーションの全体的な流れは、以下のシーケンス図で確認できます：

デモの全コードはこちらで確認できます。また、デモはこちらからご利用いただけます。

1. Builderプロジェクトの作成とアクセスキーの取得

まず、こちらのガイドに従ってSequence Builderでプロジェクトを作成し、プロジェクトのアクセスキーを取得してください。

2. React Viteアプリケーションの初期化

次に、署名生成やブロックチェーンからの検証レスポンス取得に必要なコードを格納する新しいプロジェクトを初期化します：

pnpm create vite

これで空のプロジェクトが作成され、要素やロジックを追加できるようになります。

3. Sequence Walletを使ったユーザーサインイン

プロジェクトの動作に必要なパッケージをインストールします：

pnpm install 0xsequence ethers

その後、ステップ1で取得したプロジェクトアクセスキーと選択したネットワークで、ユーザーがサインインできるようにします。

import { sequence } from '0xsequence'

function App() {

    sequence.initWallet(PROJECT_ACCESS_KEY, {

        defaultNetwork: 'sepolia',

    });

    const signIn = async () => {

        const wallet = sequence.getWallet()

        const details = await wallet.connect({app: 'sequence signature validation demo'})

        if(details){

            console.log('is signed in')

            console.log(details)

        }

    }

    return (

        ...

        <button onClick={() => signIn()}>sign in</button>

        ...

    )

}

4. EIP712型付きデータでEIP6492署名を生成

次に、typescriptでカスタム型付きデータを定義します。Sequenceのユーティリティライブラリを使ってTypedData型を構築し、name、wallet、messageパラメータを持つメッセージ構造を検証します：

この例のVERIFYING_CONTRACT_ADDRESSはsepoliaにデプロイしたスマートコントラクトですが、次のステップでこのコントラクトの内容を紹介し、どのネットワークでもデプロイできるように説明します：

import { sequence } from '0xsequence'

interface Person {

  name: string;

  wallet: string;

  message: string;

}

const VERIFYING_CONTRACT_ADDRESS = '0xB81efF8d6700b83B24AA69ABB18Ca8f9F7A356c5'

const CHAIN_ID = 11155111

const submitSignature = () => {

    const wallet = sequence.getWallet()

    const message = 'hey' // message can be dynamic

    const person: Person = {

        name: "user", // name can be dynamic

        wallet: wallet.getAddress(),

        message: message,

    };

    const chainId = CHAIN_ID

    const typedData: sequence.utils.TypedData = {

        domain: {

            // Domain settings must match verifying contract

            name: "Sequence Signature Validation Demo",

            version: "1",

            chainId,

            verifyingContract: VERIFYING_CONTRACT_ADDRESS,

        },

        types: {

            Person: [

                { name: "name", type: "string" },

                { name: "wallet", type: "address" },

                { name: "message", type: "string" },

            ],

        },

        message: person,

        primaryType: "Person",

    };

    ...

}

その後、参照した各プロパティを使って型付きメッセージオブジェクトに署名します：

const wallet = await sequence.getWallet()

const signer = wallet.getSigner(CHAIN_ID);

const signature = await signer.signTypedData(

    typedData.domain,

    typedData.types,

    typedData.message,

    {

        chainId,

        eip6492: true, // enabling signatures for non-deployed wallet contracts

    }

);

console.log("signature", signature);

関数をボタンに紐付け、ユーザーがクリックした後に署名が生成されることを確認してください：

<button onClick={() => submitSignature()}>verify signature</button>

5. EIP712検証とEIP1271バリデーション用コントラクトのデプロイ

ここでは、Remix や Foundry などのツール、または Sequence Builder を使ってコントラクトをデプロイするためのソースコードを提供します。

Universal Signature Validator（ユニバーサル署名バリデータ）

Universal Signature Validator は、特定のネットワークに一度デプロイすれば、多くのアプリケーションで共有できるため、再利用性と拡張性に優れています。これは、EIP6492 対応ウォレット向けのオフチェーン・オンチェーン両方のスマートコントラクトウォレットで利用できます。

こちらにソースコードがあります。このコードを利用してデプロイしてください。

カスタムコントラクトバリファイア

次に紹介するコントラクトは、用途に合わせてカスタマイズできるよう、さまざまな関数について詳しく説明します。まずは、Universal Signature Validator をコンストラクタに渡すという最初のステップで、以下の基本事項から始めましょう。

import {IERC1271} from "./interfaces/IERC1271.sol";

import {IERC6492} from "./interfaces/IERC6492.sol";

import {ECDSA} from "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";

import {EIP712} from "@openzeppelin/contracts/utils/cryptography/EIP712.sol";

struct Person { // can be customized

    string name;

    address wallet;

    string message;

}

contract EIP712Verifier is EIP712 {

    using ECDSA for bytes32;

    IERC6492 public immutable ERC6492_SIGNATURE_VALIDATOR; // the universal signature validator

    bytes32 private constant _ERC6492_DETECTION_SUFFIX = 0x6492649264926492649264926492649264926492649264926492649264926492;

    // this line of code must be customized to the struct you're verifying

    bytes32 private constant _PERSON_TYPEHASH = keccak256(bytes("Person(string name,address wallet,string message)"));

    constructor(address erc6492SignatureValidator) {

        ERC6492_SIGNATURE_VALIDATOR = IERC6492(erc6492SignatureValidator);

    }

    ...

}

署名の検証

次に、署名検証用の関数を用意します。この関数はメッセージハッシュのダイジェストを生成し、署名者を検証します。

/// @dev Verifies the signature of a person.

function verifySignature(address signer, Person memory person, bytes calldata signature)

    external

    returns (bool success)

{

    bytes32 digest = personDigest(person);

    return ERC6492_SIGNATURE_VALIDATOR.isValidSig(signer, digest, signature);

}

カスタム Person ダイジェスト

以下の関数では、渡されたパラメータを使って struct ハッシュを再生成します。必要に応じて、パラメータの種類や数を増減できます。

ダイジェストの構築方法については、EIP712仕様をご参照ください。

/// @dev Returns the EIP712 hash of a person.

function personDigest(Person memory person) public view returns (bytes32 digest) {

    bytes32 structHash = keccak256(

        abi.encode(_PERSON_TYPEHASH, keccak256(bytes(person.name)), person.wallet, keccak256(bytes(person.message)))

    );

    digest = EIP712._hashTypedDataV4(structHash);

}

署名者の検証

次に、signer アドレス、digest、signature を検証します。EIP6492 署名が渡された場合は universal signature validator を利用し、それ以外は EIP1271 の署名検証を直接行います。

/// @dev Validates the ERC1271 signature of a signer.

function validateSigner(address signer, bytes32 digest, bytes calldata signature) internal returns (bool success) {

    if (signature.length >= 32) {

        bool isCounterfactual =

            bytes32(signature[signature.length - 32:signature.length]) == _ERC6492_DETECTION_SUFFIX;

        if (isCounterfactual) {

            return ERC6492_SIGNATURE_VALIDATOR.isValidSig(signer, digest, signature);

        }

    }

    try IERC1271(signer).isValidSignature(digest, signature) returns (bytes4 magicValue) {

        return magicValue == IERC1271.isValidSignature.selector;

    } catch {}

    return false;

}

これで両方のコントラクトをデプロイする準備ができました。ネットワークを選択してください。

6. 検証コントラクトからのレスポンスを表示

署名を渡し、ethers を使ってデプロイ済みコントラクトを呼び出します。この際、PROJECT_ACCESS_KEY を利用します。

プロバイダの作成

プロジェクトアクセスキーを使ってプロバイダを作成します。

import { ethers } from 'ethers'

const CHAIN_HANDLE = 'sepolia'

const provider = new ethers.JsonRpcProvider(

    `https://nodes.sequence.app/${CHAIN_HANDLE}/${PROJECT_ACCESS_KEY}`

);

Ethers コントラクトの初期化

ステップ5 で生成された ABI（または Git のソースコードからコピー）をインポートし、プロバイダと検証コントラクトアドレスを指定します。

import { ABI } from "./abi";

const contract = new ethers.Contract(

    VERIFYING_CONTRACT_ADDRESS,

    ABI,

    provider

);

署名検証関数をスタティックコール

関数をスタティックコールすることで、トランザクションをチェーンに送信せずにシミュレーションできます。これにより、検証が成功したかどうかの結果が返されます。

const address = await wallet.getAddress()

const person: Person = {

    name: "user",

    wallet: address,

    message: message,

}

const signature = await signer.signTypedData(

    typedData.domain,

    typedData.types,

    typedData.message,

    {

        chainId,

        eip6492: true,

    }

);

const result = await contract.verifySignature.staticCall(

    address,

    person,

    signature

);

console.log(`Signature is ${result ? "valid" : "invalid"}`);

return result;

まとめ

これで、ユーザーが正しい情報に署名していることを保証するさまざまなユースケース（例：ERC20 の使用許可、オフチェーンでの入札、署名済み QR コードによるミントなど）へとアプリケーションを拡張できます。

ガイド

ボイラープレート

​1. Builderプロジェクトの作成とアクセスキーの取得

​2. React Viteアプリケーションの初期化

​3. Sequence Walletを使ったユーザーサインイン

​4. EIP712型付きデータでEIP6492署名を生成

​5. EIP712検証とEIP1271バリデーション用コントラクトのデプロイ

​カスタム Person ダイジェスト

​署名者の検証

​6. 検証コントラクトからのレスポンスを表示

​まとめ

1. Builderプロジェクトの作成とアクセスキーの取得

2. React Viteアプリケーションの初期化

3. Sequence Walletを使ったユーザーサインイン

4. EIP712型付きデータでEIP6492署名を生成

5. EIP712検証とEIP1271バリデーション用コントラクトのデプロイ

カスタム Person ダイジェスト

署名者の検証

6. 検証コントラクトからのレスポンスを表示

まとめ