docs: improve writing style and remove AI-sounding language

- Replace formal phrases like "enables", "comprehensive", "designed to"
- Remove Oxford commas before "and" in simple lists
- Use contractions (can't, doesn't) for natural tone
- Simplify introductory sentences across all README files
- Make descriptions more direct and conversational

Author: Kazopl

README.md

@@ -1,13 +1,13 @@
 # MPC Agent Wallet SDK
 
-A **2-of-3 threshold MPC wallet SDK** designed for AI agents. Enables secure transaction signing where the AI agent cannot act alone - requiring approval from either a user or recovery guardian.
+A **2-of-3 threshold MPC wallet SDK** built for AI agents. The AI agent can't sign transactions alone - it needs approval from either a user or recovery guardian.
 
 ## Key Features
 
 - **2-of-3 Threshold Signing**: AI agent holds 1 share, user holds 1 share, recovery guardian holds 1 share. Any 2 can sign.
 - **Policy Engine**: Configurable rules enforced before signing (spending limits, whitelists, time bounds)
 - **Rust Core**: High-performance cryptographic operations with WASM compilation support
-- **Chain Agnostic**: Designed for EVM, Solana, and Bitcoin support
+- **Chain Agnostic**: Works with EVM, Solana and Bitcoin
 
 ## Architecture
 
