akovalenko/lnd.xprv
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

chainntnfs/interface: update docs to note support for scripts

Browse Source
This commit is contained in:
Wilmer Paulino 2018-12-06 21:14:13 -08:00
parent c72da48111
commit 72cc843e92
No known key found for this signature in database
GPG Key ID: 6DF57B9F9514972F
1 changed files with 28 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
chainntnfs/interface.go
View File

@ -70,31 +70,41 @@ func (t TxConfStatus) String() string {
type ChainNotifier interface { type ChainNotifier interface {
// RegisterConfirmationsNtfn registers an intent to be notified once // RegisterConfirmationsNtfn registers an intent to be notified once
// txid reaches numConfs confirmations. We also pass in the pkScript as // txid reaches numConfs confirmations. We also pass in the pkScript as
// the default light client instead needs to match on scripts created // the default light client instead needs to match on scripts created in
// in the block. The returned ConfirmationEvent should properly notify // the block. If a nil txid is passed in, then not only should we match
// the client once the specified number of confirmations has been // on the script, but we should also dispatch once the transaction
// reached for the txid, as well as if the original tx gets re-org'd // containing the script reaches numConfs confirmations. This can be
// out of the mainchain. The heightHint parameter is provided as a // useful in instances where we only know the script in advance, but not
// convenience to light clients. The heightHint denotes the earliest // the transaction containing it.
// height in the blockchain in which the target txid _could_ have been //
// included in the chain. This can be used to bound the search space // The returned ConfirmationEvent should properly notify the client once
// when checking to see if a notification can immediately be dispatched // the specified number of confirmations has been reached for the txid,
// due to historical data. // as well as if the original tx gets re-org'd out of the mainchain. The
// heightHint parameter is provided as a convenience to light clients.
// It heightHint denotes the earliest height in the blockchain in which
// the target txid _could_ have been included in the chain. This can be
// used to bound the search space when checking to see if a notification
// can immediately be dispatched due to historical data.
// //
// NOTE: Dispatching notifications to multiple clients subscribed to // NOTE: Dispatching notifications to multiple clients subscribed to
// the same (txid, numConfs) tuple MUST be supported. // the same (txid, numConfs) tuple MUST be supported.
RegisterConfirmationsNtfn(txid *chainhash.Hash, pkScript []byte, numConfs, RegisterConfirmationsNtfn(txid *chainhash.Hash, pkScript []byte,
heightHint uint32) (*ConfirmationEvent, error) numConfs, heightHint uint32) (*ConfirmationEvent, error)
// RegisterSpendNtfn registers an intent to be notified once the target // RegisterSpendNtfn registers an intent to be notified once the target
// outpoint is successfully spent within a transaction. The script that // outpoint is successfully spent within a transaction. The script that
// the outpoint creates must also be specified. This allows this // the outpoint creates must also be specified. This allows this
// interface to be implemented by BIP 158-like filtering. The returned // interface to be implemented by BIP 158-like filtering. If a nil
// SpendEvent will receive a send on the 'Spend' transaction once a // outpoint is passed in, then not only should we match on the script,
// transaction spending the input is detected on the blockchain. The // but we should also dispatch once a transaction spends the output
// heightHint parameter is provided as a convenience to light clients. // containing said script. This can be useful in instances where we only
// The heightHint denotes the earliest height in the blockchain in // know the script in advance, but not the outpoint itself.
// which the target output could have been created. //
// The returned SpendEvent will receive a send on the 'Spend'
// transaction once a transaction spending the input is detected on the
// blockchain. The heightHint parameter is provided as a convenience to
// light clients. It denotes the earliest height in the blockchain in
// which the target output could have been spent.
// //
// NOTE: The notification should only be triggered when the spending // NOTE: The notification should only be triggered when the spending
// transaction receives a single confirmation. // transaction receives a single confirmation.