TON에서 스마트 계약을 작성하고 게시하는 방법에 대해

이 기사는 무엇입니까?

이 기사에서는 Telegram 블록체인 대회 중 첫 번째 대회에 참가하여 상을 받지 못한 방법과 망각에 빠지지 않고 도움이 될 수 있도록 내 경험을 기사에 기록하기로 결정한 방법에 대해 이야기하겠습니다. 누구.

추상적인 코드를 작성하는 것이 아니라 뭔가 작동하는 작업을 하고 싶었기 때문에 이 기사에서는 즉석 복권을 위한 스마트 계약과 중간 저장소를 사용하지 않고 TON에서 직접 스마트 계약 데이터를 표시하는 웹 사이트를 작성했습니다.

이 기사는 TON에서 처음으로 스마트 계약을 만들고 싶지만 어디서부터 시작해야 할지 모르는 사람들에게 유용할 것입니다.

복권을 예로 들어 환경 설치부터 스마트 계약 게시, 상호 작용, 데이터 수신 및 게시를 위한 웹 사이트 작성까지 진행하겠습니다.

공모전 참가에 대해

지난 XNUMX월 텔레그램은 새로운 언어로 블록체인 대회를 발표했습니다. Fift и FunC. 제안된 XNUMX개의 스마트 계약 중 하나를 작성하는 것이 필요했습니다. 앞으로 다른 글을 쓰지 않아도 뭔가 다른 일을 하고, 언어를 배우고, 뭔가를 만들어 보면 좋겠다고 생각했어요. 또한 주제는 끊임없이 입술에 있습니다.

나는 스마트 계약 개발 경험이 없었다고 말할 가치가 있습니다.

할 수 있을 때까지 끝까지 참여하고 리뷰글을 쓰려고 했는데 첫 번째에 바로 실패했어요. 나 지갑을 썼다 다중 서명 사용 FunC 그리고 그것은 일반적으로 작동했습니다. 나는 그것을 기초로 삼았다. Solidity의 스마트 계약.

당시에는 이 정도면 적어도 상을 받기에 충분하다고 생각했습니다. 그 결과 참가자 40명 중 60명 정도가 수상자가 되었는데 나는 그중에 포함되지 않았다. 일반적으로 이것에는 아무런 문제가 없지만 한 가지가 나를 괴롭혔습니다. 결과발표 당시 본인의 계약에 대한 테스트 검토가 이루어지지 않았는데, 채팅참가자들에게 혹시 없는 사람이 있는지 물어보니 한 명도 없었습니다.

분명히 내 메시지에 주의를 기울인 것 같은데, 이틀 후 심사위원들이 댓글을 게시했는데, 그들이 심사 과정에서 실수로 내 스마트 계약을 놓쳤는지 아니면 단순히 너무 나빠서 댓글이 필요하지 않다고 생각했는지는 아직도 이해가 되지 않습니다. 페이지에 질문을 했는데 답변을 받지 못했습니다. 누가 심사했는지는 안 비밀이지만 개인적인 메시지를 쓰는 것은 불필요하다고 생각했습니다.

이해하는 데 많은 시간을 소비했기 때문에 기사를 작성하기로 결정했습니다. 아직 정보가 많지 않기 때문에 이 기사는 관심 있는 모든 사람의 시간을 절약하는 데 도움이 될 것입니다.

TON의 스마트 계약 개념

글을 쓰기 전에 어느 쪽에서 접근해야 할지 파악해야 합니다. 따라서 이제 시스템이 어떤 부분으로 구성되어 있는지 알려 드리겠습니다. 보다 정확하게는 최소한 일종의 근로 계약서를 작성하기 위해 알아야 할 부분이 무엇인지입니다.

우리는 스마트 계약을 작성하고 협력하는 데 중점을 둘 것입니다. TON Virtual Machine (TVM), Fift и FunC, 따라서 기사는 일반 프로그램 개발에 대한 설명과 비슷합니다. 여기서는 플랫폼 자체가 어떻게 작동하는지에 대해서는 다루지 않겠습니다.

일반적으로 작동 방식에 대해 TVM 그리고 언어 Fift 좋은 공식 문서가 있습니다. 대회에 참가하면서, 그리고 지금 계약서를 작성하면서 나는 자주 그녀에게 눈을 돌렸다.

스마트 계약이 작성되는 주요 언어는 다음과 같습니다. FunC. 현재 이에 대한 문서가 없으므로 무언가를 작성하려면 공식 저장소에서 스마트 계약의 예와 거기에 있는 언어 자체의 구현을 연구해야 하며, 지난 두 가지 스마트 계약의 예도 볼 수 있습니다. 대회. 기사 끝 부분의 링크.

우리가 이미 스마트 계약을 작성했다고 가정해 보겠습니다. FunC, 그 후 코드를 Fift 어셈블러로 컴파일합니다.

컴파일된 스마트 계약은 계속 게시될 예정입니다. 이렇게 하려면 함수를 작성해야 합니다. Fift, 스마트 계약 코드 및 기타 매개변수를 입력으로 사용하고 출력은 확장자가 있는 파일이 됩니다. .boc (“세포 주머니”를 의미함) 그리고 작성 방법에 따라 스마트 계약 코드를 기반으로 생성된 개인 키와 주소가 있습니다. 아직 공개되지 않은 스마트 계약의 주소로 이미 그램을 보낼 수 있습니다.

수신된 TON에 스마트 계약을 게시하려면 .boc 파일은 라이트 클라이언트를 사용하여 블록체인으로 전송되어야 합니다(자세한 내용은 아래 참조). 하지만 게시하기 전에 생성된 주소로 그램을 전송해야 합니다. 그렇지 않으면 스마트 계약이 게시되지 않습니다. 게시 후 외부(예: 라이트 클라이언트 사용) 또는 내부(예: 하나의 스마트 계약이 TON 내부에서 다른 스마트 계약에 메시지를 보냄)에서 메시지를 보내 스마트 계약과 상호 작용할 수 있습니다.

코드가 어떻게 게시되는지 이해하면 더 쉬워집니다. 우리는 작성하려는 내용과 프로그램이 어떻게 작동할지 대략적으로 알고 있습니다. 그리고 글을 쓰면서 기존 스마트 계약에서 이것이 이미 어떻게 구현되어 있는지 찾아보거나 구현 코드를 살펴봅니다. Fift и FunC 공식 저장소에서 또는 공식 문서를 살펴보세요.

대회 참가자들과 텔레그램 직원들이 모두 모이는 텔레그램 채팅에서 자주 키워드를 검색했는데, 대회가 진행되는 동안 모두가 그곳에 모여 Fift와 FunC에 대해 논의하기 시작했습니다. 기사 마지막에 링크를 걸어두세요.

이제 이론에서 실습으로 이동할 때입니다.

TON 작업을 위한 환경 준비

MacOS에 대한 기사에 설명될 모든 작업을 수행하고 Docker의 깨끗한 Ubuntu 18.04 LTS에서 다시 확인했습니다.

가장 먼저 해야 할 일은 다운로드 및 설치입니다. lite-client 이를 통해 TON에 요청을 보낼 수 있습니다.

공식 웹사이트의 지침에는 설치 과정이 매우 자세하고 명확하게 설명되어 있으며 일부 세부 사항은 생략되어 있습니다. 여기서는 지침에 따라 누락된 종속성을 설치합니다. 각 프로젝트를 직접 컴파일하지 않고 공식 Ubuntu 저장소에서 설치했습니다(MacOS에서는 brew).

