AWNEX 하이브리드 월렛 - 통합 개발 계획서

📋 프로젝트 개요

🎯 핵심 비전: 중앙집중식 거래소(CEX)의 장점과 탈중앙형 지갑(DEX)의 장점을 융합한 차세대 하이브리드 디지털 자산 거래 플랫폼

🏢 CEX의 장점

사용자 친화적 UI/UX
안정성과 신뢰성
24/7 고객 지원
규제 준수 (KYC/AML)

🔗 DEX의 장점

완전한 자산 소유권
투명성과 검증 가능성
프라이버시 보호
검열 저항성

🚀 핵심 서비스

⚡ 블록체인 기반 실시간 자산 관리

👑 포인트 기반 멤버십 서비스

💰 AWNEX 온체인 스테이킹 (DeFi)

🏢 실물자산 토큰화 (RWA)

🎨 아트 & 프리미엄 마켓플레이스

🔄 자산 이전 서비스

🚨 시장 문제점 분석

연간 수십억~수백억 달러 규모의 자산 탈취 피해 급증

$38억

2022년 크립토 해킹 피해

전년 대비 15% 증가

$18억

2023년 총 피해 규모

DeFi 공격이 64% 차지

$10억+

2024년 상반기 피해

연간 20억 달러 초과 예상

알수 없는 집계 되지 않는피해 사례 자산탈취 지갑탈취등 피해금액 상상초월할 정도 많음

🏢 중앙화 거래소 사례

마운트곡스 (2014): 85만 BTC 손실 ($4.5억)
FTX (2022): 고객 자금 유용으로 $320억 파산
바이낸스: 규제 압박과 자금 동결 위험

🔗 탈중앙화 플랫폼 사례

Terra Luna (2022): 알고리즘 스테이블코인 붕괴 ($400억)
대형 러그풀: Squid Game Token, AnubisDAO
고급 공격: MEV, 지갑 서명, 악성 NFT

💡 AWNEX 하이브리드 솔루션

특성	CEX (중앙화)	DEX (탈중앙화)	AWNEX 하이브리드
자산 소유권	❌ 거래소 보관	✅ 사용자 직접 관리	✅ 사용자 완전 제어
사용자 경험	✅ 직관적이고 쉬움	❌ 복잡하고 어려움	✅ 직관적이고 쉬움
보안 수준	❌ 중앙화 위험	⚠️ 사용자 실수 위험	✅ 다중 보안 계층
투명성	❌ 불투명한 운영	✅ 완전 투명	✅ 블록체인 기반 투명성
규제 준수	✅ KYC/AML 준수	❌ 규제 미준수	✅ 하이브리드 규제 대응

🌟 하이브리드 아키텍처의 혁신: 중앙화와 탈중앙화의 장점만을 융합하여 시스템적 리스크를 최소화하고, 완전한 자산 제어권과 사용자 친화적 경험을 동시에 제공합니다.

🏗️ 시스템 아키텍처

보안 구현 프로세스

사용자 여정 단계별 보안 적용 시스템 (현재 구현 ✅ vs 향후 계획 🔮)

아키텍처 계층 구조

Frontend부터 Blockchain까지 6개 계층의 데이터 흐름과 구성 요소

기술 스택 생태계

AWNEX를 구성하는 4개 핵심 기술 영역의 통합 생태계

간소화 프로세스 플로우 (참고용)

📱

회원가입

이메일 인증
지갑 생성

→

🔐

로그인

2FA 인증
세션 관리

→

💼

자산 관리

실시간 동기화
암호화 저장

→

⚡

거래 실행

가스비 최적화
트랜잭션 검증

→

💾

지갑 백업

Seed Phrase
Private Key

기술 아키텍처 레이어

📱 Frontend Layer

React 18 + Vite
Tailwind CSS + Framer Motion
PWA (Service Worker)
반응형 디자인

🔄 Context Layer

AuthContext (인증)
ThemeContext (테마)
상태 관리
암호화 처리

🛠️ Utils Layer

Web3.js + Ethers.js
API 통합
헬스체크
유틸리티 함수

⚙️ Config Layer

Firebase 설정
EmailJS 설정
토큰 컨트랙트
인프라 설정

🔥 Backend Services

Firebase (BaaS)
외부 API 통합
서버리스 함수
실시간 데이터베이스

