Skip to content
Back to search

attestix

Attestix - Attestation Infrastructure for AI Agents. DID-based agent identity, W3C Verifiable Credentials, EU AI Act compliance layer, delegation chains, and reputation scoring. 47 MCP tools across 9 modules.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/VibeTensor/attestix with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/VibeTensor/attestix'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vibetensor--attestix/badge.svg)](/listings/vibetensor--attestix)

HTML

<a href="/listings/vibetensor--attestix"><img src="/api/listings/vibetensor--attestix/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# Stable 0.4.0:
pip install attestix

# Pre-release 0.4.1rc1 (opt in with --pre):
pip install --pre attestix

> Stable 0.4.0 ships only the canonical > `attestix.*` namespace. The older flat layout (`from services... import`, > `from auth... import`, ...) keeps working via thin deprecation shims that > emit a `DeprecationWarning` on first import and are scheduled for removal in > v0.5.0. Update imports to `from attestix.services... import` at your earliest > convenience.

CLI

attestix status                          # System overview
attestix init --name MyBot               # Create agent identity
attestix compliance <agent-id>           # Check EU AI Act compliance
attestix verify <agent-id>               # Verify identity cryptographically
attestix audit <agent-id>                # View hash-chained audit trail
attestix credential --list               # List W3C Verifiable Credentials

REST API

pip install fastapi uvicorn
uvicorn attestix.api.main:app --reload   # Swagger docs at http://localhost:8000/docs

Web Dashboard

pip install streamlit
streamlit run demo/webapp/app.py         # Opens at http://localhost:8501

Quick Demo