apt -y install git 
apt -y install wget 
apt -y install cmake 
apt -y install g++ 
apt -y install zlib1g-dev 
apt -y install libssl-dev 

모든 종속성이 설치되면 설치할 수 있습니다 lite-client, Fift, FunC.

먼저, 종속성과 함께 TON 저장소를 복제합니다. 편의상 모든 작업을 폴더에서 수행하겠습니다. ~/TON.

cd ~/TON
git clone https://github.com/ton-blockchain/ton.git
cd ./ton
git submodule update --init --recursive

저장소는 구현도 저장합니다. Fift и FunC.

이제 프로젝트를 어셈블할 준비가 되었습니다. 저장소 코드가 폴더에 복제됩니다. ~/TON/ton. 에 ~/TON 폴더를 생성 build 그 안에 프로젝트를 수집합니다.

mkdir ~/TON/build 
cd ~/TON/build
cmake ../ton

우리는 스마트 계약을 작성할 것이므로 다음 사항뿐만 아니라 lite-client하지만 Fift с FunC, 이제 모든 것을 컴파일해 보겠습니다. 빠른 처리가 아니어서 기다리고 있습니다.

cmake --build . --target lite-client
cmake --build . --target fift
cmake --build . --target func

다음으로, 노드에 대한 데이터가 포함된 구성 파일을 다운로드합니다. lite-client 연결됩니다.

wget https://test.ton.org/ton-lite-client-test1.config.json

TON에 첫 번째 요청하기

이제 발사해보자 lite-client.

cd ~/TON/build
./lite-client/lite-client -C ton-lite-client-test1.config.json

빌드가 성공하면 시작 후 라이트 클라이언트와 노드의 연결 로그가 표시됩니다.

[ 1][t 2][1582054822.963129282][lite-client.h:201][!testnode]   conn ready
[ 2][t 2][1582054823.085654020][lite-client.cpp:277][!testnode] server version is 1.1, capabilities 7
[ 3][t 2][1582054823.085725069][lite-client.cpp:286][!testnode] server time is 1582054823 (delta 0)
...

명령을 실행할 수 있습니다 help 어떤 명령을 사용할 수 있는지 확인하세요.

help

이 기사에서 사용할 명령을 나열해 보겠습니다.

list of available commands:
last    Get last block and state info from server
sendfile <filename> Load a serialized message from <filename> and send it to server
getaccount <addr> [<block-id-ext>]  Loads the most recent state of specified account; <addr> is in [<workchain>:]<hex-or-base64-addr> format
runmethod <addr> [<block-id-ext>] <method-id> <params>...   Runs GET method <method-id> of account <addr> with specified parameters

last получает последний созданный блок с сервера. 

sendfile <filename> отправляет в TON файл с сообщением, именно с помощью этой команды публикуется смарт-контракт и запрсосы к нему. 

getaccount <addr> загружает текущее состояние смарт-контракта с указанным адресом. 

runmethod <addr> [<block-id-ext>] <method-id> <params>  запускает get-методы смартконтракта. 

이제 계약 자체를 작성할 준비가 되었습니다.

Реализация

생각

위에서도 썼듯이 우리가 작성하고 있는 스마트 컨트랙트는 복권이다.

게다가 티켓을 구매하고 한 시간, 하루, 한 달을 기다려야 하는 복권이 아니라 사용자가 계약 주소로 전송하는 즉석 복권입니다. N 그램을 저장하고 즉시 돌려받습니다. 2 * N 그램 또는 손실. 당첨 확률을 약 40%로 만들어 보겠습니다. 지불할 그램이 충분하지 않은 경우 거래를 충전으로 간주합니다.

또한, 베팅 내용을 실시간으로 편리한 형태로 볼 수 있어 사용자가 승패를 즉시 알 수 있도록 하는 것이 중요합니다. 따라서 TON에서 직접 베팅과 결과를 보여주는 웹사이트를 만들어야 합니다.

스마트 계약 작성

편의를 위해 FunC용 코드를 강조 표시해 두었습니다. 해당 플러그인은 Visual Studio Code 검색에서 찾아 설치할 수 있으며, 갑자기 추가하고 싶은 내용이 있으면 플러그인을 공개적으로 사용할 수 있도록 했습니다. 또한 누군가가 이전에 Fift 작업용 플러그인을 만들었으므로 이를 설치하고 VSC에서 찾을 수도 있습니다.

중간 결과를 커밋할 저장소를 즉시 생성해 보겠습니다.

우리의 삶을 더 쉽게 만들기 위해 스마트 계약을 작성하고 준비될 때까지 로컬에서 테스트할 것입니다. 그 후에야 TON에 게시할 것입니다.

스마트 계약에는 액세스할 수 있는 두 가지 외부 방법이 있습니다. 첫 번째, recv_external() 이 기능은 계약에 대한 요청이 TON이 아닌 외부 세계에서 올 때 실행됩니다. 예를 들어 우리가 직접 메시지를 생성하여 라이트 클라이언트를 통해 보낼 때입니다. 두번째, recv_internal() 이는 TON 자체 내에서 모든 계약이 당사 계약을 참조하는 경우입니다. 두 경우 모두 매개변수를 함수에 전달할 수 있습니다.

게시되면 작동하지만 기능적 부하가 없는 간단한 예부터 시작해 보겠습니다.

() recv_internal(slice in_msg) impure {
    ;; TODO: implementation 
}

() recv_external(slice in_msg) impure {
    ;; TODO: implementation  
}

여기서는 그것이 무엇인지 설명해야 합니다. slice. TON 블록체인에 저장된 모든 데이터는 모음입니다. TVM cell 또는 단순히 cell, 이러한 셀에는 최대 1023비트의 데이터와 다른 셀에 대한 최대 4개의 링크를 저장할 수 있습니다.

TVM cell slice 또는 slice 이것은 기존 것의 일부입니다 cell 분석하는 데 사용되며 나중에 명확해질 것입니다. 우리에게 가장 중요한 것은 전송할 수 있다는 것입니다. slice 메시지 유형에 따라 데이터를 처리합니다. recv_external() 또는 recv_internal().

impure — 함수가 스마트 계약 데이터를 수정함을 나타내는 키워드입니다.

계약 코드를 저장하자 lottery-code.fc 그리고 컴파일하세요.

~/TON/build/crypto/func -APSR -o lottery-compiled.fif ~/TON/ton/crypto/smartcont/stdlib.fc ./lottery-code.fc 

플래그의 의미는 다음 명령을 사용하여 볼 수 있습니다.

~/TON/build/crypto/func -help

우리는 Fift 어셈블러 코드를 다음과 같이 컴파일했습니다. lottery-compiled.fif:

// lottery-compiled.fif

"Asm.fif" include
// automatically generated from `/Users/rajymbekkapisev/TON/ton/crypto/smartcont/stdlib.fc` `./lottery-code.fc` 
PROGRAM{
  DECLPROC recv_internal
  DECLPROC recv_external
  recv_internal PROC:<{
    //  in_msg
    DROP    // 
  }>
  recv_external PROC:<{
    //  in_msg
    DROP    // 
  }>
}END>c

로컬로 실행될 수 있으므로 이를 위해 환경을 준비하겠습니다.

