시작하기에 앞서

From ArdorDocs
Jump to: navigation, search
This page is a translated version of the page Getting started and the translation is 100% complete.

Other languages:
English • ‎한국어


Ardor는 BAAS(Blockchain As A Service)를 목적으로 하는 최초의 Multi-chain 블록체인 플랫폼으로, 2018년 1월 1일부로 메인넷을 통해 작동해 왔습니다. 블록체인 코어는 에너지 효율적이며 오랜 시간 동안 안정성이 증명된 Nxt 블록체인을 한 단계 업그레이드해 만들어졌습니다. 이 문서는 독자에게 Ardor 플랫폼의 광범위한 기능에 대해 쉽게 설명하기 위한 목적으로 작성되었습니다. Ardor의 독창적인 다양한 기능들에 대해 알아보시고, 몇 가지 튜토리얼을 직접 따라 해 보면서 익혀 보세요. 또한 Ardor의 250개가 넘는 API 각각에 대한 설명과 스마트 컨트랙 사용법에 대한 절차를 기술해 놓았으니, 개발자분들은 이를 통해 쉽고 효율적으로 기존 프로세스에 블록체인을 통합하거나 dApp을 배포하실 수 있으실 겁니다. 추후 신규 기능이 출시되면 이 사이트의 내용 또한 업데이트 예정이니, 정기적으로 새 콘텐츠 및 변동 사항이 있는지 확인하십시오.

Ardor가 처음이신 분들을 위한 자료 링크:

Ardor 백서

개발자를 위한 Ardor 치트 시트

Ardor 플랫폼 수수료 기준 다운로드

Ardor 플랫폼 수수료 기준

Transaction Fee (ARDR) Reasons
Default Ardor fee 1 permanent transaction
Default Child Chain fee 0.01 prunable transaction
New account fee 1 creates permanent global entity
Balance leasing 0.1 Ardor chain only, not frequently used
Ardor Coin Exchange 0.5 permanent transaction
Asset issuance 100 create permanent global entity, Ignis chain only, not frequently used, need to reduce scam assets
Singleton asset issuance 1 + 1 per 32b Ignis chain only, more frequently used, but still creates global permanent entity
Asset increase 10 Ignis chain only, rarely used
Dividend payment 0.1 needs processing, not frequently used
Set asset control 10 Ignis chain only, not frequently used, asset issuers only
Set account control 1 Ignis chain only, not frequently used
Cloud data upload 0.1 + 0.01 per 1kb prunable, but takes space
Poll creation 1 + 0.1 per option > 20 + 0.2 per 32b > 288b not frequently used, need to keep until poll is over, takes space
Phasing approval 0.01 per approved tx needs processing
Account info 1 + 1 per 32b permanent, Ignis only, rarely used
Set account property 0.1 + 0.1 per 32b permanent, Ignis only, not frequently used
Alias assignment 1 + 1 per 32b creates permanent unique entity, not frequently used
Shuffling (total) 0.12 takes space, but prunable, not frequently used
Shuffling penalty 10 IGNIS, 10 Bitswift must be affordable, but not negligible
Currency issuance 4 / 100 / 2500 creates permanent unique entity, not frequently used
Marketplace listing 0.2 + 0.2 per 32b takes space, need to keep until delisting, not frequently used
Marketplace delivery 0.1 + 0.2 per 32b takes space, need to keep
Permanent message 0.1 + 0.1 per 32b permanent
Prunable message 0.01 per 1k prunable
Phasing appendix 0.01 balance independent, 0.2 balance dependent + 0.01 per 32b size depends on size and complexity, needs processing
Composite phasing appendix 0.02 + 0.02 per 32b + per poll fees determined by phasing complexity
Referenced Tx deposit 10 refundable

Ardor 다운로드

우선 자바를 최신버젼으로 업데이트 해 주시기 바랍니다.

Ardor/Ignis를 사용하기 위해선 "지갑"이라고 불리는 클라이언트를 다운 받으셔야 합니다. 클라이언트는 바이너리 패키지형태로 배포되고 있으며 아래 운영체제들을 지원합니다. :


200px-Windowslogo.jpg200px-AppleLogo.jpg200px-Linuxlogo.jpg200px-RaspberryPi Logo.png200px-Android.png


