Expand description
Peer reputation system — R0..R4 tiers computed from QoS history.
§Tiers
| Tier | Name | Criteria |
|---|---|---|
| R0 | Quarantine | fault_score ≥ FAULT_BLACKLISTED; isolated from trusted peers |
| R1 | Fledgling | Node age < FLEDGLING_DAYS (7 days in the network) |
| R2 | Reliable | uptime_ratio ≥ 0.95 over 30 d; pos_pass_rate ≥ 0.98 |
| R3 | Trusted | uptime_ratio ≥ 0.99 over 90 d; pos_pass_rate ≥ 0.995 |
| R4 | Pillar | uptime_ratio ≥ 0.999 over 365 d; pos_pass_rate ≥ 0.999 |
§Reputation score
A continuous reputation_score: i64 underlies the tier computation.
Score changes:
| Event | Delta |
|---|---|
| PoS challenge passed | +PASS_INC |
| PoS challenge failed | −FAIL_DEC |
| 24 h verified uptime | +UPTIME_INC |
bp pause --eta respected | 0 |
bp pause --eta overrun | −LATE_PENALTY |
| Eviction without notice | score reset→0, R0 lock for 30 days |
§Placement preference
When selecting Pouch peers for fragment distribution (PutFile), the
scheduler prefers peers whose reputation tier is ≥ the sender’s
own tier. R0 peers only receive fragments from other R0 senders.
Structs§
- Reputation
Record - Per-peer reputation state persisted for the daemon’s lifetime.
- Reputation
Store - In-memory registry of per-peer
ReputationRecords.
Enums§
- Reputation
Tier - Discrete reputation tier for a Pouch peer.
Constants§
- FAIL_
DEC - Score decrement per failed PoS challenge.
- FLEDGLING_
DAYS - Days since first-seen after which a node graduates from Fledgling (R1).
- LATE_
PENALTY - Penalty for overrunning a
bp pause --etadeadline. - PASS_
INC - Score increment per passed PoS challenge.
- R2_
POS_ RATE - Minimum PoS pass rate required for R2.
- R2_
UPTIME - Minimum uptime ratio (0–1) required for R2.
- R2_
WINDOW_ DAYS - Observation window for R2 criteria (days).
- R3_
POS_ RATE - Minimum PoS pass rate required for R3.
- R3_
UPTIME - Minimum uptime ratio required for R3.
- R3_
WINDOW_ DAYS - Observation window for R3 criteria (days).
- R4_
POS_ RATE - Minimum PoS pass rate required for R4.
- R4_
UPTIME - Minimum uptime ratio required for R4.
- R4_
WINDOW_ DAYS - Observation window for R4 criteria (days).
- UPTIME_
INC - Score increment per 24 h of verified uptime.