⛓️ Blockchain Layer

Ethereum Network
Web3 Integration
스마트 컨트랙트
탈중앙화 인프라

프로젝트 디렉토리 구조

📂 AWNEX_V6_10_23/
├── 📁 src/                          # 소스 코드
│   ├── 📄 App.jsx                   # 메인 앱 컴포넌트
│   ├── 📄 main.jsx                  # 앱 진입점
│   ├── 📄 index.css                 # 글로벌 스타일
│   │
│   ├── 📁 components/               # 재사용 가능한 컴포넌트
│   │   ├── 📄 Navbar.jsx           # 상단 네비게이션
│   │   ├── 📄 Footer.jsx           # 하단 푸터
│   │   └── 📄 FloatingMenu.jsx     # 플로팅 메뉴
│   │
│   ├── 📁 pages/                    # 페이지 컴포넌트
│   │   ├── 📄 Home.jsx             # 홈 페이지
│   │   ├── 📄 Wallet.jsx           # 지갑 페이지
│   │   ├── 📄 DeFi.jsx             # DeFi 페이지
│   │   ├── 📄 Membership.jsx       # 멤버십 페이지
│   │   ├── 📄 Rewards.jsx          # RWA-Fi 페이지
│   │   ├── 📄 Market.jsx           # 마켓 페이지
│   │   ├── 📄 Convert.jsx          # 컨버트 페이지
│   │   ├── 📄 Login.jsx            # 로그인 페이지
│   │   ├── 📄 Signup.jsx           # 회원가입 페이지
│   │   └── 📄 Admin.jsx            # 관리자 페이지
│   │
│   ├── 📁 context/                  # React Context
│   │   ├── 📄 AuthContext.jsx      # 인증 상태 관리
│   │   └── 📄 ThemeContext.jsx     # 테마 상태 관리
│   │
│   ├── 📁 config/                   # 설정 파일
│   │   ├── 📄 firebase.js          # Firebase 설정
│   │   ├── 📄 emailjs.js           # 이메일 서비스 설정
│   │   ├── 📄 infrastructure.js    # 인프라 설정
│   │   └── 📄 tokens.js            # 토큰 컨트랙트 주소
│   │
│   └── 📁 utils/                    # 유틸리티 함수
│       ├── 📄 web3.js              # Web3 관련 함수
│       ├── 📄 investingAPI.js      # 외부 API 연동
│       └── 📄 healthCheck.js       # 헬스체크 함수
│
├── 📁 public/                       # 정적 자산
│   └── 📁 assets/
│       ├── 📁 images/              # 이미지 파일
│       └── 📁 videos/              # 비디오 파일
│
├── 📁 DIST/                        # 빌드 결과물
│   ├── 📄 index.html              # 메인 HTML
│   ├── 📄 manifest.webmanifest    # PWA 매니페스트
│   └── 📁 assets/                 # 번들된 자산
│
├── 📁 functions/                   # Firebase Functions
│   └── 📄 index.js                # 서버리스 함수
│
├── 📁 scripts/                     # 스크립트
│   └── 📄 init-firestore.js       # Firestore 초기화
│
├── 📄 package.json                 # 프로젝트 의존성
├── 📄 vite.config.js               # Vite 설정
├── 📄 firebase.json                # Firebase 설정
└── 📄 tailwind.config.js           # Tailwind CSS 설정

🎯 핵심 기능

💼 하이브리드 디지털 지갑

포인트 기반 멤버십 (Basic/Premium/VIP)
AWNEX 토큰 보유량별 등급 시스템
일일 체크인 포인트 적립
추천 시스템 보상

🚀 DeFi 스테이킹

멤버십 등급별 차등 이율 (12%~20%)
즉시 포인트 보상 (1,000P~5,000P)
실시간 스테이킹 현황
자동 복리 계산

🎨 아트 & 프리미엄 마켓플레이스

실물 아트작품 AWNEX 결제
디지털 아트 NFT 거래
한국 전통 예술품
블록체인 진품 인증

🏢 RWA-Fi 실물자산 투자

부동산 토큰화 투자
원자재 및 인프라 투자
스마트 컨트랙트 증서 발행
분기별 배당 시스템

📱 페이지별 상세 기능

🏠 홈페이지 슬라이드 (7개)

1️⃣ Home (홈)