python examples/quickstart.py            # Full 9-module workflow in 0.1 seconds

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 565 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <!-- mcp-name: io.github.VibeTensor/attestix -->
  2. <p align="center">
  3. <img src="https://raw.githubusercontent.com/VibeTensor/attestix/main/docs/assets/atx_icon.png" alt="Attestix" width="120" height="120" />
  4. </p>
  5. <h1 align="center">Attestix</h1>
  6. <p align="center">
  7. <strong>Signed identity and evidence for AI agents</strong>
  8. </p>
  9. <p align="center">
  10. <a href="https://github.com/VibeTensor/attestix/actions/workflows/test.yml"><img src="https://img.shields.io/github/actions/workflow/status/VibeTensor/attestix/test.yml?branch=main&label=tests&style=flat-square" alt="CI"></a>
  11. <a href="https://github.com/VibeTensor/attestix/actions/workflows/lint.yml"><img src="https://img.shields.io/github/actions/workflow/status/VibeTensor/attestix/lint.yml?branch=main&label=lint&style=flat-square" alt="Lint"></a>
  12. <a href="https://github.com/VibeTensor/attestix/actions/workflows/security.yml"><img src="https://img.shields.io/github/actions/workflow/status/VibeTensor/attestix/security.yml?branch=main&label=security&style=flat-square" alt="Security"></a>
  13. <a href="https://codecov.io/gh/VibeTensor/attestix"><img src="https://img.shields.io/codecov/c/github/VibeTensor/attestix?style=flat-square" alt="Coverage"></a>
  14. <a href="https://pypi.org/project/attestix/"><img src="https://img.shields.io/pypi/v/attestix?color=4f46e5&style=flat-square" alt="PyPI"></a>
  15. <a href="https://pypi.org/project/attestix/"><img src="https://img.shields.io/pypi/pyversions/attestix?color=4f46e5&style=flat-square" alt="Python"></a>
  16. <a href="https://github.com/VibeTensor/attestix/blob/main/LICENSE"><img src="https://img.shields.io/github/license/VibeTensor/attestix?color=4f46e5&style=flat-square" alt="License"></a>
  17. <a href="https://attestix.io/docs"><img src="https://img.shields.io/badge/docs-attestix.io%2Fdocs-4f46e5?style=flat-square" alt="Docs"></a>
  18. <a href="https://attestix.io"><img src="https://img.shields.io/badge/website-attestix.io-4f46e5?style=flat-square" alt="Website"></a>
  19. </p>
  20. <p align="center">
  21. Record cryptographically verifiable evidence to support AI governance workflows.<br/>
  22. Open-source identity, credentials, compliance automation, and trust scoring.<br/>
  23. MCP and REST interfaces,
  24. Automated functional tests and Attestix interoperability benchmarks.<br/>
  25. Real integrations with LangChain, OpenAI Agents SDK, and CrewAI.
  26. </p>
  27. <p align="center">
  28. <em>Status: pre-1.0 toolkit; this README describes current main source.
  29. Single-maintainer project, community
  30. contributions welcome. No independent third-party security audit has been
  31. performed yet; deploy with the same diligence you would apply to any
  32. pre-1.0 open-source crypto stack.</em>
  33. </p>
  34. ---
  35. ## Source and verification status
  36. Python `attestix` 0.5.0 is published on PyPI and requires Python 3.11 or later. Confirm the release files on [PyPI](https://pypi.org/project/attestix/0.5.0/) before installing; source metadata alone is not proof of publication. Python 0.4.3 is a previously published release with the Filelock constraint described below. Language SDKs have independent release schedules; verify each registry and pin the version you reviewed.
  37. - Credential verification binds the stated issuer to the supported proof controller. Ambiguous NFC-normalized keys fail before signing or verification.
  38. - Presentation verification requires the caller's expected challenge and domain. A signature alone does not provide replay protection.
  39. - REST use requires an API key by default. The default REST server is single-tenant and rejects non-default tenant headers; a shared API key does not provide cross-tenant authorization.
  40. - JSON updates use the shared storage lock. Protect the local signing key and data directory; test backup restoration, isolation and your selected signer/backend before production.
  41. - `workflow_complete` describes recorded documentation completion. `legal_conformity` is not assessed; the deprecated `compliant` field is a workflow alias. Generated declarations are drafts for provider review.
  42. - Local purge cannot erase external replicas, remote logs, previously shared credentials or third-party backups. Plan historical data and credential migration separately.
  43. ## Install
  44. Attestix 0.5.0 requires Python 3.11 or later for the patched file-locking dependency. Earlier releases retain their own Python requirements; check the registry files for the version you install.
  45. ```bash
  46. # Confirm this release is available on PyPI before installing:
  47. pip install attestix==0.5.0
  48. ```
  49. Version 0.4.3 requires `filelock<4.0.0` and cannot install patched Filelock 4.2.1. On Unix, keep the Attestix data directory private and prevent other users from replacing its lock path. This limits the conditional local file-truncation risk described in the [Filelock advisory](https://github.com/tox-dev/filelock/security/advisories/GHSA-69hj-f68j-2879). Moving from 0.4.3 to 0.5.0 requires Python 3.11 or later; review the release files before upgrading.
  50. > Since 0.4.0, the supported namespace is the canonical
  51. > `attestix.*` namespace. The older flat layout (`from services... import`,
  52. > `from auth... import`, ...) keeps working via thin deprecation shims that
  53. > emit a `DeprecationWarning` on first import and may be removed in
  54. > a future release. Update imports to `from attestix.services... import` at your earliest
  55. > convenience.
  56. ### CLI
  57. ```bash
  58. attestix status # System overview
  59. attestix init --name MyBot # Create agent identity
  60. attestix compliance <agent-id> # Check recorded documentation gaps
  61. attestix verify <agent-id> # Verify identity cryptographically
  62. attestix audit <agent-id> # View hash-chained audit trail
  63. attestix credential --list # List W3C Verifiable Credentials
  64. ```
  65. ### REST API
  66. ```bash
  67. pip install 'attestix[api]==0.5.0'
  68. # Configure ATTESTIX_API_KEY in your environment before starting the API.
  69. uvicorn attestix.api.main:app --reload # Swagger docs at http://localhost:8000/docs
  70. ```
  71. ### Web Dashboard
  72. ```bash
  73. pip install streamlit
  74. streamlit run demo/webapp/app.py # Opens at http://localhost:8501
  75. ```
  76. ### Quick Demo
  77. ```bash
  78. python examples/quickstart.py # Local synthetic workflow
  79. ```
  80. ## Verify in any language
  81. Attestix credentials use a published canonical-JSON and Ed25519 verification profile.
  82. Language-specific verifier repositories share conformance fixtures, but their trust-input
  83. and delegation-chain checks differ. Read each verifier README and pin a reviewed version.
  84. Cryptographic validity is separate from issuer trust, authorization, revocation and replay policy.
  85. | Language | Install | Status |
  86. |----------|---------|--------|
  87. | **Python** | `pip install attestix==0.5.0` | PyPI 0.5.0 published; verify release files |
  88. | **JS / TS** | `npm install attestix@0.4.2` | npm 0.4.2; verifier source ([attestix-js](https://github.com/VibeTensor/attestix-js)) |
  89. | **Go** | `go get github.com/VibeTensor/attestix-go@v0.4.2` | Go module v0.4.2; verifier source ([attestix-go](https://github.com/VibeTensor/attestix-go)) |
  90. | **Rust** | `cargo add attestix` | crates.io 0.4.1; GitHub v0.4.2 source ([attestix-rs](https://github.com/VibeTensor/attestix-rs)) |
  91. | **Java** | Maven `com.vibetensor:attestix:0.4.2` | Maven 0.4.2; verifier source ([attestix-java](https://github.com/VibeTensor/attestix-java)) |
  92. | **R** | See repository installation instructions | CRAN 0.4.1; GitHub 0.4.2 source ([attestix-r](https://github.com/VibeTensor/attestix-r)) |
  93. Every verifier targets the Attestix canonical-JSON profile, which differs from strict [RFC 8785](https://www.rfc-editor.org/rfc/rfc8785),
  94. and Ed25519 signatures ([RFC 8032](https://www.rfc-editor.org/rfc/rfc8032)) against
  95. the shared [`spec/verify/v1`](https://github.com/VibeTensor/attestix/tree/main/spec/verify/v1)
  96. vectors. Verify in the browser at <https://attestix.io/verify>, or read the
  97. bundle wire-format at <https://attestix.io/spec/bundle/v1>.
  98. ## Why Attestix
  99. The EU AI Act has a staged application timeline. The European Commission currently lists
  100. 2 December 2027 for specified high-risk use cases and 2 August 2028 for high-risk systems
  101. embedded in regulated products. Applicability depends on the system and the operator's role.
  102. See the [European Commission's current AI Act guidance](https://digital-strategy.ec.europa.eu/en/policies/regulatory-framework-ai).
  103. Attestix helps organize evidence; a signature or generated declaration does not establish
  104. legal conformity or replace the applicable assessment process.
  105. Attestix provides agent identity, signed credentials, delegation, and offline verification
  106. for developers who need portable evidence in their applications. Broader governance
  107. platforms also offer APIs, SDKs, agent governance, and compliance workflows; evaluate
  108. their current capabilities against your requirements.
  109. Agent identity is fragmenting across walled gardens (Microsoft Entra, AWS AgentCore, ERC-8004). Attestix combines **agent identity, AI governance evidence and verifiable credentials** in one toolkit.
  110. Attestix fills this gap.
  111. ---
  112. ## Modules
  113. | Module | What it does |
  114. |--------|-------------|
  115. | **Identity** | Unified Agent Identity Tokens (UAITs) bridging MCP OAuth, A2A, DIDs, and API keys. local data erasure tooling |
  116. | **Agent Cards** | Parse, generate, and discover A2A-compatible agent cards |
  117. | **DID** | Create and resolve W3C Decentralized Identifiers (`did:key`, `did:web`) |
  118. | **Delegation** | UCAN-style capability delegation with EdDSA-signed JWT tokens |
  119. | **Reputation** | Recency-weighted trust scoring (0.0 - 1.0) with category breakdown |
  120. | **Compliance** | EU AI Act risk profiles, conformity assessments (Article 43), Annex V declarations |
  121. | **Credentials** | W3C Verifiable Credentials with Ed25519Signature2020 proofs, presentations |
  122. | **Provenance** | Training data provenance (Article 10), model lineage (Article 11), hash-chained audit trail (Article 12) |
  123. | **Blockchain** | Anchor artifact hashes to Base L2 via Ethereum Attestation Service, Merkle batching |
  124. ---
  125. ## Quick Start
  126. ### As an MCP Server (Claude Code)
  127. Add to your Claude Code config (`~/.claude.json`):
  128. ```json
  129. {
  130. "mcpServers": {
  131. "attestix": {
  132. "type": "stdio",
  133. "command": "python",
  134. "args": ["-m", "attestix.main"]
  135. }
  136. }
  137. }
  138. ```
  139. Then ask Claude:
  140. > "Create an identity for my data analysis agent with capabilities: data_analysis, reporting"
  141. ### As a Python Library
  142. ```python
  143. from attestix.services.identity_service import IdentityService
  144. from attestix.services.compliance_service import ComplianceService
  145. from attestix.services.credential_service import CredentialService
  146. identity_svc = IdentityService()
  147. compliance_svc = ComplianceService()
  148. credential_svc = CredentialService()
  149. # 1. Create an agent identity
  150. agent = identity_svc.create_identity(
  151. display_name="MyAgent",
  152. source_protocol="manual",
  153. capabilities=["data_analysis", "reporting"],
  154. description="Analyzes quarterly financial data",
  155. issuer_name="VibeTensor",
  156. expiry_days=365,
  157. )
  158. agent_id = agent["agent_id"] # attestix:f9bdb7a94ccb40f1
  159. agent_did = agent["issuer"]["did"] # did:key:z6Mk...
  160. # 2. Create a compliance profile
  161. profile = compliance_svc.create_compliance_profile(
  162. agent_id=agent_id,
  163. risk_category="limited",
  164. provider_name="VibeTensor",
  165. intended_purpose="Analyzes quarterly financial data",
  166. )
  167. # 3. Issue a verifiable credential
  168. credential = credential_svc.issue_credential(
  169. subject_id=agent_id,
  170. credential_type="AgentIdentityCredential",
  171. issuer_name="VibeTensor",
  172. claims={"capabilities": ["data_analysis", "reporting"]},
  173. expiry_days=365,
  174. )
  175. print(credential["proof"]["type"]) # Ed25519Signature2020
  176. ```
  177. For a complete end-to-end walkthrough covering all 9 modules, run the quickstart:
  178. ```bash
  179. python examples/quickstart.py
  180. ```
  181. ### From Source
  182. ```bash
  183. git clone https://github.com/VibeTensor/attestix.git
  184. cd attestix
  185. pip install -r requirements.txt
  186. python -m attestix.main
  187. ```
  188. ---
  189. ## AI governance evidence workflow
  190. Record a high-risk AI agent documentation workflow for provider review:
  191. ```
  192. 1. create_agent_identity --> UAIT with DID (Ed25519 signed)
  193. 2. record_training_data --> Article 10 data governance
  194. 3. record_model_lineage --> Article 11 technical documentation
  195. 4. create_compliance_profile --> Risk categorization + obligations
  196. 5. record_conformity_assessment --> Operator-recorded assessment details
  197. 6. generate_declaration_of_conformity --> Annex V declaration + W3C VC
  198. 7. create_verifiable_presentation --> Signed VP for a verifier with a fresh challenge
  199. ```
  200. The current Attestix workflow blocks self-assessment for a profile marked high-risk. This application policy is not a universal determination of the legally applicable assessment route:
  201. ```
  202. record_conformity_assessment(assessment_type="self", ...)
  203. --> ERROR: "High-risk AI systems require third_party conformity assessment"
  204. ```
  205. Full walkthrough: [EU AI Act Compliance Guide](https://attestix.io/docs/guides/eu-ai-act-compliance)
  206. ---
  207. ## How It Works
  208. Credentials and presentations carry signatures; audit chains carry integrity hashes.
  209. Not every record or external artifact is independently signed:
  210. | Artifact | Standard | Signed |
  211. |----------|----------|--------|
  212. | Agent Identity (UAIT) | Custom + DID | Ed25519 |
  213. | Verifiable Credential | W3C VC Data Model 1.1 | Ed25519Signature2020 |
  214. | Verifiable Presentation | W3C VP | Ed25519Signature2020 |
  215. | Delegation Token | UCAN-style JWT | EdDSA |
  216. | Draft evidence credential | Attestix documentation profile | Ed25519 |
  217. | Audit Trail | Hash-chained log | SHA-256 chain |
  218. | Blockchain Anchor | EAS on Base L2 | On-chain |
  219. **Local operation.** Core identity and credential operations can use local JSON storage.
  220. Remote DID resolution, hosted signers and blockchain integrations require their configured services.
  221. ---
  222. ## Architecture
  223. ```
  224. attestix/ # Canonical Python package
  225. main.py # MCP server entry point (MCP tools)
  226. cli.py # `attestix` console script
  227. config.py # Environment-based configuration
  228. errors.py # Error handling with JSON logging
  229. api/ # FastAPI REST surface
  230. main.py # uvicorn entry: `attestix.api.main:app`
  231. routers/ # REST routers
  232. auth/
  233. crypto.py # Ed25519 key management
  234. ssrf.py # SSRF protection for outbound HTTP
  235. services/
  236. identity_service.py # UAIT lifecycle, local data erasure
  237. agent_card_service.py # A2A agent card operations
  238. did_service.py # DID creation and resolution
  239. delegation_service.py # UCAN delegation tokens
  240. reputation_service.py # Trust scoring
  241. compliance_service.py # Operator-recorded profiles and assessment evidence
  242. credential_service.py # W3C VCs and VPs
  243. provenance_service.py # Training data, lineage, audit trail
  244. blockchain_service.py # Base L2 anchoring via EAS
  245. storage/ # Repository seam (file / memory / pg)
  246. signing/ # Signer seam (in-process / kms)
  247. audit/ # Tamper-evident event chain
  248. tenancy/ # Tenant context
  249. idempotency/ # Stripe-style idempotency keys + middleware
  250. blockchain/
  251. merkle.py # Merkle tree for batch anchoring
  252. tools/ # MCP tool definitions (one file per module)
  253. ```
  254. The pre-v0.4.0 flat layout (`services/`, `auth/`, `storage/`, ...) is
  255. preserved as deprecation shims at the same paths. They re-export from the
  256. canonical `attestix.*` namespace and emit a `DeprecationWarning` on first
  257. import. The shims are deprecated and retained in 0.5.0.
  258. ---
  259. ## MCP tools
  260. <details>
  261. <summary><strong>Identity</strong></summary>
  262. | Tool | Description |
  263. |------|-------------|
  264. | `create_agent_identity` | Create a UAIT from any identity source |
  265. | `resolve_identity` | Auto-detect token type and register |
  266. | `verify_identity` | Check existence, revocation, expiry, signature |
  267. | `translate_identity` | Convert to A2A, DID Document, OAuth, or summary |
  268. | `list_identities` | List UAITs with protocol/revocation filters |
  269. | `get_identity` | Get full UAIT details |
  270. | `revoke_identity` | Mark a UAIT as revoked |
  271. | `purge_agent_data` | Remove locally managed records and parseable local backups; external copies need separate handling |
  272. </details>
  273. <details>
  274. <summary><strong>Agent Cards</strong></summary>
  275. | Tool | Description |
  276. |------|-------------|
  277. | `parse_agent_card` | Parse an A2A Agent Card JSON |
  278. | `generate_agent_card` | Generate agent.json for hosting |
  279. | `discover_agent` | Fetch `/.well-known/agent.json` from a URL |
  280. </details>
  281. <details>
  282. <summary><strong>DID</strong></summary>
  283. | Tool | Description |
  284. |------|-------------|
  285. | `create_did_key` | Generate ephemeral `did:key` with Ed25519 keypair |
  286. | `create_did_web` | Generate `did:web` DID Document for self-hosting |
  287. | `resolve_did` | Resolve any DID to its DID Document |
  288. </details>
  289. <details>
  290. <summary><strong>Delegation</strong></summary>
  291. | Tool | Description |
  292. |------|-------------|
  293. | `create_delegation` | UCAN-style capability delegation token |
  294. | `verify_delegation` | Verify JWT signature, expiry, structure |
  295. | `list_delegations` | List delegations by agent and role |
  296. | `revoke_delegation` | Revoke a delegation token |
  297. </details>
  298. <details>
  299. <summary><strong>Reputation</strong></summary>
  300. | Tool | Description |
  301. |------|-------------|
  302. | `record_interaction` | Record outcome and update trust score |
  303. | `get_reputation` | Get score with category breakdown |
  304. | `query_reputation` | Search agents by reputation criteria |
  305. </details>
  306. <details>
  307. <summary><strong>Compliance</strong></summary>
  308. | Tool | Description |
  309. |------|-------------|
  310. | `create_compliance_profile` | Create EU AI Act profile with risk categorization |
  311. | `get_compliance_profile` | Retrieve full compliance profile |
  312. | `update_compliance_profile` | Update an existing compliance profile |
  313. | `get_compliance_status` | Gap analysis: completed vs missing requirements |
  314. | `record_conformity_assessment` | Record self or third-party assessment (Article 43) |
  315. | `generate_declaration_of_conformity` | Generate Annex V declaration + auto-issue VC |
  316. | `list_compliance_profiles` | Filter by risk category and compliance status |
  317. </details>
  318. <details>
  319. <summary><strong>Credentials</strong></summary>
  320. | Tool | Description |
  321. |------|-------------|
  322. | `issue_credential` | Issue W3C VC with Ed25519Signature2020 proof |
  323. | `verify_credential` | Check signature, expiry, revocation |
  324. | `verify_credential_external` | Verify any VC JSON from an external source |
  325. | `revoke_credential` | Revoke a Verifiable Credential |
  326. | `get_credential` | Get full VC details |
  327. | `list_credentials` | Filter by agent, type, validity |
  328. | `create_verifiable_presentation` | Bundle VCs into a signed VP for a verifier |
  329. | `verify_presentation` | Verify a VP with embedded credentials |
  330. </details>
  331. <details>
  332. <summary><strong>Provenance</strong></summary>
  333. | Tool | Description |
  334. |------|-------------|
  335. | `record_training_data` | Record training data source (Article 10) |
  336. | `record_model_lineage` | Record model chain and metrics (Article 11) |
  337. | `log_action` | Log agent action with hash-chained audit trail (Article 12) |
  338. | `get_provenance` | Get full provenance record |
  339. | `get_audit_trail` | Query audit log with filters |
  340. </details>
  341. <details>
  342. <summary><strong>Blockchain</strong></summary>
  343. | Tool | Description |
  344. |------|-------------|
  345. | `anchor_identity` | Anchor identity hash to Base L2 via EAS |
  346. | `anchor_credential` | Anchor credential hash to Base L2 via EAS |
  347. | `anchor_audit_batch` | Merkle batch anchor of audit log entries |
  348. | `verify_anchor` | Verify an on-chain anchor against local data |
  349. | `get_anchor_status` | Get anchoring status for an artifact |
  350. | `estimate_anchor_cost` | Estimate gas cost for anchoring |
  351. </details>
  352. ---
  353. ## Standards Conformance
  354. Public tests and conformance fixtures cover selected signature, canonicalization,
  355. credential, delegation and interface behavior. They do not establish universal W3C
  356. interoperability, legal conformity, certification or operating acceptance. Consult
  357. the test cases and the selected verifier's documented boundaries.
  358. Run them yourself:
  359. ```bash
  360. docker build -f Dockerfile.test -t attestix-bench . && docker run --rm attestix-bench
  361. ```
  362. | Standard | What is tested | Tests |
  363. |----------|---------------|:-----:|
  364. | **RFC 8032 (Ed25519)** | 4 IETF canonical vectors: key derivation, signature generation (exact match), verification, tamper rejection | 18 |
  365. | **W3C VC Data Model 1.1** | Credential structure, Ed25519Signature2020 proof, mutable field exclusion, VP structure, replay protection | 25 |
  366. | **W3C DID Core 1.0** | `did:key` and `did:web` document structure, roundtrip resolution, Ed25519VerificationKey2020 | 18 |
  367. | **UCAN v0.9.0** | JWT header (alg/typ/ucv), all payload fields, capability attenuation, expiry enforcement, revocation | 18 |
  368. | **MCP Protocol** | MCP tools registered, 9 modules, async convention, snake\_case naming | 5 |
  369. | **Performance** | Ed25519 key gen, JSON canonicalization, sign/verify, identity creation, credential ops | 7 |
  370. ### Performance
  371. Benchmark results depend on interpreter, hardware, storage and workload. Run the
  372. repository benchmarks on your target environment; no static latency figure here is
  373. an operating guarantee.
  374. ## Security
  375. - **Ed25519** signatures on all UAITs, VCs, assessments, declarations, and audit entries
  376. - **Hash-chained audit trail** with SHA-256 for tamper-evident logging
  377. - **SSRF protection** blocks private IPs, metadata endpoints, and DNS rebinding
  378. - **Encrypted key storage** with AES-256-GCM when `ATTESTIX_KEY_PASSWORD` is set
  379. - Private keys never exposed in tool responses
  380. - No external API calls required for core operations
  381. ---
  382. ## Research Paper
  383. Attestix is described in a research paper covering system architecture, cryptographic pipeline, governance evidence workflows, and evaluation with 531 automated tests (440 functional + 91 RFC / W3C conformance benchmarks).
  384. **[Attestix: A Unified Attestation Infrastructure for Autonomous AI Agents](https://github.com/VibeTensor/attestix/blob/main/paper/attestix-paper.pdf)**
  385. Pavan Kumar Dubasi, VibeTensor Private Limited, 2026.
  386. ### Citing Attestix
  387. If you use Attestix in your research, please cite:
  388. ```bibtex
  389. @article{dubasi2026attestix,
  390. title = {Attestix: A Unified Attestation Infrastructure for Autonomous AI Agents},
  391. author = {Dubasi, Pavan Kumar},
  392. year = {2026},
  393. url = {https://github.com/VibeTensor/attestix},
  394. note = {Open-source. Apache License 2.0}
  395. }
  396. ```
  397. ---
  398. ## Documentation
  399. Full documentation at **[attestix.io/docs](https://attestix.io/docs)**
  400. | Guide | Description |
  401. |-------|-------------|
  402. | [Getting Started](https://attestix.io/docs/getting-started) | Installation and first identity in 5 minutes |
  403. | [EU AI Act Compliance](https://attestix.io/docs/guides/eu-ai-act-compliance) | Step-by-step compliance workflow |
  404. | [Risk Classification](https://attestix.io/docs/guides/risk-classification) | How to determine your AI system's risk category |
  405. | [Architecture](https://attestix.io/docs/guides/architecture) | System design and data flows |
  406. | [API Reference](https://attestix.io/docs/reference/api-reference) | MCP tools with parameter tables |
  407. | [Integration Guide](https://attestix.io/docs/guides/integration-guide) | LangChain, OpenAI Agents SDK, CrewAI, MCP client |
  408. | [Configuration](https://attestix.io/docs/reference/configuration) | Environment variables, storage, Docker |
  409. | [Research Paper](https://attestix.io/docs/project/research) | Paper, citation formats, evaluation highlights |
  410. | [Reputation Scoring](https://attestix.io/docs/guides/reputation) | Recency-weighted trust scoring and categories |
  411. | [Examples](https://attestix.io/docs/examples) | End-to-end code examples for common workflows |
  412. ---
  413. ## Disclaimer
  414. Attestix generates machine-readable, cryptographically signed compliance documentation. It is a documentation and evidence tooling system. **It does not replace legal counsel, notified body assessments, or official regulatory submissions.** Always consult qualified legal professionals for compliance decisions.
  415. ---
  416. ## Sponsors
  417. Attestix is free and open-source. If you or your organization benefit from it, please consider sponsoring to support continued development, security audits, and infrastructure.
  418. <a href="https://github.com/sponsors/VibeTensor"><img src="https://img.shields.io/badge/Sponsor-GitHub%20Sponsors-ea4aaa?style=flat-square&logo=github" alt="GitHub Sponsors" /></a>
  419. ---
  420. ## Contributing
  421. See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
  422. ## License
  423. Apache License 2.0. See [LICENSE](LICENSE).
  424. ---
  425. <p align="center">
  426. <a href="https://vibetensor.com">
  427. <img src="https://raw.githubusercontent.com/VibeTensor/attestix/main/docs/assets/atx_gold.svg" alt="Attestix" width="48" />
  428. </a>
  429. </p>
  430. <p align="center">
  431. Built by <a href="https://vibetensor.com">VibeTensor</a>
  432. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.