본문으로 건너뛰기

뼈대 및 Rust 아키텍처

이 글에서는 이 "Zero to Hero" 시리즈를 진행하면서 개발하게 될 NFT 컨트랙트의 기본 아키텍처에 대해 알아봅니다. 컨트랙트의 레이아웃을 발견하고 완전한 기능을 갖춘 스마트 컨트랙트를 구축하기 위해 Rust 파일이 어떻게 구성되어 있는지 확인할 수 있습니다.

New to Rust?

If you are new to Rust and want to dive into smart contract development, our Quick-start guide is a great place to start.

소개​

이 튜토리얼은 FT 스마트 컨트랙트의 코드 뼈대와 파일 구조를 보여줍니다. 모든 함수가 배치된 방법과 채워야 하는 누락된 Rust 코드를 찾을 수 있습니다. 모든 파일과 함수가 다루어지면 모형 컨트랙트를 작성하는 프로세스를 거쳐 모든 것이 올바르게 작동하는지 확인합니다.

파일 구조​

레퍼지토리에는 다양한 폴더가 있습니다. 각 폴더는 뼈대 폴더에서 시작하여 완성된 컨트랙트 폴더로 끝나는 이 튜토리얼의 다른 이정표를 나타냅니다. 이 폴더들 중 하나에 들어가면, 각각 일반 Rust 프로젝트를 따르고 있는 것을 확인할 수 있습니다. 이 스마트 컨트랙트의 파일 구조는 다음과 같습니다.

  • Cargo.toml: 코드 의존성(dependency)을 정의하기 위한 파일(Javascript나 node 프로젝트에서의 package.json과 유사)
  • src: 모든 Rust 소스 파일이 저장되는 폴더입니다.
  • target: 컴파일된 wasm 파일이 출력될 폴더입니다.
  • build.sh: 소스 코드를 컴파일하는 더 편리한 방법을 제공하기 위해 추가된 스크립트

소스 파일​

파일설명
ft_core.rs대체 가능한 토큰(FT)의 액세스 및 전송을 제어하는 로직이 존재합니다. 이 파일은 핵심 표준의 구현을 나타냅니다.
lib.rs공개된 스마트 컨트랙트 함수들을 가지고 있고, 어떤 정보가 온체인에 저장될지 지시합니다.
metadata.rs토큰 및 메타데이터 구조를 정의합니다. 이 파일은 표준의 메타데이터 확장 구현을 나타냅니다.
storage.rs등록 및 저장을 위한 로직을 포함합니다. 이 파일은 스토리지 관리 표준의 구현을 나타냅니다.
skeleton
├── Cargo.lock
├── Cargo.toml
├── build.sh
└── src
    ├── ft_core.rs
    ├── lib.rs
    ├── metadata.rs
    └── storage.rs
팁

GitHub 레퍼지토리에서 코드를 살펴보세요.

ft_core.rs​

사용자 간에 FT를 전송하고 중요한 정보를 쿼리할 수 있는 핵심 로직입니다.

메서드설명
ft_transfer지정된 양의 FT를 수신자 ID로 전송합니다.
ft_transfer_call지정된 양의 FT를 수신자에게 전송하고, 수신자의 컨트랙트에서 교차 컨트랙트 호출(cross-contract call)을 수행하여 ft_on_transfer 메서드를 실행하려고 시도합니다. 이 ft_on_transfer 메서드의 구현은 컨트랙트 작성자에게 달려 있습니다. 이 튜토리얼의 마켓플레이스 섹션에서 예제 구현을 볼 수 있습니다. ft_on_transfer의 실행이 끝나면, ft_resolve_transfer는 호출되어서 성공적으로 수행되었는지 확인됩니다.
ft_total_supply컨트랙트에서 유통되는 대체 가능한 토큰의 총량을 반환합니다.
ft_balance_of특정 사용자가 소유한 대체 가능한 토큰 수를 반환합니다.
ft_on_transfer수신자의 컨트랙트에 따라 진행되는 메서드입니다. ft_transfer_call 메서드를 통해 FT가 수신자의 컨트랙트 계정으로 전송될 때 호출됩니다. 이는 보낸 사람에게 다시 환불해야 하는 FT 수를 반환합니다.
ft_resolve_transferft_on_transfer 실행이 완료된 후 호출됩니다. 이 함수는 수신자 컨트랙트에서 사용하지 않은 FT를 환불하고 환불 후 수신자에게 전송된 순 FT 수를 반환합니다(있는 경우).
1.skeleton/src/ft_core.rs
loading...

You'll learn more about these functions in the circulating supply and transfers sections of the tutorial series.

lib.rs​

이 파일은 컨트랙트가 저장하고 추적하는 정보를 간략하게 설명합니다.

