chore: centralize protocol version metadata

Author: Zk-nd3r

CROSSLINK_INTEGRATION.md

@@ -10,7 +10,7 @@ Crosslink introduces proof-of-stake to Zcash. Validators lock ZEC as collateral,
 2. A validator withdraws stake
 3. A validator receives a reward
 
-ZAP1 already has event types for these: STAKING_DEPOSIT (0x0A), STAKING_WITHDRAW (0x0B), STAKING_REWARD (0x0C). They're reserved in the spec and implemented in the API as of v3.0.0-draft.
+ZAP1 already has event types for these: STAKING_DEPOSIT (0x0A), STAKING_WITHDRAW (0x0B), STAKING_REWARD (0x0C). They're reserved in the spec and implemented in the API as of v3.0.0.
 
 ## Event types
 

ONCHAIN_PROTOCOL.md

@@ -1,8 +1,8 @@
 # ONCHAIN_PROTOCOL.md
 
-**Specification Version: 3.0.0-draft**
+**Specification Version: 3.0.0**
 
-**Version:** 2.2.0  
+**Version:** 3.0.0  
 **Date:** 2026-03-28  
 **Status:** Deployed on Zcash mainnet
 
@@ -379,7 +379,7 @@ The credential profile depends on the proof profile and is not expected to deplo
 
 ## Changelog
 
-### 3.0.0-draft (2026-03-31)
+### 3.0.0 (2026-03-31)
 - Added type byte prefix to leaf hash construction (Section 3)
 - Renumbered sections 12-15 to fix gap from removed sections
 - Clarified domain separation constants

conformance/openapi.yaml

@@ -2,7 +2,7 @@ openapi: 3.0.3
 info:
   title: ZAP1 Attestation Protocol
   description: Read-only API for Zcash on-chain attestation discovery, verification, and memo classification.
-  version: "3.0.0-draft"
+  version: "3.0.0"
   license:
     name: MIT
     url: https://github.com/Frontier-Compute/zap1/blob/main/LICENSE
@@ -33,13 +33,13 @@ paths:
                     example: ZAP1
                   version:
                     type: string
-                    example: "2.2.0"
+                    example: "3.0.0"
                   event_types:
                     type: integer
-                    example: 12
+                    example: 18
                   deployed_types:
                     type: integer
-                    example: 9
+                    example: 15
                   reserved_types:
                     type: integer
                     example: 3

src/api.rs

@@ -64,6 +64,8 @@ pub struct AppState {
     pub foreman: Option<Arc<ForemanClient>>,
 }
 
+pub const PROTOCOL_VERSION: &str = "3.0.0";
+
 pub fn router(state: AppState) -> Router {
     Router::new()
         .route("/invoice", post(create_invoice))
@@ -998,7 +1000,7 @@ async fn recent_events(
 async fn protocol_info() -> Json<serde_json::Value> {
     Json(serde_json::json!({
         "protocol": "ZAP1",
-        "version": "3.0.0",
+        "version": PROTOCOL_VERSION,
         "event_types": 18,
         "deployed_types": 15,
         "reserved_types": 3,

tests/api_integration_test.rs

@@ -42,7 +42,7 @@ async fn protocol_info_returns_zap1() {
     let body = axum::body::to_bytes(resp.into_body(), 10000).await.unwrap();
     let json: serde_json::Value = serde_json::from_slice(&body).unwrap();
     assert_eq!(json["protocol"], "ZAP1");
-    assert_eq!(json["version"], "3.0.0");
+    assert_eq!(json["version"], zap1::api::PROTOCOL_VERSION);
     assert_eq!(json["deployed_types"], 15);
 }