MTool 온라인 가이드

MTool 온라인 가이드

소개

노드 이전, 스테이킹, 위탁 및 거버넌스 및 기타 관련 작업을 쉽게 하기 위해 PlatON은 사용자를 지원하는 MTool을 제공합니다.

  • PlatON MTool은 Ubuntu 18.04 및 Windows 10을 지원합니다. 이 문서에서는 Windows 및 Ubuntu의 설치 및 사용에 대해 각각 설명합니다.사용자는 자신의 리소스에 따라 선택할 수 있습니다.
  • PlatON MTool은 스테이킹등과 같은 트랜잭션에 대해 온라인 서명과 오프라인 서명의 두 가지 서명 방법을 제공합니다. 이 문서는 온라인 서명 작업에 대해 설명합니다.오프라인 서명 작업에 대해서는 오프라인 PlatON MTool 를 참조하십시오.

PlatON MTool설치

또한 이 문서는 Windows 및 Ubuntu 환경에서 PlatON MTool의 동작을 별도로 소개하고 있으며, 사용자는 자신의 리소스에 따라 선택할 수 있습니다.

Windows환경에서 PlatON MTool 설치

설치전 준비사항

실행 명령어:

platon_mtool --version


실행 결과 “platon_mtool” 항목을 cmdlet, 함수, 스크립트 파일 또는 실행 프로그램의 이름으로 인식할 수 없다고 표시되는 경우, 이 절차를 확인하십시오. 경로를 포함하는 경우 경로가 올바른지 확인한 후 다시 시도하십시오.이전 버전이 설치되지 않았으면, 다음 작업을 수행할 필요가 없음을 의미합니다.

실행 결과 버전 번호, 타임 스탬프 및 기타 정보가 표시되면 PlatON MTool이 설치된 것이므로 PlatON MTool이 이전 버전인 경우 이 때 중요한 정보를 백업한 다음 이전 버전을 수동으로 제거해야 합니다. 작업 단계:

step1. 백업 목록

C:\platon_mtool\mtool\current\keystore 아래에 있는 모든 파일을 D 디스크 또는 C:\platon_mtool이 아닌 다른 목록에 넣습니다. 새 버전을 설치한 후 백업 파일을 다시 C:\platon_mtool\mtool\current\keystore 목록에 복사해야 합니다.

step2. 이전 버전 제거

C:\platon_mtool\unins000.exe를 두 번 클릭하여 PlatON MTool 및 기타 도구의 모든 이전 버전을 제거합니다.

설치 시작

step1. PlatON MTool 설치 패키지 다운로드

온라인 머신에서 https://download.platon.network/platon/mtool/windows/1.0.0/platon_mtool.exe링크를 브라우저에 복사하여 PlatON MTool 설치 패키지를 다운로드합니다.

step2. PlatON MTool설치

platon_mtool.exe를 두번 클릭하여 설치합니다. 기본 설치 목록은 C:\platon_mtool이며, 이 설치 목록을 변경하지 않는 것이 좋습니다. 팝업에 설치가 성공했음을 나타내는 Completing the mtool Setup Wizard 메시지가 표시되면 Finish를 클릭하면 됩니다.

step3. 터미널 다시 시작

설치가 완료되면 새로 추가된 환경 변수를 적용하려면 터미널을 다시 시작해야 합니다(서버를 다시 시작하지 않고 Cmd 창이나 PowerShell 창을 닫고 창을 다시 열면 됨).

Ubuntu에서 PlatON MTool 설치

다음과 같이 진행하십시오:

step1. PlatON MTool 툴킷 다운로드

wget https://download.platon.network/platon/mtool/linux/1.0.0/platon_mtool.zip

step2. PlatON MTool 툴킷 압축 풀기

(if ! command -v unzip;then sudo apt install unzip; fi;) && unzip platon_mtool.zip && cd platon_mtool

step3. 스크립트 다운로드

스크립트를 platon_mtool 목록에 다운로드하십시오. 그렇지 않으면 스크립트가 새 버전의 mtool 경로를 찾을 수 없습니다.

