stellar / stellar-docs

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

Document recoverable versus nonrecoverable contract errors #1074

Open anupsdf opened 3 weeks ago

anupsdf commented 3 weeks ago

What

Document recoverable versus nonrecoverable contract errors to assist contract developers. We can provide some guidance of which scenarios one would be beneficial than the other. This can possibly go in Errors page

dmkozh commented 1 day ago

We can provide some guidance of which scenarios one would be beneficial than the other.

Contract developers don't have control over which errors are not recoverable. Only the resource errors and internal errors are not recoverable. I don't think this information belongs to the example above. I agree that it would be nice to document somewhere, but I'm not sure where. This seems pretty low-level and I think most of the users shouldn't encounter this at all. But it is indeed pretty confusing for those who might encounter it. Maybe we need something like 'common gotchas' page?