Skip to content

Stamp via CLI

Get your first timestamp in under 5 minutes.

Prerequisites

  • Rust Nightly
  • A file to timestamp

Install the CLI

bash
cargo install uts-cli --version 0.1.0-alpha.0 --locked

Or build from source:

bash
git clone https://github.com/lightsing/uts.git
cd uts
cargo install --path crates/cli

Timestamp a File

bash
uts stamp myfile.txt

This creates myfile.txt.ots containing a pending timestamp proof.

Note:

The pending timestamp cannot prove the existence of the file, and relies on the liveness of the calendar server to retrieve the full proof later.

Upgrade the Timestamp

Wait for the calendar server to attest the batch on-chain (usually ~10 seconds), then run:

bash
uts upgrade myfile.txt.ots

This command retrieves the full self-contained proof.

Note:

Due to the privacy-preserving design of UTS, the calendar server does not associate the file hash with the timestamp proof.

Before the UIP-1 upgrade, the loss of the .ots file means permanent loss of the timestamp proof.

Always keep a backup of the .ots file if it's important to you.

Verify the Timestamp

bash
uts verify myfile.txt

The command checks the file with the upgraded proof and confirms if the timestamp is valid.

Next Steps

Released under the MIT License.