bitcoinj 라이브러리는 Bitcoin 프로토콜의 Java 구현으로, Bitcoin Core의 로컬 사본 없이도 지갑을 유지하고 거래를 보내고 받을 수 있습니다. 전체 문서와 사용 방법을 보여주는 몇 가지 예제 앱이 함께 제공됩니다.
base
및 core
모듈용 Java 8+(Java 8 API 또는 Android 8.0 API 필요, Java 8 바이트코드로 컴파일)
tools
, wallettool
, examples
및 JavaFX 기반 wallettemplate
위한 Java 17+
그래들
전체 프로젝트를 빌드하려면 Gradle 7.3+ 또는
base
, core
, tools
, wallettool
및 examples
모듈용 Debian Gradle 4.4(아래 "참조 빌드" 참조)
Google 프로토콜 버퍼 - 직렬화 및 하드웨어 통신에 사용
시작하려면 최신 JDK 및 Gradle을 설치하는 것이 가장 좋습니다. master
브랜치의 HEAD에는 최신 개발 코드가 포함되어 있으며 기능 브랜치에서는 다양한 프로덕션 릴리스가 제공됩니다.
공식 빌드는 현재 JDK 17을 사용하고 있습니다. GitHub Actions는 JDK 17 및 21을 사용하여 빌드하고 테스트합니다.
gradle clean build
출력은 build
디렉터리 아래에 있습니다.
단위/통합 테스트 없이 전체 빌드를 수행하려면 다음을 사용하세요.
gradle clean assemble
또는 IDE를 사용하여 프로젝트를 가져오세요. IntelliJ에는 Gradle 통합 기능이 내장되어 있으며 무료 Community Edition이 있습니다. 간단히 File | New | Project from Existing Sources
하고 복제된 프로젝트 소스 트리의 루트에서 build.gradle
을 찾습니다.
bitcoinj wallettool
하위 프로젝트에는 bitcoinj 기반 지갑(HD 키체인 및 SPV 블록체인 상태 모두)을 생성하고 관리하는 데 사용할 수 있는 명령줄 지갑 도구( wallet-tool
)가 포함되어 있습니다. Bitcoin의 테스트 넷에서 wallet-tool
사용하는 것은 매우 좋습니다. Bitcoin과 bitcoinj 에 대해 배우는 방법.
명령줄 Wallet 도구를 실행하는 실행 가능한 셸 스크립트를 빌드하려면 다음을 사용하세요.
gradle bitcoinj-wallettool:installDist
이제 매개변수 없이 wallet-tool
실행하여 작업에 대한 도움을 받을 수 있습니다.
./wallettool/build/install/wallet-tool/bin/wallet-tool
~/bitcoinj/bitcoinj-test.wallet
에 테스트 넷 지갑 파일을 생성하려면 다음을 사용합니다.
mkdir ~/bitcoinj
./wallettool/build/install/wallet-tool/bin/wallet-tool --net=TESTNET --wallet=$HOME/bitcoinj/bitcoinj-test.wallet create
~/bitcoinj/bitcoinj-test.wallet
에 새로 생성된 지갑을 테스트 넷과 동기화하려면 다음을 사용합니다.
./wallettool/build/install/wallet-tool/bin/wallet-tool --net=TESTNET --wallet=$HOME/bitcoinj/bitcoinj-test.wallet sync
테스트 넷을 사용하여 ~/bitcoinj/bitcoinj-test.wallet
의 지갑 상태를 덤프하려면 다음을 사용합니다.
./wallettool/build/install/wallet-tool/bin/wallet-tool --net=TESTNET --wallet=$HOME/bitcoinj/bitcoinj-test.wallet dump
메모 | 이 지침은 macOS/Linux용이며, Windows의 경우 동등한 Windows 명령줄 명령 및 옵션과 함께 wallettool/build/install/wallet-tool/bin/wallet-tool.bat 배치 파일을 사용하세요. |
우리의 참조 빌드(릴리스에도 사용됨)는 좋은 재현성을 제공하기 위해 컨테이너 내에서 실행됩니다. Buildah 1.26+, Podman 4.1+ 및 Docker(BuildKit 포함)가 지원됩니다. 우리는 호스트 OS(Debian, Ubuntu, macOS, Windows+WSL)와 아키텍처(amd64, arm64)의 다양한 조합을 테스트했습니다. 사용법 지침은 build.Containerfile
참조하세요.
이는 settings-debian.gradle
설정과 함께 Debian Gradle을 사용합니다. Debian을 사용하고 Debian 저장소에서 Gradle을 설치한 경우 다음 설정을 직접 호출할 수 있습니다.
gradle --settings-file settings-debian.gradle clean build
이는 examples
모듈에서 찾을 수 있습니다.
이제 튜토리얼을 따라갈 준비가 되었습니다.
Bitcoinj 의 공식 릴리스로 앱을 구축하는 방법은 튜토리얼에서 다룹니다.
최신 master
또는 release-0.17
브랜치 의 Jitpack 기반 빌드로 앱을 개발하거나 테스트하려면 올바른 링크를 따라 해당 브랜치에 대해 동적으로 생성된 지침을 따르세요.
마스터 브랜치
release-0.17 분기