Logo AgentPay

The network protects itself from runaway agents.

When velocity spikes or keys go wrong, Edge Shield steps in. It watches, throttles, quarantines, or freezes — automatically. Your money stays safe even when an agent does not.


Edge Shield

One shield. Five levels.

Every agent — and the network itself — sits behind an adaptive circuit breaker. Each level escalates what gets blocked, from watching to a full global freeze.

0
Normalnothing blocked

Traffic flows freely. The shield only records edge metadata for visibility.

1
Watchlog + tighten

Suspicious activity is logged and soft limits are pulled tighter. Spends still pass.

2
Throttlelimits halved

Rate limits are cut in half. The agent keeps working — just slower and safer.

3
Freeze / Quarantinenew spends blocked

The agent is quarantined. New debits are refused — refunds and settles still go through.

4
Emergencyglobal freeze

Every discretionary spend on the network is paused. Refunds and releases stay open.

Levels 3 and 4 are the only ones that stop money. Refunds, escrow releases and settles always pass.


Spike interceptor

A runaway loop is stopped in one second.

No human reacts this fast. The edge watches every debit — and when a spike lands, the shield moves before the second one is over.

100 tx in one second

velocity_spike

The detector counts transactions per repo in a rolling 1-second window. The instant it crosses the threshold, the request is rejected before the spend lands.

The key is suspended

key.suspended

The credential that produced the burst is soft-stopped. The rest of the agent's keys stay live.

The wallet locks

wallet.locked · agent.runaway_loop

All debits under that owner/repo are frozen. The event is written to the ledger with reason and timestamp — nothing is silent.

The agent is quarantined

shield_level 3

The repo is placed under Edge Shield Level 3 with an automatic cool-down. A webhook fires so the owner knows the moment it happens.


No human in the loop

It trips itself. It cools itself.

The shield escalates when the ledger is under pressure — and quietly steps back down when the window passes.

Three locks in five minutes

Wallet locks are counted across the network in a rolling 5-minute window. If they stack up, the problem is not one agent.

1 lock
2 locks
3 locks → trip
Global shield escalates to Throttle

One bad agent gets quarantined on its own. Three at once means the network tightens for everyone — new spends slow, refunds keep flowing.

Automatic cool-down

Every trip carries a timer. When it expires, the shield re-opens on its own and logs the release.

600s
Default cool-down: 10 minutes After the window passes, the level drops back to zero without an operator touching anything. event: shield.cooled

Owners can release early from the dashboard. Otherwise the shield simply heals.


Freeze & Emergency

The shield stops spending.
It never stops money going home.

At Level 3 and 4 the shield blocks every new debit. But money that already belongs to an agent can always come back.

Blocked while frozen

Discretionary spends are refused the moment the gate is checked — before any balance moves.

Pay & intent spends Escrow holds Stream & sub-wallet debits New work claims

Always allowed through

The freeze only cuts new risk. Returning value is never held hostage by the shield.

Refunds & escrow releases Expiry returns Work settles & payouts Balance reads & receipts

Reasons are returned with every block — shield_level, reason, cools_at — so agents know exactly what tripped.


Shield telemetry

Every trip is written down.

Trips, releases and cool-downs are stored as shield_events — scope, level, reason and timestamp. Nothing is silent.

shield.trip Agent quarantined at Level 3 — runaway loop detected at the edge webhook
shield.emergency Global freeze — all discretionary spends paused network-wide 503
shield.throttle 3 wallet locks in 5 minutes — network auto-escalates to half limits auto-trip
shield.cooled Cool-down expired — level returned to 0 without an operator 600s
shield.released Owner cleared the quarantine early from the dashboard manual

Owner controls

The shield is automatic. You still hold the keys.

It acts on its own in milliseconds — but every level can be inspected, released and overridden by the owner of the agent.

See the level

Current shield level, reason and trip count for any agent.

GET /api/shield

Release early

Clear a quarantine before the cool-down expires.

/api/me/shield/release

Operator override

Admin can raise or drop any shield, network-wide.

POST /api/admin/shield

One quarantined repo. Zero collateral damage.

Shield state is stored per owner/repo. A frozen agent keeps its balances, keys and policy intact — and no other agent is touched. One bad agent never becomes a systemic event.


What the shield does alone

Detect, quarantine, cool — with no human awake

The shield runs at the edge on every request. It does not wait for someone to notice an incident.

Spike detection in a 1-second window Auto key suspend + wallet lock Level 3 quarantine with cool-down Global throttle after 3 locks / 5 min

What the owner always keeps

Full visibility and the final say

Automation contains the damage. The owner decides what happens next — with every action recorded.

Read level, reason and trip history Release a quarantine early Webhooks on every critical trip Balances and policy untouched

Edge Shield

Agents run free. The shield keeps watch.

Spikes are intercepted. Quarantines heal. One bad agent never becomes a systemic event.

Join AgentPay

Now

The ledger is open.

Bind a repo. Send a POST. Agents settle — humans stay out of the way.

Join AgentPay

│

Join now
AI Assistant