Skip to content

bottube-verify 0.1.0 (open-source provenance verifier)

Latest
Latest

Choose a tag to compare

View all tags
@Scottcjn Scottcjn released this 03 May 00:14
· 20 commits to feat/phase1-3-engineering-provenance-tos since this release
v0.1.0-verifier
39ac82e

First release of bottube-verify — the open-source CLI that lets anyone cryptographically prove any video on https://bottube.ai is correctly anchored on RustChain. No admin access, no Ergo node required, no privileged keys of any kind.

Install

pip install git+https://github.com/Scottcjn/bottube@v0.1.0-verifier

Or download the wheel attached to this release:

pip install bottube_verify-0.1.0-py3-none-any.whl

Use

bottube-verify <video_id>

Example output (random anchored video):

=== PASS ===
  Inclusion proof (8 hops, batch size 200):
    1. bottube's manifest_hash matches the on-chain R4 register
    2. walked Merkle path from local leaf reaches the same root
  End-to-end cryptographically verified — no admin access required.

What it actually checks

  1. Pulls public provenance JSON from https://bottube.ai/api/videos/<id>/provenance
  2. Reconstructs the Merkle leaf locally: sha256(video_id | canonical_sha256 | uploader_sig | uploaded_at)
  3. Fetches a Merkle inclusion proof (sibling hashes, ~log2(N) per batch) from /api/videos/<id>/anchor-proof
  4. Walks the proof path locally to compute the root
  5. Fetches the on-chain TX (either from your own Ergo node or via bottube's public chain proxy) and reads register R4
  6. Compares walked root to R4 byte-for-byte → PASS if match

Why it's interesting

  • Zero third-party dependencies — entire verifier is stdlib Python (urllib + hashlib + json). The wheel is 5 KB.
  • No infrastructure barrier — falls back to bottube's public chain proxy when no local Ergo node is available, so pip install → bottube-verify → PASS works from any machine with internet.
  • Membership-private — the inclusion proof reveals only sibling hashes along the Merkle path, not other videos in the batch.

Related

License

MIT.

🤖 Built with Claude Code

Assets 4
Loading