github.com/valorbit/go-ethereum@v1.9.11-rc4/cmd/geth/consolecmd.go (about) 1 // Copyright 2016 The go-ethereum Authors 2 // This file is part of go-ethereum. 3 // 4 // go-ethereum is free software: you can redistribute it and/or modify 5 // it under the terms of the GNU General Public License as published by 6 // the Free Software Foundation, either version 3 of the License, or 7 // (at your option) any later version. 8 // 9 // go-ethereum is distributed in the hope that it will be useful, 10 // but WITHOUT ANY WARRANTY; without even the implied warranty of 11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 12 // GNU General Public License for more details. 13 // 14 // You should have received a copy of the GNU General Public License 15 // along with go-ethereum. If not, see <http://www.gnu.org/licenses/>. 16 17 package main 18 19 import ( 20 "fmt" 21 "os" 22 "os/signal" 23 "path/filepath" 24 "strings" 25 "syscall" 26 27 "github.com/valorbit/go-ethereum/cmd/utils" 28 "github.com/valorbit/go-ethereum/console" 29 "github.com/valorbit/go-ethereum/node" 30 "github.com/valorbit/go-ethereum/rpc" 31 "gopkg.in/urfave/cli.v1" 32 ) 33 34 var ( 35 consoleFlags = []cli.Flag{utils.JSpathFlag, utils.ExecFlag, utils.PreloadJSFlag} 36 37 consoleCommand = cli.Command{ 38 Action: utils.MigrateFlags(localConsole), 39 Name: "console", 40 Usage: "Start an interactive JavaScript environment", 41 Flags: append(append(append(nodeFlags, rpcFlags...), consoleFlags...), whisperFlags...), 42 Category: "CONSOLE COMMANDS", 43 Description: ` 44 The Geth console is an interactive shell for the JavaScript runtime environment 45 which exposes a node admin interface as well as the Ðapp JavaScript API. 46 See https://github.com/valorbit/go-ethereum/wiki/JavaScript-Console.`, 47 } 48 49 attachCommand = cli.Command{ 50 Action: utils.MigrateFlags(remoteConsole), 51 Name: "attach", 52 Usage: "Start an interactive JavaScript environment (connect to node)", 53 ArgsUsage: "[endpoint]", 54 Flags: append(consoleFlags, utils.DataDirFlag), 55 Category: "CONSOLE COMMANDS", 56 Description: ` 57 The Geth console is an interactive shell for the JavaScript runtime environment 58 which exposes a node admin interface as well as the Ðapp JavaScript API. 59 See https://github.com/valorbit/go-ethereum/wiki/JavaScript-Console. 60 This command allows to open a console on a running geth node.`, 61 } 62 63 javascriptCommand = cli.Command{ 64 Action: utils.MigrateFlags(ephemeralConsole), 65 Name: "js", 66 Usage: "Execute the specified JavaScript files", 67 ArgsUsage: "<jsfile> [jsfile...]", 68 Flags: append(nodeFlags, consoleFlags...), 69 Category: "CONSOLE COMMANDS", 70 Description: ` 71 The JavaScript VM exposes a node admin interface as well as the Ðapp 72 JavaScript API. See https://github.com/valorbit/go-ethereum/wiki/JavaScript-Console`, 73 } 74 ) 75 76 // localConsole starts a new geth node, attaching a JavaScript console to it at the 77 // same time. 78 func localConsole(ctx *cli.Context) error { 79 // Create and start the node based on the CLI flags 80 prepare(ctx) 81 node := makeFullNode(ctx) 82 startNode(ctx, node) 83 defer node.Close() 84 85 // Attach to the newly started node and start the JavaScript console 86 client, err := node.Attach() 87 if err != nil { 88 utils.Fatalf("Failed to attach to the inproc geth: %v", err) 89 } 90 config := console.Config{ 91 DataDir: utils.MakeDataDir(ctx), 92 DocRoot: ctx.GlobalString(utils.JSpathFlag.Name), 93 Client: client, 94 Preload: utils.MakeConsolePreloads(ctx), 95 } 96 97 console, err := console.New(config) 98 if err != nil { 99 utils.Fatalf("Failed to start the JavaScript console: %v", err) 100 } 101 defer console.Stop(false) 102 103 // If only a short execution was requested, evaluate and return 104 if script := ctx.GlobalString(utils.ExecFlag.Name); script != "" { 105 console.Evaluate(script) 106 return nil 107 } 108 // Otherwise print the welcome screen and enter interactive mode 109 console.Welcome() 110 console.Interactive() 111 112 return nil 113 } 114 115 // remoteConsole will connect to a remote geth instance, attaching a JavaScript 116 // console to it. 117 func remoteConsole(ctx *cli.Context) error { 118 // Attach to a remotely running geth instance and start the JavaScript console 119 endpoint := ctx.Args().First() 120 if endpoint == "" { 121 path := node.DefaultDataDir() 122 if ctx.GlobalIsSet(utils.DataDirFlag.Name) { 123 path = ctx.GlobalString(utils.DataDirFlag.Name) 124 } 125 if path != "" { 126 if ctx.GlobalBool(utils.TestnetFlag.Name) { 127 path = filepath.Join(path, "testnet") 128 } else if ctx.GlobalBool(utils.RinkebyFlag.Name) { 129 path = filepath.Join(path, "rinkeby") 130 } else if ctx.GlobalBool(utils.ValorbitFlag.Name) { 131 path = filepath.Join(path, "valorbit") 132 } else if ctx.GlobalBool(utils.GranvilleFlag.Name) { 133 path = filepath.Join(path, "granville") 134 } 135 } 136 endpoint = fmt.Sprintf("%s/geth.ipc", path) 137 } 138 client, err := dialRPC(endpoint) 139 if err != nil { 140 utils.Fatalf("Unable to attach to remote geth: %v", err) 141 } 142 config := console.Config{ 143 DataDir: utils.MakeDataDir(ctx), 144 DocRoot: ctx.GlobalString(utils.JSpathFlag.Name), 145 Client: client, 146 Preload: utils.MakeConsolePreloads(ctx), 147 } 148 149 console, err := console.New(config) 150 if err != nil { 151 utils.Fatalf("Failed to start the JavaScript console: %v", err) 152 } 153 defer console.Stop(false) 154 155 if script := ctx.GlobalString(utils.ExecFlag.Name); script != "" { 156 console.Evaluate(script) 157 return nil 158 } 159 160 // Otherwise print the welcome screen and enter interactive mode 161 console.Welcome() 162 console.Interactive() 163 164 return nil 165 } 166 167 // dialRPC returns a RPC client which connects to the given endpoint. 168 // The check for empty endpoint implements the defaulting logic 169 // for "geth attach" and "geth monitor" with no argument. 170 func dialRPC(endpoint string) (*rpc.Client, error) { 171 if endpoint == "" { 172 endpoint = node.DefaultIPCEndpoint(clientIdentifier) 173 } else if strings.HasPrefix(endpoint, "rpc:") || strings.HasPrefix(endpoint, "ipc:") { 174 // Backwards compatibility with geth < 1.5 which required 175 // these prefixes. 176 endpoint = endpoint[4:] 177 } 178 return rpc.Dial(endpoint) 179 } 180 181 // ephemeralConsole starts a new geth node, attaches an ephemeral JavaScript 182 // console to it, executes each of the files specified as arguments and tears 183 // everything down. 184 func ephemeralConsole(ctx *cli.Context) error { 185 // Create and start the node based on the CLI flags 186 node := makeFullNode(ctx) 187 startNode(ctx, node) 188 defer node.Close() 189 190 // Attach to the newly started node and start the JavaScript console 191 client, err := node.Attach() 192 if err != nil { 193 utils.Fatalf("Failed to attach to the inproc geth: %v", err) 194 } 195 config := console.Config{ 196 DataDir: utils.MakeDataDir(ctx), 197 DocRoot: ctx.GlobalString(utils.JSpathFlag.Name), 198 Client: client, 199 Preload: utils.MakeConsolePreloads(ctx), 200 } 201 202 console, err := console.New(config) 203 if err != nil { 204 utils.Fatalf("Failed to start the JavaScript console: %v", err) 205 } 206 defer console.Stop(false) 207 208 // Evaluate each of the specified JavaScript files 209 for _, file := range ctx.Args() { 210 if err = console.Execute(file); err != nil { 211 utils.Fatalf("Failed to execute %s: %v", file, err) 212 } 213 } 214 // Wait for pending callbacks, but stop for Ctrl-C. 215 abort := make(chan os.Signal, 1) 216 signal.Notify(abort, syscall.SIGINT, syscall.SIGTERM) 217 218 go func() { 219 <-abort 220 os.Exit(0) 221 }() 222 console.Stop(true) 223 224 return nil 225 }