Struct LicenseParser 

pub struct LicenseParser { /* private fields */ }

Parser for loading and verifying signed licenses.

The parser takes a public key and uses it to verify license signatures. Only licenses signed by the corresponding private key will be accepted.

Security

The parser only accepts licenses with valid signatures. Any tampering with the license payload will cause signature verification to fail.

Example

use rust_license_key::parser::LicenseParser;
use rust_license_key::crypto::PublicKey;

// The public key embedded in your application
let public_key_base64 = "..."; // Your public key here

// In a real application:
// let public_key = PublicKey::from_base64(public_key_base64).unwrap();
// let parser = LicenseParser::new(public_key);
// let license = parser.parse_json(&license_file_contents).unwrap();

Implementations

impl LicenseParser

pub fn new(public_key: PublicKey) -> Self

Creates a new license parser with the given public key.

Arguments

• public_key - The publisher’s public key for signature verification.

pub fn from_public_key_base64(public_key_base64: &str) -> Result<Self>

Creates a new license parser from a base64-encoded public key.

Arguments

• public_key_base64 - The base64-encoded public key string.

Errors

Returns an error if the public key is invalid or malformed.

pub fn parse_json(&self, json: &str) -> Result<LicensePayload>

Parses a signed license from a JSON string.

This method:

1. Parses the JSON structure.
2. Verifies the cryptographic signature.
3. Decodes the license payload.
4. Validates the license format version.

Arguments

• json - The JSON string containing the signed license.

Returns

The verified and decoded license payload.

Errors

Returns an error if:

• The JSON is malformed.
• The signature is invalid.
• The payload cannot be decoded.
• The license version is not supported.

pub fn parse_signed_license( &self, signed_license: &SignedLicense, ) -> Result<LicensePayload>

Parses a SignedLicense structure directly.

Use this when you already have a SignedLicense object, for example from custom deserialization logic.

Arguments

• signed_license - The signed license to verify and decode.

Returns

The verified and decoded license payload.

pub fn decode_unverified(&self, json: &str) -> Result<(LicensePayload, bool)>

Attempts to decode a license without signature verification.

Warning

This method bypasses security and should only be used for debugging or inspection purposes. Never use the returned payload for access control decisions.

Arguments

• json - The JSON string containing the signed license.

Returns

The decoded payload and a boolean indicating if the signature was valid.

pub fn public_key(&self) -> &PublicKey

Returns a reference to the parser’s public key.

Trait Implementations

impl Clone for LicenseParser

fn clone(&self) -> LicenseParser

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LicenseParser

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.