/ console / program / src / data / record / find.rs
find.rs
 1  // Copyright (c) 2019-2025 Alpha-Delta Network Inc.
 2  // This file is part of the alphavm library.
 3  
 4  // Licensed under the Apache License, Version 2.0 (the "License");
 5  // you may not use this file except in compliance with the License.
 6  // You may obtain a copy of the License at:
 7  
 8  // http://www.apache.org/licenses/LICENSE-2.0
 9  
10  // Unless required by applicable law or agreed to in writing, software
11  // distributed under the License is distributed on an "AS IS" BASIS,
12  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  // See the License for the specific language governing permissions and
14  // limitations under the License.
15  
16  use super::*;
17  
18  impl<N: Network> Record<N, Plaintext<N>> {
19      /// Returns the entry from the given path.
20      pub fn find<A: Into<Access<N>> + Copy + Debug>(&self, path: &[A]) -> Result<Entry<N, Plaintext<N>>> {
21          // If the path is of length one, check if the path is requesting the `owner`.
22          if path.len() == 1 && path[0].into() == Access::Member(Identifier::from_str("owner")?) {
23              return Ok(self.owner.to_entry());
24          }
25  
26          // Ensure the path is not empty.
27          if let Some((first, rest)) = path.split_first() {
28              let first = match (*first).into() {
29                  Access::Member(identifier) => identifier,
30                  Access::Index(_) => bail!("Attempted to index into a record"),
31              };
32              // Retrieve the top-level entry.
33              match self.data.get(&first) {
34                  Some(entry) => match rest.is_empty() {
35                      // If the remaining path is empty, return the top-level entry.
36                      true => Ok(entry.clone()),
37                      // Otherwise, recursively call `find` on the top-level entry.
38                      false => entry.find(rest),
39                  },
40                  None => bail!("Record entry `{first}` not found."),
41              }
42          } else {
43              bail!("Attempted to find record entry with an empty path.")
44          }
45      }
46  }