# Overview \[VaultKit 2.1 declares typed policies and routes vault-manager actions through Newton attestations.]

Newton VaultKit is a TypeScript SDK and companion Solidity contract system for vault curators. It routes manager actions through a Newton Policy Protocol attestation gate before the underlying vault receives the call.

Curators continue using the vault SDKs and contracts they already know. VaultKit adds a Shield clone between the curator and the vault, packages each action as an exact `Intent`, asks Newton operators to evaluate that intent against the configured policy, and forwards the action only when a valid attestation is available.

## What It Does

VaultKit turns a vault action into this flow:

```mermaid
sequenceDiagram
    participant App as Curator App
    participant SDK as Newton VaultKit
    participant AVS as Newton AVS
    participant Shield as Shield Contract
    participant Vendor as Vault Protocol

    App->>SDK: Call typed vault action
    SDK->>AVS: Submit signed intent and policy inputs
    AVS-->>SDK: Return allow/deny result and attestation data
    SDK->>Shield: Execute attested intent
    Shield->>Vendor: Forward approved manager call
```

## Core Pieces

* **Shield clones:** One audited implementation per chain, with deterministic per-curator clones deployed through `ShieldFactory`.
* **Policy-first authoring:** `definePolicy().with(...)` combines published packs and custom `defineOracle(...)` outputs.
* **Policy core:** `@newton-xyz/policy-core` owns oracle authoring, manifest encoding, schema generation, introspection, and provenance classification.
* **Vendor modules:** Typed wrappers for MetaMorpho, Morpho Blue, Euler Earn, EVault, and Superform manager actions.
* **Generic calls:** `shield.sendCall(...)` supports protocols and manager actions without a first-class vendor module.
* **Typed errors:** SDK failures map to stable error classes such as `PolicyDeniedError`, `AttestationTimeoutError`, `ShieldExecutionError`, `ParamMismatchError`, `GatewayError`, and `UnsupportedChainError`.
* **Verification:** `client.policy`, `client.verification`, and `client.reverify()` expose the resolved policy and attach-time checks.
* **Negative assertions:** `assertIntentBlocked(...)` proves a noncompliant intent is rejected without mining a transaction.
* **Browser-safe core:** The main package avoids `node:*` imports. Vendor modules may inherit constraints from the vendor SDKs they wrap.

## Manager Actions Only

VaultKit is for privileged vault operations such as reallocations, cap changes, and other curator or manager calls. End-user deposits and withdrawals still flow through the vault protocol's normal UX unless the vault deliberately routes those actions through a Shield.

## How to Read This Section

* Start with [Getting Started](/developers/vaults/sdk/integration-guide) to install packages, create clients, configure a Shield, and run a policy-gated action.
* Use [Morpho](/developers/vaults/sdk/morpho) for MetaMorpho curator setup, composite policy choices, and `reallocate` role requirements.
* Use [Morpho Blue](/developers/vaults/sdk/morpho-blue) for managed-sleeve position operations.
* Use [Superform](/developers/vaults/sdk/superform) for SuperVault manager actions and typed hook bundles.
* Use [Policies](/developers/vaults/sdk/policies) for published packs, custom oracles, bare policies, and verification.
* Read [Concepts](/developers/vaults/sdk/concepts) if you want the mental model for `createShield`, packs, vendor modules, and `sendCall`.
* Use [Examples](/developers/vaults/sdk/examples) for copyable integration patterns.
* Keep [Reference](/developers/vaults/sdk/reference) nearby for parameters, return values, supported chains, and exported errors.

<Card title="Integration Guide" icon="code" to="/developers/vaults/sdk/integration-guide">
  Install VaultKit and run a policy-gated vault action.
</Card>

<Card title="Morpho" icon="blocks" to="/developers/vaults/sdk/morpho">
  Gate MetaMorpho curator actions with a Newton Shield.
</Card>

<Card title="Concepts" icon="book-open" to="/developers/vaults/sdk/concepts">
  Understand Shield clients, policy packs, vendor modules, and generic calls.
</Card>

<Card title="Reference" icon="book-open" to="/developers/vaults/sdk/reference">
  Review the API surface, chains, errors, and package structure.
</Card>