> For the complete documentation index, see [llms.txt](https://gotts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gotts.gitbook.io/docs/gotts-vaults/vault/15-metrics.md).

# Success Metrics

> **Part of**: [Vault PRD](/docs/gotts-vaults/vault.md) | **Last Updated**: 2026-02-13

***

## Success Metrics (Core-First)

This metrics framework is split into:

* **Core launch gates (blocking):** must pass for v1 launch readiness
* **Core operating KPIs (first 90 days):** measure real adoption and reliability
* **Deferred KPIs (non-blocking):** tracked for post-v1 CCA/growth expansion only

***

## A. Core Launch Gates (Blocking)

These gates map directly to [14-milestones.md](/docs/gotts-vaults/vault/14-milestones.md) and are evaluated before mainnet launch.

| Gate | Metric                                                                                  | Target                     | Source                                   |
| ---- | --------------------------------------------------------------------------------------- | -------------------------- | ---------------------------------------- |
| P0   | Cross-doc drift items unresolved                                                        | 0                          | `DRIFT-MATRIX.md`                        |
| P1   | Core lifecycle integration test pass rate (`create -> register -> deposit -> withdraw`) | 100% in CI                 | `IMPLEMENTATION-STATE.md` + CI artifacts |
| P1   | Unauthorized/non-registered interaction block rate                                      | 100%                       | Contract/integration tests               |
| P2   | Core MCP tool success rate (local acceptance suite)                                     | >= 99%                     | MCP acceptance test logs                 |
| P2   | Quickstart completion time (clean env, median)                                          | < 5 minutes                | scripted benchmark run                   |
| P3   | Required-proxy bypass success                                                           | 0%                         | safety tests + simulation                |
| P3   | Cancel window effectiveness for delayed high-risk ops                                   | 100% tested cancel success | proxy integration tests                  |
| P4   | Reputation claim deduplication failures                                                 | 0                          | reputation engine tests                  |
| P4   | First milestone claim success after enrollment/deposit                                  | >= 99%                     | integration tests                        |
| P5   | Unresolved critical/high audit findings (core scope)                                    | 0                          | audit report                             |

***

## B. Core Operating KPIs (First 90 Days)

### Adoption and Utility

| Metric                                                     | 30-Day Target | 90-Day Target |
| ---------------------------------------------------------- | ------------- | ------------- |
| Vaults deployed via factory                                | 10+           | 40+           |
| Unique depositing agents                                   | 50+           | 250+          |
| Median time: identity -> first deposit (explicit path)     | < 10 min      | < 7 min       |
| Median time: zero -> first deposit (batch onboarding path) | < 2 min       | < 30 sec      |
| Single-UserOp onboarding success rate                      | >= 90%        | >= 95%        |
| Active weekly vault managers                               | 5+            | 20+           |
| TVL (core vault scope)                                     | $250k+        | $2M+          |

### Reliability and Performance

| Metric                                                     | Target              | Notes                                            |
| ---------------------------------------------------------- | ------------------- | ------------------------------------------------ |
| MCP core read tool p95 latency                             | <= 250 ms           | Excludes external RPC outages                    |
| MCP core write tool p95 latency                            | <= 2 s (pre-sign)   | End-to-end chain confirmation tracked separately |
| Failed write operations due to server-side validation bugs | 0 known regressions | Should fail early with actionable errors         |
| Local swarm startup success (`pnpm testnet:swarm`)         | >= 95%              | Across clean environments                        |
| Incident count causing fund loss                           | 0                   | Hard requirement                                 |

### Safety and Abuse Resistance

| Metric                                                          | Target                   | Notes                      |
| --------------------------------------------------------------- | ------------------------ | -------------------------- |
| Tier-limit bypass events                                        | 0                        | On-chain invariant         |
| Circuit-breaker missed trigger under simulated breach condition | 0                        | Test harness and drills    |
| Duplicate state-changing actions from retries                   | 0                        | Idempotency/nonce handling |
| Required-proxy operations executed without delay policy         | 0                        | Enforcement invariant      |
| Time-to-detect suspicious queued operation                      | <= 60 s in monitored env | Alerting + bot heartbeat   |

### NAV Coherence and Share Pool Integrity (D-062, D-066)

| Metric                                                | Target                                             | Notes                                                                              |
| ----------------------------------------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Share pool price vs NAV deviation (sustained >10 min) | < 75 bps                                           | Derived from canonical `NAVUpdate` events (D-066)                                  |
| NAV snapshot freshness                                | Within `navSnapshotCadence` blocks of latest block | Stale snapshots trigger oracle staleness gates                                     |
| Market safety mode false activation rate              | < 1 per month                                      | False activations reduce UX; too many indicate miscalibrated thresholds            |
| Health attestation pass rate (factory-wide)           | >= 95%                                             | Vaults consistently failing attestation indicate systemic issues                   |
| NAV rate-of-change clamp activations                  | Tracked (informational)                            | Frequent clamp activations may indicate volatile strategies or aggressive settings |
| Oracle staleness gate activations (spread widening)   | Tracked (informational)                            | Rising frequency signals oracle infrastructure degradation                         |

***

## C. Reputation Core KPIs

| Metric                                        | 30-Day Target | 90-Day Target |
| --------------------------------------------- | ------------- | ------------- |
| Agents enrolled in reputation engine          | 40+           | 200+          |
| Milestones claimed (core set)                 | 100+          | 1,000+        |
| Milestone claim rejection false-positive rate | < 2%          | < 1%          |
| Median time: enroll -> first claim            | < 1 day       | < 12 hours    |

***

## D. Deferred KPIs (Non-Blocking for v1)

These metrics are tracked for roadmap planning only. They do **not** block core-v1 launch.

### CCA Expansion (Track A)

* Auction participation rate
* CCA capital efficiency (filled vs committed)
* Post-graduation LP deployment success

### Growth Mechanics (Track B)

* Agent referral conversion rate (referred agent -> first deposit)
* Referral bonus vesting rate (% of referred agents reaching Basic tier)
* Referral tree depth distribution (1-hop, 2-hop)
* Zero-step onboarding funnel conversion (UserOp submitted -> deposit completed)
* Streak retention lift vs non-streak cohorts

### Share Token Composability (Track E)

* Share token composability integrations count (Pendle, Morpho listings)
* Collateral TVL from share tokens on external protocols (USD)
* Pendle PT/YT volume from vault share tokens (USD)

### Strategy Auctions (Track E)

* am-AMM rent revenue to depositors (USD/month)
* Active strategy auction bids per vault
* Manager turnover rate (outbid frequency)

### Rebalance Execution Quality (Track D)

* Rebalance slippage vs benchmark (bps, median and p95) — auction vs TWAMM vs direct
* Solver participation rate (unique solvers per auction)
* Auction fallback rate (% of intents falling back to TWAMM or reschedule)
* Solver bond slashing events (count and reasons)
* Execution quality score (composite: slippage, gas efficiency, surplus captured)

### Cross-Chain Deposits (Track E)

* Cross-chain deposit volume via ERC-7683 intents (USD)
* Source chain distribution (% of deposits from non-Base chains)
* Cross-chain deposit settlement time (median)

### Aggregator Discovery

* Listed on vaults.fyi within 30 days of mainnet launch
* Listed on DefiLlama within 14 days of mainnet launch
* ERC-4626 preview function accuracy vs actual (deviation < 1 bps for deposit/redeem roundtrips)
* Share price queryable at hourly granularity (required for vaults.fyi APY calculation)

***

## E. KPI Governance

* Core launch gates are reviewed weekly during implementation and must be green before release sign-off.
* KPI definitions and thresholds are versioned; any threshold change requires PRD update plus rationale entry in `DECISIONS.md`.
* Deferred KPI dashboards remain informational until the corresponding expansion track is promoted from deferred to active scope.