첫 번째 줄이 연결된다는 점에 유의하세요. Asm.fif, 이것은 Fift 어셈블러용으로 Fift로 작성된 코드입니다.

스마트 계약을 로컬에서 실행하고 테스트하고 싶기 때문에 파일을 생성하겠습니다. lottery-test-suite.fif 거기에 컴파일된 코드를 복사하여 스마트 계약 코드를 상수에 작성하는 마지막 줄을 바꿉니다. code그런 다음 가상 머신으로 전송합니다.

"TonUtil.fif" include
"Asm.fif" include

PROGRAM{
  DECLPROC recv_internal
  DECLPROC recv_external
  recv_internal PROC:<{
    //  in_msg
    DROP    // 
  }>
  recv_external PROC:<{
    //  in_msg
    DROP    // 
  }>
}END>s constant code

지금까지는 분명해 보였습니다. 이제 TVM을 시작하는 데 사용할 코드를 동일한 파일에 추가해 보겠습니다.

0 tuple 0x076ef1ea , // magic
0 , 0 , // actions msg_sents
1570998536 , // unix_time
1 , 1 , 3 , // block_lt, trans_lt, rand_seed
0 tuple 100000000000000 , dictnew , , // remaining balance
0 , dictnew , // contract_address, global_config
1 tuple // wrap to another tuple
constant c7

0 constant recv_internal // to run recv_internal() 
-1 constant recv_external // to invoke recv_external()

В c7 우리는 컨텍스트, 즉 TVM(또는 네트워크 상태)이 시작될 데이터를 기록합니다. 대회 중에도 개발자 중 한 명이 만드는 방법을 보여주었습니다. c7 그리고 나는 복사했다. 이 기사에서는 변경해야 할 수도 있습니다. rand_seed 난수의 생성은 이에 따라 달라지며 변경하지 않으면 매번 동일한 숫자가 반환됩니다.

recv_internal и recv_external 값이 0과 -1인 상수는 스마트 계약에서 해당 기능을 호출하는 역할을 합니다.

이제 빈 스마트 계약에 대한 첫 번째 테스트를 만들 준비가 되었습니다. 명확성을 위해 지금은 모든 테스트를 동일한 파일에 추가하겠습니다. lottery-test-suite.fif.

변수를 만들어보자 storage 그리고 거기에 빈 것을 쓰세요 cell, 이것이 스마트 계약 저장소가 됩니다.

message 외부에서 스마트 컨트랙트에게 전송할 메시지입니다. 우리는 또한 지금은 그것을 비워 둘 것입니다.

variable storage 
<b b> storage ! 

variable message 
<b b> message ! 

상수와 변수를 준비한 후 다음 명령을 사용하여 TVM을 시작합니다. runvmctx 생성된 매개변수를 입력에 전달합니다.

message @ 
recv_external 
code 
storage @ 
c7 
runvmctx 

결국 우리는 성공할 것이다 그렇게 중간 코드 Fift.

이제 결과 코드를 실행할 수 있습니다.

export FIFTPATH=~/TON/ton/crypto/fift/lib // выполняем один раз для удобства 
~/TON/build/crypto/fift -s lottery-test-suite.fif 

프로그램은 오류 없이 실행되어야 하며 출력에 실행 로그가 표시됩니다.

execute SETCP 0
execute DICTPUSHCONST 19 (xC_,1)
execute DICTIGETJMPZ
execute DROP
execute implicit RET
[ 3][t 0][1582281699.325381279][vm.cpp:479]     steps: 5 gas: used=304, max=9223372036854775807, limit=9223372036854775807, credit=0

훌륭합니다. 우리는 스마트 계약의 첫 번째 작업 버전을 작성했습니다.

이제 기능을 추가해야 합니다. 먼저 외부 세계에서 들어오는 메시지를 다루겠습니다. recv_external()

개발자는 계약에서 허용할 수 있는 메시지 형식을 직접 선택합니다.

하지만 보통

• 첫째, 우리는 계약을 외부 세계로부터 보호하고 계약 소유자만이 외부 메시지를 보낼 수 있도록 만들고 싶습니다.
• 둘째, TON에 유효한 메시지를 보낼 때 이것이 정확히 한 번만 발생하기를 원하며 동일한 메시지를 다시 보내면 스마트 계약이 이를 거부합니다.

따라서 거의 모든 계약은 이 두 가지 문제를 해결합니다. 계약이 외부 메시지를 허용하므로 이 문제도 처리해야 합니다.

우리는 그것을 역순으로 할 것입니다. 먼저, 반복 문제를 해결해 보겠습니다. 계약이 이미 그러한 메시지를 수신하여 처리한 경우에는 다시 실행하지 않습니다. 그런 다음 특정 집단의 사람들만이 스마트 계약에 메시지를 보낼 수 있도록 문제를 해결할 것입니다.

메시지 중복 문제를 해결하는 방법에는 여러 가지가 있습니다. 방법은 다음과 같습니다. 스마트 계약에서는 수신된 메시지의 카운터를 초기 값 0으로 초기화합니다. 스마트 계약의 각 메시지에는 현재 카운터 값을 추가합니다. 메시지의 카운터 값이 스마트 계약의 값과 일치하지 않으면 이를 처리하지 않고, 일치하는 경우 이를 처리하고 스마트 계약의 카운터를 1만큼 늘립니다.

돌아가자 lottery-test-suite.fif 두 번째 테스트를 추가합니다. 잘못된 번호를 보내면 코드에서 예외가 발생해야 합니다. 예를 들어, 계약 데이터가 166을 저장하고 우리는 165를 보낼 것입니다.

<b 166 32 u, b> storage !
<b 165 32 u, b> message !

message @ 
recv_external 
code 
storage @ 
c7 
runvmctx

drop 
exit_code ! 
."Exit code " exit_code @ . cr 
exit_code @ 33 - abort"Test #2 Not passed"

발사하자.

 ~/TON/build/crypto/fift -s lottery-test-suite.fif 

그리고 테스트가 오류와 함께 실행되는 것을 볼 수 있습니다.

[ 1][t 0][1582283084.210902214][words.cpp:3046] lottery-test-suite.fif:67: abort": Test #2 Not passed
[ 1][t 0][1582283084.210941076][fift-main.cpp:196]      Error interpreting file `lottery-test-suite.fif`: error interpreting included file `lottery-test-suite.fif` : lottery-test-suite.fif:67: abort": Test #2 Not passed

이 단계에서 lottery-test-suite.fif 다음과 같아야합니다 링크.

이제 스마트 계약에 카운터 로직을 추가해 보겠습니다. lottery-code.fc.

() recv_internal(slice in_msg) impure {
    ;; TODO: implementation 
}

() recv_external(slice in_msg) impure {
    if (slice_empty?(in_msg)) {
        return (); 
    }
    int msg_seqno = in_msg~load_uint(32);
    var ds = begin_parse(get_data());
    int stored_seqno = ds~load_uint(32);
    throw_unless(33, msg_seqno == stored_seqno);
}

В slice in_msg 우리가 보내는 메시지가 거짓말입니다.

가장 먼저 할 일은 메시지에 데이터가 포함되어 있는지 확인하고, 그렇지 않은 경우 간단히 종료합니다.

다음으로 메시지를 구문 분석합니다. in_msg~load_uint(32) 숫자 165, 32비트를 로드합니다. unsigned int 전송된 메시지에서

