agentvault 1.0.0

package/README.md

@@ -0,0 +1,253 @@
+# AgentVault
+
+**Persistent On-Chain AI Agent Platform - Sovereign, Reconstructible, Autonomous**
+
+AgentVault is an open-source CLI and canister system that enables true autonomy for local AI agents. Deploy agents to Internet Computer (ICP) canisters for persistent, 24/7 execution without browser dependencies.
+
+## Features
+
+- **Agent Packaging**: Compile TypeScript agents to WASM
+- **Canister Deployment**: Deploy to ICP local replica or mainnet
+- **State Management**: Query, fetch, and reconstruct agent state
+- **Multi-Chain Wallets**: ICP, Ethereum, Polkadot, Solana support
+- **VetKeys Integration**: Threshold key derivation for secure secrets
+- **Monitoring**: Health checks, metrics, and alerting
+- **Archival**: Arweave integration for permanent storage
+- **AI Inference**: Bittensor network integration
+
+## Installation
+
+### From npm (Recommended)
+
+```bash
+npm install -g agentvault
+agentvault --help
+```
+
+### From Source
+
+```bash
+git clone https://github.com/anomalyco/agentvault.git
+cd agentvault
+npm install
+npm run build
+node dist/cli/index.js --help
+```
+
+### Prerequisites
+
+- Node.js 18+
+- dfx (Internet Computer SDK) - for canister deployment
+- TypeScript 5.7+
+
+## Quick Start
+
+### 1. Initialize a New Agent Project
+
+```bash
+agentvault init my-agent
+```
+
+This creates a `.agentvault/` directory with agent configuration.
+
+### 2. Package Your Agent
+
+```bash
+agentvault package ./my-agent
+```
+
+Compiles your agent to WASM and generates deployment artifacts.
+
+### 3. Start Local ICP Replica
+
+```bash
+dfx start --background
+```
+
+### 4. Deploy to Canister
+
+```bash
+agentvault deploy --network local
+```
+
+### 5. Execute Agent
+
+```bash
+agentvault exec --canister-id <your-canister-id> "your task"
+```
+
+### 6. Query Agent State
+
+```bash
+agentvault show --canister-id <your-canister-id>
+```
+
+### 7. Fetch State for Local Rebuild
+
+```bash
+agentvault fetch --canister-id <your-canister-id>
+```
+
+## CLI Commands
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `init` | Initialize a new AgentVault project |
+| `package` | Package agent directory to WASM |
+| `deploy` | Deploy agent to ICP canister |
+| `exec` | Execute task on canister |
+| `show` | Show agent state |
+| `fetch` | Download agent state from canister |
+| `status` | Display project status |
+| `list` | List all agents |
+
+### Wallet Commands
+
+| Command | Description |
+|---------|-------------|
+| `wallet` | Manage agent wallets |
+| `identity` | Manage ICP identities |
+| `cycles` | Manage canister cycles |
+| `tokens` | Query token balances |
+
+### Monitoring Commands
+
+| Command | Description |
+|---------|-------------|
+| `monitor` | Monitor canister health |
+| `health` | Run health checks |
+| `info` | Get canister information |
+| `stats` | View canister statistics |
+| `logs` | View canister logs |
+
+### Advanced Commands
+
+| Command | Description | Status |
+|---------|-------------|--------|
+| `backup` | Backup agent data | Stable |
+| `rebuild` | Rebuild agent from state | Stable |
+| `promote` | Promote canister between environments | Stable |
+| `rollback` | Rollback canister deployment | Stable |
+| `inference` | Query AI inference services | Experimental |
+| `archive` | Archive to Arweave | Experimental |
+| `approve` | Multi-signature approvals | Experimental |
+| `profile` | Profile canister performance | Experimental |
+| `trace` | View execution traces | Experimental |
+
+## Environment Variables
+
+### ICP Configuration
+
+```bash
+ICP_LOCAL_URL=http://127.0.0.1:4943    # Local replica URL
+ICP_MAINNET_URL=https://ic0.app        # Mainnet URL
+```
+
+### RPC Endpoints
+
+```bash
+# Ethereum
+ETHEREUM_RPC_URL=https://eth.example.com
+INFURA_API_KEY=your-key
+ETHERSCAN_API_KEY=your-key
+
+# Solana
+SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
+SOLANA_MAINNET_RPC_URL=https://api.mainnet-beta.solana.com
+SOLANA_DEVNET_RPC_URL=https://api.devnet.solana.com
+
+# Polkadot
+POLKADOT_RPC_URL=wss://rpc.polkadot.io
+KUSAMA_RPC_URL=wss://kusama-rpc.polkadot.io
+```
+
+## Project Structure
+
+```
+agentvault/
+├── src/                    # Core TypeScript library
+│   ├── deployment/         # ICP client and deployment
+│   ├── packaging/          # WASM compilation
+│   ├── canister/           # Actor bindings
+│   ├── wallet/             # Multi-chain wallet
+│   ├── security/           # VetKeys and encryption
+│   ├── monitoring/         # Health and metrics
+│   ├── archival/           # Arweave client
+│   └── inference/          # Bittensor client
+├── cli/                    # CLI commands
+├── canister/               # Motoko canister code
+├── webapp/                 # Next.js dashboard
+├── tests/                  # Test suite (508 tests)
+└── examples/               # Sample agents
+```
+
+## Documentation (v1.0)
+
+- **Website**: https://agentvault.cloud
+- [Documentation index](docs/user/index-v1.0.md)
+- [Comprehensive tutorial](docs/user/tutorial-v1.0.md)
+- [Clawdbot/Claude skill runbook](docs/user/clawdbot-claude-skill.md)
+
+## Development
+
+```bash
+npm run dev          # Development mode with watch
+npm run dev:dashboard # Run core + web dashboard together
+npm run dev:webapp   # Run only Next.js dashboard
+npm run build        # Build TypeScript
+npm run test         # Run test suite
+npm run test:watch   # Run tests in watch mode
+npm run typecheck    # TypeScript type checking
+npm run typecheck:webapp # Dashboard type checking
+npm run lint         # ESLint
+npm run lint:fix     # ESLint with auto-fix
+```
+
+## Testing
+
+AgentVault has 508 tests covering:
+
+- CLI commands (init, deploy, package, status)
+- ICP client (connection, deployment, execution)
+- Packaging (compiler, detector, packager)
+- Integration tests
+
+```bash
+npm run test
+```
+
+## Known Limitations
+
+| Feature | Status |
+|---------|--------|
+| Core flow (init → package → deploy → exec → fetch) | ✅ Working |
+| Wallet crypto (real elliptic curves) | ⚠️ Basic SHA-256 |
+| VetKeys threshold signatures | ⚠️ Simulated |
+| Bittensor inference | ⚠️ Requires API access |
+| Arweave archival | ⚠️ Requires wallet setup |
+| Backup/restore | ⚠️ Manifest only |
+
+## Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch
+3. Run tests and linting
+4. Submit a pull request
+
+## License
+
+MIT License - see [LICENSE](./LICENSE).
+
+## Resources
+
+- **Website**: https://agentvault.cloud
+- **Documentation**: https://agentvault.cloud/docs
+- **npm**: https://www.npmjs.com/package/agentvault
+- [Product Requirements Document](./docs/PRD.md)
+- [Implementation Plan](./AI_DOCS/)
+- [Changelog](./CHANGELOG.md)
+- [ICP Documentation](https://internetcomputer.org/docs/)

package/backups/agentvault-backup-test-agent-2026-02-12T17-54-28-967Z.json

@@ -0,0 +1,28 @@
+{
+  "version": "1.0",
+  "agentId": "test-agent",
+  "exportedAt": 1770918868967,
+  "format": "json",
+  "wallets": [
+    {
+      "id": "wallet-1",
+      "agentId": "test-agent",
+      "chain": "cketh",
+      "address": "0x1234567890abcdef1234567890abcdef12345678",
+      "privateKey": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+      "createdAt": 1770918868967,
+      "updatedAt": 1770918868967,
+      "creationMethod": "private-key"
+    },
+    {
+      "id": "wallet-2",
+      "agentId": "test-agent",
+      "chain": "cketh",
+      "address": "0x1234567890abcdef1234567890abcdef12345678",
+      "privateKey": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+      "createdAt": 1770918868967,
+      "updatedAt": 1770918868967,
+      "creationMethod": "private-key"
+    }
+  ]
+}

package/backups/agentvault-backup-test-agent-2026-02-12T17-54-29-032Z.backup

@@ -0,0 +1 @@
+{"encrypted":"601fecd19c66b7208418848c25fc5ab223b694d01f3e3a841dedd7c1c8e99a45223092b8b14c8a5bb54e4099944bac5c937725009efa33282d97eed87b5d5f8d2b7a79792b22627b703dff7d8d21d94fe18637acac331c5ef5269af7f57fb3ded7ba073803c04961c7e12a277d9655331afd0e92240701d44dfeae03b584e0f20cf283aadafcdd7997145316792302abcc5400d9a13cef0e74c8b72c9f66be6664a1797757240cd1a84d08329dfa0d254462945b83d6bb55e4c7f37b2fcee1db39630df81320f8d2e5e38ed2af7bb0ee750357233d9c86289f13afcf549b945e41f944607a36d440c5a0310cf373777385aa98c3aa5af83f53766c2d1e3035f85be4173cc4358132383f06970f16c1d7c2064114284526043cad36533323d7d6b0ddebf4e1de4c3a4eb795dc666c292d7b81bb8e1da78b02c2568ff0fa0608cf52cad455aa02a9c74393fe4a84e996a70de0a02c054f9e41d808ae24bf22692c32a12e7a7b19dc1b5427935c809aa00fd4cc42e063d19674d6427f4b47c3cb5e2fabb1cca37f19104c30497a553f0c4ba74522dea156434ed3172794b3511818a5e2e78e500e0ca25e08eb0bfe07f34fbc819cd3688b4e243a5ea525314824f82b9ab190338ae2e178c4fb0242f776231b3dd97e3e14f7f27e6892.feb08a8a8fd6b9be8bcbd441aa83e67c"}

package/backups/agentvault-backup-test-agent-2026-02-12T17-57-42-373Z.json

@@ -0,0 +1,28 @@
+{
+  "version": "1.0",
+  "agentId": "test-agent",
+  "exportedAt": 1770919062374,
+  "format": "json",
+  "wallets": [
+    {
+      "id": "wallet-1",
+      "agentId": "test-agent",
+      "chain": "cketh",
+      "address": "0x1234567890abcdef1234567890abcdef12345678",
+      "privateKey": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+      "createdAt": 1770919062373,
+      "updatedAt": 1770919062373,
+      "creationMethod": "private-key"
+    },
+    {
+      "id": "wallet-2",
+      "agentId": "test-agent",
+      "chain": "cketh",
+      "address": "0x1234567890abcdef1234567890abcdef12345678",
+      "privateKey": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+      "createdAt": 1770919062373,
+      "updatedAt": 1770919062373,
+      "creationMethod": "private-key"
+    }
+  ]
+}

package/backups/agentvault-backup-test-agent-2026-02-12T17-57-42-428Z.backup

@@ -0,0 +1 @@
+{"encrypted":"24a771888039381d577a63fe00df9329cc4a9146db72eec35f206749f86d4745230bf150284b6c88505c368db132b4c216b70300e9c54aa37a797288e29bd43bebb281fe677fbd2c51202b04d7fac922927b1eda8da57cfc37de77f5765c79eac282e63d8c318346dc42e43864efb9566c12da3a8f66f06bace75bc4791c46c37aca495fb47e256ce0d4310713c093105d458e809673641b0e219b9509dff9811654de30a43e32bb6e333dfc55238e2a7d549deac02d1e2eb3523153eee504e0abc57a801127c8809e7fef3109a68949bff235442c936cae8438fb782508b3213d37880303f1b446b1ddf7d286c8b85d2dd78da37c02b1551acb791aeaa44ebaa5f8e22d1fa85acb28ea69e4588def5259b2caa6ed85cc48e2b74862c3f1d9b8450e43ecc14c8f5345afdc8321ed0cde0255bc60ad80c290ad1a5ade52588b076c0f48d2c0e880f3be83037b10c382348d85e23a89214307ad421b7ceb40086919e5aa0e552a5d4e2e33edba5fd7b4a0be369efe3a64d712ace867d38abe6172ead9c6395f44791b955a2ae0eae1450645cfac5fce67101635bc2ca6cce07ee4afcfe2864500da777fbd425d3e5e7614b22177478012f77826efe682af73e6ed92e479fcf234020ab065483efc6f0318368bdf501eb0bf6250f4dd.7aefcc7265f58c652c096d39067b9806"}

package/backups/agentvault-backup-test-agent-2026-02-12T18-52-25-132Z.json

@@ -0,0 +1,28 @@
+{
+  "version": "1.0",
+  "agentId": "test-agent",
+  "exportedAt": 1770922345133,
+  "format": "json",
+  "wallets": [
+    {
+      "id": "wallet-1",
+      "agentId": "test-agent",
+      "chain": "cketh",
+      "address": "0x1234567890abcdef1234567890abcdef12345678",
+      "privateKey": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+      "createdAt": 1770922345132,
+      "updatedAt": 1770922345132,
+      "creationMethod": "private-key"
+    },
+    {
+      "id": "wallet-2",
+      "agentId": "test-agent",
+      "chain": "cketh",
+      "address": "0x1234567890abcdef1234567890abcdef12345678",
+      "privateKey": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+      "createdAt": 1770922345132,
+      "updatedAt": 1770922345132,
+      "creationMethod": "private-key"
+    }
+  ]
+}

package/backups/agentvault-backup-test-agent-2026-02-12T18-52-25-247Z.backup

@@ -0,0 +1 @@
+{"encrypted":"6327bb22b39ebc91b780f3b3405f99b540aa8b8da54ef348372b333007db38c29cbb90aae4deebb0651c109302c466de03bddfcf14007de39a0ec1fc06467f5b5ea54cb4ac50e55b05ec2219d2492baaeb2fb156cc7a967470332738d411281605b4dc3c6596cd58352715ec865bb0bafcb9c8842e053b32660eaf623acb6098c92b92b088a06b3990c74a2c40045cecbbbc40c215083ff5e0c8a5042f20604c20c38622dd8edb8df09635590fc4e3d7867f1c044d3ae4648fffd25fee767433f393c4e6fed78a82fae705d919566df1e7eac98ba01542e1cba0bd3f5952527b2a7894fe74cd239c1c9953310de8c37beaacff376ad13e8b57829d8daacb2540dfb1e6a4c8a6f0cf866a629879bbca811830f7aa2a109a45a20e4e1996e32b88c76269d348044e9012e69263e358aeedf5c565ef225ada153531cc4cd26f8d195c824c798e4218df62eb69fea4fec2c818db73621957ef85dfa1d48aa0ed0ff8029ca9762fee9520de2163b491412cf1a184fdd890ecfc904b16db92703678a08013064cec3980eaaa564e9e41e1a2635465ab79240ff1137c1d3e0c28516b6277bd7e7d329a0890587ea8f4fa9fedd3fd21e981d167c6f4f509719fddfc98f3a98632a919ecaaea01e984139c5ed9c4d755460d41bf73ca3c4a20.36ed2be30022b68e47c1a001c5ab6633"}

package/backups/agentvault-backup-test-agent-2026-02-12T18-54-09-216Z.json

@@ -0,0 +1,28 @@
+{
+  "version": "1.0",
+  "agentId": "test-agent",
+  "exportedAt": 1770922449216,
+  "format": "json",
+  "wallets": [
+    {
+      "id": "wallet-1",
+      "agentId": "test-agent",
+      "chain": "cketh",
+      "address": "0x1234567890abcdef1234567890abcdef12345678",
+      "privateKey": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+      "createdAt": 1770922449209,
+      "updatedAt": 1770922449209,
+      "creationMethod": "private-key"
+    },
+    {
+      "id": "wallet-2",
+      "agentId": "test-agent",
+      "chain": "cketh",
+      "address": "0x1234567890abcdef1234567890abcdef12345678",
+      "privateKey": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+      "createdAt": 1770922449209,
+      "updatedAt": 1770922449209,
+      "creationMethod": "private-key"
+    }
+  ]
+}

package/backups/agentvault-backup-test-agent-2026-02-12T18-54-09-283Z.backup

@@ -0,0 +1 @@
+{"encrypted":"da6dc94ce5ddc2fa316b86ffc93e33dd5005c73536eb8b970403ce0007ab9a1d5861df815a30bea164d55c71333c7ccead0ad1133365fe94a2b42d63059a8904c3fa8db39ea6021a2f6ffedf961cbcb89ef4e1e6f5d690719e7c244d8ce65477e43b0e1627af287df6d445218e2979abf486d619ed0e1991e403f0c59c010fb016f5ce4d384d873aa2efc33a7418b53b047323e36679cd7e6c81bb75375fbb911da34de78c25e0f7c0a13cc6333719eeb9fb0624d64baf9f1855e2c5ebc7f171e090de6a6985f1eb08de5076251d01f94737d6849de59400305ea0a3325467f690f73ad816d74379c976e67da5623613512bc3bd3908fc30f842d7d47d7df8f535e792b0c7ae5106f1fd0ad6e1b587f9431e302c90ed57554104f82ae0a1e75b7881d85f671d97bc624058017beb26d0cd637ecaed3194acd18c5883152bd925ef3dfcb83ecb6fc22dfdb022f48ba3f8fdd1a702cb6dca202dc48a85079d348e5124e6a8351f87b0119c17e2102c0fee094a9abce58f53d57b28ed20f552a2fc1b7c99537624d67becb12ff196c1c5cd401e2bb3d4fdba6cb6e1ddbe00bfe5c45d8e20426df80fee7e62b520696fec1f0b23b30c861cb6e1b2a89aa7561ec897c22ce02bace4f21be511b76c52900eaed2fe60b8cc45daf488d29f.d7869a1924b7c6f7a65146e053409960"}

package/backups/agentvault-backup-test-agent-2026-02-12T22-18-22-772Z.backup

@@ -0,0 +1 @@
+{"encrypted":"2dd98d8fdb2707830c917802d1acde9f94dd31a8ee62612323c5c81f5c4fda15c4764f5ddf7ba7c90048d280d7005656177a8d184d6b60868480821dba3826f582e4d25d8d8c4ffe985da64a56d00c409677ab2e1857cd08f4ef1b0bc5e0a0e31d1d524ab717a4ec25deb9ee0f20e4e423bbf09b8b7d302bf389d6e93a75d5ab1b01b31c8d2e5436cb22e077b07ce69bf3b7fe52c14b757f89bbf6fc62ce687589f494ef5822c9cf22c81c3ce502fab75dc77684b6c1c39c025d7ffba968f80974bf40509a1599342f16b446bff6c001450087cd23d8887bdaa83d4bf0679a5347e064a0f5e49c0a0f138a20c6d722acf56b2245b58f07dc73b49a3e698fbb23681813106ee5e0f9093cd97840e1abc698d817be04e980305c05f38dc60bcb10d5fd1d38384eb831dc629055e4b58ff3a99e08f98da688bfd99fcd723a9c98c054141d7343428d3d3262c06b66ef7b1579804d4318a600e51a5b1cb722248d25dfbd1f7ea2c186d513c7bbbfea29911861ab2aa190f108eab4f9c31a0e8e345048d8dabb1eb4cc818721f74d663111fc9a27ae11cb945ec2a65f7132ed4dde14c28d86bb54b30dd1044b7fc3b7c2a00d1a2b64a9bcacd8c2ffb316214c3d5dfed61f410347eb1ae1828b37c063eb92f8dd44774e907b32aa203c98.0b0e2b98e9d80607a998eb6157697e4c"}

package/backups/agentvault-backup-test-agent-2026-02-12T22-18-22-793Z.json

@@ -0,0 +1,28 @@
+{
+  "version": "1.0",
+  "agentId": "test-agent",
+  "exportedAt": 1770934702794,
+  "format": "json",
+  "wallets": [
+    {
+      "id": "wallet-1",
+      "agentId": "test-agent",
+      "chain": "cketh",
+      "address": "0x1234567890abcdef1234567890abcdef12345678",
+      "privateKey": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+      "createdAt": 1770934702793,
+      "updatedAt": 1770934702793,
+      "creationMethod": "private-key"
+    },
+    {
+      "id": "wallet-2",
+      "agentId": "test-agent",
+      "chain": "cketh",
+      "address": "0x1234567890abcdef1234567890abcdef12345678",
+      "privateKey": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+      "createdAt": 1770934702793,
+      "updatedAt": 1770934702793,
+      "creationMethod": "private-key"
+    }
+  ]
+}

package/backups/test-backup.json

@@ -0,0 +1,28 @@
+{
+  "version": "1.0",
+  "agentId": "test-agent",
+  "exportedAt": 1771032384251,
+  "format": "json",
+  "wallets": [
+    {
+      "id": "wallet-1",
+      "agentId": "test-agent",
+      "chain": "cketh",
+      "address": "0x1234567890abcdef1234567890abcdef12345678",
+      "privateKey": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+      "createdAt": 1771032384247,
+      "updatedAt": 1771032384247,
+      "creationMethod": "private-key"
+    },
+    {
+      "id": "wallet-2",
+      "agentId": "test-agent",
+      "chain": "cketh",
+      "address": "0x1234567890abcdef1234567890abcdef12345678",
+      "privateKey": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+      "createdAt": 1771032384247,
+      "updatedAt": 1771032384247,
+      "creationMethod": "private-key"
+    }
+  ]
+}

package/dist/cli/commands/approve.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+declare const approveCmd: Command;
+export { approveCmd };
+//# sourceMappingURL=approve.d.ts.map