Vaultum

Programmable Security for Digital Assets

Your keys. Your rules. Your vault.

Documentation • Get Started • Architecture • Contributing

Vaultum transforms traditional wallets into programmable vaults with fine-grained security controls. Built on ERC-4337 account abstraction, we enable users to define exactly how their digital assets can be accessed and used.

• 🔐 Modular Security - Mix and match security modules like building blocks
• ⛓️ Cross-Chain Native - One account, multiple blockchains
• ⚡ Gas Abstraction - Pay fees in any token or let others sponsor
• 🎮 Session Keys - Grant temporary, limited access for dApps
• 👥 Social Recovery - Never lose access to your assets
• 💰 Spending Limits - Built-in protection against hacks and mistakes

graph TB
    subgraph "Frontend Layer"
        A[Vaultum App<br/>Next.js 14]
        B[Partner dApps]
    end
    
    subgraph "SDK Layer"
        C[JS/TS SDK]
        D[PHP SDK]
        E[Future SDKs]
    end
    
    subgraph "API Layer"
        F[Vaultum API<br/>Laravel]
        G[Bundler Service]
        H[Paymaster Service]
    end
    
    subgraph "Blockchain Layer"
        I[Smart Account<br/>Contracts]
        J[Security Modules]
        K[EntryPoint<br/>ERC-4337]
    end
    
    A --> C
    B --> C
    C --> F
    D --> F
    F --> G
    F --> H
    G --> K
    H --> K
    K --> I
    I --> J

# Coming soon: Install the Vaultum app
# Create your smart wallet in seconds
# Add security modules as needed

npm install @vaultum/sdk
# or
yarn add @vaultum/sdk
# or
pnpm add @vaultum/sdk

import { VaultumClient } from '@vaultum/sdk';

const client = new VaultumClient({
  chain: 'ethereum',
  apiUrl: 'https://api.vaultum.app'
});

// Create a smart account
const account = await client.createAccount({
  owner: '0xYourAddress',
  modules: ['sessionKeys', 'spendingLimits']
});

composer require vaultum/sdk

use Vaultum\SDK\Client;
use Vaultum\SDK\Enums\Chain;

$client = new Client(
    'https://api.vaultum.app',
    Chain::ETHEREUM
);

$account = $client->createAccount(
    owner: '0xYourAddress',
    modules: ['sessionKeys', 'spendingLimits']
);

Vaultum's modular architecture lets you customize security to your needs:

• Node.js 18+ & pnpm
• PHP 8.3+ & Composer
• Foundry for smart contracts
• Docker (optional)

# Clone the contracts
git clone https://github.com/vaultum/contracts
cd contracts
forge install
forge test

# Clone and run the API
git clone https://github.com/vaultum/api
cd api
cp .env.example .env
php artisan migrate
php artisan serve

# Install SDK
npm install @vaultum/sdk

Each repository includes comprehensive test suites:

# Smart Contracts
forge test -vvv

# JavaScript SDK
pnpm test

# PHP SDK
composer test

# API
php artisan test

Smart Contracts

Network Status

Community

• ERC-4337 smart account implementation
• Basic security modules (Session Keys, Spending Limits)
• SDK development (JavaScript/PHP)
• API infrastructure with bundler integration

• Social Recovery Module (94% complete)
• Multi-signature support
• Dead man's switch
• Privacy features

• Cross-chain message passing
• Mobile app (React Native)
• Hardware wallet integration
• Fiat on/off ramps

• Multi-chain deployment (10+ chains)
• DAO governance
• DeFi integrations
• Enterprise features & compliance

We welcome contributions from the community! See our Contributing Guide for details.

• 🐛 Report bugs and issues
• 💡 Suggest new features
• 🔧 Submit pull requests
• 📖 Improve documentation
• 🌟 Star our repositories

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Vaultum is open source software licensed under the MIT License.