https://github.com/convex-dev/convex-java
Java / JVM client library for Convex
https://github.com/convex-dev/convex-java
blockchain java
Last synced: 5 months ago
JSON representation
Java / JVM client library for Convex
- Host: GitHub
- URL: https://github.com/convex-dev/convex-java
- Owner: Convex-Dev
- License: apache-2.0
- Created: 2021-02-08T04:46:51.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2022-04-22T07:25:52.000Z (about 3 years ago)
- Last Synced: 2024-04-19T16:14:10.793Z (about 1 year ago)
- Topics: blockchain, java
- Language: Java
- Homepage:
- Size: 92.8 KB
- Stars: 3
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# IMPORTANT
This repository is NO LONGER THE OFFICIAL LOCATION for `convex-java` has graduated to become part of the main Convex build at https://github.com/Convex-Dev/convex . You can still use `convex-java` of course! But development continues in the main repository rather than here. This repo is being kept open at present for reference purposes.
# convex-java
Java client library for Convex
## About
Convex is an open, decentralised technology for the Internet of Value. Java is one of the world's leading programming languages, especially in the realm of business and finance.
`convex-java` provides everything Java developers need to access Convex and utilise all of its capabilities from their own applications.
## Usage
You will need a connection to a peer on the Convex Network. Peers are servers which participate in the maintaining consensus on the Convex Network, by executing the CPoS consensus algorithm and validating transactions. It is easiest if you simply use the free public peer available at `https://convex.world`.
```java
Convex convex = Convex.connect("https://convex.world");
```
To utilise the network, you will need an account with available funds. On the Test Network, you can obtain one by requesting a new account with free balance (up to 10,000,000 Convex copper coins). This should be enough for most simple testing.
```java
convex.useNewAccount(10000000);
```
`convex-java` will automatically generate a new cryptographic key pair to secure your new account. Having a valid key pair for the account is the *only way* to successfully submit transactions for that Account on the Convex Network. If you want to access the key pair, you can use:
```java
convex.getKeyPair()
```
## Installation and Configuration
You can clone this repository and run `mvn install` to get a working local version. This is recommended for developers who wish to use early snapshot versions or contribute to `convex-java` as an open source project.
`convex-java` is also available as a Maven dependency.
```
world.convex
convex-java
0.0.1
```
## License
Copyright 2021 The Convex Foundation
`convex-java` is licensed under the Apache License v2.0.
Some dependencies from The Convex Foundation are licensed under the Convex Public License, which is an open source license that is free to use for any applications using the Convex Network.