list_proposals

Für Emittenten: Multisig-Vorschläge für ein verwaltetes Unternehmen auflisten, sortiert nach dem neuesten zuerst. Jede Zeile beschreibt den Vorschlag mit ausreichend Detail, um seinen Status zu bewerten und zu entscheiden, ob man ihn unterzeichnen sollte.

Authentifizierung

Erfordert Anmeldung und Emittentenzugriff auf das angeforderte Unternehmen. Rufen Sie zunächst list_managed_companies auf, um eine gültige companyId zu erhalten.

Eingaben

Feld	Typ	Erforderlich	Beschreibung
company	integer	Ja	Unternehmens-ID eines Unternehmens, das der angemeldete Benutzer verwalten darf.
state	string	Nein	Nach Status filtern: pending, signed oder failed. Weglassen, um alle Status zu sehen.
pageNumber	integer	Nein	Nullbasierter Seitenindex. Standard 0 (neueste Seite).
pageSize	integer	Nein	Vorschläge pro Seite. Standard 10, Maximum 100. Nur erhöhen, wenn der Benutzer danach fragt.

Ausgabe

Eine Zusammenfassungs-Umhüllung mit Paginierungsmetadaten und den Vorschlägen auf der angeforderten Seite:

Feld	Typ	Beschreibung
companyId	integer	Die Unternehmens-ID, zu der die Vorschläge gehören.
state	string	Angewendeter Statusfilter, falls vorhanden. Omitted wenn alle Status aufgelistet werden.
pageNumber	integer	Nullbasierter Seitenindex.
pageSize	integer	Seitengröße, die für die Anfrage verwendet wurde.
totalElements	integer	Gesamtzahl der Vorschläge, die dem Filter entsprechen.
totalPages	integer	Gesamtzahl der Seiten bei der angeforderten Seitengröße.
items	array	Vorschläge auf dieser Seite.

Jeder Vorschlag in items enthält:

Feld	Typ	Beschreibung
id	integer	Vorschlag-ID — erforderliche Eingabe für sign_proposal.
nonce	string	Konto-Nonce, die für diesen Vorschlag reserviert ist (Dezimalzahl). Erforderlich beim Unterzeichnen.
gasPrice	number	Gaspreis festgelegt für diesen Vorschlag (wei). Erforderlich beim Unterzeichnen.
creationTimestamp	string	ISO-Zeitstempel, als der Vorschlag erstellt wurde.
executionDatetime	string	ISO-Zeitstempel, als der Vorschlag in der Blockchain ausgeführt wurde. Fehlt während der Vorschlag ausstehend ist oder fehlgeschlagen ist.
declaration	string	Solidity-artige Methodensignatur, die aufgerufen wird, z.B. setPaymentHub(address hub).
title	string	Kurzer benutzerfreundlicher Titel.
message	string	Ausführlichere benutzerfreundliche Beschreibung, was der Vorschlag bewirkt.
toAddress	string	Vertrag-Adresse, die der Vorschlag aufrufen würde.
hexData	string	ABI-kodierte Aufrufdaten (hex). Nicht direkt benutzerlesbar; kodiert die dekodierten Parameter der Transaktion.
hash	string	Blockchain-Transaktions-Hash. Vorhanden, wenn der Vorschlag ausgeführt wurde.
signedBy	array	Unterzeichner, die bereits unterzeichnet haben, als { name } Objekte.
youHaveSigned	boolean	Ob der angemeldete Benutzer diesen Vorschlag bereits unterzeichnet hat.
initiatorName	string	Name der Person, die den Vorschlag erstellt hat.
state	string	pending · signed · failed.
errorMessage	string	Von der Rückseite gemeldeter Fehlgrund. Vorhanden nur, wenn state failed ist.

Andere Felder aus dem detaillierten trans Block des Backends (Gaslimit, Wert, Von-Adresse, Blocknummer, usw.) und die Labels/Unterkategorien/Chain des Vorschlags werden vom Adapter entfernt und erreichen nie den Model-Kontext.

Beispiel-Eingabeaufforderungen

• “Ausstehende Multisig-Vorschläge meines Unternehmens auflisten.”
• “Die neuesten unterzeichneten Vorschläge für Unternehmen 42 anzeigen.”
• “Welche ausstehenden Vorschläge meines Unternehmens habe ich noch nicht unterzeichnet?”
• “Ist der letzte Vorschlag erfolgreich oder fehlgeschlagen?”

Hinweise für Agenten

• Rufen Sie immer zuerst list_managed_companies auf — die Übergabe einer company-ID, für die der Benutzer nicht autorisiert ist, gibt 403 zurück.
• Verwenden Sie state: 'pending', wenn der Benutzer fragt „was muss unterzeichnet werden?” — es gibt nur Vorschläge zurück, die auf weitere Unterzeichnungen oder Ausführung warten.
• Das Flag youHaveSigned ist der kanonische Weg, um zu wissen, ob der angemeldete Benutzer einen bestimmten Vorschlag noch unterzeichnen muss. Leiten Sie nicht nur aus signedBy ab.
• Ein 404 bedeutet, dass das Unternehmen nicht existiert; führen Sie list_managed_companies erneut aus. Ein 401 bedeutet, dass die Sitzung abgelaufen ist; rufen Sie sign_in auf und wiederholen Sie.