Skip to content

Signed Immutable Request Protocol - HTTP capsule transport with receipts

License

Notifications You must be signed in to change notification settings

LogLine-Foundation/SIRP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SIRP - Secure Intent Routing Protocol

CI SBOM Geiger License Security

SIRP é um protocolo de cápsulas e sessões, com assinatura criptográfica e roteamento DHT, entregue como overlay compatível com a internet de hoje. Ele convive com TCP/IP por padrão e só promete o que mede. Sem hype — engenharia, números e caminho de adoção real.

Resumo em 1 linha: um transporte moderno, medível e seguro, que roda hoje como overlay e abre rota para migração evolutiva.


Por que SIRP?

  • Compatível por desenho: gateways HTTP ↔ SIRP mostram utilidade sem pedir "tudo ou nada".
  • Integridade e autoria: cada cápsula pode ser autenticada (Ed25519) e hashada (BLAKE3/Keccak), com recibos verificáveis.
  • Roteamento robusto: Kademlia DHT para descoberta e resiliência.
  • Operação honesta: benchmarks antes de claims, RC com CI, SBOM, Geiger e hash publicado.
  • LLM-friendly: schemas JSON, ferramentas e testes para automação/integração por agentes.

Status

  • Release Candidate: v2026.01.04-rc1
  • Golden path documentado: QA, bundle determinístico, assinatura/sha256, SBOM, draft automático.
  • Convivência com IP: foco em overlay SIRP-CP/1.0 (coabita, não rompe).
  • Nunca: prometer "substituir TCP/IP" sem métricas independentes e casos reais.

Get the Release

  1. Baixe o ZIP no GitHub Releases:

  2. Verifique o SHA256:

    shasum -a 256 dist/sirp-unified-2026.01.04-rc1.zip
    # esperado:
    # 47871baa48c6c99d92840160fcf193cece245e10634052a4aeb6db87b2abdf60
  3. (Opcional) Verifique a assinatura minisign, se publicada.

O bundle é determinístico (mesmo conteúdo ⇒ mesmo SHA256), preparado para supply-chain hardening.


Build a partir do código

Pré-requisitos: Rust ≥ 1.70, cargo, python3, make.

# QA rápido em árvore limpa
make qa  # fmt, clippy, tests, audit/deny (não bloqueiam), smoke

# Build do nó
cd packages/sirp-node-with-rfc/sirp-node
cargo build --release

# Testes
cargo test --all

Smoke & Schemas:

# Smoke/validação do bundle
make smoke

# Validação de todos os schemas JSON
python3 scripts/sirp-validate.py --schemas

Métricas: make metrics-smoke existe como no-op por enquanto (gancho para /metrics).


Demo (overlay)

  • HTTP ↔ SIRP Gateways: objetivo é rodar cliente HTTP contra serviços "traduzidos" via SIRP para provar convivência.
  • Targets make demo/make bench-quick virão nos próximos incrementos; o RC traz a infraestrutura, testes e validadores prontos.

Arquitetura (mapa rápido)

packages/sirp-node-with-rfc/sirp-node/
  ├─ src/tal/        # Trait de Abstração de Transporte + drivers
  ├─ src/capsule/    # Wire format, hashing e assinatura
  ├─ src/session/    # Streams, handshakes e recibos
  ├─ src/dht/        # Roteamento (Kademlia-like)
  ├─ src/gateway/    # Tradução HTTP ↔ SIRP
  ├─ src/node/       # Daemon, observabilidade e métricas
  ├─ tests/          # Unit + integração (smoke/LLM)
  ├─ Cargo.toml
  └─ README.md

Pilares técnicos

  • Cápsulas SIRP-CP/1.0: cabeçalhos mínimos, payload autenticável, envelope verificável.
  • Criptografia: Ed25519 (assinaturas) + BLAKE3/Keccak para hashing (pluggable).
  • Recibos: estrutura JSON com hash/assinatura para trilha de auditoria e assentamento econômico futuro.
  • DHT: descoberta + resiliência sem ponto único.
  • Gateways: garantem adoção progressiva e casos reais cedo.

Especificação & RFCs

  • Problem Statement
  • Architecture (TAL + drivers)
  • Protocol Specification (wire format)
  • Security Analysis
  • Performance Evaluation (medido, não alegado)
  • Deployment Strategy (overlay → ilha → peering)
  • Comparison (TCP/IP, Tor, I2P — honesto)
  • Future Work (L2 substrate, zero-knowledge routing, HW accel)

Veja a pasta RFC/ e os documentos de protocolo na árvore do repositório.


Segurança & Proveniência

  • CI/CD: validação no tag v*, draft release automático.
  • SBOM: gerado via cargo-about e anexado ao release.
  • Geiger: inventário de unsafe Rust.
  • Determinismo: SOURCE_DATE_EPOCH, zip -X, timestamps fixos.
  • Políticas: HARDENING.md e SECURITY.md com processo de reporte, SLA e melhores práticas.

LLM-friendly (pronto para agentes)

  • Schemas JSON versionados para cápsulas/recibos/diagnóstico.
  • Ferramentas: scripts e testes para rodar validação autônoma (make llm-check).
  • Guia: INTEGRATION.md mostra como agentes podem operar SIRP (lint/validate/prepare/run).

Roadmap 2026

Q1 — Agora

  • SIRP-CP/1.0 (overlay) • Gateways HTTP ↔ SIRP • Métricas/benchmarks honestos • Publicação RCs

Q2–Q3

  • Ilha SIRP interna (backbone raw-UDP) • Peering multi-org • Recibos UBL para assentamento econômico

Q4+

  • Substrato L2 experimental • Zero-knowledge routing • Aceleração (XDP/DPDK)

Nunca

  • Prometer "substituir TCP/IP" ou declarar vitória sem dados independentes

Contribuir

  • Leia CONTRIBUTING.md, veja o RC_CHECKLIST.md e abra uma issue usando os templates.
  • CODEOWNERS configurado; use PRs pequenos e testáveis.
  • Objetivo: cada incremento precisa melhorar medição, segurança ou adoção — sem regressões.

Licenciamento & Segurança


Contato


TL;DR para começar

# QA rápido
make qa

# Validar schemas
python3 scripts/sirp-validate.py --schemas

# Build do nó
cd packages/sirp-node-with-rfc/sirp-node && cargo build --release

Quando publicar RC: gere o ZIP determinístico, confira o SHA256, empurre o tag e anexe artefatos ao draft. Tudo documentado em PUBLISH_RC.md e automatizado por scripts/sirp-release-secure.sh.


Quick Reference

Comando Descrição
make qa Quality assurance completo (fmt, clippy, tests, smoke)
make smoke Validação estrutural do bundle
make list Lista pacotes, specs e docs
make meta Exibe sirp.meta.json formatado
make llm Helper de integração LLM (dry-run)
make metrics-smoke Verifica endpoint /metrics (no-op para skeleton)
./scripts/sirp-validate.py --schemas Valida todos os schemas JSON
./scripts/sirp-bundle.sh Cria bundle ZIP determinístico
./scripts/sirp-release-secure.sh [VERSION] Release seguro com assinaturas

Última atualização: 2026-01-04 (RC v2026.01.04-rc1)

About

Signed Immutable Request Protocol - HTTP capsule transport with receipts

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published