Open
Conversation
- Add rotating 3D ASCII globe to introduction page hero - Globe uses golden spiral distribution for even particle placement - Mouse interaction causes particles to shatter/repel away - Particles smoothly spring back to reform the globe - Uses gold color scheme matching site branding (#D4A63A) - Supports touch devices and responsive resizing https://claude.ai/code/session_01AdzuF7QtsgEpGwi3ju16Wv
New concept pages for location proofs and the plugin architecture. New guides for creating proofs, ProofMode, WitnessChain, and writing custom plugins. Updated existing pages to reference the plugin system instead of "in development" placeholders. Added Verify API endpoints to the API reference. New pages: - concepts/location-proofs.mdx - concepts/plugins.mdx - guides/creating-location-proofs.mdx - guides/proofmode-integration.mdx - guides/witnesschain-integration.mdx - guides/writing-plugins.mdx Updated pages: - introduction.mdx, how-it-works.mdx, sdk/overview.mdx - concepts/verifiable-computation.mdx - guides/location-gated-nft.mdx - api-reference/overview.mdx - mint.json (navigation)
johnx25bd
commented
Feb 12, 2026
api-reference/overview.mdx
Outdated
| --- | ||
| title: "API Overview" | ||
| description: "REST APIs for geospatial operations and location records" | ||
| description: "REST APIs for geospatial operations, location verification, and location records" |
Member
Author
There was a problem hiding this comment.
probalby should emphasize verifiable
johnx25bd
commented
Feb 12, 2026
| | API | Purpose | Base URL | | ||
| |-----|---------|----------| | ||
| | **Compute API** | Verifiable geospatial operations | `/compute/v0` | | ||
| | **Verify API** | Location proof verification | `/verify/v0` | |
Member
Author
There was a problem hiding this comment.
reorder, verify shoudl be first, then compute, then records
johnx25bd
commented
Feb 12, 2026
api-reference/overview.mdx
Outdated
| |-----|---------|----------| | ||
| | **Compute API** | Verifiable geospatial operations | `/compute/v0` | | ||
| | **Verify API** | Location proof verification | `/verify/v0` | | ||
| | **Records API** | Query location attestations | `/api/v0` | |
Member
Author
There was a problem hiding this comment.
can we make this records/v0, but silently keep api/v0 working under the hood? (api is too catch-all and is confusing)
johnx25bd
commented
Feb 12, 2026
| | **Records API** | Query location attestations | `/api/v0` | | ||
|
|
||
| <CardGroup cols={2}> | ||
| <CardGroup cols={3}> |
Member
Author
There was a problem hiding this comment.
again reorder Verify Compute Records
johnx25bd
commented
Feb 12, 2026
api-reference/overview.mdx
Outdated
| Stamp verification and proof credibility assessment | ||
| </Card> | ||
| <Card title="Records API" icon="database" href="/api-reference/records/overview"> | ||
| Query existing location attestations across chains |
Member
Author
There was a problem hiding this comment.
'location records across systems'
johnx25bd
commented
Feb 12, 2026
api-reference/overview.mdx
Outdated
| Distance, containment, proximity checks with signed attestations | ||
| </Card> | ||
| <Card title="Verify API" icon="shield-check" href="#verify-api"> | ||
| Stamp verification and proof credibility assessment |
Member
Author
There was a problem hiding this comment.
this is jargony, can it be clearer while still being concise and elegant
Update documentation to match actual SDK implementation from PR #54. The docs were written before final SDK design was settled and contained several inaccuracies. Key changes: - Remove evaluate() from plugin interface (SDK-side evaluation) - Replace scalar confidence scores with multidimensional CredibilityVector - Remove caps (0.85) and bonuses - applications define trust models - Fix API calls: astral.verify.* → astral.stamps.verify() / astral.proofs.verify() - Update CredibilityVector structure (spatial, temporal, validity, independence) - Fix hosted verification options syntax Files updated: - guides/creating-location-proofs.mdx - concepts/location-proofs.mdx - concepts/plugins.mdx - guides/writing-plugins.mdx - guides/witnesschain-integration.mdx - guides/proofmode-integration.mdx - sdk/overview.mdx - api-reference/overview.mdx - introduction.mdx Verified against astral-sdk PR #54 implementation.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documents the location proof plugin system — concepts, guides, and API reference.
New pages (6):
concepts/location-proofs.mdx— evidence-based verification, terminology, pipeline, credibility scoringconcepts/plugins.mdx— plugin interface, registry, runtime model, stamp lifecycleguides/creating-location-proofs.mdx— E2E tutorial with mock pluginguides/proofmode-integration.mdx— proof bundle parsing, PGP verification, signalsguides/witnesschain-integration.mdx— historical proofs, ECDSA verification, scoringguides/writing-plugins.mdx— complete guide to implementingLocationProofPluginUpdated pages (7):
introduction.mdx— verification callout, SDK section shows stamps/proofs/verifysdk/overview.mdx— v0.3.0, plugin/stamps/proofs/verify in architecturehow-it-works.mdx— updated location verification referencesconcepts/verifiable-computation.mdx— links to plugin system (3 locations)guides/location-gated-nft.mdx— location verification linksapi-reference/overview.mdx— Verify API endpoints (stamp, proof, plugins)mint.json— navigation updatedTest plan
mintlify devrenders all new pages without errorsCloses: #21, #23