# Introduction

## Giggle IPOS: Technical Overview

Giggle IPOS (Intellectual Property Operating System) is a blockchain-enabled platform for IP management, tokenization, and distribution. The platform's architecture enables developers to create extensions that enhance how IP holders engage with their audiences and monetize their assets.

### Core Architecture

* **IP Asset Layer**: Secure blockchain infrastructure for registering and validating intellectual property assets
* **Tokenization Engine**: ERC-standard implementation for converting IP into tradable tokens with configurable ownership and revenue models
* **Portal Framework**: Customizable frontend system that renders IP content and widget extensions
* **Widget Subscription System**: Marketplace for IP holders to discover and subscribe to third-party extensions

### Widget Technical Implementatio

{% @mermaid/diagram content="flowchart TB
subgraph "IP Portal"
IPContent\["IP Content Layer"]

```
    subgraph "Widget System"
        Widget["Widget (iframe)"]
        WidgetAPI["Widget API Client"]
    end
    
    IPContent --- Widget
end

subgraph "Platform Services"
    Auth["Authentication Service"]
    APIGateway["API Gateway"]
    PermissionSystem["Permission Controller"]
    SubscriptionManager["Subscription Manager"]
end

subgraph "Developer Infrastructure"
    WidgetURL["Widget URL Endpoint"]
    ManagementURL["Management URL Endpoint"]
end

Widget <-- "PostMessage JWT" --> Auth
WidgetAPI <-- "API Requests with JWT" --> APIGateway
APIGateway --> PermissionSystem
SubscriptionManager --> PermissionSystem
Widget <-- "Renders" --> WidgetURL
IPContent <-- "Configures" --> ManagementURL

class Widget,WidgetAPI,WidgetURL,ManagementURL accent;
classDef accent fill:#6366f1,color:white,stroke:#4f46e5;" %}
```

* **Widget URL**: Public endpoint that renders the widget interface to users
* **Management URL**: Administrative interface for IP holders to configure widget parameters
* **Authentication**: JWT token delivery via PostMessage API
* **Permissions**: Granular access control system based on declared widget requirements

#### Subscription Flow

{% @mermaid/diagram content="sequenceDiagram
participant IPHolder as IP Holder
participant Marketplace as Widget Marketplace
participant Developer as Widget Developer
participant Portal as IP Portal
participant Widget as Widget Instance
participant API as Platform API

```
IPHolder->>Marketplace: Browse available widgets
Marketplace->>IPHolder: Display widget options
IPHolder->>Marketplace: Subscribe to widget
Marketplace->>Developer: Notify of new subscription
Marketplace->>Portal: Activate widget for IP holder

Note over Portal,Widget: When portal loads

Portal->>Widget: Load widget iframe
Widget->>Portal: Request authentication
Portal->>Widget: Send JWT via PostMessage
Widget->>API: Make API calls with JWT
API->>Widget: Return permitted data

Note over IPHolder,Widget: Ongoing usage

IPHolder->>Widget: Interact with widget
Widget->>API: Request IP-specific data
API->>Widget: Return data based on permissions" %}
```

### Authentication Flow

1. IP holder subscribes to a widget
2. Widget iframe loads within portal for subscribed IP holders
3. Platform sends JWT token via PostMessage
4. Widget uses token to authenticate API requests
5. Access restricted based on declared permissions and subscription tier

### API Integration Points

#### Development Workflow

1. Register as a developer
2. Declare widget permissions, endpoints, and subscription tiers
3. Develop widget and management interfaces
4. Submit for approval
5. Distribute to IP holders through the widget marketplace
6. Manage active subscriptions and updates

#### Technology Stack

The platform is built on modern web technologies with blockchain integration:

* **Frontend**: React/Next.js framework with server and client components
* **Authentication**: JWT-based secure token system
* **Blockchain**: EVM-compatible smart contracts for token operations
* **API**: RESTful endpoints with GraphQL support for complex data queries
* **Subscription**: Recurring payment infrastructure with blockchain integration

Developers can create widgets using any frontend framework that can be served via URL and communicate through standard PostMessage API patterns, while managing subscriptions through our developer portal.