docs: refresh Cloud verification guides - #49
Conversation
thisisjoshford
left a comment
There was a problem hiding this comment.
Tysm for the updates here @hanakannzashi ! Below is an agent review and agree we should resolve 1 & 2 ( having NVIDIA verification endpoint/example and including JS/Python snippets rather than just curl commands) - the rest are nice to haves IMO. I'm also working to update the verification example repo as mentioned in 3 but feel free to skip that part as we can do a follow-up PR.
-
The NVIDIA verification endpoint is gone. The old model page had the full
POST https://nras.attestation.nvidia.com/v3/attest/gpuexample with a sample EAT response. The new pages only say "verify with the applicable NVIDIA verification service" — a reader can no longer discover where to sendnvidia_payload. Suggest restoring the NRAS URL + minimal request/response example inreference/quote-nonce-signer.mdx(the "Verify GPU evidence" section is the natural home). -
All JS/Python examples were removed. The old pages had worked examples for attestation requests, request/response hashing (with a real fixture), and
ethers/eth_accountsignature recovery. The new pages are curl-only, and signature verification is prose ("recover the Ethereum EIP-191 signer") with no code. Since #44 asked for stale examples to be updated, dropping them entirely feels like the wrong direction — even one JS + one Python snippet per flow would do. -
Link to the verification example repo was dropped. The old model/chat pages pointed to
near-examples/nearai-cloud-verification-example(just updated for the current API, incl.signature_kindhandling); onlynearai-cloud-verifiersurvives, in one reference page. Please restore it alongside the verifier link — it's the easy on-ramp, the verifier is the complete implementation.
Non-blocking
-
signature_kindinference guidance now contradicts the API reference.cloud-api's OpenAPI text says legacy signatures "can still be distinguished structurally" (3 parts = model TEE, 2 = gateway);cloud-api/response-signatures.mdxsays "do not infer it from the shape oftext". The stricter stance is defensible, but the two sources should agree — worth a follow-up to align the API reference. -
cloud/verification/provenance.mdxis orphaned — not indocs.jsonnav and nothing links to it, and since the path didn't exist before there are no external inbound links either. Wire it in or drop it. -
Consider
docs.jsonredirectsinstead of stub pages for the oldchat/model/gateway/tlsURLs. The stubs work (hidden pages still resolve), but redirects would keep four near-empty pages out of search andllms.txt. -
The "why gateway signatures happen" explanation disappeared. The old chat page explained the gateway signs streamed responses because it rewrites chunks for usage accounting. Someone seeing
signature_kind: "gateway"on a streamed completion now has no "why" anywhere — one sentence incloud-api/response-signatures.mdxwould cover it.
Couldn't verify live (plausible, just noting): the error_code/message 200-unavailable signature shape, and the E2EE "unsupported rather than re-routed" behavior.
|
@hanakannzashi I think we can hold on the merge of this PR until https://github.com/nearai/verifiable-ai-sdk/pull/1 is merged and the verifiable-ai-sdk is released. We probably need to re-implement https://github.com/nearai/nearai-cloud-verifier after the verifiable-ai-sdk is published, and also update the NEAR AI docs accordingly. |
Summary
Validation
mint validatemint broken-linksCloses #44