SRWA Protocol

Native, institution-ready security tokens on Solana

SRWA (Solana Real-World Assets) brings real-world assets to DeFi without bridges or intermediaries. Our tokens embed offering rules, compliance policies, investor restrictions, and institutional governance directly on-chain, enabling issuers and investors to interact with programmable RWAs that stay 100% on Solana.

🚀 Why SRWA?

Traditional RWA wrappers lack enforceable rules, accountability, and on-chain auditability. SRWA introduces a Solana-native token standard that carries governance, compliance, and distribution logic inside the asset itself.

Key Benefits

🔒 Built-in Compliance: Transfer hooks enforce KYC/AML at the token level
🏦 Institutional Grade: Designed for regulated financial institutions
⚡ Lightning Fast: Leverages Solana's 400ms block time and low fees
🔗 DeFi Compatible: Works seamlessly with MarginFi, Solend, Jupiter, and more
🛡️ On-chain Governance: Transparent, auditable, and programmable

📦 Repository Structure

programs/              # Anchor smart contracts (SRWA standard)
  ├── srwa_factory/        # Token factory with SPL Token-2022
  ├── identity_claims/     # KYC/AML identity registry
  ├── compliance_modules/  # Jurisdiction, sanctions, lockups
  ├── srwa_controller/     # Transfer hook orchestrator
  ├── offering_pool/       # Capital formation lifecycle
  ├── purchase_order/      # OTC-style order flow
  └── ...

frontend/              # React + Vite institutional dashboard
  ├── src/
  │   ├── components/      # UI components
  │   ├── hooks/           # Solana & SRWA hooks
  │   ├── contexts/        # Wallet & program contexts
  │   └── pages/           # Dashboard pages
  └── ...

tests/                 # Anchor integration tests
examples/              # End-to-end scripts

🏗️ Architecture

Smart Contract Stack

All programs are written in Rust with Anchor. Program IDs are configured in Anchor.toml and loaded dynamically in the frontend.

Program	Purpose	Key Instructions
srwa_factory	Token factory for SPL Token-2022 with transfer hooks, metadata, offering state	`create_srwa`, `request_srwa`, `approve_srwa`, `register_user`
identity_claims	Identity registry with topic-based claims (KYC, AML, Accredited)	`register_identity`, `add_claim`, `revoke_claim`, `is_verified`
compliance_modules	Pluggable policies: jurisdictions, sanctions, lockups, investor limits	`configure_jurisdiction`, `set_sanctions`, `set_lockup`
srwa_controller	Token-2022 transfer hook orchestrator for compliance checks	`on_transfer`, `transfer_checked`
offering_pool	Capital formation lifecycle (open, subscribe, lock, settle, refund)	`open`, `subscribe`, `lock`, `settle`, `refund`
purchase_order	OTC-style order flow with SOL escrow	`create_order`, `approve_order`, `cancel_order`

Core Data Accounts

SRWAConfig, OfferingState, ValuationData: Per-mint configuration PDAs
PlatformAdminRegistry, KYCProviderRegistry, IssuerKYCConfig: Governance registries
UserRegistry: Wallet-level role, KYC status, activation flags
IdentityAccount & ClaimAccount: Identity graph with topic IDs
JurisdictionConfig, SanctionsList, LockupAccount: Modular compliance state

🎯 Use Cases

For Issuers / Banks

Single integration surface for DeFi-ready distribution
Force transfer, freeze, lockups with event logging
Built-in compliance eliminates manual checks

For Investors

Deposit SRWA as collateral, borrow stablecoins
Access to Solana DeFi: lending, swaps, yield
Transparent pricing and compliance status

For DeFi Protocols

Plug-and-play SRWA support via transfer hooks
Pre-flight eligibility checks avoid failed transactions
Integration allowlist for authorized protocols

🛠️ Getting Started

Prerequisites

Rust 1.75+
Solana CLI 1.18+
Anchor CLI 0.31.1+
Node.js 18+ (Node 22 recommended)

Install Tooling

# Install Anchor CLI
cargo install --git https://github.com/coral-xyz/anchor --tag v0.31.1 anchor-cli

# Configure Solana
solana-install init 1.18.0
solana config set --url devnet

Build Smart Contracts

# Clone repository
git clone https://github.com/your-org/srwa-protocol
cd srwa-protocol

# Build all programs
anchor build

# Run tests
anchor test

Deploy Contracts

# Deploy to devnet
anchor deploy --provider.cluster devnet

# Or deploy to localnet
solana-test-validator --reset
anchor deploy --provider.cluster localnet

💻 Frontend Development

The frontend is a React 18 + Vite 7 + TypeScript institutional dashboard with Solana wallet integration.

Quick Start

cd frontend
npm install
npm run dev

Environment Configuration

Create frontend/.env:

VITE_SOLANA_NETWORK=devnet
VITE_SOLANA_RPC_URL=https://api.devnet.solana.com
VITE_ENABLE_DASHBOARD=true

Wallet Support

