NEAR CLI
NEAR 명령줄(Command Line) 인터페이스 (CLI)는 쉘에서 직접 NEAR 네트워크와 상호 작용할 수 있는 도구입니다. Among other things, the NEAR CLI enables you to:
- NEAR 계정으로 로그인
- 컨트랙트 배포
- 배포된 컨트랙트에서 상호 작용 및 정보 쿼리
내부적으로 NEAR CLI는
NEAR JavaScript API
를 활용합니다. :::정보
The NEAR CLI also comes with an implementation in Rust called near-cli-rs
. If you want to use near-cli
while you have near-cli-rs
installed, prefix the following commands with npx
. :::
Overview
자세한 정보와 예를 보려면 명령을 클릭하세요.
명령 | 설명 |
---|---|
ACCESS KEYS | |
near add-credentials | Stores credentials for an account locally |
near add-key | 계정에 새 액세스 키 추가 |
near delete-key | 계정에서 액세스 키 삭제 |
near generate-key | generates a key pair and optionally stores it locally as credentials for an accountId |
near list-keys | 지정된 계정에 대한 모든 액세스 키 및 세부 정보 표시 |
near login | stores a full access key locally using NEAR Wallet |
ACCOUNTS | |
near create-account | creates a new account, either using a faucet to fund it, or an account saved locally |
near delete-account | 계정을 삭제하고 남은 잔액을 수령자 계정으로 이체 |
near list-keys | 주어진 계정에 대한 모든 액세스 키 표시 |
near send-near | 한 계정에서 다른 계정으로 토큰 전송 |
near state | 계정 내 세부 정보 확인 |
CONTRACTS | |
near call | change 또는 view 메서드를 호출할 수 있는 컨트랙트 호출 생성 |
near deploy | NEAR 블록체인에 스마트 컨트랙트 배포 |
near storage | Shows the storage state of a given contract, i.e. the data stored in a contract |
near view | view 메서드만 호출할 수 있는 컨트랙트 호출 생성 |
TRANSACTIONS | |
near tx-status | txHash 를 통해 트랜잭션 상태 조회 |
설정
설치
npm
과NodeJS
의 최신 버전이 설치되었는지 확인하세요.
Mac / Linux
- OS X가 USB 장치와 관련된 노드 패키지를 처리하는 방식으로 인해 때때로 Ledger를 사용하는 데 문제가 있으므로,
nvm
과 같은 패키지 관리자를 사용하여npm
및node
를 설치합니다. 여기를 클릭하세요. - Node 버전 12 이상을 설치했는지 확인하세요.
- 다음을 실행하여
near-cli
를 전역적으로 설치합니다.
npm install -g near-cli
For example, on Ubuntu 20.04 near-cli
can be installed by running:
# Install nvm (https://github.com/nvm-sh/nvm?tab=readme-ov-file#installing-and-updating)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
# Install node
nvm install node
# Install near-cli
npm install -g near-cli
# near-cli works!
near --help
Windows
Windows 사용자의 경우, Linux용 Windows 하위 시스템(
WSL
)을 사용하는 것이 좋습니다.
WSL
설치 [여기를 클릭하세요]npm
설치 [여기를 클릭하세요]Node.js
설치 [여기를 클릭하세요]npm
기본 디렉토리 변경 [여기를 클릭하세요]- 이는
WSL
권한 문제를 피하기 위한 것입니다.
- 이는
- 다음을 실행하여
WSL
을 열고near-cli
를 전역적으로 설치
npm install -g near-cli
네트워크 선택
near-cli
의 기본 네트워크는testnet
입니다.
- 명령 앞에 환경 변수를 추가하여 네트워크를 변경할 수 있습니다.
NEAR_NETWORK=testnet near send ...
- 또는, 다음을 실행하여 전역 환경 변수를 설정할 수 있습니다.
export NEAR_NETWORK=mainnet
- All commands that interact with the network also allow to pass the
--networkId
option.
near send-near ... --networkId mainnet