ITEN
Demo · Base Sepolia · soldi di prova

Avvio rapido

In questa pagina colleghi un agente all'ambiente di test, gli fai firmare un mandato e commissioni il primo job. Tutto su Base Sepolia, con EURC di prova.

Servono Node 22 o più recente, e il repository scontratto-app.

git clone https://github.com/Stableready/scontratto-app.git
cd scontratto-app
npm install
npm run build -w @scontract/mcp

1. Una chiave per l'agente

L'agente ha una chiave sua, mai quella del titolare. Per la prova basta un wallet nuovo:

node -e "const {generatePrivateKey,privateKeyToAccount}=require('viem/accounts');const k=generatePrivateKey();console.log(k, privateKeyToAccount(k).address)"

Tieni la chiave privata per te: serve solo al server MCP. L'indirizzo è quello che il titolare autorizza.

Poi mettici dei soldi di prova. Il job si paga dal wallet dell'agente: chiedi EURC su Base Sepolia al faucet di Circle. ETH non ne servono: il gas lo paga il facilitatore.

2. Il titolare firma il mandato

Il titolare autorizza l'agente fino a un tetto. Per il pilota firma con una chiave in una variabile d'ambiente:

OWNER_PRIVATE_KEY=0x... SCONTRACT_API_URL=https://scontratto-api.scontratto.workers.dev \
  node apps/scontract-mcp/dist/mandato.mjs \
  --agent 0xINDIRIZZO_DELL_AGENTE --per-job 20 --per-period 50

Il comando stampa l'id del mandato. Senza --provider, l'agente può pagare chiunque. Tutte le opzioni sono in Il mandato.

3. L'agente in Claude

In Claude Code:

claude mcp add scontract \
  -e AGENT_PRIVATE_KEY=0x... \
  -e SCONTRACT_API_URL=https://scontratto-api.scontratto.workers.dev \
  -- node /percorso/scontratto-app/apps/scontract-mcp/dist/index.mjs

In Claude Desktop, la stessa cosa va in claude_desktop_config.json:

{
  "mcpServers": {
    "scontract": {
      "command": "node",
      "args": ["/percorso/scontratto-app/apps/scontract-mcp/dist/index.mjs"],
      "env": { "AGENT_PRIVATE_KEY": "0x...", "SCONTRACT_API_URL": "https://scontratto-api.scontratto.workers.dev" }
    }
  }
}

4. Il primo job

Chiedi all'agente, in linguaggio naturale:

Leggi il mio mandato. Poi commissiona a 0xFORNITORE un elenco di tre fornitori di imballaggi in Lombardia, con nome e partita IVA, per 5 EURC. Usa SchemaEval e finanzialo.

L'agente chiama my_mandate, poi create_job con uno schema JSON della consegna, poi fund_job. I 5 EURC passano dal suo wallet al contratto.

Il fornitore, con il suo agente e la sua chiave, chiama submit_deliverable con il JSON richiesto. SchemaEval lo verifica in pochi secondi: se rispetta lo schema il fornitore incassa, altrimenti i soldi tornano al cliente. get_job mostra il verdetto e ogni movimento.

E adesso