Plenipo

Guida · Sandbox pubblica

Come funziona la demo

Plenipo permette a una persona di dare un mandato limitato a un agente AI dal proprio portafoglio europeo di identità digitale e a una banca di verificare ogni chiamata rispetto al mandato. La sandbox pubblica esegue l'intera catena con persone e denaro fittizi. Questa pagina mostra chi fa cosa, cosa vedi su ogni schermata e come rendere la simulazione più reale, un passo alla volta.

Chi partecipa alla demo

Chi partecipa alla demoPiattaforma di agenti to Persona con EUDI Wallet: richiesta di mandato (OpenID4VP, QR o link). Persona con EUDI Wallet to Piattaforma di agenti: approvazione: PID legato all'hash del mandato. Agente AI (Claude o il tuo) to Banca: chiamata firmata + catena di mandati. Banca to Piattaforma di agenti: lista di stato del mandato. Banca to Fornitore PID: lista di stato PID.Persona conEUDI WalletAgente AI(Claude o il tuo)Piattaforma di agentiRichieste e revocaBancaVerificatore PlenipoFornitore PIDIdentità e statorichiesta di mandato(OpenID4VP, QR o link)approvazione: PID legatoall'hash del mandatochiamata firmata + catena di mandatilista di stato del mandatolista di stato PID
Persona con EUDI Wallet
La persona legge i limiti del mandato nel wallet e decide se approvare con il proprio PID.
Agente AI (Claude o il tuo)
L'agente chiede il permesso e invia alla banca chiamate firmate entro il mandato.
Piattaforma di agenti
La piattaforma richiede il mandato e mantiene il comando per fermarlo revocandolo o sospendendolo.
Banca
La banca verifica ogni chiamata con Plenipo prima di eseguire qualsiasi operazione.
Fornitore PID
Il fornitore PID emette l'identità della persona e ne pubblica la lista di stato.

Nella sandbox pubblica tutti e cinque operano su sandbox.plenipo.net; le persone sono Maria Rossi e Luca Bianchi e il denaro non è reale.

Un mandato, passo per passo

Un mandato, passo per passo1. L'agente chiede alla piattaforma un mandato (azioni, controparti, limiti, validità). 2. La piattaforma invia una richiesta OpenID4VP con il mandato come dati di transazione (tipo plenipo_mandate). 3. La persona legge ogni limite e approva con il proprio PID. 4. Il wallet restituisce la presentazione PID, il cui key binding firma l'hash dei byte esatti del mandato. 5. L'agente chiama la banca con un'invocazione firmata e la catena di mandati. 6. La banca controlla l'emittente PID, l'hash del mandato, i limiti, la controparte e lo stato di revoca, poi risponde ALLOW o DENY.AgentePiattaformaWalletBancaChiede un mandato1Richiesta OpenID4VPplenipo_mandate2Legge i limitie approva3Presentazione PIDlegata all'hash del mandato4Invocazione firmata + catena di mandati5Verifica, poi ALLOW o DENY6
  1. 01L'agente chiede alla piattaforma un mandato (azioni, controparti, limiti, validità).
  2. 02La piattaforma invia una richiesta OpenID4VP con il mandato come dati di transazione (tipo plenipo_mandate).
  3. 03La persona legge ogni limite e approva con il proprio PID.
  4. 04Il wallet restituisce la presentazione PID, il cui key binding firma l'hash dei byte esatti del mandato.
  5. 05L'agente chiama la banca con un'invocazione firmata e la catena di mandati.
  6. 06La banca controlla l'emittente PID, l'hash del mandato, i limiti, la controparte e lo stato di revoca, poi risponde ALLOW o DENY.

L'agente chiede

La piattaforma mostra cosa chiede l'agente e un codice QR. Un EUDI Wallet lo scansiona; nella sandbox puoi anche aprire il wallet nel browser.

La persona decide

