linera-rpc 0.15.13

RPC schemas and networking library for the Linera protocol.
Documentation 
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

// Copyright (c) Facebook, Inc. and its affiliates.
// Copyright (c) Zefchain Labs, Inc.
// SPDX-License-Identifier: Apache-2.0

use linera_base::{
    crypto::{AccountPublicKey, AccountSignature, CryptoHash, TestString},
    data_types::{BlobContent, ChainDescription, ChainOrigin, OracleResponse, Round},
    identifiers::{Account, AccountOwner, BlobType, GenericApplicationId},
    ownership::ChainOwnership,
    vm::VmRuntime,
};
use linera_chain::{
    data_types::{MessageAction, OriginalProposal, Transaction},
    manager::{ChainManagerInfo, LockingBlock},
    types::{Certificate, CertificateKind, ConfirmedBlock, Timeout, ValidatedBlock},
};
use linera_core::{data_types::CrossChainRequest, node::NodeError};
use linera_execution::{
    system::{AdminOperation, SystemMessage, SystemOperation},
    Message, MessageKind, Operation,
};
use linera_rpc::RpcMessage;
use serde_reflection::{Registry, Result, Samples, Tracer, TracerConfig};

fn get_registry() -> Result<Registry> {
    let mut tracer = Tracer::new(
        TracerConfig::default()
            .record_samples_for_newtype_structs(true)
            .record_samples_for_tuple_structs(true),
    );
    let mut samples = Samples::new();
    // 1. Record samples for types with custom deserializers.
    {
        // Record sample values for Secp256k1PublicKey and Secp256k1Signature
        // as the ones generated by serde-reflection are not valid and will fail.
        let validator_keypair = linera_base::crypto::ValidatorKeypair::generate();
        let validator_signature = linera_base::crypto::ValidatorSignature::new(
            &TestString::new("signature".to_string()),
            &validator_keypair.secret_key,
        );
        tracer.trace_value(&mut samples, &validator_keypair.public_key)?;
        tracer.trace_value(&mut samples, &validator_signature)?;

        // We also record separate samples for EVM-compatible keys,
        // as the generated ones are not valid.
        let evm_secret_key = linera_base::crypto::EvmSecretKey::generate();
        let evm_public_key = evm_secret_key.public();
        tracer.trace_value(&mut samples, &evm_public_key)?;
        let evm_signature = linera_base::crypto::EvmSignature::new(
            CryptoHash::new(&TestString::new("signature".to_string())),
            &evm_secret_key,
        );
        tracer.trace_value(&mut samples, &evm_signature)?;
    }
    // 2. Trace the main entry point(s) + every enum separately.
    tracer.trace_type::<AccountPublicKey>(&samples)?;
    tracer.trace_type::<AccountSignature>(&samples)?;
    tracer.trace_type::<Round>(&samples)?;
    tracer.trace_type::<OracleResponse>(&samples)?;
    tracer.trace_type::<Account>(&samples)?;
    tracer.trace_type::<SystemOperation>(&samples)?;
    tracer.trace_type::<AdminOperation>(&samples)?;
    tracer.trace_type::<SystemMessage>(&samples)?;
    tracer.trace_type::<Operation>(&samples)?;
    tracer.trace_type::<Message>(&samples)?;
    tracer.trace_type::<Transaction>(&samples)?;
    tracer.trace_type::<OriginalProposal>(&samples)?;
    tracer.trace_type::<VmRuntime>(&samples)?;
    tracer.trace_type::<MessageAction>(&samples)?;
    tracer.trace_type::<MessageKind>(&samples)?;
    tracer.trace_type::<CertificateKind>(&samples)?;
    tracer.trace_type::<Certificate>(&samples)?;
    tracer.trace_type::<ConfirmedBlock>(&samples)?;
    tracer.trace_type::<ValidatedBlock>(&samples)?;
    tracer.trace_type::<Timeout>(&samples)?;
    tracer.trace_type::<ChainDescription>(&samples)?;
    tracer.trace_type::<ChainOrigin>(&samples)?;
    tracer.trace_type::<ChainOwnership>(&samples)?;
    tracer.trace_type::<GenericApplicationId>(&samples)?;
    tracer.trace_type::<LockingBlock>(&samples)?;
    tracer.trace_type::<ChainManagerInfo>(&samples)?;
    tracer.trace_type::<CrossChainRequest>(&samples)?;
    tracer.trace_type::<NodeError>(&samples)?;
    tracer.trace_type::<RpcMessage>(&samples)?;
    tracer.trace_type::<BlobType>(&samples)?;
    tracer.trace_type::<BlobContent>(&samples)?;
    tracer.trace_type::<AccountOwner>(&samples)?;
    tracer.registry()
}

#[test]
fn test_format() {
    insta::assert_yaml_snapshot!("format.yaml", get_registry().unwrap());
}