다음으로 스마트 계약 저장소에서 32비트를 로드합니다. 로드된 번호가 전달된 번호와 일치하는지 확인하고, 일치하지 않으면 예외를 발생시킵니다. 우리의 경우에는 일치하지 않는 항목을 전달하므로 예외가 발생해야 합니다.

이제 컴파일해 봅시다.

~/TON/build/crypto/func -APSR -o lottery-compiled.fif ~/TON/ton/crypto/smartcont/stdlib.fc ./lottery-code.fc 

결과 코드를 다음 위치에 복사하세요. lottery-test-suite.fif, 마지막 줄을 바꾸는 것을 잊지 마십시오.

테스트가 통과되었는지 확인합니다.

~/TON/build/crypto/fift -s lottery-test-suite.fif

바로 여기 현재 결과와 함께 해당 커밋을 볼 수 있습니다.

스마트 컨트랙트의 컴파일된 코드를 테스트를 통해 지속적으로 파일에 복사하는 것은 불편하므로 코드를 상수에 작성하는 스크립트를 작성하고 다음을 사용하여 컴파일된 코드를 테스트에 연결하기만 하면 됩니다. "include".

프로젝트 폴더에 파일 생성 build.sh 다음 내용으로.

#!/bin/bash

~/TON/build/crypto/func -SPA -R -o lottery-compiled.fif ~/TON/ton/crypto/smartcont/stdlib.fc ./lottery-code.fc

실행 가능하게 만들어 보겠습니다.

chmod +x ./build.sh

이제 스크립트를 실행하여 계약을 컴파일하세요. 하지만 이 외에도 상수로 작성해야 합니다. code. 그래서 우리는 새로운 파일을 만들 것입니다 lotter-compiled-for-test.fif, 파일에 포함할 것입니다. lottery-test-suite.fif.

sh에 스커트 코드를 추가해 보겠습니다. 그러면 컴파일된 파일이 다음과 같이 복제됩니다. lotter-compiled-for-test.fif 마지막 줄을 변경하십시오.

# copy and change for test 
cp lottery-compiled.fif lottery-compiled-for-test.fif
sed '$d' lottery-compiled-for-test.fif > test.fif
rm lottery-compiled-for-test.fif
mv test.fif lottery-compiled-for-test.fif
echo -n "}END>s constant code" >> lottery-compiled-for-test.fif

이제 확인을 위해 결과 스크립트를 실행해 보겠습니다. 그러면 파일이 생성됩니다. lottery-compiled-for-test.fif, 우리는 이를 우리의 lottery-test-suite.fif

В lottery-test-suite.fif 계약 코드를 삭제하고 라인을 추가하세요 "lottery-compiled-for-test.fif" include.

우리는 테스트를 실행하여 통과하는지 확인합니다.

~/TON/build/crypto/fift -s lottery-test-suite.fif

좋습니다. 이제 테스트 시작을 자동화하기 위해 파일을 만들어 보겠습니다. test.sh, 먼저 실행됩니다 build.sh를 누른 다음 테스트를 실행합니다.

touch test.sh
chmod +x test.sh

우리는 안에 쓴다

./build.sh 

echo "nCompilation completedn"

export FIFTPATH=~/TON/ton/crypto/fift/lib
~/TON/build/crypto/fift -s lottery-test-suite.fif

그것을 해보자. test.sh 테스트가 제대로 작동하는지 확인하기 위해 실행해 보세요.

chmod +x ./test.sh
./test.sh

계약이 컴파일되고 테스트가 실행되는지 확인합니다.

좋습니다. 이제 시작 중입니다. test.sh 테스트는 즉시 컴파일되어 실행됩니다. 다음은 링크입니다. 저지르다.

좋습니다. 계속하기 전에 편의를 위해 한 가지 작업을 더 해보겠습니다.

폴더를 만들어보자 build 복사된 계약과 해당 복제본을 상수에 기록하여 저장합니다. lottery-compiled.fif, lottery-compiled-for-test.fif. 폴더도 만들어보자 test 테스트 파일은 어디에 저장되나요? lottery-test-suite.fif 그리고 잠재적으로 다른 지원 파일도 있습니다. 관련 변경사항 링크.

계속해서 스마트 계약을 개발해 보겠습니다.

다음으로 메시지가 수신되었는지 확인하고 올바른 번호를 보낼 때 스토어에서 카운터가 업데이트되는지 확인하는 테스트가 있어야 합니다. 하지만 그건 나중에 하도록 하겠습니다.

이제 스마트 계약에 어떤 데이터 구조와 어떤 데이터를 저장해야 하는지 생각해 보겠습니다.

우리가 저장하는 모든 것을 설명하겠습니다.

`seqno` 32-х битное целое положительное число счетчик. 

`pubkey` 256-ти битное целое положительное число публичный ключ, с помощью которого, мы будем проверять подпись отправленного извне сообщения, о чем ниже. 

`order_seqno` 32-х битное целое положительное число хранит счетчик количества ставок. 

`number_of_wins` 32-х битное целое положительное число хранит  количество побед. 

`incoming_amount` тип данных Gram (первые 4 бита отвечает за длину), хранит общее количество грамов, которые были отправлены на контртакт. 

`outgoing_amount` общее количество грамов, которое было отправлено победителям. 

`owner_wc` номер воркчейна, 32-х битное (в некоторых местах написано, что 8-ми битное) целое число. В данный момент всего два -1 и 0. 

`owner_account_id` 256-ти битное целое положительное число, адрес контракта в текущем воркчейне. 

`orders` переменная типа словарь, хранит последние двадцать ставок. 

다음으로 두 가지 함수를 작성해야 합니다. 먼저 전화하자 pack_state(), 이후 스마트 계약 저장소에 저장하기 위해 데이터를 압축합니다. 둘째한테 전화하자 unpack_state() 저장소에서 데이터를 읽고 반환합니다.

_ pack_state(int seqno, int pubkey, int order_seqno, int number_of_wins, int incoming_amount, int outgoing_amount, int owner_wc, int owner_account_id, cell orders) inline_ref {
    return begin_cell()
            .store_uint(seqno, 32)
            .store_uint(pubkey, 256)
            .store_uint(order_seqno, 32)
            .store_uint(number_of_wins, 32)
            .store_grams(incoming_amount)
            .store_grams(outgoing_amount)
            .store_int(owner_wc, 32)
            .store_uint(owner_account_id, 256)
            .store_dict(orders)
            .end_cell();
}

_ unpack_state() inline_ref {
    var ds = begin_parse(get_data());
    var unpacked = (ds~load_uint(32), ds~load_uint(256), ds~load_uint(32), ds~load_uint(32), ds~load_grams(), ds~load_grams(), ds~load_int(32), ds~load_uint(256), ds~load_dict());
    ds.end_parse();
    return unpacked;
}

우리는 스마트 계약의 시작 부분에 이 두 가지 기능을 추가합니다. 그것은 잘 될 것이다 그렇게 중간 결과.

데이터를 저장하려면 내장 함수를 호출해야 합니다. set_data() 그리고 다음에서 데이터를 쓸 것입니다. pack_state() 스마트 계약 저장소에 있습니다.

cell packed_state = pack_state(arg_1, .., arg_n); 
set_data(packed_state);

이제 데이터 쓰기 및 읽기를 위한 편리한 기능이 있으므로 계속 진행할 수 있습니다.