@@ -255,48 +255,6 @@ mpc-agent-wallet/
 └── README.md
 ```
 
-## Roadmap
-
-### Phase 1: Core MPC Engine [Complete]
-- [x] DKLs23 adaptation for 2-of-3 threshold
-- [x] Policy engine with spending limits, whitelists
-- [x] Key share storage interface
-
-### Phase 2: Chain Adapters [Complete]
-- [x] EVM adapter with EIP-1559 support
-- [x] Solana adapter
-- [x] ERC-4337 smart account module
-
-### Phase 3: WASM + SDKs [Complete]
-- [x] WASM compilation with wasm-bindgen
-- [x] TypeScript SDK (`@mpc-wallet/sdk`)
-- [x] Python SDK (`mpc-wallet`)
-
-### Phase 4: Relay Service [Complete]
-- [x] WebSocket relay
-- [x] Approval flow
-- [x] Webhook notifications
-
-### Phase 5: Smart Contracts [Complete]
-- [x] MpcSmartAccount - ERC-4337 smart account with MPC signature validation
-- [x] MpcRecoveryModule - Time-delayed MPC key recovery
-- [x] MpcSpendingLimitHook - On-chain spending limit enforcement
-- [x] MpcSmartAccountFactory - CREATE2 counterfactual deployment
-- [x] 71 passing tests
-
-### Phase 6: Testing & Security [Complete]
-- [x] Comprehensive test suite (198+ tests)
-- [x] Fuzz testing for policy engine and signing
-- [x] Security checklist documentation
-
-### Phase 7: Documentation & Examples [Complete]
-- [x] Quick start guide
-- [x] Architecture documentation
-- [x] Security model documentation
-- [x] Integration guide for AI frameworks
-- [x] TypeScript & Python API reference
-- [x] Example integrations (ElizaOS, LangChain, Telegram, DeFi Agent)
-
 ## Documentation
 
 | Document | Description |
@@ -350,4 +308,4 @@ Contributions welcome! Please read the contributing guidelines first.
 
 ---
 
-Built for AI agents that need secure, controlled access to blockchain operations.
+Built for AI agents that need secure blockchain access with human oversight.

contracts/README.md

@@ -51,7 +51,7 @@ ERC-4337 smart account contracts secured by MPC threshold signatures for AI agen
 |----------|-------------|
 | `MpcSmartAccount` | ERC-4337 smart account with MPC signature validation and policy enforcement |
 | `MpcSmartAccountFactory` | Factory for deploying MPC smart account proxies with CREATE2 |
-| `MpcRecoveryModule` | Enables MPC key recovery with time-delayed execution |
+| `MpcRecoveryModule` | Handles MPC key recovery with time-delayed execution |
 | `MpcSpendingLimitHook` | Spending limit enforcement hook for transaction policies |
 
 ## Features
@@ -197,11 +197,11 @@ account.cancelRecovery(accountAddress);  // Only account or guardians
 
 ## Security Considerations
 
-1. **Key Share Distribution**: Store key shares on separate devices/locations
-2. **Guardian Selection**: Choose diverse, trusted guardians
-3. **Time Delay**: Allows detection of malicious recovery attempts
-4. **Spending Limits**: Mitigate damage from compromised AI agents
-5. **Whitelist**: Restrict interaction to known-good contracts
+1. **Key Share Distribution**: Store key shares on separate devices
+2. **Guardian Selection**: Pick diverse and trusted guardians
+3. **Time Delay**: Gives time to detect malicious recovery attempts
+4. **Spending Limits**: Limits damage from compromised AI agents
+5. **Whitelist**: Only allow known-good contracts
 
 ## License
 

docs/README.md

@@ -1,17 +1,17 @@
 # MPC Agent Wallet SDK - Quick Start Guide
 
-Welcome to the MPC Agent Wallet SDK! This guide will help you get started with building secure, AI-controlled wallets using threshold MPC cryptography.
+This guide covers everything you need to build secure AI-controlled wallets using threshold MPC cryptography.
 
 ## What is MPC Agent Wallet?
 
-MPC Agent Wallet is a **2-of-3 threshold Multi-Party Computation (MPC) wallet SDK** designed specifically for AI agents. It enables AI applications to securely manage cryptocurrency wallets while maintaining human oversight.
+MPC Agent Wallet is a **2-of-3 threshold Multi-Party Computation (MPC) wallet SDK** built for AI agents. It lets AI applications manage cryptocurrency wallets while keeping humans in control.
 
 ### Key Benefits
 
-- **AI agents cannot act alone** - Requires approval from user or recovery guardian
-- **Policy enforcement** - Spending limits, whitelists, and time restrictions
-- **Multi-chain support** - EVM, Solana, and Bitcoin compatible
-- **Developer-friendly** - TypeScript, Python, and Rust SDKs
+- **AI agents can't act alone** - Needs approval from user or recovery guardian
+- **Policy enforcement** - Spending limits, whitelists and time restrictions
+- **Multi-chain support** - Works with EVM, Solana and Bitcoin
+- **Developer-friendly** - TypeScript, Python and Rust SDKs
 
 ## Installation
 
@@ -193,9 +193,9 @@ print(f"Wallet address: {address}")
 
 ## Next Steps
 
-- [Architecture Guide](./architecture.md) - Deep dive into system design
-- [Security Model](./security-model.md) - Understand the threat model
-- [Integration Guide](./integration-guide.md) - Integrate with AI frameworks
+- [Architecture Guide](./architecture.md) - Learn how the system works
+- [Security Model](./security-model.md) - Threat model and protections
+- [Integration Guide](./integration-guide.md) - Connect with AI frameworks
 - [TypeScript API Reference](./api-reference/typescript.md)
 - [Python API Reference](./api-reference/python.md)
 
@@ -217,4 +217,4 @@ print(f"Wallet address: {address}")
 
 ---
 
-Built for AI agents that need secure, controlled access to blockchain operations.
+Built for AI agents that need secure blockchain access with human oversight.

docs/SECURITY_CHECKLIST.md

@@ -143,7 +143,7 @@ This document outlines the security measures and verification checklist for the
 - [x] **Memory Safety**: Written in Rust with safe defaults
 - [x] **No Unsafe Code**: Minimal unsafe code, all reviewed
 - [x] **Dependency Audit**: Dependencies audited with `cargo audit`
-- [x] **Test Coverage**: Comprehensive unit, integration, and fuzz tests
+- [x] **Test Coverage**: Unit, integration and fuzz tests
 
 #### Testing Framework
 
@@ -191,7 +191,7 @@ Test categories:
 
 ### Testing
 
-- [x] Unit tests comprehensive (>80% coverage target)
+- [x] Unit tests complete (>80% coverage target)
 - [x] Integration tests for all flows
 - [x] Fuzz testing for edge cases
 - [x] Invariant tests for critical properties

docs/api-reference/python.md

@@ -671,7 +671,7 @@ asyncio.run(main())
 
 ## Type Hints
 
-The package includes comprehensive type hints and supports mypy/pyright:
+The package includes full type hints and supports mypy/pyright:
 
 ```python
 from mpc_wallet import MpcAgentWallet, TransactionRequest, PolicyDecision

docs/architecture.md

@@ -1,6 +1,6 @@
 # Architecture Guide
 
-This document provides a comprehensive overview of the MPC Agent Wallet SDK architecture, design decisions, and component interactions.
+This guide covers the MPC Agent Wallet SDK architecture, design decisions and how components work together.
 
 ## System Overview
 
