shrub/pkg/bitcoin/sur/btc-provider.hoon

/-  *bitcoin, resource
|%
+$  host-info
  $:  api-url=@t
      connected=?
      =network
      block=@ud
      clients=(set ship)
  ==
+$  whitelist
  $:  public=?
      kids=?
      users=(set ship)
      groups=(set resource:resource)
  ==
::
+$  whitelist-target
  $%  [%public ~]
      [%kids ~]
      [%users users=(set ship)]
      [%groups groups=(set resource:resource)]
  ==
+$  command
  $%  [%set-credentials api-url=@t =network]
      [%add-whitelist wt=whitelist-target]
      [%remove-whitelist wt=whitelist-target]
      [%set-interval inte=@dr]
  ==
+$  action
  $%  [%address-info =address]
      [%tx-info txid=hexb]
      [%raw-tx txid=hexb]
      [%broadcast-tx rawtx=hexb]
      [%ping ~]
      [%block-info block=(unit @ud)]
  ==
::
+$  result
  $%  [%address-info =address utxos=(set utxo) used=? block=@ud]
      [%tx-info =info:tx]
      [%raw-tx txid=hexb rawtx=hexb]
      [%broadcast-tx txid=hexb broadcast=? included=?]
      [%block-info =network block=@ud fee=(unit sats) blockhash=hexb blockfilter=hexb]
  ==
+$  error
  $%  [%not-connected status=@ud]
      [%bad-request status=@ud]
      [%no-auth status=@ud]
      [%rpc-error ~]
  ==
+$  update  (each result error)
+$  status
  $%  [%connected =network block=@ud fee=(unit sats)]
      [%new-block =network block=@ud fee=(unit sats) blockhash=hexb blockfilter=hexb]
      [%disconnected ~]
  ==
::
++  rpc-types
  |%
  +$  action
    $%  [%get-address-info =address]
        [%get-tx-vals txid=hexb]
        [%get-raw-tx txid=hexb]
        [%broadcast-tx rawtx=hexb]
        [%get-block-count ~]
        [%get-block-info block=(unit @ud)]
    ==
  ::
  +$  result
    $%  [%get-address-info =address utxos=(set utxo) used=? block=@ud]
        [%get-tx-vals =info:tx]
        [%get-raw-tx txid=hexb rawtx=hexb]
        [%create-raw-tx rawtx=hexb]
        [%broadcast-tx txid=hexb broadcast=? included=?]
        [%get-block-count block=@ud]
        [%get-block-info block=@ud fee=(unit sats) blockhash=hexb blockfilter=hexb]

    ==
  --
--
::
fixed bizarre bug with ?- 2021-03-01 13:15:03 +03:00			`/- *bitcoin, resource`
start types 2020-10-01 16:51:37 +03:00			`\|%`
get blockfilter 2021-01-26 14:27:32 +03:00			`+$ host-info`
			`$: api-url=@t`
			`connected=?`
done w initial cleanup 2021-01-28 14:03:53 +03:00			`=network`
get blockfilter 2021-01-26 14:27:32 +03:00			`block=@ud`
			`clients=(set ship)`
			`==`
null fees possible, expanded whitelists and scrys in provider 2021-02-11 14:00:21 +03:00			`+$ whitelist`
			`$: public=?`
			`kids=?`
			`users=(set ship)`
fixed bizarre bug with ?- 2021-03-01 13:15:03 +03:00			`groups=(set resource:resource)`
null fees possible, expanded whitelists and scrys in provider 2021-02-11 14:00:21 +03:00			`==`
			`::`
			`+$ whitelist-target`
			`$% [%public ~]`
			`[%kids ~]`
			`[%users users=(set ship)]`
fixed bizarre bug with ?- 2021-03-01 13:15:03 +03:00			`[%groups groups=(set resource:resource)]`
null fees possible, expanded whitelists and scrys in provider 2021-02-11 14:00:21 +03:00			`==`
docs, btc-provider refactored 2020-11-13 13:14:35 +03:00			`+$ command`
rename stuff 2021-01-28 17:43:24 +03:00			`$% [%set-credentials api-url=@t =network]`
null fees possible, expanded whitelists and scrys in provider 2021-02-11 14:00:21 +03:00			`[%add-whitelist wt=whitelist-target]`
			`[%remove-whitelist wt=whitelist-target]`
btc-provider: made interval ~m1, and allow provider to set interval 2021-07-06 22:26:14 +03:00			`[%set-interval inte=@dr]`
docs, btc-provider refactored 2020-11-13 13:14:35 +03:00			`==`
factor out req-id in provider 2020-12-23 14:21:48 +03:00			`+$ action`
working %address-info 2020-11-09 12:53:30 +03:00			`$% [%address-info =address]`
reduce all hex types to hexb 2021-01-26 21:36:21 +03:00			`[%tx-info txid=hexb]`
			`[%raw-tx txid=hexb]`
			`[%broadcast-tx rawtx=hexb]`