🎯 AWNEX 하이브리드 월렛 - 차세대 디지털 자산 거래 플랫폼

✨ 실시간 자산 관리

✨ 멤버십 스테이킹

✨ DeFi 서비스

✨ RWA 실물자산 투자

✨ 아트 마켓플레이스

✨ 지갑 이전 서비스

중앙집중식 거래소의 장점과 탈중앙형 지갑의 장점을 융합한 PWA 기반 하이브리드 월렛

2️⃣ Wallet (지갑)

💼 완전한 자산 제어권 - AWNEX 하이브리드 지갑

🔐 AES-256 암호화 지갑키 관리

🔐 Zero-Knowledge 아키텍처

🔐 PBKDF2 해싱 보안

🔐 사용자 주도적 지갑 백업

실시간 잔고 조회부터 트랜잭션 실행까지, 모든 자산을 안전하게 관리

3️⃣ Membership (멤버십)

👑 포인트 기반 멤버십 시스템

🥇 Basic: 1~49,999 AWNEX, 거래 1달러당 10P

🥈 Premium: 50,000~99,999 AWNEX, 거래 1달러당 20P

🥉 VIP: 100,000+ AWNEX, 거래 1달러당 30P

AWNEX 토큰 보유량에 따라 자동 등급 결정, 거래할수록 더 많은 포인트 획득

4️⃣ DeFi (DeFi)

🚀 AWNEX 토큰 스테이킹 - AWNEX DeFi 플랫폼

💰 Basic: 100 AWNEX, 12% 연간 + 1,000P

💰 Premium: 500 AWNEX, 15% 연간 + 2,500P

💰 VIP: 1,000 AWNEX, 20% 연간 + 5,000P

안정적인 수익과 즉시 포인트 보상, 실시간 스테이킹 현황 확인

5️⃣ Market (마켓)

🛒 아트 & 마켓플레이스 - AWNEX 아트 & 프리미엄 마켓

🎨 실물 아트작품 거래

🖼️ 디지털 아트 거래

🏆 한국 전통 예술품 거래

💎 프리미엄 마켓

실물경제와 블록체인이 만나는 혁신적인 마켓플레이스

6️⃣ Convert (컨버트)

🔄 실시간 자산 이전 - AWNEX 컨버트 서비스

⚡ 기존 지갑 신원 인증(KYC)

💱 확인후 새지갑 자산이전

🔒 안전한 거래 보장

📊 실시간 자산 조회

기존 지갑의 AWNEX 토큰과 ETH를 새로운 AWNEX 지갑으로 안전 이전

7️⃣ RWA-Fi (RWA-Fi)

🏢 실물자산 토큰화 (RWA-Fi) - Real World Asset Finance

🏠 부동산 토큰화

🏭 기업 채권 투자

🏦 금융 상품 연동

📊 실물자산 포트폴리오

블록체인 기술로 실물자산을 토큰화하여 투자, 다양한 자산 포트폴리오 구성

💼 지갑 페이지 주요 기능

실시간 자산 관리

AWNEX, ETH, USDT 멀티 자산 지원
실시간 가격 정보 (CoinGecko, 업비트 API)
USDT/KRW 기준 총 자산 가치 표시
자산별 입금/출금 통계

거래 및 보안

실시간 가스비 조회 (다중 API 백업)
웹 내 서명 모달 (MetaMask 의존성 제거)
트랜잭션 히스토리 (10개 단위 페이지네이션)
자동 새로고침 시스템 (5초 간격)

🛡️ 보안 시스템

현재 1단계 보안 기능

🔐 기본 지갑 보안

✅ AES-256 암호화 (군사급 보안)
✅ Zero-Knowledge 아키텍처
✅ PBKDF2 해싱
✅ Firebase 보안 규칙

💼 거래 보안

✅ 실시간 가스비 조회
✅ 트랜잭션 검증
✅ 웹 내 서명 모달
✅ 실시간 동기화

향후 2단계 고급 보안

Q2 2025

🔮 Phase 1: 인증 보안 강화

2FA 인증 (SMS/이메일/Google Authenticator)
KYC/AML 준수 시스템
24/7 실시간 모니터링

Q3-Q4 2025

🔮 Phase 2: 고급 공격 방지

MEV 공격 방지 (Private Mempool)
스캠 방지 (스마트 컨트랙트 감사)
프론트러닝 방지 (Batch Auction)

