HYAKUME SWARM

# Introduction

Hyakume Swarm is a runtime for deploying networks of autonomous sentinel agents that monitor on-chain activity 24/7. Each agent — an "eye" — watches one threat vector. Together they form a swarm with no blind spots.

The name comes from the Hyakume (百目), a yokai covered in a hundred eyes that guards temples from thieves at night. When an intruder nears, it detaches an eye to follow and watch them. Hyakume Swarm works the same way: point it at what you want protected, and it never looks away.

# Installation

The runtime ships as a TypeScript package. Install hyakume and configure the chains you want to watch.

# sentinel swarm runtime
npm install hyakume

# Quickstart

Open a single eye on a token and start receiving alerts on Telegram. The watcher runs continuously and fires the moment a threat pattern trips.

import { Watcher } from "hyakume";

const eye = new Watcher({
  network: "solana",
  target: "<TOKEN_MINT_ADDRESS>",
  watch: ["liquidity", "mintAuthority", "approvals"],
  alert: { telegram: process.env.TG_CHAT_ID }
});

await eye.open(); // the eye is now watching, 24/7

# The Watcher

A Watcher is a single eye: one target, one set of threat vectors, one alert channel. It polls on-chain state and fires when a pattern it knows trips.

• eye.open() — start watching. Runs until closed.
• eye.close() — detach the eye and stop.
• eye.status() — current state and last signals seen.

# The Swarm

A Swarm coordinates many watchers across many targets and votes on ambiguous signals — so a single noisy data point doesn't trigger a false alarm. The hive only screams when enough eyes agree.

import { Swarm } from "hyakume";

const swarm = new Swarm({
  network: "solana",
  targets: ["<MINT_A>", "<MINT_B>", "<WALLET>"],
  watch: ["liquidity", "approvals", "authority", "whales"],
  consensus: 3,             // eyes that must agree to alert
  alert: { telegram: process.env.TG_CHAT_ID, discord: process.env.WEBHOOK }
});

await swarm.watch();
swarm.on("threat", (t) => console.log(t.reason, t.severity));        

# Alerts

Alerts are delivered the instant a threat is confirmed. Every alert explains why it fired, not just that something happened, so you can act with confidence.

# Configuration

Configure via the constructor or a hyakume.config.json at your project root.

# FAQ

Does Hyakume Swarm move my funds or trade for me?

No. It only watches and warns. It never signs transactions or controls a wallet. It's a sentinel, not an agent that acts.

What can it watch?

Token mints, LP positions, individual wallets, and contract authorities — for rug signals, suspicious approvals, authority changes, and large insider moves.

Which chains are supported?

Solana at launch, with EVM chains (Base, Ethereum, Arbitrum) on the roadmap.

How fast are alerts?

Sub-second from detection to delivery on the default scan interval. Higher tiers scan more frequently.