From 12b85ecf0ff5362bfe0d800193d03b1cc7d8f851 Mon Sep 17 00:00:00 2001 From: Touseef Liaqat Date: Wed, 6 Mar 2024 14:11:25 -0800 Subject: [PATCH 1/2] Simplify running local chain step --- README.md | 47 ++++++++--------------------------------------- 1 file changed, 8 insertions(+), 39 deletions(-) diff --git a/README.md b/README.md index 144e4750..534b7fb2 100644 --- a/README.md +++ b/README.md @@ -11,58 +11,27 @@ User application for Agoric Inter Protocol--Vaults, BLD Boost, Liquidations, etc ### Setup -1. Download and build the latest copy of `agoric-sdk`, including Agoric's Cosmic SwingSet. +1. Run the agoric local chain ```sh - cd agoric-sdk - yarn && yarn build - yarn link-cli ~/bin/agoric # or use any local dir in $PATH (e.g. ~/.local/bin/agoric) + docker run -d -p 26657:26657 -p 1317:1317 -p 9090:9090 ghcr.io/agoric/agoric-3-proposals:main ``` - Test that `agoric` works with: - - `agoric --version` - - For Cosmic SwingSet (in `agoric-sdk`): - - ```sh - cd packages/cosmic-swingset - make - ``` - - Test that Cosmic SwingSet tools work with: - - `agd --help` - -2. (One-time) Define keys expected by the startup scripts\* - - ```sh - agd keys add gov1 --keyring-backend=test - agd keys add gov2 --keyring-backend=test - ``` - - \*If you have access to the mnemonics, use `--interactive` to get a prompt to import them. Without that it will create new keys. You can save the seed phrase somewhere, or even create a keplr account with it for testing. You can use `agd keys list --keyring-backend=test` to check which keys you've created. - -3. Start a local chain with psm, vaults, etc. - - ``` - cd packages/inter-protocol && scripts/start-local-chain.sh - ``` - -4. Go the the [wallet](https://github.com/Agoric/wallet-app) repository and start a local client server: +2. Clone and run wallet app ```sh - cd wallet-app && yarn install - cd wallet && yarn start + git clone git@github.com:Agoric/wallet-app.git + cd wallet-app + yarn && yarn build && yarn preview ``` -5. Open the [wallet UI](http://localhost:3000/wallet/) and adjust Settings to use the localhost network. +3. Open the [wallet UI](http://localhost:3000/wallet/) and adjust Settings to use the localhost network. Screen Shot 2023-01-23 at 11 57 16 AM If you created a Keplr account with the seed from YOUR_ACCOUNT_KEY, you should already have a smart wallet provisioned. -6. Return to this repository and `yarn && yarn dev` to start the local server with Hot Module Replacement (which automatically refreshes the UI as you change source files). To connect to your local wallet UI, use http://127.0.0.1:5173/?wallet=local. +4. Return to this repository and `yarn && yarn dev` to start the local server with Hot Module Replacement (which automatically refreshes the UI as you change source files). To connect to your local wallet UI, use http://127.0.0.1:5173/?wallet=local. ## Deployment From 3cb5170e8efe48ff0e2c323b6bbd6416c934bcbb Mon Sep 17 00:00:00 2001 From: rabi-siddique Date: Thu, 21 Mar 2024 09:25:35 +0500 Subject: [PATCH 2/2] docs: update steps to setup dapp-inter locally --- README.md | 38 ++++++++++++++++++++++++++++---------- 1 file changed, 28 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 534b7fb2..55284963 100644 --- a/README.md +++ b/README.md @@ -11,27 +11,45 @@ User application for Agoric Inter Protocol--Vaults, BLD Boost, Liquidations, etc ### Setup -1. Run the agoric local chain +1. Download and build the latest copy of `agoric-sdk`, including Agoric's Cosmic SwingSet. ```sh - docker run -d -p 26657:26657 -p 1317:1317 -p 9090:9090 ghcr.io/agoric/agoric-3-proposals:main + cd agoric-sdk + yarn && yarn build + yarn link-cli ~/bin/agoric # or use any local dir in $PATH (e.g. ~/.local/bin/agoric) + ``` + + Test that `agoric` works with: + + `agoric --version` + + For Cosmic SwingSet (in `agoric-sdk`): + + ```sh + cd packages/cosmic-swingset + make ``` -2. Clone and run wallet app + Test that Cosmic SwingSet tools work with: + + `agd --help` + +2. (One-time) Define keys expected by the startup scripts\* ```sh - git clone git@github.com:Agoric/wallet-app.git - cd wallet-app - yarn && yarn build && yarn preview + agd keys add gov1 --keyring-backend=test + agd keys add gov2 --keyring-backend=test ``` -3. Open the [wallet UI](http://localhost:3000/wallet/) and adjust Settings to use the localhost network. + Note: If you have the mnemonic phrases, use `--interactive` to import them. Otherwise, new keys will be created. Remember to save the seed phrase securely. You can also use it to set up a Keplr account for testing purposes. To see the keys you've created, run `agd keys list --keyring-backend=test`. - Screen Shot 2023-01-23 at 11 57 16 AM +3. Run the agoric local chain - If you created a Keplr account with the seed from YOUR_ACCOUNT_KEY, you should already have a smart wallet provisioned. + ```sh + docker run -d -p 26657:26657 -p 1317:1317 -p 9090:9090 ghcr.io/agoric/agoric-3-proposals:main + ``` -4. Return to this repository and `yarn && yarn dev` to start the local server with Hot Module Replacement (which automatically refreshes the UI as you change source files). To connect to your local wallet UI, use http://127.0.0.1:5173/?wallet=local. +4. Run `yarn && yarn dev` to start the local server with Hot Module Replacement (which automatically refreshes the UI as you change source files). To connect to your local wallet UI, use http://127.0.0.1:5173/?wallet=local. ## Deployment