# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kaisign.gitbook.io/kaisign/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.