Foreshock

Product · Tour

See what it returns.

A walk through the answers the running product gives, in the order a deposit meets them: the screening verdict, the statement of what can be seen right now, the record of your own addresses, and the evidence each answer points to. The fields are the ones the product returns. Every value is synthetic.

Values
Synthetic
Times
UTC
Amounts
Exact, never rounded

01Screening a deposit address

Before crediting, you send the addresses involved. Each comes back with one of three verdicts, the evidence behind it, and the health of the collector that would have seen a freeze against it.

Request · two addresses Example · not real data
ChainAddress
tron TXXXXXXXXXXXXXXXXXXXXXXXXMERCHANT1
tron TXXXXXXXXXXXXXXXXXXXXXXXXMERCHANT2
Response · one result per address Example · not real data
TXXXXXXXXXXXXXXXXXXXXXXXXMERCHANT1 CLEAR
Chain
tron
Matches
none

Collector health

Authority
authority-EXAMPLE-0001
Status
OK
Last verified
2026-09-11 06:24:00 UTC
Collector lag
3s
TXXXXXXXXXXXXXXXXXXXXXXXXMERCHANT2 FROZEN
Chain
tron
Matches
1
Authority
authority-EXAMPLE-0001
Action
FREEZE
Stage
EXECUTED
Executed
2026-09-10 01:12:44 UTC
Block
61201004
Transaction
0000000000000000000000000000000000000000000000000000000000000031
Evidence snapshot
cas:sha256:0000000000000000000000000000000000000000000000000000000000000031

Collector health

Authority
authority-EXAMPLE-0001
Status
OK
Last verified
2026-09-11 06:24:00 UTC
Collector lag
3s

The second address has an outstanding freeze on record. The match carries when it executed, the block, the transaction, and the hash of the stored response it was read from. The first address is clear, and the collector that would have seen a freeze against it is reporting and current.

What each verdict does to the deposit

  • FROZEN An outstanding freeze is on record against the address. The deposit is not credited; the match and its snapshot are where review starts.
  • CLEAR Nothing outstanding, and every collector for that chain is inside its freshness threshold. Both halves are required. It is the only verdict from this check that does not stop the deposit.
  • UNKNOWN HOLD Anything else: a collector that is stale or blind, or a signal that cannot be interpreted. Treated as HOLD.

02Coverage health

Every response states what the system could see at the moment it answered. That is the difference between "no alert" and "we cannot see", two situations that look identical in a product that does not say which one you are in.

Coverage · per authority in scope for an account Example · not real data
As of
2026-09-11 06:24:05 UTC
Authority Observable Last verified Collector lag
authority-EXAMPLE-0001 yes 2026-09-11 06:24:00 UTC 3s
authority-EXAMPLE-0002 no 2026-09-11 05:02:11 UTC 1h 21m

The second authority is not observable right now, and its last verification is well behind the first. A deposit in its scope is held until that changes.

Coverage · per capability, attached to an address reading Example · not real data
Capability Status Since Last verified Collector lag
transfer STALE 2026-09-11 06:11:48 UTC 2026-09-11 06:24:00 UTC 12m 22s
profile OK — 2026-09-11 06:24:00 UTC 3s
freeze OK — 2026-09-11 06:24:00 UTC 5s

The same statement travels with address readings, one line per capability. Here transfer collection is STALE and says since when; account and freeze collection are current.

Event · coverage status changed Example · not real data
Type
coverage.health_changed
Occurred
2026-09-11 06:26:04 UTC
Capability
transfer
Previous status
OK
Status
STALE
Since
2026-09-11 06:11:48 UTC
Collector lag
12m 22s

A change of status is delivered as its own event, so a client learns of a blind spot without polling for it.

The statuses

OK
The collector is reporting and inside its freshness threshold.
STALE
The collector's data is older than its threshold. A property of the collector, never of a signal, and never an all-clear: it is a known blind spot.
BLIND
An authority is registered, and no collector is reporting for it at all.
Since
When the current status began. An interruption notice that cannot say since when gets ignored, so the time is part of the answer.

03Monitoring your own addresses

The addresses you hold are watched continuously. Five readings come back for each: the account as it stands, its transfers, each day of its ledger, roll-ups across addresses and periods, and how much of its history is proven loaded.

The account as it stands

Address · account Example · not real data
Address
TXXXXXXXXXXXXXXXXXXXXXXXXMERCHANT1
Observed
2026-09-11 06:23:51 UTC
Account type
EOA
Activated
yes
Created
2025-11-02 00:15:30 UTC
Last active
2026-09-11 06:21:12 UTC

Balances

