timothyshimmin / dojo-startos

Wrapper for dojo

Samourai Dojo is the backing server for Samourai Wallet. This .s9pk wrapper will allow you to run Dojo on your Embassy.

Dependencies

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

Build enviroment

Prepare your EmbassyOS build enviroment. 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 essentials build packages

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

6. Install Rust

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

7. Install toml

cargo install toml-cli

8. Build and install embassy-sdk

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

Cloning

Clone the project locally. Note the submodule link to the original project(s).

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

Building

To build the project, run the following commands:

docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
docker buildx create --name multiarch --driver docker-container --use
docker buildx inspect --bootstrap

You should only run the above commands once to create a custom builder. Afterwards you will only need the below command to make the .s9pk file

make

Installing (on Embassy)

SSH into an Embassy device. scp the .s9pk to any directory from your local machine. Run the following command to install the package:

embassy-cli auth login
#Enter your embassy password then run:
embassy-cli package install /path/to/dojo.s9pk

Verify Install

Go to your Embassy Services page, select dojo and start the service.

#Done