Skip to content

Fix #9: Soroban error taxonomy table #43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
calproencrip wants to merge 1 commit into from
Closed

Fix #9: Soroban error taxonomy table #43

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions config/soroban-errors.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
- code: TRAPPED
category: execution
plain_english: "The contract execution trapped (panicked) during invocation."
common_cause: "A require! or assert! failed, or an unhandled panic in contract code."
fix: "Check contract logs and the host error; add guards before the failing operation."
docs_url: "https://developers.stellar.org/docs/smart-contracts"
- code: INSUFFICIENT_REFUNDABLE_FEE
category: fees
plain_english: "The transaction did not include enough refundable fee to cover resource usage."
common_cause: "Resource consumption exceeded the declared refundable fee."
fix: "Increase the fee or reduce resource usage (CPU, memory, ledger entries)."
docs_url: "https://developers.stellar.org/docs/smart-contracts/fees"
- code: RESOURCE_LIMIT_EXCEEDED
category: resources
plain_english: "The transaction exceeded a Soroban resource limit."
common_cause: "Too much CPU, memory, or ledger I/O for a single transaction."
fix: "Split work across multiple transactions or optimize the contract."
docs_url: "https://developers.stellar.org/docs/smart-contracts/limits"
- code: ENTRY_ARCHIVED
category: state
plain_english: "A ledger entry referenced by the transaction has been archived."
common_cause: "The contract or data entry expired and was archived."
fix: "Restore the archived entry before retrying the transaction."
docs_url: "https://developers.stellar.org/docs/smart-contracts/state-archival"