DLC-protocol-wallet

A test backend to:

• generating offer messages for numerical contracts
• receiving accept messages and returning sign messages from them

Run with:

cargo run

Run against dev test environment:

STORAGE_API_ENDPOINT="https://dev-oracle.dlc.link/storage-api" FUNDED_URL="https://stacks-observer-mocknet.herokuapp.com/funded" BTC_RPC_URL="electrs-btc2.dlc.link:18443/wallet/alice" RPC_USER="devnet2" RPC_PASS="devnet2" ORACLE_URL="https://dev-oracle.dlc.link/oracle" STORAGE_API_ENABLED=true RUST_LOG=warn,dlc_protocol_wallet=info cargo run

Run against a full local stack (dlc.link devs only):

STORAGE_API_ENDPOINT="http://localhost:8100" FUNDED_URL="http://localhost:8889/funded" BTC_RPC_URL="localhost:28443/wallet/alice" RPC_USER="devnet2" RPC_PASS="devnet2" ORACLE_URL="http://localhost:8080" RUST_BACKTRACE=full STORAGE_API_ENABLED=true RUST_LOG=warn,dlc_protocol_wallet=info cargo run

• Note, you can change the RUST_LOG to RUST_LOG=warn,dlc_protocol_wallet=debug for more debugging of this app's functioning.

Docker Compose example:

• go into the docker folder and create a .env file like this (you can make a duplicate of the .env.template file and rename it to .env):

CONTRACT_CLEANUP_ENABLED: "false",
ELECTRUM_API_URL: "https://dev-oracle.dlc.link/electrs/",
BITCOIN_NETWORK: "regtest",
DOCKER_PUBLIC_REGISTRY_PREFIX=public.ecr.aws/dlc-link/,
FUNDED_URL: "https://stacks-observer-mocknet.herokuapp.com/funded",
ORACLE_URL: "https://dev-oracle.dlc.link/oracle",
RUST_LOG: "warn,dlc_protocol_wallet=debug",
RUST_BACKTRACE: "full",
STORAGE_API_ENABLED: "true",
STORAGE_API_ENDPOINT: "https://dev-oracle.dlc.link/storage-api",

Then run:

docker-compose up -d

If you run into an authentication error when pulling down the docker image like this:

Error response from daemon: pull access denied for public.ecr.aws/dlc-link/dlc-protocol-wallet, repository does not exist or may require 'docker login': denied: Your authorization token has expired. Reauthenticate and try again

Run the authentication command like this: aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin public.ecr.aws

as per this article: https://docs.aws.amazon.com/AmazonECR/latest/public/public-registries.html#public-registry-auth

API documentation:

See wallet.yaml - the content can be copied to swagger editor

Build Error

https://github.com/rust-lang/rust/issues/110475

If seeing something like: error[E0275]: overflow evaluating the requirement F: FnMut<(&Pk,)> then consider reverting back your nightly build of Rust to something like: rustup override set nightly-2023-03-31