# Eoniq Blockchain

> Eoniq Blockchain is automation for smart contracts on Robinhood Chain: watch contract events, schedule onchain tasks that any keeper can run when they are due, guard them with allowlists and approvals, and read every run and failure back from the chain. It is a brand name, not a separate blockchain.

## Pages
- https://eoniqblockchain.xyz/monitor: Event monitor
- https://eoniqblockchain.xyz/schedule: Scheduler
- https://eoniqblockchain.xyz/guard: Guard
- https://eoniqblockchain.xyz/history: History
- https://eoniqblockchain.xyz/developers: Developers
- https://eoniqblockchain.xyz/schedule/<id>: one task

## What each part does
- Watch a contract's events: Paste any Robinhood Chain contract and read its logs over the last 2,000, 10,000 or 50,000 blocks, decoded when the event is known or when you give its signature. Watched contracts refresh while the page is open.
- Schedule a call: Register one contract call with an interval, an optional view-call condition, a run limit and an ETH reward per run held in the forge. Any keeper can run it when it is due.
- Decide what may run: Calls leave from your own caller address, only to (contract, function) pairs on your allowlist, only with approvals where you asked for them, and a task halts after the failures you allow.
- Read every run back: Every run is an event: who ran it, whether the call succeeded, gas used, reward paid, and the revert reason in words when it failed.
- Plug it into your app: A read-only JSON API for tasks, runs and guards, an open keeper script you run with your own key, and the calldata helpers the site itself uses.

## Read-only JSON
- GET https://eoniqblockchain.xyz/api/v1/status
- GET https://eoniqblockchain.xyz/api/v1/tasks[?owner=0x…&status=…&due=1]
- GET https://eoniqblockchain.xyz/api/v1/tasks/<id>
- GET https://eoniqblockchain.xyz/api/v1/runs[?task=&owner=&keeper=&failed=1&limit=]
- GET https://eoniqblockchain.xyz/api/v1/guard?owner=0x…
- GET https://eoniqblockchain.xyz/api/monitor?address=0x…&blocks=2000|10000|50000[&topic0=0x…]

## Limits
- Eoniq Blockchain is a brand name. It is not a separate blockchain: everything runs on Robinhood Chain and gas is paid in ETH.
- EoniqTaskForge is not deployed yet. Until it is, the scheduler builds and checks tasks but cannot send them.
- The forge holds the ETH you escrow for rewards. It is new code with Foundry tests and a written self-review, and it needs an independent security review before real volumes. Start with small amounts.
- Nobody is paid to run your task except the reward you set. Eoniq runs no hosted keeper network today (planned): a task runs when some keeper finds it worth the gas.
- A task call never carries ETH: the forge sends value 0. Tasks cannot move the escrow anywhere except to the keeper as its reward.
- A keeper is paid for a run whether your call succeeds or reverts, because it paid the gas either way. Set a failure limit so a broken task halts.

## Planned
- Hosted keeper network (Eoniq-run keepers with a public schedule)
- Push alerts for watched contracts (today: in the page, while it is open)
- Write API with API keys (today: read-only API + your own wallet or keeper)
- $EONIQ for keeper fees and API quotas, once those services exist

Network: Robinhood Chain (chain id 4663, gas ETH).