🔧 기술 스택

AWNEX 기술 스택 생태계

중앙 AWNEX 하이브리드 월렛을 중심으로 4개 핵심 기술 영역이 통합된 개발 환경

AWNEX
Hybrid Wallet

📱 Frontend Framework

React 18.2.0 - UI 라이브러리
Vite 5.0.8 - 빌드 도구
Tailwind CSS 3.3.0 - 스타일링
Framer Motion 10.16.0 - 애니메이션

⛓️ Blockchain & Web3

Ethers.js 6.8.0 - ETH 라이브러리
Web3.js 4.3.0 - 블록체인 상호작용
QR Scanner 1.4.2 - QR 코드 스캔
QRCode 1.5.4 - QR 코드 생성

🔥 Backend & Database

Firebase 10.7.0 - BaaS 플랫폼
Firestore - NoSQL 데이터베이스
Firebase Auth - 인증 시스템
Firebase Hosting - 웹 호스팅

🛠️ Build & Development

Vite PWA Plugin 0.17.4 - PWA 지원
PostCSS 8.4.32 - CSS 처리
Autoprefixer 10.4.16 - CSS 호환성
ESLint - 코드 품질 관리

Version 1.2.1

Production Ready

PWA Enabled

기술 스택 카테고리

Frontend Framework

Blockchain & Web3

Backend & Database

Build & Development

🚀 배포 및 인프라

🌐 Production Environment

Firebase Hosting: 웹사이트 호스팅
CDN 글로벌 배포: 전세계 빠른 접속
HTTPS 자동 적용: 보안 연결
커스텀 도메인: 차후 공개

💻 Development Environment

Vite Dev Server: 포트 3000
Hot Module Replacement: 실시간 업데이트
코드 분할: 최적화된 번들링
PWA 매니페스트: 네이티브 앱 경험

🔍 모니터링 시스템: Firebase Performance Monitoring, Crashlytics, Analytics를 통한 24/7 실시간 모니터링

📈 개발 로드맵

2025 Q2

Phase 1: 보안 강화

2FA 인증 시스템 구축
KYC/AML 준수 시스템
실시간 모니터링 시스템

2025 Q3-Q4

Phase 2: 고급 DeFi 기능

MEV 공격 방지 시스템
고급 스테이킹 메커니즘
유동성 풀 및 AMM 통합

2026 Q1-Q2

Phase 3: RWA-Fi 확장

부동산 토큰화 플랫폼
기업 채권 투자 상품
실물자산 포트폴리오 관리

2026 Q3-2027

Phase 4: 글로벌 확장

다중 체인 지원 (BSC, Polygon)
글로벌 규제 대응
기관 투자자 대상 서비스

📊 업데이트 로그

v1.2.1 (2025-01-21) - DeFi 메뉴 추가 및 문서 통합

✅ DeFi 메뉴 추가: 상단 네비게이션과 하단 푸터에 DeFi 메뉴 추가
✅ 메뉴 순서 조정: Home → Wallet → Membership → DeFi → RWA-Fi → Market → Convert
✅ DeFi 페이지 구현: Membership과 동일한 스테이킹 시스템 제공
✅ 문서 통합: 모든 개발 문서를 하나의 통합 문서로 정리

v1.2.0 (2025-01-21) - 스테이킹 시스템 완전 개편

✅ 개별 스테이킹 카드 시스템: 통합 방식에서 개별 카드 방식으로 전환
✅ 실시간 스테이킹 진행: 실시간 이자 애니메이션 (초시계 효과)
✅ 스테이킹 기간 단축: 90일 → 1일 (테스트용)
✅ UI/UX 대폭 개선: 스테이킹 시작 버튼을 맨 위로 이동

v1.1.9 (2025-01-20) - 인베스팅닷컴 USDT 가격 API 통합

✅ USDT 가격 API 변경: 업비트에서 인베스팅닷컴 스타일로 전환
✅ CoinGecko API 활용: USDT 원화 가격 정보 제공
✅ 상세한 가격 정보: 24시간 최고가/최저가, 마지막 업데이트 시간

주요 성능 개선 사항

🚀 API 요청량 83% 감소 (10분 캐시 시스템)
🚀 지갑 연결 최적화 (즉시 확인 + 펄스 효과)
🚀 이메일 인증 상태 감지 강화
🚀 실시간 동기화 시스템 구축

