docs(reference): sync DAPI endpoint and query reference to v4.0 testnet

[thephez]

Summary

Brings the DAPI endpoint reference and query-syntax docs in line with the v4.0 proto, now live on testnet. Covers an audit-driven cleanup of stale/incorrect endpoint entries, two newly documented endpoints, real testnet examples for the shielded endpoints, and corrections to the query orderBy/range rules.

DAPI endpoint reference

Removed the four orphaned nullifier-changes endpoints (getNullifiersTrunkState, getNullifiersBranchState, getRecentNullifierChanges, getRecentCompactedNullifierChanges) from the detail and overview pages, matching their removal from the proto.

Documented two endpoints that existed in the proto but were missing from the docs:

• getShieldedNotesCount — with overview row and detail entry
• getDocumentHistory — with parameter table and a real testnet gRPCurl request/response

Corrected a set of parameter and behavior errors:

• getIdentityKeys: identity_td → identity_id, type String → Bytes, and limit/offset made optional and reworded from "revisions" to "keys"
• getIdentitiesContractKeys: contract_id type String → Bytes
• getDataContractHistory: start_at_ms/limit/offset marked optional
• getProtocolVersionUpgradeVoteStatus: start_pro_tx_hash type String → Bytes
• Protocol-version-upgrade endpoints: prove descriptions no longer reference "identity"
• getGroupActions: added the burn_from_id field and the update_price token event
• getTokenContractInfo: added tokenContractPosition to the response example
• getTokenPerpetualDistributionLastClaim: noted the last_claim oneof variants
• getEpochsInfo: removed a stray "id must be base64" comment
• getCurrentQuorumsInfo: removed the nonexistent version parameter and the proof claim
• subscribeToTransactionsWithProofs: fixed the orphaned asterisk / empty description on send_transaction_hashes

Shielded endpoints

Added gRPCurl request/response examples to all six shielded endpoints, captured from a live testnet seed node, and removed the admonition stating they were not yet available on public nodes (v4 now serves them on testnet).

Query syntax

Reworded the orderBy rule to describe sorting by a consecutive trailing run of an index's properties (the prior "last indexed property" wording wrongly denied valid multi-field orderBy). Added the required orderBy to the Range and in examples so they execute, reframed the "range only after ==/in" tip as an index-position rule that permits a standalone range, and noted that in is treated as a range.

Preview build: https://dash-docs-platform--155.org.readthedocs.build/en/155/

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 85e6f5ea-188d-41a9-89ee-c3e246a1a523

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}