외부에서 들어오는 메시지가 계약 소유자(또는 개인 키에 접근할 수 있는 다른 사용자)의 서명이 있는지 확인해야 합니다.

스마트 계약을 게시하면 스토리지에 필요한 데이터로 이를 초기화할 수 있으며, 이는 향후 사용을 위해 저장됩니다. 수신 메시지가 해당 개인 키로 서명되었는지 확인할 수 있도록 공개 키를 여기에 기록합니다.

계속하기 전에 개인 키를 만들어서 작성해 보겠습니다. test/keys/owner.pk. 이를 위해 Fift를 대화형 모드로 실행하고 XNUMX개의 명령을 실행해 보겠습니다.

`newkeypair` генерация публичного и приватного ключа и запись их в стек. 

`drop` удаления из стека верхнего элемента (в данном случае публичный ключ)  

`.s` просто посмотреть что лежит в стеке в данный момент 

`"owner.pk" B>file` запись приватного ключа в файл с именем `owner.pk`. 

`bye` завершает работу с Fift. 

폴더를 만들어보자 keys 폴더 안에 test 거기에 개인 키를 쓰세요.

mkdir test/keys
cd test/keys
~/TON/build/crypto/fift -i 
newkeypair
 ok
.s 
BYTES:128DB222CEB6CF5722021C3F21D4DF391CE6D5F70C874097E28D06FCE9FD6917 BYTES:DD0A81AAF5C07AAAA0C7772BB274E494E93BB0123AA1B29ECE7D42AE45184128 
drop 
 ok
"owner.pk" B>file
 ok
bye

현재 폴더에 파일이 있습니다 owner.pk.

스택에서 공개 키를 제거하고 필요한 경우 개인 키에서 가져올 수 있습니다.

이제 서명 확인서를 작성해야 합니다. 테스트부터 시작해 보겠습니다. 먼저 함수를 사용하여 파일에서 개인 키를 읽습니다. file>B 그리고 그것을 변수에 씁니다. owner_private_key, 그런 다음 기능을 사용하여 priv>pub 개인 키를 공개 키로 변환하고 결과를 기록합니다. owner_public_key.

variable owner_private_key
variable owner_public_key 

"./keys/owner.pk" file>B owner_private_key !
owner_private_key @ priv>pub owner_public_key !

두 키가 모두 필요합니다.

함수에서와 동일한 순서로 임의의 데이터로 스마트 계약 저장소를 초기화합니다. pack_state()그리고 그것을 변수에 씁니다. storage.

variable owner_private_key
variable owner_public_key 
variable orders
variable owner_wc
variable owner_account_id

"./keys/owner.pk" file>B owner_private_key !
owner_private_key @ priv>pub owner_public_key !
dictnew orders !
0 owner_wc !
0 owner_account_id !

<b 0 32 u, owner_public_key @ B, 0 32 u, 0 32 u, 0 Gram, 0 Gram, owner_wc @ 32 i, owner_account_id @ 256 u,  orders @ dict, b> storage !

다음으로 서명된 메시지를 작성하겠습니다. 여기에는 서명과 카운터 값만 포함됩니다.

먼저 전송하려는 데이터를 생성한 다음 개인 키로 서명하고 마지막으로 서명된 메시지를 생성합니다.

variable message_to_sign
variable message_to_send
variable signature
<b 0 32 u, b> message_to_sign !
message_to_sign @ hashu owner_private_key @ ed25519_sign_uint signature !
<b signature @ B, 0 32 u, b> <s  message_to_send !  

결과적으로 우리가 스마트 계약으로 보낼 메시지는 변수에 기록됩니다. message_to_send, 기능에 대해 hashu, ed25519_sign_uint 당신은 읽을 수있다 Fift 문서에서.

그리고 테스트를 실행하기 위해 다시 호출합니다.

message_to_send @ 
recv_external 
code 
storage @
c7
runvmctx

여기 그렇게 테스트가 포함된 파일은 이 단계에서 다음과 같아야 합니다.

테스트를 실행하면 실패하므로 이 형식의 메시지를 수신하고 서명을 확인할 수 있도록 스마트 계약을 변경하겠습니다.

먼저 메시지에서 서명의 512비트를 계산하여 변수에 쓴 다음 카운터 변수의 32비트를 계산합니다.

스마트 컨트랙트 스토리지에서 데이터를 읽어오는 기능이 있으므로 이를 활용하겠습니다.

다음은 저장소와 함께 전송된 카운터를 확인하고 서명을 확인하는 것입니다. 일치하지 않는 항목이 있으면 적절한 코드와 함께 예외가 발생합니다.

var signature = in_msg~load_bits(512);
var message = in_msg;
int msg_seqno = message~load_uint(32);
(int stored_seqno, int pubkey, int order_seqno, int number_of_wins, int incoming_amount, int outgoing_amount, int owner_wc, int owner_account_id, cell orders) = unpack_state();
throw_unless(33, msg_seqno == stored_seqno);
throw_unless(34, check_signature(slice_hash(in_msg), signature, pubkey));

관련 커밋 여기에.

테스트를 실행하고 두 번째 테스트가 실패하는지 확인해 보겠습니다. 두 가지 이유 때문에 메시지에 비트가 충분하지 않고 저장소에 비트가 충분하지 않아 구문 분석 시 코드가 충돌합니다. 보내는 메시지에 서명을 추가하고 마지막 테스트의 저장소를 복사해야 합니다.

두 번째 테스트에서는 메시지 서명을 추가하고 스마트 계약 저장소를 변경해 보겠습니다. 여기 그렇게 테스트가 포함된 파일은 현재와 같습니다.

다른 사람의 개인 키로 서명된 메시지를 보내는 네 번째 테스트를 작성해 보겠습니다. 또 다른 개인 키를 만들어 파일에 저장해 보겠습니다. not-owner.pk. 이 개인 키로 메시지에 서명하겠습니다. 테스트를 실행하고 모든 테스트가 통과하는지 확인하겠습니다. 저지르다 지금이 순간.

이제 마침내 스마트 계약 논리 구현으로 넘어갈 수 있습니다.
В recv_external() 우리는 두 가지 유형의 메시지를 받아들입니다.

우리의 계약은 플레이어의 손실을 누적시키므로 이 돈은 복권 제작자에게 전달되어야 합니다. 복권 작성자의 지갑 주소는 계약이 생성될 때 저장소에 기록됩니다.

만약을 대비해 패자 그램을 보낼 주소를 변경할 수 있는 기능이 필요합니다. 또한 복권에서 소유자의 주소로 그램을 보낼 수 있어야 합니다.

첫 번째부터 시작해 보겠습니다. 먼저 메시지를 보낸 후 스마트 계약이 새 주소를 저장소에 저장했는지 확인하는 테스트를 작성해 보겠습니다. 메시지에는 카운터와 새 주소 외에 추가 정보도 전송됩니다. action 음수가 아닌 7비트 정수에 따라 스마트 계약에서 메시지를 처리하는 방법을 선택합니다.

<b 0 32 u, 1 @ 7 u, new_owner_wc @  32 i, new_owner_account_id @ 256 u, b> message_to_sign !

테스트에서 스마트 계약 저장소가 역직렬화되는 방식을 확인할 수 있습니다. storage XNUMX화에서. 변수의 역직렬화는 Fift 문서에 설명되어 있습니다.

커밋 링크 반죽을 추가한 것.