OS별 설치 방법

  1. https://www.jelurida.com/ardor-client.exe 를 클릭하셔서 Ardor 클라이언트의 최신 버젼을 다운로드 받습니다.
  2. Ardor의 윈도우 클라이언트는 .exe 파일이므로, 파일의 진위 여부 확인을 하시려면 integrity check를 별도로 수행 하시면 됩니다.
  3. 클라이언트 파일을 실행 하셔서 설치 하시면 됩니다. 설치 과정중에 Testnet과 Mainnet을 선택할 때 유의해 주세요. (Mainnet Full 노드로 사용 하시려면 계속 다음만 누르시면 됩니다.)설치 중 좀 더 자세한 가이드가 필요 하실 경우 step-by-step guide를 참조 해 주세요. 설치가 완료되면 시작메뉴와 바탕화면에 Ardor 아이콘이 생성됩니다.
  4. Ardor 아이콘을 클릭하시면 곧 새창이 열리면서 Ardor 클라이언트가 실행됩니다.
  5. 기존 계정을 보유하고 계신경우, 해당 주소로 로그인 하시면 됩니다. 신규 계정을 만드는데 도움이 필요 하신 경우, 신규 계정 만드는법을 클릭해 주세요.



  1. https://www.jelurida.com/ardor-installer.dmg 를 클릭하셔서 Ardor 클라이언트의 최신 버젼을 다운로드 받습니다.
  2. 파일의 진위여부 확인을 하시려면, 파일 서명 검증을 클릭해 주세요.
  3. 설치 패키지를 실행한 후 아래 절차를 따라 주세요. (Ardor의 Mac용 설치파일은 .dmg 형태입니다.)
    1. ardor-installer.app을 응용 프로그램(Applications)으로 드래그합니다.
      MacInstaller 1.png
    2. 언어를 선택 합니다.
      MacInstaller 2.png
    3. 'Next'버튼을 눌러 설치를 시작합니다.
      MacInstaller 3.png
    4. 라이센스 이용약관에 동의 합니다.
      MacInstaller 4.png
    5. 설치 경로를 선택합니다.
      MacInstaller 5.png
    6. 설치 하고자 하는 패키지를 선택합니다.
      MacInstaller 6.png
    7. 설치 옵션을 선택합니다. (Mainnet Full 노드로 사용 하시려면 그대로 두시면 됩니다.) 테스트넷으로 설치 하시려면 Ardor 테스트넷 튜토리얼을 참고 하십시오.
      MacInstaller 7.png
    8. 설치가 완료되면 'Done(완료)' 버튼을 누르십시오.
      MacInstaller 9.png
  4. 응용 프로그램(Application)에서 ardor.app을 클릭해 클라이언트를 실행 하실 수 있습니다. 기존 계정을 보유하고 계신 경우, 해당 주소로 로그인 하시면 됩니다. 신규 계정을 만드는데 도움이 필요 하신 경우, 신규 계정 만드는법을 클릭해 주세요.



이 가이드는 Linux 64-bit를 기준으로 작성 되었습니다. 32-bit환경에서 설치가 필요 하신 경우 Oracle Java 8의 32-bit 버젼을 다운로드 하시면 됩니다.

하기 절차들은 Linux VPS 환경에서도 동일하게 적용 됩니다.

Oracle Java 8 셋업

Oracle Java 8 은 하기처럼 PPA 저장소를 통해 설치 하실 수 있습니다(Ubuntu/Debian 빌드 환경). 이미 Oracle Java8을 설치 하신 경우 이 단계를 건너 뛰시면 됩니다. :

sudo add-apt-repository ppa:webupd8team/java 
sudo apt-get update 
sudo apt-get install oracle-java8-installer

Ardor 클라이언트 설치/실행

ardor-client.sh를 통해 대부분의 리눅스 배포판과 호환되는 유닉스 인스톨러 실행 파일을 열고 절차를 따르십시오. 또는 아래에 설명된대로 일반적인 방법을 통해 진행 하실 수도 있습니다. :

  1. 우선 Home 폴더에서 최신 클라이언트 (version 2.2.5)를 다운로드 받습니다:
    cd ~
    wget https://www.jelurida.com/ardor-client.zipwget https://www.jelurida.com/ardor-client.zip.asc 그리고 파일의 진위여부를 확인합니다: gpg --with-fingerprint ardor-client.zip.asc.
  2. 압축을 풉니다:
    unzip ardor-client-2.2.5.zip
    cd ardor
  3. 소프트웨어 설치를 시작합니다. ./run.sh 로 진행하시거나 Ardor노드를 백그라운드에서 실행 하시려면 nohup ./run.sh &로 진행하시면, Ardor 디렉토리를 찾으실 수 있으실 겁니다.
    Ardor server 2.2.5 started successfully. 과 같은 비슷한 텍스트 문구가 보이면 서버가 활성화 될 것입니다. 이 Shell 윈도우는 Ardor 서버를 실행하고, 모든 Ardor 로그 메시지를 보여주므로 종료 하시면 안됩니다!
  4. Ardor 클라이언트에 접속하기 위해 웹브라우저에서 http://localhost:27876/ 를 실행합니다. 컴퓨터에서 Ardor를 처음 실행 하신경우, 모든 Ardor 블록체인 데이터를 다운받아야 합니다. Ardor 클라이언트에서 다운르도 진행 현황을 확인 할 수 있고, 네트워크 연결 속도에 따라 이작업은 몇시간 정도 걸릴 수 있습니다. 기존 계정을 보유하고 계신 경우, 해당 주소로 로그인 하시면 됩니다. 신규 계정을 만드는데 도움이 필요 하신 경우, 신규 계정 만드는 법을 클릭해 주세요.
    • 주의사항: 지정된 서버나 VPS에 클라이언트를 설치하셨다면, "localhost"를 귀하의 Server/VPS IP로 변경해 주세요.



