SmartLedger API Walkthrough - Vanguarde Integration

🔄 Complete Integration Workflow

🔐 Identity

Web3Keys generates cryptographic identity

→

🧩 Schema

SchemaForge validates structure

→

🤖 AI Content

Human-Led AI generates content

→

📋 Notarize

NotaryHash timestamps content

→

⛓️ Publish

BlockPublish stores on blockchain

🔐

Web3Keys API

✅ PRODUCTION READY

ECDSA identity management, cryptographic signing, and session authentication. The foundation of digital trust with enterprise-grade security.

🔄 Step-by-Step Workflow

User Registration & Key Generation

Generate ECDSA key pair with HD wallet support and Shamir secret sharing

POST /api/web3keys/register

curl -X POST http://localhost:3001/api/web3keys/register \
  -H "Content-Type: application/json" \
  -d '{"username": "vanguarde-user", "email": "user@vanguarde.digital"}'
                    

Session Authentication

Secure login with cryptographic challenge-response

POST /api/web3keys/login

curl -X POST http://localhost:3001/api/web3keys/login \
  -H "Content-Type: application/json" \
  -d '{"userId": "user-id", "challenge": "login-challenge"}'
                    

Message Signing

Sign documents or messages with ECDSA for non-repudiation

POST /api/web3keys/sign

curl -X POST http://localhost:3001/api/web3keys/sign \
  -H "Content-Type: application/json" \
  -d '{"privateKey": "L5oL...", "message": "Document to sign"}'
                    

Signature Verification

Verify authenticity of signatures with public key

POST /api/web3keys/verify

curl -X POST http://localhost:3001/api/web3keys/verify \
  -H "Content-Type: application/json" \
  -d '{"message": "Document", "signature": "3044...", "publicKey": "03..."}'
                    

🎯 Live Production Proof

Test User: 893c6541-00fe-4a73-968f-8c69ac981399

Web3 Address: 1Q9kwJD6weS38owCQBQb5trTCpgThcmYQq

Sample Signature: 3044022015b96f36df43100138bb2df4abe41a68...

🧩

SchemaForge API

✅ PRODUCTION READY

JSON schema management, validation, and auto-generation. Ensures structured data integrity for AI content and API integrations.

🔄 Step-by-Step Workflow

Auto-Generate Schema from Example

Create JSON schema from sample data with intelligent type inference

POST /api/schemaforge/create

curl -X POST http://localhost:3001/api/schemaforge/create \
  -H "Content-Type: application/json" \
  -d '{
    "name": "User Profile",
    "example": {
      "name": "John Doe",
      "email": "john@example.com",
      "age": 30,
      "verified": true
    }
  }'
                    

Manual Schema Creation

Define complete schema with validation rules and constraints

POST /api/schemaforge/create-manual

curl -X POST http://localhost:3001/api/schemaforge/create-manual \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Document Schema",
    "schema": {
      "type": "object",
      "properties": {
        "title": {"type": "string", "minLength": 1},
        "content": {"type": "string"},
        "tags": {"type": "array", "items": {"type": "string"}}
      },
      "required": ["title", "content"]
    }
  }'
                    

Data Validation

Validate JSON data against schema with detailed error reporting

POST /api/schemaforge/validate/:schemaId

curl -X POST http://localhost:3001/api/schemaforge/validate/schema-id \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "title": "My Document",
      "content": "Document content here",
      "tags": ["important", "verified"]
    }
  }'
                    

Schema Management

List, retrieve, and manage all schemas with versioning

GET /api/schemaforge/list

curl http://localhost:3001/api/schemaforge/list
curl http://localhost:3001/api/schemaforge/schema/schema-id
curl http://localhost:3001/api/schemaforge/stats
                    

🎯 Live Production Proof

Integration Schema: e860f9f4-50bc-45b6-9929-0c67e6d8ecd9

Vanguarde Profile Schema: a8c8c6e5-7053-4e26-b4d0-3a4bdd5031ef

Validation Success Rate: 100% for tested schemas

🤖

Human-Led AI API

✅ BREAKTHROUGH TECHNOLOGY