wget https://download.platon.network/platon/scripts/mtool_install.sh

step4. 실행

chmod +x mtool_install.sh && ./mtool_install.sh

  • Install platon mtool succeed. 라는 메시지가 표시되면 PlatON MTool 설치가 성공적으로 완료되었음을 의미하며, 설치에 성공하지 못한 경우 커뮤니티 서비스 담당자 연락처 정보를 통해 특정 문제를 피드백하십시오.

step5. 세션 창 다시 시작
설치가 완료되면 새로 추가된 환경 변수를 적용하려면 세션 창을 다시 시작해야 합니다(서버를 다시 시작하지 않고 세션 창을 닫거나 ssh 도구로 창을 다시 열면 됨).

PlatON MTool 환경 변수 설명

Windows와 Ubuntu의 PlatON MTool 디렉터리에서 사용되는 환경 변수는 다음과 같습니다:

  • PlatON MTool 목록
    • Windows:%PLATON_MTOOLDIR%
    • Ubuntu:$PLATON_MTOOLDIR

참고:사용자는 자신이 설치한 시스템에 따라 환경 변수를 선택합니다.

PlatON MTool 명령세부사항 

주의사항:

  • 아래 명령어는 Ubuntu에서 명령어 형식이며 Windows에서는 $PLATON_MTOOLDIR을 %PLATON_MTOOLDIR%로 수정해야 합니다.
  • 개발 네트워크에 연결되어 있는 경우 PlatON MTool 설치 디렉터리에 있는 config.properties 구성 파일의 chainid를 201030으로 수정해야 합니다.

지갑 생성

  • 명령어 실행

platon_mtool account new staking

  • 매개변수 설명

staking: 생성된 지갑 이름 동일한 비밀번호를 두 번 입력하면 생성 성공 후 $PLATON_MTOOLDIR/keystore 디렉토리 아래에 지갑 파일 staking.json이 생성되고 다음 정보가 출력됩니다:

-name: staking-type: NORMAL-address: lat124xmsmd0uf5cvk7v3s36eytqezqsjfcxfw2lmr-public key: 0x9521cd81ba28d5d1c23bb7ddb7042d146375203d35000c0289178027abd4dc09bca30257739df166201e73497485242f41d5f50d46bc3c7e4385f81bde560db0

Important write this Private Key in a safe place.It is the important way to recover your account if you ever forget your password.4630b6d86bc74bffd4ca8cfc18bceec562cb40fc5080c258452a04a69bc1ee07

Important write this mnemonic phrase in a safe place.It is the important way to recover your account if you ever forget your password.worry jewel penalty jealous expect embark outer eternal verb rebuild rice kidney

지갑 주소 형식은 다음과 같이 Bech32로 적용됩니다.

lat124xmsmd0uf5cvk7v3s36eytqezqsjfcxfw2lmr: 지갑 주소;

4630b6d86bc74bffd4ca8cfc18bceec562cb40fc5080c258452a04a69bc1ee07은 지갑 프라이빗 키입니다.

worry jewel penalty jealous expect embark outer eternal verb rebuild rice kidney 는 니모닉입니다.

보안하기 위한 사용자는 지갑의 프라이빗 키 및 니모닉 문구를 백업해야 하며(둘 중 하나 또는 둘 다 백업 가능) 지갑 분실 시 복구에 사용할 수 있습니다. 사용자는 니모닉 문구 또는 프라이빗 키를 오프라인 머신과 같은 안전한 저장 매체에 백업하는 것이 좋습니다.

지갑 복원

지갑 파일이 손실된 경우 백업된 프리이빗 키 또는 니모닉을 사용하여 다음과 같이 복원할 수 있습니다:

  • 명령어 실행
    프라이빗 키를 통해 복구:

platon_mtool account recover -k staking

새 지갑 비밀번호와 백업 프라이빗 키를 입력하라는 메시지가 다음과 같이 표시됩니다:

