Chainlink Data Streams Oracle-Backed Cross-Chain Stablecoin Workshop

🎯 Overview

This repository contains a complete workshop implementation of an oracle-backed stablecoin system that integrates Chainlink Data Streams for real-time price feeds and Chainlink CCIP for cross-chain functionality on Solana and Ethereum.

Built on Official Chainlink Tools:

• Chainlink Data Streams SDK - Official SDK for real-time price feed integration
• Chainlink Solana CCIP Starter Kit - Official starter kit for cross-chain functionality

Workshop Content

• Real-time price integration via Chainlink Data Streams SDK
• Oracle program for on-chain price verification and storage
• Stablecoin program with collateral management and minting logic
• Cross-chain transfers using Chainlink CCIP
• Multisig authority management with SPL Token multisig integration
• Production-ready testing with comprehensive test suites

Workshop Instructors

• Harry - Chainlink Data Streams and Oracle Program implementation
• Jae - Stablecoin integration with Oracle Program and Cross-Chain CCIP configuration

Workshop Setup Guide

Ready to build? Follow the complete step-by-step guide:

→ INSTRUCTIONS.md - Complete prerequisites, installation, and deployment walkthrough

For Korean instructions, see INSTRUCTIONS_KR.md.

If you encounter any issues during the workshop, check the troubleshooting section in INSTRUCTIONS.md.

📁 Project Structure

solana-stablecoin-workshop/
├── README.md                    # This overview and instructions
├── INSTRUCTIONS.md              # Complete step-by-step deployment guide
├── oracle/                      # Chainlink Data Streams & Oracle Program
├── cross-chain-stablecoin/      # Stablecoin & CCIP Integration
├── solana-starter-kit/          # CCIP Solana integration scripts and libraries
└── smart-contract-examples/     # Ethereum smart contracts for CCIP

🏗️ System Architecture

graph LR
    subgraph "📊 Data Streams (Harry)"
        DS[Chainlink Data Streams<br/>Real-time SOL/USD]
        OC[Rust Client<br/>Fetches & Processes]
        OP[Oracle Program<br/>Verifies & Stores]
        
        DS --> OC --> OP
    end
    
    subgraph "🪙 Stablecoin System (Jae)"
        SP[Stablecoin Program<br/>Mint/Burn Logic]
        MS[SPL Token Multisig<br/>1-of-3 Authority]
        
        OP --> SP
        SP --> MS
    end
    
    subgraph "🌉 Cross-Chain CCIP (Jae)"
        CP[CCIP Pool Program<br/>Solana Side]
        EP[Ethereum Pool<br/>ERC20 Token]
        
        MS --> CP
        CP <--> EP
    end
    
    subgraph "🔐 Security & Testing"
        T1[Oracle Tests<br/>Real Data Streams]
        T2[Stablecoin Tests<br/>12 Test Suite]
        T3[Integration Tests<br/>End-to-End]
        
        OP -.-> T1
        SP -.-> T2
        CP -.-> T3
    end

Loading

🛠️ Built With

This workshop leverages key Chainlink development tools:

Core Dependencies

• Chainlink Data Streams SDK - Real-time price feed integration
• Chainlink Data Streams Report - Report decoding and verification
• CCIP Solana Starter Kit - Cross-chain functionality
• Anchor Framework - Solana program development
• SPL Token Program - Token and multisig management

Development Tools

• Solana CLI - Blockchain interaction and deployment
• Rust - Oracle client and program development
• TypeScript - Testing and deployment scripts
• Hardhat - Ethereum smart contract deployment

🚀 Workshop Content

The workshop covers:

• Phase 1: Oracle Program Deployment (Data Streams integration)
• Phase 2: Stablecoin Program Deployment (Oracle integration)
• Phase 3: CCIP Pool Setup (Cross-chain configuration)
• Phase 4: Ethereum Side Deployment (ERC20 token and pool)
• Phase 5: Cross-Chain Configuration (Solana ↔ Ethereum)
• Phase 6: Testing and Token Operations (End-to-end validation)
• Phase 7: Cross-Chain Transfer Execution (Live transfers)

🧪 Testing

Comprehensive Test Suites

Each component includes thorough testing:

Oracle Tests (oracle/tests/)

cd oracle
anchor test  # Real Chainlink Data Streams integration

Stablecoin Tests (cross-chain-stablecoin/stablecoin-program/tests/)

cd cross-chain-stablecoin/stablecoin-program
./test-individual.sh all  # 12 comprehensive tests

# Individual test categories
./test-individual.sh oracle      # Oracle integration (3 tests)
./test-individual.sh stablecoin  # Program logic (4 tests)
./test-individual.sh integration # End-to-end (4 tests)
./test-individual.sh ccip        # CCIP multisig (1 test)

Test Coverage

• ✅ Real Chainlink Data Integration - Live SOL/USD price feeds
• ✅ Oracle Program Verification - On-chain price storage and retrieval
• ✅ Stablecoin Minting/Burning - Complete collateral management
• ✅ Cross-Program Invocation - Oracle ↔ Stablecoin integration
• ✅ Multisig Authority - SPL Token multisig operations
• ✅ CCIP Cross-Chain - Solana ↔ Ethereum transfers

🎯 Workshop Learning Objectives

Part 1: Chainlink Data Streams & Oracle (Harry)

• Integrate real-time price feeds using Chainlink Data Streams SDK
• Build Rust client for fetching and processing price reports
• Implement Solana oracle program for on-chain price verification
• Handle report compression, validation, and storage

Part 2: Stablecoin & Cross-Chain Integration (Jae)

• Build oracle-backed stablecoin with collateral management
• Implement Cross-Program Invocation (CPI) between programs
• Configure SPL Token multisig for authority management
• Set up CCIP for cross-chain token transfers
• Deploy and configure Ethereum side components

📚 Documentation

Each component includes comprehensive documentation:

• Oracle System - Complete Data Streams and Oracle documentation
• Stablecoin System - Stablecoin and CCIP integration guide

🎉 Workshop Outcomes

By completing this workshop, you will have:

✅ Built a datastreams-backed stablecoin system
✅ Implemented multisig authority management
✅ Configured cross-chain transfers via CCIP
✅ Deployed to both Solana and Ethereum networks

🔗 Resources

• Chainlink Data Streams Documentation
• CCIP Documentation
• Solana Program Development
• Anchor Framework