Raspberry pi에 Ardor 클라이언트를 설치 하고자 하시는 경우 태양광 패널로 작동하는 Ardor 클라이언트 만들기를 참고 하십시오.


구글 플레이 스토어에선 안드로이드 환경에서 Ardor 클라이언트의 일부 기능만 지원하는 Ardor Lite 지갑 을 다운로드 하실 수 있습니다.

또한 1.11.0e 버젼의 클라이언트 이후론 Android용 모바일 앱으로 클라이언트가 제공되고 있습니다. 모바일 앱은 Apache Cordova 애플리케이션으로 패키지 된 기존 웹 지갑을 기반으로 합니다.

사용편의성

모바일 앱과 웹 지갑의 사용편의성 향상을 위해 아래 사항들이 구현되었습니다.

게졍 ID와 암호문구 모두 QR코드 스캐닝을 지원하도록 Lock Screen이 수정되었습니다.

입력 모드에서 계정 ID, 암호문구, QR코드 스캐닝을 선택 할수 있도록 버튼 그룹이 생성되었습니다.

별도로 존재했던 '계정ID 저장하기'와 '암호문구 저장' 체크박스를 "계정정보 저장하기" 체크 박스 하나로 통합하였습니다. "계정정보 저장하기"를 선택하시면, 디바이스에 암호문구가 함께 저장이 되므로, 사용자가 앱을 실행시키면 자동으로 메인 메뉴를 불러오게 되었습니다. 로그아웃을 선택하시면 암호문구가 디바이스에서 삭제 됩니다.

모든 입력값을 디바이스의 QR 코드 스캐너를 이용해 입력 할 수 있습니다.

모바일 앱은 라이트 클라이언트이기 때문에, 블록체인을 모바일 장치로 다운로드 하지 않습니다. 따라서 설치 즉시 사용 할 수 있습니다.

보안성

앱을 실행하게 되면, 모바일 장치는 앱에 하드코딩된 부트 스트랩 노드 목록에서 해당 시점의 사용 가능한 리모트 노드를 무작위로 선택합니다.

트랜잭션은 디바이스 내에서 서명이 되기 때문에, 암호문구가 장치 밖으로 전송 되지 않습니다.

암호문구를 리모트노드로 전송해야 하는 기능들은 모바일 앱의 기능에서 제외되었습니다.

리모트 노드에 의한 데이터 조작을 방지하기 위해, 특정 리모트 노드에서 반환된 데이터는 다른 리모트 노드를 통해 유효성을 검사합니다. 차이가 발생 할 경우, 툴바에서 데이터의 일관성이 없다고 시각적인 표시를 해 사용자에게 경고하게 됩니다. 이는 블록체인이 다운로드되는 동안 로밍 클라이언트나 라이트 클라이언트가 사용하는 것과 동일한 매커니즘입니다.

https를 지원하는 대부분의 리모트 노드는 모바일 앱에서 사용 할 수 없는 자체 서명된 인증서를 사용하기 때문에, 리모트 노드와의 통신엔 상대적으로 덜 안전한 http가 사용됩니다.

신규 위젯

모바일 앱을 실행할때, 잠금 설정 화면과 시작화면에 "환경설정" 메뉴가 표시됩니다. 톱니 바퀴 메뉴에서도 "환경설정" 메뉴를 확인 할 수 있습니다.

사용자 환경설정

환경설정 메뉴를 통해 사용자는 다음 설정들을 할 수 있습니다 :

"'계정 기억하기 체크박스'" - '계정 기억하기'의 기본 설정을 지정 할 수 있습니다.(이 설정은 기존에 있었으나, 1.5버젼 이후엔 작동하지 않았었습니다.)

"'모바일앱 시뮬레이션'" - 웹 지갑이 피어 선택 및 다른 기능과 관련한 모바일앱을 시뮬레이션 할 수 있습니다. 이 설정은 개발 및 문제 해결에만 사용해야 하며, 모바일 앱 실행 중에는 표시되지 않습니다.

"'테스트넷 연결'" - 이 옵션을 선택하면 모바일 장치가 메인넷 노드 대신 테스트넷 노드에 연결하게 됩니다. 테스트넷 모드는 테스트 및 데모 목적으로 사용 할 수 있습니다.

"'리모트 노드 주소, 리모트 노드 포트, Https 사용'" - 임의의 퍼블릭 노드에 의존 하는 것이 목적에 맞지 않을 때 신뢰 할 수 있는 퍼블릭 노드를 알고 있는 경우 주소를 구성 할 수 있습니다. 이때 이 메뉴를 통해 해당 노드의 주소, 포트, 프로토콜을 선택 할 수 있습니다. 리모트 노드가 CA로부터 승인된 SSL인증서를 지원하는 경우 Https를 통해 통신을 할 수도 있습니다.

"'데이터 유효성 검사 노드수'" - 유효성 검사를 수행 할 리모트 노드의 수를 지정하는 기능입니다. 기본적으로 클라이언트는 3개의 랜덤 노드를 사용하며 신뢰할 수 있는 원격 노드에 연결된 경우, 이 값을 0으로 줄일 수 있습니다.

"'부트 스트랩 노드 수'" - 연결된 노드와 데이터 유효성을 검사할 노드 수입니다. 이러한 노드는 추가 원격노드를 얻기 위해 필요 합니다.

데이터 검증

앱이 연결된 임의의 리모트 노드가 앱에 허위 또는 악의적인 데이터를 제공하지 않도록 하기 위해, 리모트 노드에 전송된 정보는 최대 3개의 추가 리모트 노드를 통해 검증됩니다. 검증 상태는 "모바일 클라이언트" 상태 단추의 오른쪽에 녹색/노란색/빨간색 색상의 아이콘으로 표시됩니다. 빨강색의 아이콘은 연결된 리모트 노드가 손상되었다는 것을 뜻합니다.

"모바일 클라이언트" 링크를 클릭하면 리모트 노드의 최신 요청 목록과 유효성 검사 상태를 확인 할 수 있습니다.

경우에 따라, 유효성 검증 실패는 신규 트랜잭션이 네트워크에 전파되는 동안 일시적으로 나타 날 수 있는 일반적인 현상입니다. 따라서, 이를 유념하셔서 데이터 유효성 상태를 판단 하십시오.

모바일 앱 테스트

앱을 사용하고자 하는 유저는 다음과 같은 옵션을 선택 할 수 있습니다 :

1. BitBucket 에 업로드된 앱을 직접 디바이스에 다운받아 설치

2. 이메일을 이용해 Ionic에 계정을 생성한 다음 모바일 장치에서 Ionic View 응용프로그램을 설치하고 이메일 주소를 개발자에게 보내주십시오. 개발자가 응용프로그램을 공유한 이후, ionic 보기 옵선 메뉴에서 "응용프로그램 미리보기"를 선택하고 응용프로그램 ID ec170f70를 선택 하시면 됩니다.


도움이 필요하신가요?

다운로드 하거나 개발과정 중에 도움이 필요하신가요? 4가지 채널을 통해 도움을 드리고 있습니다 : slack #helpdesk 채널, Ardor Forum, FAQ, helpdesk


네트워크 사용을 위해 ARDR가 필요 하다면?

Ardor 클라이언트가 설치되었다면, 이제 첫 트랜잭션을 만들어 볼 차례입니다. 이렇게 하려면 ARDR, IGNIS 또는 다른 차일드 체인 토큰을 보유해야 합니다. Ardor 메인넷에 있는 토큰들은 실제 가치를 지닌 토큰들이며, 현재 많은 거래소를 통해 유통되고 있습니다.

앞으로 만나 볼 예제에서 만나볼 토큰들은 Testnet에서 사용하는 것들입니다. 이러한 토큰은 거래소에서 거래되지 않으며 금전적인 가치가 없습니다. Testnet에서의 토큰은 개발자/사용자가 기능을 실험해 볼수 있도록 편의를 위해 제공되고 있습니다.

Testnet 토큰을 수령하시려면 Ardor Forum이나 slack #helpdesk 채널에 문의 또는 faucet 에서 받으 실 수 있습니다.


거래소


다음 단계

기본 튜토리얼을 따라해 보거나 Ardor의 built-in 기능들에 대한 자료를 읽어 보면서 Ardor Platform을 사용 하는 법에 대해 배워보세요.


피드백

혹시 이 문서들에 오류가 있다면 최대한 빨리 바로잡도록 하겠습니다. 오류사항이나 질문이 있으시다면 stackexchange 로 연락 주십시오. 가능한 빨리 답변 드리도록 하겠습니다.