This guide explains BIP 370 PSBT Version 2 in plain English. It covers the problem behind the BIP, why it matters and whether the proposal is part of Bitcoin today.
TL;DR
- What it is: BIP 370 specifies PSBT version 2, which moves unsigned-transaction data into global, input and output maps and permits authorised inputs or outputs to be added or removed after creation. Unlike PSBT version 0, it excludes the global unsigned transaction.
- Why it matters: PSBTv2 enables coordinated construction that PSBTv0 could not express, but that flexibility changes the trust model. Every mutation, role transition, locktime and final transaction must be explicitly verified.
- Current position: The BIP is Deployed, Applications and Specification.
BIP 370 PSBT Version 2 in simple English
BIP 370 PSBT Version 2: Version two stores transaction version, fallback locktime, input count, output count and modifiable flags globally. Counts must match the actual maps and duplicate keys remain invalid.
Simple example
A node operator is checking BIP 370 PSBT Version 2. The global version field must be present and equal two. Validate amounts, scripts and totals independently before deciding fees or intent.
Key terms in plain English
- BIP:
- Bitcoin Improvement Proposal: a document describing a proposed rule, standard or process. Its status must be checked separately.
- PSBT:
- A portable format for passing an unsigned or partly signed Bitcoin transaction between tools and signers.
- Node:
- A computer running Bitcoin software that checks data and communicates with other peers.
Status and version
The BIP is Deployed, Applications and Specification. The global version field must be present and equal two; PSBT_GLOBAL_UNSIGNED_TX must be absent.
Global transaction fields
Version two stores transaction version, fallback locktime, input count, output count and modifiable flags globally. Counts must match the actual maps and duplicate keys remain invalid.
Per-input construction
Each input carries previous txid and output index, with optional sequence and required height- or time-based locktime. Decode byte order and bounds exactly.
Per-output construction
Each output stores its satoshi amount and script in its output map. Validate amounts, scripts and totals independently before deciding fees or intent.
Modifiable flags
Flags declare whether inputs or outputs can change and whether SIGHASH_SINGLE pairings need preservation. Once commitments or signatures constrain modification, constructors must stop unsafe edits.
Identity and roles
A v2 proposal’s identity depends on its constructed unsigned transaction state. Creator, Constructor, Updater, Signer and Extractor must each validate the fields they consume and preserve unknown keys.
How specialists test it
Developers test the proposal with made-up data on an isolated test network. They check normal cases and deliberately invalid cases. Different implementations should reach the same result before anyone relies on the proposal.
Frequently asked questions
What is the main point of BIP 370 PSBT Version 2?
BIP 370 PSBT Version 2: Version two stores transaction version, fallback locktime, input count, output count and modifiable flags globally.
For BIP 370 PSBT Version 2, what should a beginner know about status and version?
The BIP is Deployed, Applications and Specification. The global version field must be present and equal two.
For BIP 370 PSBT Version 2, what should a beginner know about global transaction fields?
Version two stores transaction version, fallback locktime, input count, output count and modifiable flags globally.
For BIP 370 PSBT Version 2, what should a beginner know about per-input construction?
Each input carries previous txid and output index, with optional sequence and required height- or time-based locktime.
Conclusion
PSBTv2 enables coordinated construction that PSBTv0 could not express, but that flexibility changes the trust model. Every mutation, role transition, locktime and final transaction must be explicitly verified.
Primary sources
Check the current specification status and the documentation for the exact implementation you operate before moving production funds or changing a mining node.



Join the ASIC Mining Discussion
Members can read and join the discussion
Log in to read comments from other miners. Create a free account if you would like to ask a question or share your experience.
Membership helps us protect the discussion from spam and keep answers useful.