Qearn Frontend and Smart Contract Integration

[serendipity-seeker]

Key Features

• Qearn Page: Interface for managing Locking and Unlocking statuses.
• Qearn Service: Handles main logic and utilities.
• Time Service: Manages locking epochs.
• API Integration:
  • querySmartContract: Query SC state.
  • broadcastTransaction: Broadcast transactions to the blockchain.

Running on Testnet

Prerequisites

• Running Qearn SC testnet
• Repositories:
  • Go Qubic Node
  • Qubic HTTP Server

Setup

1. Confirm Testnet: Ensure the testnet is running.
2. Docker Setup: Use the following docker-compose to set up the services.

  services:
  qubic-http:
    image: ghcr.io/qubic/qubic-http:v0.7.0
    container_name: qubic-http
    environment:
      QUBIC_API_SIDECAR_SERVER_HTTP_HOST: "0.0.0.0:8000"
      QUBIC_API_SIDECAR_SERVER_GRPC_HOST: "0.0.0.0:8001"
      QUBIC_API_SIDECAR_SERVER_MAX_TICK_FETCH_URL: "http://qubic-nodes:8080/max-tick"
      QUBIC_API_SIDECAR_POOL_NODE_FETCHER_URL: "http://qubic-nodes:8080/status"
      QUBIC_API_SIDECAR_POOL_NODE_PORT: "31844"
      QUBIC_API_SIDECAR_POOL_NODE_FETCHER_TIMEOUT: "20s"
    ports:
      - "0.0.0.0:8000:8000"
    networks:
      - qubic
    depends_on:
      qubic-nodes:
        condition: service_healthy
    restart: always
  qubic-nodes:
    image: ghcr.io/qubic/qubic-nodes:v1.0.4
    container_name: qubic-nodes
    environment:
      QUBIC_NODES_QUBIC_PEER_LIST: "45.143.199.17"
      QUBIC_NODES_QUBIC_PEER_PORT: "31844"
    networks:
      - qubic
    healthcheck:
      test: [ "CMD", "wget", "-q", "--spider", "http://127.0.0.1:8080/status" ]
      interval: 5s
      timeout: 5s
      retries: 5
    restart: always

  networks:
    qubic:

3. Modify Testnet URL: Update testnet-proxy.js:

   const testnetURL = 'http://116.202.157.215:8000'; // Update URL as HTTP server URL

Running the Application

1. Install Dependencies:

   yarn install

2. Start Testnet Proxy:

   node testnet-proxy.js

3. Start the Application:

   yarn start

Live Test URL

• https://116.202.157.215:4200

Ensure the testnet is running before testing.

References

• QEarn Article
• Qearn Specification
• Qearn Reward Table