L'app pilota
L'app è su https://scontratto-app.pages.dev. Gira su Base Sepolia, con EURC di prova: niente soldi veri. Serve un wallet nel browser, per esempio MetaMask, Coinbase Wallet o Rabby.
Prima di cominciare
- Il wallet. Collegalo con il pulsante in alto. L'app chiede di passare a Base Sepolia, e la aggiunge se il wallet non la conosce.
- Un po' di ETH di prova per il gas, da un faucet di Base Sepolia. Serve a chi apre e versa.
- EURC di prova dal faucet di Circle, scegliendo Base Sepolia. Servono a chi versa.
- Le impostazioni, dall'ingranaggio. L'URL dell'API è già giusto. Le scritture vogliono il token del pilota: chiedilo al team. Resta nel tuo browser.
Per provare da solo servono due account nel wallet: uno versa, l'altro riceve. Si passa dall'uno all'altro nel wallet, senza ricaricare.
La lista
Contratti mostra tutti gli scontratti del pilota, tra persone e tra agenti, nella stessa tabella: chi sono le parti, cosa li fa eseguire, lo stato e la scadenza. I filtri in alto mostrano solo quelli tra persone o solo quelli tra agenti. Sopra, l'app spiega i tre modi di farne uno: tra persone, tra agenti, misti.
Uno scontratto su una spedizione
Nuovo chiede prima chi firma. Con Firmo io si apre il modulo:
| Campo | Cosa mettere |
|---|---|
| Chi versa | L'indirizzo che paga. Se il wallet è collegato, è già il tuo. |
| Chi riceve | L'indirizzo che incassa. |
| Importo | In EURC. |
| Giorni di termine | Entro quando deve arrivare la consegna. |
| Corriere | Il codice del corriere su AfterShip, per esempio dhl, brt, gls. |
| Numero di tracking | Quello della spedizione vera. |
| Alla scadenza | Se i soldi tornano a chi versa, o se lo scontratto si esegue comunque. |
Poi i passi, che l'app mostra uno per uno:
- Mandato preparato. L'API calcola il documento da firmare e il suo id.
- Firmato da chi riceve. Con l'account di chi riceve, firma il mandato nel wallet. Non costa niente.
- Contratto creato. Lo scontratto esiste, in bozza.
- Aperto e versato. Con l'account di chi versa: tre transazioni nel wallet. La prima autorizza l'escrow a prelevare gli EURC, la seconda apre lo scontratto con la firma di chi riceve, la terza versa.
Seguirlo
La scheda dello scontratto mostra le parti, la somma sul binario tra le due, la condizione e la scadenza. Quando il corriere segna consegnato, la somma scorre verso chi riceve. Alla scadenza senza consegna, torna indietro.
Osserva adesso chiede all'oracolo di guardare il tracking subito, senza aspettare il giro dei cinque minuti. Sotto ci sono la storia, con i link alle transazioni su Basescan, e la prova di quello che l'oracolo ha visto.
Uno scontratto tra agenti
Quando a firmare è un tuo agente, con scontract.ai, l'app serve a te come titolare.
- Autorizzarlo. Nuovo, poi Firma il mio agente: firmi con il tuo wallet il mandato dell'agente. Decidi quanto può spendere per scontratto e per periodo, verso quali fornitori e fino a quando. Sotto c'è il catalogo delle condizioni che può usare.
- Controllarlo. In I tuoi agenti, sotto la lista, vedi i tuoi mandati e quanto hanno ancora a disposizione. Da un mandato lo revochi con una transazione.
- Seguirlo. Gli scontratti dei tuoi agenti sono nella stessa lista degli altri. La scheda è la stessa: chi versa, chi riceve, quando si esegue, quando si annulla, e in più il verdetto dell'evaluator.
Gli agenti non usano l'app: creano e pagano gli scontratti con il server MCP.
Da sapere
- Il token del pilota protegge le scritture finché non c'è un login vero. Con il login, a dire chi versa sarà la sessione dell'utente.
- Il tracking deve esistere su AfterShip. Se non lo conosce, l'oracolo lo registra alla prima osservazione, e il corriere comincia a mandare aggiornamenti.
- Lo stesso giro si può fare da riga di comando, senza browser:
node scripts/pilota.mjs <tracking>nel repository, con le chiavi di prova in.dev.vars.