behn timer added 2020-11-07 14:56:11 +03:00			`[%ping ~]`
btc: use blockfilter when requesting address info 2021-06-12 02:10:56 +03:00			`[%block-info block=(unit @ud)]`
re-worked as provider; parse out ElectRS response 2020-10-19 15:21:54 +03:00			`==`
WIP: check network on provider updates 2021-02-15 11:23:56 +03:00			`::`
factor out req-id in provider 2020-12-23 14:21:48 +03:00			`+$ result`
WIP: mostly refactored wallet-hook 2020-12-23 15:58:23 +03:00			`$% [%address-info =address utxos=(set utxo) used=? block=@ud]`
everything compiles 2020-12-07 23:31:09 +03:00			`[%tx-info =info:tx]`
reduce all hex types to hexb 2021-01-26 21:36:21 +03:00			`[%raw-tx txid=hexb rawtx=hexb]`
			`[%broadcast-tx txid=hexb broadcast=? included=?]`
btc: use blockfilter when requesting address info 2021-06-12 02:10:56 +03:00			`[%block-info =network block=@ud fee=(unit sats) blockhash=hexb blockfilter=hexb]`
rpc error-handling skeleton 2020-10-23 20:35:04 +03:00			`==`
			`+$ error`
working http error handling 2020-11-07 12:14:34 +03:00			`$% [%not-connected status=@ud]`
			`[%bad-request status=@ud]`
ping works 2020-11-07 18:51:31 +03:00			`[%no-auth status=@ud]`
working http error handling 2020-11-07 12:14:34 +03:00			`[%rpc-error ~]`
re-worked as provider; parse out ElectRS response 2020-10-19 15:21:54 +03:00			`==`
support for req-id 2020-11-09 15:29:30 +03:00			`+$ update (each result error)`
update block and fees 2020-11-16 20:06:45 +03:00			`+$ status`
WIP: check network on provider updates 2021-02-15 11:23:56 +03:00			`$% [%connected =network block=@ud fee=(unit sats)]`
			`[%new-block =network block=@ud fee=(unit sats) blockhash=hexb blockfilter=hexb]`
update block and fees 2020-11-16 20:06:45 +03:00			`[%disconnected ~]`
			`==`
fix txinfo return 2020-12-21 12:50:33 +03:00			`::`
initial bad-tx error handling 2020-12-13 13:04:47 +03:00			`++ rpc-types`
ported RPC actions 2020-10-12 11:26:43 +03:00			`\|%`
RPC refactor 2020-10-20 17:13:52 +03:00			`+$ action`
WIP: mostly refactored wallet-hook 2020-12-23 15:58:23 +03:00			`$% [%get-address-info =address]`
reduce all hex types to hexb 2021-01-26 21:36:21 +03:00			`[%get-tx-vals txid=hexb]`
			`[%get-raw-tx txid=hexb]`
			`[%broadcast-tx rawtx=hexb]`
WIP: check network on provider updates 2021-02-15 11:23:56 +03:00			`[%get-block-count ~]`
btc: use blockfilter when requesting address info 2021-06-12 02:10:56 +03:00			`[%get-block-info block=(unit @ud)]`
RPC refactor 2020-10-20 17:13:52 +03:00			`==`
working tx vals fetching 2020-12-06 20:53:02 +03:00			`::`
initial bad-tx error handling 2020-12-13 13:04:47 +03:00			`+$ result`
WIP: mostly refactored wallet-hook 2020-12-23 15:58:23 +03:00			`$% [%get-address-info =address utxos=(set utxo) used=? block=@ud]`
everything compiles 2020-12-07 23:31:09 +03:00			`[%get-tx-vals =info:tx]`
reduce all hex types to hexb 2021-01-26 21:36:21 +03:00			`[%get-raw-tx txid=hexb rawtx=hexb]`
			`[%create-raw-tx rawtx=hexb]`
			`[%broadcast-tx txid=hexb broadcast=? included=?]`
provider time conversion 2020-12-01 15:23:11 +03:00			`[%get-block-count block=@ud]`
null fees possible, expanded whitelists and scrys in provider 2021-02-11 14:00:21 +03:00			`[%get-block-info block=@ud fee=(unit sats) blockhash=hexb blockfilter=hexb]`
add marks 2020-11-24 22:30:41 +03:00
RPC refactor 2020-10-20 17:13:52 +03:00			`==`
ported RPC actions 2020-10-12 11:26:43 +03:00			`--`
start types 2020-10-01 16:51:37 +03:00			`--`
clean up subscribe/leave flow in wallet-hook 2020-11-10 13:30:06 +03:00			`::`