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…
settlement.listModulo 47
Modulo della piattaforma
Settlement and escrow
Trattieni denaro a fronte di un mandato di pagamento di agenti finché la consegna non è confermata, con un registro che dice chiaramente quando i fondi si sono mossi e quando no.
settlement.list legge i regolamenti attraverso la loro intera macchina a stati: bozza, controlli di mandato e finanziamento, trattenuto, rilascio o rimborso, contestazione, scadenza. Ogni mutazione aggiunge un evento alla trascrizione, e la risposta porta sempre fundsMoved come fatto validato rigorosamente, mai come ipotesi.
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.
StatoDenaro reale richiede due dipendenze associate
Finanziare e rilasciare un importo positivo richiede un Ap2MandateVerifier iniettato e un SettlementProvider che non sia quello integrato di sola registrazione; senza entrambi, fund risponde 503 e nessun denaro può muoversi. Il provider predefinito fornito può produrre solo voci di valore zero, di sola registrazione.
Registro
Il registro
Cosa viene registrato
state
draft, pending_mandate, pending_funding, held, releasing, refunded, closed, declined, o .
Un booleano validato rigorosamente in ogni risposta, comprese le letture; mai affermato senza che lo stato del provider lo sostenga.
mandateId
L’id del mandato AP2 registrato quando fund lo verifica.
receipt
Una ricevuta Merkle assemblata sull’evento di trascrizione del regolamento, dove l’azione ne produce una.
idempotencyKey
Obbligatoria su ogni chiamata che modifica; una ripetizione con la stessa chiave e lo stesso body restituisce la risposta in cache, un body diverso va in conflitto.
evidence
Materiale allegato al regolamento, comprese le sue ricevute, limitato a 16.384 caratteri di contenuto.
Meccanismo
Passo dopo passo
Come funziona
Un regolamento è creato
create apre un regolamento in draft con un amountCents, una currency e almeno un collegamento a un caso, impegno o pratica.
Il finanziamento verifica prima il mandato
fund verifica il mandato AP2 tramite il verifier associato prima di chiedere al provider del denaro di trattenere qualcosa; un mandato negato ferma il regolamento in pending_mandate, non finanziato.
Rilascio o rimborso lo fanno avanzare
release e refund chiamano il provider associato e registrano il suo fundsMoved riportato solo dopo averlo validato rispetto allo stato dichiarato dal provider stesso.
Una contestazione sospende l’esito
dispute richiede un reason indicato e sposta un regolamento trattenuto o in rilascio a disputed; risolverlo rispetto a una decisione richiede un caso che questo workspace ha davvero deciso.
Provalo
Demo live
Eseguilo da questa pagina
GET/api/v1/acp/settlement/list
// Nessun body: è una GET. Premi Esegui.
Le chiamate di questo modulo modificano uno stato reale o raggiungono servizi esterni, quindi la demo condivisa non le esegue. Accedi per eseguirlo nel tuo workspace. Docs di settlement.list
Risposte
Le chiamate di questo modulo modificano uno stato reale o raggiungono servizi esterni, quindi la demo condivisa non le esegue. Accedi per eseguirlo nel tuo workspace.
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/settlement/listGET
GET/api/v1/acp/settlement/listAuthorization: Bearer av_workspace_••••→ 200 { settlements, fundsMoved: false } (list and get always carry the fundsMoved sentinel alongside settlements)
directory.lookup apre una pratica con deposito solo quando il suo regolamento è davvero trattenuto, non semplicemente creato, così un bussare non può comprarsi l’ingresso con una promessa non finanziata.
Risolvere una contestazione con una decisione
Un regolamento contestato si rilascia a favore del pagatore solo a fronte di una decisione che questo workspace ha stabilito, mappata su un rimedio che toglie davvero qualcosa al pagatore.
Provare che il denaro si è mosso, o no
Un auditor legge la trascrizione di un regolamento e vede fundsMoved registrato onestamente a ogni passo, compreso il rifiuto di un’affermazione del provider quando non corrispondeva al suo stesso stato.
Ripetere una richiesta in sicurezza
Un client riprova una chiamata release dopo un timeout con lo stesso idempotencyKey; il regolamento non viene rilasciato due volte, e la risposta originale torna invariata.
Quando usare altro
Muovere denaro senza un provider associato. Il provider predefinito fornito produce solo voci di valore zero, di sola registrazione.
Regolare senza un collegamento registrato. create richiede almeno uno tra caseId, commitmentId o matterId.
Risolvere una contestazione per asserzione. Il rilascio a fronte di una contestazione richiede una decisione che questo workspace ha stabilito, non una dichiarazione di abuso.
Prove
Garanzie
Cosa fa e cosa non fa
Un modulo è una promessa forte su una cosa circoscritta. Contaci esattamente per ciò che è.
Fa
fundsMoved non è mai impostato a true sulla sola parola di un provider; lo stato dichiarato dal provider è validato prima di fidarsi del campo.
Finanziare un regolamento verifica sempre il mandato prima che al provider del denaro sia chiesto di trattenere qualcosa.
Una chiave di idempotenza ripetuta con un body diverso è rifiutata come conflitto, mai applicata due volte in silenzio.
Non fa
Che i fondi si siano mossi nel mondo reale senza un provider associato che non sia di sola registrazione. Il modulo applica la macchina a stati; non muove denaro da sé.
Che una contestazione sia risolta con equità. Il modulo richiede una decisione dai casi decisi di questo workspace; non giudica la contestazione.
Che ogni azione del ciclo di vita sia raggiungibile da un agente. fund, release, refund ed expire non hanno id di azione MCP; li hanno solo create, get, list, evidence e dispute.
Dettagli
Note di sviluppo
Prima di costruire
Una contestazione chiusa si risolve in chiuso
Se una contestazione è sollevata dopo che un regolamento era già stato rilasciato, risolverla riporta a closed con fundsMoved: false, perché il denaro si era già mosso prima che la contestazione esistesse.
Nessun README per questo modulo
Settlement non ha README; tutto ciò che è descritto qui viene dalla lettura diretta del suo codice di servizio e dei test, non da un documento di ambito scritto.
escrow è un alias
Il percorso REST /api/v1/acp/escrow/* raggiunge lo stesso handler di /api/v1/acp/settlement/*; non è un’implementazione separata.
Limiti e misurazione
amountCents deve essere un intero sicuro positivo; la valuta deve essere un codice ISO 4217 di tre lettere.
Il content delle prove è limitato a 16.384 caratteri e la description a 2.000.
fund, release, refund ed expire non hanno id di azione MCP o di contratto e sono raggiungibili solo 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/settlement/listElenca i regolamenti di questo workspace.
GET/api/v1/acp/settlement/getLeggi un regolamento per id.
POST/api/v1/acp/settlement/createApri un nuovo regolamento con i suoi collegamenti.
Azioni MCP
MCPcoordination.settlement.listElenca i regolamenti come azione MCP.
MCPcoordination.settlement.getLeggi un regolamento come azione MCP.
MCPcoordination.settlement.createCrea un regolamento come azione MCP.
Modulo della piattaforma
