elhthss API

Comprehensive API documentation for integrating with the elhthss platform. Build, query, and manage blockchain-native applications with secure, real-time endpoints.

📘 Start Integrating 🔧 API Sandbox

API Endpoints Overview

Authentication

Secure API access using JWT tokens or blockchain-signed requests.

→ Details

Data Access

Query blockchain-verified data streams and encrypted health records.

→ Details

Smart Contracts

Execute automated workflows on Ethereum, solana, and polkadot.

→ Details

Authentication

JWT Authentication

POST /auth/login 
{
  "client_id": "project_id",
  "private_key": "wallet_signature"
}

Returns a JWT token valid for 24 hours. Use this with the Authorization header for secured endpoints.

Blockchain Access

Sign-in using wallet

Use your Ethereum wallet to sign a cryptographic challenge. This generates a session key for access.

npm install @elhthss/wallet-auth

Usage Examples

Query Health Records

                        GET /api/health-records/patient-id 
                    
                        {
  "patient_id": "0x123...",
  "last_access": "2025-03-14T10:23:15Z",
  "data_hash": "QmV4QpX..."
}

Returns cryptographic hash of encrypted health records stored on IPFS.

Write Secure Data

                        POST /api/health-records/new-data
                    
{
  "data": "base64_encoded_patient_data",
  "encryption_key": "symmetricetric_key_512",
  "signature": "ecdsa_signature"
}

Encrypts data with zero-knowledge proof attestation before blockchain registration.

Supported Integrations

Ethereum

Full support for smart contract deployment and querying on Ethereum mainnet and testnets.

→ Docs

Solana

High-performance Solana integration for real-time health data transactions.

→ Docs

Polkadot

Cross-chain health data interoperability via Polkadot parachains.

→ Docs