Anser is a client-side web app that uses the Alby extension's liquid integration to provide a simple interface to the Liquid Network.
See the FAQ for more details.
Anser is a progressive web app that can be easily installed on your device, providing a native app experience. Alternatively, you can utilize it directly within your browser or even host your own instance.
There is a live version hosted on github pages that is automatically updated with every release, you can find it here also available on IPfs (check the Release Page for the link).
If you wish to test the latest updates from the master branch, you can access the snapshot here.
Anser is a web app that can be hosted on any web server capable of serving static files.
- Download the latest release from the Release Page.
- Unzip the archive
- Upload the extracted files to your web server
Anser is also available as a self-contained docker container that can be run on any docker host. You can build a docker image from this repo (see Build and run with Docker) or you can pull the latest image from github package registry.
# Pull the image ( check https://github.com/riccardobl/anser-liquid/pkgs/container/anser-liquid for the latest version )
docker pull ghcr.io/riccardobl/anser-liquid:v1.0
# Run and expose on port 8080
docker run -d \
--restart=always \
--name="anserliquid" \
--read-only \
--tmpfs /data \
--tmpfs /tmp \
--tmpfs /config \
-p 8080:80 \
ghcr.io/riccardobl/anser-liquid:v1.0
One way to use Anser Library is to include the LiquidWallet.js script as a module and instantiate a LiquidWallet object.
However to make things even easier, there is an additional set of simplified APIs that is automatically exported in window.liquid namespace when the script is included as a normal script tag.
<script src="https://cdn.jsdelivr.net/gh/riccardobl/anser-liquid@releases/{VERSION}/liquidwallet.lib.js"></script>
N.B. Replace {VERSION} with the latest version from the Release Page.
The window.liquid
API provides common functionalities in a more intuitive way.
See the documentation here.
You can find the minified version of LiquidWallet.js that can be used both as a module and as a script tag in the Release Page or in JsDelivr.
- NodeJS and NPM
- git
- bash
# Clone the repo
git clone https://github.com/riccardobl/anser-liquid.git
# Enter the directory
cd anser-liquid
# (Optional) checkout a specific version
# git checkout v1.0
# Prepare the environment
bash prepare.sh
# Test (this will run a local server on port 9000)
npm run start
# Build (this will build a release version in the dist/ directory)
BUILD_MODE="production" npm run build
# Clone the repo
git clone https://github.com/riccardobl/anser-liquid.git
# Enter the directory
cd anser-liquid
# (Optional) checkout a specific version
# git checkout v1.0
# Build
docker build -t anserliquid .
# Run and expose on port 8080
docker run -it --rm \
--name="anserliquid" \
--read-only \
--tmpfs /data \
--tmpfs /tmp \
--tmpfs /config \
-p 8080:80 \
anserliquid
The anser container does not provide a TSL certificate. To enable https you can use a reverse proxy like nginx or customize the Caddyfile and rebuild the container.
The source code is logically divided in 2 parts:
- src/js/LiquidWallet.js serves as the backend component, managing all interactions with various APIs. It provides a streamlined interface that can be easily integrated with any application.
- src/js/ui contains everything related to the UI of the web app.
The entry point of the web app is
Yes, Anser relies on the Alby browser extension for key management and signing.
No, Anser is a fully client-side app; your keys never leave the Alby extension.
No, Anser serves as an interface that filters and displays data from the Liquid Network. It enables you to create valid transactions that are signed by the Alby extension and broadcasted through an Electrum node.
Anser connects to the public websocket endpoint provided by Blockstream. It's important to note that this node only provides access to public data of the Liquid Network, and broadcast your transactions to the other nodes. It does not hold your keys or funds and cannot sign or build transactions on your behalf.
Absolutely! Anser is a static web app that can be hosted on any webserver, including your local machine.