AssetAmount
TRX 3,120.45
TRC20-EXAMPLE1 18,250
TRC20-EXAMPLE2 unavailable

A balance that could not be read is marked unavailable. It is never shown as zero.

Transfers

Address · transfers, newest first Example · not real data
Time Direction Asset Amount Finality Balance after Transaction Evidence snapshot
2026-09-11 06:21:12 UTC in TRC20-EXAMPLE1 125 provisional 18,250 0000…0041 cas:sha256:0000…0041
2026-09-11 05:58:03 UTC out TRC20-EXAMPLE1 40 final 18,125 0000…0040 cas:sha256:0000…0040
2026-09-11 03:02:40 UTC in TRX 260 final unavailable 0000…0039 cas:sha256:0000…0039
2026-09-10 11:44:21 UTC in TRC20-EXAMPLE1 9 reverted — 0000…0038 cas:sha256:0000…0038

Each transfer is published the moment it is seen and then followed to finality. The states:

provisional
Seen at one confirmation and published at once. It may still change, so it is never presented as settled.
final
Past the chain's finality threshold, and no longer expected to change.
reverted
Removed by a chain reorganisation. The record is kept and announced as its own event. It is never silently deleted, because a client that only saw a deletion would never learn of it.

One day of the ledger

Address · ledger for one day Example · not real data
Address
TXXXXXXXXXXXXXXXXXXXXXXXXMERCHANT1
Day
2026-09-11
Time zone
Asia/Shanghai
Complete
yes
History complete back to
2026-06-13
Asset Everything seen Final only
In Out Net In Out Net
TRC20-EXAMPLE1 486 (9)140 (3)346 361 (8)140 (3)221
TRX 260 (1)0 (0)260 260 (1)0 (0)260

transfers in parentheses

"Everything seen" includes transfers that are still provisional; "final only" counts those past finality. Near the head of the chain the two differ, and the difference is not an error. A total that has to be right is read from the ledger, never added up from alerts.

Address · a day while history is still loading Example · not real data
Address
TXXXXXXXXXXXXXXXXXXXXXXXXMERCHANT2
Day
2026-09-11
Complete
no
History loading
yes
History complete back to
2026-09-04

Until history is loaded, the day is marked incomplete. It is never shown as a settled total.

Roll-ups

Roll-up · month to date, three addresses, one asset Example · not real data
Range
2026-09-01 → 2026-09-11
Time zone
Asia/Shanghai
Asset
TRC20-EXAMPLE1
Address Net, everything seen Net, final only State
TXXXXXXXXXXXXXXXXXXXXXXXXMERCHANT1 2,255 2,130 complete
TXXXXXXXXXXXXXXXXXXXXXXXXMERCHANT2 210 210 still loading
0xdddd000000000000000000000000000000000001 — — not watched; not in the total NOT_WATCHED
Total 2,465 2,340

Each address carries its own completeness. An address that cannot be included is listed with the reason, not dropped from the total without a word. Net is arithmetic on one asset: different assets are never added together, and no price is applied. The same figures are available by day, week or month for a single address.

How much history is proven

History · per asset, two watched addresses Example · not real data
Your label Asset State History complete back to
shop-01 ASSET-EXAMPLE1 complete 2026-06-13
shop-02 ASSET-EXAMPLE1 still loading 2026-09-04
shop-02 ASSET-EXAMPLE2 one source only; never reported complete —

Completeness is stated per asset, not per address. Where an asset's past can be read from only one independent source, there is nothing to check it against, so its history is never reported as complete. It stays marked as not proven rather than becoming "complete" because nothing contradicted it. Asset identifiers in this panel are generic placeholders.

04Evidence

The external responses a verdict or a ledger line rests on are stored once, under the hash of their content. Records point to that hash rather than restating what it says.

References · from the panels above Example · not real data
RecordEvidence snapshot
Screening match · FREEZE · authority-EXAMPLE-0001 cas:sha256:0000000000000000000000000000000000000000000000000000000000000031
Transfer · tr_EXAMPLE0000000000041 cas:sha256:0000000000000000000000000000000000000000000000000000000000000041
Transfer · tr_EXAMPLE0000000000040 cas:sha256:0000000000000000000000000000000000000000000000000000000000000040
  1. 01 The hash is computed over the stored response, byte for byte as it was received.
  2. 02 Storage is append-only. A stored response cannot be rewritten, including by us.
  3. 03 Given the bytes, anyone can recompute the hash and compare. If it matches, the record points at exactly what it says it points at.

How evidence is kept and exported

Where to go next

The product pages explain each readout and its limits. The API reference is the contract these panels follow.

Questions about any panel on this page: hello@4shock.xyz