🔧 설치 가이드

필수 요구사항

Node.js 18.0.0 이상
npm 또는 yarn
Firebase 프로젝트 설정

설치 및 실행

          # 저장소 클론 git clone <repository-url> cd awnex-hybrid-wallet # 의존성 설치 npm install # 개발 서버
          실행 npm run dev # 프로덕션 빌드 npm run build
        

환경 변수 설정

          # Firebase 설정 VITE_FIREBASE_API_KEY=your-api-key VITE_FIREBASE_AUTH_DOMAIN=your-project.firebaseapp.com
          VITE_FIREBASE_PROJECT_ID=your-project-id VITE_FIREBASE_STORAGE_BUCKET=your-project.appspot.com
          VITE_FIREBASE_MESSAGING_SENDER_ID=123456789 VITE_FIREBASE_APP_ID=your-app-id # EmailJS 설정
          VITE_EMAILJS_SERVICE_ID=service_3hy9144 VITE_EMAILJS_PUBLIC_KEY=MB9eRtRkybqUCb2K7
        

Firebase 설정 단계

1-2단계

Firebase 콘솔에서 새 프로젝트 생성
Authentication 활성화 (Google, 이메일/비밀번호)

3-4단계

Firestore 데이터베이스 생성
Hosting 설정 및 환경변수 추가

📞 지원 및 문의

🛠️ 기술 지원

이메일: [email protected]
GitHub: GitHub Issues
문서: 통합 개발 문서

📚 개발자 리소스

API 문서
인프라 가이드
보안 문서

📄 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다.

자세한 내용은 LICENSE 파일 참조

🌟 AWNEX - 차세대 디지털 자산 거래 플랫폼 최종 업데이트: 2025년 1월 21일 | 버전: v1.2.1 | 배포 상태: ✅ 차후

📋 목차

📋 프로젝트 개요

🏢 CEX의 장점

🔗 DEX의 장점

🚀 핵심 서비스

🚨 시장 문제점 분석

연간 수십억~수백억 달러 규모의 자산 탈취 피해 급증

🏢 중앙화 거래소 사례

🔗 탈중앙화 플랫폼 사례

💡 AWNEX 하이브리드 솔루션

🏗️ 시스템 아키텍처

보안 구현 프로세스

아키텍처 계층 구조

기술 스택 생태계

간소화 프로세스 플로우 (참고용)

기술 아키텍처 레이어

📱 Frontend Layer

🔄 Context Layer

🛠️ Utils Layer

⚙️ Config Layer

🔥 Backend Services

⛓️ Blockchain Layer

프로젝트 디렉토리 구조

🎯 핵심 기능

💼 하이브리드 디지털 지갑

🚀 DeFi 스테이킹

🎨 아트 & 프리미엄 마켓플레이스

🏢 RWA-Fi 실물자산 투자

📱 페이지별 상세 기능

🏠 홈페이지 슬라이드 (7개)

💼 지갑 페이지 주요 기능

실시간 자산 관리

거래 및 보안

🛡️ 보안 시스템

현재 1단계 보안 기능

🔐 기본 지갑 보안

💼 거래 보안

향후 2단계 고급 보안

🔮 Phase 1: 인증 보안 강화

🔮 Phase 2: 고급 공격 방지

🔧 기술 스택

AWNEX 기술 스택 생태계

기술 스택 카테고리

🚀 배포 및 인프라

🌐 Production Environment

💻 Development Environment

📈 개발 로드맵

Phase 1: 보안 강화

Phase 2: 고급 DeFi 기능

Phase 3: RWA-Fi 확장

Phase 4: 글로벌 확장

📊 업데이트 로그

v1.2.1 (2025-01-21) - DeFi 메뉴 추가 및 문서 통합

v1.2.0 (2025-01-21) - 스테이킹 시스템 완전 개편

v1.1.9 (2025-01-20) - 인베스팅닷컴 USDT 가격 API 통합

주요 성능 개선 사항

🔧 설치 가이드

필수 요구사항

설치 및 실행

환경 변수 설정

Firebase 설정 단계

1-2단계

3-4단계

📞 지원 및 문의

🛠️ 기술 지원

📚 개발자 리소스

📄 라이선스