snarkvm-console-program 4.6.1

Program operations for a decentralized virtual machine
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
95
96

// Copyright (c) 2019-2026 Provable Inc.
// This file is part of the snarkVM library.

// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at:

// http://www.apache.org/licenses/LICENSE-2.0

// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

use super::*;

impl<N: Network> ToBits for Future<N> {
    /// Returns the future as a list of **little-endian** bits.
    // Note: Any updates to bit serialization will require updating `FinalizeType::future_size_in_bits`.
    #[inline]
    fn write_bits_le(&self, vec: &mut Vec<bool>) {
        // Write the bits for the program ID.
        let program_id_bits = self.program_id.to_bits_le();
        u16::try_from(program_id_bits.len()).or_halt_with::<N>("Program ID exceeds u16::MAX bits").write_bits_le(vec);
        vec.extend_from_slice(&program_id_bits);

        // Write the bits for the function name.
        let function_name_bits = self.function_name.to_bits_le();
        u16::try_from(function_name_bits.len())
            .or_halt_with::<N>("Function name exceeds u16::MAX bits")
            .write_bits_le(vec);
        vec.extend_from_slice(&function_name_bits);

        // Write the number of arguments.
        u8::try_from(self.arguments.len()).or_halt_with::<N>("arguments exceed u8::MAX").write_bits_le(vec);

        // Write the arguments.
        for argument in &self.arguments {
            let argument_bits = argument.to_bits_le();

            // Write the size of the argument.
            let argument_length = argument_bits.len();
            match argument_length <= u16::MAX as usize {
                true => u16::try_from(argument_length)
                    .or_halt_with::<N>("argument exceeds u16::MAX bits")
                    .write_bits_le(vec),
                false => u32::try_from(argument_length)
                    .or_halt_with::<N>("argument exceeds u32::MAX bits")
                    .write_bits_le(vec),
            }

            // Write the argument.
            vec.extend_from_slice(&argument_bits);
        }
    }

    /// Returns the future as a list of **big-endian** bits.
    // Note: Any updates to bit serialization will require updating `FinalizeType::future_size_in_bits`.
    #[inline]
    fn write_bits_be(&self, vec: &mut Vec<bool>) {
        // Write the bits for the program ID.
        let program_id_bits = self.program_id.to_bits_be();
        u16::try_from(program_id_bits.len()).or_halt_with::<N>("Program ID exceeds u16::MAX bits").write_bits_be(vec);
        vec.extend_from_slice(&program_id_bits);

        // Write the bits for the function name.
        let function_name_bits = self.function_name.to_bits_be();
        u16::try_from(function_name_bits.len())
            .or_halt_with::<N>("Function name exceeds u16::MAX bits")
            .write_bits_be(vec);
        vec.extend_from_slice(&function_name_bits);

        // Write the number of arguments.
        u8::try_from(self.arguments.len()).or_halt_with::<N>("arguments exceed u8::MAX").write_bits_be(vec);

        // Write the arguments.
        for argument in &self.arguments {
            let argument_bits = argument.to_bits_be();

            // Write the size of the argument.
            let argument_length = argument_bits.len();
            match argument_length <= u16::MAX as usize {
                true => u16::try_from(argument_length)
                    .or_halt_with::<N>("argument exceeds u16::MAX bits")
                    .write_bits_be(vec),
                false => u32::try_from(argument_length)
                    .or_halt_with::<N>("argument exceeds u32::MAX bits")
                    .write_bits_be(vec),
            }

            // Write the argument.
            vec.extend_from_slice(&argument_bits);
        }
    }
}