Skip to content

Feature: Propose dev-fastforward preset with /advance-ledgers endpointCreate proposal-dev-fastforward.md#934

Open
LiamVanderdeg wants to merge 3 commits into
stellar:mainfrom
LiamVanderdeg:main
Open

Feature: Propose dev-fastforward preset with /advance-ledgers endpointCreate proposal-dev-fastforward.md#934
LiamVanderdeg wants to merge 3 commits into
stellar:mainfrom
LiamVanderdeg:main

Conversation

@LiamVanderdeg
Copy link
Copy Markdown

Summary

Proposal for a dev-fastforward preset implementing the endpoint requested by @teddav in #932:
"An endpoint to automatically advance by N ledgers" for local Soroban testing.

Problem

As described in #932:

  1. Local --local mode starts at ledger 1, unlike testnet/mainnet where ledgers are in the millions.
  2. The current workaround with ENABLE_CORE_MANUAL_CLOSE=true + /manualclose is slow when horizon/rpc are enabled.
  3. Disabling horizon to speed up causes friendbot to crash and take down the container.
  4. Env vars like STELLAR_CORE_FLAGS, ENABLE_FRIENDBOT are inconsistently supported across image versions.

Proposed Solution

Add --preset dev-fastforward that:

  • Enables --core-config-unsafe-mode to disable archive publishing/validation
  • Disables horizon/rpc/friendbot by default during fast-forward
  • Exposes /advance-ledgers?count=N endpoint as requested by @teddav

This allows reaching ledger 1M+ in minutes, matching real network conditions for time-based contract testing.

Context

This PR formalizes the discussion in issue #932 and the solution we use for ChathaPop.app testing,
which cuts local test time ~90%.

Reference: #932

Copilot AI review requested due to automatic review settings May 12, 2026 23:32
@github-project-automation github-project-automation Bot moved this to Backlog (Not Ready) in DevX May 12, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds a written proposal describing a new dev-fastforward preset and an /advance-ledgers endpoint to speed up local Soroban testing by fast-forwarding ledgers.

Changes:

  • Introduces a proposal doc for a dev-fastforward preset.
  • Documents rationale and constraints from issue #932.
  • Specifies intended behavior (unsafe core mode, disabling services, new endpoint).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/proposal-dev-fastforward.md
Comment thread docs/proposal-dev-fastforward.md Outdated
@LiamVanderdeg
Copy link
Copy Markdown
Author

Ecosystem contribution: Proposed dev-fastforward preset per issue #932

Added implementation notes and usage details for fast-forwarding ledgers in local development.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Backlog (Not Ready)

Development

Successfully merging this pull request may close these issues.

2 participants