Waves RIDE dApp을 구축, 배포 및 테스트하는 방법

안녕하세요! 이 기사에서는 Waves 노드에서 일반 dApp을 작성하고 실행하는 방법을 보여 드리겠습니다. 필요한 도구와 방법, 개발 사례를 살펴보겠습니다.

dApp과 일반 애플리케이션의 개발 계획은 거의 동일합니다.

• 우리는 코드를 작성합니다
• 자동화된 테스트 작성
• 애플리케이션 실행
• 테스트

도구

1. docker 노드와 Waves Explorer를 실행하려면

노드를 시작하지 않으려면 이 단계를 건너뛸 수 있습니다. 결국 테스트 및 실험 네트워크가 있습니다. 그러나 자체 노드를 배포하지 않으면 테스트 프로세스가 지연될 수 있습니다.

• 테스트 토큰이 있는 새 계정이 지속적으로 필요합니다. 테스트 네트워크 수도꼭지는 10분마다 10개의 WAVES를 전송합니다.
• 테스트 네트워크의 평균 블록 시간은 1분이고, 노드에서는 15초입니다. 이는 거래에 여러 번의 확인이 필요할 때 특히 두드러집니다.
• 공개 테스트 노드에서는 공격적인 캐싱이 가능합니다.
• 또한 유지보수로 인해 일시적으로 이용이 불가능할 수도 있습니다.

이제부터는 여러분이 자신의 노드로 작업하고 있다고 가정하겠습니다.

2. 서핑보드 명령줄 도구

• 여기에서 ppa, homebrew 또는 exe를 사용하여 Node.js를 다운로드하고 설치하세요. https://nodejs.org/en/download/.
• 기존 노드에서 테스트를 실행할 수 있는 도구인 Surfboard를 설치합니다.

npm install -g @waves/surfboard

3. Visual Studio Code 플러그인

IDE 팬이 아니고 텍스트 편집기를 선호하는 경우 이 단계는 선택 사항입니다. 필요한 모든 도구는 명령줄 유틸리티입니다. vim을 사용한다면 플러그인에 주의하세요 vim-ride.

Visual Studio Code를 다운로드하고 설치합니다. https://code.visualstudio.com/

VS Code를 열고 wave-ride 플러그인을 설치합니다.

Waves Keeper 브라우저 확장: https://wavesplatform.com/products-keeper

완료!

노드 및 Waves Explorer 시작

1. 노드를 시작합니다.

docker run -d -p 6869:6869 wavesplatform/waves-private-node

노드가 REST API를 통해 실행되는지 확인하세요. http://localhost:6869:

노드용 Swagger REST API

2. Waves Explorer 인스턴스를 시작합니다.

docker run -d -e API_NODE_URL=http://localhost:6869 -e NODE_LIST=http://localhost:6869 -p 3000:8080 wavesplatform/explorer

브라우저를 열고 다음으로 이동하십시오. http://localhost:3000. 빈 로컬 노드 회로가 얼마나 빨리 구축되는지 확인할 수 있습니다.

Waves Explorer에 로컬 노드 인스턴스가 표시됩니다.

RIDE 구조 및 서핑보드 도구

빈 디렉터리를 만들고 그 안에서 명령을 실행하세요.

surfboard init

이 명령은 프로젝트 구조, "hello world" 애플리케이션 및 테스트를 사용하여 디렉터리를 초기화합니다. VS Code로 이 폴더를 열면 다음이 표시됩니다.

Surfboard.config.json

• ./ride/ 폴더 아래에 단일 파일 wallet.ride(dApp 코드가 있는 디렉터리)가 있습니다. 다음 블록에서는 dApp을 간략하게 분석하겠습니다.
• ./test/ 폴더 아래에 *.js 파일이 있습니다. 테스트는 여기에 저장됩니다.
• ./surfboard.config.json – 테스트 실행을 위한 구성 파일입니다.

Envs는 중요한 섹션입니다. 각 환경은 다음과 같이 구성됩니다.

• dApp을 실행하는 데 사용될 노드의 REST API 엔드포인트와 네트워크의 CHAIN_ID입니다.
• 테스트 토큰의 소스가 될 토큰이 있는 계정에 대한 비밀 문구입니다.

보시다시피, Surfboard.config.json은 기본적으로 여러 환경을 지원합니다. 기본값은 로컬 환경입니다(defaultEnv 키는 변경 가능한 매개변수입니다).

지갑 데모 애플리케이션

이 섹션은 RIDE 언어에 대한 참조가 아닙니다. 그보다는 블록체인에서 무슨 일이 일어나고 있는지 더 잘 이해하기 위해 배포하고 테스트하는 애플리케이션을 살펴보세요.

간단한 Wallet 데모 애플리케이션을 살펴보겠습니다. 누구나 dApp 주소로 토큰을 보낼 수 있습니다. WAVES만 인출할 수 있습니다. InvokeScriptTransaction을 통해 두 가지 @Callable 함수를 사용할 수 있습니다.

• deposit()WAVES에 첨부된 결제가 필요합니다.
• withdraw(amount: Int)토큰을 반환하는

dApp 라이프사이클 전반에 걸쳐 구조(주소 → 금액)가 유지됩니다.

동작
결과 상태

처음에는
빈

앨리스는 5 WAVES를 예치합니다.
앨리스 주소 → 500000000

Bob은 2 WAVES를 입금했습니다.

앨리스 주소 → 500000000
밥 주소 → 200000000

Bob은 7 WAVES를 인출합니다.
거부됨!

앨리스는 4개의 WAVES를 인출합니다.
앨리스 주소 → 100000000
밥 주소 → 200000000

상황을 완전히 이해하는 코드는 다음과 같습니다.

