> For the complete documentation index, see [llms.txt](https://kaisign.gitbook.io/kaisign/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kaisign.gitbook.io/kaisign/readme.md).

# Kai-Sign

Welcome to Kai-Sign, the decentralized platform for creating, verifying, and distributing **ERC7730 metadata** for blockchain clear signing. Transform cryptic transaction bytecode into human-readable information that users can understand and verify.

## What is Kai-Sign?

Kai-Sign enables **clear signing** for blockchain transactions by providing:

* **Visual ERC7730 Builder** - Create metadata with drag-and-drop interface
* **Hardware Wallet Preview** - Test how transactions display on Ledger devices
* **Community Verification** - Decentralized validation through optimistic oracle

## Quick Links

| Resource                                                  | Description                              |
| --------------------------------------------------------- | ---------------------------------------- |
| [**Quickstart**](/kaisign/getting-started/quickstart.md)  | Create your first metadata in 15 minutes |
| [**Core Concepts**](/kaisign/getting-started/concepts.md) | Understand ERC7730 and clear signing     |
| [**Builder Tool**](https://beta.kaisign.xyz)              | Start creating metadata now              |

## The Problem: Blind Signing

When you approve blockchain transactions, you typically see cryptic bytecode:

```
0xa9059cbb000000000000000000000000a1371748d65baef4509a3c067b3fe3a1b79183ae000000000000000000000000000000000000000000000000000000001f143c37
```

This forces users to **blind sign** transactions, creating security vulnerabilities and poor user experiences.

## The Solution: Clear Signing

Kai-Sign transforms that bytecode into clear, verifiable information:

```
Transfer Tokens
├─ To: vitalik.eth (0xa137...83ae)
├─ Amount: 521.99 USDC
└─ Network: Ethereum Mainnet
```

## How It Works

### 1. Create Metadata

Use our visual builder to map contract functions to human-readable descriptions following the [ERC7730 standard](https://eips.ethereum.org/EIPS/eip-7730).

### 2. Community Verification

Submit metadata for decentralized verification through an optimistic oracle with economic incentives for accuracy.

### 3. Hardware Integration

Verified metadata automatically works with supported hardware wallets for secure clear signing.

## Architecture

Kai-Sign consists of several integrated components:

```
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Frontend      │    │   Backend API   │    │  Blockchain     │
│   Builder       │◄──►│   Services      │◄──►│  (Ethereum)     │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│ Hardware Wallet │    │   Kai-Sign      │    │   Blob          │
│   Integration   │    │      API        │    │   Storage       │
└─────────────────┘    └─────────────────┘    └─────────────────┘
```

* **Frontend**: Visual metadata builder and hardware wallet simulator
* **Backend**: API services and blockchain integration
* **Smart Contracts**: On-chain metadata registry and verification
* **Verification**: Optimistic oracle with bond escalation
* **Storage**: Decentralized metadata storage

## Getting Started

### For Developers

1. [**Installation Guide**](/kaisign/developers/installation.md) - Set up the development environment
2. [**Quickstart Tutorial**](/kaisign/getting-started/quickstart.md) - Create your first metadata
3. [**Core Concepts**](/kaisign/getting-started/concepts.md) - Learn ERC7730 fundamentals
4. [**API Documentation**](/kaisign/developers/overview.md) - Integrate with Kai-Sign services

### For Users

1. [**Build Metadata**](/kaisign/using-kai-sign/build-clear-sign-metadata.md) - Create clear signing specs
2. [**Verify Metadata**](/kaisign/using-kai-sign/publish-your-docs.md) - Submit for community verification
3. [**Hardware Integration**](/kaisign/features/hardware-viewer.md) - Test with hardware wallets

## Key Features

### 🛠️ **ERC7730 Builder**

* Visual interface for creating metadata

### 🔐 **Decentralized Verification**

* Economic incentives for accurate verification

### 🌐 **Decentralized Storage**

* Ethereum blob transactions for large files

## License

This project is licensed under the Apache License 2.0.

***

**Ready to start?** Follow our [Quickstart Guide](/kaisign/getting-started/quickstart.md) to create your first ERC7730 metadata in 15 minutes.