cosmosign

Cosmosign

Cosmosign is a lightweight Go library for signing and broadcasting transactions to Cosmos blockchains.

Installation

go get github.com/shapeshed/cosmosign

Quickstart

package main

import (
	"log"

	"github.com/cosmos/cosmos-sdk/types"
	banktypes "github.com/cosmos/cosmos-sdk/x/bank/types"
	cosmosign "github.com/shapeshed/cosmosign"
	"google.golang.org/grpc"
	"google.golang.org/grpc/credentials/insecure"

)

func main() {
	conn, err := grpc.NewClient("localhost:1919", grpc.WithTransportCredentials(insecure.NewCredentials()))
	if err != nil {
		log.Fatalf("Failed to initialise grpc connection: %v", err)
		return
	}

	cs, err := cosmosign.NewClient(
		cosmosign.WithGRPCConn(conn),
		cosmosign.WithGasPrices("0.0ustake"),
		cosmosign.WithKeyringBackend("pass"),
		cosmosign.WithKeyringRootDir("/home/cosmos/"),
		cosmosign.WithKeyringUID("account1"),
	)
	if err != nil {
		log.Fatalf("Failed to initialise cosmosign: %v", err)
	}

	fromAddress := "cosmos1..."
	toAddress := "cosmos1..."
	amount, err := types.ParseCoinsNormalized("1000ustake")
	if err != nil {
		log.Fatalf("Failed to parse amount: %v", err)
	}

	msg := banktypes.NewMsgSend(fromAddress, toAddress, amount)

	res, err := cs.SendMessages(msg)
	if err != nil {
		log.Fatalf("Failed to send transaction: %v", err)
	}

	if res.TxResponse.Code == 0 {
		log.Printf("Transaction successful, hash: %s", res.TxResponse.TxHash)
	} else {
		log.Printf("Transaction failed, code: %d, log: %s", res.TxResponse.Code, res.TxResponse.RawLog)
	}
}

Options

You may pass an arbitrary number of options when creating the cosmosign client. Each option has a default value, but you may override them using the available With methods.

Updating an existing client

Options can be updated on an instantiated client.

err = cs.ApplyOptions(
    cosmosign.WithKeyringUID("another-signer"),
    cosmosign.WithGasMulplier(2.0),
    cosmosign.WithGasPrices("0.025ustake"),
    cosmosign.WithMemo("doge ftw"),
)

License

This project is licensed under the Apache License, Version 2.0. See the LICENSE file for more details.