Implement burn

[onchainguy-btc]

After my first burn PR (#2766) got a bit outdated, I created a new one. Tried to make as less changes as possible. This PR does not support burn messages yet. Hope we can get the general burning merged first and then I'm happy to add support for an optional burn message via data pushes.

[raphjaph]

Finally having a look at this. There's just two things but they probably require a bit of refactoring. Especially the new command ord wallet burn I think is important because burning is quite drastic and we want it to be a very distinct action.

[onchainguy-btc]

@raphjaph thanks for the feedback, will get that done asap!

[onchainguy-btc]

@raphjaph just implemented the changes. Let me know if I can improve on anything else. Can also write some more tests if you have ideas for some good ones.

[raphjaph]

In OP_RETURNs there is no dust_limit and I see that you correctly disable the check for that. One thing you could try doing is only burn the exact sat that the inscription is on instead of the whole UTXO. This will require some careful changes to the TransactionBuilder, which should then be tested as well in the unit tests of the transaction_builder.rs file.

[raphjaph]

Suggested change

	outgoing: Outgoing,
	inscription_id: InscriptionId,

For now we only want to enable burning inscriptions, so let's make sure only that is possible. We'll add burning functionality to the other types (sats, btc, runes) later.

[raphjaph]

Suggested change

	#[derive(Clone, Copy)]
	struct AddressParser;
	#[derive(Clone, Debug, PartialEq)]
	pub(crate) enum ParsedAddress {
	Address(Address<NetworkUnchecked>),
	ScriptBuf(ScriptBuf),
	}
	fn parse_address(arg: &str) -> Result<ParsedAddress, bitcoin::address::Error> {
	Ok(ParsedAddress::Address(Address::from_str(arg)?))
	}

Let's get rid of all of these. The burn command should just use the transaction builder directly with the correct TxOut, which can include an OP_RETURN script.

[raphjaph]

Suggested change

	pub(crate) address: ParsedAddress,
	pub(crate) address: Address,

[onchainguy-btc]

In OP_RETURNs there is no dust_limit and I see that you correctly disable the check for that. One thing you could try doing is only burn the exact sat that the inscription is on instead of the whole UTXO. This will require some careful changes to the TransactionBuilder, which should then be tested as well in the unit tests of the transaction_builder.rs file.

@raphjaph Do you think that's worth it? If I'm not mistaking doing so would add additional inputs to the transaction for extracting the sat. The fee for that could potentially be higher than what the inscription sats are worth.

As an alternative idea: What if we exit the ord wallet burn command with an error if the inscription is on a utxo with more than 10_000 sats. This way we can prevent burning large bitcoin amounts by mistake. If people still want to burn the inscriptions, they can first transfer it to a different, smaller output.

[raphjaph]

@raphjaph Do you think that's worth it? If I'm not mistaking doing so would add additional inputs to the transaction for extracting the sat. The fee for that could potentially be higher than what the inscription sats are worth.

That's true, then let's just leave it how it is for now.

As an alternative idea: What if we exit the ord wallet burn command with an error if the inscription is on a utxo with more than 10_000 sats. This way we can prevent burning large bitcoin amounts by mistake. If people still want to burn the inscriptions, they can first transfer it to a different, smaller output.

Sounds reasonble

[onchainguy-btc]

@raphjaph Do you think that's worth it? If I'm not mistaking doing so would add additional inputs to the transaction for extracting the sat. The fee for that could potentially be higher than what the inscription sats are worth.

That's true, then let's just leave it how it is for now.

As an alternative idea: What if we exit the ord wallet burn command with an error if the inscription is on a utxo with more than 10_000 sats. This way we can prevent burning large bitcoin amounts by mistake. If people still want to burn the inscriptions, they can first transfer it to a different, smaller output.

Sounds reasonble

Cool, will adapt to that!

[raphjaph]

Let me know when this is ready for review :)

[onchainguy-btc]

@raphjaph Ready for review ✅