Lilkijin2004/veracity-anchor-plus
0
1<!DOCTYPE html>2<html lang="en" class="dark">3<head>4 <meta charset="UTF-8">5 <meta name="viewport" content="width=device-width, initial-scale=1.0">6 <title>Documentation | Veracity Anchor Plus</title>7 <link rel="stylesheet" href="style.css">8 <script src="https://cdn.tailwindcss.com"></script>9 <script src="https://cdn.jsdelivr.net/npm/feather-icons/dist/feather.min.js"></script>10 <script>11 tailwind.config = {12 darkMode: 'class',13 theme: {14 extend: {15 colors: {16 primary: { 500: '#6366f1', 600: '#4f46e5' },17 secondary: { 500: '#10b981' }18 },19 fontFamily: {20 mono: ['JetBrains Mono', 'Consolas', 'monospace'],21 }22 }23 }24 }25 </script>26 <style>27 .doc-content h2 { font-size: 1.5rem; font-weight: 700; color: #ffffff; margin-top: 2rem; margin-bottom: 1rem; }28 .doc-content h3 { font-size: 1.25rem; font-weight: 600; color: #e2e8f0; margin-top: 1.5rem; margin-bottom: 0.75rem; }29 .doc-content p { color: #94a3b8; margin-bottom: 1rem; line-height: 1.625; }30 .doc-content ul { list-style: disc; list-style-position: inside; color: #94a3b8; margin-bottom: 1rem; }31 .doc-content ul li { margin-bottom: 0.5rem; }32 .doc-content code { background-color: #1e293b; padding-left: 0.5rem; padding-right: 0.5rem; padding-top: 0.25rem; padding-bottom: 0.25rem; border-radius: 0.375rem; font-size: 0.875rem; font-family: ui-monospace, monospace; color: #818cf8; }33 .doc-content pre { background-color: #020617; padding: 1rem; border-radius: 0.75rem; border: 1px solid #1e293b; overflow-x: auto; margin-bottom: 1.5rem; }34 .doc-content pre code { background-color: transparent; padding: 0; color: #cbd5e1; }35 </style>36</head>37<body class="bg-slate-950 text-slate-100 font-sans antialiased">38 <script src="components/nav-bar.js"></script>39 <script src="components/footer-section.js"></script>40 41 <nav-bar></nav-bar>42 43 <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 pt-24 pb-12">44 <div class="flex flex-col lg:flex-row gap-8">45 <!-- Sidebar -->46 <aside class="lg:w-64 lg:flex-shrink-0">47 <div class="lg:sticky lg:top-24 space-y-1">48 <div class="text-xs font-mono text-slate-500 uppercase tracking-wider mb-4 px-3">Overview</div>49 <a href="#introduction" class="block px-3 py-2 rounded-lg text-slate-300 hover:bg-slate-800 text-sm">Introduction</a>50 <a href="#quickstart" class="block px-3 py-2 rounded-lg text-slate-300 hover:bg-slate-800 text-sm">Quick Start</a>51 <a href="#authentication" class="block px-3 py-2 rounded-lg text-slate-300 hover:bg-slate-800 text-sm">Authentication</a>52 53 <div class="text-xs font-mono text-slate-500 uppercase tracking-wider mt-6 mb-4 px-3">API Reference</div>54 <a href="#endpoints" class="block px-3 py-2 rounded-lg text-slate-300 hover:bg-slate-800 text-sm">Endpoints</a>55 <a href="#attestations" class="block px-3 py-2 rounded-lg text-slate-300 hover:bg-slate-800 text-sm">Attestations</a>56 <a href="#evidence" class="block px-3 py-2 rounded-lg text-slate-300 hover:bg-slate-800 text-sm">Evidence Chain</a>57 <a href="#webhooks" class="block px-3 py-2 rounded-lg text-slate-300 hover:bg-slate-800 text-sm">Webhooks</a>58 59 <div class="text-xs font-mono text-slate-500 uppercase tracking-wider mt-6 mb-4 px-3">SDKs</div>60 <a href="#javascript" class="block px-3 py-2 rounded-lg text-slate-300 hover:bg-slate-800 text-sm">JavaScript</a>61 <a href="#python" class="block px-3 py-2 rounded-lg text-slate-300 hover:bg-slate-800 text-sm">Python</a>62 </div>63 </aside>64 65 <!-- Content -->66 <main class="flex-1 doc-content">67 <div class="mb-8">68 <h1 class="text-4xl font-bold text-white mb-4">Documentation</h1>69 <p class="text-slate-400 text-lg">Build truth-verification systems with our cryptographic attestation infrastructure.</p>70 </div>71 72 <section id="introduction">73 <h2>Introduction</h2>74 <p>Veracity Anchor Plus provides cryptographic infrastructure for verifiable truth. Our platform enables autonomous attestation engines to detect misinformation, phishing, and malware with immutable provenance chains.</p>75 <p>Each attestation is cryptographically signed using Ed25519 and stored with content-addressable identifiers (CIDs), ensuring tamper-evident verification chains.</p>76 </section>77 78 <section id="quickstart">79 <h2>Quick Start</h2>80 <p>Get your first attestation in under 5 minutes:</p>81 <pre><code>curl -X POST https://api.veracity.anchor/v1/attest \82 -H "Authorization: Bearer YOUR_API_KEY" \83 -H "Content-Type: application/json" \84 -d '{85 "type": "claim",86 "input": "The Earth orbits the Sun"87 }'</code></pre>88 89 <h3>Response Structure</h3>90 <p>All responses follow the Canonical Data Contract with consistent fields:</p>91 <ul>92 <li><code>id</code>: Unique attestation identifier</li>93 <li><code>verdict</code>: Boolean or safety classification</li>94 <li><code>confidence</code>: 0.0 to 1.0 score</li>95 <li><code>evidence</code>: Array of supporting sources</li>96 <li><code>provenance</code>: Cryptographic signature chain</li>97 </ul>98 </section>99 100 <section id="authentication">101 <h2>Authentication</h2>102 <p>API requests must include your API key in the header:</p>103 <pre><code>Authorization: Bearer vapi_xxxxxxxxxxxxxxxx</code></pre>104 <p>Keys can be generated from the Curator Dashboard under Key Management.</p>105 </section>106 107 <section id="endpoints">108 <h2>Core Endpoints</h2>109 110 <h3>POST /v1/attest</h3>111 <p>Generate truth attestation for claims or URLs.</p>112 <ul>113 <li><strong>Rate Limit:</strong> 100 req/min</li>114 <li><strong>Timeout:</strong> 30s</li>115 </ul>116 117 <h3>POST /v1/safety-attest</h3>118 <p>Safety analysis for URLs and resources.</p>119 <ul>120 <li>Sandbox execution environment</li>121 <li>Static and dynamic analysis</li>122 <li>Phishing pattern detection</li>123 </ul>124 </section>125 126 <section id="attestations">127 <h2>Working with Attestations</h2>128 <p>Attestations are immutable once created. To challenge a verdict, use the appeals system:</p>129 <pre><code>POST /v1/appeal130{131 "attestationId": "att_9x2m4",132 "reason": "New evidence contradicts verdict",133 "evidence": ["https://..."]134}</code></pre>135 </section>136 137 <section id="evidence">138 <h2>Evidence Chain Verification</h2>139 <p>Every attestation includes a provenance chain that can be independently verified:</p>140 <ol class="list-decimal list-inside text-slate-400 space-y-2 mb-4">141 <li>Extract the <code>cid</code> from the attestation response</li>142 <li>Retrieve the IPLD node from our IPFS gateway</li>143 <li>Verify the Ed25519 signature against the public key</li>144 <li>Validate the chain integrity back to the genesis block</li>145 </ol>146 </section>147 </main>148 </div>149 </div>150 151 <footer-section></footer-section>152 153 <script src="script.js"></script>154 <script>feather.replace();</script>155</body>156</html>