@@ -151,3 +151,21 @@ To generate a release `bridge-$VERSION.zip` file, use a simple `npm run release`
151151This will pack the build directory together with the README, `bridge-https.py`
152152script, and also generate a set of checksums for the build directory. You can
153153verify the checksums on e.g. MacOS via `shasum -c checksums.txt`.
154+
155+## L2 Local Environment
156+
157+To work with the L2 aggregator locally, set up the local environment like so:
158+
159+```sh
160+# Start ganache and apply the yu/naive-fallback branch from urbit/azimuth
161+ganache-cli --host '0.0.0.0' -m 'benefit crew supreme gesture quantum web media hazard theory mercy wing kitten'
162+truffle migrate with-state --reset --compile-all
163+
164+# Build urbit at naive/fake-txs branch, start a local fake ship, then run these in the dojo:
165+:azimuth|watch 'http://0.0.0.0:8545'
166+|start %aggregator
167+|start %aggregator-rpc
168+
169+# If having CORS issues with API requests, try this:
170+> |cors-approve ~~https~3a.~2f.~2f.localhost~3a.3000
171+```