# tcip-rep-proto

**Repository Path**: tcip-rep/tcip-rep-proto

## Basic Information

- **Project Name**: tcip-rep-proto
- **Description**: tcip-rep-proto
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-04-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tcip-rep-proto

TCIP-REP 协议层模块，包含所有跨链协议的 Protobuf 定义，并同时生成：
- **Java 类**（gRPC 服务接口与消息）
- **Scala 类**（RepChain 合约调用）

## 模块结构

```
src/main/
├── proto/              # Protobuf 定义文件
│   ├── api/
│   │   ├── rpc_cross_chain.proto     # 跨链 gRPC 服务
│   │   └── rpc_relay_chain.proto     # 中继链 gRPC 服务
│   └── common/
│       ├── common.proto              # 公共数据结构
│       ├── cross_chain/
│       │   ├── request.proto
│       │   └── response.proto
│       └── relay_chain/
│           ├── request.proto
│           └── response.proto
├── java/               # 生成的 Java gRPC 代码
└── scala/              # 生成的 Scala ScalaPB 代码
```

## 依赖

- Java 11+
- Maven 3.6+
- gRPC / Protobuf
- ScalaPB（Scala Protocol Buffers 运行时）

## 构建步骤

### 日常编译（不重新生成代码）

生成的 Java/Scala 代码已提交至 Git，日常只需编译：

```bash
mvn compile -Dscalapbc.skip=true
```

### 重新生成 Protobuf 代码（修改 .proto 后执行）

修改 `src/main/proto/` 下的任意 `.proto` 文件后，需重新生成 Java 和 Scala 代码：

```bash
# Windows
mvn compile -Dscalapbc.skip=false

# Linux / macOS
mvn compile -Dscalapbc.skip=false
```

生成结果输出到：
- `src/main/java/` — Java gRPC Stub 和 Protobuf 消息类
- `src/main/scala/` — Scala ScalaPB 类（供 RepChain 合约使用）

### 安装到本地 Maven 仓库（其他模块依赖此模块时执行）

```bash
mvn install -Dscalapbc.skip=true -DskipTests
```

## 版本

`2.0.0-SNAPSHOT`

## 所属项目

[tcip-rep](https://gitee.com/tcip-rep) — 跨链互操作协议 RepChain 实现