Il wallet mostra ogni limite del mandato: azioni, beneficiari, importi, validità, passaggio ad altri agenti. L'approvazione condivide dal PID solo nome, cognome e data di nascita.

Ogni controllo, dal vivo

Ogni esecuzione ha un codice demo di sei caratteri. Su plenipo.net/demo segui l'agente, il wallet e la banca in tempo reale. Qui una bolletta chiede all'agente di pagare un altro soggetto: la banca rifiuta con COUNTERPARTY_NOT_PERMITTED e il pagamento autentico va comunque a buon fine.

Cosa vede la banca

La banca conserva le proprie decisioni e i pagamenti. Nella sandbox pubblica ogni mandato ha una copia del conto, così le esecuzioni non interferiscono.

Cinque modi per usarla, dal rapido al reale

  1. 01

    Guarda uno scenario guidato

    Serve
    Un browser.
    Simulato
    Agente, persona, wallet, banca.
    Reale
    Il verificatore Plenipo decide ogni chiamata.
  2. 02

    Usala con Claude

    Parli con l'agente e approvi nel wallet della sandbox come Maria o Luca.

    Serve
    Claude con un connettore personalizzato (l'URL MCP su /demo).
    Simulato
    Persona, wallet, banca.
    Reale
    Un vero agente LLM sceglie cosa chiamare, e il verificatore.
  3. 03

    Porta il tuo agente o la tua banca

    Il tuo agente firma le chiamate con la propria chiave; il tuo servizio le verifica con la libreria.

    Serve
    Node 22+, npm install plenipo, oppure la sandbox dal repository (cartella sandbox, Docker Compose).
    Simulato
    Gli altri attori della sandbox.
    Reale
    Il tuo codice.
  4. 04

    Un'implementazione reale di wallet

    La Wallet API di walt.id presenta il PID e approva il mandato, end-to-end, sia come plenipo_mandate sia come e-mandate TS12 (testato il 25 ottobre 2026).

    Serve
    Docker.
    Simulato
    Agente, persona, banca e identità di test.
    Reale
    La Wallet API di walt.id e il verificatore.
  5. 05

    Il wallet di riferimento EUDI

    L'app di riferimento europea, in una build Plenipo che mostra ogni limite del mandato nella schermata di consenso, con un PID di prova dell'emittente europeo. Provata su emulatore Android e simulatore iOS il 15 novembre 2026: la banca ha consentito 84,30 € e rifiutato 180 € (oltre il limite per pagamento) e un pagamento a un beneficiario fuori dal mandato.

    Serve
    Un Mac con Android Studio (emulatore Android) o Xcode (simulatore iOS 26 o successivo). Build nelle release GitHub dei due fork; approvare entro 10 minuti dalla richiesta.
    Simulato
    Banca sandbox, persone e denaro fittizi.
    Reale
    Integrazione del wallet di riferimento UE con un PID di test.

    Build di prova solo per la sandbox. Seguono la build Android firmata e TestFlight.

01 Il PID nel walletEmesso dall'emittente di prova europeo
02 La richiestaLa piattaforma dell'agente chiede il mandato
03 Il consensoScopo, azioni, beneficiari, limiti, durata
04 La firmaIl PID firma l'hash del mandato
05 La tracciaIl wallet registra la transazione

Schermate delle build di prova Plenipo su emulatore Android e simulatore iOS, 15 novembre 2026. Dati di prova; banca e denaro della sandbox sono simulati.

Ogni livello sostituisce una parte simulata con una reale; il verificatore della banca è lo stesso a ogni livello.

Da sapere

Nessun pagamento reale
Il denaro della sandbox è fittizio e i conti vengono azzerati ogni notte.
Fermalo quando vuoi
Revoca o sospendi un mandato dalla piattaforma; la banca rifiuta la chiamata successiva.
Cosa impone la banca
Azioni, controparti, limiti per operazione e totali, validità, profondità di delega e revoca, verificati a ogni chiamata.