密码学相关函数

密码学相关的函数在crypto.codon中定义，可以通过像下面的方式导入：

from chain.crypto import sha256

或者只导入crypto模块：

from chain import crypto

然后通过像crypto.sha256的方式来调用内部函数。

sha256

sha256算法hash函数

def sha256(data: bytes) -> Checksum256:

用于检测hash256值是否正常，不正确会直接抛出异常

def assert_sha256(data: bytes, hash: Checksum256):

sha1

sha1算法hash函数

def sha1(data: bytes) -> Checksum160:

用于检测sha1 hash值是否正常，不正确会直接抛出异常

def assert_sha1(data: bytes, hash: Checksum160):

sha512

sha512算法hash函数

def sha512(data: bytes) -> Checksum512:

用于检测hash512值是否正常，不正确会直接抛出异常

def assert_sha512(data: bytes, hash: Checksum512):

ripemd160

ripemd160算法hash函数

def ripemd160(data: bytes) -> Checksum160:

用于检测ripemd160算法的hash值是否正常，不正确会直接抛出异常

def assert_ripemd160(data: bytes, hash: Checksum160):

recover_key

用于从digest和signture中恢复出公钥

def recover_key(digest: Checksum256, sig: Signature) -> PublicKey:

检查签名是否正常，不正常会抛出异常

def assert_recover_key(digest: Checksum256, sig: Signature, pub: PublicKey):

示例：

# crypto_example.codon
from chain.contract import Contract
from chain.crypto import sha256, assert_sha256, sha512, assert_sha512, sha1, assert_sha1, ripemd160, assert_ripemd160
from chain.crypto import recover_key, assert_recover_key
from chain.crypto import Signature, Checksum256, PublicKey

@contract(main=True)
class MyContract(Contract):

    def __init__(self):
        super().__init__()

    @action('testcrypto')
    def test_crypto(self):
        assert_sha256(b"hello", sha256(b"hello"))
        assert_sha1(b"hello", sha1(b"hello"))
        assert_sha512(b"hello", sha512(b"hello"))
        assert_ripemd160(b"hello", ripemd160(b"hello"))

    @action('testrecover')
    def test_recover(self, msg: bytes, digest: Checksum256, sig: Signature, k1: PublicKey):
        _digest = sha256(msg)
        assert _digest == digest
        _pubkey = recover_key(digest, sig)
        assert _pubkey == k1, "_pubkey == k1"
        assert_recover_key(digest, sig, k1)
        print('done!')

测试代码：

def test_crypto():
    t = init_test('crypto_example')
    args = {}
    ret = t.push_action('hello', 'testcrypto', args, {'hello': 'active'})
    t.produce_block()
    logger.info("++++++++++%s\n", ret['elapsed'])

def test_recover():
    t = init_test('crypto_example')

    msg = b'hello,world'
    # key pair
    public_key = 'EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV'
    private_key = '5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3'

    h = hashlib.sha256()
    h.update(msg)
    digest = h.hexdigest()
    logger.info('++++digest: %s', digest)

    #sign with private key
    sig = eosapi.sign_digest(digest, private_key)
    logger.info('++++signature: %s', sig)
    args = {
        "msg": msg.hex(),
        "digest": digest,
        "sig": sig,
        "k1": public_key,
    }
    ret = t.push_action('hello', 'testrecover', args, {'hello': 'active'})
    t.produce_block()
    logger.info("++++++++++%s\n", ret['elapsed'])

编译：

python-contract build crypto_example.codon

测试：

ipyeos -m pytest -s -x test.py -k test_crypto
ipyeos -m pytest -s -x test.py -k test_recover

在这个示例代码中，分别演示了常用的hash函数的用法以及recover_key和assert_recover_key的用法。hash函数的用法比较简单，这里解释一下recover_key的测试代码： recover_key接受二个参数，分别是digest和signature，digest是对一个二进制数据进行sha256运行的结果。在上面的代码中是通过对hello,world进行sha256算法的hash计算。

h = hashlib.sha256()
h.update(b'hello,world')
digest = h.hexdigest()

运算出的结果作为参数传给action.

下面是对testrecover的解释：

@action('testrecover')
def test_recover(self, msg: bytes, digest: Checksum256, sig: Signature, k1: PublicKey):
    _digest = sha256(msg)
    assert _digest == digest #判断digest是否对msg进行hash256算法的hash结果
    _pubkey = recover_key(digest, sig)
    assert _pubkey == k1, "_pubkey == k1" #判断public key是否正确

    assert_recover_key(digest, sig, k1) #作用相当于上面两行代码
    print('done!')

在发送的Transaction中也是需要包含用户对Transaction的签名的，以表示用户授权了这个Transaction。然后在智能合约，就可以调用的require_auth函数来判断Transaction是否进行过特定用户的授权。

在实际的智能合约的应用中，如果要在智能合约里判断某段二进制数据是否是用特定的私钥进行的签名也可以用上面的办法。过程如下：

首先用户用自己的私钥对数据进行签名
用户将数据，签名，公钥（注意这里不是私钥）传给智能合约
智能合约即可判断数据是否是用特别的私钥签的名，并进行相应的操作。