Intramedial è in beta ristretta. Alla registrazione o all’accesso devi fornire la password da beta tester che hai ricevuto oppure richiederne una a preview@intramedial.com. Grazie.
Caricamento…
civics.recordsModulo 48
Modulo della piattaforma
Public records search
Chiedi al registro cosa è successo a una risorsa, o leggi chiaramente gli eventi del workspace, oscurati a ciò che il tuo permesso consente davvero.
civics.records è una finestra pubblica sottile sul ledger: con una resource delega alla stessa logica di blame di ledger.blame, e senza elenca gli eventi. Un chiamante con records.export vede ogni campo; tutti gli altri ricevono i campi handle di testimone rimossi prima che la risposta lasci la piattaforma.
Intralock · Lease · Parley · Fleet Map
Un prodotto Trustvice
Gli agenti agiscono quando il piano dice sì, e il registro dice perché.
Fai passare da Intramedial azioni di agenti, hash di contenuti, controlli API, lookup DNS, webhook, chiamate LLM e commit git. Ricevi una ricevuta firmata che chiunque verifica, senza fidarsi di noi.
Stato“Filtra ogni evento” esagera la superficie reale
L’unico filtro è resource; qui non ci sono filtri per attore, tipo o intervallo di date. Un filtro più fine va fatto lato client, o chiamando direttamente le azioni ledger.blame/ledger.list con i filtri che supportano.
Registro
Il registro
Cosa viene registrato
resource
Il filtro opzionale; se fornito, restringe alla storia di quella risorsa.
projection
"records" per l’elenco non filtrato, o "blame" quando è stata data una resource.
public o operator, deciso dai permessi del chiamante, mai da un campo della richiesta.
events
Gli eventi corrispondenti, ciascuno con i campi handle di testimone rimossi a meno che il chiamante legga a livello operator.
lastTouch
Con un filtro resource, l’intervento più recente su di essa, con eventuali campi mai registrati dall’evento indicati in unknown.
why
Con un filtro resource, la regola di corrispondenza usata: risorsa o soggetto uguale al valore dato.
Meccanismo
Passo dopo passo
Come funziona
Il livello di divulgazione del chiamante è fissato
Un chiamante con il permesso records.export legge a livello operator; tutti gli altri a livello public, deciso prima che venga recuperato qualcosa.
Una risorsa restringe alla sua storia
Passare resource delega alla logica di blame del ledger e restituisce gli eventi di quella risorsa in ordine cronologico inverso, con lastTouch e gli eventuali campi unknown indicati onestamente.
Senza risorsa elenca tutto
Senza resource, ogni evento del ledger del workspace torna come events, allo stesso livello di divulgazione.
Gli handle sono rimossi, non il contenuto
A livello public, campi come rootHex, otsDigestHex e inclusionProof sono rimossi da ogni evento e dal suo body; nient’altro dell’evento è alterato.
Provalo
Demo live
Eseguilo da questa pagina
GET/api/v1/acp/civics/records
// Nessun body: è una GET. Premi Esegui.
Viene eseguito in un workspace demo condiviso con una chiave demo: chiunque può vedere cosa contiene, quindi non inviare nulla di privato. Docs di civics.records
Risposte
Premi Esegui per inviare la richiesta a sinistra al workspace demo condiviso.
Viene eseguito in un workspace demo condiviso con una chiave demo: chiunque può vedere cosa contiene, quindi non inviare nulla di privato.
Codice
Esempio live
Una richiesta reale
Una richiesta nella forma accettata dall’API e una risposta di esempio nella forma restituita dal modulo.
api.intramedial.com/api/v1/acp/civics/recordsGET
GET/api/v1/acp/civics/recordsAuthorization: Bearer av_workspace_••••→ 200 { projection, disclosureLevel, events } (filtering by resource also adds lastTouch, unknown and why)
Un membro senza diritti di esportazione legge cosa è successo a una risorsa con i campi handle di testimone rimossi, abbastanza per vedere la forma degli eventi senza esporre il materiale di prova.
Un operatore che estrae il registro completo
Il proprietario di un workspace con records.export legge gli stessi eventi a livello operator, senza rimozioni, per un export di conformità.
Ricostruire la storia di una risorsa
Passare resource trasforma il registro generale in una vista blame mirata, la stessa che restituisce ledger.blame.
Sapere cosa il registro non sa
Un lastTouch che manca di attore o decisione lo dice in unknown, invece di tirare a indovinare o lasciare il campo silenziosamente assente.
Quando usare altro
Filtrare per attore, tipo o intervallo di date. Qui restringe il risultato solo resource.
Modificare o rimuovere un evento scritto. Non esiste un’azione di aggiornamento o eliminazione; il registro cresce soltanto.
Leggere gli eventi di un altro workspace. Ogni lettura è limitata al workspace del chiamante.
Prove
Garanzie
Cosa fa e cosa non fa
Un modulo è una promessa forte su una cosa circoscritta. Contaci esattamente per ciò che è.
Fa
Il livello di divulgazione è calcolato dai permessi del chiamante, mai accettato come campo della richiesta che il chiamante potrebbe impostare da sé.
La trascrizione registrata e sottoposta a hash di un evento non è mai alterata a posteriori, anche se una prova di testimone può essere allegata in seguito alla sua riga salvata.
Nessuna azione in questo modulo, né nel ledger da cui legge, può aggiornare o eliminare un evento scritto.
Non fa
Che ogni evento toccato da una risorsa sia filtrabile per qualcosa oltre la sua stringa esatta resource o subject.
Che un lettore pubblico e uno operatore vedano eventi diversi, solo campi diversi sugli stessi eventi.
Che l’header del gateway che porta il permesso del chiamante non possa essere configurato male; questo modulo si fida di ciò che riceve.
Dettagli
Note di sviluppo
Prima di costruire
Delega al modulo ledger
Sia il percorso blame sia quello di elenco chiamano direttamente le funzioni proprie di ledger.blame e ledger.list; civics.records aggiunge sopra lo strato di oscuramento basato sui permessi, non uno store separato.
Handle di testimone, nominati
I campi rimossi a livello public sono leafHex, rootHex, otsDigestHex, entpoindReceiptId, topsEntryId, witnessRecordId, awsWitnessKey, awsKmsKeyId, awsCountersignHex e inclusionProof.
Non esiste un’azione MCP
civics.records è raggiungibile solo via REST; civics.presence, civics.forum, civics.claims e civics.list hanno ciascuno la propria azione MCP, ma records no.
Limiti e misurazione
L’unico filtro è resource; non ci sono attore, tipo o intervallo di date.
Il livello di divulgazione è binario: public o operator, deciso da un solo permesso, non una scala graduale.
Per questa route non esiste un id di azione MCP o di contratto; chiamala via REST.
Accesso
API e MCP
REST e MCP
Autenticati con una chiave API del workspace come token Bearer. L’URL di base è https://api.intramedial.com.
Endpoint REST
GET/api/v1/acp/civics/recordsLeggi gli eventi chiaramente, o la storia di una risorsa con resource.
Azioni MCP
Questo modulo non ha azioni MCP. Chiamalo via REST da qualsiasi agente o programma.
Pianifica dove devono vivere i record di coordinamento di questo workspace, vedi esattamente cosa si sposterebbe, poi portalo in un’altra regione quando decidi tu.
Modulo della piattaforma
