diff --git a/e2e-testing/README.md b/e2e-testing/README.md
new file mode 100644
index 0000000..6b1e1c9
--- /dev/null
+++ b/e2e-testing/README.md
@@ -0,0 +1,113 @@
+# Starship 
+
+End-to-end testing environment for fully simulated chains, powered by [Starship](https://docs.cosmology.zone/starship).
+
+## Configuration
+
+The current commands will read from [`config.yaml`](./config.yaml) to build a multi-chain testing environment. Currently, the image includes `agoric`, `osmosis`, and `cosmoshub` chains and a hermes relayer between each.
+
+The `agoric` software revision includes the vats necessary for building and testing orchestration applications:
+- vat-network
+- vat-ibc
+- vat-localchain
+- vat-transfer
+- vat-orchestration
+
+## Initial Setup
+
+Ensure you have Kubernetes available. See https://docs.cosmology.zone/starship/get-started/step-2.
+
+The following will install `kubectl`, `kind`, `helm`, and `yq` as needed:
+
+```sh
+make clean setup
+```
+
+## Getting Started
+
+You can start everything with a single command:
+
+```sh
+make start
+```
+
+This command will:
+1. Install the Helm chart and start the Starship service
+2. Wait for all pods to be ready
+3. Set up port forwarding
+4. Fund the provision pool
+5. Override the chain registry
+
+The process may take 7-12 minutes to complete. You'll see status updates as the pods come online.
+
+Alternatively, you can run the steps individually:
+
+```sh
+# install helm chart and start starship service
+make install
+
+# wait for all pods to spin up
+make wait-for-pods
+
+# expose ports on your local machine (useful for testing dapps)
+make port-forward
+
+# set up Agoric testing environment
+make fund-provision-pool override-chain-registry register-bank-assets
+```
+
+If you get an error like "connection refused", you need to wait longer, until all the pods are Running.
+
+## Cleanup
+
+```sh
+# stop the containers and port-forwarding
+make stop
+
+# delete the clusters
+make clean
+```
+
+## Logs
+
+You can use the following commands to view logs:
+
+```sh
+# agoric slogfile
+make tail-slog
+
+# agoric validator logs
+kubectl logs agoriclocal-genesis-0 --container=validator --follow
+
+# relayer logs
+kubectl logs hermes-agoric-gaia-0 --container=relayer --follow
+kubectl logs hermes-osmosis-gaia-0 --container=relayer --follow
+```
+
+## Agoric Smart Wallet
+
+For the steps below, you must import a key to `agd` or create a new one.
+
+```bash
+# create a `user1` key from a random seed
+kubectl exec -i agoriclocal-genesis-0 -c validator -- agd keys add user1
+
+# get the newly created address
+ADDR=$(kubectl exec -i agoriclocal-genesis-0 -c validator -- agd keys show user1 -a)
+
+# fund the wallet with some tokens 
+make fund-wallet COIN=20000000ubld ADDR=$ADDR
+
+# provision the smart wallet
+make provision-smart-wallet ADDR=$ADDR
+```
+
+## Chain Registry
+
+These only work if you've done `make port-forward`.
+
+- http://localhost:8081/chains/agoriclocal
+- http://localhost:8081/chains/osmosislocal
+- http://localhost:8081/chains/gaialocal
+- http://localhost:8081/chains/agoriclocal/keys
+- http://localhost:8081/ibc
diff --git a/e2e-testing/config.yaml b/e2e-testing/config.yaml
index 1385428..7615ae5 100644
--- a/e2e-testing/config.yaml
+++ b/e2e-testing/config.yaml
@@ -25,8 +25,8 @@ chains:
       exposer: 38087
       grpc: 9090
     resources:
-      cpu: 1
-      memory: 4Gi
+      cpu: 0.5
+      memory: 3Gi
   - id: osmosislocal
     name: osmosis
     numValidators: 1
@@ -55,9 +55,6 @@ chains:
       rpc: 26655
       grpc: 9093
       faucet: 8084
-    resources:
-      cpu: 1
-      memory: 1Gi
   - id: gaialocal
     name: cosmoshub
     numValidators: 1
@@ -79,9 +76,6 @@ chains:
       rpc: 26654
       grpc: 9092
       faucet: 8083
-    resources:
-      cpu: 1
-      memory: 1Gi
 
 relayers:
   - name: osmosis-gaia