diff --git a/docs/code_contribution_guide.md b/docs/code_contribution_guide.md deleted file mode 100644 index 3ff6334308..0000000000 --- a/docs/code_contribution_guide.md +++ /dev/null @@ -1,11 +0,0 @@ -Code contribution guide -======================= - -Remix is an open source tool and we encourage anyone to help us improve our tool. -You can do that by opening issues, giving feedback or by contributing a pull request -to our codebase. - -The Remix application is built with JavaScript and it doesn't use any framework. We only -rely on selected set of npm modules, like `yo-yo`, `csjs-inject` and others. Check out the `package.json` files in the Remix submodules to learn more about the stack. - -To learn more, please visit our [GitHub page](https://github.com/ethereum/remix-ide). diff --git a/docs/community.md b/docs/community.md deleted file mode 100644 index a76c8fd09d..0000000000 --- a/docs/community.md +++ /dev/null @@ -1,14 +0,0 @@ -Community -======================= - -We know that blockchain ecosystem is very new and that lots of information is scattered around the web. -That is why we created a community support channel where we and other users try to answer your questions if -you get stuck using Remix. Please, join [the community](https://gitter.im/ethereum/remix) and ask for help. - -For anyone who is interested in developing a custom plugin for Remix or who wants to contribute to the codebase, -we opened a [contributors' channel](https://gitter.im/ethereum/remix-dev) especially for developers working on Remix tools. - -We would kindly ask you to respect the space and to use it for -getting help with your work and the developers' channel for discussions related to working on Remix codebase. If you have -ideas for collaborations or you want to promote your project, try to find some more appropriate channels to do so. Or you can contact -the main contributors directly on Gitter or Twitter. diff --git a/docs/compile.md b/docs/compile.md deleted file mode 100644 index 8123ade117..0000000000 --- a/docs/compile.md +++ /dev/null @@ -1,28 +0,0 @@ -Compiler (Solidity) -=================== - -Clicking the Solidity icon in the icon panel brings you to the Solidty Compiler. - -Compiling is triggered when you click the compile button ( **A. in image below**). If you want the file to be compiled each time the file is saved or when another file is selected - check the auto compile checkbox ( **B. in image below**). - -If the contract has a lot of dependencies it can take a while to compile - so you use autocompilation at your discretion. - -![](images/a-sol-compiler.png) - -After each compilation, a list is updated with all the newly compiled -contracts. The contract compiled can be selected with the Contract pulldown menu ( **C. in image below**). Multiple contracts are compiled when one contract imports other contracts. Selecting a contract will show information about that one. - -When the "Compilation Details" button is clicked ( **D. in image below**), a modal opens displaying detailed information about the current selected contract. - -From this tab, you can also publish your contract to Swarm (only non -abstract contracts can be published). - -Published data notably contains the `abi` and solidity source code. - -After a contract is published, you can find its metadata information -using the bzz URL located in the details modal dialog `SWARM LOCATION`. - -Compilation Errors and Warning are displayed below the contract section. -At each compilation, the static analysis tab builds a report. It is very -valuable when addressing reported issues even if the compiler doesn't -complain. ([see more](static_analysis.html)) diff --git a/docs/conf.py b/docs/conf.py index 4e5b322071..e41ea2098e 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -48,10 +48,10 @@ master_doc = 'index' # General information about the project. project = u'Remix, Ethereum-IDE' -copyright = u'2018, Remix' +copyright = u'2019, Remix' author = u'Remix team' -github_doc_root = 'https://github.com/ethereum/remix/tree/master/docs/' +github_doc_root = 'https://github.com/ethereum/remix-ide/tree/master/docs/' # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the diff --git a/docs/contract_metadata.md b/docs/contract_metadata.md deleted file mode 100644 index 4806e30cd3..0000000000 --- a/docs/contract_metadata.md +++ /dev/null @@ -1,69 +0,0 @@ -Build Artifact -============== - -As compilation succeed Remix create a JSON file for each compiled contract. -These JSON files contains several metadata - -Library Deployment ------------------- - -By default Remix automatically deploy needed libraries. - -`linkReferences` contains a map representing libraries which depend on the current contract. -Values are addresses of libraries used for linking the contract. - -`autoDeployLib` defines if the libraries should be auto deployed by Remix or if the contract should be linked with libraries described in `linkReferences` - -Note that Remix will resolve addresses corresponding to the current network. -By default, a configuration key follow the form: `:`, but it is also possible -to define `` or `` as keys. - -``` -{ - "VM:-": { - "linkReferences": { - "browser/Untitled.sol": { - "lib": "
", - "lib2": "
" - } - }, - "autoDeployLib": true - }, - "main:1": { - "linkReferences": { - "browser/Untitled.sol": { - "lib": "
", - "lib2": "
" - } - }, - "autoDeployLib": true - }, - "ropsten:3": { - "linkReferences": { - "browser/Untitled.sol": { - "lib": "
", - "lib2": "
" - } - }, - "autoDeployLib": true - }, - "rinkeby:4": { - "linkReferences": { - "browser/Untitled.sol": { - "lib": "
", - "lib2": "
" - } - }, - "autoDeployLib": true - }, - "kovan:42": { - "linkReferences": { - "browser/Untitled.sol": { - "lib": "
", - "lib2": "
" - } - }, - "autoDeployLib": true - } -} -``` diff --git a/docs/create_deploy.md b/docs/create_deploy.md deleted file mode 100644 index 77279ca5cf..0000000000 --- a/docs/create_deploy.md +++ /dev/null @@ -1,108 +0,0 @@ -Creating and Deploying a Contract -================================ - -There are 3 type of environments Remix can be plugged to: -`Javascript VM`, `Injected provider`, or `Web3 provider`. (for details see [Running transactions](http://remix.readthedocs.io/en/latest/run_tab.html)) - -Both `Web3 provider` and `Injected provider` require the use of an -external tool. - -The external tool for `Web3 provider` is an Ethereum node and for -`Injected provider` Metamask. - -The `JavaScript VM` mode is convenient because each execution runs in -your browser and you don't need any other software or Ethereum node to run it. - -So, it is the easiest test environment - **no setup required!** - -But keep in mind that reloading the browser when you are in the Javascript VM will restart Remix in an empty state. - -For performance purposes ( which is to say - for testing in an environment that is closest to the mainnet), it might also be better to use an external node. - -Selecting the VM mode ---------------------- - -Make sure the VM mode is selected. All accounts displayed in `Accounts` -should have 100 ether. - -Sample contract ---------------- - -``` -{.sourceCode .none} -pragma solidity ^0.5.1; - -contract testContract { - - uint value; - - constructor (uint _p) public { - value = _p; - } - - function setP(uint _n) payable public { - value = _n; - } - - function setNP(uint _n) public { - value = _n; - } - - function get () view public returns (uint) { - return value; - } -} - -``` - -This contract is very basic. The goal is to quickly start to create and -to interact with a sample contract. - -Deploying an instance ---------------------- - -The `Compile tab` displays information related to the current contract -(note that there can be more than one) (see ../compile\_tab). - -Moving on, in the `Run tab` select, `JavaScript VM` to specify that you -are going to deploy an instance of the contract in the `JavaScript VM` -state. - -![](images/a-jvm.png) - -The constructor of `Ballot.sol` needs a parameter (of type `uint8`). -Give any value and click on `Deploy`. - -The transaction which deploys the instance of `Ballot` is created. - -In a "normal" blockchain, it can take several seconds to execute. This -is the time for the transaction to be mined. However, because we are -using the `JavaScript VM`, our execution is immediate. - -The terminal will inform you about the transaction. You can see details -there and start debugging. - -The newly created instance is displayed in the `run tab`. - -![](images/a-jvm-instance.png) - -Interacting with an instance ----------------------------- - -This new instance contains 3 actions which corresponds to the 3 -functions (`setP`, `setPN`, `get`). Clicking on `SetP` or `SetPN` will -create a new transaction. - -Note that `SetP` is `payable` (red button) : it is possible to send -value (Ether) to the contract. - -`SetPN` is not payable (orange button - depending on the theme) : it is not possible to send -value (Ether) to the contract. - -Clicking on `get` will not execute a transaction (usually its a blue button - depending on the theme). It doesn't execute a transaction because a `get` does not modify the state (variable -`value`) of this instance. - -As `get` is `view` you can see the return value just below the -action. - -![](images/a-jvm-calling-instance.png) diff --git a/docs/debugger.md b/docs/debugger.md deleted file mode 100644 index 8a5c0959ff..0000000000 --- a/docs/debugger.md +++ /dev/null @@ -1,12 +0,0 @@ -Debugger -======== - -This module allows you to debug the transaction. It can be used to -deploy transactions created from Remix and already mined transactions. -(debugging works only if the current environment provides the necessary -features). - -To get to the debugger - you can click the debug button in the terminal when a successful or failed transaction appears there. You can also load the module from the plugin manager and then click the bug in the icon panel. Or you can get to the debugger by running the debug command in the console. - - -![](images/a-debugger.png) diff --git a/docs/file_explorer.md b/docs/file_explorer.md deleted file mode 100644 index 8f09b973ea..0000000000 --- a/docs/file_explorer.md +++ /dev/null @@ -1,54 +0,0 @@ -File Explorer -============= - -To get to the file explorers - click the file explorers icon. - -![](images/a-file-explorer1.png) - -The file explorer lists by default all the files stored in your browser. -You can see them in the browser folder. You can always rename, remove or -add new files to the file explorer. - -Note that clearing the browser storage will permanently delete all the -solidity files you wrote. To avoid this, you can use Remixd, which -enables you to store and sync files in the browser with your local -computer ( for more information see [remixd](remixd.html) ). - -![](images/a-file-explorer-buttons.png) - -We will start by reviewing at the icons at the top left - from left to -the right: - -Create new File ---------------- - -Creates a new `untitled.sol` file in Remix. - -Add Local File --------------- - -Allows you to select files from the local file system and import them to -the Remix browser storage. - -Publish to Gist ---------------- - -Publishes all files from the browser folder to a gist. -Gist API has changed in 2018 and it unfortunately requires users to be authenticated to be able to publish a gist. - -Click [this link](https://github.com/settings/tokens) to Github tokens setup and select Generate new token. -Then check only Create gists checkbox and generate a new token. - -Then paste it in Remix (right panel/Settings tab) and click Save. Now you should be able to use the feature. - -Copy to another Remix instance ------------------------- - -Enables you to copy files from the browser storage to another instance -(URL) of Remix. - -Connect your filesystem to Remix --------------------- - -Allows to sync between Remix and your local file system (see -[more about RemixD](remixd.html)). diff --git a/docs/images/a-Runtab-deploy-atAddress.png b/docs/images/a-Runtab-deploy-atAddress.png deleted file mode 100644 index 89d3e77ef6..0000000000 Binary files a/docs/images/a-Runtab-deploy-atAddress.png and /dev/null differ diff --git a/docs/images/a-debug1-deploy.png b/docs/images/a-debug1-deploy.png deleted file mode 100644 index f2dedaf456..0000000000 Binary files a/docs/images/a-debug1-deploy.png and /dev/null differ diff --git a/docs/images/a-debug2-udapp1.png b/docs/images/a-debug2-udapp1.png deleted file mode 100644 index e2f35b3b56..0000000000 Binary files a/docs/images/a-debug2-udapp1.png and /dev/null differ diff --git a/docs/images/a-debug2-udapp1a.png b/docs/images/a-debug2-udapp1a.png deleted file mode 100644 index 0b57f61709..0000000000 Binary files a/docs/images/a-debug2-udapp1a.png and /dev/null differ diff --git a/docs/images/a-debug3-udapp2.png b/docs/images/a-debug3-udapp2.png deleted file mode 100644 index 56ae6a0dc7..0000000000 Binary files a/docs/images/a-debug3-udapp2.png and /dev/null differ diff --git a/docs/images/a-debug4-value-loc.png b/docs/images/a-debug4-value-loc.png deleted file mode 100644 index 61cdcab9ac..0000000000 Binary files a/docs/images/a-debug4-value-loc.png and /dev/null differ diff --git a/docs/images/a-debug5-term-debug-but.png b/docs/images/a-debug5-term-debug-but.png deleted file mode 100644 index 96bf3ca56e..0000000000 Binary files a/docs/images/a-debug5-term-debug-but.png and /dev/null differ diff --git a/docs/images/a-debugger.png b/docs/images/a-debugger.png deleted file mode 100644 index 2756ab6c47..0000000000 Binary files a/docs/images/a-debugger.png and /dev/null differ diff --git a/docs/images/a-file-explorer-buttons-big.png b/docs/images/a-file-explorer-buttons-big.png deleted file mode 100644 index 5f16de4d01..0000000000 Binary files a/docs/images/a-file-explorer-buttons-big.png and /dev/null differ diff --git a/docs/images/a-file-explorer-buttons.png b/docs/images/a-file-explorer-buttons.png deleted file mode 100644 index 9c6ee3f795..0000000000 Binary files a/docs/images/a-file-explorer-buttons.png and /dev/null differ diff --git a/docs/images/a-file-explorer1.png b/docs/images/a-file-explorer1.png deleted file mode 100644 index fbc53896fc..0000000000 Binary files a/docs/images/a-file-explorer1.png and /dev/null differ diff --git a/docs/images/a-home-page.png b/docs/images/a-home-page.png deleted file mode 100644 index f4ca8b0537..0000000000 Binary files a/docs/images/a-home-page.png and /dev/null differ diff --git a/docs/images/a-hometab.png b/docs/images/a-hometab.png deleted file mode 100644 index a48d9f61c0..0000000000 Binary files a/docs/images/a-hometab.png and /dev/null differ diff --git a/docs/images/a-icon-swap.png b/docs/images/a-icon-swap.png deleted file mode 100644 index 53cf741bd1..0000000000 Binary files a/docs/images/a-icon-swap.png and /dev/null differ diff --git a/docs/images/a-icons-at-load.png b/docs/images/a-icons-at-load.png deleted file mode 100644 index ce859729ed..0000000000 Binary files a/docs/images/a-icons-at-load.png and /dev/null differ diff --git a/docs/images/a-jvm-calling-instance.png b/docs/images/a-jvm-calling-instance.png deleted file mode 100644 index 7dc9a7adf1..0000000000 Binary files a/docs/images/a-jvm-calling-instance.png and /dev/null differ diff --git a/docs/images/a-jvm-instance.png b/docs/images/a-jvm-instance.png deleted file mode 100644 index 5ed6615c9d..0000000000 Binary files a/docs/images/a-jvm-instance.png and /dev/null differ diff --git a/docs/images/a-jvm.png b/docs/images/a-jvm.png deleted file mode 100644 index 851236b457..0000000000 Binary files a/docs/images/a-jvm.png and /dev/null differ diff --git a/docs/images/a-layout1.png b/docs/images/a-layout1.png deleted file mode 100644 index bb8ebbeda0..0000000000 Binary files a/docs/images/a-layout1.png and /dev/null differ diff --git a/docs/images/a-layout1a.png b/docs/images/a-layout1a.png deleted file mode 100644 index cee0ffe747..0000000000 Binary files a/docs/images/a-layout1a.png and /dev/null differ diff --git a/docs/images/a-layout1b.png b/docs/images/a-layout1b.png deleted file mode 100644 index 18e9aabc7c..0000000000 Binary files a/docs/images/a-layout1b.png and /dev/null differ diff --git a/docs/images/a-old-tuto_basicimport.png b/docs/images/a-old-tuto_basicimport.png deleted file mode 100644 index 81a8009336..0000000000 Binary files a/docs/images/a-old-tuto_basicimport.png and /dev/null differ diff --git a/docs/images/a-old-tuto_importgit.png b/docs/images/a-old-tuto_importgit.png deleted file mode 100644 index 022eb4b011..0000000000 Binary files a/docs/images/a-old-tuto_importgit.png and /dev/null differ diff --git a/docs/images/a-old-tuto_importswarm.png b/docs/images/a-old-tuto_importswarm.png deleted file mode 100644 index 01fba3e646..0000000000 Binary files a/docs/images/a-old-tuto_importswarm.png and /dev/null differ diff --git a/docs/images/a-plug.png b/docs/images/a-plug.png deleted file mode 100644 index 3161fe3a78..0000000000 Binary files a/docs/images/a-plug.png and /dev/null differ diff --git a/docs/images/a-plugin-man-local.png b/docs/images/a-plugin-man-local.png deleted file mode 100644 index b760bab001..0000000000 Binary files a/docs/images/a-plugin-man-local.png and /dev/null differ diff --git a/docs/images/a-remixd-success.png b/docs/images/a-remixd-success.png deleted file mode 100644 index bef13de555..0000000000 Binary files a/docs/images/a-remixd-success.png and /dev/null differ diff --git a/docs/images/a-runtab-recorder.png b/docs/images/a-runtab-recorder.png deleted file mode 100644 index 36d6b0528b..0000000000 Binary files a/docs/images/a-runtab-recorder.png and /dev/null differ diff --git a/docs/images/a-runtab1.png b/docs/images/a-runtab1.png deleted file mode 100644 index 138a93305f..0000000000 Binary files a/docs/images/a-runtab1.png and /dev/null differ diff --git a/docs/images/a-sol-compiler.png b/docs/images/a-sol-compiler.png deleted file mode 100644 index 87f90586e0..0000000000 Binary files a/docs/images/a-sol-compiler.png and /dev/null differ diff --git a/docs/images/a-sol-editor.png b/docs/images/a-sol-editor.png deleted file mode 100644 index b6c0cd5c58..0000000000 Binary files a/docs/images/a-sol-editor.png and /dev/null differ diff --git a/docs/images/a-static-analysis.png b/docs/images/a-static-analysis.png deleted file mode 100644 index e3d2cfe46e..0000000000 Binary files a/docs/images/a-static-analysis.png and /dev/null differ diff --git a/docs/images/a-terminal-and-more.png b/docs/images/a-terminal-and-more.png deleted file mode 100644 index 45d41644ca..0000000000 Binary files a/docs/images/a-terminal-and-more.png and /dev/null differ diff --git a/docs/images/a-themes.png b/docs/images/a-themes.png deleted file mode 100644 index bc48776de1..0000000000 Binary files a/docs/images/a-themes.png and /dev/null differ diff --git a/docs/images/a-unit-testing1.png b/docs/images/a-unit-testing1.png deleted file mode 100644 index 5e1b167584..0000000000 Binary files a/docs/images/a-unit-testing1.png and /dev/null differ diff --git a/docs/images/file-explorer-buttons.png b/docs/images/file-explorer-buttons.png deleted file mode 100644 index 9c6ee3f795..0000000000 Binary files a/docs/images/file-explorer-buttons.png and /dev/null differ diff --git a/docs/images/layout1b.png b/docs/images/layout1b.png deleted file mode 100644 index 18e9aabc7c..0000000000 Binary files a/docs/images/layout1b.png and /dev/null differ diff --git a/docs/images/remix_analysistab.png b/docs/images/remix_analysistab.png deleted file mode 100755 index e43143962c..0000000000 Binary files a/docs/images/remix_analysistab.png and /dev/null differ diff --git a/docs/images/remix_compiletab.png b/docs/images/remix_compiletab.png deleted file mode 100755 index cd51b11574..0000000000 Binary files a/docs/images/remix_compiletab.png and /dev/null differ diff --git a/docs/images/remix_debuggertab.png b/docs/images/remix_debuggertab.png deleted file mode 100755 index 104d9744b2..0000000000 Binary files a/docs/images/remix_debuggertab.png and /dev/null differ diff --git a/docs/images/remix_editor.png b/docs/images/remix_editor.png deleted file mode 100755 index 9260f05fe4..0000000000 Binary files a/docs/images/remix_editor.png and /dev/null differ diff --git a/docs/images/remix_file_explorer_browser.png b/docs/images/remix_file_explorer_browser.png deleted file mode 100755 index 3f09c0c752..0000000000 Binary files a/docs/images/remix_file_explorer_browser.png and /dev/null differ diff --git a/docs/images/remix_file_explorer_menu.png b/docs/images/remix_file_explorer_menu.png deleted file mode 100755 index 2140e9b36c..0000000000 Binary files a/docs/images/remix_file_explorer_menu.png and /dev/null differ diff --git a/docs/images/remix_quickstart_javascriptvm_callinginstance.png b/docs/images/remix_quickstart_javascriptvm_callinginstance.png deleted file mode 100644 index fe11a2cb06..0000000000 Binary files a/docs/images/remix_quickstart_javascriptvm_callinginstance.png and /dev/null differ diff --git a/docs/images/remix_quickstart_javascriptvm_creation.png b/docs/images/remix_quickstart_javascriptvm_creation.png deleted file mode 100644 index fc7598aea7..0000000000 Binary files a/docs/images/remix_quickstart_javascriptvm_creation.png and /dev/null differ diff --git a/docs/images/remix_quickstart_javascriptvm_creationTransaction.png b/docs/images/remix_quickstart_javascriptvm_creationTransaction.png deleted file mode 100644 index 0b27bc105f..0000000000 Binary files a/docs/images/remix_quickstart_javascriptvm_creationTransaction.png and /dev/null differ diff --git a/docs/images/remix_recorder.png b/docs/images/remix_recorder.png deleted file mode 100644 index 1f7abc7363..0000000000 Binary files a/docs/images/remix_recorder.png and /dev/null differ diff --git a/docs/images/remix_runtab.png b/docs/images/remix_runtab.png deleted file mode 100755 index c636298493..0000000000 Binary files a/docs/images/remix_runtab.png and /dev/null differ diff --git a/docs/images/remix_runtab_example.png b/docs/images/remix_runtab_example.png deleted file mode 100755 index 78fba7e994..0000000000 Binary files a/docs/images/remix_runtab_example.png and /dev/null differ diff --git a/docs/images/remix_settingstab.png b/docs/images/remix_settingstab.png deleted file mode 100755 index bfd50332e1..0000000000 Binary files a/docs/images/remix_settingstab.png and /dev/null differ diff --git a/docs/images/remix_supporttab.png b/docs/images/remix_supporttab.png deleted file mode 100755 index b62ead496b..0000000000 Binary files a/docs/images/remix_supporttab.png and /dev/null differ diff --git a/docs/images/remix_terminal.png b/docs/images/remix_terminal.png deleted file mode 100755 index 3f096a2490..0000000000 Binary files a/docs/images/remix_terminal.png and /dev/null differ diff --git a/docs/images/remix_unittest.png b/docs/images/remix_unittest.png deleted file mode 100644 index c94077524c..0000000000 Binary files a/docs/images/remix_unittest.png and /dev/null differ diff --git a/docs/import.md b/docs/import.md deleted file mode 100644 index a576d24586..0000000000 --- a/docs/import.md +++ /dev/null @@ -1,39 +0,0 @@ -Importing Source Files in Solidity -================================== - -It is essential to know all many techniques for importing files. - -For a tutorial about importing files see this [tutorial](https://github.com/ethereum/remix-workshops/tree/master/loading_via_npm_github_plugin). - -For a detailed explanation of the `import` keyword see the -[Solidity documentation](https://solidity.readthedocs.io/en/develop/layout-of-source-files.html?highlight=import#importing-other-source-files) - -Here are a some of the main methods of importing a file: - -Importing a file from the browser's local storage -------------------------------------------------- - -Files in Remix can be imported just by specifying their path. Please use ./ for relative paths to increase portability. -![](images/a-old-tuto_basicimport.png) - -Importing a file from your computer's filesystem -------------------------------------------------- - -This method uses **remixd** - the remix daemon. Please go to the [remixd tutorial](remixd.html) for instructions about how to bridge the divide between the browser and your computers filesystem. - - -Importing from GitHub ---------------------- - -It is possible to import files directly from GitHub with URLs like -`https://github.com///`. - -![](images/a-old-tuto_importgit.png) - -Importing from Swarm --------------------- - -Files can be imported using all URLs supported by swarm. If you do not -have a swarm node, then use swarm-gateways.net. - -![](images/a-old-tuto_importswarm.png) diff --git a/docs/index.rst b/docs/index.rst index a2b8905151..1bcf167c48 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,88 +1,4 @@ -Welcome to Remix documentation! +Remix documentation has moved! =============================== -Remix is a powerful, open source tool that helps you write Solidity contracts straight from the browser. -Written in JavaScript, Remix supports both usage in the browser and locally. - -Remix also supports testing, debugging and deploying of smart contracts and much more. - -Our Remix project with all its features is available -at `remix.ethereum.org `__ and more information can be found in these -docs. Our IDE tool is available at `our GitHub repository -`__. - -This set of documents covers instructions on how to use Remix and some tutorials to help you get started. - -Useful links: - -- `Solidity documentation `__ - -- `Remix alpha `__ - The version where we test new Remix release (not stable!). - -- `Ethereum StackExchange for Remix `__ - -- `Community support channel `__ - -- `Ðapp Developer resources (Ethereum wiki) `__ - -.. toctree:: - :maxdepth: 2 - :caption: New Layout Intro - - layout - -.. toctree:: - :maxdepth: 2 - :caption: Tour of default modules - - file_explorer - plugin_manager - settings - solidity_editor - terminal - -.. toctree:: - :maxdepth: 2 - :caption: Tour of typical solidity modules - - compile - run - udapp - debugger - static_analysis - -.. toctree:: - :maxdepth: 2 - :caption: Using Remix - - contract_metadata - create_deploy - import - remixd - unittesting - -.. toctree:: - :maxdepth: 2 - :caption: Building Plugins - - remix_plugin.md - -.. toctree:: - :maxdepth: 2 - :caption: URLs & Downloads - - locations - -.. toctree:: - :maxdepth: 2 - :caption: Tutorials and workshops slides - - remix_tutorials_github - -.. toctree:: - :maxdepth: 2 - :caption: Code contribution guide - - code_contribution_guide - community - support +Please go to `remix-ide.readthedocs.io `__ diff --git a/docs/layout.md b/docs/layout.md deleted file mode 100644 index 2cbeed1066..0000000000 --- a/docs/layout.md +++ /dev/null @@ -1,54 +0,0 @@ -Remix-IDE Layout -============== - -The new structure --------------------- -![](images/a-layout1b.png) - -1. Icon Panel - click to change which plugin appears in the Swap Panel -2. Swap Panel - Most but not all plugins will have their GUI here. -3. Main Panel - In the old layout this was just for editing files. In the tabs can be plugins or files for the IDE to compile. -4. Terminal - where you will see the results of your interactions with the GUI's. Also you can run scripts here. - -Icon Panel at Page Load ------------------------ -When you load remix - the icon panel show these icons by default. - -![](images/a-icons-at-load.png) - -Everything in remix is now a plugin... so the **[Plugin Manager](#plugin-manager)** is very important. -In the old layout, each basic task in remix was separated into the tabs. Now these tabs are plugins. - -But to activate a half a dozen plugins - (or however many you are using) each time the page load is **tedious**. So learn about the **[Environments](#environments)**. - -Homepage --------- - -![](images/a-hometab.png) - -The homepage is located in a tab in the Main Panel. - -You can also get there by clicking the remix logo at the top of the icon panel. - -### Environments -Clicking on one of the environment buttons loads up a collection of plugins. We currently have a **Solidity** Button and a **Vyper** button. In the future you will be able to save your own environment. - -To see all the plugins go to the **plugin manager** - by selecting the plug in the icon panel. -![](images/a-plug.png) - -The environment buttons are time & sanity savers - so you don't need to go to the plugin manager to get started everytime you load the page. - - -Plugin Manager ---------------- - -In order to make Remix flexible for integrating changes into its functionality and for integrating remix into other projects (your's for example), we've now made everything a plugin. This means that you only load the functionality you need. It also means that you need a place to turn off and on plugins - as your needs change. This all happens in the plug manager. - -The Plugin Manager is also the place you go when you are creating your own plugin and you want to load your local plugin into Remix. In that case you'd click on the "Connect to a Local Plugin" link at the top of the Plugin Manager panel. - -Themes ---------------- - -So you want to work on Remix with a dark theme or a gray theme or just a different theme that the one you are currently looking at? Go to the settings tab and at the bottom is a choice of lots of bootstrap based themes. - -![](images/a-themes.png) diff --git a/docs/locations.md b/docs/locations.md deleted file mode 100644 index 51e50e8a7a..0000000000 --- a/docs/locations.md +++ /dev/null @@ -1,10 +0,0 @@ -Finding Remix -============= - -So if you've found the documentation to Remix but don't know where to find Remix or if you want to run the remix-ide locally and want to find out where to download it - this page is here to help. - -- An online version is available at [https://remix.ethereum.org](https://remix.ethereum.org). This version is stable and is updated at almost every release. -- An alpha online version is available at [https://remix-alpha.ethereum.org](https://remix-alpha.ethereum.org). This is not a stable version. -- npm `remix-ide` package `npm install remix-ide -g`. `remix-ide` create a new instance of `Remix IDE` available at [http://127.0.0.1:8080](http://127.0.0.1:8080) and make the current folder available to Remix IDE by automatically starting `remixd`. -see [Connection to `remixd`](http://remix.readthedocs.io/en/latest/tutorial_remixd_filesystem.html) for more information about sharing local file with `Remix IDE`. -- Github release: [https://github.com/ethereum/remix-ide/releases](https://github.com/ethereum/remix-ide/releases) . The source code is packaged at every release but still need to be built using `npm run build`. diff --git a/docs/mist1.png b/docs/mist1.png deleted file mode 100644 index cd2991e2fd..0000000000 Binary files a/docs/mist1.png and /dev/null differ diff --git a/docs/plugin_manager.md b/docs/plugin_manager.md deleted file mode 100644 index 9c95b45661..0000000000 --- a/docs/plugin_manager.md +++ /dev/null @@ -1,22 +0,0 @@ -Plugin Manager -=================== - -## Everything is a PLUGIN in Remix - -In order to integrate new tools made by us and by ...you into Remix, we've now made everything a plugin. -This architcture will also allow Remix or just parts of Remix to be integrated into other projects (your's for example). - -This means that you only load the functionality you need. - -It also means that you can turn off and on plugins - as your needs change. - -This all happens in the plug manager. - -The Plugin Manager is also the place you go when you are creating your own plugin and you want to load your local plugin into Remix. - -To load your local plugin, you'd click on the "Connect to a Local Plugin" link at the top of the Plugin Manager panel. - -![](images/a-plugin-man-local.png) - -To learn more about how to create your own plugin, go to -[the README of remix-plugin repo](https://github.com/ethereum/remix-plugin). diff --git a/docs/remix1.png b/docs/remix1.png deleted file mode 100644 index 7575d34f6c..0000000000 Binary files a/docs/remix1.png and /dev/null differ diff --git a/docs/remix2.png b/docs/remix2.png deleted file mode 100644 index 17a53affd9..0000000000 Binary files a/docs/remix2.png and /dev/null differ diff --git a/docs/remix3.png b/docs/remix3.png deleted file mode 100644 index 060352a755..0000000000 Binary files a/docs/remix3.png and /dev/null differ diff --git a/docs/remix4.png b/docs/remix4.png deleted file mode 100644 index 404ed50572..0000000000 Binary files a/docs/remix4.png and /dev/null differ diff --git a/docs/remix5.png b/docs/remix5.png deleted file mode 100644 index 4297d58adc..0000000000 Binary files a/docs/remix5.png and /dev/null differ diff --git a/docs/remix_breakpoint.png b/docs/remix_breakpoint.png deleted file mode 100644 index c755f61348..0000000000 Binary files a/docs/remix_breakpoint.png and /dev/null differ diff --git a/docs/remix_debuginstructions.png b/docs/remix_debuginstructions.png deleted file mode 100644 index bb36decbaf..0000000000 Binary files a/docs/remix_debuginstructions.png and /dev/null differ diff --git a/docs/remix_debugtransactioninfo.png b/docs/remix_debugtransactioninfo.png deleted file mode 100644 index 92d2e33100..0000000000 Binary files a/docs/remix_debugtransactioninfo.png and /dev/null differ diff --git a/docs/remix_enterdebugsession.png b/docs/remix_enterdebugsession.png deleted file mode 100644 index 77acc520ee..0000000000 Binary files a/docs/remix_enterdebugsession.png and /dev/null differ diff --git a/docs/remix_executionexception.png b/docs/remix_executionexception.png deleted file mode 100644 index 9f28396b8a..0000000000 Binary files a/docs/remix_executionexception.png and /dev/null differ diff --git a/docs/remix_navigation.png b/docs/remix_navigation.png deleted file mode 100644 index d4187a462a..0000000000 Binary files a/docs/remix_navigation.png and /dev/null differ diff --git a/docs/remix_plugin.md b/docs/remix_plugin.md deleted file mode 100644 index 95ccd300f7..0000000000 --- a/docs/remix_plugin.md +++ /dev/null @@ -1,4 +0,0 @@ -Remix Plugin -============ - -The best documentation about how to build a plugin is currently in [the readme of remix-plugin repo](https://github.com/ethereum/remix-plugin). Please go [here](https://github.com/ethereum/remix-plugin) to learn all about it. diff --git a/docs/remix_plugin_api.md b/docs/remix_plugin_api.md deleted file mode 100644 index 1c6f66e1ba..0000000000 --- a/docs/remix_plugin_api.md +++ /dev/null @@ -1,60 +0,0 @@ -Remix Plugin API usage -====================== - -This section list all the available key and value pair which define this API: - -## 1) notifications - -### app (key: app) - - - unfocus `[]` - - focus `[]` - -### compiler (key: compiler) - - - compilationFinished `[success (bool), data (obj), source (obj)]` - - compilationData `[compilationResult (obj)]` - -### transaction listener (key: txlistener) - - - newTransaction `[tx (obj)]` - -### addendum - -`newTransaction` is broadcasted to all loaded plugins. -`compilationFinished` is sent to the plugin that currently has the focus. -`focus / unfocus` is sent to the plugin which currently has the focus or is unfocused. -`compilationData` is sent always just upon the `focus` event and gives the last compilation result. - -## 2) requests - -### app - - - getExecutionContextProvider `@return {String} provider (injected | web3 | vm)` - - getProviderEndpoint `@return {String} provider endpoint url if web3, returns an error if injected or javascript VM` - - updateTitle `@param {String} title` - -### config - - - setConfig `@param {String} path, @param {String} content` - - getConfig `@param {String} path` - - removeConfig `@param {String} path` - -### compiler - - getCompilationResult `@return {Object} compilation result` - -### udapp (only VM) - - runTx `@param {Object} tx` - - getAccounts `@return {Array} acccounts` - - createVMAccount `@param {String} privateKey, @param {String} balance (hex)` - -### editor - - getCurrentFile `@return {String} current file path displayed in the editor` - - getFile `@param {String} path` - - setFile `@param {String} path, @param {String} content` - - highlight `@param {Object} lineColumnPos, @param {String} filePath, @param {String} hexColor` - - - - - diff --git a/docs/remix_soliditylocals.png b/docs/remix_soliditylocals.png deleted file mode 100644 index bfa627d1a4..0000000000 Binary files a/docs/remix_soliditylocals.png and /dev/null differ diff --git a/docs/remix_soliditystate.png b/docs/remix_soliditystate.png deleted file mode 100644 index 789df079e2..0000000000 Binary files a/docs/remix_soliditystate.png and /dev/null differ diff --git a/docs/remix_startdebugging.png b/docs/remix_startdebugging.png deleted file mode 100644 index bf5287a5c3..0000000000 Binary files a/docs/remix_startdebugging.png and /dev/null differ diff --git a/docs/remix_stepdetail.png b/docs/remix_stepdetail.png deleted file mode 100644 index efde21304e..0000000000 Binary files a/docs/remix_stepdetail.png and /dev/null differ diff --git a/docs/remix_tutorials_github.md b/docs/remix_tutorials_github.md deleted file mode 100644 index 5373c23029..0000000000 --- a/docs/remix_tutorials_github.md +++ /dev/null @@ -1,37 +0,0 @@ -Remix Tutorials -======================= - -There are a series of tutorials in our github repo [remix-workshops](https://github.com/ethereum/remix-workshops). - -We are in the process of upgrading these tutorials to use the new Remix layout. - -In this repo there tutorials for all levels. - -There are tutorials for specific remix functionalities like: - -***Deploying*** - - Multiple ways of loading files in Remix - Deploying with libraries - Deploying a proxy contract - -***Testing*** - - Testing Examples - Continuous integration - -***Remix Plugin Development*** - - Developing a plugin for Remix and deploying it to swarm - -***Other*** - - EtherAtom (walkthrough slides + screencast) - Debugging transactions with Remix IDE - Recording and replaying transactions - Using a Pipeline plugin for developing Solidity contracts with demo video - Running scripts in the Remix terminal (batch deployment) (proxy deployment) - -***Additional external workshops*** - - Using Oraclize plugin in Remix diff --git a/docs/remix_valueinput.png b/docs/remix_valueinput.png deleted file mode 100644 index 381ebfc86a..0000000000 Binary files a/docs/remix_valueinput.png and /dev/null differ diff --git a/docs/remixd.md b/docs/remixd.md deleted file mode 100644 index f96e6f5d44..0000000000 --- a/docs/remixd.md +++ /dev/null @@ -1,57 +0,0 @@ -Remixd: Get access your local filesystem -========================================= - -`remixd` is an npm module. Its purpose is to give the remix web -application access to a folder on your local computer. - -The code of `remixd` is -[here](https://github.com/ethereum/remixd) . - -`remixd` can be globally installed using the following command: -`npm install -g remixd` - -You can install it just in the directory of your choice using this command: -`npm install remixd` - -Then `remixd -s --remix-ide ` will start `remixd` and will share the given folder. - -For example, to sync your local folder to the official Remix IDE, -`remixd -s --remix-ide https://remix.ethereum.org` - -The folder is shared using a websocket connection between `Remix IDE` -and `remixd`. - -Be sure the user executing `remixd` has read/write permission on the -folder. - -There is an option to run remixd in read-only mode, use `--read-only` flag. - -**Warning!** - -`remixd` provides `full read and write access` to the given folder for `any -application` that can access the `TCP port 65520` on your local host. - -From `Remix IDE`, in the Plugin Manager you need to activate the remixd plugin. - -A modal dialog will ask confirmation - -Accepting this dialog will start a session. - -If you do not have `remixd` running in the background - another modal will open up and it will say: - -``` -Cannot connect to the remixd daemon. -Please make sure you have the remixd running in the background. -``` - -Assuming you don't get the 2nd modal, your connection to the remixd daemon is successful. The shared folder will be available in the file explorer. - -**When you click the activation of remixd is successful - there will NOT be an icon that loads in the icon panel.** - -Click the File Explorers icon and in the swap panel you should now see the folder for `localhost`. - -Click on the `localhost connection` icon: - -![](images/a-remixd-success.png) - - diff --git a/docs/remixd_alert.png b/docs/remixd_alert.png deleted file mode 100644 index d64e6f7214..0000000000 Binary files a/docs/remixd_alert.png and /dev/null differ diff --git a/docs/remixd_connectionok.png b/docs/remixd_connectionok.png deleted file mode 100644 index e8381f55df..0000000000 Binary files a/docs/remixd_connectionok.png and /dev/null differ diff --git a/docs/remixd_noconnection.png b/docs/remixd_noconnection.png deleted file mode 100644 index b6cd6f5b40..0000000000 Binary files a/docs/remixd_noconnection.png and /dev/null differ diff --git a/docs/run.md b/docs/run.md deleted file mode 100644 index 62a8e8fd1c..0000000000 --- a/docs/run.md +++ /dev/null @@ -1,282 +0,0 @@ -Run & Deploy -============ - -The Run tab allows you to send transactions to the current environment. - -To get to the Run & Deploy module - click the run icon in the icon panel. - -In order to use this module you need to have a contract compiled. So if there is file name in the contract pulldown menu ( in the image below it's the pulldown that says **Ballot**), then you can interact with this contract. If nothing is there - then you need to select a contract - make it the active contract in the main panel, ( in the image below - on the right side of the page - in the main panel - you see the ballot.sol so it is the active contract) then go to the compiler module and compile it. - -![](images/a-runtab1.png) - -Run Setup ---------- - -The following settings allow you to directly influence the transaction -execution: - -Environment: - -- `JavaScript VM`: All the transactions will be executed in - a sandbox blockchain in the browser. This means nothing - will be persisted and a page reload will restart a new - blockchain from scratch, the old one will not be saved. - -- `Injected Provider`: Remix will connect to an injected - web3 provider. `Metamask` is an example of - providers that inject web3, thus can be used with this - option. - -- `Web3 Provider`: Remix will connect to a remote node. You - will need to provide the URL address to the selected - provider: geth, parity or any Ethereum client. - -- Account: the list of accounts associated with the current - environment (and their associated balances). - -- Gas Limit: the maximum amount of gas that can be set for all the - transactions created in Remix. - -- Value: the amount of value for the next created transaction (this - value is always reset to 0 after each transaction execution). - - ![](images/a-Runtab-deploy-atAddress.png) - -Initiate Instance ------------------ - -This section contains the list of compiled contracts and 2 actions: - -- `At Address` assumes the given address is an instance of the - selected contract. It is then possible to interact with an already - deployed contract. There's no check at this point, so be careful - when using this feature, and be sure you trust the contract at that - address. - -- `Deploy` send a transaction that deploys the selected contract. When - the transaction is mined, the newly created instance will be added - (this might take several seconds). Note that if the `constructor` - has parameters, you need to specify them. - -Pending Instances ------------------ - -Validating a transaction take several seconds. During this time, the GUI -shows it in a pending mode. When transaction is mined the number of -pending transactions is updated and the transaction is added to the log -(see ../terminal) - -Using the ABI ------------- - -Using `Deploy` or `At Address` is a classic use case of Remix. It is -possible though to interact with a contract by using its ABI. The ABI is -a JSON array which describe its interface. - -To interact with a contract using the ABI, create a new file in Remix -with extension `*.abi` and copy the ABI content to it. Then in the input -next to `At Address`, put the Address of the contract you want to -interact with. Click on `At Address`, a new "connection" with the -contract will popup below. - -Using the Recorder ------------------- - -The Recorder allows to save a bunch of transactions in a JSON file and -rerun them later either in the same environment or in another. - -Saving to JSON allows to easily check the transaction list, tweak input -parameters, change linked library, etc... - -We can find many use cases for the recorder, for instance: -: - After having coded and tested contracts in a constrained - environment (like the JavaScript VM), it could be interesting to - redeploy them easily in a more persisted environment (like a - Geth node) in order to check whether everything behaves normally - in a classic environment. - - Deploying contract does often require more than creating one - transaction. - - Working in a dev environment does often require to setup the - state in a first place. - -![](images/a-runtab-recorder.png) - -Saving a record ends up with the creation of this type of content (see -below): - -In that specific record, 3 transactions are executed: - -The first corresponds to the deployment of the lib `testLib`. - -The second corresponds to the deployment of the contract `test`, the -first parameter of the constructor is set to 11. That contract depends -on a library. The linkage is done using the property `linkReferences`. -In that case we use the addres of the previously created library : -`created{1512830014773}`. the number is the id (timestamp) of the -transaction that leads to the creation of the library. - -The third parameter corresponds to the call to the function `set` of the -contract `test` (the property to is set to: `created{1512830015080}`) . -Input parameters are `1` and -`0xca35b7d915458ef540ade6068dfe2f44e8fa733c` - -all these transactions are created using the value of the accounts -`account{0}`. - -``` -{.sourceCode .none} -{ -"accounts": { - "account{0}": "0xca35b7d915458ef540ade6068dfe2f44e8fa733c" -}, -"linkReferences": { - "testLib": "created{1512830014773}" -}, -"transactions": [ - { - "timestamp": 1512830014773, - "record": { - "value": "0", - "parameters": [], - "abi": "0xbc36789e7a1e281436464229828f817d6612f7b477d66591ff96a9e064bcc98a", - "contractName": "testLib", - "bytecode": "60606040523415600e57600080fd5b60968061001c6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680636d4ce63c146044575b600080fd5b604a6060565b6040518082815260200191505060405180910390f35b6000610d809050905600a165627a7a7230582022d123b15248b8176151f8d45c2dc132063bcc9bb8d5cd652aea7efae362c8050029", - "linkReferences": {}, - "type": "constructor", - "from": "account{0}" - } - }, - { - "timestamp": 1512830015080, - "record": { - "value": "100", - "parameters": [ - 11 - ], - "abi": "0xc41589e7559804ea4a2080dad19d876a024ccb05117835447d72ce08c1d020ec", - "contractName": "test", - "bytecode": "60606040526040516020806102b183398101604052808051906020019091905050806000819055505061027a806100376000396000f300606060405260043610610062576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680632f30c6f61461006757806338cc48311461009e57806362738998146100f357806387cc10e11461011c575b600080fd5b61009c600480803590602001909190803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610145565b005b34156100a957600080fd5b6100b1610191565b604051808273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390f35b34156100fe57600080fd5b6101066101bb565b6040518082815260200191505060405180910390f35b341561012757600080fd5b61012f6101c4565b6040518082815260200191505060405180910390f35b8160008190555080600160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055505050565b6000600160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b60008054905090565b600073__browser/ballot.sol:testLib____________636d4ce63c6000604051602001526040518163ffffffff167c010000000000000000000000000000000000000000000000000000000002815260040160206040518083038186803b151561022e57600080fd5b6102c65a03f4151561023f57600080fd5b505050604051805190509050905600a165627a7a72305820e0b2510bb2890a0334bfe5613d96db3e72442e63b514cdeaee8fc2c6bbd19d3a0029", - "linkReferences": { - "browser/ballot.sol": { - "testLib": [ - { - "length": 20, - "start": 511 - } - ] - } - }, - "name": "", - "type": "constructor", - "from": "account{0}" - } - }, - { - "timestamp": 1512830034180, - "record": { - "value": "1000000000000000000", - "parameters": [ - 1, - "0xca35b7d915458ef540ade6068dfe2f44e8fa733c" - ], - "to": "created{1512830015080}", - "abi": "0xc41589e7559804ea4a2080dad19d876a024ccb05117835447d72ce08c1d020ec", - "name": "set", - "type": "function", - "from": "account{0}" - } - } -], -"abis": { - "0xbc36789e7a1e281436464229828f817d6612f7b477d66591ff96a9e064bcc98a": [ - { - "constant": true, - "inputs": [], - "name": "get", - "outputs": [ - { - "name": "", - "type": "uint256" - } - ], - "payable": false, - "stateMutability": "view", - "type": "function" - } - ], - "0xc41589e7559804ea4a2080dad19d876a024ccb05117835447d72ce08c1d020ec": [ - { - "constant": true, - "inputs": [], - "name": "getInt", - "outputs": [ - { - "name": "", - "type": "uint256" - } - ], - "payable": false, - "stateMutability": "view", - "type": "function" - }, - { - "constant": true, - "inputs": [], - "name": "getFromLib", - "outputs": [ - { - "name": "", - "type": "uint256" - } - ], - "payable": false, - "stateMutability": "view", - "type": "function" - }, - { - "constant": true, - "inputs": [], - "name": "getAddress", - "outputs": [ - { - "name": "", - "type": "address" - } - ], - "payable": false, - "stateMutability": "view", - "type": "function" - }, - { - "constant": false, - "inputs": [ - { - "name": "_t", - "type": "uint256" - }, - { - "name": "_add", - "type": "address" - } - ], - "name": "set", - "outputs": [], - "payable": true, - "stateMutability": "payable", - "type": "function" - }, - { - "inputs": [ - { - "name": "_r", - "type": "uint256" - } - ], - "payable": true, - "stateMutability": "payable", - "type": "constructor" - } - ] -} -} -``` diff --git a/docs/settings.md b/docs/settings.md deleted file mode 100644 index 2f78eb52f0..0000000000 --- a/docs/settings.md +++ /dev/null @@ -1,14 +0,0 @@ -Settings -======== - -To get to **Settings** click the gear a the very bottom of the icon panel. - -You can find a link to the homepage (if you closed it) as well as a link to our Gitter Channel and for you aesthetes out there, we now have a rather large list of themes. - -![](images/a-themes.png) - -Another important settings: - -- Text wrap: controls if the text in the editor should be wrapped. - -- Enable optimization: defines if the compiler should enable optimization during compilation. Enabling this option saves execution gas. It is useful to enable optimization for contracts ready to be deployed in production but could lead to some inconsistencies when debugging such a contract. diff --git a/docs/solidity_editor.md b/docs/solidity_editor.md deleted file mode 100644 index f492dab9a9..0000000000 --- a/docs/solidity_editor.md +++ /dev/null @@ -1,18 +0,0 @@ -Solidity Editor -=============== - -The Remix editor recompiles the code each time the current file is -changed or another file is selected. It also provides syntax -highlighting mapped to solidity keywords. - -![](images/a-sol-editor.png) - -Here's the list of some important features: - -- It display opened files as tabs. -- Compilation Warning and Error are displayed in the gutter -- Remix saves the current file continuously (5s after the last - changes) -- +/- on the top left corner enable you to increase/decrease the font - size of the editor - diff --git a/docs/static_analysis.md b/docs/static_analysis.md deleted file mode 100644 index ac3de2ed7e..0000000000 --- a/docs/static_analysis.md +++ /dev/null @@ -1,33 +0,0 @@ -Analysis -======== - -This section gives information about the last compilation. By default, a -new analysis is run at each compilation. - -The analysis tab gives detailed information about the contract code. It -can help you avoid code mistakes and to enforce best practices. - -![](images/a-static-analysis.png) - -Here is the list of analyzers: - -Security: -- Transaction origin: Warns if tx.origin is used -- Check effects: Avoid potential reentrancy bugs -- Inline assembly: Use of Inline Assembly -- Block timestamp: Semantics maybe unclear -- Low level calls: Semantics maybe unclear -- Block.blockhash usage: Semantics maybe unclear - - -Gas & Economy: -- Gas costs: Warns if the gas requirements of the functions - are too high -- This on local calls: Invocation of local functions via - this - -Miscellaneous: -- Constant functions: Checks for potentially constant - functions -- Similar variable names: Checks if variable names are too - similar diff --git a/docs/support.md b/docs/support.md deleted file mode 100644 index 85dfb873c5..0000000000 --- a/docs/support.md +++ /dev/null @@ -1,9 +0,0 @@ -Support chat -======================= - -We know that blockchain ecosystem is very new and that lots of information is scattered around the web. -That is why we created a community support chat where we and other users try to answer your questions if -you get stuck using Remix. Please, join [the Remix channel](https://gitter.im/ethereum/remix) and ask the community for help. - -For anyone who is interested in developing a custom plugin for Remix or who wants to contribute to the codebase, -we've opened [another channel](https://gitter.im/ethereum/remix-dev) specially for developers working on Remix tool. diff --git a/docs/terminal.md b/docs/terminal.md deleted file mode 100644 index 56fdb7c2fd..0000000000 --- a/docs/terminal.md +++ /dev/null @@ -1,21 +0,0 @@ -Terminal -======== - -![](images/a-terminal-and-more.png) - -Features, available in the terminal: - -- It integrates a JavaScript interpreter and the `web3` object. It - enables the execution of the JavaScript script which interacts with - the current context. (note that `web3` is only available if the - `web provider` or `injected provider` mode is selected). -- It displays important actions made while interacting with the Remix - IDE (i.e. sending a new transaction). -- It displays transactions that are mined in the current context. You - can choose to display all transactions or only transactions that - refers to the contracts Remix knows (e.g transaction created from - the Remix IDE). -- It allows searching for the data and clearing the logs from the - terminal. -- You can run scripts by inputting them at the bottom after the `>`. - diff --git a/docs/tutorial_debug.md b/docs/tutorial_debug.md deleted file mode 100644 index f85712faa0..0000000000 --- a/docs/tutorial_debug.md +++ /dev/null @@ -1,239 +0,0 @@ -Debugging transactions -====================== - -There are two ways to start debugging, each one corresponds to a different use case. -* from the transaction log in the Terminal - use this when you are want to debug a "sucessful" transaction. -* from the Debugger - use this if you have a *transaction hash* or a *block number* with a *transaction index*. - -### Debug from the Transaction GUI - - -Let's start with a basic contract (or replace this one by your own): -- create a blank file in the file explorer (by clicking the + icon) and give it a name. -- copy the code below. -- compile the code. -- click the Run & Deploy icon in the icon panel. - -``` -{.sourceCode .none} - RS why is this here? -pragma solidity >=0.5.1 <0.6.0; -contract Donation { - address owner; - event fundMoved(address _to, uint _amount); - modifier onlyowner { if (msg.sender == owner) _; } - address[] _giver; - uint[] _values; - - constructor() public { - owner = msg.sender; - } - - function donate() payable public { - addGiver(msg.value); - } - - function moveFund(address payable _to, uint _amount) onlyowner public { - uint balance = address(this).balance; - uint amount = _amount; - if (_amount <= balance) { - if (_to.send(balance)) { - emit fundMoved(_to, _amount); - } else { - revert(); - } - } else { - revert(); - } - } - - function addGiver(uint _amount) internal { - _giver.push(msg.sender); - _values.push(_amount); - } -} -``` - -For the purpose of this tutorial, we will run the `JavaScript VM`. -This simulates a custom blockchain. You could do the same using a proper backend node. - -Let's deploy the contract: - -Click the `Deploy` button - -![](images/a-debug1-deploy.png) - -You'll see the deployed instance (AKA the udapp). - -![](images/a-debug2-udapp1a.png) - -Then open it up (by clicking the caret). - -![](images/a-debug3-udapp2.png) - - -We are going to call the `Donate` function and will send it ether. - -To do this: in the value input box put in **2** and select Ether as the unit (and not wei like I did in the image below - well you could - it won't really change anything). - -![](images/a-debug4-value-loc.png) - -Then click the `Donate` button. - -This will send Ether to the this function. - -Because we are using the `JavaScript VM`, everything happens almost instantly. (If we had been using Injected Web 3, then we would have to need to approve the transaction, pay for gas and wait for the transaction to get mined.) - -Remix displays information related to each transaction result in the terminal. - -Check in the **terminal** where the transaction you just made is logged. - -Click the debug button to start debugging it. - -![](images/a-debug5-term-debug-but.png) - -### From the Debugger - -Click the bug icon in the icon panel to get to the debugger in the side panel. If you don't see the bug icon go to the plugin manager and activate the debugger. - -You can start a debug session by providing either a `transaction hash` -or a `block number` and `transaction index`. - -To find a transaction hash -1. go to a transaction in the terminal. -2. Click a line with a transaction - to exand the log. -3. Copy the transaction has locate there. - -![image](remix3.png) - -Then click on the `start debugging` button. - -Using the debugger ------------------- - -The debugger allows one to see detailed informations about the -transaction's execution. It uses the editor to display the -location in the source code where the current execution is. - -The transaction panel displays basic information about the current -transaction. - -![image](remix_debugtransactioninfo.png) - -The navigation part contains a slider and buttons that can be used to -step through the transaction execution. - -From the left to the right: - -step over back, step into back, step into forward, step over forward, -jump out (jump out of the current call), jump to the previous -breakpoint, jump to the next breakpoint. - -![image](remix_navigation.png) - -11 panels give detailed information about the execution: - -### Instructions - -![image](remix_debuginstructions.png) - -The Instructions panel displays the bytecode of the current executing -contract- with the current step highlighted. - -Important note: When this panel is hidden, the slider will have a -courser granularity and only stop at *expression boundaries*, even if they -are compiled into multiple EVM instructions. When the panel is -displayed, it will be possible to step over every instruction, even -those that refers to the same expression. - -### Solidity Locals - -![image](remix_soliditylocals.png) - -The Solidity Locals panel displays local variables associated with the -current context. - -### Solidity State - -![image](remix_soliditystate.png) - -The Solidity State panel displays state variables of the current -executing contract. - -### Low level panels - -These panels display low level informations about the execution: - -> - Stack -> - Storages Changes -> - Memory -> - Call Data -> - Call Stack -> - Return Value (only if the current step is a RETURN opcode) -> - Full Storages Changes (only at the end of the execution - display -> every storage change of every modified contract) - -### Reverted Transaction - -A transaction could be `reverted` (because of an *out of gas exception* or -Solidity `revert` statement or because of a low level exception). - -It is important to be aware of the exception and to locate -where the exception is in the source code. - -Remix will warn you when the execution throws an exception. The -`warning` button will jump to the last opcode before the exception -happened. - -![image](remix_executionexception.png) - -### Breakpoints - -The two last buttons from the navigation area are used to jump either -back to the previous breakpoint or forward to the next breakpoint. - -Breakpoints can be added and removed by clicking on the line number in the *Editor*. - -![image](remix_breakpoint.png) - -When using debug session with breakpoints, the execution will jump to the first -encountered breakpoint. - -**Important note:** If you add a breakpoint to a line that declares a -variable, it might be triggered twice: Once for initializing the -variable to zero and second time for assigning the actual value. As an -example, assume you are debugging the following contract: - -(RS - what is the {.sourceCode .none} doing?) -``` -{.sourceCode .none} -pragma solidity >=0.5.1 <0.6.0; - -contract ctr { - function hid () public { - uint p = 45; - uint m; - m = 89; - uint l = 34; - } -} -``` - -And let's says that breakpoints are set for the lines - -`uint p = 45;` - -`m = 89;` - -`uint l = 34;` - -then clicking on `Jump to next breakpoint` will stop at the following -lines in the given order: - -> `uint p = 45;` (declaration of p) -> -> `uint l = 34;` (declaration of l) -> -> `uint p = 45;` (45 assigned to p) -> -> `m = 89;` (89 assigned to m) -> -> `uint l = 34;` (34 assigned to l) diff --git a/docs/tutorial_geth-remix.md b/docs/tutorial_geth-remix.md deleted file mode 100644 index ec096a1fda..0000000000 --- a/docs/tutorial_geth-remix.md +++ /dev/null @@ -1,279 +0,0 @@ -Debugging a Dapp using Remix & Geth -========================================== - -The ultimate goal of this tutorial is to debug transactions that have -been created by a dapp front end. - -It is easy in Remix to debug a transaction created from its own GUI. -However, setting up an environment that allows you to debug transactions -created outside of Remix, require a bit more of complexity. - -We will need four tools for that : - -> - Geth - this is the center piece and provides the blockchain -> environment. We will basically run geth in a dev mode. -> - Remix - this is the Ethereum IDE. We will use it to develop our -> Solidity contract. -> - Any code editor you want - in order to write your front end :) - -Install the environment ------------------------ - -### Install Metamask - -Basically we will run our front end in the Metamask Chrome plugin ([Metamask](http://metamask.io)). - -### Install Geth - -[Geth](http://github.com/ethereum/go-ethereum/releases) is the official -Ethereum client. - -Running the environment ------------------------ - -### Run Geth - -We will run a test node. This node will have a new empty state and will -not be synced to the main or ropsten network. - - geth --ipcpath /geth.ipc --datadir --dev console - -`` is the folder where keys and chain data will be -stored. - -`--ipcpath` defines the end point that other apps (like Metamask) use to -talk to geth. - -`--datadir` specifies the data directory. - -`--dev` sets the node into private chain mode and adds some debugging -flags. - -Then we need to create accounts and mine a bit to generate some Ether: - - // from the geth console : - personal.newAccount() // You can execute this command several time if you need more than one account. - miner.start() // generate some Ether. - miner.stop() // stop mining after 30s-60s - we could also keep mining. - -Next time we run Geth, we will only need to mine transactions (no need -to recreate account). - - -### Starting Remix - -In Mist click on `Develop` / `Open Remix IDE` - -Remix will open in a new window. If this is the first time it is run, -the `Ballot` contract will be loaded. - -Now, we need to check if Remix is connected to Mist: - -Right panel / third tab from the left, `Injected Provider` should be -checked. - -![image](remix4.png) - -Right panel / second tab from the left, `Transaction Origin` should -contain accounts we have previously created in Geth. - -![image](remix5.png) - -Developing contract / front end -------------------------------- - -### Donation contract - Dapp Back end - -Here is a sample solidity contract. - -Copy and paste the following inside remix: - -``` -{.sourceCode .none} -contract Donation { - address owner; - event fundMoved(address _to, uint _amount); - modifier onlyowner { if (msg.sender == owner) _; } - address[] _giver; - uint[] _values; - - function Donation() { - owner = msg.sender; - } - - function donate() payable { - addGiver(msg.value); - } - - function moveFund(address _to, uint _amount) onlyowner { - uint balance = this.balance; - uint amount = _amount; - if (_amount <= this.balance) { - if (_to.send(this.balance)) { - fundMoved(_to, _amount); - } else { - throw; - } - } else { - throw; - } - } - - function addGiver(uint _amount) internal { - _giver.push(msg.sender); - _values.push(_amount); - } -} -``` - -### Dapp Front end - -and here is the front end: - -```html -
-
Donation Contract
-
- -
-
-
- -
-
- -
-
-
-
-
-
-
-
-
- - -``` - -I would suggest serving this file using `http-serve`, but you can use -any web server you like. - -Example: Dapp Front End - -### Important notice ! - -The variable `contractspec` contains the abi of the `donation` contract. -This means that if you change something in the contract interface -(function names, parameters, ...) you need to copy the new abi from -remix to the front end. - -Deploying ---------- - -Right panel / Red button `Create` - -![image](remix1.png) - -This creates a new transaction that deploys the `Donation` contract -(Mist will ask for the usual passphrase check). - -Wait for the transaction to be mined (don't forget to activate mining -`miner.start()`). Once this is done, you can use it by executing the -`moveFund` and `donate` function. But this is not what we want to -achieve. We want to run and debug those functions from the front end. - -Remix also display the address of the contract. Save it, we'll need this -address later. - -![image](remix2.png) - -Debugging ---------- - -From Mist, browse the above front end. In the first field, paste the -address of the newly created contract. Now, let's call the first -function (label `give`). - -You will need an account and a value. - -The account could be any account that is declared in the Wallet section -of Mist. This is the sender of the transaction that we are going to -create. The value should be no more than the actual balance of the -account - the unit is in wei, so just put `100` (100 wei), that should -be fine. - -Click on `Give` and wait for the transaction to be mined. - -The HTML block with id `log` is filled by all the transactions created -from the front end. It was easier for the purpose of this tutorial to -just log transactions in a div but you can have your own logging -mechanism. - -There is only one field that we need, this is the `transactionHash`. - -Copy it and switch to Remix. On the right side, the fifth panel shows a -small "bug" icon, that is the debugger. - -Paste the hash into the transaction field and click on the `play` -button. - -![image](remix3.png) - -You are now entering a debug session for the call to `donate`. - -Debugging in Remix is easier than with common tools like gdb because you -can freely move in time. Use the slider to change the current step and -click on the panels below to expand them and explore the curret state, -local variables, etc. There are also breakpoints to move between -sections of the code quickly, but more on all that later. - -At the time of this writing, there is an issue that could break the -contract creation. The a workaround for that at - . Please follow -the workaround or wait for this issue to be closed. - -Also, although retrieving a contract's storage when Remix is using the -JavaScript VM is working well, there is still work to be done when Remix -is using eth or geth as backend. diff --git a/docs/udapp.md b/docs/udapp.md deleted file mode 100644 index 2315956a99..0000000000 --- a/docs/udapp.md +++ /dev/null @@ -1,32 +0,0 @@ -Run & Deploy (part 2) -===================== - -## Deployed contracts - -This section in the Run tab contains a list of deployed contracts to interact with through autogenerated UI of the deployed contract (also called udapp). - -The deployed contract appears but is in its collapsed form. - -![](images/a-debug2-udapp1a.png) - -Click the sideways caret to open it up. - -![](images/a-debug3-udapp2.png) - -You will see the functions in the contract. The functions buttons can have different color buttons. - -- Functions that are `constant` or `pure` functions in Solidity have a blue buttons. Clicking one of this type does not create a new transaction. So clicking will not cause state changes - it will only return a value stored in the contract - so it won't cost you anything in gas fees. - -- Functions that changes the state of the contract are orange, clicking this type of function will cost gas and they do change the state of the contract and so they do create a new transaction. -But this transaction does not accept Ether. - -- Functions that have red buttons are `payable` functions in Solidity. Clicking one of these will create a new transaction and this transaction can accept a **value**. The **value** is put in in the Value field which is under the Gas Limit field. - -![](images/a-jvm-calling-instance.png) - - -For more information see more about [Solidity -modifier](http://solidity.readthedocs.io/en/develop/miscellaneous.html?highlight=pure#modifiers) -. - -If a function requires input parameters, it is required to specify them. diff --git a/docs/unittesting.md b/docs/unittesting.md deleted file mode 100644 index 27720f7f38..0000000000 --- a/docs/unittesting.md +++ /dev/null @@ -1,41 +0,0 @@ -Unit Testing -============ - -Click the "double check" icon to get to the unit testing plugin. If you don't see this icon, go to the plugin manager and load up the unit testing plugin. - -![](images/a-unit-testing1.png) - -Generate test File ------------------- - -This create a new solidity file in the current folder suffixed with `_test`. -This file contains the minimun you need for running unit testing. - -Run Tests ---------- - -This execute tests. The execution is run in a separate environment and the result is displayed below. - -| Available functions | Supported types | - -| ------------- | ------------- | - -| `Assert.ok()` | `bool` | - -| `Assert.equal()` | `uint`, `int`, `bool`, `address`, `bytes32`, `string` | - -| `Assert.notEqual()` | `uint`, `int`, `bool`, `address`, `bytes32`, `string` | - -| `Assert.greaterThan()` | `uint`, `int` | - -| `Assert.lesserThan()` | `uint`, `int` | - -see [https://github.com/ethereum/remix/blob/master/remix-tests/tests/examples_4/SafeMath_test.sol](https://github.com/ethereum/remix/blob/master/remix-tests/tests/examples_4/SafeMath_test.sol) for some code sample - -Continuous integration ----------------------- - -remix-tests is also a CLI, it can be used in a continuous integration environement which support node.js. -Please find more information in the [remix-test repository](https://github.com/ethereum/remix/tree/master/remix-tests) - -See also: example [Su Squares contract](https://github.com/su-squares/ethereum-contract/tree/e542f37d4f8f6c7b07d90a6554424268384a4186) and [Travis build](https://travis-ci.org/su-squares/ethereum-contract/builds/446186067) that uses remix-tests for continuous integration testing.