Os detalhes técnicos, documentos legais e alguns processos de conta continuam em inglês.
Comece com o protocolo de linguagem e grafo que seu aplicativo já usa.
Crie uma sessão com um Passkey ou carteira EIP-4361 SIWE. O Kotobase então emite um Biscuit de curta duração restrito a um único locatário, grafo, titular, expiração e conjunto de permissões.
A credencial principal da API é um Biscuit de curta duração emitido somente após autenticação Passkey ou SIWE. Solicite-o para o grafo e permissões exatas que você precisa:
POST https://auth.kotobase.net/v1/biscuit/token
{"tenantId":"...","graph":"...","permissions":["data:write"]}
Use o valor completo de autorização retornado pelo endpoint:
Authorization: Biscuit <token>
Credenciais CACAO e Bearer opacas permanecem caminhos de compatibilidade apenas para migração.
Passe o valor de autorização retornado diretamente para o SDK TypeScript, Python ou PHP:
export KOTOBASE_TOKEN="Biscuit ..." && kotobase account-status
Um Biscuit rejeitado nunca é tentado novamente como CACAO ou Bearer.
Instale o CLI em um comando:
curl -fsSL https://kotobase.net/install.sh | sh
Ele precisa de babashka e escreve apenas no seu próprio ~/.local.
Clientes TypeScript, Python e PHP compartilham um contrato único de transporte e autenticação.
Datomic Client API, SPARQL (incluindo compatibilidade com caminho HTTP RDF4J), Cypher, Gremlin e GraphQL são monitorados por descoberta explícita de capacidade e testes de conformidade.
Use o endpoint MCP em
https://kotobase.net/mcp
contra o mesmo grafo do locatário, ou execute
kotobase mcp
para emitir a configuração do cliente.
Importe ou sincronize bidirecionalmente um cofre Obsidian preservando Markdown, frontmatter e [[wikilinks]].
Ayatori é a composição do plano de consulta que transforma a descoberta de provedores e blocos IPLD imutáveis em uma projeção persistente e consultável.
IPNI discovery → provider block fetch → CID verification → required Arrangement ranges → persistent cursor → Datalog
A descoberta é apenas uma dica de provedor. Ayatori não a trata como prova de recuperação, validade de CID ou execução de consulta.
Em 30 de agosto de 2026, o caminho de solicitação de consulta de produção compartilhado kotobase.net é composto em ayatori.query, e o nome do bloqueio do componente de produção é ayatori.
Essa é uma mudança de qual repositório serve a produção, não do que ele computa: ayatori.query é um namespace alias sobre a mesma ponte. A descoberta de provedores IPNI e leituras remotas verificadas de blocos ainda não são realizadas no caminho de solicitação.
| Biblioteca | Responsabilidade | Relação direta | Status |
|---|---|---|---|
| ayatori | Coordena descoberta, leituras remotas verificadas, cursores persistentes e materialização de consultas. | Usa io-ipni-specs, io-ipld, arrangement e kotobase. | No caminho de solicitação de produção; seus planos de descoberta e leitura remota não estão |
| io-ipni-specs | Analisa anúncios IPNI e resultados de provedores de roteamento delegado. | Retorna candidatos a provedores; não busca nem verifica blocos. | Dependência do Ayatori |
| io-ipld | Codifica e decodifica links IPLD e verifica blocos contra CIDs solicitados. | Usado por Ayatori e a pilha de índice persistente. | Dependência do componente de produção |
| arrangement | Persiste quatro índices abrangentes como snapshots endereçados por CID e expõe leituras de cursores. | Usa prolly-tree, datom-source e datalog. | Dependência do componente de produção |
| prolly-tree | Armazena nós de índice ordenados como blocos DAG-CBOR endereçados por conteúdo. | Fornece busca, varredura por prefixo e varredura por intervalo para arrangement. | Dependência do componente de produção |
| datom-source | Define o contrato do cursor de padrão neutro em armazenamento usado por caminhos de consulta. | Separa a avaliação da consulta de uma implementação específica de armazenamento. | Dependência do componente de produção |
| datalog | Avalia Datalog sobre quatro índices abrangentes; não possui armazenamento ou E/S de rede. | Consome fontes de datom e índices fornecidos pelo chamador. | Dependência do componente de produção |
| kotobase-query | Ponte de compatibilidade da loja plana Kotobase para materialização Datalog. | Seus dois namespaces são transportados por ayatori, então chamadores que ainda os nomeiam continuam resolvendo. | Substituído; os mesmos namespaces agora são fornecidos pelo ayatori |
Rótulos de status descrevem os componentes compartilhados de consulta de produção inspecionados em 30 de agosto de 2026. Um pin de fonte ou benchmark aprovado não prova por si só que uma biblioteca atende a solicitações de produção.