github.com/intfoundation/intchain@v0.0.0-20220727031208-4316ad31ca73/common/compiler/solidity.go (about) 1 // Copyright 2015 The go-ethereum Authors 2 // This file is part of the go-ethereum library. 3 // 4 // The go-ethereum library is free software: you can redistribute it and/or modify 5 // it under the terms of the GNU Lesser 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 // The go-ethereum library 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 Lesser General Public License for more details. 13 // 14 // You should have received a copy of the GNU Lesser General Public License 15 // along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>. 16 17 // Package compiler wraps the Solidity and Vyper compiler executables (solc; vyper). 18 package compiler 19 20 import ( 21 "bytes" 22 "encoding/json" 23 "errors" 24 "fmt" 25 "os/exec" 26 "strconv" 27 "strings" 28 ) 29 30 // Solidity contains information about the solidity compiler. 31 type Solidity struct { 32 Path, Version, FullVersion string 33 Major, Minor, Patch int 34 } 35 36 // --combined-output format 37 type solcOutput struct { 38 Contracts map[string]struct { 39 BinRuntime string `json:"bin-runtime"` 40 SrcMapRuntime string `json:"srcmap-runtime"` 41 Bin, SrcMap, Abi, Devdoc, Userdoc, Metadata string 42 Hashes map[string]string 43 } 44 Version string 45 } 46 47 func (s *Solidity) makeArgs() []string { 48 p := []string{ 49 "--combined-json", "bin,bin-runtime,srcmap,srcmap-runtime,abi,userdoc,devdoc", 50 "--optimize", // code optimizer switched on 51 "--allow-paths", "., ./, ../", // default to support relative paths 52 } 53 if s.Major > 0 || s.Minor > 4 || s.Patch > 6 { 54 p[1] += ",metadata,hashes" 55 } 56 return p 57 } 58 59 // SolidityVersion runs solc and parses its version output. 60 func SolidityVersion(solc string) (*Solidity, error) { 61 if solc == "" { 62 solc = "solc" 63 } 64 var out bytes.Buffer 65 cmd := exec.Command(solc, "--version") 66 cmd.Stdout = &out 67 err := cmd.Run() 68 if err != nil { 69 return nil, err 70 } 71 matches := versionRegexp.FindStringSubmatch(out.String()) 72 if len(matches) != 4 { 73 return nil, fmt.Errorf("can't parse solc version %q", out.String()) 74 } 75 s := &Solidity{Path: cmd.Path, FullVersion: out.String(), Version: matches[0]} 76 if s.Major, err = strconv.Atoi(matches[1]); err != nil { 77 return nil, err 78 } 79 if s.Minor, err = strconv.Atoi(matches[2]); err != nil { 80 return nil, err 81 } 82 if s.Patch, err = strconv.Atoi(matches[3]); err != nil { 83 return nil, err 84 } 85 return s, nil 86 } 87 88 // CompileSolidityString builds and returns all the contracts contained within a source string. 89 func CompileSolidityString(solc, source string) (map[string]*Contract, error) { 90 if len(source) == 0 { 91 return nil, errors.New("solc: empty source string") 92 } 93 s, err := SolidityVersion(solc) 94 if err != nil { 95 return nil, err 96 } 97 args := append(s.makeArgs(), "--") 98 cmd := exec.Command(s.Path, append(args, "-")...) 99 cmd.Stdin = strings.NewReader(source) 100 return s.run(cmd, source) 101 } 102 103 // CompileSolidity compiles all given Solidity source files. 104 func CompileSolidity(solc string, sourcefiles ...string) (map[string]*Contract, error) { 105 if len(sourcefiles) == 0 { 106 return nil, errors.New("solc: no source files") 107 } 108 source, err := slurpFiles(sourcefiles) 109 if err != nil { 110 return nil, err 111 } 112 s, err := SolidityVersion(solc) 113 if err != nil { 114 return nil, err 115 } 116 args := append(s.makeArgs(), "--") 117 cmd := exec.Command(s.Path, append(args, sourcefiles...)...) 118 return s.run(cmd, source) 119 } 120 121 func (s *Solidity) run(cmd *exec.Cmd, source string) (map[string]*Contract, error) { 122 var stderr, stdout bytes.Buffer 123 cmd.Stderr = &stderr 124 cmd.Stdout = &stdout 125 if err := cmd.Run(); err != nil { 126 return nil, fmt.Errorf("solc: %v\n%s", err, stderr.Bytes()) 127 } 128 129 return ParseCombinedJSON(stdout.Bytes(), source, s.Version, s.Version, strings.Join(s.makeArgs(), " ")) 130 } 131 132 // ParseCombinedJSON takes the direct output of a solc --combined-output run and 133 // parses it into a map of string contract name to Contract structs. The 134 // provided source, language and compiler version, and compiler options are all 135 // passed through into the Contract structs. 136 // 137 // The solc output is expected to contain ABI, source mapping, user docs, and dev docs. 138 // 139 // Returns an error if the JSON is malformed or missing data, or if the JSON 140 // embedded within the JSON is malformed. 141 func ParseCombinedJSON(combinedJSON []byte, source string, languageVersion string, compilerVersion string, compilerOptions string) (map[string]*Contract, error) { 142 var output solcOutput 143 if err := json.Unmarshal(combinedJSON, &output); err != nil { 144 return nil, err 145 } 146 // Compilation succeeded, assemble and return the contracts. 147 contracts := make(map[string]*Contract) 148 for name, info := range output.Contracts { 149 // Parse the individual compilation results. 150 var abi interface{} 151 if err := json.Unmarshal([]byte(info.Abi), &abi); err != nil { 152 return nil, fmt.Errorf("solc: error reading abi definition (%v)", err) 153 } 154 var userdoc, devdoc interface{} 155 json.Unmarshal([]byte(info.Userdoc), &userdoc) 156 json.Unmarshal([]byte(info.Devdoc), &devdoc) 157 158 contracts[name] = &Contract{ 159 Code: "0x" + info.Bin, 160 RuntimeCode: "0x" + info.BinRuntime, 161 Hashes: info.Hashes, 162 Info: ContractInfo{ 163 Source: source, 164 Language: "Solidity", 165 LanguageVersion: languageVersion, 166 CompilerVersion: compilerVersion, 167 CompilerOptions: compilerOptions, 168 SrcMap: info.SrcMap, 169 SrcMapRuntime: info.SrcMapRuntime, 170 AbiDefinition: abi, 171 UserDoc: userdoc, 172 DeveloperDoc: devdoc, 173 Metadata: info.Metadata, 174 }, 175 } 176 } 177 return contracts, nil 178 }