테스트를 실행하여 실패하는지 확인해 보겠습니다. 이제 복권 소유자의 주소를 변경하는 논리를 추가해 보겠습니다.

스마트 계약에서 우리는 계속해서 분석합니다. message, 읽어보세요 action. 우리는 두 가지를 갖게 될 것임을 상기시켜 드리겠습니다. action: 주소를 변경하고 그램을 보냅니다.

그런 다음 계약 소유자의 새 주소를 읽고 이를 저장소에 저장합니다.
테스트를 실행하고 세 번째 테스트가 실패하는지 확인합니다. 이제 계약이 테스트에서 누락된 메시지의 7비트를 추가로 구문 분석한다는 사실로 인해 충돌이 발생합니다. 존재하지 않는 메시지를 메시지에 추가하세요. action. 테스트를 실행하고 모든 것이 통과되는지 확인해 보겠습니다. 여기에 변화를 약속합니다. 엄청난.

이제 이전에 저장된 주소로 지정된 그램 수를 보내는 논리를 작성해 보겠습니다.

먼저 테스트를 작성해보자. 우리는 두 가지 테스트를 작성할 것입니다. 하나는 잔고가 충분하지 않을 때이고, 두 번째는 모든 것이 성공적으로 통과되어야 할 때입니다. 테스트를 볼 수 있습니다 이 커밋에서.

이제 코드를 추가해 보겠습니다. 먼저 두 가지 도우미 메서드를 작성해 보겠습니다. 첫 번째 get 방법은 스마트 계약의 현재 잔액을 확인하는 것입니다.

int balance() inline_ref method_id {
    return get_balance().pair_first();
}

두 번째는 그램을 다른 스마트 계약으로 보내는 것입니다. 나는 이 방법을 다른 스마트 계약에서 완전히 복사했습니다.

() send_grams(int wc, int addr, int grams) impure {
    ;; int_msg_info$0 ihr_disabled:Bool bounce:Bool bounced:Bool src:MsgAddress -> 011000
    cell msg = begin_cell()
    ;;  .store_uint(0, 1) ;; 0 <= format indicator int_msg_info$0 
    ;;  .store_uint(1, 1) ;; 1 <= ihr disabled
    ;;  .store_uint(1, 1) ;; 1 <= bounce = true
    ;;  .store_uint(0, 1) ;; 0 <= bounced = false
    ;;  .store_uint(4, 5)  ;; 00100 <= address flags, anycast = false, 8-bit workchain
        .store_uint (196, 9)
        .store_int(wc, 8)
        .store_uint(addr, 256)
        .store_grams(grams)
        .store_uint(0, 107) ;; 106 zeroes +  0 as an indicator that there is no cell with the data.
        .end_cell(); 
    send_raw_message(msg, 3); ;; mode, 2 for ignoring errors, 1 for sender pays fees, 64 for returning inbound message value
}

이 두 가지 메서드를 스마트 계약에 추가하고 로직을 작성해 보겠습니다. 먼저 메시지에서 그램 수를 구문 분석합니다. 다음으로 잔액을 확인하고, 충분하지 않으면 예외를 발생시킵니다. 모든 것이 정상이면 저장된 주소로 그램을 보내고 카운터를 업데이트합니다.

int amount_to_send = message~load_grams();
throw_if(36, amount_to_send + 500000000 > balance());
accept_message();
send_grams(owner_wc, owner_account_id, amount_to_send);
set_data(pack_state(stored_seqno + 1, pubkey, order_seqno, number_of_wins, incoming_amount, outgoing_amount, owner_wc, owner_account_id, orders));

여기 그렇게 현재 스마트 계약처럼 보입니다. 테스트를 실행하고 통과하는지 확인해 보겠습니다.

그런데 처리된 메시지에 대해 매번 스마트 계약에서 수수료가 차감됩니다. 스마트 계약 메시지가 요청을 실행하려면 기본 점검 후 다음을 호출해야 합니다. accept_message().

이제 내부 메시지로 넘어가겠습니다. 실제로 우리는 그램만 받고 플레이어가 이기면 두 배의 금액을 플레이어에게 돌려주고, 패하면 소유자에게 세 번째 금액을 돌려드립니다.

먼저 간단한 테스트를 작성해 보겠습니다. 이를 위해서는 스마트 계약으로 그램을 보내는 스마트 계약의 테스트 주소가 필요합니다.

스마트 계약 주소는 워크체인을 담당하는 32비트 정수와 이 워크체인의 256비트 음수가 아닌 정수 고유 계정 번호라는 두 개의 숫자로 구성됩니다. 예를 들어 -1 및 12345는 파일에 저장할 주소입니다.

주소 저장 기능을 복사했습니다. TonUtil.fif.

// ( wc addr fname -- )  Save address to file in 36-byte format
{ -rot 256 u>B swap 32 i>B B+ swap B>file } : save-address

함수가 어떻게 작동하는지 살펴보겠습니다. 이를 통해 Fift의 작동 방식을 이해할 수 있습니다. 대화형 모드에서 Fift를 실행하세요.

~/TON/build/crypto/fift -i 

먼저 -1, 12345 및 향후 파일 "sender.addr"의 이름을 스택에 푸시합니다.

-1 12345 "sender.addr" 

다음 단계는 함수를 실행하는 것입니다. -rot, 스택 상단에 고유한 스마트 계약 번호가 있는 방식으로 스택을 이동합니다.

"sender.addr" -1 12345

256 u>B 256비트 음수가 아닌 정수를 바이트로 변환합니다.

"sender.addr" -1 BYTES:0000000000000000000000000000000000000000000000000000000000003039

swap 스택의 상위 두 요소를 교환합니다.

"sender.addr" BYTES:0000000000000000000000000000000000000000000000000000000000003039 -1

32 i>B 32비트 정수를 바이트로 변환합니다.

"sender.addr" BYTES:0000000000000000000000000000000000000000000000000000000000003039 BYTES:FFFFFFFF

B+ 두 개의 바이트 시퀀스를 연결합니다.

 "sender.addr" BYTES:0000000000000000000000000000000000000000000000000000000000003039FFFFFFFF

다시 swap.

BYTES:0000000000000000000000000000000000000000000000000000000000003039FFFFFFFF "sender.addr" 

그리고 마지막으로 바이트가 파일에 기록됩니다. B>file. 그 후에는 스택이 비어 있습니다. 우리는 멈춰요 Fift. 현재 폴더에 파일이 생성되었습니다. sender.addr. 생성된 폴더로 파일을 옮겨보자 test/addresses/.

스마트 계약으로 그램을 보내는 간단한 테스트를 작성해 보겠습니다. 커밋은 다음과 같습니다.

이제 복권의 논리를 살펴 보겠습니다.

가장 먼저 할 일은 메시지를 확인하는 것입니다. bounced 아니면 그렇지 않다면 bounced, 그러면 무시합니다. bounced 이는 오류가 발생하면 계약이 그램을 반환한다는 의미입니다. 갑자기 오류가 발생하면 그램을 반환하지 않습니다.

잔액이 XNUMX그램 미만인지 확인하고 메시지를 수락하고 무시합니다.

다음으로 메시지가 나온 스마트 계약의 주소를 구문 분석합니다.

우리는 저장소에서 데이터를 읽은 다음 XNUMX개 이상이면 기록에서 오래된 베팅을 삭제합니다. 편의상 세 가지 추가 기능을 작성했습니다. pack_order(), unpack_order(), remove_old_orders().

