Solvers Onboarding Dashboard: User Guide

Overview

The Qubetics Chain Abstraction Protocol is a platform for solvers to join the chain abstraction solver network, contribute liquidity, and earn rewards.

This guide walks through the complete solver journey, from onboarding to liquidity management and rewards. Ensuring clarity for both community members and active participants.

Onboarding Flow

Step 1: Connect Wallet

  • The solver visits the Qubetics solver portal.

  • They connect their wallet (MetaMask or Wallet Connect)

  • Once connected, the wallet address is auto-filled across the platform and becomes the account identity of the solver.

Step 2: Solver Information

The solver fills in details to register on the network:

  • Connected Wallet Address: Automatically filled from your connected wallet; links your account to the solver.

  • Node Address (Solver ID): A unique identifier assigned to your solver node for protocol recognition.

  • Node URL: The endpoint where your solver node can be reached, formatted as http://<IP or URL>:<PORT>.

  • Solver Name: A custom label you choose to easily identify your solver in the dashboard.

  • Whitelist Wallet Addresses: the wallets authorized for liquidity transfer:

  • BTC Wallet: Your Bitcoin wallet from which liquidity will be sent.

  • EVM Wallet: Your EVM wallet for TICS from which liquidity will be sent.

Note: All the fields in this form must be new and unique; otherwise, the network will not accept the form details.

Node URL input field:

Users must provide the URL of the node they wish to connect to in the Node Information section. This URL serves as a gateway for communication with the solver's network. Make sure the URL is secured with s in https://

Your IP instance will be like this, e.g.

http://ip-address:(port here)

Or

https://(domain-url)

To check your instance IP, use this command: curl ifconfig.me

Note: If your node’s RPC URL is not bound to the domain, then you need to bind your node URL to log in to the validator application.

Steps to bind the URL (Important):

1. Set up any proxy server like nginx or ALB (AWS Load Balancer Service) and proxy traffic to the node IP & port from port 80 / 443

2. Configure the proxy server to redirect traffic from 80 to 443

3. Set up SSL either using 3rd party certificates or certbot (Let's Encrypt cert manager)

4. Map the server IP to your domain

Reference Link: https://abhishek-raj.medium.com/how-to-get-your-server-up-and-running-on-https-using-nginx-in-10-minutes-9ea422bca447

Step 3: Liquidity Addition

  • Select Tokens: Tick the checkboxes for the tokens you want to provide liquidity with.

  • Enter Amounts: Input the number of tokens you’ll add; the system shows their USD equivalent.

  • Verify Eligibility: Ensure each token meets the $5000 requirement (green checkmark confirms this).

  • Check Total Value: See your total contribution at the bottom.

  • The system validates fields and liquidity thresholds before proceeding.

  • Proceed or Go Back: Click Next to confirm and move ahead

Step 4: Confirmation & Authorize

  • Review Amounts: Double-check the BTC and TICS values to ensure accuracy.

  • Understand the Process: Note that you’ll need to manually send the tokens from your whitelisted wallet to the secure deposit address.

  • Tick the Checkbox: Confirm that you understand this requirement by checking the box.

  • Click Authorize: Proceed to receive the secure deposit address for completing the transfer.

  • Or Cancel: If something looks incorrect, click Cancel and go back to adjust values.

Note:

  • You are required to tick the checkbox in order to proceed.

  • Clicking "Authorize" will initiate a transaction with the solver onboard contract to register the details.

Step 5: Transfer Funds to Liquidity Pool Address

  • A confirmation modal appears with:

  • Token type & exact contribution amount.

  • Liquidity pool wallet address for the transfer.

  • Review Token Entries: Confirm the amounts for BTC and TICS match what you specified earlier.

  • Copy Pool Address: Use the copy icon to safely copy the destination address before sending tokens.

  • Solvers must transfer tokens from their whitelisted wallets only.

  • Once acknowledged, the solver is redirected to the dashboard.

Solver Dashboard

The Solver Dashboard helps in monitoring and managing your participation in the Qubetics Chain Abstraction protocol. It provides a real-time snapshot of liquidity, rewards, performance, and recent activity.

​​Status Bar

  • Shows your solver’s activity status (Active/Inactive).

  • Displays your Solver Address.

  • Total Liquidity is highlighted in the top-right corner.

Liquidity & Rewards Overview

  • BTC & TICS Balance: Your contributed liquidity (with fiat equivalent).

  • Rewards Earned: Shows claimed BTC & TICS till date

  • Claimable Rewards: Displays unclaimed rewards in the dollar value of rewards ready to be claimed.

Node & Performance

  • Node Status → Current operational state (e.g., Active).

  • Intent Resolved → Total successful transactions processed.

  • Network Uptime → How long your node has been online.

  • Performance Metrics → Breakdown of resolved intents and uptime duration.

Solver Configuration

  • Solver ID & Name → Your unique solver identifier.

  • Whitelisted Addresses → BTC & EVM addresses linked to this solver.

  • Date Joined & Total Liquidity → Quick reference to your onboarding history and contribution size.

Recent Activity

  • Displays a transaction log:

  • Action (e.g., Add Liquidity).

  • Transaction Hash

  • Amount & Network (BTC or Qubetics).

  • Status (Success/Pending).

  • Timestamp of activity.

Functions:

1. Adding More Liquidity

  • From the dashboard, solvers can add more liquidity at any time.

  • Tokens supported BTC & TICS

  • Click on “add liquidity” button for the specified token to add liquidity for that token.

  • Follow the 2 step liquidity addition process to add liquidity for the specified token.

2. Claiming Rewards

  • Rewards earned are tracked in real-time on the dashboard.

  • Solvers see two values:

  • Rewards Earned – accumulated total.

  • Claimable Rewards – amount available for immediate withdrawal.

  • Solvers click Claim to transfer rewards to their connected wallet.

3. Viewing Performance Metrics

The Solver Dashboard displays:

  • Liquidity Status (active or inactive)

  • Transactions Processed count

  • Network Uptime percentage

  • Average Response Time of their solver node

  • Recent Activity Log including liquidity provisions, claims, cross-chain actions, and withdrawals

4. User flow

Last updated