Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/R0bi7/xCall-testing-JVM
Basic Java Smart Contracts used in xCall early testing.
https://github.com/R0bi7/xCall-testing-JVM
Last synced: about 1 month ago
JSON representation
Basic Java Smart Contracts used in xCall early testing.
- Host: GitHub
- URL: https://github.com/R0bi7/xCall-testing-JVM
- Owner: R0bi7
- License: other
- Created: 2023-06-15T16:41:43.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-06-15T16:42:57.000Z (over 1 year ago)
- Last Synced: 2024-08-01T18:24:14.793Z (4 months ago)
- Language: Java
- Size: 145 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-icon - R0bi7/xCall-testing-JVM - Sample JVM smart contract that interacts with xCall. (Interoperability)
README
# xCall testing JVM
A repository containing xCall early testing Smart Contracts. Specifically, `./Contracts/dapp-sample` package contains showcase proxy smart contract.
## Requirements
You need to install JDK 11 or later version. Visit [OpenJDK.net](http://openjdk.java.net/) for prebuilt binaries.
Or you can install a proper OpenJDK package from your OS vendors.
You will also need `jq`.
Please find below the recommanded commands to run to install these packages:
- In macOS:
```bash
$ # Install brew
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
$ # Install JDK
$ brew tap AdoptOpenJDK/openjdk
$ brew cask install adoptopenjdk11
$ # Install JQ
$ brew install jq
```
- In Windows (Windows 10 or later)
You can install the JDK11 natively, but you will need `bash` in order to run the HelloWorld deploy scripts.
Please [install WSL](https://docs.microsoft.com/en-us/windows/wsl/install-manual) first, so you can follow the same instructions than Linux.
- In Linux (Ubuntu 18.04):
```bash
$ # Install JDK
$ sudo apt install openjdk-11-jdk
$ # Install JQ
$ sudo apt install jq
```
## How to Build and Deploy the project
### 1. Build the project (mostly for making sure that everything works correctly for your setup)
`./gradlew build`
or
`./gradlew clean build` (for subsequent clean builds)
This should run all the unittest, and run successfully with a similar output than below:
```java
Starting a Gradle Daemon (subsequent builds will be faster)
> Task :Tests:customIrc2Token-Test:test
OpenJDK 64-Bit Server VM warning: Sharing is only supported for boot loader classes because bootstrap classpath has been appended
BUILD SUCCESSFUL in 2s
52 actionable tasks: 52 executed
```
### 2. Setup build system
You'll need python3 and pip installed on your machine beforehand.
Now we can install the virtualenv and the dependencies:
```bash
$ # Run this in the ./scripts folder of the project
$ python -m venv ./venv
$ source ./venv/bin/activate
$ pip install -r ./requirements.txt
```
Everytime you want to use the build & deploy system, please do `source ./venv/bin/activate` inside `./scripts` beforehand.
### 3. Keystore config
In order to deploy/update the contract keystore and password must be configured as following:
- Put keystore content in "scripts/config/keystores/{network}/operator.icx"
- Put keystore password in "scripts/config/keystores/{network}/operator.pwd"
**Note**: `{network}` should be replaced with network name you are deploying/updating to!
Make sure you have enough ICX in wallet!
### 4. Deploying contracts
#### HelloWorld contract
```bash
$ # Run this in the root folder of the project
$ # We specify "lisbon" as an argument here, which means the contracts
$ # will be deployed on Lisbon. You can set it to "custom" too for the
$ # custom network
$ ./scripts/scenario/1.deploy_hello_world.sh lisbon
[...]
# This should end with the following message
[🎉] HelloWorld have been successfully deployed!
```
#### CustomIrc2Token contract
```bash
$ # Run this in the root folder of the project
$ # We specify "lisbon" as an argument here, which means the contracts
$ # will be deployed on Lisbon. You can set it to "custom" too for the
$ # custom network
$ ./scripts/scenario/2.deploy_custom_irc2_token.sh lisbon
[...]
# This should end with the following message
[🎉] CustomIrc2Token have been successfully deployed!
```
### 5. Updating contracts
#### HelloWorld contract
```bash
$ # Run this in the root folder of the project
$ # We specify "lisbon" as an argument here, which means the contracts
$ # will be updated on Lisbon. You can set it to "custom" too for the
$ # custom network
$ ./scripts/scenario/1.1.update_hello_world.sh lisbon
[...]
# This should end with the following message
[🎉] HelloWorld have been successfully updated!
```
#### CustomIrc2Token contract
```bash
$ # Run this in the root folder of the project
$ # We specify "lisbon" as an argument here, which means the contracts
$ # will be updated on Lisbon. You can set it to "custom" too for the
$ # custom network
$ ./scripts/scenario/2.1.update_custom_irc2_token.sh lisbon
[...]
# This should end with the following message
[🎉] CustomIrc2Token have been successfully updated!
```