Pediment MVP

Bank-grade stablecoin infrastructure. Built for the GENIUS Act.

What It Does

Terminal-based stablecoin minting with built-in compliance:

• Whitelist KYC-approved addresses for token operations
• Mint tokens to approved recipients with audit trails
• Query balances and transaction history
• Audit all operations in PostgreSQL database

Architecture

CLI (TypeScript) → RPC Server (Go) → Solana Devnet
                        ↓
                  PostgreSQL (audit logs)

Quick Start

# Clone and install
git clone https://github.com/pediment/mint-mvp
cd mint-mvp && make install

# Start server
make dev

# Add address to whitelist (new terminal)
pediment whitelist add 8ecJkvxwFUPo5JjH2xBHPpHSCZ8NNX7Q8TeXiiR6zQFW --entity-name "Community Bank"

# Mint tokens
pediment mint --to 8ecJkvxwFUPo5JjH2xBHPpHSCZ8NNX7Q8TeXiiR6zQFW --amount 1000000

Available Commands

• whitelist - Manage KYC-approved addresses (add, remove, list)
• mint - Issue tokens to whitelisted addresses with compliance checks
• balance - Check SOL balance of any Solana address
• init - Initialize token configuration (planned)

Key Features

• 10x cheaper than SWIFT (0.1% vs 6.25% fees)
• Instant settlement vs 3-day wire transfers
• GENIUS Act compliant from day one
• Solana-native for ultra-low transaction costs

Requirements

• Go 1.21+ for RPC server
• Bun/Node.js 18+ for CLI
• PostgreSQL 15+ for audit logs
• Solana devnet SOL for testing

Project Structure

mint-mvp/
├── cmd/pediment/           # Go RPC server entry point
├── internal/
│   ├── rpc/               # HTTP API handlers
│   ├── chain/             # Solana client integration
│   ├── db/                # PostgreSQL models
│   └── config/            # Configuration management
├── cli/
│   ├── src/               # TypeScript CLI source
│   └── dist/              # Built CLI executable
├── scripts/seed.sql       # Database schema
├── config.yaml           # Server configuration
├── Makefile              # Build automation
└── docs/                 # Documentation

Documentation

• Installation Guide - Setup in 2 minutes
• Live Demo - 5-minute investor walkthrough
• Command Reference - All available commands

Development Status

✅ MVP Complete:

• Database-backed whitelist management
• Professional CLI interface with clean TUI
• RESTful API server with validation
• Audit logging for all operations
• Security validations and compliance checks

🔄 Next Steps:

• Actual Solana token minting (currently mock)
• JWT authentication for operators
• Additional commands (burn, transfer, audit)
• Comprehensive testing suite

Security

• All operations require whitelisted addresses
• Audit trails for compliance reporting
• Database-backed KYC status tracking
• Role-based access controls (planned)

---

Ready for investor demos. See Live Demo for complete walkthrough.