@@ -108,7 +108,7 @@ pub enum PolicyDecision {
 
 ### 3. Chain Adapters
 
-Blockchain-agnostic interface for multi-chain support.
+A common interface that works across different blockchains.
 
 ```rust
 #[async_trait]
@@ -419,6 +419,6 @@ class SlackNotifier implements NotificationChannel {
 
 ## Related Documentation
 
-- [Security Model](./security-model.md) - Detailed threat model and mitigations
+- [Security Model](./security-model.md) - Threat model and protections
 - [Integration Guide](./integration-guide.md) - AI framework integrations
-- [API Reference](./api-reference/) - Complete API documentation
+- [API Reference](./api-reference/) - Full API documentation

docs/integration-guide.md

@@ -1,6 +1,6 @@
 # Integration Guide
 
-This guide explains how to integrate the MPC Agent Wallet SDK with popular AI frameworks and applications.
+Learn how to connect the MPC Agent Wallet SDK with popular AI frameworks.
 
 ## Table of Contents
 
@@ -15,7 +15,7 @@ This guide explains how to integrate the MPC Agent Wallet SDK with popular AI fr
 
 ## ElizaOS Integration
 
-[ElizaOS](https://elizaos.ai) is a popular framework for building AI agents. The MPC Wallet integrates as a plugin.
+[ElizaOS](https://elizaos.ai) is a popular framework for building AI agents. The MPC Wallet works as a plugin.
 
 ### Installation
 
@@ -334,7 +334,7 @@ def wallet_send(to: str, amount: str, chain: str = "ethereum") -> str:
 
 ## Custom AI Frameworks
 
-For custom AI frameworks, use the SDK directly.
+For custom AI frameworks, you can use the SDK directly.
 
 ### TypeScript Example
 
@@ -589,7 +589,7 @@ try {
 ### 3. Logging and Monitoring
 
 ```typescript
-// Set up comprehensive logging
+// Set up logging
 wallet.on('policyEvaluated', (tx, decision) => {
   logger.info('Policy evaluated', {
     txId: tx.requestId,
@@ -654,7 +654,7 @@ if (context.isKnownProtocol) {
 
 ## Next Steps
 
-- [Basic Wallet Example](../examples/basic-wallet/) - Start with the basics
-- [ElizaOS Plugin Example](../examples/elizaos-plugin/) - Full ElizaOS integration
-- [LangChain Tool Example](../examples/langchain-tool/) - LangChain integration
-- [Telegram Bot Example](../examples/telegram-bot/) - Approval via Telegram
+- [Basic Wallet Example](../examples/basic-wallet/) - Start here
+- [ElizaOS Plugin Example](../examples/elizaos-plugin/) - Full ElizaOS setup
+- [LangChain Tool Example](../examples/langchain-tool/) - LangChain setup
+- [Telegram Bot Example](../examples/telegram-bot/) - Telegram approvals

docs/security-model.md

@@ -1,10 +1,10 @@
 # Security Model
 
-This document describes the security model, threat analysis, and mitigation strategies for the MPC Agent Wallet SDK.
+This guide covers the security model, threat analysis and how the MPC Agent Wallet SDK protects against attacks.
 
 ## Overview
 
-The MPC Agent Wallet is designed to provide secure cryptocurrency wallet functionality for AI agents while maintaining human oversight and control.
+The MPC Agent Wallet gives AI agents secure cryptocurrency wallet access while keeping humans in control.
 
 ### Security Goals
 
@@ -20,7 +20,7 @@ The MPC Agent Wallet is designed to provide secure cryptocurrency wallet functio
 
 | Party | Trust Level | Responsibilities |
 |-------|-------------|------------------|
-| **Agent** | Semi-trusted | Initiates transactions, enforces client-side policy |
+| **Agent** | Semi-trusted | Starts transactions, enforces client-side policy |
 | **User** | Trusted | Primary approval authority, manages policy |
 | **Recovery** | Trusted (offline) | Backup approval, key recovery |
 | **Relay** | Untrusted | Message routing only (cannot access secrets) |
@@ -241,7 +241,7 @@ EncryptedKeyShare = ChaCha20-Poly1305(key, nonce, plaintext)
 
 ## Responsible Disclosure
 
-If you discover a security vulnerability, please report it responsibly:
+Found a security issue? Please report it responsibly:
 
 1. **Email**: security@example.com
 2. **PGP Key**: Available at [keys.example.com](https://keys.example.com)

examples/basic-wallet/README.md

@@ -1,6 +1,6 @@
 # Basic Wallet Example
 
-This example demonstrates the fundamental operations of the MPC Agent Wallet SDK.
+A simple example showing basic MPC Agent Wallet SDK operations.
 
 ## Features
 

examples/defi-agent/README.md

@@ -1,6 +1,6 @@
 # DeFi Agent Example
 
-This example demonstrates an automated DeFi agent that uses the MPC wallet to execute sophisticated DeFi strategies while maintaining user oversight.
+An automated DeFi agent that uses the MPC wallet to run DeFi strategies while keeping the user in control.
 
 ## Features