CLI Client

Stamp from your terminal.
Zero browser trust required.

Open source, ~300 lines of C. Your file never touches a network — only the cryptographic commitment is transmitted. Read every line before you compile.

🔒
Privacy model: commitment = SHA256( SHA256(file) || nonce ) — the file and nonce never leave your machine. Only the 64-character hex commitment is sent to the server.

Install dependencies

DependencyUbuntu / DebianArchmacOS (Homebrew)
GCCbuild-essentialbase-develXcode CLT
OpenSSLlibssl-devopensslopenssl
libcurllibcurl4-openssl-devcurlcurl
libqrencodelibqrencode-devqrencodeqrencode
Ubuntu / Debian
sudo apt update
sudo apt install build-essential libssl-dev libcurl4-openssl-dev libqrencode-dev
Arch Linux
sudo pacman -S base-devel openssl curl qrencode
macOS
xcode-select --install
brew install openssl curl qrencode

Build

Place client.c and Makefile in the same directory, then:

terminal
make

To install system-wide:

terminal
sudo make install
# binary installed to /usr/local/bin/xrpl-timestamp

Usage

1

Stamp a file

Hashes your file locally, generates a random nonce, submits only the commitment to the server, and waits for your 1 XRP payment via Xaman.

terminal
./xrpl-timestamp stamp contract.pdf
✓ Receipt saved as contract.pdf.receipt.json
2

Verify a file

Recomputes the commitment from the file and the nonce in the receipt. Works entirely offline — no network call.

terminal
./xrpl-timestamp verify contract.pdf contract.pdf.receipt.json
✓ RESULT: MATCH — commitment is valid
3

Check job status

Useful if the client was interrupted after payment but before the receipt was saved.

terminal
./xrpl-timestamp status 42

Receipt format

Saved automatically as <file>.receipt.json when the stamp completes.

{
  "tx_hash": "ABCD…",  // verify at livenet.xrpl.org
  "nonce": "9c1d…",  // 32 random bytes — keep secret
  "commitment": "a3f8…",  // what was anchored on-chain
  "file_name": "contract.pdf"
}

To prove existence you need three things: the original file (unmodified), this receipt JSON, and the XRPL transaction — independently verifiable at livenet.xrpl.org.

client.c — full source

client.c
Loading…

Makefile

Makefile
Loading…