HPAY: read your inbox

This guide shows you how to read an address's QUAI or direct WQI activity in the HPAY inbox at hartiibiome.com/hpay/inbox. QUAI candidates are discovered through Quaiscan and checked again against the Quai node. WQI candidates are scanned from the reviewed token's events on the node and checked against the transaction, receipt and canonical block.

Who it's for: anyone who wants to look back at what came in and went out, a shop or a person who wants a CSV for their books, or anyone checking an address. The inbox is Beta: it is tested by our own test suites.

There is nothing to sign up for. The address is the account.

#What you'll need

• A Quai address that starts with 0x00 (Cyprus-1). Your own wallet, or any address you want to look at.
• Optional: a Pelagus or Blip wallet, so the page can open your own inbox for you. Without a wallet you can still paste any address.

#Open it

Any of these gets you there:

• the first entry in the tools list on hartiibiome.com/hpay;
• Your HPAY inbox in the Biome wallet panel, once your wallet is connected;
• See it in your inbox after a payment on a /pay page;
• a link with the address in it: https://hartiibiome.com/hpay/inbox?address=0x... (add &tab=sent to start on a tab).

#Steps

1. Open the inbox. If your wallet is already connected to the site, the page shows your own inbox. If not, press Connect wallet. This reads/shares your public address only: no signature or transaction is requested. The page then queries public chain sources for the address.
2. To look at another address, open Open any address (view only), paste a 0x00... address and press Open this inbox. An @name, a Qi address or an address outside Cyprus-1 is refused with a plain reason.
3. In Payment asset, choose QUAI or WQI. Wait while the page reads the public sources. The numbers at the top show the selected asset's activity and how many rows were checked.
4. Pick a tab: All, Received, Sent or Needs a look. Each row shows the direction, the other address, the amount, the dollar value when there is a price for that hour, and a check chip.
5. The first window is the last 30 days. Press Load older to read the 30 days before it.
6. Press Export CSV to download what is on screen.

#What the check chip means

Each QUAI payment is read again from the Quai node. A list of 60 payments or fewer checks itself; for a longer list, press Check all with the node. WQI rows are checked against the qualified token, exact transaction and canonical block as they are scanned.

• Checked: the node agrees and the payment has at least 12 confirmations.
• Confirming 3 of 12: the node agrees, but the payment is still young.
• Does not match: the node disagrees with Quaiscan. The node wins, the row appears under Needs a look, and it is left out of the totals. It stays in the CSV.
• Not checked or Could not check: the node was not asked yet, or did not answer.

#New since your last visit

The page counts the payments you received since you last pressed Mark all read. To do that, your browser keeps one time per address you open (at most 20), under a key of its own. Forget what this device has seen clears it. The inbox can also read same-device POS/activity records to show a Known on this device marker; it does not copy local note text into the inbox rows or CSV.

#The CSV

Export CSV downloads the windows on screen, in the order shown. Rows include direction (received, sent or self), transaction hash, addresses, amount, block, confirmations and checked_by_node. WQI exports add the asset, token contract and exact WQI base units; WQI has no historical dollar value. A payment the node disagrees with remains in the CSV with checked_by_node set to no. Unknown values are empty cells, never 0. The full column lists are in HPAY tools.

#What the inbox cannot do

• It cannot tell an HPAY payment from any other transfer. On the chain a QUAI payment looks the same whether it came from a pay link, a point of sale, a split, a button, Pelagus or Blip. WQI rows identify direct transfers from the reviewed token, not the bill or tool that prompted them. This is a payment history, not "all your HPAY receipts".
• Memos, order references and dollar prices from a link are not on the chain. If the same browser made or saw the payment (a point-of-sale sale, your HPAY activity), the row says Known on this device. Another browser or device will not show that.
• The newest plain transfers may lag. They come from Quaiscan's index, which can run behind the node, and the page says so when it is behind. QuaiRelay payments of the last 12 hours are read from the node itself.
• Some things are counted aside, not listed: failed transactions, transactions with no value, cross-zone transfers and other contract calls that carry QUAI. QUAI that other contracts send to the address (payouts, swaps) is not listed, because Quaiscan lists no internal transfers on Quai. WQI scans list direct holder transfers from the pinned token only and are bounded; older or unreadable candidates may be missing, with gaps shown.
• No alerts, no refunds, no disputes. The page sends nothing; it shows what the chain holds when you open it. A refund is a new payment sent by the other person.
• A failed read is never an empty inbox. If a source does not answer, the page names it at the top and says the list may be incomplete.

#Who sees what

The browser asks Quaiscan and the Quai node for public-chain data. Those services can see the addresses and requests sent to them, along with normal network metadata. WQI mode scans the public node and uses no price service; QUAI historical prices use a time range only. If you open or share an inbox URL with ?address=, the web host receives the address as part of the static page request. The inbox does not send that address to a Hartii user or payment API. Anyone can inspect an address because it is public chain data.

Anyone can open anyone's inbox, because it is public chain data: it shows the same payments Quaiscan shows. The chain has no private mode, and the inbox offers none.

#Common mistakes

• "My payment is missing." If it is a plain transfer from the last few minutes, wait and press Read again: the index may be behind. Or the payment is older than the window: press Load older.
• "Nothing in this window." That means the sources answered and found none. If a source failed, the page says "Nothing found, but the chain was not fully read" instead.
• "This is not my receipt for an order." The inbox cannot match a payment to an order reference. Use the point of sale or the Pay with HPAY button, which check the exact tagged amount.
• Wrong network. The inbox reads Quai Mainnet, Cyprus-1 (chain 9).

#Next

The reference for every HPAY tool, including the CSV columns and limits, is HPAY tools. To read what an address received over a long period, see the Statement in the same page.