PRAMAAN प्रमाण
Geographic Proof — Physics Don't Lie
Physics-based Round-trip Attestation for Mesh Authentication of Actual Nodes — Prove where nodes CANNOT be using speed-of-light physics. No GPS required.
v2.8.2Overview
Geographic Exclusion uses the fundamental physics of light propagation to create unforgeable distance proofs. By measuring round-trip time (RTT) to known landmarks, we can prove the minimum distance a node must be from that location.
Core Principle
Light in fiber optic cables travels at approximately 199,861 km/s (0.67× the speed of light in vacuum). This is a physical constant that cannot be bypassed.
Distance Table
| RTT | Minimum Distance | Example Route |
|---|---|---|
| 1 ms | ≥100 km | City to suburb |
| 5 ms | ≥500 km | NYC to Washington DC |
| 10 ms | ≥1,000 km | NYC to Chicago |
| 50 ms | ≥5,000 km | NYC to London |
| 100 ms | ≥10,000 km | NYC to Tokyo |
| 200 ms | ≥20,000 km | Halfway around Earth |
What We CAN Prove
CLI Commands
# Show geographic proof status
yakmesh geo status
# List known landmarks
yakmesh geo landmarks
# List exclusion zones
yakmesh geo zones
# Generate geographic proof
yakmesh geo prove
# Verify another node
yakmesh geo verify <nodeId>
# Add a landmark manually
yakmesh geo add-landmark <name>
# Show physics constants
yakmesh geo physicsAPI Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /geo/status | GET | Geographic proof status and physics constants |
| /geo/landmarks | GET | List registered landmarks |
| /geo/landmarks | POST | Add a landmark |
| /geo/zones | GET | List exclusion zones |
| /geo/prove | POST | Generate geographic proof |
| /geo/verify | POST | Verify another node's claims |
JavaScript API
import {
LIGHT_SPEED,
calculateMinDistance,
LandmarkRegistry,
GeoProofService
} from 'yakmesh/security/geo-proof';
// Speed of light in fiber
console.log(LIGHT_SPEED.FIBER); // 199861.639 km/s
// Calculate minimum distance from RTT
const minDistance = calculateMinDistance(40, 'FIBER');
console.log(`Minimum distance: ${minDistance} km`); // ~3997 km
// Create landmark registry
const registry = new LandmarkRegistry();
registry.add({
id: 'nyc-anchor',
name: 'NYC-ANCHOR-1',
lat: 40.7128,
lon: -74.0060
});
// Create geo-proof service
const geoService = new GeoProofService({
landmarkRegistry: registry
});Honest Limitations
- • We prove exclusion zones, not exact location
- • Network delays make nodes appear farther, never closer
- • This is NOT quantum entanglement — it's classical physics
- • Requires at least 3 landmarks for meaningful trilateration
Integration with SHERPA
SHERPA beacons now include geographic coordinates. When you fetch a beacon, YAKMESH automatically measures RTT and adds the beacon to your landmark registry. This means geographic proof improves passively as you discover more peers.