umarise-s3 0.2.1

Anchor every S3 upload to Bitcoin. Works with any S3-compatible backend.

umarise-s3

Anchor every S3 upload to Bitcoin. Works with any S3-compatible backend.

pip install umarise-s3

Quick start

from umarise_s3 import AnchoredS3Client

# Works with Akave, AWS S3, MinIO, GCS, etc.
s3 = AnchoredS3Client(
    endpoint_url="https://o3.akave.xyz",  # or any S3-compatible endpoint
    aws_access_key_id="your_key",
    aws_secret_access_key="your_secret",
)

# Every upload is automatically anchored
s3.upload_file("model.pt", "my-bucket", "models/model.pt")
s3.put_object(Bucket="my-bucket", Key="data.csv", Body=open("data.csv", "rb").read())

What happens

1. File is uploaded to your S3 backend (unchanged)
2. SHA-256 hash is computed locally (bytes never leave your machine)
3. Hash is submitted to Umarise Core API
4. origin_id is stored as S3 object metadata (x-amz-meta-umarise-origin-id)
5. Within ~12 hours, proof is confirmed on the Bitcoin blockchain

S3 metadata written

Metadata key	Value
umarise-origin-id	UUID
umarise-proof-status	pending or anchored
umarise-hash	SHA-256 hex

Environment

export UMARISE_API_KEY=um_your_key

Or pass api_key= to AnchoredS3Client().

Compatible backends

• Akave Cloud (S3-compatible, decentralized)
• AWS S3
• MinIO
• Google Cloud Storage (S3-compatible mode)
• Any S3-compatible endpoint

Verify independently

The proof is yours. Verify without Umarise:

• verify-anchoring.org
• ots verify proof.ots

License

Unlicense — Public Domain