{"_id":"@eth-optimism/solc","_rev":"26-c2d3512fbc803c213a9e666ffbadee6b","name":"@eth-optimism/solc","dist-tags":{"latest":"0.7.6-alpha.1"},"versions":{"0.5.16-alpha.0":{"name":"@eth-optimism/solc","version":"0.5.16-alpha.0","keywords":["ethereum","solidity","compiler"],"author":{"name":"chriseth"},"license":"MIT","_id":"@eth-optimism/solc@0.5.16-alpha.0","maintainers":[{"name":"masonforest","email":"mason@kissr.co"},{"name":"k-ho","email":"kevin@optimism.io"},{"name":"will_optimism","email":"will@optimism.io"},{"name":"ben-chain","email":"ben@optimism.io"},{"name":"karlfloersch","email":"karl@karl.tech"}],"homepage":"https://github.com/ethereum-optimism/solc-js#readme","bugs":{"url":"https://github.com/ethereum-optimism/solc-js/issues"},"bin":{"solcjs":"solcjs"},"nyc":{"exclude":["soljson.js"]},"dist":{"shasum":"27df0e8db3f4d1118bf18882460115c79d6dc6c5","tarball":"https://registry.npmjs.org/@eth-optimism/solc/-/solc-0.5.16-alpha.0.tgz","fileCount":12,"integrity":"sha512-jAgrdWSKGZTmNIsHht4mudcouptM/m0T6p7pdxnHhN39qS160LXxZQKGATk8Vnx1NJPHpJXvfwQcYbEhhrIJ2A==","signatures":[{"sig":"MEUCIAUyyTM3QZG6D7rM/9P92SNY0y7byNoAtlpcePGQGoP/AiEAgs/K0cosOSLsKLgpqP72Po62Nmoozi/9YezKFM4qcBk=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":12483181,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJfIifoCRA9TVsSAnZWagAAGbMP/RD/iZqEnKDIWGgR0cUT\nOQ16xihR9w5RGUmNaLMd5GAueFmNztqsy0IDC1VGePZHijJaBBbxdydN3yGS\n5a7WSc+QPy6XLobvR+JzOW49v64jWZQdC13P0oHZWqArbwsMBwNdgEnlcwSB\n6eK4MeD8IgeD0dwHTq3ycX9CzWUb59//+q5D8A++1YeIJhRBrPOZvzlQkrUA\nMjxX0thL7juFtT6nr2F4e0z5xZ6d6Buqm6njx7llltkinFPtyEaq/2e5DbHb\np3hpYTarWLMsQ3Orw/LO09m7uAp3uMitRWWsh54mVe6HP7+iYA4trxwBzzEl\nyARKL10n1JEv02IAo7Ju5IQ14JL9oJjGiNvqZpY9XiSFOoDNq8O409V9tuvF\nUBvtGY4EA1n7eBlWyTaeILv/S77zwvJK3lvGNLonex7dBUpLUp2RC39UV9uJ\nhq70k+hTOVWWxF6oGb4xmfHfR10jRxtqf21PZYEI7GoFO3QwybWO+I4MljGW\nolLKF+MhPKKky8ZRE+lCzc3TjSHPK4UKJZPKlfYMb/ulShv73dr7tf4s5RZt\n+4BSh8WJt7Dms1pBIy9aqw/c7BmAkPDVw9QNtYz6PD+Qm8paHUF2U6OCuqXf\n59N0oZW0CoynPd1QblyikUsIgaL4/klP25huTZoxCOnz86LCSvMDq+IrGtCK\nlap8\r\n=tjns\r\n-----END PGP SIGNATURE-----\r\n"},"main":"index.js","engines":{"node":">=8.0.0"},"gitHead":"31ef77ff23bb2b3c49dfdba8dccad5185e1c1fb0","scripts":{"lint":"node ./node_modules/semistandard/bin/cmd.js","test":"tape ./test/index.js","pretest":"npm run lint","coverage":"node ./node_modules/nyc/bin/nyc.js --reporter=lcov --reporter=text-summary ./node_modules/tape/bin/tape ./test/index.js","coveralls":"npm run coverage && node ./node_modules/coveralls/bin/coveralls.js =8.0.0"},"gitHead":"24d80834be25eab9ab41dbd393d32a2533996056","scripts":{"lint":"node ./node_modules/semistandard/bin/cmd.js","test":"tape ./test/index.js","pretest":"npm run lint","coverage":"node ./node_modules/nyc/bin/nyc.js --reporter=lcov --reporter=text-summary ./node_modules/tape/bin/tape ./test/index.js","coveralls":"npm run coverage && node ./node_modules/coveralls/bin/coveralls.js =8.0.0"},"gitHead":"6d829052d2bfa58ba51ca47972870c52c06589cb","scripts":{"lint":"node ./node_modules/semistandard/bin/cmd.js","test":"tape ./test/index.js","pretest":"npm run lint","coverage":"node ./node_modules/nyc/bin/nyc.js --reporter=lcov --reporter=text-summary ./node_modules/tape/bin/tape ./test/index.js","coveralls":"npm run coverage && node ./node_modules/coveralls/bin/coveralls.js =8.0.0"},"gitHead":"2719148d3940e31d551f8ca59bb66db8c814ed22","scripts":{"lint":"node ./node_modules/semistandard/bin/cmd.js","test":"tape ./test/index.js","pretest":"npm run lint","coverage":"node ./node_modules/nyc/bin/nyc.js --reporter=lcov --reporter=text-summary ./node_modules/tape/bin/tape ./test/index.js","coveralls":"npm run coverage && node ./node_modules/coveralls/bin/coveralls.js =8.0.0"},"gitHead":"9629c20c027c4efb965f1aac8555a54bd334de46","scripts":{"lint":"node ./node_modules/semistandard/bin/cmd.js","test":"tape ./test/index.js","pretest":"npm run lint","coverage":"node ./node_modules/nyc/bin/nyc.js --reporter=lcov --reporter=text-summary ./node_modules/tape/bin/tape ./test/index.js","coveralls":"npm run coverage && node ./node_modules/coveralls/bin/coveralls.js =8.0.0"},"gitHead":"42a7e2abf1d2a92f8202662a027102c23e7a5327","scripts":{"lint":"node ./node_modules/semistandard/bin/cmd.js","test":"tape ./test/index.js","pretest":"npm run lint","coverage":"node ./node_modules/nyc/bin/nyc.js --reporter=lcov --reporter=text-summary ./node_modules/tape/bin/tape ./test/index.js","coveralls":"npm run coverage && node ./node_modules/coveralls/bin/coveralls.js =8.0.0"},"gitHead":"7f7c42df293581f07888ed4b7136532b99cbd778","scripts":{"lint":"node ./node_modules/semistandard/bin/cmd.js","test":"tape ./test/index.js","pretest":"npm run lint","coverage":"node ./node_modules/nyc/bin/nyc.js --reporter=lcov --reporter=text-summary ./node_modules/tape/bin/tape ./test/index.js","coveralls":"npm run coverage && node ./node_modules/coveralls/bin/coveralls.js =8.0.0"},"gitHead":"e12a641be16f89a98fa0d730684e82efcf4b016c","scripts":{"lint":"node ./node_modules/semistandard/bin/cmd.js","test":"tape ./test/index.js","pretest":"npm run lint","coverage":"node ./node_modules/nyc/bin/nyc.js --reporter=lcov --reporter=text-summary ./node_modules/tape/bin/tape ./test/index.js","coveralls":"npm run coverage && node ./node_modules/coveralls/bin/coveralls.js =8.0.0"},"gitHead":"c4ba1062e6c806a5f1fcb9916453d237b29c0661","scripts":{"lint":"node ./node_modules/semistandard/bin/cmd.js","test":"tape ./test/index.js","pretest":"npm run lint","coverage":"node ./node_modules/nyc/bin/nyc.js --reporter=lcov --reporter=text-summary ./node_modules/tape/bin/tape ./test/index.js","coveralls":"npm run coverage && node ./node_modules/coveralls/bin/coveralls.js =8.0.0"},"gitHead":"5964efc01979f27abf72812798433aa90cdbd4e4","scripts":{"lint":"node ./node_modules/semistandard/bin/cmd.js","test":"tape ./test/index.js","pretest":"npm run lint","coverage":"node ./node_modules/nyc/bin/nyc.js --reporter=lcov --reporter=text-summary ./node_modules/tape/bin/tape ./test/index.js","coveralls":"npm run coverage && node ./node_modules/coveralls/bin/coveralls.js =8.0.0"},"gitHead":"e985383304bdcbe07f3affbded51d319a7f2fc40","scripts":{"lint":"node ./node_modules/semistandard/bin/cmd.js","test":"tape ./test/index.js","pretest":"npm run lint","coverage":"node ./node_modules/nyc/bin/nyc.js --reporter=lcov --reporter=text-summary ./node_modules/tape/bin/tape ./test/index.js","coveralls":"npm run coverage && node ./node_modules/coveralls/bin/coveralls.js =8.0.0"},"gitHead":"fe24b187e0a7f0fe702348211512dbaf3deaaff1","scripts":{"lint":"node ./node_modules/semistandard/bin/cmd.js","test":"tape ./test/index.js","pretest":"npm run lint","coverage":"node ./node_modules/nyc/bin/nyc.js --reporter=lcov --reporter=text-summary ./node_modules/tape/bin/tape ./test/index.js","coveralls":"npm run coverage && node ./node_modules/coveralls/bin/coveralls.js 0); } }'\n }\n }\n};\n\nvar output = JSON.parse(\n solc.compile(JSON.stringify(input), { smtSolver: smt.smtSolver })\n);\n\n```\nThe assertion is clearly false, and an ``assertion failure`` warning\nshould be returned.\n\n#### Low-level API\n\nThe low-level API is as follows:\n\n- `solc.lowlevel.compileSingle`: the original entry point, supports only a single file\n- `solc.lowlevel.compileMulti`: this supports multiple files, introduced in 0.1.6\n- `solc.lowlevel.compileCallback`: this supports callbacks, introduced in 0.2.1\n- `solc.lowlevel.compileStandard`: this works just like `compile` above, but is only present in compilers after (and including) 0.4.11\n\nFor examples how to use them, please refer to the README of the above mentioned solc-js releases.\n\n### Using with Electron\n\n**Note:**\nIf you are using Electron, `nodeIntegration` is on for `BrowserWindow` by default. If it is on, Electron will provide a `require` method which will not behave as expected and this may cause calls, such as `require('solc')`, to fail.\n\nTo turn off `nodeIntegration`, use the following:\n\n```javascript\nnew BrowserWindow({\n webPreferences: {\n nodeIntegration: false\n }\n});\n```\n\n### Using a Legacy Version\n\nIn order to compile contracts using a specific version of Solidity, the `solc.loadRemoteVersion(version, callback)` method is available. This returns a new `solc` object that uses a version of the compiler specified.\n\nYou can also load the \"binary\" manually and use `setupMethods` to create the familiar wrapper functions described above:\n`var solc = solc.setupMethods(require(\"/my/local/soljson.js\"))`.\n\n### Using the Latest Development Snapshot\n\nBy default, the npm version is only created for releases. This prevents people from deploying contracts with non-release versions because they are less stable and harder to verify. If you would like to use the latest development snapshot (at your own risk!), you may use the following example code.\n\n```javascript\nvar solc = require('solc');\n\n// getting the development snapshot\nsolc.loadRemoteVersion('latest', function(err, solcSnapshot) {\n if (err) {\n // An error was encountered, display and quit\n } else {\n // NOTE: Use `solcSnapshot` here with the same interface `solc` has\n }\n});\n```\n\n### Linking Bytecode\n\nWhen using libraries, the resulting bytecode will contain placeholders for the real addresses of the referenced libraries. These have to be updated, via a process called linking, before deploying the contract.\n\nThe `linker` module (`require('solc/linker')`) offers helpers to accomplish this.\n\nThe `linkBytecode` method provides a simple helper for linking:\n\n```javascript\nvar linker = require('solc/linker');\n\nbytecode = linker.linkBytecode(bytecode, { MyLibrary: '0x123456...' });\n```\n\nAs of Solidity 0.4.11 the compiler supports [standard JSON input and output](https://solidity.readthedocs.io/en/develop/using-the-compiler.html#compiler-input-and-output-json-description) which outputs a _link references_ map. This gives a map of library names to offsets in the bytecode to replace the addresses at. It also doesn't have the limitation on library file and contract name lengths.\n\nThere is a method available in the `linker` module called `findLinkReferences` which can find such link references in bytecode produced by an older compiler:\n\n```javascript\nvar linker = require('solc/linker');\n\nvar linkReferences = linker.findLinkReferences(bytecode);\n```\n\n### Updating the ABI\n\nThe ABI generated by Solidity versions can differ slightly, due to new features introduced. There is a tool included which aims to translate the ABI generated by an older Solidity version to conform to the latest standard.\n\nIt can be used as:\n\n```javascript\nvar abi = require('solc/abi');\n\nvar inputABI = [\n {\n constant: false,\n inputs: [],\n name: 'hello',\n outputs: [{ name: '', type: 'string' }],\n payable: false,\n type: 'function'\n }\n];\nvar outputABI = abi.update('0.3.6', inputABI);\n// Output contains: [{\"constant\":false,\"inputs\":[],\"name\":\"hello\",\"outputs\":[{\"name\":\"\",\"type\":\"string\"}],\"payable\":true,\"type\":\"function\"},{\"type\":\"fallback\",\"payable\":true}]\n```\n\n### Formatting old JSON assembly output\n\nThere is a helper available to format old JSON assembly output into a text familiar to earlier users of Remix IDE.\n\n```\nvar translate = require('solc/translate')\n\n// assemblyJSON refers to the JSON of the given assembly and sourceCode is the source of which the assembly was generated from\nvar output = translate.prettyPrintLegacyAssemblyJSON(assemblyJSON, sourceCode)\n```\n\n## Browser Usage\n\nAdd the version of `solc` you want to use into `index.html`:\n\n```html\n\n```\n\n(Alternatively use `https://solc-bin.ethereum.org/bin/soljson-latest.js` to get the latests version.)\n\nThis will load `solc` into the global variable `window.Module`. Then use this inside Javascript as:\n\n```javascript\nvar wrapper = require('solc/wrapper');\nvar solc = wrapper(window.Module);\n```\n\nOr in ES6 syntax:\n\n```javascript\nimport * as wrapper from 'solc/wrapper';\nconst solc = wrapper(window.Module);\n```\n\nAlternatively, to iterate the releases, one can load `list.js` from `solc-bin`:\n\n```html\n\n```\n\nThis will result in two global variables, `window.soljsonReleases` listing all releases and `window.soljsonSources` listing all nightly builds and releases.\n","readmeFilename":"README.md"}