다음으로 잔액이 지불하기에 충분하지 않은지 확인한 다음 이것이 베팅이 아니라 보충이라고 간주하고 보충을 저장합니다. orders.

마지막으로 스마트 계약의 본질입니다.

먼저 플레이어가 패하면 배팅 내역에 저장하고 금액이 3그램 이상이면 스마트 계약 소유자에게 1/3을 보냅니다.

플레이어가 이기면 플레이어의 주소로 두 배의 금액을 보낸 다음 베팅에 대한 정보를 기록에 저장합니다.

() recv_internal(int order_amount, cell in_msg_cell, slice in_msg) impure {
    var cs = in_msg_cell.begin_parse();
    int flags = cs~load_uint(4);  ;; int_msg_info$0 ihr_disabled:Bool bounce:Bool bounced:Bool
    if (flags & 1) { ;; ignore bounced
        return ();
    }
    if (order_amount < 500000000) { ;; just receive grams without changing state 
        return ();
    }
    slice src_addr_slice = cs~load_msg_addr();
    (int src_wc, int src_addr) = parse_std_addr(src_addr_slice);
    (int stored_seqno, int pubkey, int order_seqno, int number_of_wins, int incoming_amount, int outgoing_amount, int owner_wc, int owner_account_id, cell orders) = unpack_state();
    orders = remove_old_orders(orders, order_seqno);
    if (balance() < 2 * order_amount + 500000000) { ;; not enough grams to pay the bet back, so this is re-fill
        builder order = pack_order(order_seqno, 1, now(), order_amount, src_wc, src_addr);
        orders~udict_set_builder(32, order_seqno, order);
        set_data(pack_state(stored_seqno, pubkey, order_seqno + 1, number_of_wins, incoming_amount + order_amount, outgoing_amount, owner_wc, owner_account_id, orders));
        return ();
    }
    if (rand(10) >= 4) {
        builder order = pack_order(order_seqno, 3, now(), order_amount, src_wc, src_addr);
        orders~udict_set_builder(32, order_seqno, order);
        set_data(pack_state(stored_seqno, pubkey, order_seqno + 1, number_of_wins, incoming_amount + order_amount, outgoing_amount, owner_wc, owner_account_id, orders));
        if (order_amount > 3000000000) {
            send_grams(owner_wc, owner_account_id, order_amount / 3);
        }
        return ();
    }
    send_grams(src_wc, src_addr, 2 * order_amount);
    builder order = pack_order(order_seqno, 2, now(), order_amount, src_wc, src_addr);
    orders~udict_set_builder(32, order_seqno, order);
    set_data(pack_state(stored_seqno, pubkey, order_seqno + 1, number_of_wins + 1, incoming_amount, outgoing_amount + 2 * order_amount, owner_wc, owner_account_id, orders));
}

그게 전부 야. 해당 커밋.

이제 남은 것은 간단합니다. 외부 세계에서 계약 상태에 대한 정보를 얻을 수 있도록 get-method를 만들어 보겠습니다(실제로 스마트 계약 저장소에서 데이터를 읽습니다).

get 메소드를 추가해보자. 스마트 계약에 대한 정보를 받는 방법에 대해 아래에 작성하겠습니다.

또한 스마트 계약을 게시할 때 발생하는 첫 번째 요청을 처리할 코드를 추가하는 것을 잊었습니다. 해당 커밋. 그리고 더 나아가 수정 금액의 1/3을 소유자 계정으로 보내는 버그.

다음 단계는 스마트 계약을 게시하는 것입니다. 폴더를 만들어보자 requests.

출판 코드를 기초로 삼았습니다 simple-wallet-code.fc 어느 쪽 찾을 수있다 공식 저장소에 있습니다.

주목할 가치가 있는 것. 스마트 계약 저장소와 입력 메시지를 생성합니다. 그 후 스마트 계약의 주소가 생성됩니다. 즉, TON에 게시되기 전에도 주소가 알려져 있습니다. 다음으로, 이 주소로 몇 그램을 보내야 하며, 그 후에만 스마트 계약 자체가 포함된 파일을 보내야 합니다. 왜냐하면 네트워크는 스마트 계약 및 작업을 저장하는 데 수수료를 받기 때문입니다(스마트 계약을 저장하고 실행하는 검증자). 계약). 코드는 여기서 볼 수 있습니다.

다음으로 게시 코드를 실행하고 lottery-query.boc 스마트 계약 파일 및 주소.

~/TON/build/crypto/fift -s requests/new-lottery.fif 0

생성된 파일을 저장하는 것을 잊지 마세요. lottery-query.boc, lottery.addr, lottery.pk.

무엇보다도 실행 로그에서 스마트 계약의 주소를 볼 수 있습니다.

new wallet address = 0:044910149dbeaf8eadbb2b28722e7d6a2dc6e264ec2f1d9bebd6fb209079bc2a 
(Saving address to file lottery.addr)
Non-bounceable address (for init): 0QAESRAUnb6vjq27KyhyLn1qLcbiZOwvHZvr1vsgkHm8Ksyd
Bounceable address (for later access): kQAESRAUnb6vjq27KyhyLn1qLcbiZOwvHZvr1vsgkHm8KpFY

그냥 재미삼아 TON에게 요청해보자

$ ./lite-client/lite-client -C ton-lite-client-test1.config.json 
getaccount 0QAESRAUnb6vjq27KyhyLn1qLcbiZOwvHZvr1vsgkHm8Ksyd

그러면 이 주소를 가진 계정이 비어 있음을 알 수 있습니다.

account state is empty

우리는 주소로 보내드립니다 0QAESRAUnb6vjq27KyhyLn1qLcbiZOwvHZvr1vsgkHm8Ksyd 2 Gram을 사용하고 몇 초 후에 동일한 명령을 실행합니다. 내가 사용하는 그램을 보내려면 공식 지갑, 채팅에서 누군가에게 테스트 그램을 요청할 수 있습니다. 이에 대해서는 기사 끝 부분에서 설명하겠습니다.

> getaccount 0QAESRAUnb6vjq27KyhyLn1qLcbiZOwvHZvr1vsgkHm8Ksyd

초기화되지 않은 것 같습니다(state:account_uninit) 동일한 주소와 잔액이 1나노그램인 스마트 계약입니다.

account state is (account
  addr:(addr_std
    anycast:nothing workchain_id:0 address:x044910149DBEAF8EADBB2B28722E7D6A2DC6E264EC2F1D9BEBD6FB209079BC2A)
  storage_stat:(storage_info
    used:(storage_used
      cells:(var_uint len:1 value:1)
      bits:(var_uint len:1 value:103)
      public_cells:(var_uint len:0 value:0)) last_paid:1583257959
    due_payment:nothing)
  storage:(account_storage last_trans_lt:3825478000002
    balance:(currencies
      grams:(nanograms
        amount:(var_uint len:4 value:2000000000))
      other:(extra_currencies
        dict:hme_empty))
    state:account_uninit))
x{C00044910149DBEAF8EADBB2B28722E7D6A2DC6E264EC2F1D9BEBD6FB209079BC2A20259C2F2F4CB3800000DEAC10776091DCD650004_}
last transaction lt = 3825478000001 hash = B043616AE016682699477FFF01E6E903878CDFD6846042BA1BFC64775E7AC6C4
account balance is 2000000000ng

