# AgentVault Network (agentvault.network)
> Non-Custodial Post-Quantum Autonomous Crypto Vault & Headless Wallet-as-a-Service (WaaS) for AI Agents and Machine-to-Machine (M2M) Micro-Payments.

## System Overview
AgentVault is an open, client-side, non-custodial cryptocurrency wallet infrastructure engineered specifically for autonomous AI agents, programmatic bots, and human operators seeking post-quantum security.

* **Primary Endpoint**: https://agentvault.network
* **AI Protocol Manifest**: https://agentvault.network/ai-manifest.json
* **LLM Context & System Reference**: https://agentvault.network/llms.txt
* **License**: Business Source License 1.1 (BSL 1.1, transitioning to Apache 2.0 in 2031) by VVK Inc.

---

## Key Capabilities & Architectural Model

1. **Zero-Custody / Zero Server Keys (Headless & Programmatic)**:
   - Private keys and recovery mnemonics (BIP39) exist **exclusively in agent runtime memory**.
   - No private keys, mnemonics, or plaintext secrets are ever transmitted to backend servers or APIs.
   - Remote database (Firestore) stores only client-side Argon2id + AES-256-GCM encrypted ciphertexts.

2. **Autonomous AI Agent Core (`src/agent/agentCore.js`)**:
   - **No KYC / No Human In The Loop**: Autonomous agents can self-provision isolated non-custodial wallets programmatically.
   - **Sub-Millisecond In-Memory Signing (< 1ms)**: Fast in-memory session engine for high-frequency micro-payments, API fee settlements, and token swaps.
   - **Spending Guardrails**: Client-side policy enforcement (`maxPerTxUsd`, `dailyBudgetUsd`) rejects unauthorized transactions before cryptographic signing occurs, protecting agent treasuries against prompt injection and LLM hallucination exploits.
   - **Post-Quantum M2M Messaging**: Inter-agent encrypted channels powered by NIST FIPS 203 (ML-KEM-768 / Kyber) lattice-based key encapsulation.

3. **Multi-Chain Asset Support**:
   - **EVM Layer-2 Networks**: Base L2 (Chain ID 8453), Arbitrum One (Chain ID 42161), Polygon PoS (Chain ID 137), Ethereum Mainnet (Chain ID 1).
   - **Native Currencies & Stablecoins**: ETH, POL, USDC, USDT.
   - **Bitcoin Multi-Format**: BIP84 Native SegWit (`bc1q`), BIP86 Taproot (`bc1p`), BIP49 Nested SegWit (`3...`), BIP44 Legacy (`1...`).

4. **Cryptographic Standards**:
   - **Memory-Hard KDF**: Argon2id (RFC 9106, 32 MB RAM memory cost) neutralizing GPU/ASIC brute-force and Grover's algorithm parallelization.
   - **Symmetric Encryption**: AES-256-GCM with unique 96-bit IVs and 128-bit authentication tags.
   - **Post-Quantum Key Exchange**: NIST FIPS 203 ML-KEM-768.
   - **HD Wallet Derivation**: BIP32, BIP39, BIP44, BIP84, BIP86 via `@scure/bip39`, `@scure/bip32`, `@scure/btc-signer`.

---

## Developer & Agent Quickstart

### 1. Initialize Autonomous Agent Vault
```javascript
import { createAgentVault, createAgentSession } from 'https://agentvault.network/src/agent/agentCore.js';

// 1. Programmatically provision a non-custodial vault
const agent = await createAgentVault({
    agentName: 'TradingBot-01',
    agentSecret: 'Secure_Passphrase_K992x!'
});

console.log('EVM Address (Base L2):', agent.addresses.evm);
console.log('Bitcoin SegWit Address:', agent.addresses.btc);
console.log('ML-KEM-768 Public Key:', agent.postQuantum.publicKey);
```

### 2. Boot High-Speed Session with Spending Guardrails
```javascript
// 2. Unlock in-memory session with spending limits
const session = await createAgentSession({
    encryptedVault: agent.encryptedVault,
    agentSecret: 'Secure_Passphrase_K992x!',
    policy: {
        maxPerTxUsd: 15.00,       // Max $15 per single transaction
        dailyBudgetUsd: 50.00,     // Max $50 total expenditure per 24 hours
        allowedCurrencies: ['USDC', 'ETH'],
        allowedChains: ['base', 'arbitrum']
    }
});

// Check wallet balances on Base L2
const balances = await session.getBalances('base');
console.log('USDC Balance:', balances.stablecoins.usdc);
```

### 3. Execute Autonomous Micro-Payment (e.g. paying for API compute or x402)
```javascript
// 3. Autonomous payment execution (< 1ms signing time)
const tx = await session.pay({
    to: '0xRecipientAddress...',
    amount: 2.50, // 2.50 USDC
    currency: 'USDC',
    chainKey: 'base'
});

console.log('Payment broadcasted successfully! Tx Hash:', tx.hash);
console.log('Explorer:', tx.explorerUrl);
```

### 4. Post-Quantum Confidential Inter-Agent Communication (M2M)
```javascript
import { sendPostQuantumAgentMessage } from 'https://agentvault.network/src/agent/agentCore.js';

const encryptedM2M = await sendPostQuantumAgentMessage({
    recipientPublicKey: '0xOtherAgentMLKEMPublicKey...',
    secretPayload: { action: 'REQUEST_DATA_FEED', bidUsdc: 0.10 }
});
```

---

## Machine-to-Machine Protocol Specifications
* **Manifest URL**: `https://agentvault.network/ai-manifest.json`
* **Agent Core SDK**: `https://agentvault.network/src/agent/agentCore.js`
* **Network RPCs**: Decentralized Multi-RPC failover for Base L2, Arbitrum One, and Polygon PoS.
* **Mempool API**: Direct integration with Mempool.space for dynamic sat/vB Bitcoin fee estimation and dust threshold protection (294 sat minimum).

---

## Contact & Governance
* **Platform**: AgentVault Network
* **Website**: https://agentvault.network
* **Organization**: VVK Inc. (Viacheslav Kryvous)
* **Open Source Repository**: https://github.com/vvk-inc/safezonewallet