https://github.com/linki/etherdelta-go
EtherDelta bindings for Go and example code
https://github.com/linki/etherdelta-go
etherdelta ethereum golang smart-contracts
Last synced: 6 months ago
JSON representation
EtherDelta bindings for Go and example code
- Host: GitHub
- URL: https://github.com/linki/etherdelta-go
- Owner: linki
- License: mit
- Archived: true
- Created: 2017-11-14T19:37:56.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-04-23T13:12:47.000Z (over 8 years ago)
- Last Synced: 2024-06-20T08:15:56.067Z (about 2 years ago)
- Topics: etherdelta, ethereum, golang, smart-contracts
- Language: Go
- Size: 67.4 KB
- Stars: 5
- Watchers: 4
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# etherdelta-go
[](https://github.com/linki/etherdelta-go/releases)
This is an example of how to interact with an Ethereum contract from Go through RPC.
The example shows three things:
* how to generate Go language bindings given a contract's ABI definition,
* how to read data from the blockchain without spending gas, and
* how to change state on the blockchain by providing the correct private key and spending gas
# The contract library
We use [abigen](https://github.com/ethereum/go-ethereum/tree/v1.7.2/cmd/abigen)
to generate Go language bindings given a contract's ABI definition.
To regenerate the code [install abigen](https://github.com/ethereum/go-ethereum/tree/v1.7.2#building-the-source), put the ABI definition into a file (e.g., [for the EtherDelta contract](https://etherscan.io/address/0x8d12a197cb00d4747a1fe03395095ce2a5cc6819#code)) and run:
```console
$ cd contract
$ abigen --abi etherdelta.abi --pkg contract --type EtherDelta --out etherdelta.go
```
This will create an [etherdelta.go](contract/etherdelta.go) file that you can import into your Go programs.
# Example program
The [example code](main.go) contains a working interaction with the Ethereum blockchain and may even be useful for somebody.
When using [EtherDelta](https://etherdelta.com/) (a decentralized exchange based on smart contracts) a user deposits funds from her own address into a pool that can be accessed by EtherDelta for executing trades. Later the user withdraws any funds from the pool back to her own address. Often there's a tiny amount left in the pool which is tedious to withdraw manually.
`etherdelta-go` to the rescue; it allows you to withdraw any deposited Ethereum or [ERC20](https://theethereum.wiki/w/index.php/ERC20_Token_Standard) [Token](https://etherscan.io/tokens)s known to [0xProject](https://0xproject.com/)'s [Token Registry](https://etherscan.io/address/0x926a74c5c36adf004c87399e65f75628b0f98d2c) back to you.
Build and install the binary:
```console
$ cd $GOPATH/src/github.com/linki/etherdelta-go
$ dep ensure -vendor-only
$ go install
```
Make sure `$GOPATH/bin` is in your `$PATH`, then run it like that:
```console
$ etherdelta-go --keystore-file "UTC-...98c"
Found tokens: 50
Your address: 0x001...98C
Deposited ETH: 1000000000000000000
...
Deposited AIR: 500000000
...
```
Note the balances are displayed using the smallest spendable unit. The above maps to 1 Ethereum and 5 AirToken.
If you have anything deposited you can run the command with the `--withdraw-all` flag which will attempt to withdraw ETH and tokens that have a balance greater than zero. When using `--withdraw-all` you also have to provide `--passphrase` to unlock your Keystore file.
```console
$ etherdelta-go --keystore-file "UTC-...98c" --passphrase "my...pass" --withdraw-all
Found tokens: 50
Your address: 0x001...98C
Deposited ETH: 1000000000000000000
Withdrawing ETH: 1000000000000000000
Transaction hash: 0x7e3892...be9249
...
Deposited AIR: 500000000
Withdrawing AIR: 500000000
Transaction hash: 0x1a6328...7ef38a
...
```
The tool won't wait until the transactions have been mined. So just make sure the transactions got successfully submitted and give them some time to be mined. Then you can run the command again and validate that all your deposited ETH and tokens have been withdrawn.
```console
$ etherdelta-go --keystore-file "UTC-...98c"
Found tokens: 50
Deposited ETH: 0
...
Deposited AIR: 0
...
```
It takes the following arguments:
* `keystore-file`: the location of an Ethereum [Keystore file](https://theethereum.wiki/w/index.php/Accounts,_Addresses,_Public_And_Private_Keys,_And_Tokens#UTC_JSON_Keystore_File) which describes where the funds will be withdrawn to as well as contains the encrypted private key for that address, e.g., `~/Library/Ethereum/keystore/UTC--2017-11-...61d3f9`
* `withdraw-all`: sends a transactions to withdraw the balance if it's greater than zero. Without this flag it will merely print the deposited balances. Note that `passphrase` must be provided and correct in order to successfully sign the transaction. Defaults to `false` (disable withdrawal).
* `passphrase`: the passphrase unlocking the `keystore-file`. It proves that you are the owner of the Keystore file and is only required when using `withdraw-all`.
There are some optional arguments as well:
* `endpoint`: an RPC endpoint to interact with the Ethereum blockchain. You can run your own Ethereum node or connect to one provided by [Infura](https://infura.io/) free of charge. Defaults to `https://mainnet.infura.io`.
* `etherdelta`: The address of the EtherDelta contract to use. Since contracts are immutable each change to the contract requires a new contract to be deployed and results in a new contract address. Defaults to the most recent contract as of December 2017: [0x8d12A197cB00D4747a1fe03395095ce2A5CC6819](https://etherscan.io/address/0x8d12A197cB00D4747a1fe03395095ce2A5CC6819).
* `token-registry`: The address of 0xProject's TokenRegistry contract. Defaults to the most recent contract as of December 2017: [0x926a74c5C36adf004C87399e65f75628b0f98D2C](https://etherscan.io/address/0x926a74c5C36adf004C87399e65f75628b0f98D2C).
* `gas-price`: The gas price in wei for the withdrawal transaction. Defaults to `1000000000` which is 1 Gwei.
* `gas-limit`: The maximum gas to use for the withdrawal transaction. Defaults to `100000`. During my testing for AirToken the final gas for successful transactions hovered around `50000`.
* `timeout`: The timeout to submit a transaction to the Ethereum endpoint. Defaults to 5 seconds.
Keeping the defaults for `gas-price` and `gas-limit` will result in a maximum transaction fee of `0.0001` ETH.
### Requirements
* Go 1.10
* Ethereum 1.8
# Disclaimer
No warranty for any funds lost. See [LICENSE](LICENSE) for details.