메서드설명
new_default_meta기본 metadata를 이용해 컨트랙트를 초기화해, 사용자가 입력값을 제공하지 않아도 되도록 합니다. 또한 소유자에게 전송되는 전체 토큰 수량을 전달됩니다.
new사용자가 제공한 metadata와 총 공급량으로 컨트랙트를 초기화합니다.
Keep in mind

The initialization functions (new, new_default_meta) can only be called once.

1.skeleton/src/lib.rs
loading...

튜토리얼 시리즈의 토큰 정의에서 이러한 기능에 대해 자세히 알아볼 것입니다.

metadata.rs​

이 파일은 토큰 및 메타데이터에 대해 저장할 정보를 추적하는 데 사용됩니다. 또한 표준 메타데이터 확장의 일부인 컨트랙트의 메타데이터를 보는 기능을 정의할 수 있습니다.

이름설명
FungibleTokenMetadata이 구조는 대체 가능한 토큰의 메타데이터를 정의합니다.
ft_metadata이 함수를 통해 사용자는 토큰의 메타데이터를 쿼리할 수 있습니다.
1.skeleton/src/metadata.rs
loading...

튜토리얼 시리즈의 토큰 정의에서 이러한 기능에 대해 자세히 알아볼 것입니다.

storage.rs​

스토리지 관리 표준에 따른 등록 로직을 포함합니다.

메서드설명
storage_deposit주어진 계정에 대해 Ⓝ의 입금을 받는 지급 메서드입니다. 이렇게 하면 컨트랙트 사용자가 등록됩니다.
storage_balance_bounds컨트랙트와 상호 작용하는 데 필요한 최소 및 최대 허용 스토리지 금액을 반환합니다. FT 컨트랙트의 경우 최소값 = 최대값입니다.
storage_balance_of지정된 사용자가 지불한 총 스토리지 및 사용 가능한 스토리지를 반환합니다. FT 컨트랙트의 경우 등록을 위해 컨트랙트에서 사용하고 스토리지에 대해 초과 지불할 수 없기 때문에, 사용 가능한 스토리지는 항상 0입니다.
1.skeleton/src/storage.rs
loading...
팁

튜토리얼 시리즈의 스토리지에서 이러한 기능에 대해 자세히 알아볼 것입니다.

뼈대 만들기​

  • 아직 기본 레퍼지토리를 복제하지 않은 경우 터미널을 열고 다음을 실행합니다.
git clone https://github.com/near-examples/ft-tutorial/
  • 다음으로 1.skeleton/build.sh 파일 내에 있는 빌드 스크립트를 사용하여 뼈대 컨트랙트를 빌드합니다.
cd ft-tutorial/1.skeleton
./build.sh
cd ..

이 소스는 뼈대일 뿐이므로 다음과 같이 사용하지 않는 코드에 대한 많은 경고를 받게 됩니다.

   = note: `#[warn(dead_code)]` on by default

warning: constant is never used: `GAS_FOR_RESOLVE_TRANSFER`
 --> src/ft_core.rs:5:1
  |
5 | const GAS_FOR_RESOLVE_TRANSFER: Gas = Gas(5_000_000_000_000);
  | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

warning: constant is never used: `GAS_FOR_FT_TRANSFER_CALL`
 --> src/ft_core.rs:6:1
  |
6 | const GAS_FOR_FT_TRANSFER_CALL: Gas = Gas(25_000_000_000_000 + GAS_FOR_RESOLVE_TRANSFER.0);
  | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

warning: `fungible-token` (lib) generated 25 warnings
    Finished release [optimized] target(s) in 1.93s
✨  Done in 2.03s.

이러한 경고에 대해 걱정하지 마세요. 아직 이 컨트랙트를 배포하지 않을 것입니다. 뼈대 구축하는 것은 Rust 툴체인이 제대로 작동하는지 확인하는 것이고, 이는 다음 튜토리얼에서 이 NFT 컨트랙트의 개선된 버전을 컴파일할 수 있는지 확인하는 데 유용합니다.

결론​

이 NFT 스마트 컨트랙트의 레이아웃과 다양한 소스 파일에 모든 함수가 어떻게 배치되어 있는지 확인했습니다. yarn을 사용하여 컨트랙트를 컴파일할 수 있었고, 튜토리얼의 다음 섹션에서 이 뼈대를 구체화하기 시작할 것입니다.

문서의 버전 관리

이 글을 쓰는 시점에서 이 예제는 다음 버전에서 작동합니다.

  • rustc: 1.6.0
  • near-sdk-rs: 4.0.0
페이지 편집
작성자: Github Actions 작성일: 마지막으로 갱신함
Was this page helpful?
Need some help? Chat with us or check our Dev Resources!
Twitter
Telegram
Discord
Zulip