Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/astroport-fi/asteroid-local

Last synced: about 1 month ago
JSON representation

Host: GitHub
URL: https://github.com/astroport-fi/asteroid-local
Owner: astroport-fi
Created: 2024-01-26T14:03:58.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-05-03T12:04:45.000Z (9 months ago)
Last Synced: 2024-11-08T16:28:13.718Z (3 months ago)
Language: Shell
Size: 29.3 KB
Stars: 1
Watchers: 3
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# Asteroid Local Setup

## Links

- Frontend - http://localhost:5173/app
- Hasura Console / GraphQL playground - http://localhost:8080/console
- GraphQL API - http://localhost:8080/v1/graphql
- DB Explorer - http://localhost:8888/?pgsql=db&username=admin&db=meteors&ns=public
- Cosmos Hub RPC - http://localhost:16657
- Cosmos Hub REST - http://localhost:1316

## Accounts

| Cosmos Hub Address | Neutron Address | Mnemonic |
| ----------- | ----------- | ----------- |
| cosmos1m9l358xunhhwds0568za49mzhvuxx9uxre5tud | neutron1m9l358xunhhwds0568za49mzhvuxx9ux8xafx2 | banner spread envelope side kite person disagree path silver will brother under couch edit food venture squirrel civil budget number acquire point work mass |
| cosmos10h9stc5v6ntgeygf5xf945njqq5h32r53uquvw | neutron10h9stc5v6ntgeygf5xf945njqq5h32r54rf7kf | veteran try aware erosion drink dance decade comic dawn museum release episode original list ability owner size tuition surface ceiling depth seminar capable only |
| cosmos14xcrdjwwxtf9zr7dvaa97wy056se6r5e8q68mw | neutron14xcrdjwwxtf9zr7dvaa97wy056se6r5erln9pf | obscure canal because tomorrow tribe sibling describe satoshi kiwi upgrade bless empty math trend erosion oblige donate label birth chronic hazard ensure wreck shine |

### Add mnemonic Cosmos Hub

```bash
echo "banner spread envelope side kite person disagree path silver will brother under couch edit food venture squirrel civil budget number acquire point work mass" | gaiad keys add test --recover
```

check balances

```bash
gaiad query bank balances "$(gaiad keys show test -a)" --node tcp://0.0.0.0:16657
```

### Add mnemonic Neutron

```bash
echo "banner spread envelope side kite person disagree path silver will brother under couch edit food venture squirrel civil budget number acquire point work mass" | neutrond keys add test --recover
```

check balances

```bash
neutrond query bank balances "$(neutrond keys show test -a)" --node tcp://0.0.0.0:26657
```

## Prerequisites

### General
- Docker - https://docs.docker.com/get-docker/
- Go - https://go.dev/doc/install

### Frontend (if you want to run frontend)
- Node.js - https://nodejs.org/

### Relayer (if you want to run relayer)
- Rust - https://www.rust-lang.org/tools/install

## Setup Cosmos Hub

1. Clone repo

```bash
git clone --depth 1 --branch v15.1.0 https://github.com/cosmos/gaia
```

2. Install `gaiad`

```bash
cd gaia && make install
```

## Setup DB & API and init Cosmos Hub

1. Clone repo

```bash
git clone https://github.com/astroport-fi/asteroid-local
```

2. Init Cosmos Hub

```bash
./network/init-and-start-gaia.sh
```

once initialized run

```bash
./network/start-gaia.sh
```

3. Create a docker network

```bash
docker network create external-example
```

4. Run services with Docker

```bash
docker compose up
```

## Setup Asteroid

Clone repo

```bash
git clone https://github.com/astroport-fi/asteroid-protocol
```

### Setup Indexer

1. `cd indexer`
2. Create `.env` file
```bash
cp .env.template .env
```

