BSV BLOCKCHAIN | Software Development Kit for Go

Welcome to the BSV Blockchain Libraries Project, the comprehensive Go SDK designed to provide an updated and unified layer for developing scalable applications on the BSV Blockchain. This SDK addresses the limitations of previous tools by offering a fresh, peer-to-peer approach, adhering to SPV, and ensuring privacy and scalability.

Table of Contents

• BSV BLOCKCHAIN | Software Development Kit for Go
  • Table of Contents
  • Objective
  • Getting Started
    • Installation
    • Basic Usage
    • Examples
  • Features & Deliverables
  • Documentation
  • Contribution Guidelines
  • Support & Contacts
  • License

Objective

The BSV Blockchain Libraries Project aims to structure and maintain a middleware layer of the BSV Blockchain technology stack. By facilitating the development and maintenance of core libraries, it serves as an essential toolkit for developers looking to build on the BSV Blockchain.

Getting Started

Installation

To install the SDK, run:

go install github.com/bitcoin-sv/go-sdk

Basic Usage

Here's a simple example of using the SDK to create and sign a transaction:

package main

import (
	"context"
	"log"

	"github.com/bitcoin-sv/go-sdk/ec/wif"
	"github.com/bitcoin-sv/go-sdk/transaction"
	"github.com/bitcoin-sv/go-sdk/transaction/unlocker"
)

func main() {
	tx := transaction.NewTx()

	_ = tx.From(
		"11b476ad8e0a48fcd40807a111a050af51114877e09283bfa7f3505081a1819d",
		0,
		"76a914eb0bd5edba389198e73f8efabddfc61666969ff788ac6a0568656c6c6f",
		1500,
	)

	_ = tx.PayToAddress("1AdZmoAQUw4XCsCihukoHMvNWXcsd8jDN6", 1000)

	decodedWif, _ := wif.DecodeWIF("KzH8frNSgsKtmPQ2oMFnwD3DK347PY3YJUzE1dCKNKLaWSfHaXGC")

	if err := tx.FillAllInputs(context.Background(), &unlocker.Getter{PrivateKey: decodedWif.PrivKey}); err != nil {
		log.Fatal(err.Error())
	}
	log.Printf("tx: %s\n", tx)
}

See the Go Doc for a complete list of available modules and functions.

Examples

Check out the examples folder for more advanced examples.

Features & Deliverables

• Sound Cryptographic Primitives: Secure key management, signature computations, and encryption protocols.
• Script Level Constructs: Network-compliant script interpreter with support for custom scripts and serialization formats.
• Transaction Construction and Signing: Comprehensive transaction builder API, ensuring versatile and secure transaction creation.
• Transaction Broadcast Management: Mechanisms to send transactions to both miners and overlays, ensuring extensibility and future-proofing.
• Merkle Proof Verification: Tools for representing and verifying merkle proofs, adhering to various serialization standards.
• Serializable SPV Structures: Structures and interfaces for full SPV verification.
• Secure Encryption and Signed Messages: Enhanced mechanisms for encryption and digital signatures, replacing outdated methods.

Documentation

The SDK is richly documented with code-level annotations. This should show up well within editors like VSCode. For complete API docs, check out the Go Doc. Please refer to the Libraries Wiki (link to be provided) for a deep dive into each feature, tutorials, and usage examples.

Contribution Guidelines

We're always looking for contributors to help us improve the SDK. Whether it's bug reports, feature requests, or pull requests - all contributions are welcome.

1. Fork & Clone: Fork this repository and clone it to your local machine.
2. Set Up: Run go get github.com/bitcoin-sv/go-sdk to get all the modules.
3. Make Changes: Create a new branch and make your changes.
4. Test: Ensure all tests pass by running go test ./....
5. Commit: Commit your changes and push to your fork.
6. Pull Request: Open a pull request from your fork to this repository.

For more details, check the contribution guidelines.

For information on past releases, check out the changelog. For future plans, check the roadmap!

Support & Contacts

Project Owners: Thomas Giacomo and Darren Kellenschwiler

Development Team Lead: TBD

For questions, bug reports, or feature requests, please open an issue on GitHub or contact us directly.

License

The license for the code in this repository is the Open BSV License. Refer to LICENSE.txt for the license text.

Thank you for being a part of the BSV Blockchain Libraries Project. Let's build the future of BSV Blockchain together!