코코넛 월렛 ・ Coconut Wallet

비트코인을 주고 받기 위해 코코넛 볼트와 쌍으로 사용하는 모바일 애플리케이션이에요.

현재는 개발팀이 직접 구축한 '로컬 테스트넷 비트코인 네트워크'와 연결해서 사용하실 수 있어요.

휴대폰 두 대를 사용한다는 가정 하에 하나의 폰에는 코코넛 볼트를 설치하고, '내보내기'메뉴의 QR 코드를 월렛으로 스캔해야만 보기 전용(watch-only) 지갑이 추가돼요.

월렛은 온라인 상태를 유지하여 지갑의 정보를 최신으로 유지하고, 서명된 트랜잭션을 비트코인 네트워크로 전송해요.

테스트 비트코인을 받아서 코코넛 볼트와 함께 에어갭 트랜잭션 전송 연습을 할 수 있어요.

더 상세한 설명이 필요하시면 튜토리얼 사이트를 참고해주세요.

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

coconut_lib
coconut_vault
coconut_wallet

개발환경 설정 및 실행

개발환경 설정

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

2. 이 프로젝트는 'flutter_dotenv' 라이브러리를 통해 설정한 환경변수가 있어야 정상 동작합니다. 현재 비트코인 Regtest(로컬 테스트넷) 환경변수가 준비되어 있으나 오픈소스로 공개해 두지는 않았습니다. 개발 환경에서 직접 코코넛 월렛을 구동하기 위해 환경변수 파일이 필요하신 분은 포우팀으로 연락주시면 언제든지 답변 드리겠습니다. hello@noncelab.com

3. 버전 확인

   flutter --version

   # 스토어에 배포된 버전입니다.
   Flutter 3.29.1 • channel stable • https://github.com/flutter/flutter.git
   Framework • revision 09de023485 (11 months ago) • 2025-02-28 13:44:05 -0800
   Engine • revision 871f65ac1b
   Tools • Dart 3.7.0 • DevTools 2.42.2

4. 자동 생성 파일 준비

   flutter pub run build_runner clean # realm generate 오류 발생 시 캐시 삭제
   
   dart run build_runner build --delete-conflicting-outputs
   
   dart run realm generate
   
   flutter pub run slang
   
   # or
   dart run build_runner clean && dart run build_runner build --delete-conflicting-outputs && dart run realm generate && flutter pub run slang

실행하기

1. 포우팀에게 문의하여 환경변수 파일 준비하기

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

3. 소스코드 다운로드

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

4. 플러터 플러그인 설치

   flutter pub get

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

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

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

6. 로컬 키스토어(Keystore) 설정

   android/app/build.gradle 설정에 의해, 앱을 실행하려면 각 환경(flavor)에 맞는 속성 파일(key_*.properties)이 반드시 존재해야 합니다.

   로컬 개발 환경에서는 환경 설정을 위해 임의로 생성한 키스토어(local.jks)를 생성하여 설정합니다.

   키스토어 생성하기 터미널에서 프로젝트 최상위 경로(root)로 이동 후 아래 명령어를 실행하여 android/app/local.jks 파일을 생성합니다.

   keytool -genkey -v -keystore android/app/local.jks -storepass android -alias local -keypass android -keyalg RSA -keysize 2048 -validity 10000 -dname "CN=Local Dev,O=Coconut,C=KR"

   속성 파일(Properties) 생성하기 android/ 폴더 아래에 key_regtest.properties와 key_mainnet.properties 파일을 각각 생성하고, 아래 내용을 똑같이 작성합니다.

   storePassword=android
   keyPassword=android
   keyAlias=local
   storeFile=../app/local.jks

7. 터미널 실행 가이드

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

   
   

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

   코코넛 월렛은 용도에 따라 두 가지 버전을 제공합니다.

   mainnet: 실제 비트코인 메인넷을 사용하는 정식 출시 버전입니다. 스토어를 통해 무료로 제공되며, 실제 자산을 관리할 때 사용합니다.

   regtest: 로컬 테스트넷 환경을 사용하는 학습용 버전입니다. 코코넛 볼트와 연동하여 가상의 비트코인으로 전송 과정을 무료로 연습해볼 수 있습니다.

   ⚠️ Mainnet 임의 빌드 시 주의사항

   공식 배포 채널(앱스토어/플레이스토어)이 아닌 방법으로 소스 코드를 직접 빌드하여 Mainnet 환경에서 사용하는 경우, 발생할 수 있는 자산 손실이나 오류에 대해 회사는 일체 책임을 지지 않습니다. 개발 및 학습 목적으로는 반드시 regtest 모드를 사용해 주세요.

기여하기

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

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

라이선스

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

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

Dependencies

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