https://github.com/yann39/eth-hash-app
Document hash storing on Ethereum blockchain from Java
https://github.com/yann39/eth-hash-app
blockchain bootstrap ethereum java spring-boot web3js zk zkoss
Last synced: 2 months ago
JSON representation
Document hash storing on Ethereum blockchain from Java
- Host: GitHub
- URL: https://github.com/yann39/eth-hash-app
- Owner: Yann39
- License: gpl-3.0
- Created: 2024-02-13T21:07:29.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-03-17T15:48:55.000Z (over 2 years ago)
- Last Synced: 2025-09-03T06:37:40.216Z (10 months ago)
- Topics: blockchain, bootstrap, ethereum, java, spring-boot, web3js, zk, zkoss
- Language: Java
- Homepage:
- Size: 303 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Document hashes on Ethereum blockchain from Java
Storing and reading document hashes on the **Ethereum blockchain** from **Java**.
---
# Table of Contents
* [About the Project](#about-the-project)
* [Getting Started](#getting-started)
* [Prerequisites](#prerequisites)
* [Installation](#installation)
* [Usage](#usage)
* [License](#license)
# About the Project
This project demonstrate **document hash** storing on the **Ethereum blockchain** from **Java**.
This is a **Java Spring Boot** application with a **ZK** frontend, that use an embedded **H2** database for demonstration purpose.
# Getting Started
## Prerequisites
To run this project in a local environment, you need :
- A local Ethereum blockchain running on `localhost` on port `7545`
- A `Diploma` smart contract deployed to handle document hash read and write
See the [eth-hash-chain](https://github.com/Yann39/eth-hash-chain) project for setting up a local blockchain with all the required capabilities.
## Installation
1. Clone the repository :
```shell script
git clone https://github.com/Yann39/eth-hash-app
```
2. Replace `application.account-address` and `application.contract-address` values in _application.properties_
to match your account and smart contract addresses according to your running blockchain
3. Build the JAR file using **Maven** :
```shell script
mvn package
```
4. Start your local blockchain (Ganache)
5. Execute application from Intellij or run the JAR file, with the right profile :
```shell script
java -Dspring.profiles.active=local -jar /target/eth-hash-app.jar
```
6. Reach
# Usage
Simply reach the application home page at to display the home page.
Navigate to the **Documents** menu, or direct access :
Connect to the Ethereum network (you should see a "connected" message) :
Then simply add documents and try to save hashes to the Ethereum blockchain.
You can then view documents :
# License
[General Public License (GPL) v3](https://www.gnu.org/licenses/gpl-3.0.en.html)
This program is free software: you can redistribute it and/or modify it under the terms of the GNU
General Public License as published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without
even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not,
see .