> ## Documentation Index > Fetch the complete documentation index at: https://injectivelabs-mintlify-25e241d4.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 네트워크 참여 메인넷, 테스트넷 또는 로컬 개발 네트워크에서 Injective 노드를 설정하고 동기화하세요. Injective 메인넷의 chain-id는 `injective-1`입니다. 스냅샷 복원, state sync 및 block sync injectived 설치, 구성 및 실행 최소 및 권장 사양 *** ### 동기화 옵션 노드를 체인 데이터로 부트스트랩하는 방법을 선택하세요. 대부분의 운영자에게는 스냅샷 복원이 노드를 실행하는 가장 빠른 방법입니다. **옵션 1. 스냅샷 복원 (권장)** 사전 빌드된 스냅샷을 다운로드하여 데이터 디렉터리에 압축을 해제합니다. 새 노드를 동기화하는 가장 빠르고 신뢰할 수 있는 방법입니다. Injective는 공식 프루닝 스냅샷(goleveldb, 약 2-3 GB)을 제공하며, 커뮤니티도 추가 옵션을 유지 관리합니다. 다운로드 링크, 사용 지침, 커뮤니티 제공자는 [Chain Portal의 스냅샷 페이지](https://portal.injective.network/snapshots)를 참조하세요. **검증자:** 스냅샷 복구 중에는 반드시 `priv_validator_state.json`을 백업하고 복원해야 합니다. 전체 절차는 [검증자 문제 해결 가이드](/ko/infra/coordinated-upgrades#스냅샷에서-복구)를 참조하세요. ```bash theme={null} # 예시: 다운로드 및 압축 해제 sudo systemctl stop injectived rm -rf ~/.injectived/data wget -O snapshot.lz4 lz4 -d snapshot.lz4 | tar xf - -C ~/.injectived/ sudo systemctl start injectived ``` **옵션 2. State Sync (CometBFT P2P)** State sync는 모든 과거 블록을 재생하는 대신 CometBFT P2P 레이어를 통해 피어로부터 상태 머신 스냅샷을 다운로드하여 노드를 부트스트랩합니다. 신뢰할 수 있는 RPC 서버 두 개가 필요합니다. 사용 가능한 엔드포인트는 [Chain Portal의 RPC 제공자 페이지](https://portal.injective.network/rpcs)를 참조하세요. `config.toml`의 `[statesync]` 아래에서 구성합니다: ```toml theme={null} [statesync] enable = true rpc_servers = "," trust_height = trust_hash = "" trust_period = "168h0m0s" ``` trust height와 hash를 얻으려면: ```bash theme={null} # 신뢰할 수 있는 RPC에서 최근 높이와 해당 해시 가져오기 LATEST=$(curl -s https://sentry.tm.injective.network/block | jq -r '.result.block.header.height') TRUST_HEIGHT=$((LATEST - 2000)) TRUST_HASH=$(curl -s "https://sentry.tm.injective.network/block?height=$TRUST_HEIGHT" | jq -r '.result.block_id.hash') echo "trust_height = $TRUST_HEIGHT" echo "trust_hash = \"$TRUST_HASH\"" ``` **State sync는 `wasm/` 디렉터리를 복원하지 않습니다.** CometBFT state sync는 IAVL 상태 트리를 복원하지만 `~/.injectived/data/wasm/`에 저장된 CosmWasm 컴파일된 컨트랙트 바이트코드는 복원하지 않습니다. 이 파일이 없으면 동기화 완료 직후 노드에서 **AppHash 불일치**가 발생합니다. 이 문제가 발생하면 다음 중 하나를 수행하세요: 1. **스냅샷 복원**(옵션 1)으로 전환하세요. Injective의 공식 스냅샷에는 `wasm/` 디렉터리가 포함되어 있습니다 2. 신뢰할 수 있는 소스에서 `wasm/` 디렉터리를 확보하여 노드를 시작하기 전에 `~/.injectived/data/wasm/`에 배치하세요 **PebbleDB 사용자:** Injective의 공식 스냅샷은 goleveldb만 사용합니다. PebbleDB 스냅샷은 유지 관리되지 않습니다. PebbleDB를 실행 중이고 스냅샷 복원을 사용할 수 없는 경우, state sync를 사용할 때 `wasm/` 디렉터리를 별도로 확보해야 합니다. **옵션 3. Block Sync (전체 재생)** 기본 동작입니다. 노드가 피어로부터 모든 블록을 다운로드하고 재생합니다. 가장 느린 방법이지만 외부 스냅샷이 필요하지 않습니다. 최근 스냅샷 높이에서 동기화하는 경우가 아니라면 메인넷에서는 실용적이지 않습니다. **동기화 방법 비교:** | 방법 | 속도 | wasm 포함 여부 | 참고 | | -------------- | -------- | --------------------------------------- | --------------------------------- | | **스냅샷 복원** | 빠름 (수 분) | 예 (공식 스냅샷) | 대부분의 운영자에게 권장 | | **State Sync** | 빠름 (수 분) | **아니요** - 수동 wasm 복원 없이는 AppHash 불일치 발생 | `config.toml`의 `[statesync]`에서 구성 | | **Block Sync** | 느림 (수일) | 해당 없음 (실행을 통해 구축) | 기본값, 제네시스부터 메인넷 동기화에는 실용적이지 않음 | #### 피어 검색 노드가 네트워크와 동기화하려면 피어가 필요합니다. `~/.injectived/config/config.toml`의 `[p2p]` 섹션에 시드 또는 persistent peers를 추가하세요. 커뮤니티 제공자들이 최신 시드 및 피어 목록을 유지 관리합니다: * [Polkachu Injective Seeds](https://polkachu.com/seeds/injective) * [Decentrio Injective Infrastructure](https://decentrio.ventures/infrastructure/injective) (시드, 피어, 주소록) 더 빠른 피어 검색을 위해 사전 빌드된 주소록을 다운로드할 수도 있습니다: ```bash theme={null} # Decentrio 주소록 wget -O ~/.injectived/config/addrbook.json \ https://backend.decentrio.ventures/snapshots/injective/addrbook.json ``` *** ### 노드 소프트웨어 #### `injectived` 설치 각 [Injective core 릴리스](https://github.com/InjectiveFoundation/injective-core/releases/latest)에는 `injectived`, [`peggo`](/ko/infra/validator-mainnet/peggo)(Peggy 브릿지 오케스트레이터), `libwasmvm`이 하나의 zip에 포함되어 있습니다. 검증자는 노드와 함께 `peggo`를 실행해야 합니다. 검증자가 아닌 노드 운영자는 `injectived`만 필요합니다. ```bash theme={null} # 최신 릴리스 다운로드 wget https://github.com/InjectiveFoundation/injective-core/releases/latest/download/linux-amd64.zip unzip linux-amd64.zip sudo mv injectived /usr/bin sudo mv libwasmvm.x86_64.so /usr/lib # 검증자는 peggo도 필요합니다 sudo mv peggo /usr/bin ``` #### 새 Injective 노드 초기화 Injective 노드를 실행하기 전에 체인과 제네시스 파일을 초기화합니다: ```bash theme={null} # 인수는 노드의 사용자 지정 사용자 이름입니다. 사람이 읽을 수 있어야 합니다. export MONIKER= injectived init $MONIKER --chain-id injective-1 ``` `init` 명령을 실행하면 `~/.injectived`에 `injectived` 기본 구성 파일이 생성됩니다. #### 메인넷 참여를 위한 구성 준비 메인넷 제네시스 파일을 다운로드합니다. Injective는 공식 스냅샷과 함께 이 파일을 제공합니다: ```bash theme={null} # 메인넷 제네시스 파일 다운로드 wget -O ~/.injectived/config/genesis.json \ http://injective-mainnet-snapshots.s3-website.gra.io.cloud.ovh.net/genesis.json ``` 체크섬을 확인합니다: ```bash theme={null} sha256sum ~/.injectived/config/genesis.json # 예상 값: 573b89727e42b41d43156cd6605c0c8ad4a1ce16d9aad1e1604b02864015d528 ``` 피어 검색을 위한 시드를 구성하고(동기화 옵션 섹션의 [피어 검색](#피어-검색) 참조) `~/.injectived/config/config.toml`에서 `timeout_commit`을 `300ms`로 설정하세요. #### `app.toml` 및 `config.toml`을 사용한 노드 구성 `~/.injectived/config` 내에 두 개의 구성 파일이 자동으로 생성됩니다: * `config.toml`: 합의 레이어(CometBFT)를 구성합니다. [합의 레이어 문서에서 자세히 알아보기](https://docs.cometbft.com/v0.38/core/configuration). * `app.toml`: 상태 프루닝 전략, 텔레메트리, gRPC 및 REST 서버 구성, state sync 등 노드의 애플리케이션 및 실행 레이어를 구성합니다. #### `injectived`용 `systemd` 서비스 구성 (선택 사항) `/etc/systemd/system/injectived.service`에서 구성을 편집합니다: ```bash theme={null} [Unit] Description=injectived [Service] WorkingDirectory=/usr/bin ExecStart=/bin/bash -c '/usr/bin/injectived --log-level=error start' Type=simple Restart=always RestartSec=5 User=root [Install] WantedBy=multi-user.target ``` systemd 서비스 시작 및 재시작: ```bash theme={null} sudo systemctl daemon-reload sudo systemctl restart injectived sudo systemctl status injectived # 시스템 부팅 시 시작 활성화 sudo systemctl enable injectived # 로그 확인 journalctl -u injectived -f ``` 스냅샷 데이터가 올바른 디렉터리에 로드되기 전에 서비스를 중지하고 이후에 시작해야 합니다. ```bash theme={null} # 노드 중지 sudo systemctl stop injectived # 노드 시작 sudo systemctl start injectived ``` *** ### 하드웨어 노드 운영자는 최적의 성능을 달성하기 위해 베어메탈 서버를 배포해야 합니다. 검증자 노드는 높은 가동 시간을 보장하기 위해 권장 하드웨어 사양, 특히 CPU 요구 사항을 충족해야 합니다. | *최소* | *권장* | | :--------------: | :--------------: | | RAM 메모리 128GB | RAM 메모리 128GB | | CPU 12 코어 | CPU 16 코어 | | CPU 기본 클럭 3.7GHz | CPU 기본 클럭 4.2GHz | | 스토리지 2TB NVMe | 스토리지 2TB NVMe | | 네트워크 1Gbps+ | 네트워크 1Gbps+ | *** **지원** 추가 질문이 있으시면 [Discord](https://discord.gg/injective), [Telegram](https://t.me/joininjective) 또는 [이메일](mailto:contact@injectivelabs.org)을 통해 언제든지 Injective 팀에 문의하세요. #### 하드웨어 사양 노드 운영자는 최적의 성능을 달성하기 위해 베어메탈 서버를 배포해야 합니다. 또한 검증자 노드는 높은 가동 시간을 보장하기 위해 권장 하드웨어 사양, 특히 CPU 요구 사항을 충족해야 합니다. | *최소* | *권장* | | :--------------: | :--------------: | | RAM 메모리 128GB | RAM 메모리 128GB | | CPU 12 코어 | CPU 16 코어 | | CPU 기본 클럭 3.7GHz | CPU 기본 클럭 4.2GHz | | 스토리지 2TB NVMe | 스토리지 2TB NVMe | | 네트워크 1Gbps+ | 네트워크 1Gbps+ | #### `injectived` 및 `peggo` 설치 가장 최근 릴리스는 [Injective 릴리스 저장소](https://github.com/InjectiveLabs/testnet/releases)를 참조하세요. 검증자가 아닌 노드 운영자는 `peggo`를 설치할 필요가 없습니다. ```bash theme={null} wget https://github.com/InjectiveLabs/testnet/releases/latest/download/linux-amd64.zip unzip linux-amd64.zip sudo mv peggo /usr/bin sudo mv injectived /usr/bin sudo mv libwasmvm.x86_64.so /usr/lib ``` #### 새 Injective 체인 노드 초기화 Injective 노드를 실행하기 전에 체인과 노드의 제네시스 파일을 초기화해야 합니다: ```bash theme={null} # 인수는 노드의 사용자 지정 사용자 이름입니다. 사람이 읽을 수 있어야 합니다. export MONIKER= # Injective 테스트넷의 chain-id는 "injective-888"입니다 injectived init $MONIKER --chain-id injective-888 ``` `init` 명령을 실행하면 `~/.injectived`에 `injectived` 기본 구성 파일이 생성됩니다. #### 테스트넷 참여를 위한 구성 준비 이제 기본 구성을 테스트넷의 제네시스 파일과 애플리케이션 구성 파일로 업데이트하고, 시드 노드로 영구 피어를 구성해야 합니다. ```bash theme={null} git clone https://github.com/InjectiveLabs/testnet.git # 제네시스 파일을 config 디렉터리에 복사 aws s3 cp --no-sign-request s3://injective-snapshots/testnet/genesis.json . mv genesis.json ~/.injectived/config/ # config 파일을 config 디렉터리에 복사 cp testnet/corfu/70001/app.toml ~/.injectived/config/app.toml cp testnet/corfu/70001/config.toml ~/.injectived/config/config.toml ``` 제네시스 체크섬도 확인할 수 있습니다 - a4abe4e1f5511d4c2f821c1c05ecb44b493eec185c0eec13b1dcd03d36e1a779 ```bash theme={null} sha256sum ~/.injectived/config/genesis.json ``` #### `injectived`용 `systemd` 서비스 구성 `/etc/systemd/system/injectived.service`에서 구성을 편집합니다: ```bash theme={null} [Unit] Description=injectived [Service] WorkingDirectory=/usr/bin ExecStart=/bin/bash -c '/usr/bin/injectived --log-level=error start' Type=simple Restart=always RestartSec=5 User=root [Install] WantedBy=multi-user.target ``` systemd 서비스 시작 및 재시작 ```bash theme={null} sudo systemctl daemon-reload sudo systemctl restart injectived sudo systemctl status injectived # 시스템 부팅 시 시작 활성화 sudo systemctl enable injectived # 로그 확인 journalctl -u injectived -f ``` #### 네트워크와 동기화 스냅샷을 다운로드하고 네트워크와 동기화하려면 [Polkachu Injective 테스트넷 노드 스냅샷](https://polkachu.com/testnets/injective/snapshots)을 참조하세요. **지원** 추가 질문이 있으시면 [Discord](https://discord.gg/injective), [Telegram](https://t.me/joininjective) 또는 [이메일](mailto:contact@injectivelabs.org)을 통해 Injective 팀에 문의하세요. 로컬 노드를 쉽게 설정하려면 [injective-core](https://github.com/InjectiveFoundation/injective-core) 저장소에서 `setup.sh` 스크립트를 다운로드하고 실행하세요. 설치된 `injectived` 버전에 맞는 스크립트 버전을 사용하세요. ```bash theme={null} # 버전 태그를 설치된 injectived 바이너리 버전으로 교체하세요 # 예를 들어, v1.18.3용 스크립트를 사용하려면: wget https://raw.githubusercontent.com/InjectiveFoundation/injective-core/v1.18.3/setup.sh chmod +x ./setup.sh # 스크립트를 실행 가능하게 만들기 ./setup.sh ``` 레거시 [injective-chain-releases](https://github.com/InjectiveLabs/injective-chain-releases) 저장소의 `setup.sh` 스크립트는 더 이상 사용되지 않으며 `injectived` v1.14.1 이하에서만 호환됩니다. 항상 체인 버전에 맞는 [InjectiveFoundation/injective-core](https://github.com/InjectiveFoundation/injective-core) 저장소의 스크립트를 사용하세요. 다음을 실행하여 노드를 시작합니다: ```bash theme={null} injectived start # 이 명령을 실행하면 블록이 들어오기 시작합니다 ``` 스크립트가 수행하는 작업에 대한 자세한 설명과 설정 프로세스에 대한 더 세밀한 제어를 원하면 아래를 계속 읽으세요. #### 체인 초기화 Injective 노드를 실행하기 전에 체인과 노드의 제네시스 파일을 초기화해야 합니다: ```bash theme={null} # 인수는 노드의 사용자 지정 사용자 이름입니다. 사람이 읽을 수 있어야 합니다. injectived init --chain-id=injective-1 ``` 위의 명령은 노드를 실행하는 데 필요한 모든 구성 파일과 네트워크의 초기 상태를 정의하는 기본 제네시스 파일을 생성합니다. 이러한 모든 구성 파일은 기본적으로 `~/.injectived`에 있지만 `--home` 플래그를 전달하여 이 폴더의 위치를 덮어쓸 수 있습니다. `~/.injectived` 이외의 다른 디렉터리를 사용하기로 선택한 경우 `injectived` 명령을 실행할 때마다 `--home` 플래그로 위치를 지정해야 합니다. 이미 제네시스 파일이 있는 경우 `--overwrite` 또는 `-o` 플래그로 덮어쓸 수 있습니다. `~/.injectived` 폴더의 구조는 다음과 같습니다: ```bash theme={null} . # ~/.injectived |- data # 노드에서 사용하는 데이터베이스를 포함합니다. |- config/ |- app.toml # 애플리케이션 관련 구성 파일. |- config.toml # Tendermint 관련 구성 파일. |- genesis.json # 제네시스 파일. |- node_key.json # p2p 프로토콜에서 노드 인증에 사용할 개인 키. |- priv_validator_key.json # 합의 프로토콜에서 검증자로 사용할 개인 키. ``` #### `genesis.json` 파일 수정 이 시점에서 `genesis.json` 파일을 수정해야 합니다: * staking `bond_denom`, crisis `denom`, gov `denom`, mint `denom` 값을 `"inj"`로 변경합니다. 이것이 Injective의 네이티브 토큰이기 때문입니다. 다음 명령을 실행하여 쉽게 수행할 수 있습니다: ```bash theme={null} cat $HOME/.injectived/config/genesis.json | jq '.app_state["staking"]["params"]["bond_denom"]="inj"' > $HOME/.injectived/config/tmp_genesis.json && mv $HOME/.injectived/config/tmp_genesis.json $HOME/.injectived/config/genesis.json cat $HOME/.injectived/config/genesis.json | jq '.app_state["crisis"]["constant_fee"]["denom"]="inj"' > $HOME/.injectived/config/tmp_genesis.json && mv $HOME/.injectived/config/tmp_genesis.json $HOME/.injectived/config/genesis.json cat $HOME/.injectived/config/genesis.json | jq '.app_state["gov"]["deposit_params"]["min_deposit"][0]["denom"]="inj"' > $HOME/.injectived/config/tmp_genesis.json && mv $HOME/.injectived/config/tmp_genesis.json $HOME/.injectived/config/genesis.json cat $HOME/.injectived/config/genesis.json | jq '.app_state["mint"]["params"]["mint_denom"]="inj"' > $HOME/.injectived/config/tmp_genesis.json && mv $HOME/.injectived/config/tmp_genesis.json $HOME/.injectived/config/genesis.json ``` 위의 명령은 기본 `.injectived` 디렉터리를 사용하는 경우에만 작동합니다. 특정 디렉터리의 경우 위의 명령을 수정하거나 `genesis.json` 파일을 수동으로 편집하여 변경 사항을 반영하세요. #### 검증자 계정용 키 생성 체인을 시작하기 전에 최소 하나의 계정으로 상태를 채워야 합니다. 이를 위해 먼저 `test` keyring 백엔드 아래에 `my_validator`라는 새 계정을 keyring에 생성합니다(다른 이름과 다른 백엔드를 자유롭게 선택하세요): ```bash theme={null} injectived keys add my_validator --keyring-backend=test # 생성된 주소를 나중에 사용하기 위해 변수에 저장합니다. MY_VALIDATOR_ADDRESS=$(injectived keys show my_validator -a --keyring-backend=test) ``` 이제 로컬 계정을 생성했으므로 체인의 제네시스 파일에서 `inj` 토큰을 부여합니다. 이렇게 하면 체인이 제네시스부터 이 계정의 존재를 인식하게 됩니다: ```bash theme={null} injectived add-genesis-account $MY_VALIDATOR_ADDRESS 100000000000000000000000000inj --chain-id=injective-1 ``` `$MY_VALIDATOR_ADDRESS`는 keyring의 `my_validator` 키 주소를 보유하는 변수입니다. Injective의 토큰은 `{amount}{denom}` 형식입니다: `amount`는 18자리 정밀도의 소수이고 `denom`은 명명 키(예: `inj`)가 있는 고유한 토큰 식별자입니다. 여기서는 `injectived`에서 스테이킹에 사용되는 토큰 식별자인 `inj` 토큰을 부여합니다. #### 체인에 검증자 추가 이제 계정에 토큰이 있으므로 체인에 검증자를 추가해야 합니다. 검증자는 체인에 새 블록을 추가하기 위해 합의 과정에 참여하는 특수 풀 노드입니다. 모든 계정이 검증자 운영자가 되겠다는 의사를 선언할 수 있지만, 충분한 위임을 받은 계정만 활성 세트에 들어갈 수 있습니다. 이 가이드에서는 위의 `init` 명령을 통해 생성된 로컬 노드를 체인의 검증자로 추가합니다. 검증자는 `gentx`라는 제네시스 파일에 포함된 특수 트랜잭션을 통해 체인이 처음 시작되기 전에 선언할 수 있습니다: ```bash theme={null} # gentx를 생성합니다. injectived genesis gentx my_validator 1000000000000000000000inj --chain-id=injective-1 --keyring-backend=test # 제네시스 파일에 gentx를 추가합니다. injectived genesis collect-gentxs ``` `gentx`는 세 가지 작업을 수행합니다: 1. 생성한 `validator` 계정을 검증자 운영자 계정(즉, 검증자를 제어하는 계정)으로 등록합니다. 2. 제공된 `amount`의 스테이킹 토큰을 셀프 위임합니다. 3. 운영자 계정을 블록 서명에 사용될 Tendermint 노드 pubkey와 연결합니다. `--pubkey` 플래그가 제공되지 않으면 위의 `injectived init` 명령을 통해 생성된 로컬 노드 pubkey가 기본값으로 사용됩니다. `gentx`에 대한 자세한 정보는 다음 명령을 사용하세요: ```bash theme={null} injectived genesis gentx --help ``` #### `app.toml` 및 `config.toml`을 사용하여 노드 구성 `~/.injectived/config` 내에 두 개의 구성 파일이 자동으로 생성됩니다: * `config.toml`: Tendermint를 구성하는 데 사용됩니다([Tendermint 문서](https://docs.tendermint.com/v0.34/tendermint-core/configuration.html)에서 자세히 알아보기). * `app.toml`: Cosmos SDK(Injective가 구축된 기반)에서 생성되며 상태 정리 전략, 텔레메트리, gRPC 및 REST 서버 구성, 상태 동기화 등의 구성에 사용됩니다. 두 파일 모두 자세한 주석이 있습니다. 노드를 조정하려면 직접 참조하세요. 조정할 예시 구성 중 하나는 `app.toml` 내의 `minimum-gas-prices` 필드입니다. 이 필드는 검증자 노드가 트랜잭션 처리를 위해 기꺼이 수락하는 최소 가스 가격을 정의합니다. 비어 있으면 필드를 `10inj`와 같은 값으로 편집해야 합니다. 그렇지 않으면 노드가 시작 시 중단됩니다. 이 튜토리얼에서는 최소 가스 가격을 0으로 설정합니다: ```toml theme={null} # 검증자가 트랜잭션 처리를 위해 기꺼이 수락하는 최소 가스 가격입니다. # 트랜잭션 수수료는 이 구성에 지정된 모든 명명의 # 최소값을 충족해야 합니다 (예: 0.25token1;0.0001token2). minimum-gas-prices = "0inj" ``` #### 로컬넷 실행 이제 모든 것이 설정되었으므로 마침내 노드를 시작할 수 있습니다: ```bash theme={null} injectived start # 이 명령을 실행하면 블록이 들어오기 시작합니다 ``` 이 명령을 사용하면 단일 노드를 실행할 수 있으며, 이것만으로도 노드를 통해 체인과 상호작용하기에 충분하지만 여러 노드를 동시에 실행하여 노드 간의 합의가 어떻게 이루어지는지 확인할 수도 있습니다.