← 프로젝트 목록으로
closed외주 프로젝트·2025.10 – 2026.01
Ludium Portal
Web3 인재 매칭 플랫폼의 스폰서-빌더 계약 스마트컨트랙트와 GraphQL 백엔드 API
- 클라이언트
- Ludium (Web3 빌더 커뮤니티)
- 담당
- Smart contract, 백엔드 API (GraphQL)
해결해야 할 과제
스폰서가 프로그램 예산을 걸고 빌더와 계약을 맺은 뒤, 마일스톤마다 대금이 지급되는 구조를 온체인으로 만들어야 했습니다. 동시에 v2로 개편되는 포털의 채용 · 지원 · 대시보드 · 커뮤니티 기능을 백엔드 API로 받쳐야 했습니다.
주요 결정
빌더 서명이 있어야 계약 성립
스폰서가 계약을 만들 때 빌더가 미리 서명한 계약 조건을 함께 제출하게 하고, 컨트랙트에서 서명을 검증해 양쪽이 합의한 금액 · 기간으로만 계약이 생성되게 했습니다. 계약서 스냅샷 해시도 함께 기록해 오프체인 문서와 대조할 수 있게 했습니다.
마일스톤 지급과 예외 처리
마일스톤 완료 시 수수료를 떼고 지급하고, 계약 일시정지 · 재개 · 취소와 프로그램 환불, 긴급 중단 경로를 역할별로 나눴습니다. 업그레이드 가능한 구조(UUPS)로 배포해 요구사항 변경에 대응했습니다.
v2 GraphQL API
Pothos 스키마로 프로그램 · 마일스톤 · 지원서 · 포트폴리오 · 대시보드 · 아티클 · 스레드 · 알림 API를 만들고, 관계 조회는 DataLoader로 묶어 N+1 쿼리를 줄였습니다. 프로그램 ID를 UUID로 바꾸는 마이그레이션도 기존 데이터를 유지한 채 진행했습니다.
결과
- 계약 컨트랙트 테스트넷 배포 및 테스트 41건
- 백엔드 v2 GraphQL API 기능 개발 (PR 단위로 dev에 병합)
사용 기술
- Solidity — 스폰서-빌더 계약 · 마일스톤 지급 컨트랙트
- EIP-712 — 빌더 서명 검증으로 계약 합의 확인
- 업그레이더블 컨트랙트 (UUPS) — UUPS
- Hardhat — 배포 · 업그레이드 스크립트와 테스트
- GraphQL — Mercurius + Pothos, DataLoader
- Node.js — Fastify
- Drizzle ORM — 스키마 · 마이그레이션
- PostgreSQL
- TypeScript
기획 · 협업
- 아키텍처 · 유저 플로우 설계 — 스폰서-빌더 계약 흐름과 컨트랙트 · API 구조 설계