환경

모든 메서드 실행에는 다음과 같은 것들과 관련된 환경이 있습니다.

메서드를 호출한 사람
호출에 첨부된 돈
사용 가능한 컴퓨팅 리소스
현재 타임스탬프
공개 키 유도를 위한 헬퍼 함수(예시)

환경 변수

🌐 JavaScript
🦀 Rust

Variable Name	SDK Variable	Description
Predecessor	`near.predecessorAccountId()`	Account ID that called this method
Current Account	`near.currentAccountId()`	Account ID of this smart contract
Signer	`near.signerAccountId()`	Account ID that signed the transaction leading to this execution
Attached Deposit	`near.attachedDeposit()`	Amount in NEAR attached to the call by the predecessor
Account Balance	`near.accountBalance()`	Balance of this smart contract (including Attached Deposit)
Prepaid Gas	`near.prepaidGas()`	Amount of gas available for execution
Timestamp	`near.blockTimestamp()`	Current timestamp (number of non-leap-nanoseconds since January 1, 1970 0:00:00 UTC)
Current Epoch	`near.epochHeight()`	Current epoch in the blockchain
Block Index	`near.blockIndex()`	Current block index (a.k.a. block height)
Storage Used	`near.storageUsage()`	Current storage used by this smart contract
Used Gas	`near.usedGas()`	Amount of gas used for execution
Signer Public Key	`near.signerAccountPk()`	Sender Public Key
Account Locked Balance	`near.accountLockedBalance()`	Balance of this smart contract that is locked

Variable Name	SDK Variable	Description
Predecessor	`env::predecessor_account_id()`	Account ID that called this method
Current Account	`env::current_account_id()`	Account ID of this smart contract
Signer	`env::signer_account_id()`	Account ID that signed the transaction leading to this execution
Attached Deposit	`env::attached_deposit()`	Amount in NEAR attached to the call by the predecessor
Account Balance	`env::account_balance()`	Balance of this smart contract (including Attached Deposit)
Prepaid Gas	`env::prepaid_gas()`	Amount of gas available for execution
Timestamp	`env::block_timestamp()`	Current timestamp (number of non-leap-nanoseconds since January 1, 1970 0:00:00 UTC)
Current Epoch	`env::epoch_height()`	Current epoch in the blockchain
Block Index	`env::block_index()`	Current block index (a.k.a. block height)
Storage Used	`env::storage_usage()`	Current storage used by this smart contract in bytes
Storage Byte Cost	`env::storage_byte_cost()`	Current storage cost per byte in yoctoNEAR
Used Gas	`env::used_gas()`	Amount of gas used for execution
Signer Public Key	`env::signer_account_pk()`	Sender Public Key
Account Locked Balance	`env::account_locked_balance()`	Balance of this smart contract that is locked

호출자는 누구인가요? Who am I?

환경에서는 세 가지 중요한 사용자인 current_account (현재 계정), predecessor (전임자), 그리고 signer (서명자)에 대한 정보를 제공합니다.

Current Account

current_account 에는 컨트랙트가 배포된 주소가 포함되어 있습니다. This is very useful to implement ownership, e.g. making a public method only callable by the contract itself.

전임자(Predecessor)와 서명자

predecessor는 컨트랙트에서 메서드를 호출한 계정입니다. 한편, signer는 최초 트랜잭션에 서명한 계정을 의미합니다.

단순 트랜잭션(교차 컨트랙트 호출 없음) 중에는 predecessor와 signer가 동일합니다. 예를 들어 alice.near가 contract.near를 호출하는 경우, 컨트랙트의 관점에서 alice.near는 predecessor인 동시에 signer인 것입니다. 그러나 contract.near가 교차 컨트랙트 호출을 생성하면, predecessor에 변경 사항이 발생합니다. In the example below, when pool.near executes, it would see contract.near as the predecessor and alice.near as the signer.

스마트 컨트랙트와 상호 작용하는 사용자에 대한 정보에 액세스할 수 있습니다.

팁

대부분의 시나리오에서는 **predecessor(전임자)**만 알면 됩니다. 그러나, signer(서명자)가 매우 필요한 상황도 있습니다. 예를 들어, 이 마켓플레이스에 NFT를 추가할 때, 컨트랙트는 signer를 통해 트랜잭션을 생성한 사람이 NFT 소유자인지 확인합니다.

잔고 및 첨부된 NEAR

이는 모두 yoctoNEAR ((1 Ⓝ = 10²⁴yⓃ))로 표현됩니다.

Attached Deposit

attached_deposit은 호출에 연결된 predecessor의 yoctoNEAR 양을 나타냅니다.

이 금액은 컨트랙트 계정에 이미 예치되어 있으며, 메서드 패닉이 발생하면 predecessor에게 자동으로 반환 됩니다.

warning

교차 컨트랙트 호출을 했는데 패닉이 발생하면 자금이 컨트랙트로 다시 전송됩니다. 콜백 섹션에서 이 상황을 처리하는 방법을 참고하세요.

Account Balance

account_balance는 컨트랙트 잔고를 나타냅니다(current_account).

이는 attached_deposit을 포함하는데, 이는 해당 값이 메소드 실행 시 저장되었기 때문입니다.

컨트랙트에 잠긴 $NEAR가 있으면 account_locked_balance에 나타납니다.

Storage Used

storage_used는 현재 컨트랙트에서 사용되고 있는 스토리지의 양을 나타냅니다.

