File: _eip712_certificate_chain.py

package info (click to toggle)
python-autobahn 22.7.1%2Bdfsg1-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 8,404 kB
  • sloc: python: 38,356; javascript: 2,705; makefile: 905; ansic: 371; sh: 63
file content (119 lines) | stat: -rw-r--r-- 5,273 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
###############################################################################
#
# The MIT License (MIT)
#
# Copyright (c) Crossbar.io Technologies GmbH
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
# THE SOFTWARE.
#
###############################################################################

from binascii import a2b_hex
from typing import List, Tuple, Dict, Any, Union

from autobahn.xbr._eip712_delegate_certificate import EIP712DelegateCertificate
from autobahn.xbr._eip712_authority_certificate import EIP712AuthorityCertificate


def parse_certificate_chain(certificates: List[Tuple[Dict[str, Any], str]]) \
        -> List[Union[EIP712DelegateCertificate, EIP712AuthorityCertificate]]:
    """

    :param certificates:
    :return:
    """
    # parse the whole certificate chain
    cert_chain = []
    cert_sigs = []
    for cert_data, cert_sig in certificates:
        if cert_data['primaryType'] == 'EIP712DelegateCertificate':
            cert = EIP712DelegateCertificate.parse(cert_data['message'])
        elif cert_data['primaryType'] == 'EIP712AuthorityCertificate':
            cert = EIP712AuthorityCertificate.parse(cert_data['message'])
        else:
            assert False, 'should not arrive here'
        cert_chain.append(cert)
        cert_sigs.append(cert_sig)

    # FIXME: allow length 2 and length > 3
    assert len(cert_chain) == 3

    # Certificate Chain Rules (CCR):
    #
    # 1. **CCR-1**: The `chainId` and `verifyingContract` must match for all certificates to what we expect, and `validFrom` before current block number on the respective chain.
    # 2. **CCR-2**: The `realm` must match for all certificates to the respective realm.
    # 3. **CCR-3**: The type of the first certificate in the chain must be a `EIP712DelegateCertificate`, and all subsequent certificates must be of type `EIP712AuthorityCertificate`.
    # 4. **CCR-4**: The last certificate must be self-signed (`issuer` equals `subject`), it is a root CA certificate.
    # 5. **CCR-5**: The intermediate certificate's `issuer` must be equal to the `subject` of the previous certificate.
    # 6. **CCR-6**: The root certificate must be `validFrom` before the intermediate certificate
    # 7. **CCR-7**: The `capabilities` of intermediate certificate must be a subset of the root cert
    # 8. **CCR-8**: The intermediate certificate's `subject` must be the delegate certificate `delegate`
    # 9. **CCR-9**: The intermediate certificate must be `validFrom` before the delegate certificate
    # 10. **CCR-10**: The root certificate's signature must be valid and signed by the root certificate's `issuer`.
    # 11. **CCR-11**: The intermediate certificate's signature must be valid and signed by the intermediate certificate's `issuer`.
    # 12. **CCR-12**: The delegate certificate's signature must be valid and signed by the `delegate`.

    # CCR-1
    chainId = 1
    verifyingContract = a2b_hex('0xf766Dc789CF04CD18aE75af2c5fAf2DA6650Ff57'[2:])
    for cert in cert_chain:
        assert cert.chainId == chainId
        assert cert.verifyingContract == verifyingContract

    # CCR-2
    realm = a2b_hex('0xA6e693CC4A2b4F1400391a728D26369D9b82ef96'[2:])
    for cert in cert_chain[1:]:
        assert cert.realm == realm

    # CCR-3
    assert isinstance(cert_chain[0], EIP712DelegateCertificate)
    for i in [1, len(cert_chain) - 1]:
        assert isinstance(cert_chain[i], EIP712AuthorityCertificate)

    # CCR-4
    assert cert_chain[2].subject == cert_chain[2].issuer

    # CCR-5
    assert cert_chain[1].issuer == cert_chain[2].subject

    # CCR-6
    assert cert_chain[2].validFrom <= cert_chain[1].validFrom

    # CCR-7
    assert cert_chain[2].capabilities == cert_chain[2].capabilities | cert_chain[1].capabilities

    # CCR-8
    assert cert_chain[1].subject == cert_chain[0].delegate

    # CCR-9
    assert cert_chain[1].validFrom <= cert_chain[0].validFrom

    # CCR-10
    _issuer = cert_chain[2].recover(a2b_hex(cert_sigs[2]))
    assert _issuer == cert_chain[2].issuer

    # CCR-11
    _issuer = cert_chain[1].recover(a2b_hex(cert_sigs[1]))
    assert _issuer == cert_chain[1].issuer

    # CCR-12
    _issuer = cert_chain[0].recover(a2b_hex(cert_sigs[0]))
    assert _issuer == cert_chain[0].delegate

    return cert_chain