Transazioni confermate dal wallet

Gli strumenti di transazione restituiscono una pagina HTTPS di conferma monouso. Il backend prepara e valida la richiesta; tu la controlli e firmi tramite il wallet.

Il flusso di conferma

L'agente richiede l'azione supportata esatta.
Lo strumento restituisce un confirmationUrl e informazioni sull'operazione.
Apri l'URL nel browser, controlla l'azione e collega il wallet previsto se necessario.
Scegli Conferma nel wallet, poi approva o rifiuta nell'interfaccia normale del wallet.
Esamina il risultato dell'operazione e la risorsa interessata.

L'agente deve mostrare l'URL restituito senza modificarlo. Il suo segreto è contenuto nel frammento e non deve essere copiato nei log o ricostruito in un altro URL. Le intenzioni normalmente scadono dopo cinque minuti.

Cosa dimostra ogni fase

Fase	Evidenza
Preparata	Il backend ha creato una richiesta; nulla è stato firmato
In attesa di approvazione	L'utente deve ancora approvare o rifiutare
Inviata	È stato osservato un invio dal wallet; lo stato finale potrebbe essere ancora in attesa
Risultato verificato	Il lettore dell'operazione o risorsa pertinente osserva lo stato previsto

Risultati scaduti o incerti

Se un'intenzione scade prima dell'invio, esamina lo stato attuale prima di prepararne un'altra. Se l'invio è ambiguo, non ripetere automaticamente la transazione. Una vecchia approvazione potrebbe ancora completarsi.

Rinnovare o revocare l'accesso MCP può invalidare una conferma preparata. Ricontrolla l'azione e la risorsa previste prima di richiedere un nuovo URL.

Rileggi la risorsa corretta

Usa domains.records per una radice posseduta e subdomains.get_item per un figlio posseduto. Per i siti, usa sites.list_releases e sites.list_domains. Per Storage, conserva l'identificatore dell'operazione del provider restituito da quel flusso; non è intercambiabile con un ID di operazione MCP generico.

Trasferimenti NFT

Asset	Strumento
Radice `.ton` o `.t.me`	`dns.send_transfer_tx` con `domain` e `newOwner`
NFT figlio	`subdomains.transfer_item_tx` con `itemAddress` e `newOwner`

Dopo un trasferimento, gli strumenti riservati al proprietario potrebbero smettere di restituire l'NFT. Per una radice .ton, usa dns.lookup per verificare il nuovo proprietario. Per un nome utente o un figlio, verifica con il wallet destinatario o un lettore della blockchain adatto.