Skip to main content

​
Overview

As a patient, Salud Health empowers you to take control of your medical records with complete privacy and security. All your health data is encrypted and stored on the Aleo blockchain, ensuring that only you can access and share your information.

​
Getting Started

​
Connecting Your Wallet

Before you can create or view records, you need to connect your Aleo wallet:
1

Navigate to Salud Health

Open the Salud Health application in your web browser.
2

Enter Your Private Key

On the wallet connect screen, paste your Aleo private key (starts with APrivateKey1...).
Your private key never leaves your browser - it’s only used to establish a secure session with the backend.
3

Connect

Click the “Connect” button to establish your session. The app will verify your credentials and load your records from the blockchain.

​
Understanding Your Dashboard

Once connected, you’ll see your dashboard with:
  • Medical Records Count: Total number of encrypted health records you’ve created
  • Active Shares: Number of records currently shared with healthcare providers
  • Quick Actions: Shortcuts to create new records, share with doctors, and view access history
  • Recent Records: Your most recently created or updated medical records

​
Creating Medical Records

Salud Health allows you to create encrypted medical records that are permanently stored on the Aleo blockchain.
1

Click 'New Record'

From your dashboard or the Records page, click the “New Record” button.
2

Fill in Record Details

Complete the form with your medical information:
  • Title: A descriptive name for your record (e.g., “Annual Physical 2026”)
  • Description: Detailed information about the medical event or test
  • Record Type: Select from 10 categories:
    • General Health
    • Laboratory Results
    • Prescription
    • Imaging (X-rays, MRI, CT scans)
    • Vaccination
    • Surgical
    • Mental Health
    • Dental
    • Vision
    • Other
  • Medical Data: Enter the detailed medical information (this will be encrypted)
3

Submit

Click “Create Record” to encrypt and store your data on the Aleo blockchain.
Record creation may take 10-15 seconds as the transaction is processed on the blockchain.

​
Record Types Explained

For routine checkups, health assessments, and general wellness visits. Includes vital signs, physical examinations, and preventive care.
Blood tests, urine analysis, genetic testing, and other laboratory work. Store test results with reference ranges and doctor’s notes.
Medication prescriptions including drug names, dosages, frequency, and duration. Track your medication history securely.
X-rays, MRI scans, CT scans, ultrasounds, and other medical imaging. Store reports and findings from radiologists.
Immunization records, vaccine dates, lot numbers, and vaccination history. Essential for travel and school requirements.

​
Managing Your Records

​
Viewing Records

1

Navigate to Records Page

Click “Records” in the main navigation to see all your medical records.
2

Filter and Search

  • Use the search bar to find specific records by title or description
  • Filter by record type using the category pills
  • Switch between grid and list view using the toggle buttons
3

View Details

Click on any record card to view its full details, including encrypted data, creation date, and sharing history.

​
Syncing with Blockchain

Your records are automatically synced from the Aleo blockchain when you connect. You can manually trigger a sync:
  • Click the “Sync” button on the Records page or Dashboard
  • Wait for the blockchain sync to complete (shown by the spinning icon)
  • New or updated records will appear once the sync finishes
The first sync after connecting may take 10-15 seconds as the app fetches all your records from the blockchain.

​
Sharing Records with Doctors

One of Salud Health’s most powerful features is the ability to securely share medical records with healthcare providers using time-limited access.

​
How Record Sharing Works

1

Select a Record

From your Records page or Dashboard, click on the record you want to share, then click the “Share” button.
2

Configure Access Settings

In the Share Record modal, you’ll configure:Doctor’s Aleo Address (Optional)
  • Leave empty to allow any doctor with the QR code to access
  • Enter a specific Aleo address (starts with aleo1...) to restrict access to one doctor only
Access Duration Choose from predefined durations:
  • 1 Hour (240 blocks) - Quick consultation
  • 4 Hours (960 blocks) - Extended appointment
  • 12 Hours (2,880 blocks) - Half day access
  • 24 Hours (5,760 blocks) - Full day access
  • 3 Days (17,280 blocks) - Multi-day care
  • 7 Days (40,320 blocks) - Extended care (maximum)
3

Generate QR Code

Click “Generate QR Code” to create a secure, time-limited access token.
4

Share with Your Doctor

You can share the access in two ways:
  • Show QR Code: Display the QR code on your phone/screen for the doctor to scan
  • Copy Access Token: Copy the token string and send it securely (not recommended for public channels)
  • Download QR: Save the QR code as a PNG file

