LithosDocs
ProtocolPayoutsTokenStatsDocs
Start mining
Documentation home
Protocol
  • Lithos Protocol
  • LFSM
    • Rollups
    • NISPs
    • Emissions
    • Mining on Lithos
    • Candidate building
    • Ergo Voting
  • LithosDex
    • Choosing a pool
    • Trading with orders
    • Providing liquidity
    • Creating a pool
    • Difficulty forwards
Run Lithos
  • Startup guide
    • Setting up an Ergo node
  • Configuration
    • Node connection and security
    • Stratum and difficulty
    • Block packages
    • Batching and orders
    • Collateral and emission
    • Wallet and consolidation
    • Statistics and web panels
    • Synchronization and storage
    • Tasks and dispatchers
    • Failure modes
    • Reporting issues
    • Renting hashrate into Lithos
    • Checking your wallet
Client API
  • Overview
    • getLithos client information
    • getList UTXO ids for blocks
    • getUTXO ids by block height
    • getBlock info by UTXO id
    • postBlock info for multiple UTXO ids
    • getGet a block's miner set
    • getList all pool blocks
    • getGet Lithos payouts
    • getStatistics overview
    • getMining and payment totals
    • getMining statistics by hour or day
    • getEstimate Lithos hashrate
    • getNetwork difficulty by epoch
    • getThis client's own hashrate
    • getThis client's hashrate over time
    • getThis client's payouts and claims
    • getCollateral inventory
    • getThis wallet's lending earnings
    • getLocal mining activity
    • getCollateral market snapshot
    • getList queue boxes
    • getList the active set
    • getPermit price history
    • getYour lending status
    • postQuote joining the queue
    • postJoin the collateral queue
    • getLithosDex pool state
    • getEvery LithosDex pool
    • getOne LithosDex pool and its vault
    • getList your outstanding orders on any pool
    • postQuote a direct swap on any pool
    • postSwap directly on any pool
    • postQuote a direct deposit on any pool
    • postDeposit directly on any pool
    • postQuote a direct redemption on any pool
    • postRedeem a provision directly on any pool
    • getList your provisions on any pool
    • postClaim a provision's fees on any pool
    • postCheck a flush on any pool
    • postFlush any pool
    • getA verified pool's price history
    • getA verified pool's fee history
    • getA verified pool's recent activity
    • getA provision's fee history on a verified pool
    • postQuote a new LithosDex pool
    • postCreate a LithosDex pool
    • postQuote a swap order on any pool
    • postPlace a swap order on any pool
    • postQuote a deposit order on any pool
    • postPlace a deposit order on any pool
    • postQuote a redeem order on any pool
    • postPlace a redeem order on any pool
    • getLithosDex fee vault state
    • getList your outstanding orders
    • postQuote a swap order
    • postPlace a swap order
    • postQuote a deposit order
    • postPlace a deposit order
    • postQuote a redeem order
    • postPlace a redeem order
    • postCancel an order
    • postQuote a swap
    • postQuote a swap by desired output
    • postExecute a swap
    • postQuote a liquidity deposit
    • postDeposit liquidity
    • postQuote a liquidity redemption
    • postRedeem liquidity
    • getList liquidity provisions
    • postLook up provision NFTs
    • postClaim settled fees for a provision
    • postQuote a provision resize
    • postResize a provision
    • postCheck a pending fee flush
    • postFlush pending fees to the vault
    • getPool-wide fee history
    • getPool price history
    • getRecent pool activity
    • getFee history for one provision
    • getDifficulty accumulator and the next epoch's difficulty
    • getList open offers
    • postCreate an offer
    • postQuote an offer
    • postQuote filling an offer
    • postFill an offer
    • postQuote cancelling an offer
    • postCancel an offer
    • getThe whole market
    • getYour settled positions and closed offers
    • getList your positions and offers
    • postQuote settling a position
    • postSettle a position
    • getWallet balances
    • getYour block rewards
    • postClaim unlocked block rewards
    • getVerified tokens
    • getGet Stratum information
    • getGet candidate settings
    • getGet difficulty commitment
    • postCommit a difficulty
    • getGet best NISP at height
Lithos

A decentralized mining pool protocol on Ergo. Miners build their own blocks; contracts pay them for proven work.

Live on Ergo mainnet
Protocol
  • How Lithos works
  • Mining on Lithos
  • NISPs
  • Emissions
  • LFSM contracts
Run Lithos
  • Startup guide
  • Configuration
  • LithosDex
  • Difficulty forwards
  • Client API
  • Failure modes
Network
  • Live stats
  • Public stats API
  • Ergo Platform↗
  • SOAT Miner↗
Community
  • Telegram↗
  • X / Twitter↗
  • GitHub↗
Lithos
© 2026 Lithos Protocol. The Lithos client, its contracts and Lithos Launcher are open source under CC0.λίθος — stone
Docs/Run Lithos/Operations

Checking your wallet

Reading your node wallet in the web panel's Wallet page, checking tokens and provision NFTs, and claiming lending rewards.

Standard3 min readFor anyone running the Lithos client with its web panel. No Ergo experience needed.

The web panel's Wallet page shows what the node wallet your client signs with holds: its ERG, its tokens, the boxes the client is holding for transactions, and your lending rewards. This page covers reading it, checking tokens, and claiming rewards. The settings that control how the client uses the wallet are in Wallet and consolidation.

Opening the Wallet page#

Open Wallet in the client's navigation bar. The page reads your wallet through the client's API, so it needs the API key, entered under Settings. The key is kept in memory, so you enter it again after refreshing the page, unless you turn on Remember API key in this browser. Read Remembering the key in the web panel before you do.

Reading the summary#

The top of the page shows the following figures:

FigureWhat it shows
SpendableERG in plain boxes the client is not holding for anything. A join quote is priced against this
Held for transactionsERG and boxes held for transactions in flight, or kept for your own blocks
TokensHow many tokens the wallet holds, and how many are verified
Claimable rewardsLending rewards you can claim now, and how many reward boxes have unlocked

Held boxes come back once the transaction they fund confirms or fails. When held boxes are released explains how long that can take.

Checking your tokens#

The Tokens list shows every token the wallet holds, verified tokens first. Filter it by Verified, Unverified or NFTs, or search by name, ticker or id. Hover over a token to see its full details.

A Verified badge means the token is on the verified list that ships with the client. Any other token's name and ticker were chosen by whoever minted it, and another token can carry the same name. Check the token id before you trust a name.

Checking provision NFTs#

A LithosDex position is owned by an NFT, and anyone can mint a token named like one. The page checks the single-unit tokens in your wallet against the LithosDex pools and marks each one as follows:

BadgeWhat it means
LD-NFTThe NFT owns an open provision. Hover to see the pool and the provision's stats, or follow the link to the pool's Liquidity tab
Not an LD-NFTThe token is named like a provision NFT, but owns no open provision

The check runs by itself when the wallet holds 100 tokens or fewer. Above that, tick Check provision NFTs automatically, or select the tokens to check and select Check selected. Select LD-NFT names selects every token named like a provision NFT. Providing liquidity covers checking an NFT you do not hold.

Claiming lending rewards#

When a block spends one of your collateral boxes, the block's reward is paid to you and locked for 720 blocks, about a day at Ergo's 2-minute block time. Lending rewards shows what is Claimable now and what is Still locked.

Select Claim to move every unlocked reward to your primary address at once, where it becomes spendable ERG. The client also does this on a timer, as Sweeping lending rewards describes.

Primary address shows the address that receives change and swept rewards.

Next steps#

  • Wallet and consolidation: how the client selects, holds and merges your wallet's boxes.
  • Choosing a pool: what the verified list means for LithosDex pools.
Edit this page on GitHubsynced from main
← PreviousRenting hashrate into LithosNext →Overview
On this page
  • Opening the Wallet page
  • Reading the summary
  • Checking your tokens
  • Checking provision NFTs
  • Claiming lending rewards
  • Next steps