Repository navigation
Releases
Releases Β· vinaybhosle/agentstamp
v2.3.0 β Accountability & Compliance
What's New
Accountability
- Human sponsor field β Link an agent to its human operator (email/URL). Appears in passports, MCP tools, and compliance reports
- Key rotation & revocation β
POST /api/v1/stamp/revoke/:stampIdwith reasons: key_compromise, key_rotation, decommissioned, owner_request
EU AI Act Compliance
- Compliance report β
GET /api/v1/compliance/report/:agentIdreturns structured Article 52 transparency, risk level, audit summary, trust status - AI Act fields β
ai_act_risk_level(minimal/limited/high) andtransparency_declarationon agent registration
Interoperability
- W3C Verifiable Credentials β
GET /api/v1/passport/:wallet/vcexports agent passport as a W3C VC Data Model 2.0 credential. Interoperable with any VC verifier - DNS-based discovery β Add
_agentstamp.yourdomain.comTXT record. Verify withGET /api/v1/discovery/dns/:domain
MCP Tools (15 β 17)
compliance_reportβ EU AI Act compliance dataget_verifiable_credentialβ W3C VC exportdns_discoveryβ DNS TXT record verification
Webhook Events (12 β 14)
agent_expiredβ dispatched when agents expire during cleanupagent_updatedβ dispatched when agent profile is updated
Security
- Webhook DNS SSRF: switched to dual-stack DNS resolution (all IPs checked)
- Wallet auth: removed body fallback on signed endpoints (header-only)
- Rate limiters added to /well and /bridge routes
- MCP limit params constrained to max 100 via Zod
- transparency_declaration: 2KB size cap + allowlisted keys
Infrastructure
- Browse API returns
totalcount for accurate pagination - Shared constants module (
src/constants.js) - E2E test suite for v2.3.0 features
- Node 22 LTS pinned via
.node-version
Full test suite: 196 tests (188 unit + 8 E2E) β all green
v2.2.0 β Deep Security Hardening
What's New
Security (42 fixes across 2 audit rounds)
- SSRF protection with dual-stack IPv4+IPv6 DNS resolution and DNS rebinding prevention
- Payment replay detection: L1 in-memory cache + L2 SQLite with atomic dedup
- Audit endpoints now require wallet signature or admin key
- Wallet linking requires dual-signature proof (primary + linked wallet)
- Body hash binding with canonical JSON key ordering prevents replay
- Recursive metadata validation with depth limit (prototype pollution prevention)
- Sentry PII scrubbing: wallet headers redacted, signatures/admin keys removed
- mcp-stdio temp directory restricted to mode 0o700
- Atomic transactions for wish grants (double-grant prevention)
- Configurable rate limiters via environment variables
Tests
- All 15 E2E test suites updated for post-hardening auth requirements
- 607/607 tests passing (396 E2E + 211 unit)
Version
- Bumped to 2.2.0 across all discovery files, health endpoint, MCP server, OpenAPI spec, and ERC-8004 registration
v2.1.0 β Security Hardening
Security Hardening Release
12 vulnerability fixes across authentication, payment replay, SSRF, input validation, and CI/CD security.
CRITICAL
- Signature body-binding: Legacy fallback deprecated (30-day sunset). Signatures without body hash now emit
X-AgentStamp-Deprecationheader.
HIGH
- Payment replay protection: Dedup hashes persisted to SQLite β survives server restarts (24hr TTL)
- GitHub Action injection fix: Inputs use environment variables instead of direct shell interpolation
- SSRF hardening: IPv6-mapped IPv4, decimal/hex IP, and DNS rebinding protection on webhook registration
- Startup validation: Server refuses to start without required secrets (
BLIND_TOKEN_SECRET,IP_HASH_SALT) - Registry rate limiting: Browse, search, and leaderboard endpoints now rate-limited (60 req/min)
- Free-tier resilience: Free stamp/registration endpoints remain available when x402 payment service is down
MEDIUM
- Webhook ownership uses wallet linking for list/delete operations
- Prototype pollution guard on metadata input (
__proto__,constructor,prototypestripped) - Database file permissions hardened to
0600on startup - CI pipeline fails on HIGH+ npm audit vulnerabilities
- Admin and analytics authentication keys disambiguated
Infrastructure
- Sentry error monitoring instrumentation added
- Shared
timingSafeCompareutility extracted
211 unit tests passed. E2E: flow14 (68/68) + flow15 (42/42) β 0 regressions.
v2.0.0 β Trust Intelligence Platform
AgentStamp v2.0.0
Trust intelligence for AI agents β identity stamps, reputation scoring, registry, forensic audit trails, and A2A passports via x402 micropayments.
Highlights
- 19 MCP tools for agent trust verification
- x402 V2 dual-chain payments (Base + Solana USDC)
- ERC-8004 bridge (lookup, trust check, link)
- Dynamic reputation scoring (0-100) with decay
- Ed25519 signed forensic audit chain (17 event types)
- A2A v0.3 compatible passports
- SDK: npm
agentstamp-verify+ PyPIagentstamp