Enter a passphrase to encrypt your key to disk:Repeat the passphrase:Enter your 64bit Private Key:4630b6d86bc74bffd4ca8cfc18bceec562cb40fc5080c258452a04a69bc1ee07

또한 니모닉을 통해 복구:platon_mtool account recover -m staking

새 비밀번호와 니모닉 단어를 입력하라는 메세지가 다음과 같이 표시됩니다:

Enter a passphrase to encrypt your key to disk:Repeat the passphrase:Enter you r bip39 mnemonic:worry jewel penalty jealous expect embark outer eternal verb rebuild rice kidney

  • 매개변수 설명
    staking:지갑 이름
    성공적으로 복원되면 $PLATON_MTOOLDIR/keystore 디렉토리 아래에 지갑 파일 staking.json이 생성됩니다.

일반 이체 작업

  • 명령어 실행

platon_mtool tx transfer --keystore $PLATON_MTOOLDIR/keystore/staking.json --amount "1" --recipient $to_address --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수 설명

keystore: 보내는 지갑의 경로

amount:이체 금액(단위:LAT)

recipient:받은 주소

config:노드 정보 파일 경로 확인

지갑 리스트 확인

  • 명령어 실행

platon_mtool account list

지갑 이름으로 잔액 확인

  • 명령어 실행

platon_mtool account balance $keystorename --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수 설명

$keystorename:지갑 파일 이름,예:staking.json

config:노드 정보 파일 경로 확인

주소로 잔액 확인

  • 명령어 실행

platon_mtool account balance -a $address --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수

a:지갑주소 

config:노드 정보 파일 경로 확인

새로운 락업 계획을 새우기

노드는 본인 지갑에 있는 자금을 사용하여 새로운 락업 계획을 만들 수 있습니다. 새로운 락업 계획을 새우기 전에 먼저 json 형식의 락업 계획 설명 파일을 생성해야 합니다.

  • 릭업 계획 설명 파일,retricting_plans.json

{  "account":"lat12jn6835z96ez93flwezrwu4xpv8e4zathsyxdn",  "plans":[    {"epoch": 5000,"amount": 100},    {"epoch": 6000,"amount": 100},    {"epoch": 7000,"amount": 100}  ]}

account:락업 자금 전송될 대상 주소

epoch:전송를 기다리는 결제 주기의 수(1 이상)

amount:전송 자금, 단위: LAT

  • 명렬어 실행

platon_mtool create_restricting --config $PLATON_MTOOLDIR/validator/validator_config.json --keystore $PLATON_MTOOLDIR/keystore/staking.json --file ./restricting_plans.json

  • 매개변수 설명

config:노드 정보 파일 경로 확인

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

file: 락업 계획의 설명 파일

스테이킹 작업 시작

합의 노드 배포가 완료되고 블록이 성공적으로 동기화되면 PlatON MTool을 사용하여 스테이킹할 수 있습니다. 자금 신청 완료 후 계정에  잔액이 충분한지 확인하고, 이용자의 상황에 따라 스테이킹할 금액을 입금하며, 최소 한도는 100,000 LAT 입니다.

참고: 계정에 충분한 LAT를 유지하여 노드가 관리하는 후속 트랜잭션에 대비하여 업그레이드 제안에 대한 투표 및 기타 트랜잭션과 같은 충분한 트랜잭션 수수료를 갖도록 하십시오.

  • 명령어 실행

platon_mtool staking --config $PLATON_MTOOLDIR/validator/validator_config.json --keystore $PLATON_MTOOLDIR/keystore/staking.json --amount 100000 --benefit_address xxx196278ns22j23awdfj9f2d4vz0pedld8a2fzwwj --delegated_reward_rate 5000 --node_name myNode --website www.mywebsite.com --details myNodeDescription --external_id 121412312

힌트:please input keystore password:스테이킹 지갑의 비밀번호를 입력한 후 Enter를 누르면 다음 정보가 표시되면 스테이킹이 성공한 것입니다:

operation finishedtransaction hash:0x89b964d27d0caf1d8bf268f721eb123c4af57aed36187bea90b262f4769eeb9bSUCCESS

  • 매개변수 설명

