list_proposals

Per gli emittenti: elenca le proposte multisig su un’azienda gestita, ordinate dalla più recente per prima. Ogni riga descrive la proposta con dettagli sufficienti per ragionare sul suo stato e decidere se firmarla.

Autenticazione

Richiede l’accesso e l’accesso da emittente all’azienda richiesta. Chiama prima list_managed_companies per ottenere un companyId valido.

Input

Campo	Tipo	Obbligatorio	Descrizione
company	integer	Sì	ID dell’azienda di un’azienda che l’utente registrato è autorizzato a gestire.
state	string	No	Filtra per stato: pending, signed, o failed. Ometti per elencare tutti gli stati.
pageNumber	integer	No	Indice di pagina a base zero. Predefinito 0 (pagina più recente).
pageSize	integer	No	Proposte per pagina. Predefinito 10, massimo 100. Aumenta solo quando l’utente lo chiede.

Output

Un envelope di riepilogo con metadati di paginazione e le proposte sulla pagina richiesta:

Campo	Tipo	Descrizione
companyId	integer	L’ID dell’azienda a cui appartengono le proposte.
state	string	Filtro di stato applicato, se presente. Omesso quando si elencano tutti gli stati.
pageNumber	integer	Indice di pagina a base zero.
pageSize	integer	Dimensione della pagina utilizzata per la richiesta.
totalElements	integer	Numero totale di proposte corrispondenti al filtro.
totalPages	integer	Numero totale di pagine alla dimensione di pagina richiesta.
items	array	Proposte su questa pagina.

Ogni proposta in items contiene:

Campo	Tipo	Descrizione
id	integer	ID della proposta — input obbligatorio per sign_proposal.
nonce	string	Nonce dell’account riservato per questa proposta (stringa decimale). Obbligatorio durante la firma.
gasPrice	number	Prezzo del gas bloccato per questa proposta (wei). Obbligatorio durante la firma.
creationTimestamp	string	Timestamp ISO quando la proposta è stata creata.
executionDatetime	string	Timestamp ISO quando la proposta è stata eseguita on-chain. Assente mentre la proposta è in sospeso o è fallita.
declaration	string	Firma del metodo in stile Solidity chiamato, ad es. setPaymentHub(address hub).
title	string	Titolo breve leggibile dall’uomo.
message	string	Descrizione più completa e leggibile dall’uomo di ciò che fa la proposta.
toAddress	string	Indirizzo del contratto che la proposta chiamerebbe.
hexData	string	Dati di chiamata codificati ABI (esadecimale). Non direttamente leggibile dall’utente; codifica i parametri decodificati della transazione.
hash	string	Hash della transazione on-chain. Presente solo dopo che la proposta è stata eseguita.
signedBy	array	Firmatari che hanno già firmato, come oggetti { name }.
youHaveSigned	boolean	Se l’utente registrato ha già firmato questa proposta.
initiatorName	string	Nome della persona che ha creato la proposta.
state	string	pending · signed · failed.
errorMessage	string	Motivo del fallimento segnalato dal backend. Presente solo quando state è failed.

Gli altri campi dal blocco trans dettagliato del backend (limite di gas, valore, indirizzo di provenienza, numero di blocco, ecc.) e le etichette / figli / catena della proposta vengono rimossi dall’adattatore e non raggiungono mai il contesto del modello.

Esempi di Prompt

• “Elenca le proposte multisig in sospeso della mia azienda.”
• “Mostra le proposte firmate più recenti per l’azienda 42.”
• “Quali proposte in sospeso sulla mia azienda non ho ancora firmato?”
• “L’ultima proposta ha avuto successo o è fallita?”

Note per gli Agenti

• Chiama sempre list_managed_companies per primo — passare un ID company per il quale l’utente non è autorizzato restituisce 403.
• Usa state: 'pending' quando l’utente chiede “cosa deve essere firmato?” — restituisce solo le proposte in attesa di altre firme o esecuzione.
• Il flag youHaveSigned è il modo canonico per sapere se l’utente registrato deve ancora firmare una determinata proposta. Non inferire da solo da signedBy.
• Un 404 significa che l’azienda non esiste; esegui di nuovo list_managed_companies. Un 401 significa che la sessione è scaduta; chiama sign_in e riprova.