Skip to content

chinesepowered/solana-cypherpunk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UniProof 🎓

Tamper-proof academic credentials on the Solana blockchain

UniProof is a revolutionary platform that enables universities and educational institutions to issue tamper-proof degree and certification attestations directly on the Solana blockchain. Students receive their academic credentials as cryptographically signed attestations that they fully own and control.

🌟 Key Features

For Universities

  • Issue Credentials On-Chain: Create immutable academic credentials stored on Solana
  • Multi-Signature Security: Requires both registrar and dean signatures for legitimacy
  • Revocation Mechanisms: Built-in support for revoking credentials in case of fraud

For Students

  • Full Ownership: Students control their credentials without intermediaries
  • Instant Sharing: Share credentials with employers in seconds
  • Selective Disclosure: Prove you have a degree without revealing sensitive information
  • Portable: Credentials are tied to your wallet, not an institution's database

For Employers

  • Instant Verification: Verify any credential in seconds by checking the blockchain
  • Zero Cost: No expensive third-party verification services
  • 100% Authentic: Cryptographically impossible to forge or alter

🏗️ Architecture

Smart Contract (Anchor/Rust)

Located in programs/uniproof/src/lib.rs, the Solana program handles:

  • University registration
  • Credential issuance with multi-sig support
  • Registrar and dean signatures
  • Credential verification
  • Revocation mechanisms
  • Selective disclosure proofs

Frontend (Next.js + TypeScript)

  • University Portal (/university): Register and issue credentials
  • Student Portal (/student): View and manage credentials
  • Verification Portal (/verify): Instant credential verification
  • Wallet Integration: Phantom, Solflare, Backpack support

🚀 Quick Start

Prerequisites

  • Node.js 18+ and pnpm
  • Rust and Anchor CLI (for smart contract development)
  • Solana CLI tools
  • A Solana wallet (Phantom, Solflare, or Backpack)

Installation

  1. Clone the repository
git clone <your-repo-url>
cd solana-cypherpunk
  1. Install dependencies
pnpm install
  1. Build the Solana program (if modifying smart contract)
anchor build
  1. Deploy to Devnet (first time)
anchor deploy --provider.cluster devnet
  1. Run the frontend
pnpm dev

Open http://localhost:3000 to see the application.

📖 Usage Guide

For Universities

  1. Connect Wallet: Connect your institution's wallet
  2. Initialize University: Register your institution on-chain
  3. Issue Credentials:
    • Enter student wallet address
    • Fill in degree details (type, field, graduation date)
    • Submit transaction
  4. Multi-Signature: Have registrar and dean sign the credential

For Students

  1. Connect Wallet: Connect your personal Solana wallet
  2. View Credentials: All credentials issued to your wallet appear automatically
  3. Share: Copy credential address to share with employers
  4. Verify Status: Check registrar and dean signature status

For Employers

  1. No Wallet Required: Verification can be done without connecting a wallet
  2. Enter Address: Paste the credential address provided by the student
  3. Instant Result: See full credential details and verification status
  4. Check Signatures: Verify both registrar and dean have signed

🔐 Security Features

  • Multi-Signature: Credentials require signatures from both registrar and dean
  • Immutable Storage: All data stored on Solana blockchain
  • Cryptographic Proof: Impossible to forge or tamper with credentials
  • Revocation Support: Institutions can revoke credentials if needed
  • Selective Disclosure: Students can prove credentials without revealing all details

🛠️ Tech Stack

  • Blockchain: Solana
  • Smart Contracts: Anchor Framework (Rust)
  • Frontend: Next.js 15, React 19, TypeScript
  • Styling: TailwindCSS 4
  • Wallet Adapter: Solana Wallet Adapter
  • Icons: Lucide React

📁 Project Structure

solana-cypherpunk/
├── programs/
│   └── uniproof/
│       ├── src/
│       │   └── lib.rs          # Anchor smart contract
│       └── Cargo.toml
├── app/
│   ├── page.tsx                # Landing page
│   ├── university/
│   │   └── page.tsx            # University dashboard
│   ├── student/
│   │   └── page.tsx            # Student portal
│   ├── verify/
│   │   └── page.tsx            # Verification portal
│   └── layout.tsx
├── src/
│   ├── components/
│   │   ├── layout/
│   │   │   └── Navbar.tsx
│   │   ├── providers/
│   │   │   └── WalletProvider.tsx
│   │   └── ui/                 # Reusable UI components
│   ├── hooks/
│   │   └── useUniProof.ts      # Custom hook for UniProof client
│   ├── idl/
│   │   └── uniproof.ts         # Generated IDL
│   └── lib/
│       └── solana/
│           └── uniproof-client.ts  # Client SDK
├── Anchor.toml
└── package.json

🎯 Roadmap

  • Deploy to Solana mainnet
  • Add support for multiple credential types
  • Implement zero-knowledge proofs for advanced selective disclosure
  • Create mobile app
  • Add NFT metadata standard compliance
  • Integration with educational institution APIs
  • Batch credential issuance
  • Advanced analytics dashboard

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is built for the Solana Hackathon.

🔗 Links

💡 Use Cases

  • Universities: Issue tamper-proof degrees and certificates
  • Bootcamps: Provide verifiable completion certificates
  • Online Courses: Issue verified course completion credentials
  • Professional Certifications: Certify professional qualifications
  • Background Checks: Instant verification for employment screening

🎓 Hackathon Project

Built for the Solana Hackathon - transforming academic credentials with blockchain technology.


Made with ❤️ on Solana

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages