签名消息和结构化数据

签名消息和结构化数据#

点击顶部栏的 🚀 -> Binder 即可在线运行此示例!

在以太坊中,建议遵循 EIP-712 来签名数据和验证签名,而在 Conflux 中,我们遵循 CIP-23 来进行数据的签名和验证。

数据的签名和验证方式与 eth-account 保持一致,以下是示例

签名消息#

from cfx_account import Account
from cfx_account.messages import encode_defunct

message = "Hello World"

acct = Account.create()

# message should be preprocessed before signing
signable_message = encode_defunct(text=message)
# sign
signed = acct.sign_message(signable_message)

# verify signature
assert acct.address == Account.recover_message(signable_message, signature=signed.signature)

签名结构化数据#

如下所示,typed_data 是一个由 CIP-23 定义的结构化数据示例。与 EIP-712 的要求相比,主要区别在于字段 EIP712Domain 被替换为 CIP23Domain,且 domain 字段中的 chainId 是必需的而不是可选的。

from cfx_account.messages import encode_structured_data

typed_data = {
    "types": {
        "CIP23Domain": [
            {
                "name": "name",
                "type": "string"
            },
            {
                "name": "version",
                "type": "string"
            },
            {
                "name": "chainId",
                "type": "uint256"
            },
            {
                "name": "verifyingContract",
                "type": "address"
            }
        ],
        "Person": [
            {
                "name": "name",
                "type": "string"
            },
            {
                "name": "wallet",
                "type": "address"
            }
        ],
        "Mail": [
            {
                "name": "from",
                "type": "Person"
            },
            {
                "name": "to",
                "type": "Person"
            },
            {
                "name": "contents",
                "type": "string"
            }
        ]
    },
    "primaryType": "Mail",
    "domain": {
        "name": "Ether Mail",
        "version": "1",
        "chainId": 1,
        "verifyingContract": "0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC"
    },
    "message": {
        "from": {
            "name": "Cow",
            "wallet": "0xCD2a3d9F938E13CD947Ec05AbC7FE734Df8DD826"
        },
        "to": {
            "name": "Bob",
            "wallet": "0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB"
        },
        "contents": "Hello, Bob!"
    }
}

# preprocess structured data
signable_message = encode_structured_data(primitive=typed_data)
# sign
signed = acct.sign_message(signable_message)

# verify signature
assert acct.address == Account.recover_message(signable_message, signature=signed.signature)