Create a type safe descriptor builder

[notmandatory]

As discussed in the team chat with kirillzhukov, the bdk lib uses rust macros to provide a type safe way to construct valid descriptors. Since the macro approach won't work for bdk-ffi language bindings we should try to build a simple library, possibly as a new repo, that uses simple structs and enums to accomplish something similar to the bdk::descriptor::dsl module.

[thunderbiscuit]

Related to #98.

[notmandatory]

Yes it's related to the static templates, they both should result in some Descriptor structure that can be used when constructing a Wallet.

[notmandatory]

Had a related discussion on Discord bdk-users today and think a simple descriptor template api could look like below. These represent simple single key descriptors according to BIP44,BIP49,BIP84, and BIP86.

There's no BIP yet for multisig templates, but we could create a simple one that takes a given key threshold and array of keys, would also need to a DescriptorKey enum.

[Enum]
interface DescriptorKey {
  Public(DescriptorPublicKey key);
  Secret(DescriptorSecretKey key);
};

interface Descriptor {
  [Throws=Error]
  constructor(string descriptor);

  [Name=new_bip44]
  constructor(DescriptorSecretKey secret_key, KeychainKind keychain , u32 account);

  [Name=new_bip44_public]
  constructor(DescriptorPublicKey public_key, string fingerprint, KeychainKind keychain , u32 account);

  [Name=new_bip49]
  constructor(DescriptorSecretKey secret_key, KeychainKind keychain , u32 account);

  [Name=new_bip49_public]
  constructor(DescriptorPublicKey public_key, string fingerprint, KeychainKind keychain , u32 account);
  
  [Name=new_bip84]
  constructor(DescriptorSecretKey secret_key, KeychainKind keychain , u32 account);
  
  [Name=new_bip84_public]
  constructor(DescriptorPublicKey public_key, string fingerprint, KeychainKind keychain , u32 account);
  
  [Name=new_bip86]
  constructor(DescriptorSecretKey secret_key, KeychainKind keychain , u32 account);
  
  [Name=new_bip86_public]
  constructor(DescriptorPublicKey public_key, string fingerprint, KeychainKind keychain , u32 account);

  [Name=new_multisig]
  constructor(sequence<DescriptorKey> keys, u32 threshold);

  string to_string();
};

[notmandatory]

Related link with the types of descriptors other wallets use: https://github.com/nvk/walletsrecovery.org

[BitcoinZavior]

This looks great 👍
Apart from the standard templates, we can have a custom descriptor option as well, so that a path and script type can be specified and the descriptor will be created for it.

• This will take care of existing wallets created with non standard path.
• It will also allow users to create wallets based on instructions from existing wallets which may not specify or inform the users of a descriptor nor a standard template but provide a path to use.
• API to create a single XPub descriptor or a single key descriptor has been requested many times by users and having a custom descriptor option will take care of the request.

[notmandatory]

This looks great 👍 Apart from the standard templates, we can have a custom descriptor option as well, so that a path and script type can be specified and the descriptor will be created for it.

That's a great idea! But let's do it in a separate PR once we have the standard templates working ok? I'll think I'll move the multisig into it's own PR too since it might require more API discussion also.

[BitcoinZavior]

That's a great idea! But let's do it in a separate PR once we have the standard templates working ok? I'll think I'll move the multisig into it's own PR too since it might require more API discussion also.

Sounds good 👍

[thunderbiscuit]

@notmandatory mind if I take this on?

[thunderbiscuit]

Now that I'm looking at the templates from BDK I see they only build for account 0 (if you want/need a different account you must build the descriptor manually).