Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 52 additions & 0 deletions explorer/Makefile
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
.PHONY: build_explorer install_explorer set_cap create_env

ifneq (,$(wildcard ./.env))
include .env
export
endif

create_env:
truncate -s0 /tmp/aligned_layer/explorer/.env
echo "RPC_URL=${RPC_URL}" >> /tmp/aligned_layer/explorer/.env
echo "ENVIRONMENT=${ENVIRONMENT}" >> /tmp/aligned_layer/explorer/.env
echo "ALIGNED_CONFIG_FILE=${ALIGNED_CONFIG_FILE}" >> /tmp/aligned_layer/explorer/.env
echo "PHX_HOST=${PHX_HOST}" >> /tmp/aligned_layer/explorer/.env
echo "ELIXIR_HOSTNAME=${ELIXIR_HOSTNAME}" >> /tmp/aligned_layer/explorer/.env
echo "PHX_SERVER=true" >> /tmp/aligned_layer/explorer/.env
echo "DB_NAME=${DB_NAME}" >> /tmp/aligned_layer/explorer/.env
echo "DB_USER=${DB_USER}" >> /tmp/aligned_layer/explorer/.env
echo "DB_PASS=${DB_PASS}" >> /tmp/aligned_layer/explorer/.env
echo "DB_HOST=${DB_HOST}" >> /tmp/aligned_layer/explorer/.env
echo "TRACKER_API_URL=${TRACKER_API_URL}" >> /tmp/aligned_layer/explorer/.env
echo "SECRET_KEY_BASE=${SECRET_KEY_BASE}" >> /tmp/aligned_layer/explorer/.env
echo "KEYFILE_PATH=/home/app/.ssl/key.pem" >> /tmp/aligned_layer/explorer/.env
echo "CERTFILE_PATH=/home/app/.ssl/cert.pem" >> /tmp/aligned_layer/explorer/.env

# on /tmp/aligned_layer/explorer/ as app
build_explorer: export MIX_ENV=prod
build_explorer:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't this missing: explorer_ecto_setup_db to do the migrations if needed?

mix local.hex --force
mix local.rebar --force
mix deps.get --only $(MIX_ENV)
echo $(ENVIRONMENT)
mix compile
pnpm --prefix=assets/ install
mix phx.digest
mix assets.deploy
mix release --overwrite

# on /tmp/aligned_layer/explorer/ as app
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Personally, I would remove these comments or make them a little more specific.

install_explorer:
mkdir -p /home/app/repos/explorer/
mv /tmp/aligned_layer/ /home/app/repos/explorer/

# on /home/app/repos/explorer/aligned_layer/explorer/ as admin
set_cap:
sudo setcap CAP_NET_BIND_SERVICE=+eip /home/app/repos/explorer/aligned_layer/explorer/_build/prod/rel/explorer/erts-14.2.1/bin/beam.smp

# on /home/app/repos/explorer/aligned_layer/explorer/ as app
run_service:
mkdir -p /home/app/config/
cp /home/app/repos/explorer/aligned_layer/explorer/.env /home/app/config/.env.explorer
systemctl --user daemon-reload
systemctl --user enable --now explorer
50 changes: 50 additions & 0 deletions explorer/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# Explorer

## Steps to build