팁

구조가 차지하는 스토리지의 양을 알고 싶다면, 저장 전후에 스토리지를 출력해보면 됩니다.

시간

환경은 시간의 흐름을 알려주는 세 가지 다른 메서드를 공개하며, 이들은 각각 다른 방식으로 블록체인 내 시간을 나타냅니다.

Timestamp

timestamp 속성은 호출이 실행된 대략적인 UNIX 타임스탬프를 나타냅니다. 이는 인간의 방식으로 시간의 흐름을 정량화하여 특정 날짜가 지났는지 여부를 확인할 수 있습니다.

Current Epoch

NEAR 블록체인은 에포크 단위로 블록을 묶습니다. current_epoch 속성은 지금까지 경과한 에포크 수를 측정합니다. 이는 밸리데이터와 같이 에포크에서 시간을 측정하는 다른 컨트랙트와 협력하는 행위를 매우 쉽게 만들어 줍니다.

Block Index

block_index는 해당 트랜잭션이 블록체인에 추가될 블록의 인덱스를 나타냅니다.

가스

컨트랙트에는 각 호출에 사용할 컴퓨팅 리소스가 제한되어 있습니다. Such resources are measured in Gas.

1 PetaGas(1_000 TGas)는 약 1초의 계산 시간을 의미합니다.

각 코드 명령에는 일정량의 가스가 소모되며, 가스가 부족하면 Exceeded the prepaid gas라는 오류 메시지와 함께 실행이 중단됩니다.

환경은 두 가지 가스 관련 인수인 prepaid_gas 및 used_gas에 대한 액세스를 제공합니다.

Prepaid Gas

prepaid_gas는 predecessor가 해당 호출에 첨부한 가스의 양을 의미합니다. 이는 300TGas (300 * 10¹² Gas)를 넘을 수 없습니다.

Used Gas

used_gas는 지금까지 사용한 Gas의 양을 포함합니다. 이는 메서드를 실행하는 가스 비용을 추정하는 데에 유용합니다.

warning

교차 컨트랙트 호출 중 콜백에 완전히 실행하기에 충분한 가스가 있는지 항상 확인하세요.

팁

If you already estimated the Gas a method needs, you can ensure it never runs out of Gas by using assert

🦀 Rust

const REQUIRED_GAS: Gas = Gas(20_000_000_000_000); // 20 TGas
assert!(env::prepaid_gas() >= REQUIRED_GAS, "Please attach at least 20 TGas");

환경 함수

Besides environmental variables, the SDK also exposes some functions to perform basic cryptographic operations

🌐 JavaScript
🦀 Rust

Function Name	SDK method	Description
SHA 256	`near.sha256(value)`	Hashes a sequence of bytes using sha256.
Keccak 256	`near.keccak256(value)`	Hashes a sequence of bytes using keccak256.
Keccak 512	`near.keccak512(value)`	Hashes a sequence of bytes using keccak512.
RIPEMD 160	`near.ripemd160(value)`	Hashes the bytes using the RIPEMD-160 hash function.
EC Recover	`near.ecrecover(hash, sig, v, malleabilityFlag)`	Recovers an ECDSA signer address from a 32-byte message `hash` and a corresponding `signature` along with `v` recovery byte. Takes in an additional flag to check for malleability of the signature which is generally only ideal for transactions. Returns 64 bytes representing the public key if the recovery was successful.
Log String	`near.log(msg)`	Logs the string message. This message is stored on chain.
Validator Stake	`near.validatorStake(accountId)`	For a given account return its current stake. If the account is not a validator, returns 0.
Validator Total Stake	`near.validatorTotalStake()`	Returns the total stake of validators in the current epoch.

Function Name	SDK method	Description
SHA 256	`env::sha256(value)`	Hashes a sequence of bytes using sha256.
Keccak 256	`env::keccak256(value)`	Hashes a sequence of bytes using keccak256.
Keccak 512	`env::keccak512(value)`	Hashes a sequence of bytes using keccak512.
SHA 256 (Array)	`env::sha256_array(value)`	Hashes the bytes using the SHA-256 hash function. This returns a 32 byte hash.
Keccak 256 (Array)	`env::keccak256_array(value)`	Hashes the bytes using the Keccak-256 hash function. This returns a 32 byte hash.
Keccak 512 (Array)	`env::keccak512_array(value)`	Hashes the bytes using the Keccak-512 hash function. This returns a 64 byte hash.
RIPEMD 160 (Array)	`env::ripemd160_array(value)`	Hashes the bytes using the RIPEMD-160 hash function. This returns a 20 byte hash.
EC Recover	`env::ecrecover(hash, signature, v, malleability_flag)`	Recovers an ECDSA signer address from a 32-byte message `hash` and a corresponding `signature` along with `v` recovery byte. Takes in an additional flag to check for malleability of the signature which is generally only ideal for transactions. Returns 64 bytes representing the public key if the recovery was successful.
Panic String	`env::panic_str(message)`	Terminates the execution of the program with the UTF-8 encoded message.
Log String	`env::log_str(message)`	Logs the string message. This message is stored on chain.
Validator Stake	`env::validator_stake(account_id)`	For a given account return its current stake. If the account is not a validator, returns 0.
Validator Total Stake	`env::validator_total_stake()`	Returns the total stake of validators in the current epoch.

정보

In the JS SDK, throw new Error("message") mimics the behavior of Rust's env::panic_str("message").

환경

환경 변수