Skip to content

Commit 7f1bd51

Browse files
docs: add archive size proof CLI commands to README
- Added prove-archive-size and verify-archive-size commands to CLI table - Added detailed examples for generating and verifying tamper-proof size proofs - Updated cryptographic integrity features to mention archive size proofs - Shows how to prove file sizes without downloading archives
1 parent b796375 commit 7f1bd51

File tree

1 file changed

+18
-3
lines changed

1 file changed

+18
-3
lines changed

README.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,7 @@ Digstore Min is an advanced content-addressable storage system with enterprise-g
4646

4747
### 🛡️ Cryptographic Integrity
4848
- **Merkle Proofs**: Generate and verify proofs for any data item or byte range
49+
- **Archive Size Proofs**: Prove archive file sizes without downloading (tamper-proof)
4950
- **SHA-256 Hashing**: Cryptographic integrity throughout the system
5051
- **Tamper-Evident**: Any data modification is cryptographically detectable
5152
- **Historical Verification**: Verify data authenticity at any point in history
@@ -268,6 +269,8 @@ urn:dig:chia:a3f5c8d9e2b1f4a6c9d8e7f2a5b8c1d4e7f0a3b6c9d2e5f8b1c4d7e0a3b6c9d2/vi
268269
|---------|-------------|---------|
269270
| `proof generate` | Generate merkle proof | `digstore proof generate file.txt --bytes 0-1023` |
270271
| `proof verify` | Verify a merkle proof | `digstore proof verify proof.json --verbose` |
272+
| `prove-archive-size` | Generate tamper-proof archive size proof | `digstore prove-archive-size STORE_ID ROOT_HASH SIZE` |
273+
| `verify-archive-size` | Verify archive size proof without file access | `digstore verify-archive-size proof.txt STORE_ID ROOT_HASH SIZE` |
271274

272275
### Command Options
273276

@@ -307,9 +310,13 @@ digstore get "file.txt#bytes=0-1023" -o first_kb.bin
307310
# Get file using full URN
308311
digstore get urn:dig:chia:STORE_ID/file.txt
309312

310-
# Generate and verify proof
311-
digstore prove file.txt -o proof.json
312-
digstore verify proof.json
313+
# Generate and verify content proof
314+
digstore proof generate file.txt -o proof.json
315+
digstore proof verify proof.json
316+
317+
# Generate archive size proof (tamper-proof, no file download needed)
318+
digstore prove-archive-size STORE_ID ROOT_HASH SIZE -o size_proof.txt
319+
digstore verify-archive-size --from-file size_proof.txt STORE_ID ROOT_HASH SIZE
313320
```
314321

315322
**Advanced Features:**
@@ -343,6 +350,14 @@ digstore staged diff --stat
343350
# Zero-knowledge URN behavior
344351
digstore get "urn:dig:chia:invalid-store/fake.txt" # Returns random data, not error
345352

353+
# Archive size proofs (prove file size without downloading)
354+
digstore prove-archive-size 9baeb47a392476fe88266b579bf343f3af5f75c7633e25a722a89a6d7b47a2bd \
355+
e9254d8982b7a15a1dbdac05a99129df67880e37b43e5481dcf667aeca04fd4e \
356+
2544 --verbose --show-compression # Outputs compressed hex proof to stdout
357+
358+
# Verify size proof (no file access required)
359+
digstore verify-archive-size proof.txt STORE_ID ROOT_HASH SIZE --verbose
360+
346361
# List all configuration (encrypted storage is enabled by default)
347362
digstore config --list
348363
```

0 commit comments

Comments
 (0)