agorix
AirdropMarketsCollectionsLeaderboardActivity
Agorix · Decentralized Marketplace
Independent · Resilient · Community-Run

A cross-chain marketplace, run by the community.

Discover, list, and trade across Bitcoin, Ethereum, and Solana on an open, community-run network.

Marketplace
CollectionsMarketsLeaderboardActivity
Network
GovernanceExplorerAirdropDocs
Account
ProfileSettings
Legal
Terms of ServicePrivacy PolicyYour Privacy Choices
agorix.io — Lasting Access
CID: 0xA60R1X · v0.1
AirdropMarketsCollections
D
Protocol Docs
Proof of AccessNetwork Fee RoutingRelease VerificationMPC Treasury SecurityPSBT SecurityNode AuthenticationRate LimitingBundle Integrity VerificationTransaction Session Reconciliation
Docs/Security & Verification/Rate Limiting
Security & Verification

Rate Limiting

Sliding window rate limiting with escalation, per-tier limits, gossip-propagated blocklists, and token bucket implementation for anti-abuse protection.

#Rate Limiting

The protocol implements a multi-tier rate limiting system that protects against abuse, DoS attacks, and resource exhaustion. Rate limits are enforced locally at each node and violations are propagated across the network via gossip.

#Sliding Window with Escalation

Rate limit violations trigger escalating cooldown periods:

Violation CountCooldown Duration
1st violation5 minutes
2nd violation15 minutes
3rd violation60 minutes
4th+ violation24 hours + gossip broadcast

After the 4th violation, the offending identity is broadcast to all nodes via a RATE_LIMIT_VIOLATION gossip event, causing network-wide blocking.

#Rate Limit Tiers

Limits are scoped by identity type and action:

Tier KeyScopePurpose
ip:agent_apiIP addressAgent API endpoint rate limiting
ip:checkoutIP addressCheckout flow rate limiting
session:*Session IDPer-session action limits
wallet:*Wallet addressPer-wallet transaction limits
global_floodEntire nodeGlobal request ceiling for flood protection

Each tier has independently configured request limits and time windows. The global_flood tier acts as a circuit breaker: if total inbound request volume exceeds the threshold, the node begins rejecting all non-authenticated requests.

#Token Bucket Implementation

The core rate limiter (in services/cache) uses a token bucket algorithm:

  • Each identity/tier combination maintains a bucket with a configured capacity and refill rate.
  • Each request consumes one token.
  • Tokens refill at a constant rate up to the bucket capacity.
  • When the bucket is empty, requests are rejected until tokens refill.

The token bucket provides smooth rate limiting without the sharp edges of fixed-window counters. Burst traffic is absorbed up to the bucket capacity, but sustained abuse is caught.

#Gossip-Propagated Blocklists

When a node detects a severe or repeated violation, it broadcasts a RATE_LIMIT_VIOLATION event via the gossip protocol:

text
Event: RATE_LIMIT_VIOLATION
Fields:
  - offenderType: "ip" | "session" | "wallet"
  - offenderIdentity: string (hashed for privacy)
  - tier: string
  - violationCount: number
  - reportingNodeId: string
  - timestamp: number
  - signature: Ed25519 signature of reporting node

Receiving nodes add the offender to their local blocklist. The blocklist entry includes the reporting node's signature so that false reports can be traced. A single node's report is sufficient to trigger a temporary block on receiving nodes, but permanent bans require reports from multiple independent nodes.

#Anti-Abuse Protections

  • IP rate limits prevent unauthenticated endpoint abuse from botnets.
  • Session limits prevent a single authenticated session from monopolizing resources.
  • Wallet limits prevent transaction spam from a single wallet address.
  • Global flood protection prevents any form of volumetric attack from overwhelming a node.
  • Escalating penalties ensure that persistent abusers face increasingly severe consequences.
  • Network propagation ensures that an abuser blocked by one node cannot simply target another.
PreviousNode AuthenticationNext Bundle Integrity Verification

On this page

  • Rate Limiting
  • Sliding Window with Escalation
  • Rate Limit Tiers
  • Token Bucket Implementation
  • Gossip-Propagated Blocklists
  • Anti-Abuse Protections