1. Clone [Aligned Layer](https://github.com/yetanotherco/aligned_layer/) inside the `/tmp` directory.
```
cd /tmp/
git clone https://github.com/yetanotherco/aligned_layer
```

3. Head to the `explorer/` folder and run the following command:
```
RPC_URL=
ENVIRONMENT=
ALIGNED_CONFIG_FILE=
PHX_HOST=
ELIXIR_HOSTNAME=
PHX_SERVER=true
DB_NAME=
DB_USER=
DB_PASS=
DB_HOST=
TRACKER_API_URL=
SECRET_KEY_BASE=
KEYFILE_PATH=/home/app/.ssl/key.pem
CERTFILE_PATH=/home/app/.ssl/cert.pem
make create_env
Comment on lines +11 to +27
Copy link
Member

@MarcosNicolau MarcosNicolau Jan 13, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why don't we instead pass a .env file path instead of providing all the vars in the console? I find it a little uncomfortable. Or instead, the create_env just creates the template, and then you go to the created file and fill in the variables.

```
> The values to be filled can be found inside the documentation.
3. Build the elixir application.
```
make build_explorer
```

4. Move the built binary outside `/tmp/` and move it to the actual location.
```
make install_explorer
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I had to run this with sudo (I was logged as admin).

```

5. Set the `CAP_NET_BIND_SERVICE=+eip` to the elixir application to allow elixir to bind port `443`
```
make set_cap
```
> This step must be ran as user `admin`.
7. Enable the systemd service.
```
make run_service
```
Comment on lines +47 to +50
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add a comment saying this should be run as app user.

25 changes: 25 additions & 0 deletions infra/ansible/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,30 @@ Deploy the Batcher:
make ansible_batcher_deploy INVENTORY=</path/to/inventory> KEYSTORE=<path/to/keystore/in/your/local>
```



Here is the updated table with the new **testnet** column added and filled with the same values as the **stage** column:

## Explorer
| Variable | Description | Stage | Testnet | Mainnet
|----------------------------------|-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------|
| MIX_ENV | Elixir environment for compiling the binaries | prod | prod | prod |
| RPC_URL | RPC's URL for the explorer to pull data from | `<RPC_URL>` | `<RPC_URL>` | `<RPC_URL>` |
| ENVIRONMENT | Build environment for aligned internal use | holesky | holesky | mainnet |
| ALIGNED_CONFIG_FILE | JSON config file for aligned | /home/app/repos/explorer/aligned_layer/contracts/script/output/holesky/alignedlayer_deployment_output.stage.json | /home/app/repos/explorer/aligned_layer/contracts/script/output/holesky/alignedlayer_deployment_output.json | /home/app/repos/explorer/aligned_layer/contracts/script/output/mainnet/alignedlayer_deployment_output.json |
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you don't have a explorer built into /home/app (on first build) you can't build the explorer as if can't find the .jsons with the addresses.

| PHX_HOST | Domain name pointing to the server | stage.explorer.alignedlayer.com | holesky.explorer.alignedlayer.com | explorer.alignedlayer.com |
| ELIXIR_HOSTNAME | Server name | `<Your server name (uname -n)>` | `<Your server name (uname -n)>` | `<Your server name (uname -n)>` |
| PHX_SERVER | Phoenix boolean to spin up a webserver | true | true | true |
| DB_NAME | Postgresql Database Name | `<Your Database Name>` | `<Your Database Name>` | `<Your Database Name>` |
| DB_USER | Postgresql Database User | `<Your Database Username>` | `<Your Database Username>` | `<Your Database Userame>` |
| DB_PASS | Postgresql Database Password | `<Your Database Password>` | `<Your Database Password>` | `<Your Database Password>` |
| DB_HOST | Postgresql network location | localhost | localhost | localhost |
| TRACKER_API_URL | Tracker API Domain name (FQDN) | https://stage.telemetry.alignedlayer.com | https://tracker.telemetry.alignedlayer.com | https://mainnet.telemetry.alignedlayer.com |
| SECRET_KEY_BASE | Elixir's Secret Key Base | `<Elixir Secret key base (mix phx.gen.secret)>` | `<Elixir Secret key base (mix phx.gen.secret)>` | `<Your Elixir Secret Key Base (mix phx.gen.secret)>` |
| KEYFILE_PATH | SSL's Keyfile location | /home/app/.ssl/key.pem | /home/app/.ssl/key.pem | /home/app/.ssl/key.pem |
| CERTFILE_PATH | SSL's Certificate location | /home/app/.ssl/cert.pem | /home/app/.ssl/cert.pem | /home/app/.ssl/cert.pem |
| BATCH_TTL_MINUTES | Batch Time to Live (In minutes) | 5 | 5 | 60 |
| SCHEDULED_BATCH_INTERVAL_MINUTES | Scheduled Interval for batch | 1 | 1 | N/A |
## Operator

> [!IMPORTANT]
Expand Down Expand Up @@ -266,3 +290,4 @@ Public Key: E([...,...])

Refer to this link for more details about keystore creation https://docs.eigenlayer.xyz/eigenlayer/operator-guides/operator-installation#create-keys


Loading