Home

AgentID Wiki

Welcome to the AgentID Wiki - the comprehensive documentation for the Bags-native trust verification layer for AI agents on Solana.

What is AgentID?

AgentID is a trust verification layer that:

• Wraps Bags' Ed25519 agent authentication flow to establish wallet ownership
• Binds agent identities to the Solana Agent Registry (SAID Protocol)
• Adds Bags-specific reputation scoring (0-100)
• Surfaces human-readable trust badges inside Bags chat and embeddable widgets

Quick Links

• Main Repository
• Getting Started - Installation and setup guide
• API Reference - Complete API documentation
• Widget Guide - Embedding trust badges

Table of Contents

Overview

• Project Overview - Introduction to AgentID
• Project Core Components - Six major subsystems
• Getting Started - Installation and setup

Architecture

• Architecture Overview - System architecture
• Architecture Component Interactions - Component communication
• Architecture Data Flow - Data transformation flows
• Architecture Security - Security architecture
• Architecture Technology Stack - Technology choices

Backend API

• Backend API Reference - Complete API documentation
• Api Reference - API overview and examples

Database

• Database Design - Schema and data model
• Database Connection Management - Connection pooling

Services

• Service Layer - Business logic services
• Service Authentication Services - Auth and PKI
• Service Badge Services - Badge generation

Frontend

• Frontend Application - React UI documentation

Build & Deployment

• Build Deployment - Build and deployment guide

Development

• Developer Guide - Developer onboarding
• Developer Guidelines - Coding standards
• Configuration Management - Environment setup
• Security Implementation - Security practices
• Testing Strategy - Testing approach

Widgets

• Widget Guide - Embedding trust badges
• Widget System - Widget architecture

Key Features

PKI Challenge-Response

Ed25519-based challenge-response mechanism prevents spoofing and replay attacks.

Reputation Scoring

Five-factor scoring system:

• Fee activity (max 30 points)
• Success rate (max 25 points)
• Registration age (max 20 points)
• SAID trust score (max 15 points)
• Community verification (max 10 points)

Trust Badges

Multiple badge formats:

• JSON API for custom implementations
• SVG for documentation and README
• HTML widget for iframe embedding

Technology Stack

Layer	Technology
Backend	Node.js, Express.js
Frontend	React 18, Vite, TailwindCSS
Database	PostgreSQL 14+
Cache	Redis 7+
Crypto	Ed25519 (tweetnacl)

Contributing

Please read our Developer Guidelines before contributing to the project.

Support

For issues and feature requests, please use the GitHub Issues page.