https://github.com/sword-smith/geth_tools
Tools to avoid having to work in the Geth console directly. Use the command line interface instead.
https://github.com/sword-smith/geth_tools
ethereum ethereum-contract geth
Last synced: 2 months ago
JSON representation
Tools to avoid having to work in the Geth console directly. Use the command line interface instead.
- Host: GitHub
- URL: https://github.com/sword-smith/geth_tools
- Owner: Sword-Smith
- License: mit
- Created: 2017-03-28T20:11:20.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2021-04-01T09:12:16.000Z (about 4 years ago)
- Last Synced: 2025-02-10T06:14:55.054Z (4 months ago)
- Topics: ethereum, ethereum-contract, geth
- Language: JavaScript
- Homepage:
- Size: 249 KB
- Stars: 2
- Watchers: 6
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# geth_tools
## WARNING
THIS IS INTENDED FOR RUNNING A LOCAL VERSION OF ETHEREUM FOR TESTING PURPOSES.
IT HAS NOT BEEN TESTED HOW THIS SOFTWARE INTERACTS WITH THE REAL BLOCKCHAIN.
DO NOT USE THIS ON A COMPUTER THAT RUNS A REAL ETHEREUM NODE SINCE YOU MAY RISK
LOSING YOUR PRIVATE KEYS IF YOU DO NOT KNOW WHAT YOU ARE DOING!
# About
Tools to avoid having to work in the Geth console directly
# Install
Currently we support OS X and Linux!
### Dependencies
1. Geth (https://github.com/ethereum/go-ethereum/wiki/geth)
2. solc (https://solidity.readthedocs.io/en/develop/installing-solidity.html)
### Setup
1. Clone repo
2. Go to geth_tools folder
3. install cpanminus (`sudo apt-get install cpanminus`)
4. `cpanm --installdeps .` (remember the dot)
5. Run `run_geth.pl`
You may need to run
`cpanm --local-lib=~/perl5 local::lib && eval $(perl -I ~/perl5/lib/perl5/ -Mlocal::lib)`
-- Alternatively run the install_on_linux bash script
Now a fully configured geth instance should be running in DEV mode. This running instance
will only mine when there are transactions and it runs its own, local blockchain.
Solidity and Sword contracts can now be deployed by running `compile_and_deploy.pl`
# How to use it
Make sure a Geth client is running by starting the program `./run_geth.pl`
Compile and deploy to a local version of the Ethereum blockchain:
```./compile_and_deploy.pl ```
Run methods on the deployed smart contract:
```./run_code.pl ```
So a smart contract can be deployed and executed without having to interact
with the geth console.
## JavaScript Code Execution
When writing JavaScript to execute, the deployed smart contracts are
automatically put into scope. They may be referred to as "\_",
i.e., the contract name followed by an underscore. If the deployed contract has
a constructor which has an argument with the name "tokenSymbol" or
"dataFeedSymbol", the value of this constructor (which is set when executing
compile_and_deploy.pl) will be part of the variable name such that this smart
contract is referred to as \\_\ or
\\_\ in the JavaScript. This is to allow the
user to interact with several contracts of the same type but with different
symbols, such as token contracts or data feed contracts.
## Precompiler for Solidity and Sword
./deploy_and_compile.pl contains a precompiler. This means that you when
defining smart contracts can use keywords to access addresses of other smart
contracts. The keyword "\_address\_my\_" will be substituted with your own
Ethereum address. The keyword "\_address\_\_" will be
substituted with the address of a contract that you have alread deployed.
\\_\ uses the same naming convention as the JavaScript does,
as described in the section above.