Components and responsibilitiesLink to this section

TL;DRLink to this section

Separate components count work, check records, settle on Ethereum, fund rewards, and display results.
Video and public displays are separate from the records that establish work and rewards.
Missing data stays unavailable; another component must not replace it with zero or a guess.

From the wheel to your screenLink to this section

The sensor detects wheel-magnet passages, and the device saves those that pass its counting rules. Hosted services check the saved records and submit eligible work to Ethereum. The website brings together measurement data, chain records, and independent video, but those sources don't all update at the same time.

Each component below has one part of that job. Displaying a record doesn't give the website or a data service permission to change it.

System mapLink to this section

Work and rewardsLink to this section

Signed records go from the Hamster Miner to the Oracle. The Reporter authorizes checked work, and the Relayer submits it to Core on Ethereum.

Hamster Miner --> Oracle --> Reporter --> Relayer --> Core
                                                        |
                          +------- settled work --------+
                          v
     NFT --ownership--> Mining <--funded SQK-- Token
                          |
                     claim payout
                          v
                     Owner wallet

Core, Mining, Token, and the NFT collection are on Ethereum. Mining reads settled work and NFT ownership, requests SQK from Token, and holds it until owners claim. The arrows show the records and funds each component uses, not automatic callbacks.

Public data and videoLink to this section

The website displays verified measurements and confirmed chain data through the public API. Video arrives through a separate playback path.

Oracle --verified records--------------------+
                                             |
                                             v
Ethereum --> Indexer --confirmed data--> Public API --> Website
                                                           ^
                                                           |
Cameras --> Playback --------------------------------------+

Neither the display path nor the video path can change accepted work or rewards.

Technical detail: component responsibilitiesLink to this section

The table separates who stores a record, who can authorize a change, and who only displays it.

Component	Responsibility	Authority or limit
Wheel and Hall sensor	Produce magnetic readings	Cannot prove identity or direction
Pico bridge	Send raw readings with their order and timing	Cannot count accepted work or sign records
Pi measurement service	Count accepted passages, assign them to rounds, and sign records	Applies the measurement rules
Pi SQLite	Save accepted work, completed rounds, and records awaiting delivery	Stores the original measurement history
Oracle and its database	Check signed records, approve eligible rounds, and track settlement	Cannot invent or repair measured work
Reporter signer	Sign permission to settle exact work batches	Cannot change the Pi's round records
Gas relayer	Submit signed transactions and pay gas	Cannot authorize settlement
`Core` on Ethereum	Record rounds, work, and completed Squeek blocks	Does not mint tokens or calculate rewards
`Mining`	Calculate rewards, hold funded SQK, and pay claims	Has its own rules and upgrade permissions
`Token`	Limit minting to `Mining` and enforce the lifetime supply cap	Does not check physical work
Miner NFT collection	Record ownership and NFT properties	Ownership gives no device control
Indexer	Build chain views after enough confirmations	Cannot sign telemetry or settlements
Public API	Check and serve public data	Cannot replace measurements or chain records
Public web interface	Display data and help owners submit wallet actions	Browser estimates are not settled facts
Cameras and playback	Show the Hamster Miner	Cannot affect accepted work or rewards

The API reads measurement and pending work from the Oracle, and confirmed chain data from the indexer. Presenting them together does not make them the same stage.

Mining uses settled Core history through the separate reward funding and claim path. Core itself does not mint SQK.

Video does not affect work acceptance, settlement, or rewards. Public playback information allows viewing, not camera control or access to measurement credentials.

Rules and boundariesLink to this section

The Pi sends signed records to the Oracle; they do not share database write access.
Oracle API and settlement services have different permissions. Neither can change the database schema.
The Pi and public API do not hold settlement private keys.
The indexer reads one configured deployment and waits for confirmations.
Display outages do not stop otherwise healthy measurement, telemetry delivery, or settlement.
A compromised measurement host can supply false records. Signatures do not remove trust in the host and its operators.
Token enforces a cap and restricts minting to Mining, but does not check Mining's reward rules. Mining code and its upgrade administrators remain trusted.

ExampleLink to this section

Illustrative outage: the indexer stops answering while the Pi, Oracle, and Reporter remain healthy. Public chain data becomes unavailable, but measurement delivery and settlement continue.

After recovery, the indexer rebuilds its view from chain events. It does not create work or execute missing settlements.

Records verified work and tracks settled rounds and Squeek blocks on Ethereum. Calculates rewards from settled work, holds funded SQK, and pays eligible NFT owners. The Miner ERC-721 contract. Tracks NFT ownership and coordinates minting and merges with Mining. Applies Core or Mining upgrades authorized by its governing Timelock. Generates Miner NFT artwork from fixed onchain visual data. Queues governance operations and enforces a delay before they can be executed. The SQK ERC-20 contract. Enforces the lifetime supply cap; only Mining can mint SQK. Checks that visual data conforms to the required DotGrid format. When new mining power starts earning. Minting and merging schedule it for a later round, and a checkpoint must process the change. A reward update that processes settled work and scheduled mining-power changes. It can make rewards available but doesn't pay them to an owner's wallet. The Miner NFT permanently burned in a merge. Its unclaimed rewards move to the survivor, but its image is not combined or kept. SQK issued under the mining reward rules. You can direct a share of your Miner's rewards to fund SqueekFi projects. The physical mining device that records accepted wheel-magnet passages as work. It is separate from the virtual Miner NFTs. Squeekchain's record of accepted wheel-magnet passages. It doesn't prove animal identity and isn't how Ethereum reaches consensus. Combining two eligible same-level Miners you own into one higher-level Miner. One NFT is permanently burned; the survivor keeps both Miners' unclaimed rewards. The completed Squeek blocks a Miner must wait through before merging. It measures completed work, not elapsed time or Ethereum blocks; transfers don't reset it. The power used to calculate a Miner's share of rewards when eligible and active. A larger share of total power can mean a larger share of rewards. A ten-minute period used to group measured work. The device saves a completed round's work total when measurement remained uninterrupted. The transferable token used for mining rewards. It has a lifetime supply cap and is separate from the Miner NFT and the device's work count. A completed amount of settled work. Enough recorded work completes one Squeek block; it is not an Ethereum block. Squeek Miner NFTs earn SQK linked to recorded wheel activity. Owners can direct a share of those rewards to fund SqueekFi projects. Squeekchain's ecosystem for hamster-powered onchain finance. Miner owners can choose to fund projects with a share of their SQK rewards. The Miner NFT you keep in a merge. It gains a level, keeps its ID and image, and receives both Miners' unclaimed rewards. A Miner's recorded reward balance that hasn't been paid to a wallet. It stays with the NFT when ownership changes. One wheel-magnet passage that met the device's counting rules and was saved. It records work, not an amount of SQK.