Initial import of Buidler EVM and release 1.0.1

Author: alcuadrado

.npmrc

@@ -1 +1 @@
-package-lock=false
+package-lock=false

.travis.yml

@@ -15,6 +15,7 @@ install:
   - scripts/install.sh
 
 script:
+  - npx tsc --version
   - npm run test
   - npm run lint
   - node scripts/check-dependencies.js

CONTRIBUTING.md

@@ -18,7 +18,7 @@ To install this project you have to run:
 ## Building the projects
 
 Plugins require buidler-core to be built or tested. Our recommendation is to run `npm run watch` from the root folder.
-This will keep everything compiled, and these problems will be avoided.  
+This will keep everything compiled, and these problems will be avoided.
 
 ## Testing
 
@@ -30,46 +30,73 @@ You can run a package's tests by executing `npm run test` inside its folder. Or
 ## Code formatting
 
 We use [Prettier](https://prettier.io/) to format all the code without any special configuration. Whatever Prettier does
-is considered The Right Thing. It's completely fine to commit non-prettied code and then reformat it in a later commit.  
+is considered The Right Thing. It's completely fine to commit non-prettied code and then reformat it in a later commit.
 
 We also have [tslint](https://palantir.github.io/tslint/) installed in all the projects. It checks that you have run
 Prettier and forbids some dangerous patterns.
 
-The linter is always run in the CI, so make sure it passes before pushing code. You can use `npm run lint` and 
+The linter is always run in the CI, so make sure it passes before pushing code. You can use `npm run lint` and
 `npm run lint:fix` inside the packages' folders.
 
 ## Dependencies
 
-We keep our dependencies versions in sync between the different projects. 
+We keep our dependencies versions in sync between the different projects.
 
 Running `node scripts/check-dependencies.js` from the root folder checks that every project specifies the same versions
-of each dependency. It will print an error if the versions get out of sync. 
+of each dependency. It will print an error if the versions get out of sync.
 
 ## Performance and dependencies loading
 
-Buidler and its plugins are optimized for keeping startup time low. 
+Buidler and its plugins are optimized for keeping startup time low.
 
 This is done by selectively requiring dependencies when needed using `import` or `require` following this criteria:
 
-1. If something is only imported for its type, and NOT its value, use a top-level `import ... from "mod"` 
+1. If something is only imported for its type, and NOT its value, use a top-level `import ... from "mod"`
 1. If a module is in the least below, use a top-level `import ... from "mod""`.
-3. Otherwise, use `await import` or `require` locally in the functions that use it.
-  3.1. If the function is sync, use node's `require`
-  3.2. If the function is an async, use `await import`
+1. Otherwise, use `await import` or `require` locally in the functions that use it.
+   3.1. If the function is sync, use node's `require`
+   3.2. If the function is an async, use `await import`
 
 Note that these rules don't apply to tests. You can always use top-level imports there.
 
 ### Essential modules
 
 This is a list of the modules that always get loaded during startup:
 
-* `fs`
-* `path`
-* `util`
-* `find-up`
-* `fs-extra`
-* `chalk`
-* `semver`
-* `deepmerge`
-* `source-map-support/register`
- 
+- `fs`
+- `path`
+- `util`
+- `find-up`
+- `fs-extra`
+- `chalk`
+- `semver`
+- `deepmerge`
+- `source-map-support/register`
+
+## Common errors
+
+### Monkey-patching dependencies multiple times
+
+You should avoid monkey-patching whenever possible. But if it's necessary to do so, you should pay extra care when doing
+it in Buidler or your tests may fail in very hard to debug ways.
+
+When tests are run, Buidler gets initialized multiple times. That may lead to monkey-patching the same multiple times.
+To avoid this, keep references to the original implementations. In order to do this, you need to get it just once:
+
+```js
+let originalImpl; // May be a global
+
+// ...
+
+if (originalImpl === undefined) {
+  originalImpl = lib.func;
+}
+
+lib.func = function(...args) {
+  // Do something;
+  return originalImpl.apply(this, args);
+};
+```
+
+This isn't normally a problem if you are monkey-patching an object's methods. But it is when monkey-patching a class
+or its prototype.

LICENSE

@@ -0,0 +1 @@
+SEE LICENSE IN EACH PACKAGE'S LICENSE FILE

config/typescript/@types/ethereumjs-abi/index.d.ts

@@ -0,0 +1 @@
+declare module "ethereumjs-abi";

config/typescript/@types/ethereumjs-block/index.d.ts

@@ -0,0 +1 @@
+declare module "ethereumjs-block";

config/typescript/@types/ganache-core/index.d.ts

@@ -0,0 +1 @@
+declare module "ganache-core";

config/typescript/@types/merkle-patricia-tree/index.d.ts

@@ -0,0 +1 @@
+declare module "merkle-patricia-tree/secure";

docs/.gitignore

@@ -2,3 +2,5 @@
 /api
 /.vuepress/dist
 .DS_Store
+/errors/README.md
+wget-readmes.sh

docs/.vuepress/components/Plugins.vue

@@ -8,7 +8,7 @@
     <div class="plugin" v-for="plugin in plugins">
       <div>
         <span class="name"><a :href="plugin.url">{{ plugin.name }}</a></span>
-        <span class="version">{{ plugin.version }}</span>
+        <!-- <span class="version">{{ plugin.version }}</span> -->
       </div>
       <p class="description">{{ plugin.description }}</p>
       <div class="tags">
@@ -21,75 +21,9 @@
 
 <script>
 
-
-let plugins = [
-  {
-    name: "@nomiclabs/buidler-truffle4",
-    version: "1.0.0-beta.9",
-    url: "https://github.com/nomiclabs/buidler/tree/master/packages/buidler-truffle4",
-    description: "Integration with TruffleContract from Truffle 4",
-    tags: ["Truffle", "Testing"]
-  }, {
-    name: "@nomiclabs/buidler-truffle5",
-    version: "1.0.0-beta.9",
-    url: "https://github.com/nomiclabs/buidler/tree/master/packages/buidler-truffle5",
-    description: "Integration with TruffleContract from Truffle 5",
-    tags: ["Truffle", "Testing"],
-  }, {
-    name: "@nomiclabs/buidler-web3",
-    version: "1.0.0-beta.9",
-    url: "https://github.com/nomiclabs/buidler/tree/master/packages/buidler-web3",
-    description: "Injects Web3 1.x into the Buidler Runtime Environment",
-    tags: ["Web3.js", "Testing", "Tasks", "Scripts"],
-  }, {
-    name: "@nomiclabs/buidler-web3-legacy",
-    version: "1.0.0-beta.9",
-    url: "https://github.com/nomiclabs/buidler/tree/master/packages/buidler-web3-legacy",
-    description: "Injects Web3 0.20.x into the Buidler Runtime Environment",
-    tags: ["Web3.js", "Legacy", "Testing", "Tasks", "Scripts"],
-  }, {
-    name: "@nomiclabs/buidler-ethers",
-    version: "1.0.0-beta.9",
-    url: "https://github.com/nomiclabs/buidler/tree/master/packages/buidler-ethers",
-    description: "Injects ethers.js into the Buidler Runtime Environment",
-    tags: ["Ethers.js", "Testing", "Tasks", "Scripts"],
-  }, {
-    name: "@nomiclabs/buidler-etherscan",
-    version: "1.0.0-beta.9",
-    url: "https://github.com/nomiclabs/buidler/tree/master/packages/buidler-etherscan",
-    description: "Automatically verify contracts on Etherscan",
-    tags: ["Etherscan", "Verification"],
-  }, {
-    name: "@nomiclabs/buidler-solpp",
-    version: "1.0.0-beta.9",
-    url: "https://github.com/nomiclabs/buidler/tree/master/packages/buidler-solpp",
-    description: "Automatically run the solpp preprocessor before each compilation",
-    tags: ["Solpp", "Preprocessor"],
-  }, {
-    name: "@nomiclabs/buidler-solhint",
-    version: "1.0.0-beta.9",
-    url: "https://github.com/nomiclabs/buidler/tree/master/packages/buidler-solhint",
-    description: "Easily run solhint to lint your Solidity code",
-    tags: ["Solhint", "Linter"]
-  }, {
-    name: "@nomiclabs/buidler-vyper",
-    version: "1.0.0-beta.9",
-    url: "https://github.com/nomiclabs/buidler/tree/master/packages/buidler-vyper",
-    description: "Adds support to compile Vyper smart contracts",
-    tags: ["Vyper", "Compiler"]
-  },
-  {
-    name: "buidler-gas-reporter",
-    version: "0.1.2",
-    url: "https://github.com/cgewecke/buidler-gas-reporter",
-    description: "Gas usage per unit test. Average gas usage per method. A mocha reporter.",
-    tags: ["Testing", "Gas"]
-  }
-];
-
 export default {
   data() {
-    return {"plugins": plugins};
+    return {"plugins": require("../plugins.js")};
   }
 }