Research preview — APIs may change. GitHub
Location Proofs
A location proof is a location record that represents a location claim, coupled with location evidence supporting that claim. A location proof provides independently evaluable evidence that the claim corresponds to physical reality.A location proof is a verifiable digital artifact that represents a claim about the timing and position of some event, plus one or more pieces of corroborating evidence that would require technical manipulation, collusion, or fraud to forge.
Why Location Proofs Matter
Most location data today is self-reported. A device says “I’m at these coordinates” and the receiving system takes it on faith. This works until the stakes are high enough to justify forgery — and the cost of forging GPS coordinates is essentially zero. Location proofs change the economics. By requiring evidence from independent proof-of-location systems, they raise the cost of forgery. The goal is not absolute certainty (which we believe is not achievable for physical location), but making the cost of a convincing forgery exceed the value of the fraud.The Certainty Spectrum
Not all location proofs are equally strong. The level of assurance depends on the number, diversity, and quality of the evidence sources. To reason about the relative security of location proofs, we are developing a 5-level certainty spectrum:| Level | Description |
|---|---|
| L0 | No evidence — bare self-reported claim |
| L1 | One externally sourced piece of evidence (e.g. IP-based or single-sensor) |
| L2 | One substantive strategy or 2–3 lighter-weight independent sources |
| L3 | Multiple independent sources, at least one substantive |
| L4 | Diverse high-integrity signals with strong cryptographic backing and cross-correlation |
| L5 | Nation-state resistance — advanced cryptographic proofs with multiple cross-domain endorsements (research frontier) |
Design Principles
No one-size-fits-all. Different applications need different levels of assurance. A social check-in app has different requirements than a land title registry. Location proofs are designed to be composable so applications can choose the right level for their use case. Neutral framework. Astral provides the structure for collecting, composing, and evaluating location evidence — not opinions about which evidence sources to trust. Some applications will accept government-issued attestations as sufficient; others will give them no weight. The framework accommodates both without preference. Probabilistic, not deterministic. Location proofs produce credibility scores, not binary verdicts. The evidence either supports the claim strongly, weakly, or not at all — and applications decide what threshold they need. Compose for the use case. A single location stamp from one proof-of-location system coupled with a claim is a valid location proof. Multiple location stamps from independent systems are stronger. The architecture supports both without requiring a minimum. Information monotonicity. Adding valid, independent evidence to a location proof may raise or lower confidence in the underlying claim, but it should always increase certainty about that confidence. More evidence means a clearer picture, even if the picture is unfavorable. Verifiability throughout. Location stamps should be cryptographically signed, evidence bundles should maintain clear provenance, and evaluation functions should be identifiable. Every layer of the location proof should be independently checkable. Forgery cost principle. The cost of forging a location proof should exceed the economic value of the transaction it underpins. A $10 check-in reward needs less forgery resistance than a $10M land title transfer.The Location Proof Pipeline
Location proofs are built from a series of concepts that compose together:- Proof-of-location systems — The technical and social systems that produce location evidence
- Location stamps — Individual pieces of evidence from a single proof-of-location system
- Location claims — Assertions about where and when an event occurred
- Composing location proofs — Bundling location stamps with a location claim into a verifiable artifact
- Location proof evaluation — How Astral assesses the credibility of a location proof
Next: Proof-of-location systems
The technical and social systems that produce location evidence
See also:
- SDK: Location proofs — creating, signing, and verifying location proofs
- Plugins overview — the location proof plugin ecosystem