# Token Lifecycle

From bond issuance to redemption, every stage of the token lifecycle is managed through the master ledger on Internet Computer.

# Lifecycle Overview

flowchart LR
    A[Minting] --> B[Distribution]
    B --> C[Yields]
    C --> D[Trading]
    D --> C
    C --> E[Redemption]

# Stages

# Minting

Tokens are created on the Internet Computer master ledger with full bond metadata and compliance rules.

# Distribution

KYC-verified investors receive tokens on their preferred blockchain via Chain Fusion.

# Yields

Periodic coupon payments distributed to token holders based on bond terms.

# Redemption

At maturity, tokens are burned and principal is returned to holders.

# Lifecycle States

stateDiagram-v2
    [*] --> Pending: Bond Created
    Pending --> Active: Tokens Minted
    Active --> Active: Yields Paid
    Active --> Maturing: Approaching Maturity
    Maturing --> Redeemed: Principal Paid
    Redeemed --> [*]: Tokens Burned

    Active --> Suspended: Compliance Issue
    Suspended --> Active: Issue Resolved

State	Description
Pending	Bond structured, awaiting tokenization
Active	Tokens minted and tradeable
Maturing	Within 30 days of maturity
Suspended	Trading halted (compliance)
Redeemed	Principal paid, tokens burned

# Timeline Example

gantt
    title Bond Token Lifecycle (3-Year Bond)
    dateFormat YYYY-MM-DD

    section Issuance
    Due Diligence       :done, 2024-01-01, 30d
    Bond Structuring    :done, 2024-01-15, 30d
    ISIN Assignment     :done, 2024-02-01, 14d
    Token Minting       :done, 2024-02-15, 7d

    section Active Period
    Distribution        :active, 2024-02-22, 60d
    Year 1 Coupon       :milestone, 2025-02-22, 0d
    Year 2 Coupon       :milestone, 2026-02-22, 0d
    Year 3 Coupon       :milestone, 2027-02-22, 0d

    section Redemption
    Maturity Notice     :2027-01-22, 30d
    Redemption          :2027-02-22, 14d

# Data Flow

flowchart TB
    subgraph Issuance
        ASSET[Real Estate] --> BOND[Bond Structure]
        BOND --> ISIN[ISIN]
    end

    subgraph On-Chain
        ISIN --> MINT[Mint on ICP]
        MINT --> DIST[Distribute]
        DIST --> HOLD[Holdings]
        HOLD --> YIELD[Yield Payments]
        HOLD --> TRADE[Trading]
        TRADE --> HOLD
        HOLD --> REDEEM[Redemption]
        REDEEM --> BURN[Burn]
    end

    subgraph Off-Chain
        YIELD --> BANK1[Bank Settlement]
        REDEEM --> BANK2[Bank Settlement]
    end

# Key Participants

Participant	Role
Issuer	Creates bonds, triggers yields, handles redemption
Investor	Purchases tokens, receives yields, redeems at maturity
Master Ledger	Tracks ownership, enforces compliance
Chain Fusion	Enables cross-chain token representation
KYC Registry	Verifies investor identity