txnbuild

txnbuild is a Hcnet SDK, implemented in Go. It provides a reference implementation of the complete set of operations that compose transactions for the Hcnet distributed ledger.

This project is maintained by the Hcnet Development Foundation.

    import (
        "log"
        
        "github.com/shantanu-hashcash/go/clients/auroraclient"
        "github.com/shantanu-hashcash/go/keypair"
        "github.com/shantanu-hashcash/go/network"
        "github.com/shantanu-hashcash/go/txnbuild"
    )
    
    // Make a keypair for a known account from a secret seed
    kp, _ := keypair.Parse("SBPQUZ6G4FZNWFHKUWC5BEYWF6R52E3SEP7R3GWYSM2XTKGF5LNTWW4R")
    
    // Get the current state of the account from the network
    client := auroraclient.DefaultTestNetClient
    ar := auroraclient.AccountRequest{AccountID: kp.Address()}
    sourceAccount, err := client.AccountDetail(ar)
    if err != nil {
        log.Fatalln(err)
    }
    
    // Build an operation to create and fund a new account
    op := txnbuild.CreateAccount{
        Destination: "GCCOBXW2XQNUSL467IEILE6MMCNRR66SSVL4YQADUNYYNUVREF3FIV2Z",
        Amount:      "10",
    }
    
    // Construct the transaction that holds the operations to execute on the network
    tx, err := txnbuild.NewTransaction(
        txnbuild.TransactionParams{
            SourceAccount:        &sourceAccount,
            IncrementSequenceNum: true,
            Operations:           []txnbuild.Operation{&op},
            BaseFee:              txnbuild.MinBaseFee,
            Timebounds:           txnbuild.NewTimeout(300),
        },
    )
    if err != nil {
        log.Fatalln(err)
    )
    
    // Sign the transaction
    tx, err = tx.Sign(network.TestNetworkPassphrase, kp.(*keypair.Full))
    if err != nil {
        log.Fatalln(err)
    )
    
    // Get the base 64 encoded transaction envelope
    txe, err := tx.Base64()
    if err != nil {
        log.Fatalln(err)
    }
    
    // Send the transaction to the network
    resp, err := client.SubmitTransactionXDR(txe)
    if err != nil {
        log.Fatalln(err)
    }

Getting Started

This library is aimed at developers building Go applications on top of the Hcnet network. Transactions constructed by this library may be submitted to any Aurora instance for processing onto the ledger, using any Hcnet SDK client. The recommended client for Go programmers is auroraclient. Together, these two libraries provide a complete Hcnet SDK.

• The txnbuild API reference.
• The auroraclient API reference.

An easy-to-follow demonstration that exercises this SDK on the TestNet with actual accounts is also included! See the Demo section below.

Prerequisites

• Go (this repository is officially supported on the last two releases of Go)
• Modules to manage dependencies

Installing

• go get github.com/shantanu-hashcash/go/txnbuild

Running the tests

Run the unit tests from the package directory: go test

Demo

To see the SDK in action, build and run the demo:

• Enter the demo directory: cd $GOPATH/src/github.com/shantanu-hashcash/go/txnbuild/cmd/demo
• Build the demo: go build
• Run the demo: ./demo init

Contributing

Please read Code of Conduct to understand this project's communication rules.

To submit improvements and fixes to this library, please see CONTRIBUTING.

License

This project is licensed under the Apache License - see the LICENSE file for details.