Skip to content

README.md

Latest commit

 

History

History
124 lines (90 loc) · 5.51 KB

README.md

File metadata and controls

124 lines (90 loc) · 5.51 KB
Raw

🔗 Chainee | Web3 Collaboration Platform

Chainee Main Screen

"신뢰를 증명하는 최소한의 레이어, Web3 협업의 기준"

Chainee는 DID 기반 신원 인증과 스마트 계약 에스크로를 결합하여
협업 전 과정을 검증 가능한 데이터로 연결하는 신뢰 기반 인재 매칭 플랫폼입니다.

📖 목차 | Table of Contents

📌 프로젝트 소개 | Introduction

Background

기존 Web2 외주 플랫폼은 신원 불확실성, 계약 조건 분쟁, 대금 지급 지연이라는 고질적인 문제를 안고 있습니다. Chainee는 블록체인을 단순한 저장소가 아닌 **'신뢰 증명 레이어'**로 활용하여 이 문제를 해결합니다.

Strategy

  • Hybrid Architecture: 인증·상태 관리 등 UX가 중요한 영역은 **Web2(Spring)**가, 신원 증명과 대금 보존은 **Web3(Rust/Blockchain)**가 담당합니다.
  • Minimal Web3 Layer: 모든 데이터를 블록체인에 올리는 비효율을 제거하고, 신뢰가 필요한 핵심 접점(인증, 에스크로, 성과 기록)에만 온체인 기술을 적용했습니다.
  • Gradual Trust: Google OAuth로 시작해 KYC, DID 발급으로 이어지는 단계적 검증 시스템을 구축했습니다.

🧩 시스템 아키텍처 | System Architecture

Client (Web)
   │
   ▼
[ Backend API (Spring Boot) ] ◀───▶ [ DID Module (Rust) ]
   │                                   ├─ DID Issuer
   ├─ Auth: Google OAuth2              └─ DID Verifier
   ├─ KYC & Contract Manager
   └─ Notification Service
   │
   ▼                                [ Blockchain Layer ]
[ Database (MySQL) ]                   ├─ DID Document
   └─ User/Contract Data               ├─ Escrow Smart Contract
                                       └─ Badge NFT (Result)

✨ 주요 기능 | Key Features

1️⃣ 단계적 신뢰 파이프라인 (Verification)

  • OAuth → KYC → DID: 단순 소셜 로그인을 넘어 실제 신원 확인(KYC)이 완료된 사용자에게만 DID를 발급합니다.
  • 접근 제어: DID 미발급 사용자는 계약 체결 단계에 진입할 수 없도록 원천 차단하여 플랫폼 내 신뢰도를 유지합니다.

2️⃣ 스마트 계약 기반 에스크로 (Escrow)

  • 대금 보호: 계약 생성과 동시에 보수가 에스크로 컨트랙트에 예치됩니다.
  • 정산 자동화: 협업 결과 검증 시 대금이 즉시 지급되며, 계약 실패나 만료 시 사전에 정의된 규칙에 따라 자동 환불 로직이 작동합니다.

3️⃣ 성과 기반 NFT 배지 (Identity)

  • 검증 가능한 이력: 협업 종료 후 지급률 및 성과에 따라 4개 등급(Platinum ~ Bronze)의 NFT를 발급합니다.
  • 온체인 포트폴리오: 단순 텍스트 이력이 아닌, 블록체인상에 영구 기록되는 신뢰 자산을 제공합니다.

🔐 핵심 로직 | Core Logic

DID 인증 흐름

  • Register (Issuer): 사용자 DID 생성 및 온체인 DID Document 저장. KYC 정보를 포함한 발급자(Issuer) 서명 VC(Verifiable Credential) 생성.
  • Login (Verifier): 서버의 Challenge(nonce)에 대해 사용자가 VC와 VP를 제출하면 서명 및 유효성을 즉각 검증합니다.

스마트 계약 · Escrow 구조

  • Escrow: 계약 보수를 안전하게 예치하며, 성공 시 5%, 실패/만료 시 1%의 차등 수수료 체계를 적용합니다.
  • Off-chain 연동: Solana 특성상 자동 실행이 불가능한 만료 로직은 백엔드 서버에서 상태를 모니터링하여 트랜잭션을 전송하는 방식으로 보완했습니다.

🛠 기술 스택 | Tech Stack

Category Stack
Backend Java 17, Spring Boot 3.x, Rust (DID Core), JPA
Web3 DID, Smart Contract (Escrow), NFT (Badge)
Database MySQL 8.0
Infrastructure AWS EC2, GitHub Actions
Tools GitHub, Notion, Figma

📖 레포지토리 | Repositories

Part Repository Link
Backend 🔗 GitHub Link
Blockchain 🔗 GitHub Link

👥 프로젝트 팀 | Project Team

  • 김여은 (Backend Engineer)
    • 프로젝트 전반의 도메인 설계 및 API 아키텍처 구축
    • 스마트 계약(Escrow) 상태 전이 및 백엔드 연동 로직 설계
  • 이태경 (Web3 Engineer)
    • Rust 기반 DID Issuer/Verifier 모듈 구현
    • 스마트 계약(Escrow, Badge NFT) 개발 및 배포
    • 온체인 데이터 무결성 검증 및 트랜잭션 최적화
  • 박솔빈 (Frontend Engineer)
    • React 기반 클라이언트 애플리케이션 UI/UX 구현
    • Web3 지갑 연동 및 실시간 계약 상태 시각화

🎓 Note

본 프로젝트는 홍익대학교 졸업프로젝트로 진행되었습니다.
Web3 기술을 실제 서비스에 적용 가능한 하이브리드 신뢰 구조 설계에 중점을 두었습니다.