bitcoinj

ยินดีต้อนรับสู่ bitcoinj

ไลบรารี bitcoinj เป็นการใช้งาน Java ของโปรโตคอล Bitcoin ซึ่งช่วยให้สามารถรักษากระเป๋าเงินและส่ง / รับธุรกรรมโดยไม่จำเป็นต้องใช้สำเนา Bitcoin Core ในเครื่อง มาพร้อมกับเอกสารฉบับเต็มและแอปตัวอย่างบางส่วนที่แสดงวิธีใช้งาน

เทคโนโลยี

• Java 8+ (ต้องการ Java 8 API หรือ Android 8.0 API, คอมไพล์เป็น Java 8 bytecode) สำหรับโมดูล base และ core

• Java 17+ สำหรับ tools , wallettool examples และ wallettemplate ที่ใช้ JavaFX

• เกรเดิล

  • Gradle 7.3+ สำหรับการสร้างทั้งโครงการหรือ

  • Debian Gradle 4.4 สำหรับโมดูล base , core , tools , wallettool และ examples เท่านั้น (ดู "บิลด์อ้างอิง" ด้านล่าง)

• Google Protocol Buffers - สำหรับใช้กับการสื่อสารแบบซีเรียลไลซ์และฮาร์ดแวร์

เริ่มต้นใช้งาน

ในการเริ่มต้น วิธีที่ดีที่สุดคือติดตั้ง JDK และ Gradle ล่าสุด HEAD ของสาขา master ประกอบด้วยโค้ดการพัฒนาล่าสุด และมีการเผยแพร่เวอร์ชันที่ใช้งานจริงต่างๆ ในฟีเจอร์สาขา

การสร้างจากบรรทัดคำสั่ง

ขณะนี้งานสร้างอย่างเป็นทางการใช้ JDK 17 GitHub Actions ของเราสร้างและทดสอบด้วย JDK 17 และ 21

 gradle clean build

ผลลัพธ์อยู่ภายใต้ไดเร็กทอรี build

หากต้องการดำเนินการสร้างแบบเต็ม โดยไม่มี การทดสอบ หน่วย/การรวมระบบ ให้ใช้:

 gradle clean assemble 

การสร้างจาก IDE

หรือเพียงนำเข้าโครงการโดยใช้ IDE ของคุณ IntelliJ มีการผสานรวม Gradle ในตัวและมี Community Edition ฟรี เพียงใช้ File | New | Project from Existing Sources และค้นหา build.gradle ในรูทของแผนผังซอร์สโปรเจ็กต์ที่โคลน

การสร้างและการใช้เครื่องมือ Wallet

โครงการย่อย bitcoinj wallettool ประกอบด้วยเครื่องมือ Wallet บรรทัดคำสั่ง ( wallet-tool ) ที่สามารถใช้เพื่อสร้างและจัดการกระเป๋าเงินที่ใช้ bitcoinj (ทั้งพวงกุญแจ HD และสถานะบล็อคเชน SPV) การใช้ wallet-tool บนเครือข่ายทดสอบของ Bitcoin นั้นยอดเยี่ยมมาก วิธีการเรียนรู้เกี่ยวกับ Bitcoin และ bitcoinj

หากต้องการสร้างเชลล์สคริปต์ปฏิบัติการที่รันเครื่องมือ Wallet บรรทัดคำสั่ง ให้ใช้:

 gradle bitcoinj-wallettool:installDist

ตอนนี้คุณสามารถรัน wallet-tool โดยไม่ต้องใช้พารามิเตอร์เพื่อรับความช่วยเหลือในการดำเนินการ:

 ./wallettool/build/install/wallet-tool/bin/wallet-tool

หากต้องการสร้างไฟล์ test net wallet ใน ~/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 กับ test net คุณจะต้องใช้:

 ./wallettool/build/install/wallet-tool/bin/wallet-tool --net=TESTNET --wallet=$HOME/bitcoinj/bitcoinj-test.wallet sync

หากต้องการถ่ายโอนสถานะของกระเป๋าเงินใน ~/bitcoinj/bitcoinj-test.wallet ด้วย test net คุณจะต้องใช้:

 ./wallettool/build/install/wallet-tool/bin/wallet-tool --net=TESTNET --wallet=$HOME/bitcoinj/bitcoinj-test.wallet dump 

บันทึก

คำแนะนำเหล่านี้ใช้สำหรับ macOS/Linux สำหรับ Windows ให้ใช้ไฟล์แบตช์ wallettool/build/install/wallet-tool/bin/wallet-tool.bat พร้อมด้วยคำสั่งและตัวเลือกบรรทัดคำสั่ง Windows ที่เทียบเท่ากัน

การสร้างบิลด์อ้างอิง

รุ่นอ้างอิงของเรา (ซึ่งใช้สำหรับรุ่นของเราด้วย) กำลังทำงานภายในคอนเทนเนอร์เพื่อให้สามารถทำซ้ำได้ดี รองรับ Buildah 1.26+, Podman 4.1+ และ Docker (พร้อม BuildKit) เราทดสอบการผสมผสานระบบปฏิบัติการโฮสต์ต่างๆ (Debian, Ubuntu, macOS, Windows+WSL) และสถาปัตยกรรม (amd64, arm64) สำหรับคำแนะนำการใช้งาน โปรดดูที่ build.Containerfile

สิ่งนี้ใช้ Debian Gradle กับการตั้ง settings-debian.gradle หากคุณบังเอิญใช้ Debian และติดตั้ง Gradle จากที่เก็บ Debian คุณสามารถเรียกใช้การตั้งค่าเหล่านี้ได้โดยตรง:

 gradle --settings-file settings-debian.gradle clean build

ตัวอย่างการใช้งาน

พบสิ่งเหล่านี้ได้ในโมดูล examples

ที่ไหนต่อไป?

ตอนนี้คุณพร้อมที่จะปฏิบัติตามบทช่วยสอนแล้ว

การทดสอบบิลด์ SNAPSHOT

การสร้างแอปด้วยการเปิดตัว bitcoinj อย่างเป็นทางการมีกล่าวถึงในบทช่วยสอน

หากคุณต้องการพัฒนาหรือทดสอบแอปของคุณด้วยบิลด์ที่ขับเคลื่อนด้วย Jitpack ของ master ล่าสุดหรือสาขา release-0.17 ของ bitcoinj ให้ทำตามคำแนะนำที่สร้างขึ้นแบบไดนามิกสำหรับสาขานั้นโดยไปตามลิงก์ที่ถูกต้อง

• สาขาหลัก

• ปล่อย-0.17 สาขา