Forest Explorer

Forest Explorer is a server-less inspector of the Filecoin blockchain.

Implementation

Rust + Leptos application which is compiled to a server WASM module and a client WASM module. The server module is hosted by CloudFlare. It pre-renders a HTML response and hydrates it (i.e. add reactivity) via the client WASM module.

Anything pushed to main will automatically be deployed at https://forest-explorer.chainsafe.dev.

Development

Installing node(LTS versions recommended).

Running corepack enable to opt-in corepack, see docs for details.

Running yarn or yarn --immutable once to install all required npm dependencies.

Running yarn start will spawn a local copy of the explorer.

To speed up the build during development, you can run yarn dev which will skip the optimization step.

You can define secrets for your local faucet in the .dev.vars file. This file is ignored by git.

SECRET_WALLET=
SECRET_MAINNET_WALLET=
RATE_LIMITER_DISABLED=true

Note - the RATE_LIMITER_DISABLED variable is required to be set to true in order to bypass the rate limiter in the local environment if you want to test the faucet.

Dependencies

• wrangler
• wasm-pack
• worker-build

Custom deployments

Account & domain

1. In wrangler.toml, set account_id to your CloudFlare account ID.
2. In wrangler.toml, set pattern in routes to match your domain.

In order to deploy to a different CloudFlare account, you need to do the following:

Rate limiter

If you have a paid CloudFlare account:

1. Create a KV store in CloudFlare. It can be found under the Storage & Databases tab. The name can be anything.
2. In wrangler.toml, set id in kv_namespaces to your KV store id (from step 1).

If you have a free CloudFlare account, you will need to disable the rate limiter. ⚠️ This is not recommended for production use as it will expose your service to abuse.

1. In wrangler.toml, remove or comment out [durable_objects] and [migrations] sections. Additionally, remove kv_namespaces from the [env.quick] section.
2. Run npx wrangler@latest secret put RATE_LIMITER_DISABLED true.

Wallets

Set SECRET_WALLET (calibnet) and/or SECRET_MAINNET_WALLET (mainnet) using npx wrangler@latest secret put (values are exported private keys, see forest-wallet export).

Deployment

Run npx wrangler@latest deploy.