Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/galacticcouncil/hydration-node
Hydration node - Cross-chain liquidity protocol built with Polkadot-SDK
https://github.com/galacticcouncil/hydration-node
blockchain rust substrate
Last synced: about 2 months ago
JSON representation
Hydration node - Cross-chain liquidity protocol built with Polkadot-SDK
- Host: GitHub
- URL: https://github.com/galacticcouncil/hydration-node
- Owner: galacticcouncil
- License: apache-2.0
- Created: 2020-08-10T07:55:46.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-10-29T12:14:47.000Z (3 months ago)
- Last Synced: 2024-10-29T14:42:36.647Z (3 months ago)
- Topics: blockchain, rust, substrate
- Language: Rust
- Homepage: https://hydration.net
- Size: 65.7 MB
- Stars: 172
- Watchers: 23
- Forks: 69
- Open Issues: 104
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: docs/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# HydraDX node
CROSS-CHAIN LIQUIDITY PROTOCOL BUILT ON SUBSTRATE
## Contributions & Code of Conduct
Please follow the contributions guidelines as outlined in [`docs/CONTRIBUTING.md`](docs/CONTRIBUTING.md).
We are welcoming and friendly community please follow our [Code of Conduct](docs/CODE_OF_CONDUCT.md).
## Local Development
Follow these steps to prepare a local Substrate development environment :hammer_and_wrench:
### Simple Setup
Install all the required dependencies with a single command (be patient, this can take up to 30
minutes).
```bash
curl https://getsubstrate.io -sSf | bash -s -- --fast
```
### Manual Setup
Find manual setup instructions at the
[Substrate Developer Hub](https://substrate.dev/docs/en/knowledgebase/getting-started/#manual-installation).
### Build
Once the development environment is set up, build the node. This command will build the
[Wasm](https://substrate.dev/docs/en/knowledgebase/advanced/executor#wasm-execution) and
[native](https://substrate.dev/docs/en/knowledgebase/advanced/executor#native-execution) code:
```bash
cargo build --release
```
## Run
### Chopsticks
The easiest way to run and interact with HydraDX node is to use [Chopsticks](https://github.com/acalanetwork/chopsticks)
```Bash
npx @acala-network/chopsticks@latest --config=launch-configs/chopsticks/hydradx.yml
```
Now you have a test node running at [`ws://localhost:8000`](https://polkadot.js.org/apps/?rpc=ws%3A%2F%2Flocalhost%3A8000#/explorer)
### Local Testnet with Zombienet
Relay chain repository (polkadot) has to be built in `../polkadot`
Grab `zombienet` utility used to start network from [releases](https://github.com/paritytech/zombienet/releases)
Start local testnet with 4 relay chain validators and HydraDX as a parachain with 2 collators.
```
cd ./rococo-local
zombienet spawn config-zombienet.json
```
### Interaction with the node
Go to the polkadot apps at https://polkadot.js.org/apps
Connect to
- Mainnet: `wss://rpc.hydradx.cloud`
- local node: `ws://localhost:8000` (if you are using chopsticks)
### Testing of storage migrations and runtime upgrades
The `try-runtime` tool can be used to test storage migrations and runtime upgrades against state from a real chain.
Run the following command to test against the state on HydraDX.
Don't forget to use a runtime built with `try-runtime` feature.
```bash
try-runtime --runtime ./target/release/wbuild/hydradx-runtime/hydradx_runtime.wasm on-runtime-upgrade --checks all live --uri wss://rpc.hydradx.cloud:443
```
or against HydraDX testnet on Rococo using `--uri wss://rococo-hydradx-rpc.hydration.dev:443`
## Security
Useful resources:
* https://github.com/galacticcouncil/HydraDX-security
* https://apidocs.bsx.fi/HydraDX
* https://docs.hydradx.io/
* https://docs.hydradx.io/omnipool_design
* https://docs.hydradx.io/fees
Bug bounty: [https://immunefi.com/bounty/hydradx/](https://immunefi.com/bounty/hydradx/)
Reponsible disclosure: [email protected]