이제 스마트 계약을 게시해 보겠습니다. lite-client를 시작하고 실행해 보겠습니다.

> sendfile lottery-query.boc
[ 1][t 2][1583008371.631410122][lite-client.cpp:966][!testnode] sending query from file lottery-query.boc
[ 3][t 1][1583008371.828550100][lite-client.cpp:976][!query]    external message status is 1 

계약서가 게시되었는지 확인해 보겠습니다.

> last
> getaccount 0QAESRAUnb6vjq27KyhyLn1qLcbiZOwvHZvr1vsgkHm8Ksyd

무엇보다도 우리는 얻습니다.

  storage:(account_storage last_trans_lt:3825499000002
    balance:(currencies
      grams:(nanograms
        amount:(var_uint len:4 value:1987150999))
      other:(extra_currencies
        dict:hme_empty))
    state:(account_active

우리는 그것을 본다 account_active.

변경사항이 있는 해당 커밋 여기에.

이제 스마트 계약과 상호 작용하기 위한 요청을 생성해 보겠습니다.

보다 정확하게는 주소 변경을 위한 첫 번째 작업을 독립적인 작업으로 남겨두고, 소유자의 주소로 그램을 보내는 두 번째 작업을 수행하겠습니다. 실제로 그램 전송 테스트와 동일한 작업을 수행해야 합니다.

이것은 우리가 스마트 계약으로 보낼 메시지입니다. msg_seqno 165, action 발송용은 2그램과 9.5그램입니다.

<b 165 32 u, 2 7 u, 9500000000 Gram, b>

개인 키로 메시지에 서명하는 것을 잊지 마세요. lottery.pk, 이는 스마트 계약을 생성할 때 이전에 생성되었습니다. 다음은 해당 커밋입니다..

get 메소드를 사용하여 스마트 계약에서 정보 수신

이제 스마트 계약 get 메소드를 실행하는 방법을 살펴보겠습니다.

시작하다 lite-client 그리고 우리가 작성한 get 메소드를 실행하세요.

$ ./lite-client/lite-client -C ton-lite-client-test1.config.json
> runmethod 0QAESRAUnb6vjq27KyhyLn1qLcbiZOwvHZvr1vsgkHm8Ksyd balance
arguments:  [ 104128 ] 
result:  [ 64633878952 ] 
...

В result 함수가 반환하는 값을 포함합니다. balance() 우리의 스마트 계약에서.
우리는 더 많은 방법에 대해 동일한 작업을 수행할 것입니다.

> runmethod 0QAESRAUnb6vjq27KyhyLn1qLcbiZOwvHZvr1vsgkHm8Ksyd get_seqno
...
arguments:  [ 77871 ] 
result:  [ 1 ] 

베팅 내역을 물어보겠습니다.

> runmethod 0QAESRAUnb6vjq27KyhyLn1qLcbiZOwvHZvr1vsgkHm8Ksyd get_orders
...
arguments:  [ 67442 ] 
result:  [ ([0 1 1583258284 10000000000 0 74649920601963823558742197308127565167945016780694342660493511643532213172308] [1 3 1583258347 4000000000 0 74649920601963823558742197308127565167945016780694342660493511643532213172308] [2 1 1583259901 50000000000 0 74649920601963823558742197308127565167945016780694342660493511643532213172308]) ] 

우리는 lite-client를 사용하여 사이트에 스마트 계약에 대한 정보를 표시하는 방법을 얻을 것입니다.

웹사이트에 스마트 계약 데이터 표시

저는 스마트 계약의 데이터를 편리한 방식으로 표시하기 위해 Python으로 간단한 웹사이트를 작성했습니다. 여기서는 자세히 설명하지 않고 사이트를 게시하겠습니다. 한 번의 커밋으로.

TON에 대한 요청은 다음에서 이루어집니다. Python 를 통해 lite-client. 편의를 위해 사이트는 Docker로 패키징되어 Google Cloud에 게시됩니다. 링크.

해보자

이제 보충을 위해 그램을 그곳으로 보내 보겠습니다. 지갑. 40g을 보내드립니다. 그리고 명확성을 위해 몇 가지 베팅을 해보겠습니다. 이 사이트에는 베팅 내역, 현재 승률 및 기타 유용한 정보가 표시됩니다.

우리는보다우리가 첫 번째는 이겼고 두 번째는 졌다는 거죠.

사후

기사는 제가 예상한 것보다 훨씬 길었고, 더 짧았을 수도 있고, 아니면 단지 TON에 대해 아무것도 모르고 상호 작용할 수 있는 그리 간단하지 않은 스마트 계약을 작성하고 게시하려는 사람을 위한 것일 수도 있습니다. 그것. 아마도 어떤 것들은 더 간단하게 설명될 수 있었을 것입니다.

아마도 구현의 일부 측면을 더 효율적이고 우아하게 수행할 수 있었을 것입니다. 그러나 그렇게 되었다면 기사를 준비하는 데 훨씬 더 많은 시간이 걸렸을 것입니다. 어딘가에서 실수를 했거나 뭔가를 이해하지 못했을 수도 있으므로 심각한 작업을 수행하는 경우 TON 코드가 있는 공식 문서나 공식 저장소에 의존해야 합니다.

TON 자체는 여전히 활발한 개발 단계에 있기 때문에 이 기사의 모든 단계를 중단시키는 변경 사항이 발생할 수 있지만(이 글을 쓰는 동안 발생했으며 이미 수정되었습니다) 일반적인 접근 방식은 다음과 같습니다. 바뀔 것 같지 않습니다.

TON의 미래에 대해서는 이야기하지 않겠습니다. 아마도 플랫폼이 크게 성장할 것이므로 우리는 시간을 들여 플랫폼을 연구하고 지금 우리 제품으로 틈새 시장을 채워야 할 것입니다.

TON보다 더 많은 잠재 고객을 보유한 Facebook의 Libra도 있습니다. 저는 Libra에 대해 거의 아는 바가 없습니다. 포럼에 따르면 TON 커뮤니티보다 Libra에서 훨씬 더 많은 활동이 있다고 판단됩니다. TON의 개발자와 커뮤니티는 언더그라운드에 더 가깝지만 그것도 멋지네요.

참조

1. 공식 TON 문서: https://test.ton.org
2. 공식 TON 저장소: https://github.com/ton-blockchain/ton
3. 다양한 플랫폼의 공식 지갑: https://wallet.ton.org
4. 이 기사의 스마트 계약 저장소: https://github.com/raiym/astonished
5. 스마트 계약 웹사이트 링크: https://ton-lottery.appspot.com
6. FunC용 Visual Studio Code 확장을 위한 리포지토리: https://github.com/raiym/func-visual-studio-plugin
7. 초기 단계에서 이를 파악하는 데 큰 도움이 된 Telegram의 TON에 대해 채팅하세요. TON에 글을 쓰신 분들은 다 거기 계시다고 해도 틀리지 않을 것 같아요. 거기에서 테스트 그램을 요청할 수도 있습니다. https://t.me/tondev_ru
8. 유용한 정보를 찾은 TON에 대한 또 다른 대화: https://t.me/TONgramDev
9. 대회의 첫 번째 단계: https://contest.com/blockchain
10. 대회의 두 번째 단계: https://contest.com/blockchain-2

출처 : habr.com