Argon Apps

This repo contains two desktop applications that helps you interact with the Argon mainchain. Among the core activities are:

• Mining: Argon is a proof-of-authorized-work blockchain. Use the Argonot Operator app to mine Argon tokens.
• Vaultingt Run a vault. Earn interest by collateralizing Bitcoin Locks.
• Liquid Locking Secure Bitcoins into Vaults to unlock the equivalent Argon liquidity.

Features

Mining

Become an Argon Miner, even if you don't know have the technical background to manage a server.

The workflow will help you:

• Provision a mining machine (current providers are [Digital Ocean, Custom Servers, Local Docker])
• Calculate a profitable "bid" amount
• Configure a bidding "bot" to win 1 or more mining seats
• Monitor your bids and earnings

Vaults

Vaults provide collateralization security to Bitcoin Lockers. As a Vault operator, you are able to set the APR per Argon for Bitcoin Locks, as well as the percent you're willing to share with Treasury Pool providers (for more details, refer to the Argon documentation amd white-papers).

Activities:

• Create a Vault
• Cosign Bitcoin Lock release-requests
• Monitor Treasury Pool returns
• Liquid Lock BTC in your Vault

Testing Vaults

You can run the docker-compose file that's in the mainchain repository to access bitcoin liquidity to test with (locally). Running this yarn command will download the latest docker-compose from the argon mainchain repository and start it up:

yarn docker:up

.. This will start bitcoin, a miner, a pricing oracle, and an "esplora" explorer that Argonot Operator uses to track your bitcoin transactions.

You will need the following commands to run against the cli locally:

# Send bitcoin to the cosign address (replace with your address/amount)
yarn docker:btc sendtoaddress bcrt1qwyf38ct4yzdd4vqfwa0mtr2qw49n62y8me970737nfea3a7asmhqjcwjfc 0.00039045

# Get a destination address for released bitcoin
yarn docker:btc getnewaddress

# Broadcast the released bitcoin
yarn docker:btc sendrawtransaction 020000000001016aa1e38d96312ee99386a13c443bcc38e2c8cb84d55ed779d62...

# Check the status of the bitcoin transaction
yarn docker:btc gettransaction 020000000001016aa1e38d96312ee99386a13c443bcc38e2c8cb84d55ed779d62...

Now you'll want to run Argonot Operator with the environment variable ARGON_NETWORK_NAME=dev-docker to connect to the local docker instance.

Installation

This project has an automated action to build from the source of the project for each release. The action is triggered by a push to a version branch. These releases are guaranteed to match a git hash, so you can see what you're installing. However, they are unsigned, so will require steps to open on Mac/Windows.

Downloads are available for each "release" on the releases page.

Mac

1. Download the latest "dmg" installer from the releases page.
2. Click to run the installer once downloaded
   • Drag the app file to your Applications folder
3. Try to open the app once (it will be blocked and prompt you to move it to the trash)
   • Click Done
     
4. Open the "System Settings" app
5. Click Security & Privacy
6. Navigate down to Security
7. Click "Open Anyway" next to the message about the Argonot Operator (or Argon Investor Wallet, depending on which app you're installing)
   
8. Click "Open Anyway" on the pop-up
   
9. You can now open the app from the Applications folder (or a link on your Dock).

Windows

1. Download the latest windows installer (exe or msi) from the releases page.
2. Run the installer
3. You will likely see a screen that says "Windows protected your PC"
   • Click More info
     
4. Click "Run Anyway"
5. Complete the installation

Building From Source

You can build this project from source by running:

yarn install
yarn tauri build

Local Docker + E2E

For local mainchain/dev-docker work, keep runtime pinning and e2e in sync:

yarn mainchain:pin <tag-or-commit>
yarn install

Flows are the primary automation path and are documented in e2e/README.md.

Common commands:

# Full dev stack
yarn dev:docker

# Run e2e Vitest specs (flows-based, from root Vitest project)
yarn vitest --run --project e2e

# Run selected flow(s) directly
yarn e2e:docker
E2E_FLOWS=miningOnboarding yarn e2e:docker
E2E_FLOWS=vaultingOnboarding yarn e2e:docker

# Keep UI visible while running e2e flows
ARGON_E2E_HEADLESS=0 yarn e2e:docker

# Cleanup/reset e2e docker state
yarn clean:dev:docker
yarn docker:down