Local Run

go run ./app.go

# generate swagger
go get github.com/swaggo/swag/cmd/swag
Swag init -g app.go

Test with ginkgo

cd handlers
# generate test suite for handlers directory
# package name is handlers_test
ginkgo boostrap
ginkgo generate health_check.go

# under that folder
# run test suite
ginkgo --v
# run only regexp matched "Metadata" in any described clause ex: Describe/It
ginkgo -v --focus=Metadata ./handlers
# run only regexp matched "without input payload" in any described clause ex: Describe/It
ginkgo -v --focus="without input payload" ./handlers

ginkgo -v ./handlers

Local Docker Compose Run

# rebuild docker image for fiber app
docker-compose build

docker-compose up

docker-compose down

Introduction

APIs:

# bump version when release
/version

/health

# get templating or other app info, ex sign-in templating
/api/ethereum-auth/v1/metadata

# generate and cache nonce on redis then respond to user
/api/ethereum-auth/v1/nonce

# verify signature and auth system account binding etc.
/api/ethereum-auth/v1/login

Reference

1. https://npmdoc.github.io/node-npmdoc-web3/build/apidoc.html
2. https://www.toptal.com/ethereum-smart-contract/time-locked-wallet-truffle-tutorial
3. https://www.toptal.com/ethereum/one-click-login-flows-a-metamask-tutorial
4. https://eth.wiki/json-rpc/API#eth_sign
5. https://medium.com/@angellopozo/ethereum-signing-and-validating-13a2d7cb0ee3
6. https://eips.ethereum.org/EIPS/eip-191
7. https://javascript.hotexamples.com/examples/eth-lib.lib.hash/-/keccak256/javascript-keccak256-function-examples.html
8. https://geth.ethereum.org/docs/clef/apis
9. https://en.wikipedia.org/wiki/Elliptic_Curve_Digital_Signature_Algorithm
10. https://goethereumbook.org/signature-verify/
11. https://medium.com/mycrypto/the-magic-of-digital-signatures-on-ethereum-98fe184dc9c7

ecrecovery id

since testRPC other protocols will add 27, we need to minus it for Geth go-ethereum.

openethereum/parity-ethereum#5490 https://cloud.githubusercontent.com/assets/27297969/25291256/86ecd9ec-268e-11e7-98ec-fc339c4dbafe.png https://github.com/ChainSafe/web3.js/blob/0.20.7/DOCUMENTATION.md#web3ethsign https://eips.ethereum.org/EIPS/eip-1271 https://docs.kaleido.io/faqs/why-ecrecover-fails/ https://blog.ethereum.org/2019/07/10/geth-v1-9-0/ https://bitcoin.stackexchange.com/questions/38351/ecdsa-v-r-s-what-is-v?newreg=4f3cd8cd47a74643b02cec1825ed9cc1

if protocol is Geth or Quorum => ecrecover id don't need to - 27

Getting Started

TODO: Guide users through getting your code up and running on their own system. In this section you can talk about:

1. Installation process
2. Software dependencies
3. Latest releases
4. API references

Build and Test

TODO: Describe and show how to build your code and run the tests.

Contribute

TODO: Explain how other users and developers can contribute to make your code better.

If you want to learn more about creating good readme files then refer the following guidelines. You can also seek inspiration from the below readme files:

• ASP.NET Core
• Visual Studio Code
• Chakra Core