> 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/readme.md).

# README

Permissionless infrastructure for Agent Capital Markets. Gotts enables any ERC-8004 registered agent to bank with Uniswap: deploy vaults, manage strategy, trade, provide liquidity, and attract capital from other agents -- all without human intermediation.

## Products

### Gotts Safe

Unified Uniswap MCP server with 154 tools across 30 categories. Provides data, trading, liquidity management, vault operations, identity, and safety tools through a single server with profile-based tool activation.

### Gotts Vaults

Permissionless vault factory built on ERC-4626 and ERC-8004. Any registered agent can deploy a vault, manage strategy via auction-managed AMM (am-AMM), and attract capital from other agents. Every vault gets an auto-created V4 share pool for instant secondary market liquidity.

### Agent Proxy

Time-delayed execution proxy for reactive defense. All write operations pass through a mandatory cancellation window. A monitoring bot watches every announced transaction and can veto suspicious activity before execution.

## Current Status

Foundation scaffolding is complete. The monorepo contains 8 workspace packages with build, test, lint, and format tooling fully wired. No runtime code exists yet -- packages contain only placeholder exports. See the [CHANGELOG](https://github.com/wpank/gotts.ai-monorepo/blob/main/CHANGELOG.md) for completed work.

## Tech Stack

| Layer           | Technology                                           |
| --------------- | ---------------------------------------------------- |
| Language        | TypeScript (strict mode) + Solidity (^0.8.26)        |
| Runtime         | Node.js >= 20                                        |
| Package Manager | pnpm 9.x (workspaces)                                |
| Build           | tsup (TypeScript), Foundry (Solidity)                |
| Testing         | vitest (TypeScript), forge (Solidity)                |
| Linting         | ESLint + Prettier (TypeScript), forge fmt (Solidity) |
| Ethereum        | viem (not ethers.js)                                 |
| MCP SDK         | @modelcontextprotocol/sdk                            |
| Validation      | zod                                                  |

## Quick Links

* [Installation](https://github.com/wpank/gotts.ai-monorepo/blob/main/docs/getting-started/installation.md) -- set up the monorepo locally
* [Development Setup](https://github.com/wpank/gotts.ai-monorepo/blob/main/docs/contributing/development-setup.md) -- contribute to Gotts
* [Architecture](https://github.com/wpank/gotts.ai-monorepo/blob/main/docs/concepts/architecture.md) -- understand the system design
* [Glossary](https://github.com/wpank/gotts.ai-monorepo/blob/main/docs/reference/glossary.md) -- key terminology