Quick Start
AWS 빠른 설치
c5.2xlarge 인스턴스 기준 10분 이내 단일 노드 실행 가능합니다.
1️⃣
인스턴스 생성
c5.2xlarge
Ubuntu 24.04 LTS
2️⃣
의존성 설치
Python 3.12
PyNaCl, cryptography
3️⃣
노드 설정
행정구역 코드
계층 식별자 지정
4️⃣
노드 실행
L1 노드 기동
상위 계층 연결
Step 1 — 인스턴스 접속 및 환경 구성
# SSH 접속
ssh -i "your-key.pem" ubuntu@<PUBLIC_IP>
# 의존성 설치
sudo apt update -y
pip3 install cryptography PyNaCl coincurve --break-system-packages
# 저장소 클론
git clone https://github.com/aicity-inc/openhash.git
cd openhash
Step 2 — L1 노드 설정 파일
# config.yaml 예시
node:
id: "KR-JEJU-SEOGWIPO-JUNGMUN" # 계층 식별자
tier: 1 # L1 = 읍면동
admin_code: "5013025000" # 행정구역 코드
parent: "KR-JEJU-SEOGWIPO" # 상위 노드 ID
crypto:
signature: "Ed25519" # 또는 "BLS"
dual_sign: true # 이중서명 필수
merkle:
batch_size: 100 # 배치당 트랜잭션 수
sync_interval_sec: 300 # L2 보고 주기 (5분)
lpbft:
nodes: 4 # 합의 참여 노드 수
fault_tolerance: 1 # f=1, n>=3f+1
Step 3 — 노드 실행 및 확인
# 단일 L1 노드 실행
python3 -m openhash.node --config config.yaml
# 상태 확인
curl http://localhost:8080/status
# 예상 출력
{
"node_id": "KR-JEJU-SEOGWIPO-JUNGMUN",
"tier": 1,
"status": "running",
"tps_current": 1.2,
"chain_length": 18432,
"last_merkle_root": "a3f2b1..."
}