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)

npm install -g agentvault
agentvault --help

From Source

git clone https://github.com/johnnyclem/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

agentvault init my-agent

This creates a .agentvault/ directory with agent configuration.

2. Package Your Agent

agentvault package ./my-agent

Compiles your agent to WASM and generates deployment artifacts.

3. Start Local ICP Replica

dfx start --background

4. Deploy to Canister

agentvault deploy --network local

5. Execute Agent

agentvault exec --canister-id <your-canister-id> "your task"

6. Query Agent State

agentvault show --canister-id <your-canister-id>

7. Fetch State for Local Rebuild

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

ICP_LOCAL_URL=http://127.0.0.1:4943    # Local replica URL
ICP_MAINNET_URL=https://ic0.app        # Mainnet URL

RPC Endpoints

# 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
• Comprehensive tutorial
• Clawdbot/Claude skill runbook

Development

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

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.

Resources

• Website: https://agentvault.cloud
• Documentation: https://agentvault.cloud/docs
• npm: https://www.npmjs.com/package/agentvault
• Product Requirements Document
• Implementation Plan
• Changelog
• ICP Documentation