코코넛 볼트 ・ Coconut Vault

코코넛 볼트는 에어갭 환경에서 동작하는 콜드 월렛으로, 니모닉 문구를 안전하게 관리하고 트랜잭션에 서명을 해요.

볼트는 "데이터, 와이파이, 블루투스" 등의 네트워크에 연결되어 있거나 개발자 모드가 켜져있을 때는 동작하지 않아요.

비트코인 전송을 연습하기 위해서는 코코넛 월렛을 다른 휴대폰에 설치하고 튜토리얼 사이트를 참고해서 차례로 진행해주세요.

비트코인 지갑 개발을 위한 라이브러리로 코코넛 라이브러리를 사용하고 있어요.

coconut_lib
coconut_vault
coconut_wallet

개발환경 설정 및 실행

개발환경 설정

1. 이 프로젝트는 Flutter로 만들어졌습니다. 코드를 통해 앱을 실행하기 위해서는 컴퓨터에 Flutter 개발환경이 반드시 갖추어져 있어야 합니다.

2. 버전 확인

   flutter --version

   # 스토어에 배포된 버전입니다.
   Flutter 3.24.3 • channel stable • https://github.com/flutter/flutter.git
   Framework • revision 2663184aa7 (7 weeks ago) • 2024-09-11 16:27:48 -0500
   Engine • revision 36335019a8
   Tools • Dart 3.5.3 • DevTools 2.37.3
   

3. 자동 생성 파일 준비

      dart pub run build_runner clean && dart pub run build_runner build --delete-conflicting-outputs && dart pub run slang

실행하기

1. 앱을 실행할 모바일 기기 또는 시뮬레이터 준비하기

2. 소스코드 다운로드

   git clone https://github.com/noncelab/coconut_vault.git
   cd coconut_vault

3. 플러터 플러그인 설치

   flutter pub get

4. IDE debug mode 실행시 Default flavor 설정

   • Android Studio or IntelliJ
     • Run -> Edit Configurations... -> Build Flavor에 regtest 입력
   • Visual Studio Code
     • .vscode/launch.json 내부에 args 항목을 추가합니다.

       {
         "name": "coconut_vault (debug)",
         "request": "launch",
         "type": "dart",
         "args": ["--flavor", "regtest"]
       }

5. 터미널 실행 가이드

   # debug mode
   flutter run --flavor regtest
   
   # release mode
   flutter run --release --flavor regtest

   디버깅 모드로 실행하려면 휴대폰 개발자 모드를 끌 수 없어요❗

   debug mode로 실행시에는 네트워크와 블루투스 연결이 해제되었는지만 검사하고, 개발자 모드가 켜져있는 것은 검사하지 않도록 구현해놨습니다.

   하지만 release mode로 실행시에는 휴대폰의 개발자 모드까지 꺼져있어야만 사용이 가능합니다.

   
   

   flavor 옵션은 왜 설정해야 하나요❓

   현재 코코넛 볼트와 코코넛 월렛 프로젝트는 저희 팀이 직접 구축한 로컬 비트코인 테스트넷 (regtest)을 사용합니다.

   그렇기 때문에 여러분이 코코넛 월렛에서 테스트용 비트코인을 바로 받아보고, 전송 연습을 하실 수 있는 것이죠.

   만약 원하시는 분들이 많아진다면, 비트코인 mainnet 네트워크용 코코넛 볼트와 월렛도 지원할 예정이기 때문에 미리 flavor를 적용해서, 동일한 코드베이스에서 여러 환경에 맞는 앱을 빌드하고 배포할 준비를 해놓았습니다.

   현재는 regtest flavor만 설정해 놓은 상태입니다.

기여하기

자세한 사항은 CONTRIBUTING을 참고해주세요.

• Issues를 통해 버그를 보고하기
• Pull Request를 통해
  • 새로운 기능을 추가하기
  • 문서를 업데이트하거나 예제를 추가하기
  • 오타나 문법 오류를 수정하기

라이선스

X11 Consortium License (MIT와 같고 저작권자 이름을 홍보에 사용할 수 없다는 제약이 추가된 라이선스입니다.)

자세한 사항은 LICENSE를 참고해주세요.

Dependencies

사용하는 라이브러리들은 MIT, BSD, Apache 중 하나의 라이선스로 설정되어 있으며 상세 내용은 이 링크를 참고해주세요.