# web3trust/integration architecture

> Architecture diagram of the GitHub repository web3trust/integration, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/web3trust/integration
- Repository: https://github.com/web3trust/integration

## Overview

##### Project type and purpose
- From the file tree and README, this is a small Python-based integration/tooling project. It provides CLI scripts to automate “FB deposit wallet” creation, quarantine wallet creation, and fund movement between deposit and quarantine wallets. There is no frontend or datastore—just automation scripts interfacing with an external API or service (presumably the “FB” wallet service).

##### File structure
- Top-level scripts:
- auto_create_FB_deposit_wallet.py
- create_FB_deposit_wallet.py
- create_FB_quarantine_wallet.py
- mv_funds_deposit_quarantine.py
- Documentation directories:
- docs_auto_create_deposit_wallet
- docs_mv_funds_deposit_quarantine
- No src/ or lib/ subfolders—these are standalone scripts. No tests folder. No config files shown (likely environment variables or a .env file not checked in).

##### README for additional insights
- README only states “# integration,” confirming this is an integration/tooling repository.

- Use clear labels for:
- “Script: create_FB_deposit_wallet.py”
- “Script: auto_create_FB_deposit_wallet.py (Scheduler)”
- “Script: create_FB_quarantine_wallet.py”
- “Script: mv_funds_deposit_quarantine.py”
- “External Wallet Service API”
- “Logging & Monitoring”
- Scheduler → auto_create_FB_deposit_wallet.py
- auto_create_FB_deposit_wallet.py → create_FB_deposit_wallet.py
- Each script → External Wallet Service API (bidirectional for request/response)
- Each script → Logging & Monitoring

## Diagram (Mermaid)

```mermaid
graph TD
    %% Scheduler/Orchestrator
    subgraph "Scheduler/Orchestrator"
        Scheduler["cron / CI Pipeline"]:::scheduler
        AutoScript["Script: auto_create_FB_deposit_wallet.py"]:::script
    end

    %% Core Scripts
    subgraph "Core CLI Scripts"
        DepositScript["Script: create_FB_deposit_wallet.py"]:::script
        QuarantineScript["Script: create_FB_quarantine_wallet.py"]:::script
        MoveFundsScript["Script: mv_funds_deposit_quarantine.py"]:::script
    end

    %% External Systems
    ExternalAPI[(External Wallet Service API)]:::external
    Logging["Logging & Monitoring"]:::logging

    %% Documentation
    subgraph "Documentation"
        DocsAuto["Auto-create deposit wallet instructions"]:::docs
        DocsMove["Move funds deposit → quarantine instructions"]:::docs
    end

    %% Relationships
    Scheduler --> AutoScript
    AutoScript -->|"invokes"| DepositScript

    DepositScript -->|HTTP Request/Response| ExternalAPI
    QuarantineScript -->|HTTP Request/Response| ExternalAPI
    MoveFundsScript -->|HTTP Request/Response| ExternalAPI

    DepositScript -->|logs events| Logging
    AutoScript -->|logs events| Logging
    QuarantineScript -->|logs events| Logging
    MoveFundsScript -->|logs events| Logging

    %% Click Events
    click AutoScript "https://github.com/web3trust/integration/blob/main/auto_create_FB_deposit_wallet.py"
    click DepositScript "https://github.com/web3trust/integration/blob/main/create_FB_deposit_wallet.py"
    click QuarantineScript "https://github.com/web3trust/integration/blob/main/create_FB_quarantine_wallet.py"
    click MoveFundsScript "https://github.com/web3trust/integration/blob/main/mv_funds_deposit_quarantine.py"
    click DocsAuto "https://github.com/web3trust/integration/tree/main/docs_auto_create_deposit_wallet"
    click DocsMove "https://github.com/web3trust/integration/tree/main/docs_mv_funds_deposit_quarantine"

    %% Styles
    classDef script fill:#ADD8E6,stroke:#333,stroke-width:1px;
    classDef scheduler fill:#F4A460,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5;
    classDef external fill:#90EE90,stroke:#333,stroke-width:1px;
    classDef logging fill:#D3D3D3,stroke:#333,stroke-width:1px,stroke-dasharray: 2 2;
    classDef docs fill:#FFEFD5,stroke:#333,stroke-width:1px,stroke-dasharray: 2 2;
```