3. Install [Atlas migration tool CLI](https://atlasgo.io/)

```curl
curl -sSf https://atlasgo.sh | sh
```

4. Run migrations

```bash
atlas migrate apply --env local
```

5. Open [DB Explorer](http://localhost:8888/?pgsql=db&username=admin&db=meteors&ns=public&sql=) and create all views from https://github.com/astroport-fi/asteroid-protocol/blob/main/indexer/schema.sql#L373

6. Open [DB Explorer](http://localhost:8888/?pgsql=db&username=admin&db=meteors&ns=public&sql=) and create status row for local Cosmos hub

```bash
INSERT INTO "status" ("id", "chain_id", "last_processed_height", "base_token", "base_token_usd", "date_updated", "last_known_height") VALUES
(1, 'gaialocal-1', 1, 'ATOM', 9.419, NOW(), 1);
```

7. Run indexer

```
make run
```

### Load Hasura API configuration

1. Install [Hasura CLI](https://hasura.io/docs/latest/hasura-cli/install-hasura-cli/) first
2. Apply Hasura Metadata

```bash
hasura metadata apply
```

### Setup Frontend

```
cd app
npm install
npm run dev
```

## Add Local Cosmos Hub to Keplr or Leap

Use `window.leap` in Leap case

```javascript
await window.keplr.experimentalSuggestChain({
chainId: "gaialocal-1",
chainName: "Local Cosmos Hub",
rpc: "http://localhost:16657",
rest: "http://localhost:1316",
bip44: {
coinType: 118,
},
bech32Config: {
bech32PrefixAccAddr: "cosmos",
bech32PrefixAccPub: "cosmos" + "pub",
bech32PrefixValAddr: "cosmos" + "valoper",
bech32PrefixValPub: "cosmos" + "valoperpub",
bech32PrefixConsAddr: "cosmos" + "valcons",
bech32PrefixConsPub: "cosmos" + "valconspub",
},
currencies: [
{
coinDenom: 'ATOM',
coinMinimalDenom: 'uatom',
coinDecimals: 6
},
],
feeCurrencies: [
{
coinDenom: 'ATOM',
coinMinimalDenom: 'uatom',
coinDecimals: 6,
gasPriceStep: { low: 0.1, average: 0.2, high: 0.3 }
}
],
stakeCurrency: {
coinDenom: 'ATOM',
coinMinimalDenom: 'uatom',
coinDecimals: 6
},
features: ['ibc-transfer']
});
```

For Neutron

```javascript
await window.keplr.experimentalSuggestChain({
chainId: "test-1",
chainName: "Local Neutron",
rpc: "http://localhost:26657",
rest: "http://localhost:1317",
bip44: {
coinType: 118,
},
bech32Config: {
bech32PrefixAccAddr: "neutron",
bech32PrefixAccPub: "neutron" + "pub",
bech32PrefixValAddr: "neutron" + "valoper",
bech32PrefixValPub: "neutron" + "valoperpub",
bech32PrefixConsAddr: "neutron" + "valcons",
bech32PrefixConsPub: "neutron" + "valconspub",
},
currencies: [
{
coinDenom: 'NTRN',
coinMinimalDenom: 'untrn',
coinDecimals: 6
},
],
feeCurrencies: [
{
coinDenom: 'NTRN',
coinMinimalDenom: 'untrn',
coinDecimals: 6,
gasPriceStep: { low: 0.1, average: 0.2, high: 0.3 }
}
],
stakeCurrency: {
coinDenom: 'NTRN',
coinMinimalDenom: 'untrn',
coinDecimals: 6
},
features: ['ibc-transfer', 'cosmwasm']
});
```

## Appendix

### Setup Neutron

1. Clone repo

```bash
git clone --depth 1 --branch v2.0.0 https://github.com/neutron-org/neutron
```

2. Install `neutrond`

```bash
cd neutron && make install
```

3. Init Neutron

```bash
./network/init-and-start-neutron.sh
```

once initialized run

```bash
./network/start-neutron.sh
```

### Setup Relayer

1. Install Hermes

```instal
cargo install ibc-relayer-cli --bin hermes --version 1.6.0 --locked
```

2. Run relayer

```bash
./network/hermes/start.sh
```

### Additional Resources

- https://docs.neutron.org/neutron/build-and-run/localnet/