Fulcrum is a drop-in replacement for ElectronX/ElectrumX server that runs on embassyOS. This repository creates the s9pk package that is installed to run fulcrum on embassyOS. Learn more about service packaging in the Developer Docs.

Install the system dependencies below to build this project by following the instructions in the provided links. You can also find detailed steps to setup your environment in the service packaging documentation.

• docker
• docker-buildx
• yq
• deno
• make
• embassy-sdk

Prepare your embassyOS build environment. In this example we are using Ubuntu 20.04.

1. Install docker

curl -fsSL https://get.docker.com -o- | bash
sudo usermod -aG docker "$USER"
exec sudo su -l $USER

2. Set buildx as the default builder

docker buildx install
docker buildx create --use

3. Enable cross-arch emulated builds in docker

docker run --privileged --rm linuxkit/binfmt:v0.8

4. Install yq

sudo snap install yq

5. Install deno

sudo snap install deno

6. Install essentials build packages

sudo apt-get install -y build-essential openssl libssl-dev libc6-dev clang libclang-dev ca-certificates

7. Install Rust

curl https://sh.rustup.rs -sSf | sh
# Choose nr 1 (default install)
source $HOME/.cargo/env

8. Build and install embassy-sdk

cd ~/ && git clone --recursive https://github.com/Start9Labs/embassy-os.git
cd embassy-os/backend/
./install-sdk.sh
embassy-sdk init

Now you are ready to build the fulcrum package!

Clone the project locally:

git clone https://github.com/Start9Labs/fulcrum-wrapper.git
cd fulcrum-wrapper
git submodule update --init --recursive

To build the fulcrum package for all platforms using embassy-sdk version

=0.3.3, run the following command:

make

To build the fulcrum package for a single platform using embassy-sdk version <=0.3.2, run:

# for amd64
make ARCH=x86_64

or

# for arm64
make ARCH=aarch64

Run the following commands to determine successful install:

ℹ️ Change embassy-server-name.local to your Embassy address

embassy-cli auth login
# Enter your embassy password
embassy-cli --host https://embassy-server-name.local package install fulcrum.s9pk

If you already have your embassy-cli config file setup with a default host, you can install simply by running:

make install

Tip: You can also install the fulcrum.s9pk using Sideload Service under the System > Manage section.

Go to your Embassy Services page, select Fulcrum, configure and start the service. Then, verify its interfaces are accessible.

Done!