Rapport Oracle

Um oráculo genérico, multi-chain e auditável

O Rapport Oracle conecta smart contracts a dados do mundo real. No modelo Oraclize/Provable, o contrato consumidor emite uma query, o middleware em Cloudflare Workers busca o dado em fontes externas e devolve o resultado on-chain por callback assinado — com prova criptográfica verificável pelo próprio contrato. Um único workspace integra três ecossistemas: EVM/Polygon (Solidity), Solana (Anchor) e Stellar (Soroban).

Ver a arquitetura

Capacidades

Multi-chain nativo

Conectores on-chain para EVM/Polygon (Solidity), Solana (Anchor) e Stellar (Soroban), com a mesma API de query.

Modelo Provable

Query emitida por evento on-chain, resolvida off-chain e devolvida por __callback assinado pelo relayer.

Provas criptográficas

ECDSA na EVM e ed25519 na Solana e Stellar — o consumidor valida o cbAddress e a assinatura on-chain.

Edge computing

Middleware em Cloudflare Workers com cron de 1 minuto, estado em KV e DSL json(url).path para extrair dados.

Arquitetura

Ciclo de vida de uma query, do evento on-chain ao callback assinado.

[Consumidor] --query--> [Conector on-chain] --LogNewQuery/evento--> [Worker cron]
     ^                                                              |
     |                                                              v
     |                                                    fetch URL + extrai path
     |                                                              |
     +------------------- __callback(rqid, result, proof) <----------+
                          (tx assinada pelo relayer/cbAddress)

Conectores on-chain

Contratos e programas que recebem query(delay, datasource, arg), emitem o evento e validam o callback. Bibliotecas prontas para desenvolvedores em Solidity, Anchor e Soroban.

Middleware off-chain

Worker Cloudflare que faz polling dos logs a cada minuto, resolve a datasource "URL" com cap de tamanho e timeout, e deduplica queries via KV.

Relayer + prova

O relayer assina keccak256(qid, result, consumer) e envia a transação de callback. O consumidor confirma a origem verificando cbAddress e a prova.

Limites da v1: datasource "URL" apenas, até 3 tentativas por query e delay com granularidade de ~1 min. TLSNotary/zk proof estão no roadmap.

Módulos do Projeto

Cada módulo é um repositório independente, integrado ao workspace como git submodule.

Middleware — Cloudflare Worker

Worker Cloudflare que intermedeia requisições de oracle entre smart contracts e fontes de dados externas, no modelo Oraclize/Provable.

Smart Contracts

Conectores on-chain do oracle para EVM/Polygon, Solana e Stellar, com bibliotecas para desenvolvedores e exemplos de consumidores.

Workspace

Repositório raiz que integra os módulos do Rapport Oracle como git submodules, com regras de engenharia e utilitários locais.

Exemplos de Uso

Contratos consumidores completos, passo a passo, em Solidity, Anchor e Soroban.

EVM — Preço ETH/USD

O exemplo canônico: um contrato Solidity que agenda uma consulta ao preço ETH/USD e recebe o resultado via callback assinado.

EVM — Múltiplas Consultas

Como emitir várias queries de uma vez e despachar cada resposta ao seu propósito usando o rqid como chave.

Solana — Anchor + CPI

Programa Anchor que agenda uma query no oracle via CPI e valida o callback com a cb_authority lida da PDA de config.

Stellar — Soroban (Rust)

Contrato Soroban no_std que agenda a query no conector e valida o callback com require_cb_address da lib.

Apoie o Projeto — Doação via Pix

O Rapport Oracle é mantido de forma independente. Se o projeto é útil para você, apoie com uma doação via Pix: todo o valor obtido é utilizado para manter as APIs de resposta e custear os servidores.

Chave Pix (CNPJ):
67.904.299/0001-80

Recebedor:
Rapport Tecnologia

Mensagem embutida no QR:
DOACAO APIS E SERVIDORES RAPPORT ORACLE

Valor livre — também é possível doar usando a chave Pix diretamente no app do seu banco.

Pix copia e cola

00020101021126790014br.gov.bcb.pix0114679042990001800239DOACAO APIS E SERVIDORES RAPPORT ORACLE5204000053039865802BR5918RAPPORT TECNOLOGIA6009FORTALEZA62230519DOACAORAPPORTORACLE63044FBA

Vamos Começar!

Entre em contato conosco através de um dos seguintes canais:

admin@rapport.tec.br

github.com/rapporttecnologia

WhatsApp: (+55 85) 98520-5490