config:노드 정보 파일 경로 확인

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

amount: 스테이킹 수량,100000LAT 이상,소수점 8자리 이하(Free 금액 사용 스테이킹)

restrictedamount: 100000LAT 이상,소수점 8자리 이하(락업금액 사용 스테이킹)

autoamount:100000LAT 이상-락업 금액을 우선 사용,락업 금액을 부족할 경우,Free 금액으로 테스이킹

benefit_address:검증노드 수익 주소 

delegated_reward_rate:위탁 보상 비율,단위:만 포센트, 정수, 범위 [0,10000], 예를 들어 5000을 입력하면 배당률이 50%임을 의미합니다.

node_name:검증자의 이름으로 30바이트 이하이며 문자, 숫자, 공백, 밑줄 및 #을 지원하며 문자로 시작해야 합니다.

website:공식 웹사이트 경로, 70바이트 이하, 숫자와 문자로 구성

details:소개, 검증자에 대한 간략한 소개, 280바이트 이하

external_id:keybase.io에 있는 노드 아이콘의 ID 또는 외부 시스템 신분 인증의 ID

검증자 정보 수정 작업

  • 명령어 실행

platon_mtool update_validator --config $PLATON_MTOOLDIR/validator/validator_config.json --keystore $PLATON_MTOOLDIR/keystore/staking.json --node_name myNode --website www.mywebsite.com --external_id 121412312 --delegated_reward_rate 6000 --benefit_address lax1x0f9xwr9steccekttqvml0d26zgsxwdnhq3fkv --details "Modify the verifier information operation"

  • 매개변수 설명

config:노드 정보 파일 경로 확인

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

node_name[선택]:검증자의 이름으로 30바이트 이하이며 문자, 숫자, 공백, 밑줄, – 및 #을 지원하며 문자로 시작해야 합니다.

website[선택]:공식 웹사이트 경로, 70바이트 이하, 숫자와 문자로 구성

external_id[선택]:keybase.io에 있는 노드 아이콘의 ID 또는 외부 시스템 신분 인증의 ID

delegated_reward_rate[선택]:위탁 보상 비율,단위:만 포센트, 정수, 범위 [0,10000], 예를 들어 5000을 입력하면 배당률이 50%임을 의미합니다.

benefit_address[선택]:검증노드 수익 주소,42바이트(문자,숫자)

details[선택]:소개,검증자에 대한 간략한 소개, 280바이트 이하

스테이킹 취소 작업

스테이킹 취소하려면 168 정산주기가 필요합니다. 조심하십시오!

  • 명령어 실행

platon_mtool unstaking --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수 설명

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

config:노드 정보 파일 경로 확인

스테이킹 추가 직업

  • 명령어 실행

platon_mtool increasestaking --amount 5000000 --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수 설명

amount:계정 Free 잔액을 사용하여 스테이킹 금액(LAT)을 추가하는 경우, 최소 10 이상, 소수점  8자리 이하입니다.

restrictedamount: 계정 락업 금액을 사용하는 경우,최소 10개 이상, 소수점 8자리 이하(락업 금액으로 스테이킹)

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

config:노드 정보 파일 경로 확인

텍스트 제안 작업 제출 

  • 명령어 실행

platon_mtool submit_textproposal --pid_id 100 --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수 설명

pid_id:GitHub ID

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

config:노드 정보 파일 경로 확인

업데이트 제안 작업 제출

  • 명령어 실행

platon_mtool submit_versionproposal --newversion 1.0.0 --end_voting_rounds 345 --pid_id 100 --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수 설명

newversion:대상 업그레이드 버전, x.x.x, 숫자 구두점

end_voting_rounds:투표 컨센서스 라운드 수, 투표 컨센서스 라운드 수 N은 0 < N <= 4838(약 2주)을 충족해야 합니다.

pid_id:GitHub ID

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

config:노드 정보 파일 경로 확인

제안 취소 작업 제출

  • 명령어 실행

