Nava SDK

Developer Preview

The Nava SDK lets agents, scripts, and services reach Nava Guardian and supported venues. Its CLI, MCP server, bundled agent skill, and TypeScript API use the same operation names.

Guardian checks the exact proposed action against the agent's active policy and returns a structured verdict. Approval permits that action under the returned policy version. It is not an instruction to execute.

Execution behavior varies by operation. Review each adapter's boundary in the operations reference before enabling a write.

What ships

Package	Install when	Contents
`@navalabs/hyperliquid-adapter`	Hyperliquid perps	Read Hyperliquid market and account data, and place policy-gated orders on the exchange.
`@navalabs/uniswap-adapter`	Uniswap V3 and V4	Read Uniswap pool data and build unsigned swap calldata for your application to sign.
`@navalabs/sdk`	Base verification only, with no protocol	The `nava` CLI, the `nava-mcp` server, the TypeScript client, and the bundled agent skill. Every adapter brings it with it.
`@navalabs/sdk-core`	You need the lower-level client directly	The lower-level Guardian and Nava API clients that `@navalabs/sdk` re-exports.
`@navalabs/sdk-privy`	Privy device-auth wallets	Provision a Privy-backed agent wallet.

Those five are the whole published set. Hyperliquid and Uniswap are the only protocol adapters. Install the adapter for the protocol you need; it brings @navalabs/sdk with it, so one package is a complete install.

Pick a surface

Configuration

Every environment variable the CLI and nava-mcp read, per protocol, with the alias order.

Command line

Run the unified nava binary, and why exit code 0 does not mean approved.

MCP server

Run nava-mcp over stdio, register protocols, and why isError does not mean rejected.

TypeScript API

NavaClient, bootstrapGuardian, and every subpath export with an import example.

Bundled agent skill

Install the bundled skills/nava skill so an agent loads the operation reference it needs on demand.

Operations reference

All 18 operations with every option and field, for both transports, plus each adapter's safety boundary.

The four base verification operations need only @navalabs/sdk. If you are building a custom client at the protocol level, use the advanced Guardian REST guide.

Suggest changes to this page