web3.py (eth-account)

事实及其依据的检查

以下内容均非抄自文档。检查脚本 content/libraries/verify/web3py/run.sh 于2026年10月20日在容器镜像 python:3.14.8-slim-trixie 中运行了 web3.py (eth-account) 8.0.0；本页内容必须与它的输出一致，每条事实都列出了对应的输出行。

• ECDSA 签名编码

  rsv-65

  sign_message() 返回 65 字节：r、s 和 v。

  检查记录

  fact ecdsa-signature-encoding = rsv-65

• 恢复 ID v

  27-28

  v 为 27 或 28。

  检查记录

  fact recovery-v = 27-28

• 消息前缀

  eip-191

  摘要与独立计算出的 keccak-256 一致，计算对象是 \x19Ethereum Signed Message:\n、十进制长度和消息本身。

  检查记录

  fact message-prefix = eip-191

• 默认哈希

  keccak256

  消息签名使用 keccak-256。

  检查记录

  fact ecdsa-default-hash = keccak256

• 签名调用对哪些内容做哈希

  hashes-message-or-digest

  sign_message() 对加上 EIP-191 前缀的消息计算哈希；unsafe_sign_hash() 对 32 字节的摘要原样签名，对该摘要生成的签名与前者完全相同。

  检查记录

  fact ecdsa-prehash = hashes-message-or-digest
  evidence ecdsa-prehash: unsafe_sign_hash over the EIP-191 digest equals sign_message: True

• ECDSA 的 nonce

  rfc6979

  RFC 6979：签名与一个独立参考实现的输出（s 经过规范化）一致。

  检查记录

  fact ecdsa-nonce = rfc6979

• 签名时的 low-S

  low-s

  64 个消息签名中没有 high-S 值。

  检查记录

  fact ecdsa-low-s-sign = low-s

• 验证时的 high-S

  accepts-high-s

  recover_message() 从翻转 v 后的 (r, n − s) 中恢复出了签名者。

  检查记录

  fact ecdsa-low-s-verify = accepts-high-s
  evidence ecdsa-low-s-verify: recover_message on (r, n - s, flipped v): the signer

• 接受的签名形式

  v-27-28v-0-1

  v = 27/28 或 v = 0/1 的 65 字节签名都能恢复出签名者；64 字节的 EIP-2098 形式抛出 ValidationError: Unexpected recoverable signature length: Expected 65, but got 64 bytes。

  检查记录

  fact signature-input-shapes = v-27-28, v-0-1
  evidence signature-input-shapes: v-27-28: recovers the signer
  evidence signature-input-shapes: v-0-1: recovers the signer
  evidence signature-input-shapes: eip-2098: ValidationError: Unexpected recoverable signature length: Expected 65, but got 64 bytes

• ECDSA 曲线

  secp256k1

  仅支持 secp256k1。

  检查记录

  fact ecdsa-curves = secp256k1

• EdDSA

  none

  不支持 EdDSA。

  检查记录

  fact eddsa = none

• 后量子算法

  none

  不支持后量子算法。

  检查记录

  fact pqc = none

用法

from eth_account import Account
from eth_account.messages import encode_defunct

account = Account.create()
message = encode_defunct(text="Sign in to example.com\nNonce: 8f2c1a")

# personal_sign: EIP-191 prefix + keccak-256, RFC 6979, low-S, v = 27 or 28.
signed = account.sign_message(message)

# Recover and compare addresses; checksummed strings compare exactly.
signer = Account.recover_message(message, signature=signed.signature)
print("signature bytes:", len(signed.signature), "v:", signed.v)
print("signer matches:", signer == account.address)