package main import ( "bufio" "encoding/hex" "errors" "fmt" "io" "os" "os/exec" "strings" abcicli "github.com/tendermint/abci/client" "github.com/tendermint/abci/example/counter" "github.com/tendermint/abci/example/dummy" "github.com/tendermint/abci/server" "github.com/tendermint/abci/types" cmn "github.com/tendermint/tmlibs/common" "github.com/tendermint/tmlibs/log" "github.com/spf13/cobra" ) // Structure for data passed to print response. type response struct { // generic abci response Data []byte Code types.CodeType Log string Query *queryResponse } type queryResponse struct { Key []byte Value []byte Height uint64 Proof []byte } // client is a global variable so it can be reused by the console var client abcicli.Client var logger log.Logger // flags var ( // global address string abci string verbose bool // query path string height int prove bool // counter addrC string serial bool // dummy addrD string persist string ) var RootCmd = &cobra.Command{ Use: "abci-cli", Short: "", Long: "", PersistentPreRunE: func(cmd *cobra.Command, args []string) error { switch cmd.Use { // for the examples apps, don't pre-run case "counter", "dummy": return nil } if logger == nil { logger = log.NewFilter(log.NewTMLogger(log.NewSyncWriter(os.Stdout)), log.AllowError()) } if client == nil { var err error client, err = abcicli.NewClient(address, abci, false) if err != nil { return err } client.SetLogger(logger.With("module", "abci-client")) if _, err := client.Start(); err != nil { return err } } return nil }, } func Execute() { addGlobalFlags() addCommands() RootCmd.Execute() } func addGlobalFlags() { RootCmd.PersistentFlags().StringVarP(&address, "address", "", "tcp://127.0.0.1:46658", "Address of application socket") RootCmd.PersistentFlags().StringVarP(&abci, "abci", "", "socket", "Either socket or grpc") RootCmd.PersistentFlags().BoolVarP(&verbose, "verbose", "v", false, "Print the command and results as if it were a console session") } func addQueryFlags() { queryCmd.PersistentFlags().StringVarP(&path, "path", "", "/store", "Path to prefix query with") queryCmd.PersistentFlags().IntVarP(&height, "height", "", 0, "Height to query the blockchain at") queryCmd.PersistentFlags().BoolVarP(&prove, "prove", "", false, "Whether or not to return a merkle proof of the query result") } func addCounterFlags() { counterCmd.PersistentFlags().StringVarP(&addrC, "addr", "", "tcp://0.0.0.0:46658", "Listen address") counterCmd.PersistentFlags().BoolVarP(&serial, "serial", "", false, "Enforce incrementing (serial) transactions") } func addDummyFlags() { dummyCmd.PersistentFlags().StringVarP(&addrD, "addr", "", "tcp://0.0.0.0:46658", "Listen address") dummyCmd.PersistentFlags().StringVarP(&persist, "persist", "", "", "Directory to use for a database") } func addCommands() { RootCmd.AddCommand(batchCmd) RootCmd.AddCommand(consoleCmd) RootCmd.AddCommand(echoCmd) RootCmd.AddCommand(infoCmd) RootCmd.AddCommand(setOptionCmd) RootCmd.AddCommand(deliverTxCmd) RootCmd.AddCommand(checkTxCmd) RootCmd.AddCommand(commitCmd) addQueryFlags() RootCmd.AddCommand(queryCmd) // examples addCounterFlags() RootCmd.AddCommand(counterCmd) addDummyFlags() RootCmd.AddCommand(dummyCmd) } var batchCmd = &cobra.Command{ Use: "batch", Short: "Run a batch of abci commands against an application", Long: "", Args: cobra.ExactArgs(0), RunE: func(cmd *cobra.Command, args []string) error { return cmdBatch(cmd, args) }, } var consoleCmd = &cobra.Command{ Use: "console", Short: "Start an interactive abci console for multiple commands", Long: "", Args: cobra.ExactArgs(0), ValidArgs: []string{"batch", "echo", "info", "set_option", "deliver_tx", "check_tx", "commit", "query"}, RunE: func(cmd *cobra.Command, args []string) error { return cmdConsole(cmd, args) }, } var echoCmd = &cobra.Command{ Use: "echo", Short: "Have the application echo a message", Long: "", Args: cobra.ExactArgs(1), RunE: func(cmd *cobra.Command, args []string) error { return cmdEcho(cmd, args) }, } var infoCmd = &cobra.Command{ Use: "info", Short: "Get some info about the application", Long: "", Args: cobra.ExactArgs(0), RunE: func(cmd *cobra.Command, args []string) error { return cmdInfo(cmd, args) }, } var setOptionCmd = &cobra.Command{ Use: "set_option", Short: "Set an option on the application", Long: "", Args: cobra.ExactArgs(2), RunE: func(cmd *cobra.Command, args []string) error { return cmdSetOption(cmd, args) }, } var deliverTxCmd = &cobra.Command{ Use: "deliver_tx", Short: "Deliver a new transaction to the application", Long: "", Args: cobra.ExactArgs(1), RunE: func(cmd *cobra.Command, args []string) error { return cmdDeliverTx(cmd, args) }, } var checkTxCmd = &cobra.Command{ Use: "check_tx", Short: "Validate a transaction", Long: "", Args: cobra.ExactArgs(1), RunE: func(cmd *cobra.Command, args []string) error { return cmdCheckTx(cmd, args) }, } var commitCmd = &cobra.Command{ Use: "commit", Short: "Commit the application state and return the Merkle root hash", Long: "", Args: cobra.ExactArgs(0), RunE: func(cmd *cobra.Command, args []string) error { return cmdCommit(cmd, args) }, } var queryCmd = &cobra.Command{ Use: "query", Short: "Query the application state", Long: "", Args: cobra.ExactArgs(1), RunE: func(cmd *cobra.Command, args []string) error { return cmdQuery(cmd, args) }, } var counterCmd = &cobra.Command{ Use: "counter", Short: "ABCI demo example", Long: "", Args: cobra.ExactArgs(0), RunE: func(cmd *cobra.Command, args []string) error { return cmdCounter(cmd, args) }, } var dummyCmd = &cobra.Command{ Use: "dummy", Short: "ABCI demo example", Long: "", Args: cobra.ExactArgs(0), RunE: func(cmd *cobra.Command, args []string) error { return cmdDummy(cmd, args) }, } // Generates new Args array based off of previous call args to maintain flag persistence func persistentArgs(line []byte) []string { // generate the arguments to run from original os.Args // to maintain flag arguments args := os.Args args = args[:len(args)-1] // remove the previous command argument if len(line) > 0 { // prevents introduction of extra space leading to argument parse errors args = append(args, strings.Split(string(line), " ")...) } return args } //-------------------------------------------------------------------------------- func cmdBatch(cmd *cobra.Command, args []string) error { bufReader := bufio.NewReader(os.Stdin) for { line, more, err := bufReader.ReadLine() if more { return errors.New("Input line is too long") } else if err == io.EOF { break } else if len(line) == 0 { continue } else if err != nil { return err } pArgs := persistentArgs(line) out, err := exec.Command(pArgs[0], pArgs[1:]...).Output() if err != nil { return err } fmt.Println(string(out)) } return nil } func cmdConsole(cmd *cobra.Command, args []string) error { for { fmt.Printf("> ") bufReader := bufio.NewReader(os.Stdin) line, more, err := bufReader.ReadLine() if more { return errors.New("Input is too long") } else if err != nil { return err } pArgs := persistentArgs(line) out, err := exec.Command(pArgs[0], pArgs[1:]...).Output() if err != nil { return err } fmt.Println(string(out)) } return nil } // Have the application echo a message func cmdEcho(cmd *cobra.Command, args []string) error { resEcho := client.EchoSync(args[0]) printResponse(cmd, args, response{ Data: resEcho.Data, }) return nil } // Get some info from the application func cmdInfo(cmd *cobra.Command, args []string) error { var version string if len(args) == 1 { version = args[0] } resInfo, err := client.InfoSync(types.RequestInfo{version}) if err != nil { return err } printResponse(cmd, args, response{ Data: []byte(resInfo.Data), }) return nil } // Set an option on the application func cmdSetOption(cmd *cobra.Command, args []string) error { resSetOption := client.SetOptionSync(args[0], args[1]) printResponse(cmd, args, response{ Log: resSetOption.Log, }) return nil } // Append a new tx to application func cmdDeliverTx(cmd *cobra.Command, args []string) error { txBytes, err := stringOrHexToBytes(args[0]) if err != nil { return err } res := client.DeliverTxSync(txBytes) printResponse(cmd, args, response{ Code: res.Code, Data: res.Data, Log: res.Log, }) return nil } // Validate a tx func cmdCheckTx(cmd *cobra.Command, args []string) error { txBytes, err := stringOrHexToBytes(args[0]) if err != nil { return err } res := client.CheckTxSync(txBytes) printResponse(cmd, args, response{ Code: res.Code, Data: res.Data, Log: res.Log, }) return nil } // Get application Merkle root hash func cmdCommit(cmd *cobra.Command, args []string) error { res := client.CommitSync() printResponse(cmd, args, response{ Code: res.Code, Data: res.Data, Log: res.Log, }) return nil } // Query application state func cmdQuery(cmd *cobra.Command, args []string) error { queryBytes, err := stringOrHexToBytes(args[0]) if err != nil { return err } resQuery, err := client.QuerySync(types.RequestQuery{ Data: queryBytes, Path: path, Height: uint64(height), Prove: prove, }) if err != nil { return err } printResponse(cmd, args, response{ Code: resQuery.Code, Log: resQuery.Log, Query: &queryResponse{ Key: resQuery.Key, Value: resQuery.Value, Height: resQuery.Height, Proof: resQuery.Proof, }, }) return nil } func cmdCounter(cmd *cobra.Command, args []string) error { app := counter.NewCounterApplication(serial) logger := log.NewTMLogger(log.NewSyncWriter(os.Stdout)) // Start the listener srv, err := server.NewServer(addrC, abci, app) if err != nil { return err } srv.SetLogger(logger.With("module", "abci-server")) if _, err := srv.Start(); err != nil { return err } // Wait forever cmn.TrapSignal(func() { // Cleanup srv.Stop() }) return nil } func cmdDummy(cmd *cobra.Command, args []string) error { logger := log.NewTMLogger(log.NewSyncWriter(os.Stdout)) // Create the application - in memory or persisted to disk var app types.Application if persist == "" { app = dummy.NewDummyApplication() } else { app = dummy.NewPersistentDummyApplication(persist) app.(*dummy.PersistentDummyApplication).SetLogger(logger.With("module", "dummy")) } // Start the listener srv, err := server.NewServer(addrD, abci, app) if err != nil { return err } srv.SetLogger(logger.With("module", "abci-server")) if _, err := srv.Start(); err != nil { return err } // Wait forever cmn.TrapSignal(func() { // Cleanup srv.Stop() }) return nil } //-------------------------------------------------------------------------------- func printResponse(cmd *cobra.Command, args []string, rsp response) { if verbose { fmt.Println(">", cmd.Use, strings.Join(args, " ")) } // Always print the status code. fmt.Printf("-> code: %s\n", rsp.Code.String()) if len(rsp.Data) != 0 { // Do no print this line when using the commit command // because the string comes out as gibberish if cmd.Use != "commit" { fmt.Printf("-> data: %s\n", rsp.Data) } fmt.Printf("-> data.hex: 0x%X\n", rsp.Data) } if rsp.Log != "" { fmt.Printf("-> log: %s\n", rsp.Log) } if rsp.Query != nil { fmt.Printf("-> height: %d\n", rsp.Query.Height) if rsp.Query.Key != nil { fmt.Printf("-> key: %s\n", rsp.Query.Key) fmt.Printf("-> key.hex: %X\n", rsp.Query.Key) } if rsp.Query.Value != nil { fmt.Printf("-> value: %s\n", rsp.Query.Value) fmt.Printf("-> value.hex: %X\n", rsp.Query.Value) } if rsp.Query.Proof != nil { fmt.Printf("-> proof: %X\n", rsp.Query.Proof) } } } // NOTE: s is interpreted as a string unless prefixed with 0x func stringOrHexToBytes(s string) ([]byte, error) { if len(s) > 2 && strings.ToLower(s[:2]) == "0x" { b, err := hex.DecodeString(s[2:]) if err != nil { err = fmt.Errorf("Error decoding hex argument: %s", err.Error()) return nil, err } return b, nil } if !strings.HasPrefix(s, "\"") || !strings.HasSuffix(s, "\"") { err := fmt.Errorf("Invalid string arg: \"%s\". Must be quoted or a \"0x\"-prefixed hex string", s) return nil, err } return []byte(s[1 : len(s)-1]), nil }