stellar / stellar-docs

Documentation for Stellar
https://developers.stellar.org
Apache License 2.0
66 stars 132 forks source link

βœ’ Document extra signer logic #773

Open JFWooten4 opened 4 months ago

JFWooten4 commented 4 months ago

What problem does your feature solve?

Transactions with extra signers are rejected for a number of reasons. ❌

Despite this reality, the present docs only lightly cover the extra signer case.

Without adequate documentation, the community may not fully understand the real-world implications of disallowing extra signers.

What would you like to see? πŸ”

Flesh out the documentation for extra signers, possible including a new section in the docs.

Details should include traditional liability, distributed computation, and account privacy considerations. πŸ‘€

Ideally provide edge case examples for problematic examples, in code.[^some] [^some]: See, e.g., reaching quorum, config, and peers.

What alternatives are there?

There seems to be lingering confusion in the community as to why transactions with too many signature should be and are rejected.

If we leave this undocumented, the network risks the introduction of proposals aimed at allowing unlimited signers, hurting scalabitlity. πŸ“‰

Might we contemplate where to place any new page detailing this material protocol design choice? πŸ’­

JFWooten4 commented 2 weeks ago

Per Wayback, this used to be at https://developers.stellar.org/docs/glossary/transactions/#list-of-signatures