KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

go-ethereum

★ 51,285 Open GitHub ↗

Ethereum 프로토콜의 Go 구현체

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## Go Ethereum
이더리움(Ethereum) 프로토콜의 Golang 실행 레이어 구현체입니다.
[![API Reference](https://pkg.go.dev/badge/github.com/ethereum/go-ethereum)](https://pkg.go.dev/github.com/ethereum/go-ethereum?tab=doc)
[![Go Report Card](https://goreportcard.com/badge/github.com/ethereum/go-ethereum)](https://goreportcard.com/report/github.com/ethereum/go-ethereum)
[![Travis](https://app.travis-ci.com/ethereum/go-ethereum.svg?branch=master)](https://app.travis-ci.com/github/ethereum/go-ethereum)
[![Discord](https://img.shields.io/badge/discord-join%20chat-blue.svg)](https://discord.gg/nthXNEv)
[![Twitter](https://img.shields.io/twitter/follow/go\_ethereum)](https://x.com/go\_ethereum)
안정 버전 및 불안정 master 브랜치에 대한 자동 빌드가 제공됩니다. 바이너리 아카이브는 https://geth.ethereum.org/downloads/에 게시됩니다.

## 소스 빌드하기
사전 요구 사항 및 자세한 빌드 지침은 [Installation Instructions](https://geth.ethereum.org/docs/getting-started/installing-geth)를 참조하세요.
`geth`를 빌드하려면 Go(버전 1.23 이상)와 C 컴파일러가 모두 필요합니다. 선호하는 패키지 관리자를 사용하여 설치할 수 있습니다. 종속성이 설치되면 다음을 실행하세요.
```shell
make geth
```
또는 전체 유틸리티 스위트를 빌드하려면 다음을 실행하세요.
```shell
make all
```

## 실행 파일
go-ethereum 프로젝트에는 `cmd` 디렉터리에 있는 여러 래퍼/실행 파일이 포함되어 있습니다.
| 명령어 | 설명 |
| :--------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \*\*`geth`\*\* | 당사의 주요 이더리움 CLI 클라이언트입니다. 이더리움 네트워크(메인넷, 테스트넷 또는 프라이빗넷)로 들어가는 진입점이며, 풀 노드(기본값), 아카이브 노드(모든 과거 상태 유지) 또는 라이트 노드(실시간으로 데이터 검색)로 실행할 수 있습니다. HTTP, WebSocket 및/또C IPC 전송 위에 노출된 JSON RPC 엔드포인트를 통해 다른 프로세스에서 이더리움 네트워크로 들어가는 게이트웨이로 사용할 수 있습니다. 명령줄 옵션에 대해서는 `geth --help` 및 [CLI page](https://geth.ethereum.org/docs/fundamentals/command-line-options)를 참조하세요. |
| `devp2p` | 전체 블록체인을 실행하지 않고 네트워킹 레이어의 노드와 상호 작용하는 유틸리티입니다. |
| `abigen` | 이더리움 컨트랙트 정의를 사용하기 쉽고 컴파일 타임에 타입 안전한 Go 패키지로 변환하는 소스 코드 생성기입니다. 일반 [Ethereum contract ABIs](https://docs.soliditylang.org/en/develop/abi-spec.html)에서 작동하며, 컨트랙트 바이트코 도 함께 사용할 수 있는 경우 기능이 확장됩니다. 그러나 Solidity 소스 파일도 허용하므로 개발이 훨씬 간소화됩니다. 자세한 내용은 [Native DApps](https://geth.ethereum.org/docs/developers/dapp-developer/native-bindings) 페이지를 참조하세요. |
| `evm` | 설정 가능한 환경 및 실행 모드 내에서 바이트코드 조각을 실행할 수 있는 EVM(Ethereum Virtual Machine)의 개발자 유틸리티 버전입니다. 그 목적은 EVM 연산코드의 격리되고 세밀한 디버깅을 허용하는 것입니다 (예: `evm --code 60ff60ff --debug run`). |
| `rlpdump` | 이더리움 프로토콜(네트워크 및 컨센서스 측면 모두)에서 사용하는 데이터 인코딩인 바이너리 RLP([Recursive Length Prefix](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp)) 덤프를 사용자가 더 보기 쉬운 계층적 표현으로 변환하는 개발자 유틸리티 도구입니다 (예: `rlpdump --hex CE0183FFFFFFC4C304050583616263`). |

## `geth` 실행하기
가능한 모든 명령줄 플래그를 모두 다루는 것은 여기서 범위를 벗어나지만([CLI Wiki page](https://geth.ethereum.org/docs/fundamentals/command-line-options) 참조), 자신만의 `geth` 인스턴스를 실행하는 방법을 빠르게 익힐 수 있도록 몇 가지 일반적인 매개변수 조합을 나열해 두었습니다.

### 하드웨어 요구 사항
최소 사양:
\* 4개 이상의 코어 CPU
\* 8GB RAM
\* 메인넷 동기화를 위한 1TB의 여유 저장 공간
\* 8 MBit/sec 다운로드 인터넷 서비스

권장 사양:
\* 8개 이상의 코어 빠른 CPU
\* 16GB 이상의 RAM
\* 최소 1TB의 여유 공간이 있는 고성능 SSD
\* 25+ MBit/sec 다운로드 인터넷 서비스

### 메인 이더리움 네트워크의 풀 노드
가장 흔한 시나리오는 사용자가 단순히 이더리움 네트워크와 상호 작용(계정 생성, 자금 이체, 컨트랙트 배포 및 상호 작용)하려는 경우입니다. 이 특정 사용 사례의 경우 사용자는 수년 된 과거 데이터에 신경 쓰지 않으므로 네트워크의 현재 상태로 빠르게 동기화할 수 있습니다. 이를 수행하려면:
```shell
$ geth console
```
이 명령어는 다음을 수행합니다:
\* `geth`를 스냅 동기화 모드(기본값, `--syncmode` 플래그로 변경 가능)로 시작하여, CPU 집약적인 이더리움 네트워크의 전체 기록 처리를 피하는 대가로 더 많은 데이터를 다운로드하게 합니다.
\* 내장된 대화형 [JavaScript console](https://geth.ethereum.org/docs/interacting-with-geth/javascript-console)을 시작합니다 (후행 `console` 하위 명령을 통해). 이를 통해 [`web3` methods](https://github.com/ChainSafe/web3.js/blob/0.20.7/DOCUMENTATION.md)를 사용하여 상호 작용할 수 있습니다 (참고: `geth`에 번들로 제공되는 `web3` 버전은 매우 오래되었으며 공식 문서와 최신 상태가 아님). 또한 `geth` 자체의 [management APIs](https://geth.ethereum.org/docs/interacting-with-geth/rpc)를 사용할 수 있습니다.
이 도구는 선택 사항이며 생략하더라도 실행 중인 `geth` 인스턴스에 언제든지 `geth attach`로 연결할 수 있습니다.

### Holesky 테스트 네트워크의 풀 노드
개발자 관점에서, 이더리움 컨트랙트 작성을 시험해보고 싶다면 전체 시스템에 익숙해질 때까지 실제 돈을 쓰지 않고 하고 싶을 것입니다. 즉, 메인 네트워크에 연결하는 대신, 메인 네트워크와 완전히 동일하지만 플레이용 이더(play-Ether)만 있는 **테스트** 네트워크에 노드와 함께 참여하고자 하는 것입니다.
```shell
$ geth --holesky console
```
`console` 하위 명령은 위와 동일한 의미를 가지며 테스트넷에서도 유용합니다.
그러나 `--holesky` 플래그를 지정하면 `geth` 인스턴스가 약간 재구성됩니다:
\* 메인 이더리움 네트워크에 연결하는 대신, 클라이언트는 서로 다른 P2P 부트노드, 서로 다른 네트워크 ID 및 제네시스 상태를 사용하는 Holesky 테스트 네트워크에 연결합니다.
\* 기본 데이터 디렉터리(예: Linux의 경우 `~/.ethereum`)를 사용하는 대신, `geth`는 `holesky` 하위 폴더(Linux의 경우 `~/.ethereum/holesky`)로 한 단계 더 깊이 중첩됩니다. 참고로, OSX 및 Linux에서는 실행 중인 테스트넷 노드에 연결할 때 `geth attach`가 기본적으로 프로덕션 노드 엔드포인트에 연결하려고 시도하므로 사용자 지정 엔드포인트를 사용해야 함을 의미합니다(예: `geth attach /holesky/geth.ipc`). Windows 사용자는 이 영향을 받지 않습니다.

*참고: 일부 내부 보호 조치로 인해 메인 네트워크와 테스트 네트워크 간에 트랜잭션이 교차하는 것을 방지하지만, 플레이용 자금과 실제 자금에는 항상 별도의 계정을 사용해야 합니다. 계정을 수동으로 이동하지 않는 한, `geth`는 기본적으로 두 네트워크를 올바르게 분리하며 그 사이에 어떤 계정도 사용할 수 있게 만들지 않습니다.*

### 설정
`geth` 바이너리에 수많은 플래그를 전달하는 대안으로, 다음을 통해 설정 파일을 전달할 수도 있습니다:
```shell
$ geth --config /path/to/your\_config.toml
```
파일이 어떻게 생겼는지 파악하려면 `dumpconfig` 하위 명령을 사용하여 기존 설정을 내보낼 수 있습니다:
```shell
$ geth --your-favourite-flags dumpconfig
```

#### Docker 빠른 시작
컴퓨터에서 이더리움을 빠르고 쉽게 실행하는 방법 중 하나는 Docker를 사용하는 것입니다:
```shell
docker run -d --name ethereum-node -v /Users/alice/ethereum:/root \
-p 8545:8545 -p 30303:30303 \
ethereum/client-go
```
이렇게 하면 위의 명령어와 같이 DB 메모리 허용량을 1GB로 설정하여 스냅 동기화 모드로 `geth`가 시작됩니다. 또한 블록체인을 저장하기 위해 홈 디렉터리에 지속성 볼륨을 생성하고 기본 포트를 매핑합니다. 슬림 버전의 이미지를 위한 `alpine` 태그도 사용할 수 있습니다.

다른 컨테이너 및/또는 호스트에서 RPC에 액세스하려는 경우 `--http.addr 0.0.0.0`을 잊지 마세요. 기본적으로 `geth`는 로컬 인터페이스에 바인딩되며 외부에서 RPC 엔드포인트에 액세스할 수 없습니다.

### 프로그래밍 방식으로 `geth` 노드 인터페이스 연결하기
개발자로서 콘솔을 통해 수동으로 하는 것이 아니라 자신의 프로그램을 통해 `geth` 및 이더리움 네트워크와 상호 작용하고 싶어질 것입니다. 이를 돕기 위해 `geth`는 JSON-RPC 기반 API([standard APIs](https://ethereum.org/en/developers/docs/apis/json-rpc/) 및 [`geth` specific APIs](https://geth.ethereum.org/docs/interacting-with-geth/rpc))에 대한 내장 지원을 제공합니다.
이들은 HTTP, WebSockets 및 IPC(UNIX 기반 플랫폼의 UNIX 소켓 및 Windows의 명명된 파이프)를 통해 노출될 수 있습니다.

IPC 인터페이스는 기본적으로 활성화되어 있으며 `geth`에서 지원하는 모든 API를 노출하는 반면, HTTP 및 WS 인터페이스는 보안상의 이유로 수동으로 활성화해야 하며 API의 하위 집합만 노출합니다. 이들은 예상대로 켜거나 끌 수 있고 구성할 수 있습니다.

HTTP 기반 JSON-RPC API 옵션:
\* `--http` HTTP-RPC 서버 활성화
\* `--http.addr` HTTP-RPC 서버 수신 인터페이스 (기본값: `localhost`)
\* `--http.port` HTTP-RPC 서버 수신 포트 (기본값: `8545`)
\* `--http.api` HTTP-RPC 인터페이스를 통해 제공되는 API (기본값: `eth,net,web3`)
\* `--http.corsdomain` 교차 출처 요청을 수락할 도메인의 쉼표로 구분된 목록 (브라우저 강제 적용)
\* `--ws` WS-RPC 서버 활성화
\* `--ws.addr` WS-RPC 서버 수신 인터페이스 (기본값: `localhost`)
\* `--ws.port` WS-RPC 서버 수신 포트 (기본값: `8546`)
\* `--ws.api` WS-RPC 인터페이스를 통해 제공되는 API (기본값: `eth,net,web3`)
\* `--ws.origins` WebSocket 요청을 수락할 출처
\* `--ipcdisable` IPC-RPC 서버 비활성화
\* `--ipcpath` 데이터 디렉터리 내 IPC 소켓/파이프 파일 이름 (명시적 경로는 이를 벗어남)

위의 플래그로 구성된 `geth` 노드에 HTTP, WS 또는 IPC를 통해 연결하려면 고유한 프로그래밍 환경의 기능(라이브러리, 도구 등)을 사용해야 하며 모든 전송에서 [JSON-RPC](https://www.jsonrpc.org/specification)를 사용해야 합니다. 여러 요청에 대해 동일한 연결을 재사용할 수 있습니다!

\*\*참고: HTTP/WS 기반 전송을 열기 전에 보안에 미치는 영향을 이해하십시오! 인터넷의 해커들은 API가 노출된 이더리움 노드를 손상시키기 위해 적극적으로 노력하고 있습니다! 또한 모든 브라우저 탭이 로컬에서 실행되는 웹 서버에 액세스할 수 있으므로 악성 웹 페이지가 로컬에서 사용 가능한 API를 손상시키려고 시도할 수 있습니다!\*\*

### 프라이빗 네트워크 운영
공식 네트워크에서는 당연하게 여겨지는 많은 설정을 수동으로 설정해야 하므로 자신만의 프라이빗 네트워크를 유지 관리하는 것은 더 복잡합니다.
안타깝게도 [the Merge](https://ethereum.org/en/roadmap/merge/) 이후에는 해당 비콘 체인(beacon chain)을 함께 설정하지 않고는 geth 노드 네트워크를 쉽게 설정하는 것이 더 이상 불가능합니다.

사용 사례에 따라 세 가지 다른 솔루션이 있습니다:
\* CI에서 Go로 스마트 컨트랙트를 테스트하는 간단한 방법을 찾고 있다면 [Simulated Backend](https://geth.ethereum.org/docs/developers/dapp-developer/native-bindings#blockchain-simulator)를 사용할 수 있습니다.
\* 테스트를 위한 편리한 단일 노드 환경을 원한다면 [Dev Mode](https://geth.ethereum.org/docs/developers/dapp-developer/dev-mode)를 사용할 수 있습니다.
\* 다중 노드 테스트 네트워크를 찾고 있다면 [Kurtosis](https://geth.ethereum.org/docs/fundamentals/kurtosis)를 사용하여 아주 쉽게 설정할 수 있습니다.

## 기여하기
소스 코드에 도움을 주시는 것을 고려해 주셔서 감사합니다! 우리는 인터넷상의 누구에게나 기여를 환영하며, 가장 작은 수정이라도 감사히 받습니다!
go-ethereum에 기여하고 싶다면 포크하고, 수정하고, 커밋하고, 풀 리퀘스트를 보내 메인인터가 검토하고 메인 코드베이스에 병합할 수 있도록 하세요. 하지만 더 복잡한 변경 사항을 제출하려면 먼저 [our Discord Server](https://discord.gg/invite/nthXNEv)에서 코어 개발자들과 상의하여 해당 변경 사항이 프로젝트의 일반적인 철학과 일치하는지 확인하고, 노력을 훨씬 가볍게 만들고 검토 및 병합 절차를 빠르고 간단하게 만들 수 있는 초기 피드백을 받으시기 바랍니다.

기여가 코딩 지침을 준수하는지 확인하십시오:
\* 코드는 공식 Go [formatting](https://golang.org/doc/effective\_go.html#formatting) 지침을 준수해야 합니다 ([gofmt](https://golang.org/cmd/gofmt/) 사용).
\* 코드는 공식 Go [commentary](https://golang.org/doc/effective\_go.html#commentary) 지침을 준수하여 문서화되어야 합니다.
\* 풀 리퀘스트는 `master` 브랜치를 기반으로 하고 이에 대해 열려야 합니다.
\* 커밋 메시지에는 수정하는 패키지 접두사가 붙어야 합니다.
\* 예: "eth, rpc: make trace configs optional"

환경 구성, 프로젝트 종속성 관리 및 테스트 절차에 대한 자세한 내용은 [Developers' Guide](https://geth.ethereum.org/docs/developers/geth-developer/dev-guide)를 참조하십시오.

### geth.ethereum.org에 기여하기
[go-ethereum website](https://geth.ethereum.org)에 대한 기여는 `website` 브랜치를 체크아웃하고 이에 대한 풀 리퀘스트를 제기해 주세요.
더 자세한 지침은 `website` 브랜치 [README](https://github.com/ethereum/go-ethereum/tree/website#readme) 또는 웹사이트의 [contributing](https://geth.ethereum.org/docs/developers/geth-developer/contributing) 페이지를 참조하세요.

## 라이선스
go-ethereum 라이브러리(`cmd` 디렉터리 외부의 모든 코드)는 [GNU Lesser General Public License v3.0](https://www.gnu.org/licenses/lgpl-3.0.en.html)에 따라 라이선스가 부여되며, 이는 저장소의 `COPYING.LESSER` 파일에도 포함되어 있습니다.
go-ethereum 바이너리(`cmd` 디렉터리 내부의 모든 코드)는 [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.en.html)에 따라 라이선스가 부여되며, 이는 저장소의 `COPYING` 파일에도 포함되어 있습니다.

go-ethereum

Was this content helpful?

Recent Feedback

Download README