claimchain 0.3.1

构建链

ClaimChain用户的核心抽象是状态。该状态包含有关用户及其对其他用户或对象所做的声明的信息。目前，此包仅支持私有声明，这意味着链的所有者需要明确使每个声明可供预期读者阅读。一旦构建了状态，就可以将其提交到链中。

以下是如何用户 Alice 准备她的 状态

from claimchain import State

state = State()

# Alice adds information about herself
state.identity_info = "Hi, I'm Alice"

# Alice adds private claims
state['bob'] = 'Bob is a good lad'

使声明可访问需要知道每个授权读者的DH公钥。其他用户的DH密钥获取方式将在后面描述。假设Alice有Carol的DH公钥carol_dh_pk，她可以允许Carol访问她对Bob的声明

state.grant_access(carol_dh_pk, ['bob'])

请注意，第二个参数必须是一个声明标签的可迭代对象，而不是单个标签。

要提交状态，首先需要构建一个链，其次需要生成加密密钥

from hippiehug import Chain
from claimchain import LocalParams, State

state = State()

# Generate cryptographic keys
params = LocalParams.generate()

store = {}
chain = Chain(store)

with params.as_default():
    head = state.commit(chain)

然后可以通过发布存储和通信链的头来发布或传输链到其他用户。其他用户将能够使用下面的View接口来解释链。

解释链

拥有包含其他用户链的存储（字典）以及该用户链的头的访问权限，可以使用View接口。

以下是Carol如何解释Alice的声明链，假设Alice的存储是alice_store，她的链头是alice_head，而params是Carol的LocalParams对象

from hippiehug import Chain
from claimchain import View

alice_chain = Chain(alice_store, root_hash=alice_head)

with params.as_default():
    alice_view = View(alice_chain)

    # Try to get claim with label 'bob'
    claim = alice_view['bob']

    assert claim == b'Bob is a good lad'

最后，这是Carol如何检索Alice的DH公钥

alice_dh_pk = alice_view.params.dh.pk

此DH公钥可以用来授予Alice在Carol链上读取声明的权限。