UTS Cli Tool

Quick Start

1. Create a Timestamp (stamp)

Submit files to remote calendar servers for initial attestation:

# Timestamp one or more files
uts stamp file1.txt file2.zip

# Specify custom calendars and a quorum requirement
uts stamp -c https://calendar.example.com -m 1 document.pdf

# Use a specific hashing algorithm
uts stamp --hasher sha256 photo.jpg

This will create a corresponding .ots proof file (e.g., document.pdf.ots).

2. Upgrade a Proof (upgrade)

Initial proofs are often "pending." Once the calendar server commits the Merkle root to a blockchain, you must upgrade the proof to include the full path to the block:

uts upgrade document.pdf.ots

3. Verify a Proof (verify)

Verify that a file matches its timestamp proof and check the attestation status on the calendar or blockchain:

# Automatically finds the matching .ots file
uts verify document.pdf

# Specify an Ethereum RPC provider for on-chain verification
uts verify document.pdf --eth-provider https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY

4. Inspect a Proof (inspect)

View the internal structure, opcodes, and attestation paths of an .ots file in a human-readable format:

uts inspect document.pdf.ots

Command Reference

stamp

verify