From d8f8d1d205f2adbff2c14093328b8ae5c761e8af Mon Sep 17 00:00:00 2001 From: yashrajd <114083781+yashrajd@users.noreply.github.com> Date: Mon, 2 Jun 2025 16:50:05 -0400 Subject: [PATCH 1/8] adding first draft --- guide/glossary/address.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/guide/glossary/address.md b/guide/glossary/address.md index fb82380eb..6626d697a 100644 --- a/guide/glossary/address.md +++ b/guide/glossary/address.md @@ -92,6 +92,16 @@ Legacy addresses begin with the number 1, can contain upper and lowercase charac Example: `1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2` +### Silent payments address + +This is a new type of address used by the silent payments protocol ([BIP-352](https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki)). It is different from other address types on this page, since it doesn't appear on the blockchain itself. Silent payments addresses are used wallets to generate unique on-chain ([taproot]({{'/guide/glossary/address/#taproot-address---p2tr' | relative_url}}) addresses that funds are sent to. + +Since the protocol ensures that unique on-chain addresses are generated, the [address reuse]({{'/guide/glossary/address/#silent-payments-address' | relative_url}}) problem is automatically avoided. + +Silent payments addresses starts with `sp1q`, and are not case sensitive. + +Example: ` ` + ### Change address When the output of a transaction is used as the input of another transaction, it must be spent entirely. Sometimes the value of the output is higher than what the user wishes to pay. In this case, the bitcoin client generates a new bitcoin address, and sends the difference back to this address. This is known as *change address*. The change address format used will usually be the default format used by the wallet application. From 46ce61fc32018abcc8d3e6d8d3d7a4203829cede Mon Sep 17 00:00:00 2001 From: yashrajd <114083781+yashrajd@users.noreply.github.com> Date: Mon, 2 Jun 2025 17:32:22 -0400 Subject: [PATCH 2/8] adding relative urls also adding example address --- guide/glossary/address.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/glossary/address.md b/guide/glossary/address.md index 6626d697a..9bc209be5 100644 --- a/guide/glossary/address.md +++ b/guide/glossary/address.md @@ -94,13 +94,13 @@ Example: `1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2` ### Silent payments address -This is a new type of address used by the silent payments protocol ([BIP-352](https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki)). It is different from other address types on this page, since it doesn't appear on the blockchain itself. Silent payments addresses are used wallets to generate unique on-chain ([taproot]({{'/guide/glossary/address/#taproot-address---p2tr' | relative_url}}) addresses that funds are sent to. +This is a new type of address used by the silent payments protocol ([BIP-352](https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki)). It is different from other address types on this page, since it doesn't appear on the blockchain. Silent payments addresses are used by wallets to generate unique on-chain ([taproot]({{'/guide/glossary/address/#taproot-address---p2tr' | relative_url}}) addresses during every transaction. -Since the protocol ensures that unique on-chain addresses are generated, the [address reuse]({{'/guide/glossary/address/#silent-payments-address' | relative_url}}) problem is automatically avoided. +Since the protocol ensures that unique on-chain addresses are generated, the [address reuse]({{'/guide/glossary/address/#silent-payments-address' | relative_url}}) problem is automatically avoided. Learn more about silent payments UX [here]({{'/guide/how-it-works/address/#silent-payments' | relative_url}}). Silent payments addresses starts with `sp1q`, and are not case sensitive. -Example: ` ` +Example: `sp1qqffj92fjdv6yjspqhlm06e9p3r59zd3sghuwrqg2w8vu3v349pg5sq60g7xquly89u0a54r9sayzhjcpqcgeqa8qqkzuukp6c7c5wfhgscujd5rs` ### Change address From fe623b21a930885016e35ecf22e1d63df1d3bfa5 Mon Sep 17 00:00:00 2001 From: yashrajd <114083781+yashrajd@users.noreply.github.com> Date: Mon, 2 Jun 2025 17:33:39 -0400 Subject: [PATCH 3/8] fixing address reuse link in sp section --- guide/glossary/address.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/glossary/address.md b/guide/glossary/address.md index 9bc209be5..7e96c08ec 100644 --- a/guide/glossary/address.md +++ b/guide/glossary/address.md @@ -96,7 +96,7 @@ Example: `1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2` This is a new type of address used by the silent payments protocol ([BIP-352](https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki)). It is different from other address types on this page, since it doesn't appear on the blockchain. Silent payments addresses are used by wallets to generate unique on-chain ([taproot]({{'/guide/glossary/address/#taproot-address---p2tr' | relative_url}}) addresses during every transaction. -Since the protocol ensures that unique on-chain addresses are generated, the [address reuse]({{'/guide/glossary/address/#silent-payments-address' | relative_url}}) problem is automatically avoided. Learn more about silent payments UX [here]({{'/guide/how-it-works/address/#silent-payments' | relative_url}}). +Since the protocol ensures that unique on-chain addresses are generated, the [address reuse]({{'/guide/glossary/address/#address-reuse' | relative_url}}) problem is automatically avoided. Learn more about silent payments UX [here]({{'/guide/how-it-works/address/#silent-payments' | relative_url}}). Silent payments addresses starts with `sp1q`, and are not case sensitive. From 2d3764432afbefe20d93065397155844df4f3302 Mon Sep 17 00:00:00 2001 From: yashrajd <114083781+yashrajd@users.noreply.github.com> Date: Mon, 2 Jun 2025 17:50:15 -0400 Subject: [PATCH 4/8] minor fixes --- guide/glossary/address.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/glossary/address.md b/guide/glossary/address.md index 7e96c08ec..d30dfd118 100644 --- a/guide/glossary/address.md +++ b/guide/glossary/address.md @@ -94,9 +94,9 @@ Example: `1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2` ### Silent payments address -This is a new type of address used by the silent payments protocol ([BIP-352](https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki)). It is different from other address types on this page, since it doesn't appear on the blockchain. Silent payments addresses are used by wallets to generate unique on-chain ([taproot]({{'/guide/glossary/address/#taproot-address---p2tr' | relative_url}}) addresses during every transaction. +This is a new type of address used by the silent payments protocol ([BIP-352](https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki)). It is different from other address types on this page, since it doesn't appear on the blockchain. Silent payments addresses are used by wallets to generate unique on-chain ([taproot]({{'/guide/glossary/address/#taproot-address---p2tr' | relative_url}})) addresses during every transaction. -Since the protocol ensures that unique on-chain addresses are generated, the [address reuse]({{'/guide/glossary/address/#address-reuse' | relative_url}}) problem is automatically avoided. Learn more about silent payments UX [here]({{'/guide/how-it-works/address/#silent-payments' | relative_url}}). +The protocol ensures that an unique on-chain address is generated during every transaction, avoiding the [address reuse]({{'/guide/glossary/address/#address-reuse' | relative_url}}) problem entirely. Learn more about silent payments UX [here]({{'/guide/how-it-works/address/#silent-payments' | relative_url}}). Silent payments addresses starts with `sp1q`, and are not case sensitive. From 2144a274c17e2ca209383367e91bab8d6ab676b1 Mon Sep 17 00:00:00 2001 From: yashrajd <114083781+yashrajd@users.noreply.github.com> Date: Mon, 2 Jun 2025 17:59:17 -0400 Subject: [PATCH 5/8] adding SP benefits in short --- guide/glossary/address.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/glossary/address.md b/guide/glossary/address.md index d30dfd118..7481f61dc 100644 --- a/guide/glossary/address.md +++ b/guide/glossary/address.md @@ -96,7 +96,7 @@ Example: `1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2` This is a new type of address used by the silent payments protocol ([BIP-352](https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki)). It is different from other address types on this page, since it doesn't appear on the blockchain. Silent payments addresses are used by wallets to generate unique on-chain ([taproot]({{'/guide/glossary/address/#taproot-address---p2tr' | relative_url}})) addresses during every transaction. -The protocol ensures that an unique on-chain address is generated during every transaction, avoiding the [address reuse]({{'/guide/glossary/address/#address-reuse' | relative_url}}) problem entirely. Learn more about silent payments UX [here]({{'/guide/how-it-works/address/#silent-payments' | relative_url}}). +The protocol ensures that an unique on-chain address is generated during every transaction, avoiding the on-chain [address reuse]({{'/guide/glossary/address/#address-reuse' | relative_url}}) problem entirely. As a result, silent payment addresses themselves can be reused, which is a huge UX improvement. Learn more about silent payments UX [here]({{'/guide/how-it-works/address/#silent-payments' | relative_url}}). Silent payments addresses starts with `sp1q`, and are not case sensitive. From 0d1aaf7a5a3782e9190285a5a76aefba47047135 Mon Sep 17 00:00:00 2001 From: yashrajd <114083781+yashrajd@users.noreply.github.com> Date: Mon, 2 Jun 2025 18:06:44 -0400 Subject: [PATCH 6/8] Fixing link to silent payments page --- guide/glossary/address.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/glossary/address.md b/guide/glossary/address.md index 7481f61dc..fc7095ffb 100644 --- a/guide/glossary/address.md +++ b/guide/glossary/address.md @@ -96,9 +96,9 @@ Example: `1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2` This is a new type of address used by the silent payments protocol ([BIP-352](https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki)). It is different from other address types on this page, since it doesn't appear on the blockchain. Silent payments addresses are used by wallets to generate unique on-chain ([taproot]({{'/guide/glossary/address/#taproot-address---p2tr' | relative_url}})) addresses during every transaction. -The protocol ensures that an unique on-chain address is generated during every transaction, avoiding the on-chain [address reuse]({{'/guide/glossary/address/#address-reuse' | relative_url}}) problem entirely. As a result, silent payment addresses themselves can be reused, which is a huge UX improvement. Learn more about silent payments UX [here]({{'/guide/how-it-works/address/#silent-payments' | relative_url}}). +The protocol ensures that an unique on-chain address is generated during every transaction, avoiding the on-chain [address reuse]({{'/guide/glossary/address/#address-reuse' | relative_url}}) problem entirely. As a result, silent payment addresses themselves can be reused, which is a huge UX improvement. Learn more about silent payments UX [here]({{'/guide/how-it-works/silent-payments' | relative_url}}). -Silent payments addresses starts with `sp1q`, and are not case sensitive. +Silent payments addresses start with `sp1q`, and are not case sensitive. Example: `sp1qqffj92fjdv6yjspqhlm06e9p3r59zd3sghuwrqg2w8vu3v349pg5sq60g7xquly89u0a54r9sayzhjcpqcgeqa8qqkzuukp6c7c5wfhgscujd5rs` From b25eaced7f5581df015381081f2ad5af5bb9292d Mon Sep 17 00:00:00 2001 From: yashrajd <114083781+yashrajd@users.noreply.github.com> Date: Thu, 5 Jun 2025 16:45:14 -0400 Subject: [PATCH 7/8] Update terminology to "silent payment address" ....instead of "silent payments address" --- guide/glossary/address.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/guide/glossary/address.md b/guide/glossary/address.md index fc7095ffb..61cec21c1 100644 --- a/guide/glossary/address.md +++ b/guide/glossary/address.md @@ -92,13 +92,13 @@ Legacy addresses begin with the number 1, can contain upper and lowercase charac Example: `1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2` -### Silent payments address +### Silent payment address -This is a new type of address used by the silent payments protocol ([BIP-352](https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki)). It is different from other address types on this page, since it doesn't appear on the blockchain. Silent payments addresses are used by wallets to generate unique on-chain ([taproot]({{'/guide/glossary/address/#taproot-address---p2tr' | relative_url}})) addresses during every transaction. +This is a new type of address used by the silent payments protocol ([BIP-352](https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki)). It is different from other address types on this page, since it doesn't appear on the blockchain. Silent payment addresses are used by wallets to generate unique on-chain ([taproot]({{'/guide/glossary/address/#taproot-address---p2tr' | relative_url}})) addresses during every transaction. The protocol ensures that an unique on-chain address is generated during every transaction, avoiding the on-chain [address reuse]({{'/guide/glossary/address/#address-reuse' | relative_url}}) problem entirely. As a result, silent payment addresses themselves can be reused, which is a huge UX improvement. Learn more about silent payments UX [here]({{'/guide/how-it-works/silent-payments' | relative_url}}). -Silent payments addresses start with `sp1q`, and are not case sensitive. +Silent payment addresses start with `sp1q`, and are not case sensitive. Example: `sp1qqffj92fjdv6yjspqhlm06e9p3r59zd3sghuwrqg2w8vu3v349pg5sq60g7xquly89u0a54r9sayzhjcpqcgeqa8qqkzuukp6c7c5wfhgscujd5rs` From c946524fe167359acbd4bfd04ccda2be4350ede7 Mon Sep 17 00:00:00 2001 From: yashrajd <114083781+yashrajd@users.noreply.github.com> Date: Thu, 5 Jun 2025 17:09:35 -0400 Subject: [PATCH 8/8] copy improvements removed repetitive verbiage; added explanation of improved UX while keeping length the same --- guide/glossary/address.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/glossary/address.md b/guide/glossary/address.md index 61cec21c1..b3610ec49 100644 --- a/guide/glossary/address.md +++ b/guide/glossary/address.md @@ -94,9 +94,9 @@ Example: `1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2` ### Silent payment address -This is a new type of address used by the silent payments protocol ([BIP-352](https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki)). It is different from other address types on this page, since it doesn't appear on the blockchain. Silent payment addresses are used by wallets to generate unique on-chain ([taproot]({{'/guide/glossary/address/#taproot-address---p2tr' | relative_url}})) addresses during every transaction. +This is a new type of address used by the silent payments protocol ([BIP-352](https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki)). It is different from other address types on this page, since it doesn't appear on the blockchain. Instead, silent payment addresses are used by wallet software to generate unique on-chain ([taproot]({{'/guide/glossary/address/#taproot-address---p2tr' | relative_url}})) addresses during every transaction. -The protocol ensures that an unique on-chain address is generated during every transaction, avoiding the on-chain [address reuse]({{'/guide/glossary/address/#address-reuse' | relative_url}}) problem entirely. As a result, silent payment addresses themselves can be reused, which is a huge UX improvement. Learn more about silent payments UX [here]({{'/guide/how-it-works/silent-payments' | relative_url}}). +This property allows the user to avoid the on-chain [address reuse]({{'/guide/glossary/address/#address-reuse' | relative_url}}) problem entirely. As a result, silent payment addresses can be exchanged once, and then reused repeatedly. This saves manual effort and scope for human error, resulting in a better UX. Learn more about silent payments [here]({{'/guide/how-it-works/silent-payments' | relative_url}}). Silent payment addresses start with `sp1q`, and are not case sensitive.