Cap'n Web Rust 구현

Rust로 작성된, Cap'n Web 프로토콜에 대한 완전하고 상용 수준(production-ready)의 구현체입니다. 이 라이브러리는 capability 기반 RPC와 promise pipelining, 그리고 다중 전송 계층(multi-transport) 지원을 제공합니다.

docs.rs

License

주요 기능 (Features)

✅ 완벽한 프로토콜 준수 (Full Protocol Compliance) - Cap'n Web 와이어 프로토콜 전체를 구현합니다.
🔒 Capability 기반 보안 (Capability-Based Security) - 자동 생명주기 관리와 함께 위변조 불가능한 capability 참조를 제공합니다.
🚀 Promise Pipelining - 의존성 해결을 통해 왕복 횟수(round-trips)를 줄입니다.
🌐 다중 전송 계층 (Multi-Transport) - HTTP 배치, WebSocket, WebTransport를 지원합니다.
🛡️ 상용 수준 (Production-Ready) - 패닉이 없는 코드(Zero-panic code), 컨텍스트가 포함된 포괄적인 오류 처리 기능을 갖추고 있습니다.
✅ IL 표현식 평가 (IL Expression Evaluation) - 배열 표기법을 포함하여 완전한 중간 언어(intermediate language) 지원을 제공합니다.
🌍 JavaScript 상호 운용성 (JavaScript Interop) - 공식 TypeScript 구현체와 검증되었습니다.

빠른 시작 (Quick Start)

Cargo.toml에 추가하기

[dependencies]
currentspace-capnweb-server = "0.1.0"
currentspace-capnweb-client = "0.1.0"

서버 예제 (Server Example)

use currentspace_capnweb_server::{Server, ServerConfig, RpcTarget};
use currentspace_capnweb_core::{CapId, RpcError};
use serde_json::{json, Value};
...

클라이언트 예제 (Client Example)

use currentspace_capnweb_client::{Client, ClientConfig};
use currentspace_capnweb_core::CapId;
use serde_json::json;
...

아키텍처 (Architecture)

이 구현체는 다음과 같이 초점에 맞춰진 크레이트(crates)들로 구성되어 있습니다:

아키텍처 (Architecture)

이 구현체는 다음과 같이 초점에 맞춰진 크레이트(crates)들로 구성되어 있습니다:

currentspace-capnweb-core - 핵심 프로토콜 구현 (메시지, IL, 유효성 검사)
currentspace-capnweb-transport - 전송 계층 구현 (HTTP, WebSocket, WebTransport)
currentspace-capnweb-server - 기능 관리(capability management)가 포함된 서버 구현
currentspace-capnweb-client - 사용하기 편리한 레코더 API(recorder API)가 포함된 클라이언트 구현
currentspace-capnweb-interop-tests - JavaScript 상호 운용성 검증

전송 지원 (Transport Support)

HTTP 배치 전송 (HTTP Batch Transport)

use currentspace_capnweb_client::{Client, ClientConfig};

