| 항목 | 내용 |
|---|---|
| 문서 종류 | 기능 사양서 |
| 버전 | 1.2.0 |
| 기준일 | 2026-07-17 |
| 범위 | 현재 제공·목표 화면 기능 (사용자·운영 관점) |
본 문서는 무엇을 할 수 있는지를 정의한다.
구현 방식·설정 파일·라이브러리·내부 API는 다루지 않는다.
UI 레이아웃·페어 상장·지갑 단계 등은 Revolution 지정가 주문 사양서(화면 부분)를 반영한다.
1. 제품 개요
1.1 정의
Manifest DEX에서 지정가(Limit) 거래를 하고, 호가·차트·잔고·미체결·체결 내역을 볼 수 있는 웹 트레이딩 화면이다.
사용자는 지갑을 연결한 뒤 화면에서 직접 주문·취소·예치·래핑을 하며, 지갑 승인(서명)이 필요한 작업은 지갑 팝업으로 확인한다.
1.2 이용 방식
| 방식 | 설명 |
|---|---|
| 화면 거래 | 브라우저에서 지갑을 연결해 사람이 주문·잔고를 조작 |
| 자동 주문(운영) | 서버에 등록된 운영 지갑으로 주문·부하 테스트를 실행 (개발·실험용, 선택) |
두 방식의 주문 지갑과 잔고는 다를 수 있다. 화면에서 넣은 주문과 운영 지갑 주문은 서로 다른 기록으로 본다.
1.3 화면 구성
레이아웃 참고: PC는 gate.io, 모바일은 gate.io / MEXC 배치를 참고한다. 지갑 연결 버튼은 참고 서비스의 로그인 버튼 자리(예: 헤더 우측 상단)에 둔다.
| 영역 | 사용자가 보는 것 |
|---|---|
| 헤더 | 지갑 연결(로그인 자리), 브랜드 |
| 차트 + 호가 | 캔들, 매수/매도 호가, 중간가·스프레드 |
| Trade | 지정가 매수·매도 입력 |
| Balances | 지갑·거래소 예치·미체결 잠금, 래핑·입출금 |
| Open Orders | 미체결 주문과 취소 |
| Trade History | 최근 체결 목록 |
| Performance | 현재가, 지갑 요약, 추정 손익 |
| 성능 표시 (선택) | 화면 우측 하단 성능 수치(개발 참고, 거래와 무관) |
2. 기능 목록
| ID | 기능명 | 상태 |
|---|---|---|
| FS-01 | 마켓(페어) 선택 | 제공 |
| FS-02 | 실시간 호가·현재가 | 제공 |
| FS-03 | 가격 차트 | 제공 |
| FS-04 | 지갑 연결 (단계적) | 제공 |
| FS-05 | 잔고 조회 | 제공 |
| FS-06 | SOL 래핑 / 언래핑 | 제공 |
| FS-07 | 거래소 예치 / 출금 | 제공 |
| FS-08 | 지정가 매수·매도 | 제공 |
| FS-09 | 미체결 조회·취소 | 제공 |
| FS-10 | 체결 내역 | 제공 |
| FS-11 | Performance 요약 | 제공 |
| FS-12 | 화면 성능 표시 | 선택 |
| FS-13 | 운영 지갑 자동 주문 | 선택 |
| FS-14 | 주문 부하 테스트 | 선택 |
| FS-15 | 운영 지갑 주문 기록 조회 | 선택 |
| — | 스왑 / 유동성 공급 | 미제공 |
| — | Global 잔고 | 미제공 |
| — | 시장가·조건부 주문 | 미제공 |
| — | 리더보드 실데이터 | 미제공 |
3. 기능별 사양
FS-01 마켓(페어) 선택
| 항목 | 사양 |
|---|---|
| 목적 | 거래할 코인 페어를 고른다. |
| 기본 | 처음 들어오면 기본 페어(예: SOL/USDC)가 선택된다. |
| 조작 | 페어 이름 또는 검색을 눌러 목록에서 고른다. 심볼·주소 등으로 검색할 수 있다. |
| 결과 | 호가·차트·잔고(거래소)·미체결·체결 내역이 선택한 페어 기준으로 바뀐다. |
| 제한 | 페어(마켓) 목록은 관리자 사이드에서만 생성·관리한다. 사용자는 신규 페어를 직접 상장할 수 없고, 검색도 등록된 페어 안에서만 동작한다. 거래량 숫자는 참고용일 수 있다. |
FS-02 실시간 호가·현재가
| 항목 | 사양 |
|---|---|
| 목적 | 선택 페어의 매수·매도 호가와 현재가(중간가)를 보여 준다. |
| 표시 | 매도호가 / 매수호가, 가격·수량·금액, 트레이더 주소(축약), 중간가, 스프레드 |
| 동작 | 페어를 고르면 자동으로 갱신된다. |
| 제한 | 호가는 중간가 근처 상위 일부 단만 보인다. 가격이 멀리 떨어진 소량 주문은 목록에 안 보일 수 있다. |
FS-03 가격 차트
| 항목 | 사양 |
|---|---|
| 목적 | 가격 흐름을 캔들로 본다. |
| 조작 | 시간 단위(1분 / 5분 / 15분 / 30분 / 1시간 / 4시간 / 1일 / 1주)를 바꿀 수 있다. |
| 표시 | 최근 구간 중심으로 보여 주며, 실시간 중간가에 맞춰 갱신된다. |
| 제한 | 거래량(막대)은 없다. 거래소 체결 틱이 아니라 중간가 기준으로 만든 차트다. |
FS-04 지갑 연결 (단계적)
| 항목 | 사양 |
|---|---|
| 목적 | 내 Solana 지갑을 앱에 연결한다. |
| 단계 | 1단계(초기): MetaMask. 2단계(추후): Trust Wallet, Phantom 등 |
| 조작 | 헤더의 지갑 연결(로그인 자리) → 모달에서 연결 |
| 결과 | 연결된 주소가 표시되고, 잔고·내 주문·내 체결 필터를 쓸 수 있다. |
| 제한 | 연결만으로 주문이 나가지 않는다. 주문·입출금 시마다 지갑에서 따로 승인한다. 1단계 외 지갑은 아직 지원하지 않을 수 있다. |
FS-05 잔고 조회
| 항목 | 사양 |
|---|---|
| 목적 | 내 자산와 거래소 예치 상태를 확인한다. |
| 자산 | SOL, wSOL, USDC 등 페어에 따라 표시 |
| 구분 | |
| Wallet — 지갑에 있는 금액 | |
| Exchange — 거래소에 예치해 둔 금액 | |
| Orders — 미체결 주문에 묶인 금액 | |
| 갱신 | 연결 후 주기적으로 갱신. 새로고침으로 즉시 갱신 가능. 주문·입출금 후에도 갱신된다. |
| 주의 | SOL과 wSOL은 다르다. 매수에는 Quote(예: USDC), 매도에는 Base(예: wSOL 또는 예치 base) 가 필요하다. |
FS-06 SOL 래핑 / 언래핑
| 항목 | 사양 |
|---|---|
| 래핑 | 지갑 SOL을 wSOL로 바꾼다. 금액을 입력한다. |
| 언래핑 | wSOL을 다시 SOL로 바꾼다. (전액 기준) |
| 흐름 | 버튼 → 지갑에서 승인 → 성공/실패 안내 |
| 실패 | SOL이 부족하거나(금액+수수료), 지갑이 거래를 거절·실패 판정하면 완료되지 않는다. |
| 비고 | 초기 상장 페어가 Quote만 쓰는 구성(예: */USDT)이면 래핑 UI 우선순위가 낮을 수 있다. |
FS-07 거래소 예치 / 출금
| 항목 | 사양 |
|---|---|
| 예치(Deposit) | 지갑의 base/quote(예: wSOL, USDC)를 거래소 잔고로 옮긴다. |
| 출금(Withdraw) | 거래소 잔고를 지갑으로 되돌린다. |
| 전액 출금 | 해당 페어 거래소 예치를 한 번에 출금한다. |
| 흐름 | 버튼 → 지갑 승인 → 결과 안내 |
| 제한 | 처음 쓰는 지갑은 거래소 이용 설정·권한 승인이 먼저 필요할 수 있다. |
FS-08 지정가 매수·매도
| 항목 | 사양 |
|---|---|
| 목적 | 가격과 수량을 정해 주문을 넣는다. |
| 사전조건 | 지갑 연결, 가격·수량이 0보다 큼 |
| 가격 | 직접 입력 또는 ± 틱. Bid / Mid / Ask로 채울 수 있다. 실시간 중간가가 입력칸을 덮어쓰지 않는다. 페어를 바꾸면 가격·수량이 비워진다. |
| 수량 | 직접 입력 · ± · % 슬라이더. **% 모드(기본, 시작 25%)**의 100%는 내 실잔고(거래소 예치+지갑). 매수: quote÷가격 → base 최대. 매도: base 보유. 가격이 바뀌면 같은 %를 유지하려고 Size가 다시 계산된다. Size를 직접 입력하면 typed 모드로 바뀌어 가격을 바꿔도 수량은 고정된다. |
| 매수 | Quote로 산다. 거래소 예치가 모자라면 예치와 주문이 함께 진행될 수 있다. |
| 매도 | Base를 판다. 예치가 모자라면 마찬가지로 예치+주문이 필요할 수 있다. |
| 흐름 | Buy/Sell → (필요 시 초기 설정 승인) → 주문 승인 → 성공/실패 메시지 |
| 성공 의미 | 주문이 체인에 반영된 것. 호가창 맨 위에 바로 보인다는 뜻은 아니다. |
| 주문 종류 | 지정가(Limit)만. 스왑·유동성 탭은 없다. |
규칙
| 규칙 | 내용 |
|---|---|
| BR-1 | 매수: 가격 × 수량만큼 Quote(지갑+예치)가 있어야 한다. |
| BR-2 | 매도: 팔려는 수량만큼 Base(지갑에서 옮겨 담을 수 있는 분+예치)가 있어야 한다. |
| BR-3 | 수수료용 SOL이 너무 적으면 실패할 수 있다. |
FS-09 미체결 조회·취소
| 항목 | 사양 |
|---|---|
| 목적 | 아직 체결되지 않은 내 주문을 보고 취소한다. |
| 표시 | 현재 선택한 페어의 미체결(방향, 가격, 수량 등) |
| 취소 | 개별 / 매수만 / 매도만 / 전체 취소. 지갑 승인 필요. |
| 제한 | 네트워크 상황에 따라 목록 갱신이 늦을 수 있다. |
FS-10 체결 내역
| 항목 | 사양 |
|---|---|
| 목적 | 시장에서 일어난 체결을 본다. |
| 필터 | 전체 / 내 것(Mine). Mine은 내가 산·판 쪽인 체결만, 주소 대신 You로 표시할 수 있다. |
| 포함 | 체결된 거래만. 미체결은 Open Orders에 있다. |
| 제한 | 네트워크 상황에 따라 목록이 비거나 늦게 갱신될 수 있다. |
FS-11 Performance 요약
| 항목 | 사양 |
|---|---|
| 표시 | 현재가(중간가), 지갑 요약, 미체결 개수, 최근 내 체결 기준 거래 수·거래대금·손익 추정 |
| 손익 | 최근 체결만으로 간단히 추정한 값이다. |
| 제한 | 전체 기간·수수료·입출금을 반영한 정확한 장부 손익이 아니다. 매수 이력이 없는 매도는 손익을 확정하지 못할 수 있다. 리더보드 버튼은 동작하지 않는다. |
FS-12 화면 성능 표시
| 항목 | 사양 |
|---|---|
| 목적 | 화면이 얼마나 부드럽게 도는지 참고용으로 본다. |
| 표시 | 초당 프레임 등. 우측 하단, 접을 수 있다. |
| 비고 | 거래 기능과 무관한 개발·점검용이다. 선택 제공. |
FS-13 운영 지갑 자동 주문
| 항목 | 사양 |
|---|---|
| 목적 | 사람이 화면에서 누르지 않고, 운영용으로 등록된 지갑으로 지정가 주문을 낸다. |
| 내용 | 수량·가격·매수/매도를 지정해 1건 주문 |
| 제한 | 화면 지갑 주문과 별개다. 거래소에 미리 예치가 안 되어 있으면 실패할 수 있다. 전송됐다는 것과 실제로 주문이 성공한 것은 다를 수 있다. 선택 기능. |
FS-14 주문 부하 테스트
| 항목 | 사양 |
|---|---|
| 목적 | 짧은 시간에 여러 건의 자동 주문을 넣어 처리량을 본다. |
| 내용 | 한 번에 여러 건(소수)을 동시에 시도하고, 몇 건이 실제로 성공했는지 집계한다. |
| 제한 | 잔고·예치 부족 시 실패가 많을 수 있다. 실거래 자산이 소모될 수 있다. 선택 기능. |
FS-15 운영 지갑 주문 기록
| 항목 | 사양 |
|---|---|
| 목적 | 운영 지갑으로 낸 주문의 기록을 조회한다. |
| 범위 | 운영 지갑 주문만. 화면에서 넣은 주문은 여기에 없다. |
| 상태 예 | 전송됨 / 성공 / 실패 등으로 구분한다. |
| 비고 | 선택 기능. |
4. 제공하지 않는 기능
| 항목 | 상태 |
|---|---|
| 스왑 | 핵심 기능 아님 |
| 유동성 공급 | 핵심 기능 아님 |
| Global 잔고 | 핵심 기능 아님 |
| 시장가·IOC·스탑 등 | 핵심 기능 아님 |
| 헤더 Simple / Options / Vaults | 핵심 기능 아님 |
| 상단 티커 | 핵심 기능 아님 |
| 리더보드·Top Traders | 핵심 기능 아님 |
5. 확인 시나리오
| # | 상황 | 기대 결과 |
|---|---|---|
| 1 | 앱 접속 | 기본 페어가 선택되고 호가·차트가 보인다 |
| 2 | 다른 페어 선택 | 호가·차트·관련 패널이 그 페어로 바뀐다 |
| 3 | 지갑(MetaMask) 연결 | 주소·잔고가 보인다 |
| 4 | Quote 없이 매수 | 실패하거나 지갑이 거절한다 |
| 5 | 예치 후 지정가 매수 | 승인 후 성공 안내, 미체결 또는 체결에 반영 |
| 6 | 미체결 전체 취소 | 승인 후 미체결이 줄어든다 |
| 7 | 체결 내역 Mine | 내 체결만 보인다 |
6. 용어
| 용어 | 의미 |
|---|---|
| 중간가(mid) | 최우선 매수·매도 가격의 중간 |
| Wallet | 지갑에 있는 금액 |
| Exchange | 선택한 마켓에 거래소에 예치해 둔 잔고 |
| Orders(잔고) | 미체결에 묶여 있는 금액 |
| Global | 마켓을 넘어선 전체·통합 잔고 |
| Quote | 매수에 쓰는 견적 자산 (예: USDC) |
| Base | 매도·수량 기준이 되는 자산 (예: wSOL) |
| 지정가(Limit) | 가격을 정해 두고 기다리는 주문 |
| 래핑 | SOL을 거래에 쓰는 wSOL 형태로 바꿈 |
변경 이력
| 버전 | 일자 | 내용 |
|---|---|---|
| 1.0.0 | 2026-07-15 | 초판 |
| 1.1.0 | 2026-07-15 | 기술 내용(.env, SDK, API·파일 경로 등) 삭제, 기능·사용자 관점으로 정리 |
| 1.2.0 | 2026-07-17 | Revolution 사양서의 화면·제품 반영(레이아웃·상장·지갑 단계·차트 간격·BR Quote/Base 등). API·개발 항목은 제외 |