# baala-codes/solana-fall-vault architecture

> Architecture diagram of the GitHub repository baala-codes/solana-fall-vault, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/baala-codes/solana-fall-vault
- Repository: https://github.com/baala-codes/solana-fall-vault

## Overview

Lamports Vault is a small Anchor Solana program for per-user lamport vaults. A caller invokes the program’s initialize, deposit, withdraw, or close instruction; handlers validate PDA accounts and use the System Program for transfers. Initialization also records PDA bumps, while closing returns vault lamports and closes the state account. The source excerpts show these handlers and dispatch; client-side callers and deployment details are not shown.

Main entry points: [`programs/lamports-vault/src/lib.rs`](https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/lib.rs) (Vault Program), [`programs/lamports-vault/src/instructions/initialize.rs`](https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/instructions/initialize.rs) (Initialize), [`programs/lamports-vault/src/instructions/withdraw.rs`](https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/instructions/withdraw.rs) (Withdraw), [`programs/lamports-vault/src/instructions/close.rs`](https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/instructions/close.rs) (Close)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_caller(("Caller"))
node_program["Vault Program<br/>[lib.rs]"]
node_initialize["Initialize<br/>[initialize.rs]"]
node_deposit["Deposit<br/>[deposit.rs]"]
node_withdraw["Withdraw<br/>[withdraw.rs]"]
node_close["Close<br/>[close.rs]"]
node_vault[("Vault PDA<br/>[initialize.rs]")]
node_state[("Vault State<br/>[vault_state.rs]")]
node_system["System Program"]

node_caller -->|"invokes"| node_program
node_program -->|"dispatches"| node_initialize
node_program -->|"dispatches"| node_deposit
node_program -->|"dispatches"| node_withdraw
node_program -->|"dispatches"| node_close
node_initialize -->|"transfers rent"| node_system
node_initialize -->|"stores bumps"| node_state
node_initialize -->|"funds"| node_vault
node_deposit -->|"transfers lamports"| node_system
node_system -->|"credits"| node_vault
node_withdraw -->|"transfers lamports"| node_system
node_withdraw -->|"reads bump"| node_state
node_system -->|"pays withdrawal"| node_caller
node_close -->|"transfers balance"| node_system
node_close -->|"closes account"| node_state
node_system -->|"returns balance"| node_caller

click node_program "https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/lib.rs"
click node_initialize "https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/instructions/initialize.rs"
click node_deposit "https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/instructions/deposit.rs"
click node_withdraw "https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/instructions/withdraw.rs"
click node_close "https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/instructions/close.rs"
click node_vault "https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/instructions/initialize.rs"
click node_state "https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/state/vault_state.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_caller,node_system toneIndigo
class node_program,node_initialize,node_deposit,node_withdraw,node_close toneTeal
class node_vault,node_state toneAmber
```

## Components

### Other components

- **Caller**
- [Vault Program](https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/lib.rs): `programs/lamports-vault/src/lib.rs`
- [Initialize](https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/instructions/initialize.rs): `programs/lamports-vault/src/instructions/initialize.rs`
- [Deposit](https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/instructions/deposit.rs): `programs/lamports-vault/src/instructions/deposit.rs`
- [Withdraw](https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/instructions/withdraw.rs): `programs/lamports-vault/src/instructions/withdraw.rs`
- [Close](https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/instructions/close.rs): `programs/lamports-vault/src/instructions/close.rs`
- [Vault PDA](https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/instructions/initialize.rs): `programs/lamports-vault/src/instructions/initialize.rs`
- [Vault State](https://github.com/baala-codes/solana-fall-vault/blob/main/programs/lamports-vault/src/state/vault_state.rs): `programs/lamports-vault/src/state/vault_state.rs`
- **System Program**

## Connections

- Caller → Vault Program: invokes (evidence: `programs/lamports-vault/src/lib.rs`)
- Vault Program → Initialize: dispatches (evidence: `programs/lamports-vault/src/lib.rs`)
- Vault Program → Deposit: dispatches (evidence: `programs/lamports-vault/src/lib.rs`)
- Vault Program → Withdraw: dispatches (evidence: `programs/lamports-vault/src/lib.rs`)
- Vault Program → Close: dispatches (evidence: `programs/lamports-vault/src/lib.rs`)
- Initialize → System Program: transfers rent (evidence: `programs/lamports-vault/src/instructions/initialize.rs`)
- Initialize → Vault State: stores bumps (evidence: `programs/lamports-vault/src/instructions/initialize.rs`)
- Initialize → Vault PDA: funds (evidence: `programs/lamports-vault/src/instructions/initialize.rs`)
- Deposit → System Program: transfers lamports (evidence: `programs/lamports-vault/src/instructions/deposit.rs`)
- System Program → Vault PDA: credits
- Withdraw → System Program: transfers lamports (evidence: `programs/lamports-vault/src/instructions/withdraw.rs`)
- Withdraw → Vault State: reads bump (evidence: `programs/lamports-vault/src/instructions/withdraw.rs`)
- System Program → Caller: pays withdrawal
- Close → System Program: transfers balance (evidence: `programs/lamports-vault/src/instructions/close.rs`)
- Close → Vault State: closes account (evidence: `programs/lamports-vault/src/instructions/close.rs`)
- System Program → Caller: returns balance