platon_mtool submit_cancelproposal --proposalid 0x444c3df404bc1ce4d869166623514b370046cd37cdfa6e932971bc2f98afd1a6 --end_voting_rounds 12 --pid_id 100 --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수 설명

proposalid:취소해야 하는 제안의 ID, 즉 제안 거래를 시작하는 데 사용되는 hash, 66자이며 문자,숫자로 구성됩니다.

end_voting_rounds:투표 컨센서스 라운드 수, 투표 컨센서스 라운드 수 N은 0 < N <= 4838(약 2주)을 충족해야 합니다.

pid_id:GitHub ID

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

config:노드 정보 파일 경로 확인

텍스트 제안 투표 작업

  • 명령어 실행

platon_mtool vote_textproposal --proposalid 0x444c3df404bc1ce4d869166623514b370046cd37cdfa6e932971bc2f98afd1a6 --opinion yes --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수 설명

proposalid:텍스트 제안의 ID, 즉 제안 거래를 시작하는 데 사용되는 hash, 66자이며 문자,숫자로 구성됩니다.

opinion:투표 옵션, 예(yes), 아니오(no), 기권(abstain) 세 가지 중 하나 선택

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

config:노드 정보 파일 경로 확인

제안 투표 작업 업데이트

  • 명령어 실행

platon_mtool vote_versionproposal --proposalid 0x444c3df404bc1ce4d869166623514b370046cd37cdfa6e932971bc2f98afd1a6 --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수 설명

proposalid:업데이트 제안의 ID, 즉 제안 거래를 시작하는 데 사용되는 hash, 66자이며 문자,숫자로 구성됩니다.

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

config:노드 정보 파일 경로 확인

제안 투표 취소 작업

  • 명령어 실행

platon_mtool vote_cancelproposal --proposalid 0x444c3df404bc1ce4d869166623514b370046cd37cdfa6e932971bc2f98afd1a6 --opinion yes --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수 설명

proposalid:취소해야 하는 제안의 ID, 즉 제안 거래를 시작하는 데 사용되는 hash, 66자이며 문자,숫자로 구성됩니다.

opinion:투표 옵션, 예(yes), 아니오(no), 기권(abstain) 세 가지 중 하나 선택

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

config:노드 정보 파일 경로 확인

매개변수 제안 작업 제출

  • 명령어 실행

platon_mtool submit_paramproposal --pid_id 200 --module $module --paramname $paramname --paramvalue $paramvalue --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수 설명

module:거버넌스 모듈 매개변수

paramname:거버넌스 모듈 매개변수 이름, 대소문자에 주의

paramvalue:거버넌스 모듈 매개변수 값

pid_id:GitHub ID

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

config:노드 정보 파일 경로 확인

매개변수 제안 투표 작업

  • 명령어 실행

platon_mtool  vote_paramproposal --proposalid 0x444c3df404bc1ce4d869166623514b370046cd37cdfa6e932971bc2f98afd1a6 --opinion yes --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수 설명

proposalid:취소해야 하는 제안의 ID, 즉 제안 거래를 시작하는 데 사용되는 hash, 66자이며 문자,숫자로 구성됩니다.

opinion:투표 옵션, 예(yes), 아니오(no), 기권(abstain) 세 가지 중 하나 선택

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

config:노드 정보 파일 경로 확인

버전 선언 작업

  • 명령어 실행

platon_mtool declare_version --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json

  • 매개변수 설명

keystore:트랜잭션 전송을 위한 콜드 지갑 경로

config:노드 정보 파일 경로 확인

도움말 보기

  • 명령어 실행

platon_mtool -h

  • 매개변수 설명

없음

출판사 : PlatONWorld-KR, 재 인쇄 소스를 지정하십시오 :https://platonworld.org/kr/platonkorea/mtool-%ec%98%a8%eb%9d%bc%ec%9d%b8-%ea%b0%80%ec%9d%b4%eb%93%9c/

Like (0)
Previous 7월 15, 2021 10:50
Next 7월 21, 2021 20:16

相关推荐

답글 남기기

Please Login to Comment