ubl-types

Shared canonical types for Universal Business Ledger (UBL).

Note: UBL = Universal Business Ledger (not OASIS Universal Business Language).

Features

Identity Types

• AppId, TenantId, NodeId, ActorId, TraceId — String-based newtypes with Display/FromStr
• Dim — Protocol dimension (u16) with hex/decimal parsing

Cryptographic Primitives

• Cid32 — 32-byte content ID (BLAKE3) with hex serialization
• PublicKeyBytes — 32-byte Ed25519 public key
• SignatureBytes — 64-byte Ed25519 signature
• Intent — Textual intent with canonical bytes (whitespace-insensitive)

Error Types

• AtomError — Shared basic errors

Installation

[dependencies]
ubl-types = "0.1"

# Optional features
ubl-types = { version = "0.1", features = ["ulid", "strict"] }

Quick Example

use ubl_types::{Cid32, Dim, Intent, AppId};
use core::str::FromStr;

// Dimension parsing
let dim = Dim::parse("0x00A1").unwrap();
assert_eq!(dim.as_u16(), 161);

// CID with hex serialization
let cid = Cid32([0xAB; 32]);
println!("cid = {cid}"); // lowercase hex

// Intent normalization (whitespace-insensitive)
let i1 = Intent::from_raw("  hello   world ");
let i2 = Intent::from_raw("hello world");
assert_eq!(i1.as_bytes(), i2.as_bytes());

// Identity newtypes
let app = AppId::from_str("my-app").unwrap();
println!("app = {app}");

Feature Flags

License

MIT OR Apache-2.0 © LogLine Foundation