Web3Signer(file-keystore)の署名動作確認

動作環境

OS	Ubuntu 24.04 (WSL Docker Container)
JDK	Open JDK 21.0.7
Web3Signer	25.6.0

keystore 形式のアカウント作成

• go のインストール

  sudo apt install -y golang
  

• geth コマンドのインストール

  • ビルド

    git clone https://github.com/ethereum/go-ethereum.git
    cd go-ethereum/
    make geth
    

  • インストール

    mkdir $HOME/bin
    cp ./build/bin/geth $HOME/bin
    

  • PATH の設定

    echo 'PATH=$HOME/bin:$PATH' >> $HOME/.bashrc
    source $HOME/.bashrc
    

• keystore 形式のアカウント作成

  mkdir -p $HOME/web3signer/keystores
  geth account new --keystore $HOME/web3signer/keystores
  

  パスワードを設定すると下記のように作成したアカウントの情報が表示されます。

  Your new key was generated
  
  Public address of the key:   0xF7ac504BAc5De36C03483586FCdd11cA97f604F8
  Path of the secret key file: /home/youruser/web3signer/keystores/UTC--2025-07-12T12-52-35.515154612Z--f7ac504bac5de36c03483586fcdd11ca97f604f8
  
  - You can share your public address with anyone. Others need it to interact with you.
  - You must NEVER share the secret key with anyone! The key controls access to your funds!
  - You must BACKUP your key file! Without the key, it's impossible to access account funds!
  - You must REMEMBER your password! Without the password, it's impossible to decrypt the key!
  

Web3Signer のインストール

必要なパッケージのインストール

sudo apt install -y openjdk-21-jdk

インストール

• Install binary distribution

  • ビルド済みバイナリの取得と展開

    wget https://github.com/Consensys/web3signer/releases/download/25.6.0/web3signer-25.6.0.tar.gz
    tar zxvf web3signer-25.6.0.tar.gz -C $HOME
    

  • PATH の設定

    echo 'export PATH=$HOME/web3signer-25.6.0/bin:$PATH' >> $HOME/.bashrc
    source $HOME/.bashrc
    

署名鍵の設定

• 署名鍵設定ファイルディレクトリ作成

  mkdir $HOME/web3signer/keys
  

• パスワードファイルの作成

  echo "password" > $HOME/web3signer/f7ac504bac5de36c03483586fcdd11ca97f604f8.password
  

• 署名鍵の設定

  yaml title="$HOME/web3signer/keys/localkey.yaml"

  type: "file-keystore"
  keyType: "SECP256K1"
  keystoreFile: "/home/youruser/web3signer/keystores/UTC--2025-07-12T12-52-35.515154612Z--f7ac504bac5de36c03483586fcdd11ca97f604f8"
  keystorePasswordFile: "/home/youruser/web3signer/f7ac504bac5de36c03483586fcdd11ca97f604f8.password"
  

• Web3Signer の起動

  web3signer --key-store-path=$HOME/web3signer/keys eth1 --chain-id=31337
  

署名の実行

curl -X POST http://localhost:9000 \
    -H "Content-Type: application/json" \
    -d '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_sign",
  "params": ["0xf7ac504bac5de36c03483586fcdd11ca97f604f8", "0x7d3ec8fba8a1b42b74e7c0cbab2a73dbf9a84e13f96e3e8f4fd09940420e7a6f"]
}'

params で設定している配列要素の 1 個目のパラメータに Public address of the key の値を全部小文字にして先頭に 0x を付けた値を設定します。

その他の Web3Signer のAPI

Consensys Web3Signer API documentation に Web3Signer が提供する API の説明が書かれています。
上記の署名 API は古い形式で、新しい署名 API では API documentation に書かれている形式を指定するらしいのですが、どうしても 400 Bad request format の壁を越えられなかった。。。あとで時間があるときにリトライしようと思います。