Solana Stablecoin Standard (SSS)

A modular, compliance-ready stablecoin framework for Solana using Token-2022.

SSS provides a complete on-chain toolkit for issuing and managing stablecoins, from minimal single-authority tokens to fully compliant assets with transfer restrictions, blacklists, asset seizure, and GENIUS Act reserve attestations. The framework ships as two Anchor programs, a TypeScript SDK, and a Rust CLI with an interactive TUI dashboard.

Architecture

SSS is composed of two on-chain Anchor programs that work together:

Both programs are built on Solana Token-2022 extensions and use PDA-based state management with role-based access control.

Presets

SSS defines three built-in presets and a custom mode. Each preset activates a specific combination of Token-2022 extensions and program features.

For a detailed comparison, see docs/presets.md.

Quick Start

Prerequisites

• Rust 1.75+ with Cargo
• Solana CLI 2.x (Agave)
• Anchor 0.31.1
• Node.js 18+

Build

anchor build

If the build fails with a blake3 edition2024 parse error, pin the dependency:

cargo update -p blake3 --precise 1.5.5
anchor build

Test

anchor test

The test suite runs 60 integration tests across all presets plus SDK integration and 69 fuzz/property tests.

Build the CLI

cargo build -p sss-cli

The binary is output to target/debug/sss (or target/release/sss with --release).

Project Structure

programs/
  sss-token/          # Core program — 14 instructions, 5 account types, 25 error codes
  sss-transfer-hook/  # Transfer hook — blacklist enforcement on every transfer (SSS-2)
sdk/                  # TypeScript SDK — SSSClient, PDA helpers, oracle module, presets
cli/                  # Rust CLI — 14 subcommands + interactive ratatui TUI dashboard
app/                  # Next.js frontend — landing page + wallet-connected dashboard
backend/              # Express.js REST API wrapping the SDK
tests/                # Anchor integration + E2E devnet tests
docs/                 # Architecture, presets, compliance, operations docs

Features

On-Chain Program (14 Instructions)

• initialize -- Create a new stablecoin mint with Token-2022 extensions, config PDA, and role registry
• mint_tokens -- Mint tokens to a recipient (requires active minter with sufficient quota)
• burn_tokens -- Burn tokens from the caller's token account
• freeze_account -- Freeze a token account (master authority or pauser)
• thaw_account -- Thaw a frozen token account
• pause -- Pause all minting and burning operations globally
• unpause -- Resume operations after a pause
• update_roles -- Assign or reassign pauser, blacklister, and seizer roles
• update_minter -- Create or update a minter with active status and mint quota
• transfer_authority -- Transfer master authority to a new address
• blacklist_add -- Add an address to the blacklist and freeze their token account (SSS-2)
• blacklist_remove -- Remove an address from the blacklist and thaw their token account (SSS-2)
• seize -- Seize tokens from a blacklisted address via burn+mint (SSS-2)
• attest_reserve -- Record an on-chain reserve attestation with hash, amounts, and URI (GENIUS Act)

Role-Based Access Control

GENIUS Act Compliance

On-chain reserve attestations store a SHA-256 hash of off-chain reserve proof data, total reserves in USD, total outstanding tokens, the attester's public key, and a URI pointing to the full audit report. Each attestation is indexed and immutable once recorded.

Oracle Integration

The SDK includes an OracleModule for fetching real-time price data from Pyth price feeds, computing reserve hashes, and building attestation data structures.

Interactive TUI Dashboard

The CLI ships with an interactive terminal dashboard (powered by ratatui) that displays live stablecoin configuration, supply metrics, role assignments, and minter status.

SDK

The TypeScript SDK provides a high-level SSSClient for interacting with both programs.

npm install @solana-stablecoin-standard/sdk

See sdk/README.md for the full API reference.

CLI

The Rust CLI (sss) provides all program operations as subcommands with formatted terminal output.

cargo install --path cli
sss --help

See cli/README.md for the complete command reference.

Documentation

• Architecture -- PDA schema, Token-2022 extensions, transfer hook flow, role model
• Presets -- Feature comparison matrix and use cases
• SSS-1 Specification -- Minimal stablecoin preset details
• SSS-2 Specification -- Compliant stablecoin preset with transfer hook
• SSS-3 Specification -- Private stablecoin preset with confidential transfers
• Compliance -- GENIUS Act mapping, OFAC screening, regulatory considerations
• Operations -- Operator runbook: deployment, monitoring, incident response
• API Reference -- Backend REST API endpoint documentation

Devnet Deployment

Both programs are deployed to Solana devnet:

Deploy to Devnet

./scripts/deploy-devnet.sh

The deploy script will:

1. Configure Solana CLI for devnet
2. Build programs if needed
3. Deploy both programs
4. Run example transactions (init SSS-1, add minter, mint tokens)

Example Devnet Transactions

Example Mint: 9MmnDN61FaYd7SRzsnHmwEMj1jbTWh1XD4xaM9nWYujv

Live Demo: Full SSS-2 Workflow

Every operation executed end-to-end on Solana devnet against a single SSS-2 mint. Click any signature to verify on Solana Explorer.

Mint: C9TssJentaYfyyfbhihHRGfxS5t3aWHS8LoXJbopyLgp

All 14 operations executed successfully on devnet in a single automated E2E run.

Example CLI Usage (Devnet)

# Initialize a stablecoin
sss --url https://api.devnet.solana.com init --preset sss-1 --name "DevnetUSD" --symbol "dUSD"

# Check status
sss --url https://api.devnet.solana.com status --mint 9MmnDN61FaYd7SRzsnHmwEMj1jbTWh1XD4xaM9nWYujv

# View supply
sss --url https://api.devnet.solana.com supply --mint 9MmnDN61FaYd7SRzsnHmwEMj1jbTWh1XD4xaM9nWYujv

# Launch TUI dashboard
sss --url https://api.devnet.solana.com dashboard --mint 9MmnDN61FaYd7SRzsnHmwEMj1jbTWh1XD4xaM9nWYujv

Build Notes

• blake3 pinning: Platform tools ship Cargo 1.84 which cannot parse edition = "2024" in blake3 >= 1.6. Pin to 1.5.5 with cargo update -p blake3 --precise 1.5.5.
• Feature name: The Token-2022 feature is token_2022 (underscore), not token-2022 (hyphen).
• Anchor version: 0.31.1. The init-if-needed feature is required in anchor-lang for the UpdateMinter instruction.
• Seize mechanism: Seize uses burn+mint (not transfer_checked) to bypass the transfer hook for privileged operations.

License

MIT