Skip to content

fix: no need to run txindex for sBTC anymore #1875

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

Merged
adriano-stacks merged 2 commits into from
Jul 23, 2026
Merged

fix: no need to run txindex for sBTC anymore #1875

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9305658
fix: no need to run txindex for sBTC anymore
adriano-stacks Jul 23, 2026
35ef12c
Disable pruning
adriano-stacks Jul 23, 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
11 changes: 9 additions & 2 deletions docs/operate/run-a-sbtc-signer/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,18 +16,21 @@ It is of the utmost importance to follow the recommendations below.

{% stepper %}
{% step %}

#### Prevent unauthorized access to signer infrastructure

Prevent unauthorized access to the sBTC Signer infrastructure (the signer itself, its private key, and the associated PostgreSQL database).
{% endstep %}

{% step %}

#### Keep an offline, secure backup of the Signer private key

Keep an offline, secure backup of the sBTC Signer private key.
{% endstep %}

{% step %}

#### Regularly backup PostgreSQL database

Regularly backup the PostgreSQL database and store it in a secure location.
Expand Down Expand Up @@ -60,8 +63,8 @@ You will need `bitcoind` version 25 or higher.

Your Bitcoin node must include these settings for sBTC signer operation:

* `txindex=1`: Transaction indexing must be enabled
* `server=1`: RPC server must be enabled
* `prune=0`: Pruning must be disabled

### RPC-Based Block Detection

Expand All @@ -71,18 +74,21 @@ The signer connects to Bitcoin Core via RPC and polls for new bitcoin blocks. Th

{% stepper %}
{% step %}

#### Bitcoin Core validates a new block

Bitcoin Core validates a new block.
{% endstep %}

{% step %}

#### Signer detects the block via RPC polling

Signer detects the block via RPC polling.
{% endstep %}

{% step %}

#### Signer processes relevant sBTC transactions

Signer processes relevant sBTC transactions.
Expand All @@ -101,7 +107,8 @@ bitcoind \
-rpcport=${BITCOIN_RPC_PORT} \
-rpcallowip=0.0.0.0/0 \
-rpcallowip=::/0 \
-txindex
-prune=0

```

## Configure your Stacks node
Expand Down