let config = ClientConfig {
...

WebSocket 전송 (WebSocket Transport)

// WebSocket 전송은 구현되어 사용 가능합니다.
// 사용하려면 확립된 WebSocket 연결에서 WebSocketTransport를 생성해야 합니다.
use currentspace_capnweb_transport::WebSocketTransport;
...

WebTransport/HTTP3

use currentspace_capnweb_server::H3Server;

let mut h3_server = H3Server::new(server);
...

고급 기능 (Advanced Features)

Promise 파이프라이닝 (Promise Pipelining)

// Promise 파이프라인 처리는 프로토콜 내부에서 처리됩니다.
// 배치로 여러 호출을 하면 자동으로 최적화됩니다.
let batch = vec![
...

Complex Data Structures

use serde_json::json;

// Build complex JSON structures for RPC calls
...

Error Handling

match client.call(cap_id, "method", args).await {
    Ok(result) => println!("Success: {}", result),
    Err(e) => {
...

Examples

Run the included examples to see the implementation in action:

# Run client examples
cargo run --example basic_client
cargo run --example calculator_client
...

Performance

Run benchmarks to measure performance:

cargo bench --bench protocol_benchmarks

The implementation includes optimizations for:

Concurrent capability execution
Efficient promise dependency resolution
Connection pooling and reuse
Minimal memory allocations

Testing

Comprehensive test suite with tests across all core modules:

# Run all tests
cargo test --workspace

...

JavaScript Interoperability

The Rust implementation is fully compatible with JavaScript Cap'n Web implementations:

✅ Identical message formats and serialization
✅ Compatible IL plan structures
✅ Matching error handling patterns
✅ Shared protocol semantics

Test interoperability:

cargo test --package currentspace-capnweb-interop-tests

Production Deployment

Configuration

use currentspace_capnweb_server::ServerConfig;

let config = ServerConfig {
...

Monitoring

use tracing::{info, warn, error};

// Enable structured logging
...

Security

Use proper TLS certificates for WebTransport
Implement authentication for capability access
Configure appropriate rate limiting
Enable audit logging for capability calls

Contributing

Fork the repository
Create a feature branch
Add tests for new functionality
Ensure all tests pass: cargo test
Run benchmarks: cargo bench
Submit a pull request

Development Standards

Zero panics - No unwrap() in production code, all errors handled explicitly
All code must pass cargo test and cargo clippy
Use latest crate versions unless compatibility requires older versions
Research errors before attempting fixes
Comprehensive documentation for all public APIs
See RUST_CODING_STANDARDS.md for complete guidelines


### 자동 코드 검토 (Automated Code Review)
본 저장소는 자동 PR 검토를 위해 [CodeRabbit](https://coderabbit.ai)을 사용합니다. 이 봇은 다음 작업을 수행합니다:
- 코딩 표준 준수 여부 확인
- 오류 처리 및 성능 개선 사항 제안
- 프로토콜 구현 정확성 검증
- 운영 코드에 `unwrap()` 또는 `panic!`이 없는지 확인

설정은 [`.coderabbit.yaml`](.coderabbit.yaml) 파일에 되어 있습니다. 봇의 제안은 교육적인 목적이며 필수는 아닙니다. 유지 관리자가 최종 결정을 내립니다.

## 라이선스 (License)

다음 중 하나로 라이선스가 부여됩니다:
- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) 또는 http://www.apache.org/licenses/LICENSE-2.0)
- MIT License ([LICENSE-MIT](LICENSE-MIT) 또는 http://opensource.org/licenses/MIT)

선택에 따라 적용됩니다.

## 문서 (Documentation)

### 📚 온라인 문서 (Online Documentation)

- **[API 문서 (GitHub Pages)](https://currentspace.github.io/capn-rs/)** - 모든 크레이트에 대한 전체 API 문서
  - [currentspace-capnweb-core](https://currentspace.github.io/capn-rs/currentspace_capnweb_core/) - 핵심 프로토콜 타입 및 메시지
  - [currentspace-capnweb-transport](https://currentspace.github.io/capn-rs/currentspace_capnweb_transport/) - 전송 구현체
  - [currentspace-capnweb-server](https://currentspace.github.io/capn-rs/currentspace_capnweb_server/) - 서버 기능
  - [currentspace-capnweb-client](https://currentspace.github.io/capn-rs/currentspace_capnweb_client/) - 클라이언트 구현체

- **[docs.rs](https://docs.rs/currentspace-capnweb-core)** - 게시된 크레이트 문서:
  - [currentspace-capnweb-core](https://docs.rs/currentspace-capnweb-core/0.1.0) - 핵심 프로토콜 타입
  - [currentspace-capnweb-transport](https://docs.rs/currentspace-capnweb-transport/0.1.0) - 전송 계층
  - [currentspace-capnweb-server](https://docs.rs/currentspace-capnweb-server/0.1.0) - 서버 구현체
  - [currentspace-capnweb-client](https://docs.rs/currentspace-capnweb-client/0.1.0) - 클라이언트 라이브러리

### 📖 프로젝트 문서 (Project Documentation)

- [Cap'n Web Protocol Specification](spec.md) - 기술 사양서
- [Development Guide](CLAUDE.md) - 기여자 구현 가이드
- [Coding Standards](RUST_CODING_STANDARDS.md) - Rust 코딩 표준 및 모범 사례
- [CodeRabbit Setup](docs/CODERABBIT_SETUP.md) - 자동 코드 검토 설정

### 🔧 로컬 환경에서 빌드 문서 (Building Documentation Locally)
```bash

### 🔧 로컬 환경에서 문서 빌드하기 (Building Documentation Locally)
```bash

# 모든 기능을 사용하여 문서를 빌드합니다
cargo doc --workspace --all-features --no-deps --open

...

📝 문서 커버리지 (Documentation Coverage)

모든 공개 API는 문서화되어 있습니다. 문서 커버리지를 확인하려면 다음 명령어를 사용하세요:

cargo rustdoc -p currentspace-capnweb-core -- -Z unstable-options --show-coverage

로드맵 (Roadmap)

인증서 기반 인증 (Certificate-based authentication)
기능 증명 및 검증 (Capability attestation and verification)
대용량 페이로드를 위한 메시지 압축 (Message compression for large payloads)
실시간 데이터를 위한 스트리밍 기능 (Streaming capabilities for real-time data)
프로토콜 버전 관리 및 진화 (Protocol versioning and evolution)
성능 최적화 및 캐싱 (Performance optimizations and caching)

Rust로 제작되었으며 ❤️. 프로덕션 사용 준비 완료.

Show HN: Cap'n-rs – Cloudflare의 Cap'n Web 프로토콜을 구현한 Rust 라이브러리

요약

핵심 포인트

Cap'n Web Rust 구현

주요 기능 (Features)

빠른 시작 (Quick Start)

Cargo.toml에 추가하기

서버 예제 (Server Example)

클라이언트 예제 (Client Example)

아키텍처 (Architecture)

아키텍처 (Architecture)

전송 지원 (Transport Support)

HTTP 배치 전송 (HTTP Batch Transport)

WebSocket 전송 (WebSocket Transport)

WebTransport/HTTP3

고급 기능 (Advanced Features)

Promise 파이프라이닝 (Promise Pipelining)

Complex Data Structures

Error Handling

Examples

Performance

Testing

JavaScript Interoperability

Production Deployment

Configuration

Monitoring

Security

Contributing

Development Standards

📝 문서 커버리지 (Documentation Coverage)

로드맵 (Roadmap)

댓글

macOS용 현대적인 Jupyter 클라이언트, Satyrn

코딩 어드벤처: 사운드 (그리고 푸리에 변환)

Show HN: Repogather – LLM 코딩 워크플로우를 위해 관련 파일을 클립보드에 복사

PRIscope: 오픈 소스 저장소 코드 변경 이력 분석 도구

macOS용 현대적인 Jupyter 클라이언트, Satyrn

코딩 어드벤처: 사운드 (그리고 푸리에 변환)

Show HN: Repogather – LLM 코딩 워크플로우를 위해 관련 파일을 클립보드에 복사

PRIscope: 오픈 소스 저장소 코드 변경 이력 분석 도구