Documentation

RegVault Protocol

An institutional permissioned vault-share system on Solana. Vault shares are Token-2022 assets with transfer-hook enforcement, so compliance policy is enforced at the token layer instead of only in a front-end.

What makes it institutional-grade?

RegVault combines entity-based permissioning, issuer-signed attestations without storing PII, Token-2022 share tokens with Transfer Hook validation, maker-checker withdraw queues, and immutable on-chain receipts. These primitives enable regulated funds, issuers, and custodians to operate with on-chain controls that cannot be bypassed.

Key Features

The protocol is designed around four core pillars that work together to provide institutional-grade controls:

Architecture at a Glance

RegVault consists of two on-chain programs that work together:

01

regvault program

Core vault logic: entity registry, wallet claims, attestations, deposits, withdraw queue with approvals, and immutable receipts.

02

share_hook program

Token-2022 Transfer Hook validator that enforces compliance rules on every share transfer: active entity, valid attestation, and approved destination.

Token Model

Deposit Token: USDC (or mock USDC on localnet/devnet). Users deposit USDC into the vault and receive share tokens representing their claim.

Share Token (rvUSDC): A Token-2022 mint with the Transfer Hook extension enabled. Every transfer is validated by the share_hook program before execution. This means shares cannot be transferred to unregistered wallets even if a user bypasses the UI.