From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp1.osuosl.org (smtp1.osuosl.org [IPv6:2605:bc80:3010::138]) by lists.linuxfoundation.org (Postfix) with ESMTP id 8A32BC002D for ; Tue, 1 Nov 2022 18:03:39 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by smtp1.osuosl.org (Postfix) with ESMTP id 5D56180C1E for ; Tue, 1 Nov 2022 18:03:39 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 smtp1.osuosl.org 5D56180C1E Authentication-Results: smtp1.osuosl.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20210112 header.b=kyv0aFxd X-Virus-Scanned: amavisd-new at osuosl.org X-Spam-Flag: NO X-Spam-Score: -2.098 X-Spam-Level: X-Spam-Status: No, score=-2.098 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no Received: from smtp1.osuosl.org ([127.0.0.1]) by localhost (smtp1.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id dgzBPcZs7_vI for ; Tue, 1 Nov 2022 18:03:35 +0000 (UTC) X-Greylist: whitelisted by SQLgrey-1.8.0 DKIM-Filter: OpenDKIM Filter v2.11.0 smtp1.osuosl.org EFF1380BAD Received: from mail-pj1-x102b.google.com (mail-pj1-x102b.google.com [IPv6:2607:f8b0:4864:20::102b]) by smtp1.osuosl.org (Postfix) with ESMTPS id EFF1380BAD for ; Tue, 1 Nov 2022 18:03:34 +0000 (UTC) Received: by mail-pj1-x102b.google.com with SMTP id r61-20020a17090a43c300b00212f4e9cccdso19524850pjg.5 for ; Tue, 01 Nov 2022 11:03:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :from:to:cc:subject:date:message-id:reply-to; bh=ZG3VHsf50tRFWxmXtvkV1mKkABPObL6d96DlahOVx7k=; b=kyv0aFxdirgkefIX8vRlpx8zPC2C6xuYBw9OoakW+Ha6uQG89WodklfUg9TB//HXiQ 85OXTwyJYSOQ3NC/el29rjClrdw+9Xii407RWasuZc4+RR/OpkOruudK9W6tZLH3dnw5 uv5cyq799h2kaVpakUvqt44RqsZ7PAbrSkP8dMleN67i2lHZG3MZD2WmEDM/Vb014COo XyBBfolXg+C1BjQ0a0/tFrVC8uSQCh4ONVZUSpuboa4KMkAapzkj+PL19GHPD/LCoCwG +16WpTwEyW1K64v1Q9XEcnhbarNhBtrSMBOlagrsrNDyP7LtsjqNMtqw6sFrlTyVOZo1 XDTw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=ZG3VHsf50tRFWxmXtvkV1mKkABPObL6d96DlahOVx7k=; b=5d/Dckq3J7k+PJ8bUuYWGN3GuCHphrDpu48z3esknO7dzDcIKskN9c5GmhwvjUG3lr 2mNDL266V5iNhbkEJ0u5M/LboBQS4eb+b7/O4HMkezIV2PnBk6WcBTjKOcNg6YdNaayn WwKqKGxdMjhG4lOsT337Jd3789PhK+kr/JyiN+pmZUzf8ATLhFotaLV1VAeDMKmBHRlx gbwkn4oyDpLJ4noJpKe12nSCbJ1dgMJDO55rP46NMyL/5Y4lVDxgGn5ChPvGNBvvhPmE BY4gCwSEjkUUxFaB2ZJiUEKRGUytIn5RLyjBTQ0BeZtCfqzjH9iGE0yvxyPbAG/gh/A3 sdJg== X-Gm-Message-State: ACrzQf1BElylTV/HsnTcBd9rkW+JaIlYoWeY1W4ftUByigp/gJuAMWdD UDKqnDwfBMJgEp7tF1pqDcebvBQpB8t79IIDpdpQJ6lk1w0= X-Google-Smtp-Source: AMsMyM5zSRg3sMoUMytiMmBegD52+w8FHd8IhRpfNVydCRbARUhaHqaMuO+igjGevXiarg1vZ7BEgUPju+Hz8jBzstw= X-Received: by 2002:a17:90a:f001:b0:213:bf4:ee29 with SMTP id bt1-20020a17090af00100b002130bf4ee29mr37930716pjb.98.1667325813755; Tue, 01 Nov 2022 11:03:33 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: Gloria Zhao Date: Tue, 1 Nov 2022 18:03:22 +0000 Message-ID: To: Bitcoin Protocol Discussion Content-Type: multipart/alternative; boundary="000000000000da95c205ec6c8a69" X-Mailman-Approved-At: Tue, 01 Nov 2022 18:25:47 +0000 Subject: Re: [bitcoin-dev] Package Relay Proposal X-BeenThere: bitcoin-dev@lists.linuxfoundation.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: Bitcoin Protocol Discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 01 Nov 2022 18:03:39 -0000 --000000000000da95c205ec6c8a69 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hi everyone, I've made some significant changes to my package relay proposal based on observations while implementing, feedback on this thread, and offline discussions [1]. The new proposal is called Ancestor Package Relay, BIP331, and PR'd at https://github.com/bitcoin/bips/pull/1382 The major changes to the proposal are: 1. Scope reduction to receiver-initiated only 2. Scope reduction to ancestor packages only 3. Removal of block hash from package information 1. Scope reduction to receiver-initiated only Receiver-intiated package relay enables a node to ask for more information when they suspect they are missing something (i.e. in this case to resolve a missing parent tx). Sender-initiated package relay should, theoretically, save a round trip by notifying the receiver ahead of time that "hey, this is going to be a package, so make sure you download and submit these transactions together." As with any proactive communication, there is a chance that the node already knows this information, so this network bandwidth was wasted. The logic used to decide _when_ to announce a package proactively determines whether it is a net increase or decrease for overall bandwidth usage. However, it's difficult to design anything to save bandwidth without any idea of what its bandwidth usage actually looks like in practice. We'll want to design the sender-initiated protocol carefully, and inform the design decisions using data collected from the mainnet p2p network. However, there is no historical transaction data to use because the goal is to enable currently-rejected transactions to propagate. In order to get this right, I propose we hold off on sender-initiated for now, deploy receiver-initiated package relay, observe its usage and figure out where we can save a round trip, and then produce a well-researched sender-initiated package relay proposal. 2. Scope reduction to ancestor packages only The proposal now only includes ancestor packages (previously called tx-with-unconfirmed-ancestors or "v2" packages). The child-with-unconfirmed-parents (previously called "v1") package has been removed since it is a subset of ancestor packages and sender-initiated relay has been removed. It may be relevant again in the future with sender-initiated packages. If you were reviewing the previous proposal, "pkginfo2" message has been renamed to "ancpkginfo" and "MSG_PKGINFO2" inv type to "MSG_ANCPKGINFO". 3. Removal of block hash from package information Most of the rationale is already on this thread. The block hash was an attempt to enforce topology when chainstates differ, but isn't worth it. It does not make much sense to drop or delay transaction data requests due to mismatched chainstates, and the chainstate may change again between package information and transaction data rounds. Instead, differences in chainstate should be handled internally at the mempool validation level. The node should de-duplicate recently-confirmed transactions and make a best effort to validate the transactions it has already downloaded. Thanks, Gloria [1] https://diyhpl.us/wiki/transcripts/bitcoin-core-dev-tech/2022-10-11-package= -relay/ On Fri, Jun 17, 2022 at 9:08 PM Antoine Riard wrote: > Hi Gloria, > > Thanks for working on that, > > > Always overestimating fees may sidestep this issue temporarily (while > mempool > > traffic is low and predictable), but this solution is not foolproof > > and wastes users' money. The feerate market can change due to sudden > > spikes in traffic (e.g. huge 12sat/vB dump a few days ago [9]) or > > sustained, high volume of Bitcoin payments (e.g. April 2021 and > > December 2017). > > Even if the LN implementations started to overestimate fees based on the > historical worst-case of block inclusion feerates, there is still room fo= r > exploitation due to bip125 rule#3. Indeed, as long as the adversary is ab= le > to stick in the mempool a higher fee package while the feerate is not > compelling enough to get it mined, your "honest" LN package should be > bounced off. > > Considering Core's `MAX_STANDARD_TX_WEIGHT` of 400000 WU, I think it's > practical for an attacker to succeed with this pinning tactic in periods = of > traffic spikes. Of course, LN implementation could overestimate fees with= a > target like `MAX_STANDARD_WEIGHT` * `worst_case_block_inclusion_feerate` = to > mitigate. However, assuming a value of 20sat for the latter, it would > require from any LN user a minimal channel value of 2000000 satoshis to b= e > theoretically secure against this type of pinning. > > So package relay is required to mitigate efficiently and realistically > against pinning attacks, while conserving the same level of "economic" > openness for Lightning. Beyond, it should be also noted that package rela= y > is only building block of the full set of mitigations, and there should b= e > a yet to-find-consensus-as-of-today other policy change such as > user-elected package limits or replace-by-feerate. > > Anyway, I think it would be beneficial to document the design trade-offs > of pinning mitigations in the `Rationale` subsection, at the attention of > future L2s devs and users ? > > > {| > > | Field Name || Type || Size || Purpose > > |- > > |version || uint32_t || 4 || Denotes a package version supported by the > > node. > > |- > > |max_count || uint32_t || 4 ||Specifies the maximum number of > transactions > > per package this node is > > willing to accept. > > |- > > |max_weight || uint32_t || 4 ||Specifies the maximum total weight per > > package this node is willing > > to accept. > > |- > > |} > > It's unclear to me what's the purpose of `max_count` and `max_weight` in > the overall package relay flow, if they are intended to be exposed as > configurable settings to node operators. If those fields are present to > allow DoS protection increase of low-performance host, I believe it would > be better to restrain the number of consumed UTXOs or executed sigops per > package, as DoS vectors are more likely to be CPU-based, rather than > memory-based as package size already bounded at acceptance by > `MAX_PACKAGE_COUNT`. > > Thinking more we might introduce a `MAX_SIGOPS_PER_PACKAGR` limit, as > otherwise if we naively grant one package announcement as equal to one > transaction announcement in our tx-request logic, we might increase our D= oS > surface, node ressources staying equivalent ? > > > {| > > | Field Name || Type || Size || Purpose > > |- > > |txns_length||CompactSize||1 or 3 bytes|| The number of transactions > > requested. > > I'm not sure if we'll ever allow 3-bytes of package size, that would be > ~32k of transactions. > > > |- > > |txns||List of wtxids||txns_length * 32|| The wtxids of each transactio= n > in > > the package. > > |} > > I think there is a bandwidth consumption trade-off to be aware of in the > function of the package-relay usage. Let's consider a single issuer > broadcasting the package to spend a shared-utxo, after the first shot the > parent component should be spread across the network mempools. At each > fee-bump, only the bumped CPFP will propagate on the network, the parent > wtxid is reannounced in `pckginfo1` though there is no need to fetch it > redundantly and waste bandwidth. > > However, I think the bandwidth saving does not hold in case of competing > transaction issuers to spend a shared-utxo. In that case, the parent migh= t > differ at each broadcast and the list of wtxid is dissemblable at every > claim of the shared-utxo. We could save the 32 bytes * number of packages > elements by announcing a package_id, computed from the list of wtxids. > > I don't know about the occurrence of competing broadcasts among LN > non-cooperative closes, where bandwidth could be potentially saved. I wou= ld > say it's likely low because IIRC there is nothing in the LN protocol wher= e > the counterparties signal to each other they're going on-chain to introdu= ce > a competing broadcast synchronizing event. That said, it might increase i= n > the future in a post-eltoo, multi-party contracting protocol world. > > So it might be interesting to document this design trade-off, if we seek > bandwidth optimizations in function of a changing landscape in the type o= f > transaction issuers in the future. > > > 3. The sender provides package information using "pckginfo1", > > including the blockhash of the sender's best block, the wtxids of > > the transactions in the package, their total fees and total weight. > > It's unclear to me how the `pckinfo1` receiver should proceed if the > sender's best block is not in sync with the local chain tip. > > If the package isn't processed further, that's annoying for all the > low-performance LN mobile clients, their chain tips might be always behi= nd > by few blocks from the p2p network nodes. It sounds like their packages > won't propagate at all. > > If the package is processed further whatever the sender-receiver sync on > chain tip, what's the purpose of including the blockhash ? > > > A child-with-unconfirmed-parents package for a transaction should be > > announced when it meets the peer's fee filter but one or more of its > > parents don't; a "inv(MSG_PCKG1)" instead of "inv(WTX)" should be sent > > for the child. Each of the parents which meet the peer's fee filter > > should still be announced normally. > > I believe we might have concerns of package-feerate downgrades attacks. > E.g, in the LN context, where your channel counterparty is aiming to jam > the propagation of the best-feerate version of the package. > > Let's say you have : > - Alice's commitment_tx, at 1s/vB > - package A + child B, at 3s/vB > - package A + child C, at 10s/vB > - block inclusion feerate at 10s/vB > - Alice and Mallory are LN channel counterparties > - commitment_tx is using LN's anchor outputs > > Alice's LN node broadcasts A+C to her mempool. > Bob's feefilter is at 3s/vB. > Mallory broadcasts her child B in Alice's mempool. > LN commitment does not meet Bob's feefilter. > Package A+child B at 3s/vB meets Bob's feefilter and is announced to Bob. > Mallory broadcasts her own commitment_tx at 4s/vB in Bob's mempool. > When Alice's child C is relayed to Bob, it's bounced off Bob's mempool. > > Do you think this situation is plausible ? Of course, it might be heavily > dependent on package-relay yet-not-implemented internal p2p logic. > I think it could be fixable if LN removes the counterparty's > `anchor_output` on the local node's version of the commitment transaction= , > once package relay is deployed. > > Another question, at the next fee-bump iteration, Alice rebroadcasts > A+child D, at 12 s/vB. Her node has already marked Alice's commitment_tx = as > known in Bob's `m_tx_inventory_known_filter`. So when a new higher fee > child is discovered, should a `child-with-unconfirmed-parents` be > announced between Alice and Bob ? > > Anyway, I think it would be interesting to pseudo-specify the > package-assemblage algorithm (or if there is code already available) to s= ee > if it's robust against adversarial or unlucky situations ? > > > In fact, a package > > of transactions may be announced using both Erlay and package relay. > > After reconciliation, if the initiator would have announced a > > transaction by wtxid but also has package information for it, they may > > send "inv(MSG_PCKG)" instead of "inv(WTX)". > > Yes, I think this holds. Note, we might have to add to the reconciliation > set low-fee parents succeeding the feefilter check due to a child. When t= he > reconcildiff, we might have to bifucarte again on feefilter to decide to > announce missing wtixds either as `inv(MSG_PCKG)` or `inv(WTX)`. > > (IIRC, I've already made few feedbacks offline though good to get them in > the public space and think more) > > Antoine > > Le mar. 17 mai 2022 =C3=A0 12:09, Gloria Zhao via bitcoin-dev < > bitcoin-dev@lists.linuxfoundation.org> a =C3=A9crit : > >> Hi everybody, >> >> I=E2=80=99m writing to propose a set of p2p protocol changes to enable p= ackage >> relay, soliciting feedback on the design and approach. Here is a link >> to the most up-to-date proposal: >> >> https://github.com/bitcoin/bips/pull/1324 >> >> If you have concept or approach feedback, *please respond on the >> mailing list* to allow everybody to view and participate in the >> discussion. If you find a typo or inaccurate wording, please feel free >> to leave suggestions on the PR. >> >> I=E2=80=99m also working on an implementation for Bitcoin Core. >> >> >> The rest of this post will include the same contents as the proposal, >> with a bit of reordering and additional context. If you are not 100% >> up-to-date on package relay and find the proposal hard to follow, I >> hope you find this format more informative and persuasive. >> >> >> =3D=3DBackground and Motivation=3D=3D >> >> Users may create and broadcast transactions that depend upon, i.e. >> spend outputs of, unconfirmed transactions. A =E2=80=9Cpackage=E2=80=9D = is the >> widely-used term for a group of transactions representable by a >> connected Directed Acyclic Graph (where a directed edge exists between >> a transaction that spends the output of another transaction). >> >> Incentive-compatible mempool and miner policies help create a fair, >> fee-based market for block space. While miners maximize transaction >> fees in order to earn higher block rewards, non-mining users >> participating in transaction relay reap many benefits from employing >> policies that result in a mempool with the same contents, including >> faster compact block relay and more accurate fee estimation. >> Additionally, users may take advantage of mempool and miner policy to >> bump the priority of their transactions by attaching high-fee >> descendants (Child Pays for Parent or CPFP). Only considering >> transactions one at a time for submission to the mempool creates a >> limitation in the node's ability to determine which transactions have >> the highest feerates, since it cannot take into account descendants >> until all the transactions are in the mempool. Similarly, it cannot >> use a transaction's descendants when considering which of two >> conflicting transactions to keep (Replace by Fee or RBF). >> >> When a user's transaction does not meet a mempool's minimum feerate >> and they cannot create a replacement transaction directly, their >> transaction will simply be rejected by this mempool. They also cannot >> attach a descendant to pay for replacing a conflicting transaction. >> This limitation harms users' ability to fee-bump their transactions. >> Further, it presents a security issue in contracting protocols which >> rely on **presigned**, time-sensitive transactions to prevent cheating >> (HTLC-Timeout in LN Penalty [1] [2] [3], Unvault Cancel in Revault >> [4], Refund Transaction in Discreet Log Contracts [5], Updates in >> eltoo [6]). In other words, a key security assumption of many >> contracting protocols is that all parties can propagate and confirm >> transactions in a timely manner. >> >> In the past few years, increasing attention [0][1][2][3][6] has been >> brought to **pinning attacks**, a type of censorship in which the >> attacker uses mempool policy restrictions to prevent a transaction >> from being relayed or getting mined. TLDR: revocation transactions >> must meet a certain confirmation target to be effective, but their >> feerates are negotiated well ahead of broadcast time. If the >> forecasted feerate was too low and no fee-bumping options are >> available, attackers can steal money from their counterparties. I walk >> through a concrete example for stealing Lightning HTLC outputs at >> ~23:58 in this talk [7][8]. Note that most attacks are only possible >> when the market for blockspace at broadcast time demands much higher >> feerates than originally anticipated at signing time. Always >> overestimating fees may sidestep this issue temporarily (while mempool >> traffic is low and predictable), but this solution is not foolproof >> and wastes users' money. The feerate market can change due to sudden >> spikes in traffic (e.g. huge 12sat/vB dump a few days ago [9]) or >> sustained, high volume of Bitcoin payments (e.g. April 2021 and >> December 2017). >> >> The best solution is to enable nodes to consider packages of >> transactions as a unit, e.g. one or more low-fee parent transactions >> with a high-fee child, instead of separately. A package-aware mempool >> policy can help determine if it would actually be economically >> rational to accept a transaction to the mempool if it doesn't meet fee >> requirements individually. Network-wide adoption of these policies >> would create a more purely-feerate-based market for block space and >> allow contracting protocols to adjust fees (and therefore mining >> priority) at broadcast time. Some support for packages has existed in >> Bitcoin Core for years. Since v0.13, Bitcoin Core has used ancestor >> packages instead of individual transactions to evaluate the incentive >> compatibility of transactions in the mempool [10] and select them for >> inclusion in blocks [11]. >> >> Package Relay, the concept of {announcing, requesting, downloading} >> packages between nodes on the p2p network, has also been discussed for >> many years. The earliest public mention I can find is from 2015 [12]. >> The two most common use cases for package relay are fee-bumping >> otherwise-too-low-fee transactions and reducing the amount of orphans. >> It seems uncontroversial to say that everybody desires package relay >> conceptually, with varying degrees of urgency. Lots of work has been >> done by others over the past few years, from which I've taken >> inspiration from [13][14][15][16]. >> >> My approach has been to split the project into two components: (1) Packa= ge >> Mempool Accept, which includes validation logic and mempool policy. >> (3) Package Relay, which includes the p2p protocol changes. >> >> Progress so far: >> After discussions with various developers of contracting protocols >> (with heavier emphasis towards LN), it was determined that a >> package containing a child with all of its unconfirmed parents >> (child-with-unconfirmed-parents or 1-child-multi-parent package) would >> be sufficient for their use case, i.e. fee-bumping presigned >> transactions. A child-with-unconfirmed-parents package has several >> properties that make many things easier to reason about. >> >> A few months ago, I proposed a set of policies for safe package >> validation and fee assessment for packages of this restricted >> topology [17]. A series of PRs implementing this proposal have >> been merged into Bitcoin Core [18]. >> >> Theoretically, developing a safe and incentive-compatible package >> mempool acceptance policy is sufficient to solve this issue. Nodes >> could opportunistically accept packages (e.g. by trying combinations >> of transactions rejected from their mempools), but this practice would >> likely be inefficient at best and open new Denial of Service attacks >> at worst. Additional p2p messages may enable nodes to request and >> share package validation-related information with one another in a >> more communication-efficient way. >> >> Given that only package RBF remains for package mempool accept, and we >> can make progress on p2p and mempool in parallel, I think it=E2=80=99s >> appropriate to put forward a package relay proposal. >> >> =3D=3DProposal=3D=3D >> >> This proposal contains 2 components: a =E2=80=9Cgeneric=E2=80=9D package= relay >> protocol and an extension of it, child-with-unconfirmed-parents >> packages, as version 1 package relay. Another version of packages, >> =E2=80=9Ctx-with-unconfirmed-ancestors=E2=80=9D can be created to extend= package relay >> for eliminating orphans. >> >> =3D=3D=3DGeneric Package Relay=3D=3D=3D >> >> Two main ideas are introduced: >> >> Download and validate packages of transactions together. >> >> Provide information to help peers decide whether to request and/or how >> to validate transactions which are part of a package. >> >> =3D=3D=3D=3DIntended Protocol Flow=3D=3D=3D=3D >> >> Due to the asynchronous nature of a distributed transaction relay >> network, nodes may not receive all of the information needed to >> validate a transaction at once. For example, after a node completes >> Initial Block Download (IBD) and first starts participating in >> transaction relay with an empty mempool, it is common to receive >> orphans. In such scenarios where a node is aware that it is missing >> information, a ''receiver-initiated'' dialogue is appropriate: >> >> 1. Receiver requests package information. >> >> 2. The sender provides package information, including the wtxids of >> the transactions in the package and anything else that might be >> relevant (e.g. total fees and size). >> >> 3. The reciever uses the package information to decide how to request >> and validate the transactions. >> >> Sometimes, no matter what order transactions are received by a node, >> validating them individually is insufficient. When the sender is aware >> of additional information that the receiver needs to accept a package, >> a proactive ''sender-initiated'' dialogue should be enabled: >> >> 1. Sender announces they have package information pertaining to a >> transaction that might otherwise be undesired on its own. >> >> 2. The receiver requests package information. >> >> 3. The sender provides package information, including the wtxids of >> the transactions in the package and anything else that might be >> relevant (e.g. total fees and size). >> >> 4. The reciever uses the package information to decide how to request >> and validate the transactions. >> >> Package relay is negotiated between two peers during the version >> handshake. Package relay requires both peers to support wtxid-based >> relay because package transactions are referenced by their wtxid. >> >> =3D=3D=3D=3DNew Messages=3D=3D=3D=3D >> >> Three new protocol messages are added for use in any version of >> package relay. Additionally, each version of package relay must define >> its own inv type and "pckginfo" message version, referred to in this >> document as "MSG_PCKG" and "pckginfo" respectively. See >> BIP-v1-packages for a concrete example. >> >> =3D=3D=3D=3D=3Dsendpackages=3D=3D=3D=3D=3D >> >> {| >> | Field Name || Type || Size || Purpose >> |- >> |version || uint32_t || 4 || Denotes a package version supported by the >> node. >> |- >> |max_count || uint32_t || 4 ||Specifies the maximum number of >> transactions per package this node is >> willing to accept. >> |- >> |max_weight || uint32_t || 4 ||Specifies the maximum total weight per >> package this node is willing >> to accept. >> |- >> |} >> >> 1. The "sendpackages" message has the structure defined above, with >> pchCommand =3D=3D "sendpackages". >> >> 2. During version handshake, nodes should send a "sendpackages" >> message indicate they support package relay and may request >> packages. >> >> 3. The message should contain a version supported by the node. Nodes >> should send a "sendpackages" message for each version they support. >> >> 4. The "sendpackages" message MUST be sent before sending a "verack" >> message. If a "sendpackages" message is received afer "verack", the >> sender should be disconnected. >> >> 5. If 'fRelay=3D=3Dfalse' in a peer's version message, the node must not >> send "sendpackages" to them. If a "sendpackages" message is >> received by a peer after sending `fRelay=3D=3Dfalse` in their version >> message, the sender should be disconnected. >> >> 6.. Upon receipt of a "sendpackages" message with a version that is >> not supported, a node must treat the peer as if it never received the >> message. >> >> 7. If both peers send "wtxidrelay" and "sendpackages" with the same >> version, the peers should announce, request, and send package >> information to each other. >> >> =3D=3D=3D=3D=3Dgetpckgtxns=3D=3D=3D=3D=3D >> >> {| >> | Field Name || Type || Size || Purpose >> |- >> |txns_length||CompactSize||1 or 3 bytes|| The number of transactions >> requested. >> |- >> |txns||List of wtxids||txns_length * 32|| The wtxids of each transaction >> in the package. >> |} >> >> 1. The "getpckgtxns" message has the structure defined above, with >> pchCommand =3D=3D "getpckgtxns". >> >> 2. A "getpckgtxns" message should be used to request all or some of >> the transactions previously announced in a "pckginfo" message, >> specified by witness transactiosome id. >> >> 3. Upon receipt of a "getpckgtxns" message, a node must respond with >> either a "pckgtxns" containing the requested transactions or a >> "notfound" message indicating one or more of the transactions is >> unavailable. This allows the receiver to avoid downloading and storing >> transactions that cannot be validated immediately. >> >> 4. A "getpckgtxns" message should only be sent if both peers agreed to >> send packages in the version handshake. If a "getpckgtxns" message >> is received from a peer with which package relay was not negotiated, >> the sender should be disconnected. >> >> =3D=3D=3D=3D=3Dpckgtxns=3D=3D=3D=3D=3D >> >> {| >> | Field Name || Type || Size || Purpose >> |- >> |txns_length||CompactSize||1 or 3 bytes|| The number of transactions >> provided. >> |- >> |txns||List of transactions||variable|| The transactions in the package. >> |} >> >> 1. The "pckgtxns" message has the structure defined above, with >> pchCommand =3D=3D "pckgtxns". >> >> 2. A "pckgtxns" message should contain the transaction data requested >> using "getpckgtxns". >> >> 3. A "pckgtxns" message should only be sent to a peer that requested >> the package using "getpckgtxns". If a node receives an unsolicited >> package, the sender should be disconnected. >> >> 4. A "pckgtxns" message should only be sent if both peers agreed to >> send packages in the version handshake. If a "pckgtxns" message is >> received from a peer with which package relay was not negotiated, the >> sender should be disconnected. >> >> =3D=3D=3DVersion 1 Packages: child-with-unconfirmed-parents=3D=3D=3D >> >> This extends package relay for packages consisting of one transaction >> and all of its unconfirmed parents,by defining version 1 packages, a >> pckginfo1 message, and a MSG_PCKG1 inv type. It enables the use case >> in which a child pays for its otherwise-too-low-fee parents and their >> mempool conflict(s). >> >> =3D=3D=3D=3DIntended Protocol Flow=3D=3D=3D=3D >> >> When relaying a package of low-fee parent(s) and high-fee child, the >> sender and receiver do the following: >> >> 1. Sender announces they have a child-with-unconfirmed-parents package >> for a child that pays for otherwise-too-low-fee parent(s) using >> "inv(MSG_PCKG1)". >> >> 2. The receiver requests package information using >> "getdata(MSG_PCKG1)". >> >> 3. The sender provides package information using "pckginfo1", >> including the blockhash of the sender's best block, the wtxids of >> the transactions in the package, their total fees and total weight. >> >> 4. The reciever uses the package information to decide how to request >> the transactions. For example, if the receiver already has some of >> the transactions in their mempool, they only request the missing ones. >> They could also decide not to request the package at all based on the >> fee information provided. >> >> 5. Upon receiving a "pckgtxns", the receiver submits the transactions >> together as a package. >> >> =3D=3D=3D=3DNew Messages=3D=3D=3D=3D >> >> A new inv type, "MSG_PCKG1", and new protocol message, "PCKGINFO1", >> are added. >> >> =3D=3D=3D=3D=3Dpckginfo1=3D=3D=3D=3D=3D >> >> {| >> | Field Name || Type || Size || Purpose >> |- >> |blockhash || uint256 || 32 || The chain tip at which this package is >> defined. >> |- >> |pckg_fee||CAmount||4|| The sum total fees paid by all transactions in >> the package. >> |- >> |pckg_weight||int64_t||8|| The sum total weight of all transactions in >> the package. >> |- >> |txns_length||CompactSize||1 or 3 bytes|| The number of transactions >> provided. >> |- >> |txns||List of wtxids||txns_length * 32|| The wtxids of each transaction >> in the package. >> |} >> >> >> 1. The "pckginfo1" message has the structure defined above, with >> pchCommand =3D=3D "pckginfo1". >> >> 2. A "pckginfo1" message contains information about a version 1 >> package (defined below), referenced by the wtxid of the transaction >> it pertains to and the current blockhash. >> >> 3. Upon receipt of a "pckginfo1" message, the node should decide if it >> wants to validate the package, request transaction data if >> necessary, etc. >> >> 4. Upon receipt of a malformed "pckginfo1" message or package that >> does not abide by the max_count, max_weight, or other rules >> specified by the version agreed upon in the initial negotiation, the >> sender should be disconnected. If a node receives a "pckginfo1" >> message for which the "pckg_fee" or "pckg_weight" do not reflect the >> true total fees and weight, respectively, or the transactions in the >> package, the message is malformed. >> >> 5. A node MUST NOT send a "pckginfo1" message that has not been >> requested by the recipient. Upon receipt of an unsolicited >> "pckginfo1", a node should disconnect the sender. >> >> 6. A "pckginfo1" message should only be sent if both peers agreed to >> send version 1 packages in the version handshake. If a "pckginfo1" >> message is received from a peer with which package relay was not >> negotiated, the sender should be disconnected. >> >> =3D=3D=3D=3D=3DMSG_PCKG1=3D=3D=3D=3D=3D >> >> 1. A new inv type (MSG_PCKG1 =3D=3D 0x6) is added, for use in inv messag= es >> and getdata requests pertaining to version 1 packages. >> >> 2. As an inv type, it indicates that both transaction data and version >> 1 package information are available for the transaction. The >> transaction is referenced by its wtxid. As a getdata request type, it >> indicates that the sender wants package information for the >> transaction. >> >> 3. Upon receipt of a "getdata" request for "MSG_PCKG1", the node >> should respond with the version 1 package corresponding to the >> requested transaction and its current chain tip, or with NOTFOUND. >> The node should not assume that the sender is requesting the >> transaction data as well. >> >> =3D=3D=3D=3DChild With Parent Packages Rules=3D=3D=3D=3D >> >> A child-with-unconfirmed-parents package sent between nodes must abide >> by the rules below, otherwise the package is malformed and the sender >> should be disconnected. >> >> A version 1 or ''child-with-unconfirmed-parents'' package can be >> defined for any transaction that spends unconfirmed inputs. The child >> can be thought of as the "representative" of the package. This package >> can be uniquely identified by the transaction's wtxid and the current >> chain tip block hash. >> >> A ''child-with-unconfirmed-parents'' package MUST be: >> >> 1. ''Sorted topologically.'' For every transaction t in the package, >> if any of t's parents are present in the package, the parent must >> appear somewhere in the list before t. In other words, the >> transactions must be sorted in ascending order of the number of >> ancestors present in the package. >> >> 2. ''Only 1 child with unconfirmed parents.'' The package must consist >> of one transaction and its unconfirmed parents. There must not be >> any other transactions in the package. Other dependency relationships >> may exist within the package (e.g. one parent may spend the output of >> another parent) provided that topological order is respected. >> >> 3. ''All unconfirmed parents.'' All of the child's unconfirmed parents >> must be present. >> >> 4. ''No conflicts.'' None of the transactions in the package may >> conflict with each other (i.e. spend the same prevout). >> >> 5. ''Total fees and weight.'' The 'total_fee' and 'total_weight' >> fields must accurately represent the sum total of all transactions' >> fees and weights as defined in BIP141, respectively. >> >> Not all of the child's parents must be present; the child transaction >> may also spend confirmed inputs. However, if the child has confirmed >> parents, they must not be in the package. >> >> While a child-with-unconfirmed-parents package is perhaps most >> relevant when the child has a higher feerate than its parents, this >> property is not required to construct a valid package. >> >> =3D=3D=3D=3DClarifications=3D=3D=3D=3D >> >> ''Q: Under what circumstances should a sender announce a >> child-with-unconfirmed-parents package?'' >> >> A child-with-unconfirmed-parents package for a transaction should be >> announced when it meets the peer's fee filter but one or more of its >> parents don't; a "inv(MSG_PCKG1)" instead of "inv(WTX)" should be sent >> for the child. Each of the parents which meet the peer's fee filter >> should still be announced normally. >> >> ''Q: What if a new block arrives in between messages?'' >> >> A child-with-unconfirmed-parents package is defined for a transaction >> based on the current chain state. As such, a new block extending the >> tip may decrease the number of transactions in the package (i.e. if >> any of the transaction's parents were included in the block). In a >> reorg, the number of transactions in the package may decrease or >> increase (i.e. if any of the transaction's parents were included in a >> block in the previous chain but not the new one). >> >> If the new block arrives before the "getdata" or "pckginfo1", nothing >> needs to change. >> >> If the new block arrives before "getpckgtxns" or before "pckgtxns", >> the receiver may need to re-request package information if the block >> contained a transaction in the package. If the block doesn't contain >> any transactions in the package, whether it extends the previous tip >> or causes a reorg, nothing needs to change. >> >> ''Q: Can "getpckgtxns" and "pckgtxns" messages contain only one >> transaction?'' >> >> Yes. >> >> =3D=3D=3DFurther Protocol Extensions=3D=3D=3D >> >> When introducing a new type of package, assign it a version number "n" >> and use an additional "sendpackages" message during version handshake >> to negotiate support for it. An additional package information message >> "pckginfon" and inv type "MSG_PCKGn" should be defined for the type of >> package. However, "getpckgtxns" and "pckgtxns" do not need to be >> changed. >> >> Example proposal for tx-with-unconfirmed-ancestors package relay: [19] >> >> =3D=3D=3DCompatibility=3D=3D=3D >> >> Older clients remain fully compatible and interoperable after this >> change. Clients implementing this protocol will only attempt to send >> and request packages if agreed upon during the version handshake. >> >> =3D=3D=3DPackage Erlay=3D=3D=3D >> >> Clients using BIP330 reconciliation-based transaction relay (Erlay) >> are able to use package relay without interference. In fact, a package >> of transactions may be announced using both Erlay and package relay. >> After reconciliation, if the initiator would have announced a >> transaction by wtxid but also has package information for it, they may >> send "inv(MSG_PCKG)" instead of "inv(WTX)". >> >> =3D=3D=3DRationale=3D=3D=3D >> >> =3D=3D=3D=3DP2P Message Design=3D=3D=3D=3D >> >> These p2p messages are added for communication efficiency and, as >> such, one should measure alternative solutions based on the resources >> used to communicate (not necessarily trustworthy) information: We >> would like to minimize network bandwidth, avoid downloading a >> transaction more than once, avoid downloading transactions that are >> eventually rejected, and minimize storage allocated for >> not-yet-validated transactions. >> >> Consider these (plausible) scenarios in transaction relay: >> >> Alice (the "sender") is relaying transactions to Bob (the "receiver"). >> Alice's mempool has a minimum feerate of 1sat/vB and Bob's has a >> minimum feerate of 3sat/vB. For simplicity, all transactions are >> 1600Wu in virtual size and 500 bytes in serialized size. Apart from >> the spending relationships specified, all other inputs are from >> confirmed UTXOs. >> >> 1. Package {A, B} where A pays 0 satoshis and B pays 8000 satoshis in >> fees. >> >> 2. Package {C, D} where C pays 0 satoshis and D pays 1200 satoshis in >> fees. >> >> 3. Package {E, F, G, H, J} that pays 4000, 8000, 0, 2000, and 4000 >> satoshis in fees, respectively. >> >> =3D=3D=3D=3DAlternative Designs Considered=3D=3D=3D=3D >> >> ''Package Information Only:'' Just having "pckginfo" gives enough >> information for the receiver to accept the package. Omit the >> "getpckgtxns" and "pckgtxns" messages. While this option is a good >> fallback if batched transaction download fails for some reason, it >> shouldn't be used as the default because it 'always' requires storage >> of unvalidated transactions. >> >> ''No Package Information Round:'' Instead of having a package >> information round, just use the child's wtxid to refer to the package >> and always send the entire package together. This would cause nodes to >> redownload duplicate transactions. >> >> I have also created a slidedeck exploring various alternative designs >> and some examples in which they fall flat [20]. Please feel free to >> suggest other alternatives. >> >> =3D=3D=3D=3DVersioning System=3D=3D=3D=3D >> >> This protocol should be extensible to support multiple types of >> packages based on future desired use cases. Two "flavors" of >> versioning were considered: >> >> 1. When package mempool acceptance is upgraded to support more types >> of packages, increment the version number (similar to Erlay). >> During version handshake, peers negotiate which version of package >> relay they will use by each sending one "sendpackages" message. >> >> 2. When introducing another type of package, assign a version number >> to it and announce it as an additional supported version (similar >> to Compact Block Relay). During version handshake, peers send one >> "sendpackages" message for each version supported. >> >> The second option was favored because it allows different parameters >> for different versions. For example, it should be possible to support >> both "arbitrary topology but maximum 3-transaction" package as well as >> "child-with-unconfirmed-parents with default mempool ancestor limits" >> packages simultaneously. >> >> =3D=3DAcknowledgements=3D=3D >> >> I hope to have made it abundantly clear that this proposal isn=E2=80=99t >> inventing the concept of package relay, and in fact builds upon years >> of work by many others, including Suhas Daftuar and Antoine Riard. >> >> Thank you to John Newbery and Martin Zumsande for input on the design. >> >> Thank you to Matt Corallo, Christian Decker, David Harding, Antoine >> Poinsot, Antoine Riard, Gregory Sanders, Chris Stewart, Bastien >> Teinturier, and others for input on the desired interface for >> contracting protocols. >> >> Looking forward to hearing your thoughts! >> >> Best, >> Gloria >> >> [0]: >> https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2022-January/019= 817.html >> [1]: >> https://lists.linuxfoundation.org/pipermail/lightning-dev/2020-April/002= 639.html >> [2]: >> https://lists.linuxfoundation.org/pipermail/lightning-dev/2020-June/0027= 58.html >> [3]: >> https://github.com/t-bast/lightning-docs/blob/master/pinning-attacks.md >> [4]: >> https://github.com/revault/practical-revault/blob/master/transactions.md= #cancel_tx >> [5]: >> https://github.com/discreetlogcontracts/dlcspecs/blob/master/Transaction= s.md#refund-transaction >> [6]: https://gist.github.com/instagibbs/60264606e181451e977e439a49f69fe1 >> [7]: >> https://btctranscripts.com/adopting-bitcoin/2021/2021-11-16-gloria-zhao-= transaction-relay-policy/#lightning-attacks >> [8]: https://youtu.be/fbWSQvJjKFs?t=3D1438 >> [9]: >> https://www.reddit.com/r/Bitcoin/comments/unew4e/looks_like_70_mvb_of_tr= ansactions_just_got_dumped/ >> [10]: https://github.com/bitcoin/bitcoin/pull/7594 >> [11]: https://github.com/bitcoin/bitcoin/pull/7600 >> [12]: https://github.com/bitcoin/bitcoin/pull/6455#issuecomment-12271682= 0 >> [13]: https://gist.github.com/sdaftuar/8756699bfcad4d3806ba9f3396d4e66a >> [14]: https://github.com/bitcoin/bitcoin/issues/14895 >> [15]: https://github.com/bitcoin/bitcoin/pull/16401 >> [16]: https://github.com/bitcoin/bitcoin/pull/19621 >> [17]: >> https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2021-September/0= 19464.html >> [18]: https://github.com/users/glozow/projects/5/views/4?layout=3Dboard >> [19]: https://gist.github.com/glozow/9b321cd3ef6505135c763112033ff2a7 >> [20]: >> https://docs.google.com/presentation/d/1B__KlZO1VzxJGx-0DYChlWawaEmGJ9EG= ApEzrHqZpQc/edit?usp=3Dsharing >> _______________________________________________ >> bitcoin-dev mailing list >> bitcoin-dev@lists.linuxfoundation.org >> https://lists.linuxfoundation.org/mailman/listinfo/bitcoin-dev >> > --000000000000da95c205ec6c8a69 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi everyone,

I've made some significant ch= anges to my package relay proposal based on observations while implementing= , feedback on this thread, and offline discussions [1].

The new proposal is called Ancestor Package Relay, BIP331, and PR'= ;d at https://github.com/bitcoin/bips/pull/1382

The major cha= nges to the proposal are:
1. Scope reduction to receiver-initiated only<= br>2. Scope reduction to ancestor packages only
3. Removal of block hash= from package information

1.=C2=A0 Scope reduction to receiver-= initiated only
Receiver-intiated package relay enables a node to ask f= or more information when they suspect they are missing something (i.e. in t= his case to resolve a missing parent tx). Sender-initiated package relay sh= ould, theoretically, save a round trip by notifying the receiver ahead of t= ime that "hey, this is going to be a package, so make sure you downloa= d and submit these transactions together." As with any proactive commu= nication, there is a chance that the node already knows this information, s= o this network bandwidth was wasted. The logic used to decide _when_ to ann= ounce a package proactively determines whether it is a net increase or decr= ease for overall bandwidth usage. However, it's difficult to design any= thing to save bandwidth without any idea of what its bandwidth usage actual= ly looks like in practice. We'll want to design the sender-initiated pr= otocol carefully, and inform the design decisions using data collected from= the mainnet p2p network. However, there is no historical transaction data = to use because the goal is to enable currently-rejected transactions to pro= pagate. In order to get this right, I propose we hold off on sender-initiat= ed for now, deploy receiver-initiated package relay, observe its usage and = figure out where we can save a round trip, and then produce a well-research= ed sender-initiated package relay proposal.

2. Scope reduction to an= cestor packages only
The proposal now only includes ancestor packages (p= reviously called tx-with-unconfirmed-ancestors or "v2" packages).= The child-with-unconfirmed-parents (previously called "v1") pack= age has been removed since it is a subset of ancestor packages and sender-i= nitiated relay has been removed. It may be relevant again in the future wit= h sender-initiated packages. If you were reviewing the previous proposal, &= quot;pkginfo2" message has been renamed to "ancpkginfo" and = "MSG_PKGINFO2" inv type to "MSG_ANCPKGINFO".

3. = Removal of block hash from package information
Most of the rationale is = already on this thread. The block hash was an attempt to enforce topology w= hen chainstates differ, but isn't worth it. It does not make much sense= to drop or delay transaction data requests due to mismatched chainstates, = and the chainstate may change again between package information and transac= tion data rounds. Instead, differences in chainstate should be handled inte= rnally at the mempool validation level. The node should de-duplicate recent= ly-confirmed transactions and make a best effort to validate the transactio= ns it has already downloaded.

Thanks,
Gloria

[1] https://diyhpl.us/wiki/transcripts/bitcoin-c= ore-dev-tech/2022-10-11-package-relay/

On Fri, Jun 17, 2022 at 9:08 PM A= ntoine Riard <antoine.riard@gmail.com> wrote:
Hi Gloria,

Thanks fo= r working on that,

> Always overestimating fees may sidestep this= issue temporarily (while mempool
> traffic is low and predictable), = but this solution is not foolproof
> and wastes users' money. The= feerate market can change due to sudden
> spikes in traffic (e.g. hu= ge 12sat/vB dump a few days ago [9]) or
> sustained, high volume of B= itcoin payments (e.g.=C2=A0 April 2021 and
> December 2017).

E= ven if the LN implementations started to overestimate fees based on the his= torical worst-case of block inclusion feerates, there is still room for exp= loitation due to bip125 rule#3. Indeed, as long as the adversary is able to= stick in the mempool a higher fee package while the feerate is not compell= ing enough to get it mined, your "honest" LN package should be bo= unced off.

Considering Core's `MAX_STANDARD_TX_WEIGHT` of 400000= WU, I think it's practical for an attacker to succeed with this pinnin= g tactic in periods of traffic spikes. Of course, LN implementation could o= verestimate fees with a target like `MAX_STANDARD_WEIGHT` * `worst_case_blo= ck_inclusion_feerate` to mitigate. However, assuming a value of 20sat for t= he latter, it would require from any LN user a minimal channel value of 200= 0000 satoshis to be theoretically secure against this type of pinning.
<= br>So package relay is required to mitigate efficiently and realistically a= gainst pinning attacks, while conserving the same level of "economic&q= uot; openness for Lightning. Beyond, it should be also noted that package r= elay is only building block of the full set of mitigations, and there shoul= d be a yet to-find-consensus-as-of-today other policy change such as user-e= lected package limits or replace-by-feerate.

Anyway, I think it woul= d be beneficial to document the design trade-offs of pinning mitigations in= the `Rationale` subsection, at the attention of future L2s devs and users = ?

> {|
> | =C2=A0Field Name =C2=A0|| =C2=A0Type =C2=A0|| = =C2=A0Size =C2=A0|| =C2=A0Purpose
> |-
> |version || uint32_t |= | 4 || Denotes a package version supported by the
> node.
> |-<= br>> |max_count || uint32_t || 4 ||Specifies the maximum number of trans= actions
> per package this node is
> willing to accept.
>= |-
> |max_weight || uint32_t || 4 ||Specifies the maximum total weig= ht per
> package this node is willing
> to accept.
> |-> |}

It's unclear to me what's the purpose of `max_coun= t` and `max_weight` in the overall package relay flow, if they are intended= to be exposed as configurable settings to node operators. If those fields = are present to allow DoS protection increase of low-performance host, I bel= ieve it would be better to restrain the number of consumed UTXOs or execute= d sigops per package, as DoS vectors are more likely to be CPU-based, rathe= r than memory-based as package size already bounded at acceptance by `MAX_P= ACKAGE_COUNT`.

Thinking more we might introduce a `MAX_SIGOPS_PER_PA= CKAGR` limit, as otherwise if we naively grant one package announcement as = equal to one transaction announcement in our tx-request logic, we might inc= rease our DoS surface, node ressources staying equivalent ?

> {|<= br>> | =C2=A0Field Name =C2=A0|| =C2=A0Type =C2=A0|| =C2=A0Size =C2=A0||= =C2=A0 Purpose
> |-
> |txns_length||CompactSize||1 or 3 bytes|= | The number of transactions
> requested.

I'm not sure if = we'll ever allow 3-bytes of package size, that would be ~32k of transac= tions.

> |-
> |txns||List of wtxids||txns_length * 32|| The= wtxids of each transaction in
> the package.
> |}

I thi= nk there is a bandwidth consumption trade-off to be aware of in the functio= n of the package-relay usage. Let's consider a single issuer broadcasti= ng the package to spend a shared-utxo, after the first shot the parent comp= onent should be spread across the network mempools. At each fee-bump, only = the bumped CPFP will propagate on the network, the parent wtxid is reannoun= ced in `pckginfo1` though there is no need to fetch it redundantly and wast= e bandwidth.

However, I think the bandwidth saving does not hold in = case of competing transaction issuers to spend a shared-utxo. In that case,= the parent might differ at each broadcast and the list of wtxid is dissemb= lable at every claim of the shared-utxo. We could save the 32 bytes * numbe= r of packages elements by announcing a package_id, computed from the list o= f wtxids.

I don't know about the occurrence of competing broadca= sts among LN non-cooperative closes, where bandwidth could be potentially s= aved. I would say it's likely low because IIRC there is nothing in the = LN protocol where the counterparties signal to each other they're going= on-chain to introduce a competing broadcast synchronizing event. That said= , it might increase in the future in a post-eltoo, multi-party contracting = protocol world.

So it might be interesting to document this design t= rade-off, if we seek bandwidth optimizations in function of a changing land= scape in the type of transaction issuers in the future.

> 3. The = sender provides package information using "pckginfo1",
> = =C2=A0 =C2=A0including the blockhash of the sender's best block, the wt= xids of
> the transactions in the package, their total fees and total= weight.

It's unclear to me how the `pckinfo1` receiver should p= roceed if the sender's best block is not in sync with the local chain t= ip.

If the package isn't processed further, that's annoying= for all the low-performance=C2=A0 LN mobile clients, their chain tips migh= t be always behind by few blocks from the p2p network nodes. It sounds like= their packages won't propagate at all.

If the package is proces= sed further whatever the sender-receiver sync on chain tip, what's the = purpose of including the blockhash ?

> A child-with-unconfirmed-p= arents package for a transaction should be
> announced when it meets = the peer's fee filter but one or more of its
> parents don't;= a "inv(MSG_PCKG1)" instead of "inv(WTX)" should be sen= t
> for the child. Each of the parents which meet the peer's fee = filter
> should still be announced normally.

I believe we migh= t have concerns of package-feerate downgrades attacks. E.g, in the LN conte= xt, where your channel counterparty is aiming to jam the propagation of the= best-feerate version of the package.

Let's say you have :
- = Alice's commitment_tx, at 1s/vB
- package A + child B, at 3s/vB
-= package A + child C, at 10s/vB
- block inclusion feerate at 10s/vB
-= Alice and Mallory are LN channel counterparties
- commitment_tx is usin= g LN's anchor outputs

Alice's LN node broadcasts A+C to her = mempool.
Bob's feefilter is at 3s/vB.
Mallory broadcasts her chil= d B in Alice's mempool.
LN commitment does not meet Bob's feefil= ter.
Package A+child B at 3s/vB meets Bob's feefilter and is announc= ed to Bob.
Mallory broadcasts her own commitment_tx at 4s/vB in Bob'= s mempool.
When Alice's child C is relayed to Bob, it's bounced = off Bob's mempool.

Do you think this situation is plausible ? Of= course, it might be heavily dependent on package-relay yet-not-implemented= internal p2p logic.
I think it could be fixable if LN removes the count= erparty's `anchor_output` on the local node's version of the commit= ment transaction, once package relay is deployed.

Another question, = at the next fee-bump iteration, Alice rebroadcasts A+child D, at 12 s/vB. H= er node has already marked Alice's commitment_tx as known in Bob's = `m_tx_inventory_known_filter`. So when a new higher fee child is=C2=A0 disc= overed, should a `child-with-unconfirmed-parents` be announced between Alic= e and Bob ?

Anyway, I think it would be interesting to pseudo-specif= y the package-assemblage algorithm (or if there is code already available) = to see if it's robust against adversarial or unlucky situations ?
> In fact, a package
> of transactions may be announced using bo= th Erlay and package relay.
> After reconciliation, if the initiator = would have announced a
> transaction by wtxid but also has package in= formation for it, they may
> send "inv(MSG_PCKG)" instead o= f "inv(WTX)".

Yes, I think this holds. Note, we might have= to add to the reconciliation set low-fee parents succeeding the feefilter = check due to a child. When the reconcildiff, we might have to bifucarte aga= in on feefilter to decide to announce missing wtixds either as `inv(MSG_PCK= G)` or `inv(WTX)`.

(IIRC, I've already made few feedbacks = offline though good to get them in the public space and think more)

Antoine

Le=C2=A0mar. 17 mai 2022 =C3=A0=C2=A012:09, Gloria Zh= ao via bitcoin-dev <bitcoin-dev@lists.linuxfoundation.org> a =C3= =A9crit=C2=A0:
<= div dir=3D"ltr">Hi everybody,

I=E2=80=99m writing to propose a set o= f p2p protocol changes to enable package
relay, soliciting feedback on t= he design and approach. Here is a link
to the most up-to-date proposal:<= br>
https://github.com/bitcoin/bips/pull/1324

If you have concep= t or approach feedback, *please respond on the
mailing list* to allow ev= erybody to view and participate in the
discussion. If you find a typo or= inaccurate wording, please feel free
to leave suggestions on the PR.
I=E2=80=99m also working on an implementation for Bitcoin Core.


The rest of this post will include the same cont= ents as the proposal,
with a bit of reordering and additional context. I= f you are not 100%
up-to-date on package relay and find the proposal har= d to follow, I
hope you find this format more informative and persu= asive.


=3D=3DBackground and Motivation=3D=3D
Users may create and broadcast transactions that depend upon, i.e.
spen= d outputs of, unconfirmed transactions. A =E2=80=9Cpackage=E2=80=9D is the<= br>widely-used term for a group of transactions representable by a
conne= cted Directed Acyclic Graph (where a directed edge exists between
a tran= saction that spends the output of another transaction).

Incentive-co= mpatible mempool and miner policies help create a fair,
fee-based market= for block space. While miners maximize transaction
fees in order to ear= n higher block rewards, non-mining users
participating in transaction re= lay reap many benefits from employing
policies that result in a mempool = with the same contents, including
faster compact block relay and more ac= curate fee estimation.
Additionally, users may take advantage of mempool= and miner policy to
bump the priority of their transactions by attachin= g high-fee
descendants (Child Pays for Parent or CPFP).=C2=A0 Only consi= dering
transactions one at a time for submission to the mempool creates = a
limitation in the node's ability to determine which transactions h= ave
the highest feerates, since it cannot take into account descendants<= br>until all the transactions are in the mempool. Similarly, it cannot
u= se a transaction's descendants when considering which of two
conflic= ting transactions to keep (Replace by Fee or RBF).

When a user's= transaction does not meet a mempool's minimum feerate
and they cann= ot create a replacement transaction directly, their
transaction will sim= ply be rejected by this mempool. They also cannot
attach a descendant to= pay for replacing a conflicting transaction.
This limitation harms user= s' ability to fee-bump their transactions.
Further, it presents a se= curity issue in contracting protocols which
rely on **presigned**, time-= sensitive transactions to prevent cheating
(HTLC-Timeout in LN Penalty [= 1] [2] [3], Unvault Cancel in Revault
[4], Refund Transaction in Discree= t Log Contracts [5], Updates in
eltoo [6]). In other words, a key securi= ty assumption of many
contracting protocols is that all parties can prop= agate and confirm
transactions in a timely manner.

In the past fe= w years, increasing attention [0][1][2][3][6] has been
brought to **pinn= ing attacks**, a type of censorship in which the
attacker uses mempool p= olicy restrictions to prevent a transaction
from being relayed or gettin= g mined.=C2=A0 TLDR: revocation transactions
must meet a certain confirm= ation target to be effective, but their
feerates are negotiated well ahe= ad of broadcast time. If the
forecasted feerate was too low and no fee-b= umping options are
available, attackers can steal money from their count= erparties. I walk
through a concrete example for stealing Lightning HTLC= outputs at
~23:58 in this talk [7][8].=C2=A0 Note that most attacks are= only possible
when the market for blockspace at broadcast time =C2=A0de= mands much higher
feerates than originally anticipated at signing time. = Always
overestimating fees may sidestep this issue temporarily (while me= mpool
traffic is low and predictable), but this solution is not foolproo= f
and wastes users' money. The feerate market can change due to sudd= en
spikes in traffic (e.g. huge 12sat/vB dump a few days ago [9]) or
= sustained, high volume of Bitcoin payments (e.g.=C2=A0 April 2021 and
De= cember 2017).

The best solution is to enable nodes to consider packa= ges of
transactions as a unit, e.g. one or more low-fee parent transacti= ons
with a high-fee child, instead of separately. A package-aware mempoo= l
policy can help determine if it would actually be economically
rati= onal to accept a transaction to the mempool if it doesn't meet fee
r= equirements individually. Network-wide adoption of these policies
would = create a more purely-feerate-based market for block space and
allow cont= racting protocols to adjust fees (and therefore mining
priority) at broa= dcast time.=C2=A0 Some support for packages has existed in
Bitcoin Core = for years. Since v0.13, Bitcoin Core has used ancestor
packages instead = of individual transactions to evaluate the incentive
compatibility of tr= ansactions in the mempool [10] and select them for
inclusion in blocks [= 11].

Package Relay, the concept of {announcing, requesting, download= ing}
packages between nodes on the p2p network, has also been discussed = for
many years. The earliest public mention I can find is from 2015 [12]= .
The two most common use cases for package relay are fee-bumping
oth= erwise-too-low-fee transactions and reducing the amount of orphans.
It s= eems uncontroversial to say that everybody desires package relay
concept= ually, with varying degrees of urgency. Lots of work has been
done by ot= hers over the past few years, from which I've taken
inspiration from= [13][14][15][16].

My approach has been to split the project into tw= o components: (1) Package
Mempool Accept, which includes validation logi= c and mempool policy.
(3) Package Relay, which includes the p2p protocol= changes.

Progress so far:
After discussions with various develop= ers of contracting protocols
(with heavier emphasis towards LN), it was = determined that a
package containing a child with all of its unconfirmed= parents
(child-with-unconfirmed-parents or 1-child-multi-parent package= ) would
be sufficient for their use case, i.e. fee-bumping presigned
= transactions. A child-with-unconfirmed-parents package has several
prope= rties that make many things easier to reason about.

A few months ago= , I proposed a set of policies for safe package
validation and fee asses= sment for packages of this restricted
topology [17]. A series of PR= s implementing this proposal have
been merged into Bitcoin Core [= 18].

Theoretically, developing a safe and incentive-compatible= package
mempool acceptance policy is sufficient to solve this issue. No= des
could opportunistically accept packages (e.g. by trying combinations=
of transactions rejected from their mempools), but this practice would<= br>likely be inefficient at best and open new Denial of Service attacks
= at worst. Additional p2p messages may enable nodes to request and
share = package validation-related information with one another in a
more commun= ication-efficient way.

Given that only package RBF remains for packa= ge mempool accept, and we
can make progress on p2p and mempool in parall= el, I think it=E2=80=99s
appropriate to put forward a package relay prop= osal.

=3D=3DProposal=3D=3D

This proposal contains 2 component= s: a =E2=80=9Cgeneric=E2=80=9D package relay
protocol and an extension o= f it, child-with-unconfirmed-parents
packages, as version 1 package rela= y. Another version of packages,
=E2=80=9Ctx-with-unconfirmed-ancestors= =E2=80=9D can be created to extend package relay
for eliminating orphans= .

=3D=3D=3DGeneric Package Relay=3D=3D=3D

Two main ideas are = introduced:

Download and validate packages of transactions together.=

Provide information to help peers decide whether to request and/or = how
to validate transactions which are part of a package.

=3D=3D= =3D=3DIntended Protocol Flow=3D=3D=3D=3D

Due to the asynchronous nat= ure of a distributed transaction relay
network, nodes may not receive al= l of the information needed to
validate a transaction at once. For examp= le, after a node completes
Initial Block Download (IBD) and first starts= participating in
transaction relay with an empty mempool, it is common = to receive
orphans. In such scenarios where a node is aware that it is m= issing
information, a ''receiver-initiated'' dialogue is= appropriate:

1. Receiver requests package information.

2. Th= e sender provides package information, including the wtxids of
=C2=A0 = =C2=A0the transactions in the package and anything else that might be
re= levant (e.g. total fees and size).

3. The reciever uses the package = information to decide how to request
=C2=A0 =C2=A0and validate the trans= actions.

Sometimes, no matter what order transactions are received b= y a node,
validating them individually is insufficient. When the sender = is aware
of additional information that the receiver needs to accept a p= ackage,
a proactive ''sender-initiated'' dialogue should= be enabled:

1. Sender announces they have package information perta= ining to a
=C2=A0 =C2=A0transaction that might otherwise be undesired on= its own.

2. The receiver requests package information.

3. Th= e sender provides package information, including the wtxids of
=C2=A0 = =C2=A0the transactions in the package and anything else that might be
re= levant (e.g. total fees and size).

4. The reciever uses the package = information to decide how to request
=C2=A0 =C2=A0and validate the trans= actions.

Package relay is negotiated between two peers during the ve= rsion
handshake. Package relay requires both peers to support wtxid-base= d
relay because package transactions are referenced by their wtxid.
<= br>=3D=3D=3D=3DNew Messages=3D=3D=3D=3D

Three new protocol messages = are added for use in any version of
package relay. Additionally, each ve= rsion of package relay must define
its own inv type and "pckginfo&q= uot; message version, referred to in this
document as "MSG_PCKG&quo= t; and "pckginfo" respectively. See
BIP-v1-packages for a conc= rete example.

=3D=3D=3D=3D=3Dsendpackages=3D=3D=3D=3D=3D

{|| =C2=A0Field Name =C2=A0|| =C2=A0Type =C2=A0|| =C2=A0Size =C2=A0|| =C2= =A0Purpose
|-
|version || uint32_t || 4 || Denotes a package version = supported by the node.
|-
|max_count || uint32_t || 4 ||Specifies the= maximum number of transactions per package this node is
willing to acce= pt.
|-
|max_weight || uint32_t || 4 ||Specifies the maximum total wei= ght per package this node is willing
to accept.
|-
|}

1. Th= e "sendpackages" message has the structure defined above, with=C2=A0 =C2=A0pchCommand =3D=3D "sendpackages".

2. During = version handshake, nodes should send a "sendpackages"
=C2=A0 = =C2=A0message indicate they support package relay and may request
packag= es.

3. The message should contain a version supported by the node. N= odes
=C2=A0 =C2=A0should send a "sendpackages" message for eac= h version they support.

4. The "sendpackages" message MUST= be sent before sending a "verack"
=C2=A0 =C2=A0message. If a = "sendpackages" message is received afer "verack", thesender should be disconnected.

5. If 'fRelay=3D=3Dfalse' i= n a peer's version message, the node must not
=C2=A0 =C2=A0send &quo= t;sendpackages" to them. If a "sendpackages" message is
r= eceived by a peer after sending `fRelay=3D=3Dfalse` in their version
mes= sage, the sender should be disconnected.

6.. Upon receipt of a "= ;sendpackages" message with a version that is
not supported, a node= must treat the peer as if it never received the
message.

7. If b= oth peers send "wtxidrelay" and "sendpackages" with the= same
=C2=A0 =C2=A0version, the peers should announce, request, and send= package
information to each other.

=3D=3D=3D=3D=3Dgetpckgtxns=3D= =3D=3D=3D=3D

{|
| =C2=A0Field Name =C2=A0|| =C2=A0Type =C2=A0|| = =C2=A0Size =C2=A0|| =C2=A0 Purpose
|-
|txns_length||CompactSize||1 or= 3 bytes|| The number of transactions requested.
|-
|txns||List of wt= xids||txns_length * 32|| The wtxids of each transaction in the package.
= |}

1. The "getpckgtxns" message has the structure defined = above, with
=C2=A0 =C2=A0pchCommand =3D=3D "getpckgtxns".
<= br>2. A "getpckgtxns" message should be used to request all or so= me of
=C2=A0 =C2=A0the transactions previously announced in a "pckg= info" message,
specified by witness transactiosome id.

3. Up= on receipt of a "getpckgtxns" message, a node must respond with=C2=A0 =C2=A0either a "pckgtxns" containing the requested trans= actions or a
"notfound" message indicating one or more of the = transactions is
unavailable. This allows the receiver to avoid downloadi= ng and storing
transactions that cannot be validated immediately.
4. A "getpckgtxns" message should only be sent if both peers agr= eed to
=C2=A0 =C2=A0send packages in the version handshake. If a "g= etpckgtxns" message
is received from a peer with which package rela= y was not negotiated,
the sender should be disconnected.

=3D=3D= =3D=3D=3Dpckgtxns=3D=3D=3D=3D=3D

{|
| =C2=A0Field Name =C2=A0|| = =C2=A0Type =C2=A0|| =C2=A0Size =C2=A0|| =C2=A0 Purpose
|-
|txns_lengt= h||CompactSize||1 or 3 bytes|| The number of transactions provided.
|-|txns||List of transactions||variable|| The transactions in the package.<= br>|}

1. The "pckgtxns" message has the structure defined = above, with
=C2=A0 =C2=A0pchCommand =3D=3D "pckgtxns".

= 2. A "pckgtxns" message should contain the transaction data reque= sted
=C2=A0 =C2=A0using "getpckgtxns".

3. A "pckgt= xns" message should only be sent to a peer that requested
=C2=A0 = =C2=A0the package using "getpckgtxns". If a node receives an unso= licited
package, the sender should be disconnected.

4. A "pc= kgtxns" message should only be sent if both peers agreed to
=C2=A0 = =C2=A0send packages in the version handshake. If a "pckgtxns" mes= sage is
received from a peer with which package relay was not negotiated= , the
sender should be disconnected.

=3D=3D=3DVersion 1 Packages:= child-with-unconfirmed-parents=3D=3D=3D =C2=A0

This extends package= relay for packages consisting of one transaction
and all of its unconfi= rmed parents,by defining version 1 packages, a
pckginfo1 message, and a = MSG_PCKG1 inv type. It enables the use case
in which a child pays for it= s otherwise-too-low-fee parents and their
mempool conflict(s).

= =3D=3D=3D=3DIntended Protocol Flow=3D=3D=3D=3D

When relaying a packa= ge of low-fee parent(s) and high-fee child, the
sender and receiver do t= he following:

1. Sender announces they have a child-with-unconfirmed= -parents package
=C2=A0 =C2=A0for a child that pays for otherwise-too-lo= w-fee parent(s) using
"inv(MSG_PCKG1)".

2. The receiver= requests package information using
=C2=A0 =C2=A0"getdata(MSG_PCKG1= )".

3. The sender provides package information using "pckg= info1",
=C2=A0 =C2=A0including the blockhash of the sender's be= st block, the wtxids of
the transactions in the package, their total fee= s and total weight.

4. The reciever uses the package information to = decide how to request
=C2=A0 =C2=A0the transactions. For example, if the= receiver already has some of
the transactions in their mempool, they on= ly request the missing ones.
They could also decide not to request the p= ackage at all based on the
fee information provided.

5. Upon rece= iving a "pckgtxns", the receiver submits the transactions
=C2= =A0 =C2=A0together as a package.

=3D=3D=3D=3DNew Messages=3D=3D=3D= =3D

A new inv type, "MSG_PCKG1", and new protocol message,= "PCKGINFO1",
are added.

=3D=3D=3D=3D=3Dpckginfo1=3D=3D= =3D=3D=3D

{|
| =C2=A0Field Name =C2=A0|| =C2=A0Type =C2=A0|| =C2= =A0Size =C2=A0|| =C2=A0 Purpose
|-
|blockhash || uint256 || 32 || The= chain tip at which this package is defined.
|-
|pckg_fee||CAmount||4= || The sum total fees paid by all transactions in the package.
|-
|pc= kg_weight||int64_t||8|| The sum total weight of all transactions in the pac= kage.
|-
|txns_length||CompactSize||1 or 3 bytes|| The number of tran= sactions provided.
|-
|txns||List of wtxids||txns_length * 32|| The w= txids of each transaction in the package.
|}


1. The "pck= ginfo1" message has the structure defined above, with
=C2=A0 =C2=A0= pchCommand =3D=3D "pckginfo1".

2. A "pckginfo1" = message contains information about a version 1
=C2=A0 =C2=A0package (def= ined below), referenced by the wtxid of the transaction
it pertains to a= nd the current blockhash.

3. Upon receipt of a "pckginfo1"= message, the node should decide if it
=C2=A0 =C2=A0wants to validate th= e package, request transaction data if
necessary, etc.

4. Upon re= ceipt of a malformed "pckginfo1" message or package that
=C2= =A0 =C2=A0does not abide by the max_count, max_weight, or other rules
sp= ecified by the version agreed upon in the initial negotiation, the
sende= r should be disconnected.=C2=A0 If a node receives a "pckginfo1"<= br>message for which the "pckg_fee" or "pckg_weight" do= not reflect the
true total fees and weight, respectively, or the transa= ctions in the
package, the message is malformed.

5. A node MUST N= OT send a "pckginfo1" message that has not been
=C2=A0 =C2=A0r= equested by the recipient. Upon receipt of an unsolicited
"pckginfo= 1", a node should disconnect the sender.

6. A "pckginfo1&q= uot; message should only be sent if both peers agreed to
=C2=A0 =C2=A0se= nd version 1 packages in the version handshake. If a "pckginfo1"<= br>message is received from a peer with which package relay was not
nego= tiated, the sender should be disconnected.

=3D=3D=3D=3D=3DMSG_PCKG1= =3D=3D=3D=3D=3D

1. A new inv type (MSG_PCKG1 =3D=3D 0x6) is added, f= or use in inv messages
=C2=A0 =C2=A0and getdata requests pertaining to v= ersion 1 packages.

2. As an inv type, it indicates that both transac= tion data and version
=C2=A0 =C2=A01 package information are available f= or the transaction. The
transaction is referenced by its wtxid. As a get= data request type, it
indicates that the sender wants package informatio= n for the
transaction.

3. Upon receipt of a "getdata" r= equest for "MSG_PCKG1", the node
=C2=A0 =C2=A0should respond w= ith the version 1 package corresponding to the
requested transaction and= its current chain tip, or with NOTFOUND.
The node should not assume tha= t the sender is requesting the
transaction data as well.

=3D=3D= =3D=3DChild With Parent Packages Rules=3D=3D=3D=3D

A child-with-unco= nfirmed-parents package sent between nodes must abide
by the rules below= , otherwise the package is malformed and the sender
should be disconnect= ed.

A version 1 or ''child-with-unconfirmed-parents''= ; package can be
defined for any transaction that spends unconfirmed inp= uts. The child
can be thought of as the "representative" of th= e package. This package
can be uniquely identified by the transaction= 9;s wtxid and the current
chain tip block hash.

A ''child= -with-unconfirmed-parents'' package MUST be:

1. ''So= rted topologically.'' For every transaction t in the package,
= =C2=A0 =C2=A0if any of t's parents are present in the package, the pare= nt must
appear somewhere in the list before t. In other words, the
tr= ansactions must be sorted in ascending order of the number of
ancestors = present in the package.

2. ''Only 1 child with unconfirmed p= arents.'' The package must consist
=C2=A0 =C2=A0of one transacti= on and its unconfirmed parents. There must not be
any other transactions= in the package. Other dependency relationships
may exist within the pac= kage (e.g. one parent may spend the output of
another parent) provided t= hat topological order is respected.

3. ''All unconfirmed par= ents.'' All of the child's unconfirmed parents
=C2=A0 =C2=A0= must be present.

4. ''No conflicts.'' None of the tr= ansactions in the package may
=C2=A0 =C2=A0conflict with each other (i.e= . =C2=A0spend the same prevout).

5. ''Total fees and weight.= '' The 'total_fee' and 'total_weight'
=C2=A0 =C2= =A0fields must accurately represent the sum total of all transactions'<= br>fees and weights as defined in BIP141, respectively.

Not all of t= he child's parents must be present; the child transaction
may also s= pend confirmed inputs. However, if the child has confirmed
parents, they= must not be in the package.

While a child-with-unconfirmed-parents = package is perhaps most
relevant when the child has a higher feerate tha= n its parents, this
property is not required to construct a valid packag= e.

=3D=3D=3D=3DClarifications=3D=3D=3D=3D

''Q: Under = what circumstances should a sender announce a
child-with-unconfirmed-par= ents package?''

A child-with-unconfirmed-parents package for= a transaction should be
announced when it meets the peer's fee filt= er but one or more of its
parents don't; a "inv(MSG_PCKG1)"= ; instead of "inv(WTX)" should be sent
for the child. Each of = the parents which meet the peer's fee filter
should still be announc= ed normally.

''Q: What if a new block arrives in between mes= sages?''

A child-with-unconfirmed-parents package is defined= for a transaction
based on the current chain state. As such, a new bloc= k extending the
tip may decrease the number of transactions in the packa= ge (i.e. if
any of the transaction's parents were included in the bl= ock). In a
reorg, the number of transactions in the package may decrease= or
increase (i.e. if any of the transaction's parents were included= in a
block in the previous chain but not the new one).

If the ne= w block arrives before the "getdata" or "pckginfo1", no= thing
needs to change.

If the new block arrives before "getp= ckgtxns" or before "pckgtxns",
the receiver may need to r= e-request package information if the block
contained a transaction in th= e package. If the block doesn't contain
any transactions in the pack= age, whether it extends the previous tip
or causes a reorg, nothing need= s to change.

''Q: Can "getpckgtxns" and "pckg= txns" messages contain only one
transaction?''

Yes.<= br>
=3D=3D=3DFurther Protocol Extensions=3D=3D=3D

When introducin= g a new type of package, assign it a version number "n"
and us= e an additional "sendpackages" message during version handshaketo negotiate support for it. An additional package information message"pckginfon" and inv type "MSG_PCKGn" should be defined= for the type of
package.=C2=A0 However, "getpckgtxns" and &qu= ot;pckgtxns" do not need to be
changed.

Example proposal for= tx-with-unconfirmed-ancestors package relay: [19]

=3D=3D=3DCompati= bility=3D=3D=3D

Older clients remain fully compatible and interopera= ble after this
change. Clients implementing this protocol will only atte= mpt to send
and request packages if agreed upon during the version hands= hake.

=3D=3D=3DPackage Erlay=3D=3D=3D

Clients using BIP330 re= conciliation-based transaction relay (Erlay)
are able to use package rel= ay without interference. In fact, a package
of transactions may be annou= nced using both Erlay and package relay.
After reconciliation, if the in= itiator would have announced a
transaction by wtxid but also has package= information for it, they may
send "inv(MSG_PCKG)" instead of = "inv(WTX)".

=3D=3D=3DRationale=3D=3D=3D

=3D=3D=3D= =3DP2P Message Design=3D=3D=3D=3D

These p2p messages are added for c= ommunication efficiency and, as
such, one should measure alternative sol= utions based on the resources
used to communicate (not necessarily trust= worthy) information: We
would like to minimize network bandwidth, avoid = downloading a
transaction more than once, avoid downloading transactions= that are
eventually rejected, and minimize storage allocated for
not= -yet-validated transactions.

Consider these (plausible) scenarios in= transaction relay:

Alice (the "sender") is relaying trans= actions to Bob (the "receiver").
Alice's mempool has a min= imum feerate of 1sat/vB and Bob's has a
minimum feerate of 3sat/vB. = For simplicity, all transactions are
1600Wu in virtual size and 500 byte= s in serialized size. Apart from
the spending relationships specified, a= ll other inputs are from
confirmed UTXOs.

1. Package {A, B} where= A pays 0 satoshis and B pays 8000 satoshis in
=C2=A0 =C2=A0fees.
2. Package {C, D} where C pays 0 satoshis and D pays 1200 satoshis in
= =C2=A0 =C2=A0fees.

3. Package {E, F, G, H, J} that pays 4000, 8000, = 0, 2000, and 4000
=C2=A0 =C2=A0satoshis in fees, respectively.

= =3D=3D=3D=3DAlternative Designs Considered=3D=3D=3D=3D

''Pac= kage Information Only:'' Just having "pckginfo" gives eno= ugh
information for the receiver to accept the package. Omit the
&quo= t;getpckgtxns" and "pckgtxns" messages. While this option is= a good
fallback if batched transaction download fails for some reason, = it
shouldn't be used as the default because it 'always' requ= ires storage
of unvalidated transactions.

''No Package In= formation Round:'' Instead of having a package
information round= , just use the child's wtxid to refer to the package
and always send= the entire package together. This would cause nodes to
redownload dupli= cate transactions.

I have also created a slidedeck exploring various= alternative designs
and some examples in which they fall flat [20]. Ple= ase feel free to
suggest other alternatives.

=3D=3D=3D=3DVersioni= ng System=3D=3D=3D=3D

This protocol should be extensible to support = multiple types of
packages based on future desired use cases. Two "= flavors" of
versioning were considered:

1. When package memp= ool acceptance is upgraded to support more types
=C2=A0 =C2=A0of package= s, increment the version number (similar to Erlay).
During version hands= hake, peers negotiate which version of package
relay they will use by ea= ch sending one "sendpackages" message.

2. When introducing= another type of package, assign a version number
=C2=A0 =C2=A0to it and= announce it as an additional supported version (similar
to Compact Bloc= k Relay). During version handshake, peers send one
"sendpackages&qu= ot; message for each version supported.

The second option was favore= d because it allows different parameters
for different versions.=C2=A0 F= or example, it should be possible to support
both "arbitrary topolo= gy but maximum 3-transaction" package as well as
"child-with-u= nconfirmed-parents with default mempool ancestor limits"
packages s= imultaneously.

=3D=3DAcknowledgements=3D=3D

I hope to have ma= de it abundantly clear that this proposal isn=E2=80=99t
inventing the co= ncept of package relay, and in fact builds upon years
of work by many ot= hers, including Suhas Daftuar and Antoine Riard.

Thank you to John N= ewbery and Martin Zumsande for input on the design.

Thank you to Mat= t Corallo, Christian Decker, David Harding, Antoine
Poinsot, Antoine Ria= rd, Gregory Sanders, Chris Stewart, Bastien
Teinturier, and others for i= nput on the desired interface for
contracting protocols.

Loo= king forward to hearing your thoughts!

Best,
=
Gloria

[0]: https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2022-January/0198= 17.html
[1]: https://lists.linux= foundation.org/pipermail/lightning-dev/2020-April/002639.html
[2]: <= a href=3D"https://lists.linuxfoundation.org/pipermail/lightning-dev/2020-Ju= ne/002758.html" target=3D"_blank">https://lists.linuxfoundation.org/piperma= il/lightning-dev/2020-June/002758.html
[3]: https://github.com/t-bast/lightning-docs/blob/master/pinning-attacks.md<= /a>
[4]:
https://github.com/revaul= t/practical-revault/blob/master/transactions.md#cancel_tx
[5]: https://github.com/discreetlo= gcontracts/dlcspecs/blob/master/Transactions.md#refund-transaction
[= 6]: https://gist.github.com/instagibbs/60264606e1814= 51e977e439a49f69fe1
[7]: https://btctranscripts.com/adopting-bitcoin/202= 1/2021-11-16-gloria-zhao-transaction-relay-policy/#lightning-attacks[8]: h= ttps://youtu.be/fbWSQvJjKFs?t=3D1438
[9]: https://www.reddit.com/r/Bitcoin/comments/unew= 4e/looks_like_70_mvb_of_transactions_just_got_dumped/
[10]: https:/= /github.com/bitcoin/bitcoin/pull/7594
[11]: https://github.com/bitco= in/bitcoin/pull/7600
[12]: https://github.com= /bitcoin/bitcoin/pull/6455#issuecomment-122716820
[13]: https://gist.github.com/sdaftuar/8756699bfcad4d3806ba9f3396d4e66a<= /a>
[14]:
https://github.com/bitcoin/bitcoin/issues/14895
[15]= : https://github.com/bitcoin/bitcoin/pull/16401
[16]: https://gith= ub.com/bitcoin/bitcoin/pull/19621
[17]: https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2021-Se= ptember/019464.html
[18]: https://github.com/us= ers/glozow/projects/5/views/4?layout=3Dboard
[19]: https://gist.github.com/glozow/9b321cd3ef6505135c763112033ff2a7
[2= 0]: https://docs.= google.com/presentation/d/1B__KlZO1VzxJGx-0DYChlWawaEmGJ9EGApEzrHqZpQc/edit= ?usp=3Dsharing
_______________________________________________
bitcoin-dev mailing list
= bitcoin-dev@lists.linuxfoundation.org
https://lists.linuxfoundation.org/mail= man/listinfo/bitcoin-dev
--000000000000da95c205ec6c8a69--