{"id":18966157,"url":"https://github.com/aergoio/heraj","last_synced_at":"2025-04-19T14:13:34.318Z","repository":{"id":96216232,"uuid":"142944814","full_name":"aergoio/heraj","owner":"aergoio","description":"Java client framework for aergo","archived":false,"fork":false,"pushed_at":"2025-01-20T00:55:36.000Z","size":11448,"stargazers_count":22,"open_issues_count":5,"forks_count":7,"subscribers_count":9,"default_branch":"develop","last_synced_at":"2025-03-29T08:32:54.920Z","etag":null,"topics":["aergo","client","java"],"latest_commit_sha":null,"homepage":"https://heraj-docs.aergo.io","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aergoio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-07-31T01:10:55.000Z","updated_at":"2025-01-03T07:32:08.000Z","dependencies_parsed_at":"2025-01-03T08:33:47.346Z","dependency_job_id":null,"html_url":"https://github.com/aergoio/heraj","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aergoio%2Fheraj","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aergoio%2Fheraj/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aergoio%2Fheraj/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aergoio%2Fheraj/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aergoio","download_url":"https://codeload.github.com/aergoio/heraj/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249213732,"owners_count":21231096,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aergo","client","java"],"created_at":"2024-11-08T14:36:00.617Z","updated_at":"2025-04-16T07:33:03.204Z","avatar_url":"https://github.com/aergoio.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# heraj - Java client framework for aergo\n\n[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![LoC](https://tokei.rs/b1/github/aergoio/heraj)](https://github.com/aergoio/heraj)\n[![github build](https://github.com/aergoio/heraj/actions/workflows/gradle.yml/badge.svg)](https://github.com/aergoio/aergo/actions/workflows/gradle.yml/badge.svg)\n[![codecov.io](https://codecov.io/github/aergoio/heraj/coverage.svg?branch=develop)](https://codecov.io/github/aergoio/heraj?branch=develop)\n\nThe hera is the client-side framework for the aergo.\nThis repository, heraj is java implementation for hera.\n\n## Latest\n\nv1.4.2\n\nbuild with aergo-protobuf [6ce439c7600ae7b167c6c61e66ce2ac38bb2bef9](https://github.com/aergoio/aergo-protobuf/commits/6ce439c7600ae7b167c6c61e66ce2ac38bb2bef9)\n\n## Compatibility\n\n- Aergo : v2.2.x\n- Java : JDK 8 or higher\n- Android : Android 3.0 (API 11) or higher\n\n## Download\n\nThere are 3 kind of library:\n\n- heraj-transport : minimum library including all of the base\n- heraj-wallet : nonce handling wallet library (depends on `heraj-transport`)\n- heraj-smart-contract : simple client to call smart contract with a java interface (depends on `heraj-wallet`)\n\nIf you just want a minimum one, use `heraj-transport`. Or need more feature, use `heraj-wallet` or `heraj-smart-contract`.\n\n## Module Structure\n\n- core\n  - annotation : Store annotations used within heraj.\n  - common : Store models used within heraj.\n  - protobuf : Keeps java files generated from *.proto.\n  - transport : Transport module interacting with aergo node using grpc.\n  - util : Utils used within heraj.\n- client\n  - wallet : Provides KeyStore to store aergo key. Provides WalletApi to interacting with KeyStore.\n  - smart-contract : Modules for interface-based smart contract interaction.\n\n### Maven\n\n```sh\n\n...\n\n\u003cdependencies\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003eio.aergo\u003c/groupId\u003e\n    \u003cartifactId\u003eheraj-transport\u003c/artifactId\u003e\n    \u003cversion\u003e${herajVersion}\u003c/version\u003e\n  \u003c/dependency\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003eio.aergo\u003c/groupId\u003e\n    \u003cartifactId\u003eheraj-wallet\u003c/artifactId\u003e\n    \u003cversion\u003e${herajVersion}\u003c/version\u003e\n  \u003c/dependency\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003eio.aergo\u003c/groupId\u003e\n    \u003cartifactId\u003eheraj-smart-contract\u003c/artifactId\u003e\n    \u003cversion\u003e${herajVersion}\u003c/version\u003e\n  \u003c/dependency\u003e\n\u003c/dependencies\u003e\n```\n\n### Gradle\n\n```sh\n...\n\ndependencies {\n  implementation \"io.aergo:heraj-transport:${herajVersion}\"\n  implementation \"io.aergo:heraj-wallet:${herajVersion}\"\n  implementation \"io.aergo:heraj-smart-contract:${herajVersion}\"\n}\n```\n\n## Build from source\n\n### Prerequisites\n\n- [JDK8](https://openjdk.java.net/projects/jdk8/)\n\n### Clone\n\n```console\n$ git clone --recurse-submodule https://github.com/aergoio/heraj.git\n```\n\n### Submodule\n\nInitialize submodule (if not initialized)\n\n```console\n$ git submodule init\n```\n\nUpdate submodule\n\n```console\n$ git submodule update\n```\n\n### Build\n\n- Clean: `./gradlew clean`\n- Generate protobuf based files: `./gradlew :core:protobuf:build`\n- Lint: `./gradlew lint`\n- Test: `./gradlew test`\n  - Coverage (need test task): `./gradlew test coverage` (individual), `./gradlew test allcoverage` (all)\n  - Integration Test: `./test/run-it.sh` (need docker running)\n  - Benchmark Test: `./gradlew {target_project}:jmh`\n- Docs: `./gradlew javadoc` (individual), `./gradlew alljavadoc` (all)\n- Build (also lint, test): `./gradlew build`\n- Shadow Jar: `./gradlew shadowJar` (generated in `./assembly/build/libs`)\n- Install to local: `./gradlew publishToMavenLocal`\n\n## Kind of test\n\n### Unit test\n\nThey are classes with 'Test' suffix.\n\n### Integration test\n\nThey are classes with 'IT' suffix meaning integration test.\n\n### Benchmark test\n\nThey are classes with 'Benchmark' suffix, which using jmh.\n\n## Contribution\n\nGuidelines for any code contributions:\n\n1. Any changes should be accompanied by tests. It's guaranteed by travis ci.\n2. Code coverage should be maintained. Any requests dropping down code coverage significantly will be not confirmed.\n3. All contributions must be licensed MIT and all files must have a copy of statement indicating where license is (can be copied from an existing file).\n4. All java files should be formatted according to [Google's Java style guide](http://google.github.io/styleguide/javaguide.html). You can use checkstyle plugin for [eclipse](https://checkstyle.org/eclipse-cs/#!/) or [IntelliJ](https://plugins.jetbrains.com/plugin/1065-checkstyle-idea). And you can check by running `./gradlew lint`\n5. Please squash all commits for a change into a single commit (this can be done using git rebase -i). Make sure to have a meaningful commit message for the change.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faergoio%2Fheraj","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faergoio%2Fheraj","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faergoio%2Fheraj/lists"}