​
Important Security Notes

Share ResponsiblyOnly share QR codes with trusted healthcare providers. Once generated, anyone with the QR code can access the record (unless you restricted it to a specific doctor’s address).
Automatic ExpirationAccess automatically expires after the duration you selected. The QR code and access token become invalid once the time limit is reached.

​
What Doctors See

When a doctor scans your QR code:
  1. The Aleo blockchain verifies the access token is valid and not expired
  2. The encrypted medical record is decrypted using the shared view key
  3. The doctor sees:
    • Record title and description
    • Record type (e.g., Laboratory Results, Prescription)
    • Your wallet address (patient identifier)
    • Access expiration time
    • The decrypted medical data

​
Managing Privacy & Access

​
Viewing Shared Access History

Track who has access to your records:
1

Navigate to Shared Access

Click “Shared” in the main navigation menu.
2

View Access Statistics

See at a glance:
  • Active Shares: Currently valid access grants
  • Expired: Access grants that have passed their expiration time
  • Revoked: Access you manually revoked before expiration
3

Review Access Details

For each shared record, you can see:
  • Which medical record was shared
  • Doctor’s wallet address (or “Any doctor” if unrestricted)
  • When access was granted
  • When access expires
  • Current status (Active, Expired, or Revoked)

​
Revoking Access

You can revoke access to a record before it expires:
1

Find the Active Share

On the Shared Access page, locate the active share you want to revoke.
2

Click 'Revoke Access'

Click the “Revoke Access” button on the access grant card.
3

Confirm Revocation

The access token will be immediately invalidated, and the doctor will no longer be able to access the record.
Revocation is immediate and cannot be undone. The doctor will need a new QR code to regain access.

​
Data Privacy & Encryption

​
How Your Data is Protected

Salud Health implements multiple layers of security:
Your medical data is encrypted in your browser before it’s sent to the backend or blockchain. The server never sees your unencrypted health information.
Records are stored as private, encrypted data on the Aleo blockchain. Only you (and those you grant access to) can decrypt and view the contents.
When doctors access your records, Aleo’s zero-knowledge proofs verify access permissions without revealing your data to anyone else on the network.
All shared access is time-bound. Access tokens automatically expire, ensuring doctors only have temporary access to your records.
When sharing records, the view key is encrypted with the doctor’s public key, ensuring only the intended recipient can decrypt your data.

​
What’s Encrypted vs Public

Encrypted (Private):
  • Medical record title and description
  • All medical data content
  • View keys for accessing records
Public (On Blockchain):
  • Record IDs (random identifiers)
  • Data hashes (for verification)
  • Access grant metadata (not the content)
  • Wallet addresses
  • Timestamps

​
Best Practices

​
Creating Records

  • Be Descriptive: Use clear titles that help you identify records later
  • Choose Correct Type: Select the appropriate record type for better organization
  • Regular Updates: Create new records after each medical visit or test
  • Include Dates: Mention dates in descriptions for better context

​
Sharing Records

  • Minimum Duration: Choose the shortest access duration necessary
  • Verify Doctor: When possible, restrict access to a specific doctor’s Aleo address
  • Monitor Access: Regularly check your Shared Access page to review active grants
  • Revoke When Done: Manually revoke access after the appointment if needed

​
Security

  • Protect Your Private Key: Never share your Aleo private key with anyone
  • Use Strong Passwords: If you store your private key in a password manager, use a strong master password
  • Verify QR Codes: Only show QR codes to trusted healthcare providers in person
  • Regular Audits: Periodically review your access history for any unexpected grants

​
Troubleshooting

Solution: Records are fetched from the blockchain on connect and may take 10-15 seconds to sync. Try clicking the “Sync” button to manually refresh. Check the browser console for sync status.
Solution: Ensure you’re connected to your wallet and the record exists. If specifying a doctor’s address, verify it starts with aleo1 and is exactly 63 characters.
Solution: Access grants are stored locally and in the blockchain. Try refreshing the page or reconnecting your wallet to sync the latest data.
Solution: Ensure the QR code is clearly visible on screen. Try downloading the QR code as a PNG for better quality. Make sure the doctor is using the correct QR scanner in the Doctor Portal.

​
Next Steps

Doctor Guide

Learn how doctors access shared records

Wallet Setup

Set up your Aleo wallet properly

Build docs developers (and LLMs) love

Get started for freeTalk to us