shardeum

KO | EN

gitlite — search

#python #javascript #typescript #tailwindcss #plugin #linux #css #dart #flutter #machine-learning #cpp #html

★ 31,278 Open GitHub ↗

Shardeum은 EVM 기반의 오토스케일링 블록체인입니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Shardeum Logo](https://github.com/shardeum/.github/raw/dev/shardeum-white-bg.png)

**EVM 기반의 자동 확장 블록체인 플랫폼**

[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/shardeum/shardeum/blob/main/LICENSE)
[![Discord](https://img.shields.io/discord/933959587462254612?logo=discord)](https://discord.com/invite/shardeum)
[![Twitter](https://img.shields.io/twitter/follow/Shardeum?style=social)](https://x.com/Shardeum)

## 목차
- [소개](#introduction)
- [기능](#features)
- [시작하기](#getting-started)
- [사전 요구 사항](#prerequisites)
- [설치](#installation)
- [로컬에서 네트워크 실행하기](#running-the-network-locally)
- [JSON-RPC 서버 실행하기](#running-the-json-rpc-server)
- [MetaMask로 테스트하기](#testing-with-metamask)
- [Jest로 테스트하기](#testing-with-jest)
- [중지 및 정리하기](#stopping-and-cleaning-up)
- [헬스 체크](#health-checks)
- [기여하기](#contributing)
- [커뮤니티](#community)
- [라이선스](#license)
## 소개
Shardeum은 동적 상태 샤딩(dynamic state sharding)을 활용하여 전례 없는 확장성을 달성하는 혁신적인 EVM 호환 블록체인 플랫폼입니다. 샤딩 모델을 구현함으로써 Shardeum은 보안이나 탈중앙화를 타협하지 않으면서도 더 빠른 처리 시간과 낮은 트랜잭션 비용을 보장합니다.
## 기능
- \*\*확장성\*\*: 샤딩을 통한 수평적 확장성
- \*\*고성능\*\*: 낮은 지연 시간과 높은 처리량
- \*\*보안\*\*: 고급 암호화 기술과 강력한 합의 프로토콜
- \*\*탈중앙화\*\*: 단일 장애점이 없는 진정한 탈중앙화 네트워크
- \*\*상호운용성\*\*: 기존 DApp 및 스마트 계약을 위한 EVM 호환성
## 시작하기
### 사전 요구 사항
- Node.js (v18.19.1)
- npm (v10.2.4)
- Rust (v1.74.1)
- Docker (선택 사항, 컨테이너화된 배포용)
### 환경 설정
Shardeum을 실행하려면 특정 버전의 Node.js, Rust 및 기타 빌드 도구가 필요합니다.
[이 페이지](local-environment-setup.md)에서 자세한 설정 지침을 확인할 수 있습니다.
>[!IMPORTANT]
> 이것은 매우 중요한 단계입니다. 다음 단계를 진행하기 전에 로컬 환경이 올바르게 설정되어 있는지 확인하세요.
### 설치
1. 리포지토리 복제:
```bash
git clone https://github.com/shardeum/shardeum.git
cd shardeum
```
2. 종속성 설치:
```bash
npm ci
```
3. 네트워크 설정:
```bash
export LOAD\_JSON\_CONFIGS=[full-path-to-your-local-shardeum-repo]/debug-10-nodes.config.json
```
예를 들어, 로컬 shardeum 리포지토리가 `/Users/john/Desktop/projects/shardeum/` 경로에 있는 경우 다음을 실행합니다:
```
export LOAD\_JSON\_CONFIGS=/Users/john/Desktop/projects/shardeum/debug-10-nodes.config.json
```
다양한 설정 옵션에 대해 자세히 알아보려면 [여기](local-environment-setup.md)를 참조하세요.
4. 프로젝트 컴파일
```bash
npm run prepare
```
5. Shardus CLI 설치:
```bash
npm install -g @shardeum-foundation/tools-shardus-cli
npm update @shardeum-foundation/archiver
```
## 로컬에서 네트워크 실행하기
10개의 노드로 로컬 Shardeum 네트워크를 시작하려면 다음을 실행하세요:
```bash
shardus start 10
```
### JSON-RPC 서버 실행하기
1. JSON-RPC 서버 리포지토리 복제:
```bash
git clone https://github.com/shardeum/json-rpc-server.git
cd json-rpc-server
npm install
```
2. 서버 시작:
```bash
npm run start
```
기본 RPC URL은 `http://localhost:8080`입니다.
## MetaMask로 테스트하기
MetaMask를 사용하여 로컬 Shardeum 네트워크를 테스트하려면:
1. [MetaMask 확장 프로그램](https://metamask.io/download/)을 설치합니다.
2. MetaMask에 Shardeum 네트워크를 추가합니다:
- 네트워크 이름: Shardeum
- RPC URL: http://localhost:8080
- 체인 ID: 8082
- 통화 기호: SHM
- 블록 탐색기 URL: http://localhost:6001/
3. 테스트 토큰 획득 및 제네시스 파일 설정: 로컬 Shardeum 네트워크에서 테스트용 SHM 토큰을 받으려면 [src/config/genesis.json](src/config/genesis.json) 파일에 지갑 주소를 추가해야 합니다. 텍스트 편집기에서 이 파일을 열고 원하는 SHM 잔액과 함께 지갑 주소 항목을 다음과 같이 추가하세요:
```json
"YOUR-WALLET-ADDRESS": {
"wei": "200000000000000000000000000"
},
```
## Jest로 테스트하기
모든 테스트를 위해 `src/index.ts`가 모킹(mocked)되어 있습니다. `test/unit/setup.ts` 파일에서 어떻게 모킹되었는지 확인할 수 있습니다. `index` 파일은 많은 종속성을 가지고 있으므로 가능하면 직접 가져오지 말고, 구현 파일나 테스트 파일에서 필요한 특정 파일만 가져오세요.
## 중지 및 정리하기
네트워크를 중지하고 리소스를 정리하려면:
```bash
shard
```

us stop && shardus clean && rm -rf instances
```
## 상태 점검 (Health Checks)
노드의 상태를 확인하기 위한 진단 엔드포인트입니다.
- GET `/is-alive`: 서버가 실행 중인 경우 200 상태 코드를 반환합니다.
- GET `/is-healthy`: 현재는 `/is-alive`와 동일하지만 추후 확장될 예정입니다.

## 기여하기 (Contributing)
기여를 환영합니다! 자세한 내용은 [Contribution Guidelines](CONTRIBUTING.md)를 참조해 주세요. 모든 기여자들은 [Code of Conduct](CODE\_OF\_CONDUCT.md)를 준수해야 합니다.

## 커뮤니티 (Community)
- [GitHub Discussions](https://github.com/shardeum/shardeum/discussions)
- [Discord](https://discord.com/invite/shardeum)
- [X (formerly Twitter)](https://x.com/Shardeum)

## 라이선스 (License)
이 프로젝트는 MIT 라이선스에 따라 배포됩니다. 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.

shardeum

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README