Introduction

Solana Attestations is a public good program for associating offchain data with onchain accounts. The system provides a framework for creating verifiable claims about accounts, enabling developers to build reputation systems, compliance tools, and other trust-based applications.

Why Attestations?

• Verifiable Claims: Create cryptographically verifiable statements about accounts
• Flexible Schemas: Define custom data structures for different types of attestations
• Authority Management: Control who can issue attestations through credential systems
• Token Integration: Link attestations to specific token accounts for targeted claims
• On-Chain Storage: Keep attestation data on Solana for transparency and permanence

Quick Start

Install the Solana Attestations library:

# Using pnpm (recommended)
pnpm add sas-lib

# Using npm
npm install sas-lib

# Using yarn
yarn add sas-lib

For Rust projects:

cargo add solana-attestation-service-client

→ Installation Quick Start - Get up and running quickly

→ Overview - Detailed overview and architecture

Core Concepts

The Attestations system is built around three main components:

Credentials

A credential represents an attestation authority that can issue attestations. Each credential has authorized signers who can create attestations under its authority.

Schemas

A schema defines the structure and validation rules for attestations. Schemas serve as templates specifying what fields an attestation should contain and how they should be formatted.

Attestations

An attestation represents a verified claim or statement. Attestations are created by authorized signers under a credential and follow a specific schema structure.

Use Cases

Attestations enable a wide range of applications:

• Identity Verification: Verify user identities and KYC compliance
• Reputation Systems: Build trust scores and reputation metrics
• Compliance Tools: Ensure regulatory compliance for DeFi protocols
• Certification Programs: Issue and verify professional certifications
• Supply Chain Tracking: Track provenance and authenticity of goods
• Social Proof: Verify social media accounts and community membership

Architecture

The system follows a hierarchical structure:

1. Authorities create credentials that define who can issue attestations
2. Schemas are created under credentials to define attestation data structure
3. Attestations are issued by authorized signers following the schema format
4. Token Accounts can be linked to attestations for targeted claims

Getting Started

Explore the documentation based on your use case:

• Quick Start Guides - Get up and running quickly
• Credentials - Learn about attestation authorities
• Schemas - Define data structures for attestations
• Attestations - Create and manage verifiable claims
• Instructions - Complete API reference for all operations

Community & Support

• Questions? Ask on Solana Stack Exchange (use the attestations tag)
• Issues? Report on GitHub Issues

Source

GitHub Repository](https://github.com/solana-foundation/solana-attestation-service)

Built and maintained by the Solana Foundation.

Licensed under Apache License, Version 2.0.