Skip to content

Conversation

@GBKS
Copy link
Contributor

@GBKS GBKS commented Jan 11, 2021

Based on issue #30, this page explains some of the ways that users rely on applications playing well with each other.

If you know more use cases, please add comments.

Not sure on the best place for this in the nav structure yet. I put it in "Resources" for now.

@GBKS GBKS added the Copy Task is about improving text. label Jan 11, 2021
@GBKS GBKS self-assigned this Jan 11, 2021
@GBKS GBKS linked an issue Jan 11, 2021 that may be closed by this pull request
Daniel Nordh added 3 commits January 11, 2021 10:24
@danielnordh
Copy link
Contributor

Great start. Made some minor commits that should have been PR's instead, sorry. Feel free to revert where you want.

The QR code image seems like it might have the QR code in the wrong position (outside of the image)?

Good next steps could be to have actionable suggestions for each sub section, i.e suggesting a standard format for user data etc.

@ConorOkus
Copy link
Collaborator

Looks good, I think a simple one or two-liner on what interoperability is could be nice to add at the start as well. Although the illustration in the banner does a nice job as well.

layout = "float-right-desktop"
%}

Allow for wallets generated in one application to be easily restored in another application. Over the years, Bitcoin applications have implemented various technical details in different ways, partly because standards take time to evolve. See [Wallets Recovery](https://walletsrecovery.org) as an illustration of the problem.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is extremely important section. Should we maybe expand it a bit and add that following BIP's that are widely adopted helps solve this? I am so glad you included that link to walletsrecovery.org it's a great resource, but we may want to emphasize some of their points in this section?

I mean we provided a problem here but not a concrete solution is what I'm thinking.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point. I added a bit more info, recommending that wallets should put extra effort to empower users with all the info they need to recover wallets in the future. Big topic. Daniel had mentioned he is thinking of creating a dedicated page for wallet recovery, this would be a good spot to link there.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Excellent idea, I think a dedicated wallet recovery page is needed.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@danielnordh two votes here for your idea for a page about wallet recovery.


QR codes (Quick Response codes) are visual representations of data. Since most devices today feature cameras with built-in support for reading QR codes, this technique has become a convenient method to transfer data from one device to another, even if those devices are offline. Common use cases include reading payment invoices (such as the payment links described above), or importing wallet keys from a backup.

Static QR codes can only contain small amounts of information. Animated QR codes address this problem by splitting up the data over multiple static QR codes. Reading animated QR codes is not a standard feature yet.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Speaking of data in QR codes, this is an excellent read.

This also shows how interoperability in QR codes is also important. Also shows how people don't follow BIP entirely. Unsure if and how we can fit it in, but wanted to share.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just added this info.

layout = "float-right-desktop"
%}

Transaction data is stored on the Bitcoin block chain and available in any wallet a user has set up. As is, this transaction data does not contain any useful information about the reasons why transactions were made, who owns each address, etc. To better understand and organize their finances, users typically enrich transaction data by assigning contacts, notes, labels, and other useful information. This data should be stored in standardized, open formats and easily synced between applications. This is especially useful for users who rely on multiple devices.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are there any standards for this we can reference to?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just researched a little and come across some standards that are overly complicated like ISO 20022, OFX and QIF. They are meant for the exchange of financial data, but more on an enterprise/bank level. I wish there was something more lean and JSON-based available.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for looking into it.. For example, I know that Electrum has labels, but it's unclear to me how they can work and can be exported. One day it'll be essential to have a standard in Bitcoin for this sort of data, as ideally nobody wants to loose precious data when switching wallets.

layout = "float-right-desktop"
%}

While it is extremely convenient when applications provide their own node connections, it is recommended to allow users to have a choice, and potentially even encourage them to set up their own node. This results in better decentralization, and also has privacy and security benefits.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Important point 👏

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would be a good spot to link to a "Principles" or "Values" section.

@johnsBeharry
Copy link
Contributor

Not sure on the best place for this in the nav structure yet. I put it in "Resources" for now.

@GBKS how about a new chapter called Foundations? The Units & Symbols (#63) page can also go there.

@GBKS
Copy link
Contributor Author

GBKS commented Jan 13, 2021

@johnsBeharry good idea. I just updated this PR with a skeleton for a "Foundations" section that we can use.

Good to merge this one?

@GBKS GBKS merged commit 9efe720 into master Jan 13, 2021
@danielnordh danielnordh deleted the feature/interoperability-page branch September 17, 2021 14:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Copy Task is about improving text.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create a section on interoperability

6 participants