Skip to content

docs: clarify database migration workflow and RPC trust boundary - #339

Merged
Lost-Z merged 1 commit into
Lumen-Scribe:mainfrom
williamsokperez-arch:feature/database-migration
Aug 31, 2026
Merged

docs: clarify database migration workflow and RPC trust boundary#339
Lost-Z merged 1 commit into
Lumen-Scribe:mainfrom
williamsokperez-arch:feature/database-migration

Conversation

@williamsokperez-arch

Copy link
Copy Markdown

closes #275
closes #276

Fixes #276 by adding a Database changes section to CONTRIBUTING.md that documents how to create migrations, apply them, and regenerate sqlx metadata. Covers the full workflow for schema changes including updating triggers.

Fixes #275 by making the trust boundary explicit in simulate_call and /simulate endpoint docs. Clarifies that while Lumenqraph doesn't sign or broadcast, the safety guarantee depends on the RPC endpoint's simulation semantics and could change with future Soroban upgrades.

Description

Fixes #

Changes

Pre-submit checklist

  • I have run make fmt (or cargo fmt --all)
  • I have run make lint (or cargo clippy --workspace --all-targets -- -D warnings)
  • I have run make test (or cargo test --workspace)
  • I have run cargo audit and cargo deny check (if dependencies changed)
  • I have updated the documentation (if user-facing changes)
  • I have added a migration in migrations/ (if schema changed)
  • I have updated the CHANGELOG (if notable feature or fix)
  • I have tested the Docker build (if Dockerfile or dependencies changed)

Testing

  • Unit tests
  • Integration tests
  • Manual testing:

Additional context

Fixes Lumen-Scribe#276 by adding a Database changes section to CONTRIBUTING.md that
documents how to create migrations, apply them, and regenerate sqlx metadata.
Covers the full workflow for schema changes including updating triggers.

Fixes Lumen-Scribe#275 by making the trust boundary explicit in simulate_call and
/simulate endpoint docs. Clarifies that while Lumenqraph doesn't sign or
broadcast, the safety guarantee depends on the RPC endpoint's simulation
semantics and could change with future Soroban upgrades.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
@drips-wave

drips-wave Bot commented Aug 31, 2026

Copy link
Copy Markdown

@williamsokperez-arch Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

@Lost-Z
Lost-Z merged commit 96c997d into Lumen-Scribe:main Aug 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants