BAPBA Protocol
GuidesSurvivor Guides

Accessing Documents

How survivors decrypt, download, and verify documents after threshold authentication in Burning Ash Protocol.

Accessing Documents

Once the threshold is met, survivors can access the decrypted will documents. This guide covers the process.

Prerequisites

Before accessing documents, you must:

  1. Be a designated survivor
  2. Have verified your identity via OTP or backup code
  3. Have threshold (K-of-N) survivors authenticated

Access Notification

When threshold is met, you'll receive notification:

Burning Ash Protocol

The threshold has been met! You can now access [Host Name]'s will documents.

Visit the portal to view and download: [link]

The Access Portal

Initial Screen

┌─────────────────────────────────────────────────────────────┐
│                 WILL DOCUMENTS                              │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  Congratulations! The access threshold has been met.        │
│                                                              │
│  ────────────────────────────────────────────────────────  │
│                                                              │
│  PERSONAL MESSAGE FROM HOST:                                │
│  ────────────────────────────────────────────────────────  │
│  "Dear Family,                                             │
│                                                          │
│   If you're reading this, I'm gone. I wanted to           │
│   make sure you had access to these important             │
│   documents. I love you all..."                          │
│                                                              │
│  ────────────────────────────────────────────────────────  │
│                                                              │
│  YOUR DOCUMENTS:                                            │
│  ────────────────────────────────────────────────────────  │
│                                                              │
│  📄 last_will_and_testament.pdf    2.4 MB    ✅ Verified  │
│  📄 insurance_policy_details.pdf   1.1 MB    ✅ Verified  │
│  📄 account_passwords.odt          340 KB    ✅ Verified  │
│  📄 letter_to_family.docx         125 KB    ✅ Verified  │
│                                                              │
│  [Download All as ZIP]   [View Individual]                  │
│                                                              │
│  ────────────────────────────────────────────────────────  │
│                                                              │
│  ⚠️ Access expires in 5 days, 12 hours                     │
│                                                              │
└─────────────────────────────────────────────────────────────┘

Document List

Each document shows:

  • Icon — Based on file type
  • Filename — Original name as uploaded
  • Size — File size
  • Status — ✅ Verified or ⚠️ Warning

Viewing Documents

Individual Viewing

Click on any document to view in-browser:

  • PDFs can be viewed in browser
  • Images display directly
  • Text files shown as plain text

Download Options

Download All (ZIP)

Creates a ZIP archive of all documents:

  1. Click "Download All as ZIP"
  2. System creates archive (may take time for large files)
  3. Browser downloads ZIP file
  4. Extract to view individual files

Individual Download

Click document row to download single file:

  1. Click document
  2. Download starts automatically
  3. File saves to your device

Document Integrity

Verification Status

Each document shows verification status:

StatusMeaning
✅ VerifiedSHA-256 hash matches; document intact
⚠️ WarningHash mismatch; document may be modified

Hash Verification

When documents are encrypted:

  1. SHA-256 hash of original is computed
  2. Hash is stored in database
  3. When decrypted, hash is recomputed
  4. If match → ✅ Verified
  5. If mismatch → ⚠️ Warning

If Warning Shown

If you see ⚠️ Warning:

  • Document may have been tampered with
  • Access is still provided
  • Consider investigating
  • Log was created for security team review

Download Expiry

Time Limit

Access window is 7 days (default) from threshold met.

Expiry Notification

You'll see:

  • Countdown timer on portal
  • Email notifications as deadline approaches

After Expiry

When access window ends:

  • Documents are re-encrypted
  • New SSS shares generated
  • Portal shows "Access Expired"
  • New transfer would need to be initiated

Download URLs

Presigned URLs

Documents are accessed via presigned URLs:

  • Time-limited (typically 1 hour)
  • Single-use option available
  • Specific to your session

URL Properties

  • Cannot be shared publicly
  • Expire after set time
  • Tied to your verified session

File Types Supported

Viewable In-Browser

TypeExtensionViewer
PDF.pdfBuilt-in PDF viewer
Images.jpg, .jpeg, .pngBuilt-in image viewer
Text.txtPlain text display

Download Required

TypeExtensionNotes
Word.doc, .docxDownload to open
OpenDocument.odtDownload to open
Rich Text.rtfDownload to open

Personal Message

What's Included

The personal message is text you wrote when the host added you as survivor. It's displayed at the top of the access portal.

Example

"Dear Jane,

If you're reading this, I'm gone. I want to thank you for being part of my life. These documents contain everything you need to settle my affairs.

Take care of each other. I love you all."

Access Window Management

Extending Access

Currently, access window cannot be extended. After 7 days:

  • Documents are re-sealed
  • New transfer would need to start

Downloading Early

Download documents early in the access window:

  • Don't wait until the last day
  • Store securely on your device
  • You can download multiple times during window

Sharing Documents

With Other Survivors

The portal shows which survivors have authenticated:

  • You can see who else has access
  • Documents can be shared among verified survivors

With Others

Not recommended to share outside survivors:

  • Documents may contain sensitive information
  • Other survivors may have different views
  • Host may have intended limited distribution

Troubleshooting

"Documents not loading"

  • Check your authentication is valid
  • Refresh the page
  • Try downloading instead

"Download failed"

  • Check internet connection
  • Try individual downloads
  • Check storage space

"Access expired"

  • Access window has closed
  • Contact other survivors
  • May need to initiate new transfer

"Document corrupted"

  • May show ⚠️ warning
  • Try downloading again
  • Contact other survivors to compare

Best Practices

After Access

  1. Download immediately — Don't wait
  2. Verify documents — Check expected files present
  3. Read personal message — May contain instructions
  4. Store securely — Keep private, share carefully

Security

  • Don't share credentials
  • Protect downloaded files
  • Consider encryption for local storage

What Next

After accessing documents:

  1. Review all documents
  2. Follow any instructions from host
  3. Coordinate with other survivors
  4. Settle affairs per will

Summary

Accessing documents is straightforward:

  1. Receive notification that threshold met
  2. Visit portal
  3. View personal message
  4. Download/view documents
  5. Verify integrity
  6. Access for 7 days

Next Steps

On this page