list_proposals

Pour les émetteurs : lister les propositions multisig sur une entreprise gérée, triées les plus récentes en premier. Chaque ligne décrit la proposition avec suffisamment de détails pour évaluer son statut et décider si la signer.

Authentification

Nécessite une connexion et un accès émetteur à l’entreprise demandée. Appelez d’abord list_managed_companies pour obtenir un companyId valide.

Entrées

Champ	Type	Requis	Description
company	integer	Oui	ID de l’entreprise que l’utilisateur connecté est autorisé à gérer.
state	string	Non	Filtrer par statut : pending, signed, ou failed. Omettez pour lister tous les statuts.
pageNumber	integer	Non	Index de page basé sur zéro. Par défaut 0 (page la plus récente).
pageSize	integer	Non	Propositions par page. Par défaut 10, maximum 100. À augmenter uniquement si l’utilisateur en demande davantage.

Sortie

Une enveloppe récapitulative avec métadonnées de pagination et les propositions sur la page demandée :

Champ	Type	Description
companyId	integer	L’ID de l’entreprise à laquelle appartiennent les propositions.
state	string	Filtre d’état appliqué, le cas échéant. Omis lors de la liste entre tous les statuts.
pageNumber	integer	Index de page basé sur zéro.
pageSize	integer	Taille de page utilisée pour la requête.
totalElements	integer	Nombre total de propositions correspondant au filtre.
totalPages	integer	Nombre total de pages à la taille de page demandée.
items	array	Propositions sur cette page.

Chaque proposition dans items contient :

Champ	Type	Description
id	integer	ID de la proposition — entrée requise pour sign_proposal.
nonce	string	Nonce de compte réservé pour cette proposition (chaîne décimale). Requis lors de la signature.
gasPrice	number	Prix du gaz verrouillé pour cette proposition (wei). Requis lors de la signature.
creationTimestamp	string	Horodatage ISO de la création de la proposition.
executionDatetime	string	Horodatage ISO de l’exécution de la proposition on-chain. Absent tant que la proposition est en attente ou a échoué.
declaration	string	Signature de méthode de style Solidity appelée, par exemple setPaymentHub(address hub).
title	string	Titre court lisible par l’humain.
message	string	Description plus complète et lisible par l’humain de ce que fait la proposition.
toAddress	string	Adresse du contrat que la proposition appellerait.
hexData	string	Données d’appel encodées en ABI (hex). Non directement lisible par l’utilisateur ; encode les paramètres décodés de la transaction.
hash	string	Hash de la transaction on-chain. Présent uniquement une fois que la proposition a été exécutée.
signedBy	array	Signataires qui ont déjà signé, comme objets { name }.
youHaveSigned	boolean	Si l’utilisateur connecté a déjà signé cette proposition.
initiatorName	string	Nom de la personne qui a créé la proposition.
state	string	pending · signed · failed.
errorMessage	string	Raison d’échec signalée par le backend. Présent uniquement quand state est failed.

Les autres champs du bloc trans détaillé du backend (limite de gaz, valeur, adresse d’origine, numéro de bloc, etc.) et les étiquettes/enfants/chaîne de la proposition sont supprimés par l’adaptateur et ne sont jamais atteints par le contexte du modèle.

Exemples de requêtes

• “Lister les propositions multisig en attente de mon entreprise.”
• “Afficher les propositions signées les plus récentes pour l’entreprise 42.”
• “Quelles propositions en attente sur mon entreprise n’ai-je pas encore signées ?”
• “La dernière proposition a-t-elle réussi ou échoué ?”

Notes pour les agents

• Appelez toujours d’abord list_managed_companies — passer un ID company pour lequel l’utilisateur n’est pas autorisé retourne 403.
• Utilisez state: 'pending' quand l’utilisateur demande “qu’est-ce qui a besoin de signature ?” — cela retourne uniquement les propositions en attente de signatures supplémentaires ou d’exécution.
• L’indicateur youHaveSigned est le moyen canonique de savoir si l’utilisateur connecté doit toujours signer une proposition donnée. Ne déduisez pas uniquement de signedBy.
• Un 404 signifie que l’entreprise n’existe pas ; réexécutez list_managed_companies. Un 401 signifie que la session a expiré ; appelez sign_in et réessayez.