# In this example multiple accounts can deposit their funds and safely take them back. No one can interfere with this.
# An inner state is maintained as mapping `address=>waves`.
{-# STDLIB_VERSION 3 #-}
{-# CONTENT_TYPE DAPP #-}
{-# SCRIPT_TYPE ACCOUNT #-}
@Callable(i)
func deposit() = {
 let pmt = extract(i.payment)
 if (isDefined(pmt.assetId))
    then throw("works with waves only")
    else {
     let currentKey = toBase58String(i.caller.bytes)
     let currentAmount = match getInteger(this, currentKey) {
       case a:Int => a
       case _ => 0
     }
     let newAmount = currentAmount + pmt.amount
     WriteSet([DataEntry(currentKey, newAmount)]) 
   }
 }
@Callable(i)
func withdraw(amount: Int) = {
 let currentKey = toBase58String(i.caller.bytes)
 let currentAmount = match getInteger(this, currentKey) {
   case a:Int => a
   case _ => 0
 }
 let newAmount = currentAmount - amount
 if (amount < 0)
   then throw("Can't withdraw negative amount")
   else if (newAmount < 0)
     then throw("Not enough balance")
     else ScriptResult(
       WriteSet([DataEntry(currentKey, newAmount)]),
       TransferSet([ScriptTransfer(i.caller, amount, unit)])
      )
 }
@Verifier(tx)
func verify() = false

샘플 코드는 다음에서도 찾을 수 있습니다. GitHub의.

VSCode 플러그인은 파일을 편집하는 동안 지속적인 컴파일을 지원합니다. 따라서 문제 탭에서 항상 오류를 모니터링할 수 있습니다.

파일을 컴파일할 때 다른 텍스트 편집기를 사용하려면 다음을 사용하세요.

surfboard compile ride/wallet.ride

그러면 일련의 base64 컴파일된 RIDE 코드가 출력됩니다.

'wallet.ride'에 대한 테스트 스크립트

살펴 보자 테스트 파일. JavaScript의 Mocha 프레임워크로 구동됩니다. "이전" 기능과 세 가지 테스트가 있습니다:

• "이전"은 MassTransferTransaction을 통해 여러 계정에 자금을 조달하고 스크립트를 컴파일하여 블록체인에 배포합니다.
• "예금 가능"은 InvokeScriptTransaction을 네트워크로 전송하여 두 계정 각각에 대해 예금() 기능을 활성화합니다.
• 누구도 다른 사람의 토큰을 훔칠 수 없다는 “예치된 것보다 더 많은 금액을 인출할 수 없습니다” 테스트입니다.
• “입금 가능”은 출금이 올바르게 처리되었는지 확인합니다.

Surfboard에서 테스트를 실행하고 Waves Explorer에서 결과를 분석하세요.

테스트를 실행하려면 다음을 실행하세요.

surfboard test

여러 스크립트가 있는 경우(예: 별도의 배포 스크립트가 필요함) 다음을 실행할 수 있습니다.

surfboard test my-scenario.js

Surfboard는 ./test/ 폴더에 테스트 파일을 수집하고 Surfboard.config.json에 구성된 노드에서 스크립트를 실행합니다. 몇 초 후에 다음과 같은 내용이 표시됩니다.

wallet test suite
Generating accounts with nonce: ce8d86ee
Account generated: foofoofoofoofoofoofoofoofoofoofoo#ce8d86ee - 3M763WgwDhmry95XzafZedf7WoBf5ixMwhX
Account generated: barbarbarbarbarbarbarbarbarbar#ce8d86ee - 3MAi9KhwnaAk5HSHmYPjLRdpCAnsSFpoY2v
Account generated: wallet#ce8d86ee - 3M5r6XYMZPUsRhxbwYf1ypaTB6MNs2Yo1Gb
Accounts successfully funded
Script has been set
   √ Can deposit (4385ms)
   √ Cannot withdraw more than was deposited
   √ Can withdraw (108ms)
3 passing (15s)

만세! 테스트가 통과되었습니다. 이제 Waves Explorer를 사용할 때 어떤 일이 발생하는지 살펴보겠습니다. 블록을 보거나 위의 주소 중 하나를 검색에 붙여넣습니다(예: 해당 wallet#. 거기에서 거래 내역, dApp 상태, 디컴파일된 바이너리 파일을 찾을 수 있습니다.

웨이브 익스플로러. 방금 배포된 애플리케이션입니다.

몇 가지 서핑보드 팁:

1. 테스트넷 환경에서 테스트하려면 다음을 사용하십시오.

surfboard test --env=testnet

테스트 토큰 받기

2. 트랜잭션의 JSON 버전과 노드에서 처리되는 방식을 보려면 -v('verbose'를 의미)를 사용하여 테스트를 실행합니다.

surfboard test -v

Waves Keeper와 함께 앱 사용하기

1. Waves Keeper가 작동하도록 설정합니다. http://localhost:6869

로컬 노드와 작동하도록 Waves Keeper 설정

2. 네트워크 토큰과 함께 비밀 문구를 가져오시겠습니까? 단순화를 위해 노드의 초기 시드를 사용합니다. waves private node seed with waves tokens. 주소: 3M4qwDomRabJKLZxuXhwfqLApQkU592nWxF.

3. npm을 사용하여 서버리스 단일 페이지 애플리케이션을 직접 실행할 수 있습니다. 또는 기존 항목으로 이동합니다. chrome-ext.wvservices.com/dapp-wallet.html

4. dApp 주소 텍스트 상자에 테스트 실행의 지갑 주소(위 밑줄 친 부분)를 입력하세요.

5. "입금" 필드에 소액을 입력하고 버튼을 클릭하세요:

Waves Keeper는 10 WAVES를 지불하고 InvokeScriptTransaction에 서명할 수 있는 권한을 요청합니다.

6. 거래를 확인하세요.

트랜잭션이 생성되어 네트워크에 브로드캐스트됩니다. 이제 그녀의 ID를 볼 수 있습니다

7. Waves Explorer를 사용하여 트랜잭션을 모니터링합니다. 검색창에 아이디를 입력하세요

결론 및 추가 정보

Waves 플랫폼에서 간단한 dApp을 개발, 테스트, 배포 및 사용하기 위한 도구를 살펴보았습니다.

• RIDE 언어
• VS 코드 편집기
• 웨이브 탐색기
• 서핑 보드
• 웨이브 키퍼

RIDE를 계속 배우고 싶은 분들을 위한 링크:

더 많은 예
예제가 포함된 온라인 IDE
웨이브 문서
텔레그램의 개발자 채팅
스택오버플로우의 Waves 및 RIDE
새로운! Waves 플랫폼에서 dApp을 생성하는 온라인 과정

계속해서 RIDE 주제에 대해 알아보고 첫 번째 dApp을 만들어보세요!

TL; DR : bit.ly/2YCFnwY

출처 : habr.com