LNPBP: 0010
Vertical: Bitcoin protocol
Title: Bitcoin transaction output-based single-use-seals
Authors: Dr Maxim Orlovsky <[email protected]>,
Peter Todd <[email protected]>,
Federico Tenga,
Giacomo Zucco
Comments-URI:
Status: Proposal
Type: Standards Track
Created: 2019-05-12
License: CC0-1.0
- Abstract
- Background
- Motivation
- Design
- Specification
- Privacy considerations
- Compatibility
- Rationale
- Reference implementation
- Acknowledgements
- References
- Copyright
- Test vectors
The proposal standardises single-use-seal-based cryptographic commitment scheme utilizing bitcoin blockchain and bitcoin transaction graph as a proof-of-publication medium, using bitcoin transaction outputs as seal definitions and spending bitcoin transactions as proofs of seal close and containers for a commitment to a message over which the seal is closed. The verification procedure requires storing part of the single-use-seal witness data on the client side (extra-transaction proof).
Single-use-seal is a cryptographic commitment primitive originally proposed by Peter Todd in 2016 and standardized as LNPBP-8 standard. However, Here we define a specific commitment scheme based on that standard using bitcoin transactions.
Bitcoin transaction output-based single-use-seals (TxOSUS) is a particular application of single-use-seals to bitcoin transaction graph, either as a part of any bitcoin blockchain (longest PoW chain, federated sidechain etc) or state channel (Lightning network channel and other types of state channels), i.e. in terms of single-use-seals, seal medium is represented by a bitcoin transaction graph.
The parties running protocol agree on some transaction output in any given bitcoin transaction graph as a place with special meaning ("seal"), and require that a future transaction spending this output ("witness transaction") contained a deterministic bitcoin commitment to some a message. Any independent party having access to the transaction graph MUST:
- not be able to detect the presence of the commitment in a given transaction graph (hiding property of TxOSUS) even if the original message is known,
- being provided information about specific protocol used for message commitments and access to deterministic bitcoin proof data (see LNPBP-8) be able to verify the commitment such as it will be valid only and only for the message with which the original commitment was created (verifiably property of TxOSUS).
The defined procedure is not the only way in which bitcoin blockchain or transaction graph can be used as a seal medium for single-use seals (for instance, a seal may be defined as a first time some specific public key appears in the blockchain); however these options are not part of the current standard.
Seal or defined seal: Bitcoin transaction outpoint: a combination of transaction identifier (consensus-defined double SHA256 hash of fully-signed valid bitcoin transaction) and transaction output number. Transaction output number MUST be represented as a 32-bit unsigned integer1.
Witness transaction: transaction spending an output specified by a given seal.
Closed seal: a seal for which a transaction spending output matching seal definition is known. This transaction MAY be part of longest block chain, or MAY not be a part of it (existing only within a Lightning network channel or as a part of any other off-chain transaction graph). It's up to particular implementation to decide whether such transaction (named witness transaction) should be considered valid or not; however this rules MUST require that the witness transaction MUST be a valid bitcoin transaction (i.e. it can be validated with libbitcoinconsensus or Bitcoin Core instance).
Defined seal consists of 256-bit consensus-defined double SHA-256 hash of a fully-signed valid bitcoin transaction and 32-bit transaction output index.
Seal MUST be considered defined only and only all of transaction data are known, the transaction is fully signed and both transaction structure and signatures validated with bitcoin consensus rules using libbitcoinconsensus or Bitcoin Core.
NP: Parties participating the protocol MUST agree on an implementatio-specific entropy used in deterministic bitcoin commiemtnes as required by LNPBP-8 and LNPBP-3 protocols.
- Fully sign the transaction containing output acting as a defined seal.
- Construct a transaction spending the transaction output defined by the seal. The transaction may have any number
- Create a commitment to the message and embed it into the unsigned witness transaction with the deterministic bitcoin commitment embed procedure as defined in LNPBP-8, store the proof.
- Fully sign the witness transaction.
NB: Transactions and proof MUST be persisted for further verification procedure.
A party verifying that the seal is indeed closed over a message MUST run the following procedure:
- Make sure that the seal definition is fully known, otherwise fail the verification.
- Verify transaction containing the defined seal:
- the transaction MUST be a valid bitcoin transaction;
- the transaction MUST contain all transaction data required for it's verification;
- bitcoin-defined consensus transaction identifier MUST correspond to the transaction identifier provided as a part of seal definition;
- transaction output number contained in the seal definition MUST be present in transaction (i.e. transaction MUST contain exactly that numbers or more of trsansaciton outputs);
- the transaction MUST be fully-signed for all of its inputs;
- the transaction MUST signatures pass validation with bitcoin consensus rules using libbitcoinconsensus or Bitcoin Core. If any of these conditions are not met, fail the verification.
- Verify the witness transaction spending the transaction output defined as the seal subjected to the current verification procedure:
- the transaction MUST be a valid bitcoin transaction;
- the transaction MUST contain all transaction data required for it's verification;
- the transaction MUST spend transaction output defined as the seal verified by the current procedure;
- bitcoin-defined consensus transaction identifier MUST correspond to the transaction identifier provided as a part of seal definition;
- transaction output number contained in the seal definition MUST be present in transaction (i.e. transaction MUST contain exactly that numbers or more of trsansaciton outputs);
- the transaction MUST be fully-signed for all of its inputs;
- the transaction MUST signatures pass validation with bitcoin consensus rules using libbitcoinconsensus or Bitcoin Core. If any of these conditions are not met, fail the verification.
- Verify the deterministic bitcoin commitment to the given message with the provided deterministic bitcoin commitment proof according to the LNPBP-8 procedure; fail the verification if this procedure fails.
Any implementation of the standard MUST follow strict encoding rules, in particular
Defined seal MUST be serialized as fixed-length 36 byte-long structure:
- 32 bytes of transaction identifier encoded according to bitcoin transaction identifier consensus serialization rules in little-endian format
- 4 bytes of transaction output in little-endian format
Deterministic bitcoin commitment proofs MUST be serialized using strict encoding rules defined in [...].
There are no specific requirements to the message encoding or content; they MAY be defined as a part of other protocols using the current standard.
Bitcoin transactions and their parts, when needed, MUST be serialized according to bitcoin consensus serialization rules (which MAY differ from strict encoding requirements).
While bitcoin normally uses VarInt to represent the number of transaction outputs that may be contained in a given transaction, it uses 32-bit unsigned integers to reference specific transaction output from other's transaction input. Even while with the current current block size limit the maximum number of transaction outputs that may be contained within a transaction is still below 2^16, we stick to the internal bitcoin transaction limits, which, in this case, is defined by transaction input structure (it's impossible to spend transaction output with index number >2^32).
https://github.com/LNP-BP/rust-lnpbp/tree/develop/src/bp/seals
This document is licensed under the Creative Commons CC0 1.0 Universal license.