Skip to main content

Module identity

dotscope::metadata

Module identity 

Expand description

Assembly identity and cryptographic verification system Assembly identity and cryptographic verification for .NET assemblies.

This module provides comprehensive identity management for .NET assemblies, supporting both cryptographic verification and multi-assembly identification. It serves as the foundation for cross-assembly resolution, dependency tracking, and multi-assembly project management.

§ECMA-335 References

This module implements identity concepts defined in the ECMA-335 specification:

  • Section II.6.3: Referencing assemblies - defines assembly reference format
  • Section II.22.2: Assembly table - defines assembly metadata structure
  • Section II.22.5: AssemblyRef table - defines assembly reference structure
  • Section II.6.2.1.3: PublicKeyToken - defines public key token computation

See: https://ecma-international.org/publications-and-standards/standards/ecma-335/

§Module Structure

  • assembly - Complete assembly identity with name, version, culture, and strong name
  • cryptographic - Cryptographic identity and verification (public keys and tokens)

§Key Components

§Assembly Identity

§Cryptographic Identity

  • Identity - Public key and token-based cryptographic identity
  • Strong name verification and token generation
  • Support for MD5, SHA1, and custom hash algorithms

§Usage Examples

§Assembly Identity Management

use dotscope::metadata::identity::{AssemblyIdentity, AssemblyVersion};

// Create assembly identity
let identity = AssemblyIdentity::new(
    "MyLibrary",
    AssemblyVersion::new(1, 0, 0, 0),
    None, // culture-neutral
    None, // no strong name
    None, // architecture-neutral
);

// Parse from display name
let mscorlib = AssemblyIdentity::parse(
    "mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
)?;

§Cryptographic Verification

use dotscope::metadata::identity::Identity;
use dotscope::metadata::tables::AssemblyHashAlgorithm;

// Create identity from public key
let pubkey_data = vec![0x30, 0x82, 0x01, 0x0A]; // RSA public key
let identity = Identity::from(&pubkey_data, true)?;

// Generate public key token
let token = identity.to_token(AssemblyHashAlgorithm::SHA1)?;
println!("Public key token: 0x{:016X}", token);

§Integration with Metadata

ⓘ
use dotscope::metadata::identity::AssemblyIdentity;
use dotscope::metadata::tables::AssemblyRef;

// Extract identity from metadata
let assembly_ref: AssemblyRef = // ... loaded from metadata
let identity = AssemblyIdentity::from_assembly_ref(&assembly_ref);

// Use in dependency tracking
let dependency_graph = AssemblyDependencyGraph::new();
dependency_graph.add_dependency(source_identity, target_identity);

§Integration with CilProject

This identity system provides the foundation for:

  • Multi-assembly containers in CilProject
  • Cross-assembly type resolution in GlobalTypeResolver
  • Dependency tracking and analysis in AssemblyDependencyGraph
  • Version binding and compatibility analysis
  • Assembly loading and management strategies

§Thread Safety

All types in this module are thread-safe and can be safely shared across threads. Assembly identities serve as keys in concurrent collections and participate in lock-free data structures throughout the system.

Structs§

AssemblyIdentity
Complete identity information for a .NET assembly.
AssemblyVersion
Four-part version numbering for .NET assemblies.

Enums§

Identity
Assembly identity representation for .NET CIL assemblies.
ProcessorArchitecture
Processor architecture specification for .NET assemblies.