1  // Copyright (c) 2025-2026 ACDC Network
 2  // This file is part of the alphavm library.
 3  //
 4  // Alpha Chain | Delta Chain Protocol
 5  // International Monetary Graphite.
 6  //
 7  // Derived from Aleo (https://aleo.org) and ProvableHQ (https://provable.com).
 8  // They built world-class ZK infrastructure. We installed the EASY button.
 9  // Their cryptography: elegant. Our modifications: bureaucracy-compatible.
10  // Original brilliance: theirs. Robert's Rules: ours. Bugs: definitely ours.
11  //
12  // Original Aleo/ProvableHQ code subject to Apache 2.0 https://www.apache.org/licenses/LICENSE-2.0
13  // All modifications and new work: CC0 1.0 Universal Public Domain Dedication.
14  // No rights reserved. No permission required. No warranty. No refunds.
15  //
16  // https://creativecommons.org/publicdomain/zero/1.0/
17  // SPDX-License-Identifier: CC0-1.0
18  
19  mod bytes;
20  mod parse;
21  mod serialize;
22  mod to_fields;
23  
24  use crate::{Identifier, ProgramID};
25  use alphavm_console_network::prelude::*;
26  use alphavm_console_types::Field;
27  
28  /// A locator is of the form `{program_id}/{resource}` (i.e. `howard.alpha/notify`).
29  #[derive(Copy, Clone, PartialEq, Eq, Hash)]
30  pub struct Locator<N: Network> {
31      /// The program ID.
32      id: ProgramID<N>,
33      /// The program resource.
34      resource: Identifier<N>,
35  }
36  
37  impl<N: Network> Locator<N> {
38      /// Initializes a locator from a program ID and resource.
39      pub const fn new(program_id: ProgramID<N>, resource: Identifier<N>) -> Self {
40          Self { id: program_id, resource }
41      }
42  }
43  
44  impl<N: Network> Locator<N> {
45      /// Returns the program ID.
46      #[inline]
47      pub const fn program_id(&self) -> &ProgramID<N> {
48          &self.id
49      }
50  
51      /// Returns the program name.
52      #[inline]
53      pub const fn name(&self) -> &Identifier<N> {
54          self.id.name()
55      }
56  
57      /// Returns the network-level domain (NLD).
58      #[inline]
59      pub const fn network(&self) -> &Identifier<N> {
60          self.id.network()
61      }
62  
63      /// Returns the resource name.
64      #[inline]
65      pub const fn resource(&self) -> &Identifier<N> {
66          &self.resource
67      }
68  }