Integrated with @solana/wallet-adapter:

Phantom
Backpack
Solflare
Torus

Build for Production

npm run build

# Output in frontend/dist/

🔐 Security & Compliance

Compliance Flow

Every SRWA transfer triggers compliance checks:

Global Pause Check: System-wide pause state
Account Frozen Check: Individual account freeze
Integration Allowlist: Authorized protocol check
Identity Verification: KYC/AML claim validation
Jurisdiction Module: Geographic restrictions
Sanctions Module: OFAC/sanctions list
Accredited Module: Investor accreditation
Lockup Module: Time-based restrictions
Max Holders Module: Holder count limits

Error Codes

0   OK
10  PAUSED
11  FROZEN_FROM
12  FROZEN_TO
13  NOT_ALLOWED_OPERATOR
14  FROM_NOT_VERIFIED
15  TO_NOT_VERIFIED
20  SANCTIONS_DENY
21  JURISDICTION_DENY
22  WINDOW_CLOSED
23  NOT_ACCREDITED
24  LOCKUP_ACTIVE
25  MAX_HOLDERS_EXCEEDED

📚 Workflows

Issuer Flow

Connect wallet → Register role (requires admin approval)
Submit request_srwa with token config
Admin approves via approve_srwa
Open offering, accept subscriptions
Settle distribution to investors

Investor Flow

Register identity → Obtain KYC/AML claims
Subscribe to offerings
Receive SRWA via settlement
Hold or transfer (subject to compliance)

Admin Flow

Initialize PlatformAdminRegistry
Manage KYC providers and allowlists
Approve/reject SRWA requests
Monitor compliance events

🎨 Design System

The frontend uses a modern glassmorphism design with Solana branding:

Colors

Primary Purple: #9945FF (Solana brand)
Secondary Green: #14F195 (Success)
Accent Orange: #FF6B35
Background: Deep black #0A0A0A

Components

Built with Radix UI primitives
Styled with TailwindCSS
Glassmorphism effects and gradients
Animated transitions and micro-interactions

🗺️ Roadmap

Phase 1 (Current)

✅ Core smart contracts deployed
✅ Transfer hook compliance pipeline
✅ Identity claims & KYC registry
✅ Frontend dashboard MVP
🔄 Integration testing

Phase 2 (Q2 2025)

Pyth Oracle integration
Yield adapter (MarginFi/Solend)
Offering pool treasury logic
Advanced analytics dashboard
Cashflow engine for structured products

Phase 3 (Q3 2025)

📖 Documentation

Smart Contracts: See inline documentation in programs/
Frontend: Component docs in frontend/src/components/
API Reference: TypeScript types in frontend/src/types/
Integration Guide: Examples in examples/

🤝 Contributing

We welcome contributions! Please follow these guidelines:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Development Guidelines

Follow Rust and TypeScript best practices
Write tests for new features
Update documentation
Maintain consistent code style

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙋 Support & Contact

Issues: GitHub Issues
Discussions: GitHub Discussions
Discord: Join our community
Twitter: @SRWAProtocol

🌟 Acknowledgments

Built with:

Anchor - Solana development framework
SPL Token-2022 - Next-gen token standard
Solana - High-performance blockchain
React - UI framework
Vite - Build tool

Built with Anchor ⚓ on Solana ☀️

Bringing institutional RWAs to programmable DeFi liquidity

Name		Name	Last commit message	Last commit date
Latest commit History 116 Commits
examples		examples
frontend		frontend
migrations		migrations
patches/anchor-syn-0.32.1		patches/anchor-syn-0.32.1
programs		programs
scripts		scripts
tests		tests
.gitignore		.gitignore
.gitignore-protocol		.gitignore-protocol
.prettierignore		.prettierignore
Anchor.toml		Anchor.toml
Cargo.toml		Cargo.toml
README.md		README.md
REDEPLOY_INSTRUCTIONS.md		REDEPLOY_INSTRUCTIONS.md
TRANSFER_HOOK_SETUP.md		TRANSFER_HOOK_SETUP.md
package.json		package.json
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

SRWA Protocol

🚀 Why SRWA?

Key Benefits

📦 Repository Structure

🏗️ Architecture

Smart Contract Stack

Core Data Accounts

🎯 Use Cases

For Issuers / Banks

For Investors

For DeFi Protocols

🛠️ Getting Started

Prerequisites

Install Tooling

Build Smart Contracts

Deploy Contracts

💻 Frontend Development

Quick Start

Environment Configuration

Wallet Support

Build for Production

🔐 Security & Compliance

Compliance Flow

Error Codes

📚 Workflows

Issuer Flow

Investor Flow

Admin Flow

🎨 Design System

Colors

Components

🗺️ Roadmap

Phase 1 (Current)

Phase 2 (Q2 2025)

Phase 3 (Q3 2025)

📖 Documentation

🤝 Contributing

Development Guidelines

📄 License

🙋 Support & Contact

🌟 Acknowledgments

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages