## Layout

The homepage shows four stat cards above a live _Latest Transactions_ feed:

| Card | What it shows |
| --- | --- |
| `Network (GH/s)` | Hashrate (always `-` on a pure PoS chain) |
| `Difficulty` | Two lines: `POW: x.xxx` and `POS: x.xxx` |
| `Coin Supply (POT)` | Fixed at `420,000,000` |
| `BTC Price` | Market feed (may read `0.00000000 BTC` until wired) |

The footer shows current block height and peer count, updated live.

## Searching

1. ### Click into the search box

Placeholder text reads exactly: _"You may enter a block height, block hash, tx hash or address."_

2. ### Paste any of the following

- **A block height** — integer, e.g. `696`
   - **A block hash** — 64 hex chars, e.g. `000001b8e7e172fd...`
   - **A transaction id** — 64 hex chars, copied from your wallet
   - **A PotCoin address** — base58 starting with `P`
3. ### Hit `Search`

You'll be redirected to the matching detail page (`/block/...`, `/tx/...`, or `/address/...`).

## Pages you'll use

| URL | What it shows |
| --- | --- |
| `/` | Stat cards + latest transactions |
| `/movement` | Large-transaction feed (whale watch) |
| `/network` | Peers seen in the last 24h, with country / protocol / sub-version |
| `/richlist` | Top 100 holders, plus wealth-distribution buckets |
| `/info` | Self-documenting API reference |
| `/block/<hash>` | Block detail: height, difficulty, confirmations, size, bits, nonce, timestamp, transactions list |
| `/tx/<txid>` | Transaction detail: vin, vout, total, blockindex, blockhash, confirmations |
| `/address/<addr>` | Address detail: sent, received, balance, last transactions |
| `/qr/<addr>` | QR code generator for any address |

## Common workflows

### Check a payment you sent or received

1. Copy the txid from your wallet's history  
2. Visit `https://explorer.potcoin.com/tx/<txid>`  
3. Look at `vout` for the output amounts and recipient addresses  
4. `confirmations` ≥ 6 = safely settled for normal transfers.

### Look up an address balance

1. ### Web view

Visit `https://explorer.potcoin.com/address/<P-address>` for sent / received / balance / tx history.

2. ### One-line API call

```
   $ curl https://explorer.potcoin.com/ext/getbalance/<P-address>
   ```

3. ### Full activity dump

```
   $ curl https://explorer.potcoin.com/ext/getaddress/<P-address>
   {
     "address": "<P-address>",
     "sent": 0,
     "received": 0,
     "balance": 0,
     "last_txs": [...]
   }
   ```

### Pull live network stats

```
$ curl https://explorer.potcoin.com/api/getblockcount

$ curl https://explorer.potcoin.com/api/getdifficulty
{"proof-of-work":0.00139217,"proof-of-stake":88.67924329,"search-interval":1}

$ curl https://explorer.potcoin.com/api/getinfo | jq .
{
  "version": "v1.0.0",
  "protocolversion": 100001,
  "blocks": 696,
  "connections": 3,
  "difficulty": 88.67924329,
  "moneysupply": "420000000.00000000"
}
```

PotCoin is a transparent PoS chain — `getinfo` returns the standard Iquidus fields (version, blocks, connections, difficulty, moneysupply). No privacy flags; every transaction is visible on-chain.

## Full API endpoint reference

All endpoints return JSON unless noted. The explorer is Iquidus v1.7.4 — these match the upstream Iquidus API.

| Endpoint | Returns |
| --- | --- |
| `/api/getinfo` | Node state: version, blocks, connections, difficulty, moneysupply |
| `/api/getblockcount` | Current chain height (number) |
| `/api/getdifficulty` | PoW + PoS difficulty |
| `/api/getblockhash?index=N` | Block hash for height N |
| `/api/getblock?hash=X` | Full block JSON |
| `/api/getrawtransaction?txid=X&decrypt=1` | Decoded transaction |
| `/api/getaddress/<addr>` | Raw RPC address view |
| `/api/getbalance/<addr>` | Balance via RPC |
| `/api/gettx/<txid>` | Raw RPC transaction detail |
| `/ext/getmoneysupply` | Plain-text supply |
| `/ext/getdistribution` | Wealth distribution buckets |
| `/ext/getlasttxs/<count>` | Recent tx feed |
| `/ext/getaddresstx/<addr>` | Address transaction history |

**Pure-PoS note**`/api/getnetworkhashps` returns "Method not found" because pure-PoS chains have no hashrate after `LAST_POW_BLOCK = 500`.

## Build your own dashboard

Chain the endpoints above for a one-line health probe:

```
$ while true; do
    clear
    curl -s https://explorer.potcoin.com/api/getinfo | jq -r '"Height: \(.blocks) | Diff: \(.difficulty) | Peers: \(.connections) | Supply: \(.moneysupply)"'
    sleep 30
  done
```