lnrpc: re-compile protos w/ Go 1.19

This commit is contained in:
Olaoluwa Osuntokun committed 2022-08-24 11:43:00 -05:00
1 parent 65a5eeb24e
commit b3998ddb5c
24 files changed
+2773 -3481

No files matched your search

+128 -159
View File
@@ -25,15 +25,13 @@ type GenSeedRequest struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
//
//aezeed_passphrase is an optional user provided passphrase that will be used
//to encrypt the generated aezeed cipher seed. When using REST, this field
//must be encoded as base64.
// aezeed_passphrase is an optional user provided passphrase that will be used
// to encrypt the generated aezeed cipher seed. When using REST, this field
// must be encoded as base64.
AezeedPassphrase []byte `protobuf:"bytes,1,opt,name=aezeed_passphrase,json=aezeedPassphrase,proto3" json:"aezeed_passphrase,omitempty"`
//
//seed_entropy is an optional 16-bytes generated via CSPRNG. If not
//specified, then a fresh set of randomness will be used to create the seed.
//When using REST, this field must be encoded as base64.
// seed_entropy is an optional 16-bytes generated via CSPRNG. If not
// specified, then a fresh set of randomness will be used to create the seed.
// When using REST, this field must be encoded as base64.
SeedEntropy []byte `protobuf:"bytes,2,opt,name=seed_entropy,json=seedEntropy,proto3" json:"seed_entropy,omitempty"`
}
@@ -88,16 +86,14 @@ type GenSeedResponse struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
//
//cipher_seed_mnemonic is a 24-word mnemonic that encodes a prior aezeed
//cipher seed obtained by the user. This field is optional, as if not
//provided, then the daemon will generate a new cipher seed for the user.
//Otherwise, then the daemon will attempt to recover the wallet state linked
//to this cipher seed.
// cipher_seed_mnemonic is a 24-word mnemonic that encodes a prior aezeed
// cipher seed obtained by the user. This field is optional, as if not
// provided, then the daemon will generate a new cipher seed for the user.
// Otherwise, then the daemon will attempt to recover the wallet state linked
// to this cipher seed.
CipherSeedMnemonic []string `protobuf:"bytes,1,rep,name=cipher_seed_mnemonic,json=cipherSeedMnemonic,proto3" json:"cipher_seed_mnemonic,omitempty"`
//
//enciphered_seed are the raw aezeed cipher seed bytes. This is the raw
//cipher text before run through our mnemonic encoding scheme.
// enciphered_seed are the raw aezeed cipher seed bytes. This is the raw
// cipher text before run through our mnemonic encoding scheme.
EncipheredSeed []byte `protobuf:"bytes,2,opt,name=enciphered_seed,json=encipheredSeed,proto3" json:"enciphered_seed,omitempty"`
}
@@ -152,77 +148,67 @@ type InitWalletRequest struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
//
//wallet_password is the passphrase that should be used to encrypt the
//wallet. This MUST be at least 8 chars in length. After creation, this
//password is required to unlock the daemon. When using REST, this field
//must be encoded as base64.
// wallet_password is the passphrase that should be used to encrypt the
// wallet. This MUST be at least 8 chars in length. After creation, this
// password is required to unlock the daemon. When using REST, this field
// must be encoded as base64.
WalletPassword []byte `protobuf:"bytes,1,opt,name=wallet_password,json=walletPassword,proto3" json:"wallet_password,omitempty"`
//
//cipher_seed_mnemonic is a 24-word mnemonic that encodes a prior aezeed
//cipher seed obtained by the user. This may have been generated by the
//GenSeed method, or be an existing seed.
// cipher_seed_mnemonic is a 24-word mnemonic that encodes a prior aezeed
// cipher seed obtained by the user. This may have been generated by the
// GenSeed method, or be an existing seed.
CipherSeedMnemonic []string `protobuf:"bytes,2,rep,name=cipher_seed_mnemonic,json=cipherSeedMnemonic,proto3" json:"cipher_seed_mnemonic,omitempty"`
//
//aezeed_passphrase is an optional user provided passphrase that will be used
//to encrypt the generated aezeed cipher seed. When using REST, this field
//must be encoded as base64.
// aezeed_passphrase is an optional user provided passphrase that will be used
// to encrypt the generated aezeed cipher seed. When using REST, this field
// must be encoded as base64.
AezeedPassphrase []byte `protobuf:"bytes,3,opt,name=aezeed_passphrase,json=aezeedPassphrase,proto3" json:"aezeed_passphrase,omitempty"`
//
//recovery_window is an optional argument specifying the address lookahead
//when restoring a wallet seed. The recovery window applies to each
//individual branch of the BIP44 derivation paths. Supplying a recovery
//window of zero indicates that no addresses should be recovered, such after
//the first initialization of the wallet.
// recovery_window is an optional argument specifying the address lookahead
// when restoring a wallet seed. The recovery window applies to each
// individual branch of the BIP44 derivation paths. Supplying a recovery
// window of zero indicates that no addresses should be recovered, such after
// the first initialization of the wallet.
RecoveryWindow int32 `protobuf:"varint,4,opt,name=recovery_window,json=recoveryWindow,proto3" json:"recovery_window,omitempty"`
//
//channel_backups is an optional argument that allows clients to recover the
//settled funds within a set of channels. This should be populated if the
//user was unable to close out all channels and sweep funds before partial or
//total data loss occurred. If specified, then after on-chain recovery of
//funds, lnd begin to carry out the data loss recovery protocol in order to
//recover the funds in each channel from a remote force closed transaction.
// channel_backups is an optional argument that allows clients to recover the
// settled funds within a set of channels. This should be populated if the
// user was unable to close out all channels and sweep funds before partial or
// total data loss occurred. If specified, then after on-chain recovery of
// funds, lnd begin to carry out the data loss recovery protocol in order to
// recover the funds in each channel from a remote force closed transaction.
ChannelBackups *ChanBackupSnapshot `protobuf:"bytes,5,opt,name=channel_backups,json=channelBackups,proto3" json:"channel_backups,omitempty"`
//
//stateless_init is an optional argument instructing the daemon NOT to create
//any *.macaroon files in its filesystem. If this parameter is set, then the
//admin macaroon returned in the response MUST be stored by the caller of the
//RPC as otherwise all access to the daemon will be lost!
// stateless_init is an optional argument instructing the daemon NOT to create
// any *.macaroon files in its filesystem. If this parameter is set, then the
// admin macaroon returned in the response MUST be stored by the caller of the
// RPC as otherwise all access to the daemon will be lost!
StatelessInit bool `protobuf:"varint,6,opt,name=stateless_init,json=statelessInit,proto3" json:"stateless_init,omitempty"`
//
//extended_master_key is an alternative to specifying cipher_seed_mnemonic and
//aezeed_passphrase. Instead of deriving the master root key from the entropy
//of an aezeed cipher seed, the given extended master root key is used
//directly as the wallet's master key. This allows users to import/use a
//master key from another wallet. When doing so, lnd still uses its default
//SegWit only (BIP49/84) derivation paths and funds from custom/non-default
//derivation paths will not automatically appear in the on-chain wallet. Using
//an 'xprv' instead of an aezeed also has the disadvantage that the wallet's
//birthday is not known as that is an information that's only encoded in the
//aezeed, not the xprv. Therefore a birthday needs to be specified in
//extended_master_key_birthday_timestamp or a "safe" default value will be
//used.
// extended_master_key is an alternative to specifying cipher_seed_mnemonic and
// aezeed_passphrase. Instead of deriving the master root key from the entropy
// of an aezeed cipher seed, the given extended master root key is used
// directly as the wallet's master key. This allows users to import/use a
// master key from another wallet. When doing so, lnd still uses its default
// SegWit only (BIP49/84) derivation paths and funds from custom/non-default
// derivation paths will not automatically appear in the on-chain wallet. Using
// an 'xprv' instead of an aezeed also has the disadvantage that the wallet's
// birthday is not known as that is an information that's only encoded in the
// aezeed, not the xprv. Therefore a birthday needs to be specified in
// extended_master_key_birthday_timestamp or a "safe" default value will be
// used.
ExtendedMasterKey string `protobuf:"bytes,7,opt,name=extended_master_key,json=extendedMasterKey,proto3" json:"extended_master_key,omitempty"`
//
//extended_master_key_birthday_timestamp is the optional unix timestamp in
//seconds to use as the wallet's birthday when using an extended master key
//to restore the wallet. lnd will only start scanning for funds in blocks that
//are after the birthday which can speed up the process significantly. If the
//birthday is not known, this should be left at its default value of 0 in
//which case lnd will start scanning from the first SegWit block (481824 on
//mainnet).
// extended_master_key_birthday_timestamp is the optional unix timestamp in
// seconds to use as the wallet's birthday when using an extended master key
// to restore the wallet. lnd will only start scanning for funds in blocks that
// are after the birthday which can speed up the process significantly. If the
// birthday is not known, this should be left at its default value of 0 in
// which case lnd will start scanning from the first SegWit block (481824 on
// mainnet).
ExtendedMasterKeyBirthdayTimestamp uint64 `protobuf:"varint,8,opt,name=extended_master_key_birthday_timestamp,json=extendedMasterKeyBirthdayTimestamp,proto3" json:"extended_master_key_birthday_timestamp,omitempty"`
//
//watch_only is the third option of initializing a wallet: by importing
//account xpubs only and therefore creating a watch-only wallet that does not
//contain any private keys. That means the wallet won't be able to sign for
//any of the keys and _needs_ to be run with a remote signer that has the
//corresponding private keys and can serve signing RPC requests.
// watch_only is the third option of initializing a wallet: by importing
// account xpubs only and therefore creating a watch-only wallet that does not
// contain any private keys. That means the wallet won't be able to sign for
// any of the keys and _needs_ to be run with a remote signer that has the
// corresponding private keys and can serve signing RPC requests.
WatchOnly *WatchOnly `protobuf:"bytes,9,opt,name=watch_only,json=watchOnly,proto3" json:"watch_only,omitempty"`
//
//macaroon_root_key is an optional 32 byte macaroon root key that can be
//provided when initializing the wallet rather than letting lnd generate one
//on its own.
// macaroon_root_key is an optional 32 byte macaroon root key that can be
// provided when initializing the wallet rather than letting lnd generate one
// on its own.
MacaroonRootKey []byte `protobuf:"bytes,10,opt,name=macaroon_root_key,json=macaroonRootKey,proto3" json:"macaroon_root_key,omitempty"`
}
@@ -333,12 +319,11 @@ type InitWalletResponse struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
//
//The binary serialized admin macaroon that can be used to access the daemon
//after creating the wallet. If the stateless_init parameter was set to true,
//this is the ONLY copy of the macaroon and MUST be stored safely by the
//caller. Otherwise a copy of this macaroon is also persisted on disk by the
//daemon, together with other macaroon files.
// The binary serialized admin macaroon that can be used to access the daemon
// after creating the wallet. If the stateless_init parameter was set to true,
// this is the ONLY copy of the macaroon and MUST be stored safely by the
// caller. Otherwise a copy of this macaroon is also persisted on disk by the
// daemon, together with other macaroon files.
AdminMacaroon []byte `protobuf:"bytes,1,opt,name=admin_macaroon,json=adminMacaroon,proto3" json:"admin_macaroon,omitempty"`
}
@@ -386,25 +371,22 @@ type WatchOnly struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
//
//The unix timestamp in seconds of when the master key was created. lnd will
//only start scanning for funds in blocks that are after the birthday which
//can speed up the process significantly. If the birthday is not known, this
//should be left at its default value of 0 in which case lnd will start
//scanning from the first SegWit block (481824 on mainnet).
// The unix timestamp in seconds of when the master key was created. lnd will
// only start scanning for funds in blocks that are after the birthday which
// can speed up the process significantly. If the birthday is not known, this
// should be left at its default value of 0 in which case lnd will start
// scanning from the first SegWit block (481824 on mainnet).
MasterKeyBirthdayTimestamp uint64 `protobuf:"varint,1,opt,name=master_key_birthday_timestamp,json=masterKeyBirthdayTimestamp,proto3" json:"master_key_birthday_timestamp,omitempty"`
//
//The fingerprint of the root key (also known as the key with derivation path
//m/) from which the account public keys were derived from. This may be
//required by some hardware wallets for proper identification and signing. The
//bytes must be in big-endian order.
// The fingerprint of the root key (also known as the key with derivation path
// m/) from which the account public keys were derived from. This may be
// required by some hardware wallets for proper identification and signing. The
// bytes must be in big-endian order.
MasterKeyFingerprint []byte `protobuf:"bytes,2,opt,name=master_key_fingerprint,json=masterKeyFingerprint,proto3" json:"master_key_fingerprint,omitempty"`
//
//The list of accounts to import. There _must_ be an account for all of lnd's
//main key scopes: BIP49/BIP84 (m/49'/0'/0', m/84'/0'/0', note that the
//coin type is always 0, even for testnet/regtest) and lnd's internal key
//scope (m/1017'/<coin_type>'/<account>'), where account is the key family as
//defined in `keychain/derivation.go` (currently indices 0 to 9).
// The list of accounts to import. There _must_ be an account for all of lnd's
// main key scopes: BIP49/BIP84 (m/49'/0'/0', m/84'/0'/0', note that the
// coin type is always 0, even for testnet/regtest) and lnd's internal key
// scope (m/1017'/<coin_type>'/<account>'), where account is the key family as
// defined in `keychain/derivation.go` (currently indices 0 to 9).
Accounts []*WatchOnlyAccount `protobuf:"bytes,3,rep,name=accounts,proto3" json:"accounts,omitempty"`
}
@@ -466,24 +448,20 @@ type WatchOnlyAccount struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
//
//Purpose is the first number in the derivation path, must be either 49, 84
//or 1017.
// Purpose is the first number in the derivation path, must be either 49, 84
// or 1017.
Purpose uint32 `protobuf:"varint,1,opt,name=purpose,proto3" json:"purpose,omitempty"`
//
//Coin type is the second number in the derivation path, this is _always_ 0
//for purposes 49 and 84. It only needs to be set to 1 for purpose 1017 on
//testnet or regtest.
// Coin type is the second number in the derivation path, this is _always_ 0
// for purposes 49 and 84. It only needs to be set to 1 for purpose 1017 on
// testnet or regtest.
CoinType uint32 `protobuf:"varint,2,opt,name=coin_type,json=coinType,proto3" json:"coin_type,omitempty"`
//
//Account is the third number in the derivation path. For purposes 49 and 84
//at least the default account (index 0) needs to be created but optional
//additional accounts are allowed. For purpose 1017 there needs to be exactly
//one account for each of the key families defined in `keychain/derivation.go`
//(currently indices 0 to 9)
// Account is the third number in the derivation path. For purposes 49 and 84
// at least the default account (index 0) needs to be created but optional
// additional accounts are allowed. For purpose 1017 there needs to be exactly
// one account for each of the key families defined in `keychain/derivation.go`
// (currently indices 0 to 9)
Account uint32 `protobuf:"varint,3,opt,name=account,proto3" json:"account,omitempty"`
//
//The extended public key at depth 3 for the given account.
// The extended public key at depth 3 for the given account.
Xpub string `protobuf:"bytes,4,opt,name=xpub,proto3" json:"xpub,omitempty"`
}
@@ -552,29 +530,25 @@ type UnlockWalletRequest struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
//
//wallet_password should be the current valid passphrase for the daemon. This
//will be required to decrypt on-disk material that the daemon requires to
//function properly. When using REST, this field must be encoded as base64.
// wallet_password should be the current valid passphrase for the daemon. This
// will be required to decrypt on-disk material that the daemon requires to
// function properly. When using REST, this field must be encoded as base64.
WalletPassword []byte `protobuf:"bytes,1,opt,name=wallet_password,json=walletPassword,proto3" json:"wallet_password,omitempty"`
//
//recovery_window is an optional argument specifying the address lookahead
//when restoring a wallet seed. The recovery window applies to each
//individual branch of the BIP44 derivation paths. Supplying a recovery
//window of zero indicates that no addresses should be recovered, such after
//the first initialization of the wallet.
// recovery_window is an optional argument specifying the address lookahead
// when restoring a wallet seed. The recovery window applies to each
// individual branch of the BIP44 derivation paths. Supplying a recovery
// window of zero indicates that no addresses should be recovered, such after
// the first initialization of the wallet.
RecoveryWindow int32 `protobuf:"varint,2,opt,name=recovery_window,json=recoveryWindow,proto3" json:"recovery_window,omitempty"`
//
//channel_backups is an optional argument that allows clients to recover the
//settled funds within a set of channels. This should be populated if the
//user was unable to close out all channels and sweep funds before partial or
//total data loss occurred. If specified, then after on-chain recovery of
//funds, lnd begin to carry out the data loss recovery protocol in order to
//recover the funds in each channel from a remote force closed transaction.
// channel_backups is an optional argument that allows clients to recover the
// settled funds within a set of channels. This should be populated if the
// user was unable to close out all channels and sweep funds before partial or
// total data loss occurred. If specified, then after on-chain recovery of
// funds, lnd begin to carry out the data loss recovery protocol in order to
// recover the funds in each channel from a remote force closed transaction.
ChannelBackups *ChanBackupSnapshot `protobuf:"bytes,3,opt,name=channel_backups,json=channelBackups,proto3" json:"channel_backups,omitempty"`
//
//stateless_init is an optional argument instructing the daemon NOT to create
//any *.macaroon files in its file system.
// stateless_init is an optional argument instructing the daemon NOT to create
// any *.macaroon files in its file system.
StatelessInit bool `protobuf:"varint,4,opt,name=stateless_init,json=statelessInit,proto3" json:"stateless_init,omitempty"`
}
@@ -681,24 +655,20 @@ type ChangePasswordRequest struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
//
//current_password should be the current valid passphrase used to unlock the
//daemon. When using REST, this field must be encoded as base64.
// current_password should be the current valid passphrase used to unlock the
// daemon. When using REST, this field must be encoded as base64.
CurrentPassword []byte `protobuf:"bytes,1,opt,name=current_password,json=currentPassword,proto3" json:"current_password,omitempty"`
//
//new_password should be the new passphrase that will be needed to unlock the
//daemon. When using REST, this field must be encoded as base64.
// new_password should be the new passphrase that will be needed to unlock the
// daemon. When using REST, this field must be encoded as base64.
NewPassword []byte `protobuf:"bytes,2,opt,name=new_password,json=newPassword,proto3" json:"new_password,omitempty"`
//
//stateless_init is an optional argument instructing the daemon NOT to create
//any *.macaroon files in its filesystem. If this parameter is set, then the
//admin macaroon returned in the response MUST be stored by the caller of the
//RPC as otherwise all access to the daemon will be lost!
// stateless_init is an optional argument instructing the daemon NOT to create
// any *.macaroon files in its filesystem. If this parameter is set, then the
// admin macaroon returned in the response MUST be stored by the caller of the
// RPC as otherwise all access to the daemon will be lost!
StatelessInit bool `protobuf:"varint,3,opt,name=stateless_init,json=statelessInit,proto3" json:"stateless_init,omitempty"`
//
//new_macaroon_root_key is an optional argument instructing the daemon to
//rotate the macaroon root key when set to true. This will invalidate all
//previously generated macaroons.
// new_macaroon_root_key is an optional argument instructing the daemon to
// rotate the macaroon root key when set to true. This will invalidate all
// previously generated macaroons.
NewMacaroonRootKey bool `protobuf:"varint,4,opt,name=new_macaroon_root_key,json=newMacaroonRootKey,proto3" json:"new_macaroon_root_key,omitempty"`
}
@@ -767,13 +737,12 @@ type ChangePasswordResponse struct {
sizeCache protoimpl.SizeCache
unknownFields protoimpl.UnknownFields
//
//The binary serialized admin macaroon that can be used to access the daemon
//after rotating the macaroon root key. If both the stateless_init and
//new_macaroon_root_key parameter were set to true, this is the ONLY copy of
//the macaroon that was created from the new root key and MUST be stored
//safely by the caller. Otherwise a copy of this macaroon is also persisted on
//disk by the daemon, together with other macaroon files.
// The binary serialized admin macaroon that can be used to access the daemon
// after rotating the macaroon root key. If both the stateless_init and
// new_macaroon_root_key parameter were set to true, this is the ONLY copy of
// the macaroon that was created from the new root key and MUST be stored
// safely by the caller. Otherwise a copy of this macaroon is also persisted on
// disk by the daemon, together with other macaroon files.
AdminMacaroon []byte `protobuf:"bytes,1,opt,name=admin_macaroon,json=adminMacaroon,proto3" json:"admin_macaroon,omitempty"`
}