NEAR CLI - 기초
컨트랙트가 준비되면, 모든 사람이 사용할 수 있도록 NEAR 네트워크에 배포할 수 있습니다.
NEAR CLI를 사용하여 컨트랙트를 배포하고, 컨트랙트 내 메서드를 호출하는 방법을 안내해 드립니다.
정보
이 페이지에서는 NEAR CLI의 기본 사항만 다룹니다. 자세한 내용은 NEAR CLI 설명서 페이지를 참조하세요.
Deploying the Contract
NEAR CLI 덕분에 컨트랙트 배포는 다음과 같이 간단하게 수행될 수 있습니다.
- 컨트랙트를 wasm으로 컴파일합니다(템플릿 내
yarn build를 통해 자동으로 수행됨). - Create an account and deploy the contract into it using
NEAR CLI.
계정 생성 및 배포
- near-cli
- near-cli-rs
# Create a new account pre-funded by a faucet & deploy
near create-account <accountId> --useFaucet
near deploy <accountId> <route_to_wasm>
# Get the account name
cat ./neardev/dev-account
# Automatically deploy the wasm in a new account
near account create-account sponsor-by-faucet-service <my-new-dev-account>.testnet autogenerate-new-keypair save-to-keychain network-config testnet create
near contract deploy <my-new-dev-account>.testnet use-file <route_to_wasm> without-init-call network-config testnet sign-with-keychain
기존 계정에 배포
- near-cli
- near-cli-rs
# login into your account
near login
# deploy the contract
near deploy <accountId> <route_to_wasm>
# login into your account
near account import-account using-web-wallet network-config testnet
# deploy the contract
near contract deploy <accountId> use-file <route_to_wasm> without-init-call network-config testnet sign-with-keychain send
팁
You can overwrite a contract by deploying another on top of it. 이 경우 계정의 로직이 변경되지만, 상태는 유지됩니다.
정보
기본적으로
near-cli는 testnet 네트워크를 사용합니다. mainnet에 배포하려면, NEAR_ENV=mainnet를 정의하세요.Naming Convention for Public-Facing Methods
이를 고려하여, 대부분 Rust 컨트랙트로 구성된 나머지 NEAR 생태계와 호환되도록 모든 SDK에서 snake_case를 사용해 메서드의 이름을 정하는 것이 좋습니다.
Initializing the Contract
컨트랙트에 초기화 메서드가 있는 경우, 이를 호출하여 상태를 초기화할 수 있습니다. 컨트랙트가 상태에 대한 default 값을 구현하는 경우에는 필요하지 않습니다.
- near-cli
- near-cli-rs
# Call the initialization method (`init` in our examples)
near call <contractId> <initMethod> [<args>] --accountId <accountId>
# Call the initialization method (`init` in our examples)
near contract call-function as-transaction <contractId> <initMethod> json-args [<args>] prepaid-gas '30 TeraGas' attached-deposit '0 NEAR' sign-as <accountId> network-config testnet sign-with-keychain send
정보
Calling the Contract
컨트랙트가 배포되고 나면, NEAR CLI를 통해 바로 컨트랙트와 상호 작용할 수 있습니다.
View 메서드
View 메서드는 읽기 전용 작업을 수행하는 메서드입니다. 이러한 메서드를 호출하는 것은 무료이며, 호출에 사용되는 계정을 지정할 필요가 없습니다.
- near-cli
- near-cli-rs
near view <contractId> <methodName>
near contract call-function as-read-only <contractId> <methodName> text-args '' network-config testnet now
팁
View 메서드는 실행에 기본적으로 200 TGAS를 소모합니다.
메서드 변경
변경 방법은 읽기 및 쓰기 작업을 모두 수행하는 방법입니다. 이러한 방법의 경우, 호출에 사용되는 계정을 지정해야 합니다.
- near-cli
- near-cli-rs
near call <contractId> <methodName> <jsonArgs> --accountId <yourAccount> [--deposit <amount>] [--gas <GAS>]
near contract call-function as-transaction <AccountId> <MethodName> json-args <JsonArgs> prepaid-gas <PrepaidGas> attached-deposit <AttachedDeposit> sign-as <AccountId> network-config testnet sign-with-keychain send