Industry-first verifiable AI content platform with blockchain provenance, human oversight, and complete audit trails. Revolutionary technology for enterprise AI deployment.

🔄 Step-by-Step Workflow

Create AI Session with Audit Trail

Start new AI session with blockchain-backed audit trail and project tracking

POST /api/humanledai/session

curl -X POST http://localhost:3001/api/humanledai/session \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "vanguarde-user",
    "projectName": "Marketing Content Generation",
    "description": "AI-assisted content creation with human oversight"
  }'
                    

Generate AI Content with Schema Validation

AI generates content with persistent memory and schema compliance

POST /api/humanledai/generate/:sessionId

curl -X POST http://localhost:3001/api/humanledai/generate/session-id \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Write an article about blockchain benefits for businesses",
    "temperature": 0.3,
    "useSchema": true,
    "requireHumanReview": true,
    "autoNotarize": true
  }'
                    

Human Review and Approval

Expert human review with credentials and feedback tracking

POST /api/humanledai/review/:sessionId/:contentId

curl -X POST http://localhost:3001/api/humanledai/review/session/content \
  -H "Content-Type: application/json" \
  -d '{
    "approved": true,
    "feedback": "Excellent content, approved for publication",
    "modifications": "Minor formatting adjustments",
    "reviewerName": "Senior Content Editor",
    "reviewerCredentials": "10 years content marketing experience"
  }'
                    

Blockchain Publication with Provenance

Publish approved content to blockchain with complete audit trail

POST /api/humanledai/publish/:sessionId/:contentId

curl -X POST http://localhost:3001/api/humanledai/publish/session/content \
  -H "Content-Type: application/json" \
  -d '{
    "includeMetadata": true,
    "notarize": true,
    "publicationNote": "Approved AI content with human oversight"
  }'
                    

Dynamic Schema Creation

AI-driven schema generation from natural language queries

POST /api/humanledai/schema/create

curl -X POST http://localhost:3001/api/humanledai/schema/create \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Create schema for product reviews",
    "desiredKeys": ["productName", "rating", "reviewText", "pros", "cons"],
    "context": {"platform": "e-commerce", "targetAudience": "online shoppers"}
  }'
                    

🎯 Live Blockchain Evidence

Content TX: af6b1b63191416a47824f4925f97d2fd0dde29abccb7518deb3afb36b0d01736

Audit TX: cc458195fd03969069d98e06e163acb1f8b14c06dd8294a4f356631c066f7c13

Professional article generated: 2000+ words with blockchain verification

Memory efficiency: 0.7% token usage with conversation persistence

📋

NotaryHash API

✅ PRODUCTION READY

Blockchain notarization and timestamping for tamper-evident audit trails. Essential for compliance and legal-grade document integrity.

🔄 Step-by-Step Workflow

Single Document Notarization

Notarize individual documents with blockchain timestamp

POST /api/notaryhash/notarize

curl -X POST http://localhost:3001/api/notaryhash/notarize \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Important contract document content",
    "title": "Partnership Agreement",
    "description": "Vanguarde-SmartLedger Partnership Contract",
    "contentType": "application/pdf",
    "userId": "vanguarde-legal"
  }'
                    

Batch Notarization

Notarize multiple documents in single blockchain transaction

POST /api/notaryhash/batch

curl -X POST http://localhost:3001/api/notaryhash/batch \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {"content": "Document 1", "title": "Contract"},
      {"content": "Document 2", "title": "Amendment"},
      {"content": "Document 3", "title": "Appendix"}
    ],
    "batchTitle": "Legal Document Package"
  }'
                    

Hash Calculation

Calculate SHA-256 hash before notarization

POST /api/notaryhash/calculate-hash

curl -X POST http://localhost:3001/api/notaryhash/calculate-hash \
  -H "Content-Type: application/json" \
  -d '{"content": "Content to hash"}'
                    

Verification and Audit

Verify notarization authenticity and retrieve audit history

GET /api/notaryhash/verify/:hash

curl http://localhost:3001/api/notaryhash/verify/content-hash
curl http://localhost:3001/api/notaryhash/list?userId=user-id
curl http://localhost:3001/api/notaryhash/stats
                    

