Lynx Blockchain
  • Welcome
  • Technical Evolution and Architecture Overview
  • History of Lynx
    • Evolution of a Blockchain
    • Hybrid Proof of Work (HPoW) Protocol
    • Pioneering Blockchain Data Storage
    • Evolution to Proof of Stake
    • Next Generation Data Storage Architecture
    • Preserving Knowledge
  • Lynx Core
    • Hardware and System Requirements
    • Lynx Dynamics
    • Open Source
    • Core Parameters and Strategy
    • Sustainability
    • Circulating Supply Analysis
    • Locked Addresses
    • Data Storage
      • auth
      • fetch
      • fetchall
      • store
      • status
      • list
    • Understanding the Encryption Option
    • Understanding Lynx Staking Wait Times
    • Understanding Asset Retrieval Times
    • Understanding Block Time Targeting in the Lynx Blockchain
    • Understanding the Lynx Blockchain Statistics Report
  • Lynx Administration
    • Public Peer Nodes
    • Understanding Blockchain Bootstrap Files
      • Bootstrap Extraction Script
      • Bootstrap Creation Script
    • How to Sweep a Lynx Wallet
    • Enable/Disable Staking
  • Clevver
    • Revolutionizing Digital Preservation
    • Permanent Storage for Digital Assets
    • Permanent Digital Archives for Journalism
    • How did Clevver originate?
    • Shortened URL Support
    • Assigning Tags to Assets
    • How to delete content
    • Clevver Terms of Service Agreement
  • Clevver API
    • Public Methods
      • Batches
      • Files
      • User
  • ElectrumX
    • Lynx ElectrumX nodes
    • Build Script Details
  • External Links
    • Lynx Explorer
    • Lynx Github
    • Lynx Uptime Report
    • Clevver Website
  • Lynx Bootstraps
  • Wallet Links
    • Komodo Wallet
    • Wally.id Wallet
    • Lynx Paper Wallet
  • Social Links
    • Lynx Discord
    • Lynx on Bluesky
    • Clevver on Bluesky
  • Exchange Links
    • FreiXLite (LYNX/LTC)
  • FreiExchange (LYNX/BTC)
  • Komodo Wallet (SWAP)
  • XredX (LYNX/LTC)
  • XredX (LYNX/DOGE)
  • XredX (LYNX/IL8P)
Powered by GitBook
On this page
  • Overview
  • Syntax
  • Description
  • Parameters
  • Returns
  • Usage Notes
  • Examples
  • Implementation Notes
  1. Lynx Core
  2. Data Storage

status

Published: March 2025 | Last updated: March 2025

Overview

The status RPC method provides diagnostic information about the blockchain storage system's operational state. It shows the current condition of the storage worker and lists the most recent storage jobs (both completed and in progress). This command is essential for monitoring system health and troubleshooting issues with file storage operations.

Syntax

status

Description

When you invoke the status method, the Lynx daemon checks the current state of the storage worker process and retrieves information about recent jobs from the work queue. This gives you immediate visibility into the system's activity and helps identify potential bottlenecks or errors in the storage subsystem. The information is particularly valuable when diagnosing problems with store or fetch operations that may appear unresponsive.

Parameters

This method does not accept any parameters.

Returns

The method returns an array containing the worker status and recent job information:

[
  "WORKER_IDLE",
  "00112233445566778899aabbccddeeff, Fetch operation completed successfully",
  "aabbccddeeff00112233445566778899, Store operation failed: file not found",
  ...
]

The array contains the following elements:

  1. First element: The current status of the storage worker, which will be one of:

    • WORKER_IDLE - The worker is available and ready to process new storage jobs

    • WORKER_BUSY - The worker is currently processing a storage job

    • WORKER_ERROR - The worker has encountered an error and may need attention

  2. Subsequent elements: The most recent job results (up to 15 entries), with each entry containing:

    • The UUID of the file involved in the operation

    • A status message describing the result of the operation

The job list is ordered chronologically with the most recent jobs appearing last in the array.

Usage Notes

  • No authentication is required to use this command, making it useful for basic system diagnostics

  • The command only shows the most recent 15 job results to prevent overwhelming output

  • You can use this command to verify if the storage worker is available before submitting large storage jobs

  • If the worker shows WORKER_ERROR status, you may need to restart the daemon to resolve issues

Examples

Check the current system status

lynx-cli status

Output when the system is idle:

[
  "WORKER_IDLE",
  "00112233445566778899aabbccddeeff, Fetch completed",
  "aabbccddeeff00112233445566778899, Store completed"
]

Output when the system is processing jobs:

[
  "WORKER_BUSY",
  "00112233445566778899aabbccddeeff, Fetch completed",
  "aabbccddeeff00112233445566778899, Store in progress"
]

Using JSON-RPC:

curl --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "status", "params": []}' -H 'content-type: text/plain;' http://127.0.0.1:9332/

Implementation Notes

  • The system maintains a history of job results that persists until the daemon is restarted

  • Only the most recent 15 job results are displayed to keep the output manageable

  • While this command provides operational status, it does not include detailed performance metrics

PreviousstoreNextlist

Last updated 2 months ago

Page cover image