Skip to content

feat: fast sync #111

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

Open
SWvheerden wants to merge 2 commits into
base: main
Choose a base branch
from
Open

feat: fast sync #111

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5f4ab66
wip
SWvheerden Apr 7, 2026
d9674b5
merge
SWvheerden Apr 7, 2026
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
1 change: 1 addition & 0 deletions Cargo.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

9 changes: 8 additions & 1 deletion integration-tests/Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,10 @@ tari_comms_dht = { git = "https://github.com/tari-project/tari/"}
tari_p2p = { git = "https://github.com/tari-project/tari/"}
tari_shutdown = { git = "https://github.com/tari-project/tari/" }

# Minotari wallet library (for fast sync tests)
minotari = { path = "../minotari" }


# Other dependencies
rand = "0.8"
tonic = "0.13"
Expand All @@ -52,4 +56,7 @@ serde_json = "1.0"
reqwest = { version = "0.12", features = ["json"] }
log = "0.4"
chrono = "0.4"
rusqlite = { version = "0.37", features = ["bundled"] }
rusqlite = { version = "0.37", features = ["bundled"] }

[package.metadata.cargo-machete]
ignored = ["minotari"]
93 changes: 93 additions & 0 deletions integration-tests/features/fast_sync.feature
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
Feature: Fast Sync Scanning
As a wallet user
I want to quickly sync my wallet using fast sync
So that I can see my balance faster than a normal full scan

# =============================
# Performance Comparisons
# =============================
Scenario: Fast sync without backfill is faster than normal sync when there are spent outputs
Given I have a seed node MinerNode
And I have a test database with a full signing wallet
When I mine 20 blocks on MinerNode
And I perform a normal full scan
And I send 15 transactions
And I mine 100 blocks on MinerNode
And I reset the wallet database keeping account
And I measure the time for a normal full scan
And I reset the wallet database keeping account
And I measure the time for a fast sync without backfill
Then the fast sync should be faster than the normal scan

Scenario: Fast sync without backfill completes in similar time to normal sync with no spent outputs
Given I have a seed node MinerNode
And I have a test database with an existing wallet
When I mine 100 blocks on MinerNode
And I measure the time for a normal full scan
And I reset the wallet database
And I measure the time for a fast sync without backfill
Then the fast sync and normal scan should complete in similar time

Scenario: Fast sync with backfill completes within reasonable time of normal sync
Given I have a seed node MinerNode
And I have a test database with a full signing wallet
When I mine 10 blocks on MinerNode
And I perform a normal full scan
And I send 1 transactions
And I mine 100 blocks on MinerNode
And I reset the wallet database keeping account
And I measure the time for a normal full scan
And I reset the wallet database keeping account
And I measure the time for a fast sync with backfill
Then I print the fast sync benchmark results

# =============================
# Balance Correctness - No Transactions
# =============================


Scenario: Fast sync without backfill shows correct balance with no transactions
Given I have a seed node MinerNode
And I have a test database with an existing wallet
When I mine 20 blocks on MinerNode to a different address
And I perform a fast sync without backfill
Then the fast sync should complete successfully
And the fast sync balance should be zero

Scenario: Fast sync with backfill shows correct balance with no transactions
Given I have a seed node MinerNode
And I have a test database with an existing wallet
When I mine 20 blocks on MinerNode to a different address
And I perform a fast sync without backfill
And I perform a backfill scan
Then the fast sync should complete successfully
And the fast sync balance should be zero

# =============================
# Balance Correctness - With Transactions
# =============================

Scenario: Fast sync without backfill shows correct balance with transactions
Given I have a seed node MinerNode
And I have a test database with a full signing wallet
When I mine 10 blocks on MinerNode
And I perform a normal full scan
And I send 1 transactions
And I mine 10 blocks on MinerNode
And I reset the wallet database keeping account
And I perform a fast sync without backfill
Then the fast sync should complete successfully
And the fast sync balance should be at least 1 microTari

Scenario: Fast sync with backfill shows correct balance with transactions
Given I have a seed node MinerNode
And I have a test database with a full signing wallet
When I mine 10 blocks on MinerNode
And I perform a normal full scan
And I send 1 transactions
And I mine 10 blocks on MinerNode
And I reset the wallet database keeping account
And I perform a fast sync without backfill
And I perform a backfill scan
Then the fast sync should complete successfully
And the fast sync balance should be at least 1 microTari
Loading
Loading