🎯 Live Production Proof

Integration Status: 9dc71162b025e652935a37359307486d2575db8f9a9eed28be41bb5972ffb6d3

Batch Notarization: 7307b6f4a64820d2971ce4ddfb9a436b3cf8a60b88d81e9fd49b26510840f586

Vanguarde Document: 90ae70d4552aacd47b004cbb8fe089f960588e0fa64ad066fb06cc1b0447497d

⛓️

BlockPublish API

✅ PRODUCTION READY

Unified blockchain publishing with multi-provider broadcasting. Real BSV mainnet integration with automatic fee calculation and UTXO management.

🔄 Step-by-Step Workflow

Content Publishing

Publish data to BSV blockchain with metadata and verification URL

POST /api/blockpublish/publish

curl -X POST http://localhost:3001/api/blockpublish/publish \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Important data to publish",
    "privateKey": "private-key-for-signing",
    "metadata": {
      "title": "Document Title",
      "author": "Vanguarde Digital",
      "timestamp": "2025-10-17T15:30:00Z"
    }
  }'
                    

Transaction Estimation

Calculate fees and estimate costs before publishing

POST /api/blockpublish/estimate

curl -X POST http://localhost:3001/api/blockpublish/estimate \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Content to estimate",
    "metadata": {"title": "Test Document"}
  }'
                    

Blockchain Verification

Verify transaction on blockchain with confirmation status

GET /api/blockpublish/verify/:txid

curl http://localhost:3001/api/blockpublish/verify/transaction-id

Wallet Management

Monitor wallet status, balance, and UTXO management

GET /api/blockpublish/wallet

curl http://localhost:3001/api/blockpublish/wallet
curl http://localhost:3001/api/blockpublish/wallet/balance
curl http://localhost:3001/api/blockpublish/wallet/utxos
                    

🎯 Live Production Proof

Mainnet Wallet: 1AVcb2ZKGLgBjufyVvbqQuZW7FwnsY6Af5

Sample TX: 74a8db2467450c75f6fc7298742cca7ae0cc8293cee5e668ea428f40c0a6980f

Verification: https://whatsonchain.com/tx/74a8db2467...

Providers: WhatsOnChain, Bitails, GorillaPool

🎓

CredentialChain API

✅ PRODUCTION READY

Verifiable digital certificates and Train & Earn program integration. Blockchain-backed credentials with public verification URLs.

🔄 Step-by-Step Workflow

Issue Digital Certificate

Create blockchain-backed certificate with cryptographic proof

POST /api/credentialchain/issue

curl -X POST http://localhost:3001/api/credentialchain/issue \
  -H "Content-Type: application/json" \
  -d '{
    "recipientName": "John Doe",
    "recipientEmail": "john@vanguarde.digital",
    "certificateType": "Blockchain Development Certification",
    "issuerName": "Vanguarde Digital Training",
    "courseDetails": {
      "courseName": "Advanced Blockchain Development",
      "completionDate": "2025-10-17",
      "grade": "A+",
      "skills": ["Smart Contracts", "BSV Development", "API Integration"]
    }
  }'
                    

Batch Certificate Issuance

Issue multiple certificates for entire cohorts

POST /api/credentialchain/batch-issue

curl -X POST http://localhost:3001/api/credentialchain/batch-issue \
  -H "Content-Type: application/json" \
  -d '{
    "cohortName": "Q4 2025 Blockchain Cohort",
    "certificates": [
      {"recipientName": "Alice", "grade": "A"},
      {"recipientName": "Bob", "grade": "B+"},
      {"recipientName": "Carol", "grade": "A-"}
    ]
  }'
                    

Certificate Verification

Public verification with blockchain proof and authenticity check

GET /api/credentialchain/verify/:certificateId

curl http://localhost:3001/api/credentialchain/verify/certificate-id

User Credential Portfolio

List all certificates and badges for a user

GET /api/credentialchain/user/:userId

curl http://localhost:3001/api/credentialchain/user/user-id
curl http://localhost:3001/api/credentialchain/user/user-id/portfolio
curl http://localhost:3001/api/credentialchain/search?skill=blockchain
                    

🎯 Ready for Train & Earn Integration

Service Status: Operational and tested

Blockchain Integration: Web3Keys + BlockPublish foundation

Use Case: Perfect for Vanguarde's workforce development programs

🔗

Integrated Publishing API

✅ PRODUCTION READY

Combined Web3Keys + BlockPublish workflows for complete signed publishing pipeline. Enterprise-grade end-to-end solution.

🔄 Step-by-Step Workflow

Signed Publishing Workflow

Complete pipeline: Sign with Web3Keys → Publish to Blockchain → Generate Verification

POST /api/integrated/publish-signed

curl -X POST http://localhost:3001/api/integrated/publish-signed \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Document requiring cryptographic proof",
    "privateKey": "signing-private-key",
    "userId": "vanguarde-user",
    "metadata": {
      "title": "Signed Partnership Agreement",
      "type": "legal-document",
      "parties": ["Vanguarde Digital", "SmartLedger"]
    }
  }'
                    

Complete Verification

Verify both cryptographic signature and blockchain publication

GET /api/integrated/verify/:txid

curl http://localhost:3001/api/integrated/verify/transaction-id

🎯 End-to-End Tested

Complete signed publishing workflow validated

Cryptographic signature + blockchain publication

Public verification with full audit trail

🎮 Live Demo Scenarios

🎓 Train & Earn Certificate

Complete workflow from course completion to blockchain-verified certificate with public verification URL.

📝 Document Workflow

Sign documents with Web3Keys, notarize with NotaryHash, and publish to blockchain with full audit trail.

🤖 AI Content Pipeline

Generate AI content with schema validation, human review, and blockchain publication for complete provenance.

🔗 Multi-API Integration

Combine multiple APIs for complex workflows like identity verification + content creation + blockchain storage.

🔒 Enterprise Security

ECDSA signatures, HD wallets, AES-256-GCM encryption, and Shamir secret sharing for maximum security.

⛓️ Real Blockchain

Live BSV mainnet integration with multi-provider broadcasting and public verification URLs.

🤖 Advanced AI

OpenAI GPT integration with memory management, schema validation, and dynamic content generation.

📊 Complete Audit Trails

Every action logged with timestamps, cryptographic proof, and blockchain verification.

🔧 Developer Friendly

RESTful APIs with comprehensive documentation, consistent error handling, and easy integration.

⚡ Production Ready

Rate limiting, CORS support, health monitoring, and enterprise-grade reliability.

🚀 Ready for Vanguarde Digital Integration

All APIs are operational with real blockchain integration and enterprise-grade security. Start building verifiable digital trust today.

📚 API Documentation 🤝 Vanguarde Integration Guide 📊 System Health 🔍 Detailed Status

SmartLedger × Vanguarde Digital
Verifiable AI • Verifiable People • Verifiable Data

🚀 SmartLedger API Ecosystem

🔄 Complete Integration Workflow

🔐 Identity

🧩 Schema

🤖 AI Content

📋 Notarize

⛓️ Publish

Web3Keys API

🔄 Step-by-Step Workflow

🎯 Live Production Proof

SchemaForge API

🔄 Step-by-Step Workflow

🎯 Live Production Proof

Human-Led AI API

🔥 BREAKTHROUGH: World's First Verifiable AI Content Platform

🔄 Step-by-Step Workflow

🎯 Live Blockchain Evidence

NotaryHash API

🔄 Step-by-Step Workflow

🎯 Live Production Proof

BlockPublish API

🔄 Step-by-Step Workflow

🎯 Live Production Proof

CredentialChain API

🔄 Step-by-Step Workflow

🎯 Ready for Train & Earn Integration

Integrated Publishing API

🔄 Step-by-Step Workflow

🎯 End-to-End Tested

🎮 Live Demo Scenarios

🎓 Train & Earn Certificate

📝 Document Workflow

🤖 AI Content Pipeline

🔗 Multi-API Integration

🔒 Enterprise Security

⛓️ Real Blockchain

🤖 Advanced AI

📊 Complete Audit Trails

🔧 Developer Friendly

⚡ Production Ready

🚀 Ready for Vanguarde Digital Integration