Urbit Bitcoin Connector

This app will allow you to connect your Urbit's Bitcoin wallet to your Umbrel.

Urbit's Bitcoin wallet talks to the blockchain like this:

[%btc-wallet] <--> [%btc-provider] <--> [Full node]

You need to connect %btc-wallet to a configured provider before you can use it. %btc-wallet and %btc-provider may or may not be on the same ship.

Connecting your ship

First configure your provider:

• Open the dojo on your ship ('Terminal')
• Enter the following commands:

dojo> |rein %bitcoin [& %btc-provider]
dojo> =network %main
dojo> :btc-provider +bitcoin!btc-provider/command [%set-credentials api-url='http://127.0.0.1:55555' network]

You should see a new block announcement in the dojo. (If your ship is on another host, change the IP address.)

• Next, go to your Bitcoin wallet in your Urbit's web UI.
• Configure your provider by entering the @p (ship name) of the provider you just configured.
• Enter your xPub from Bridge or an external wallet.

Whitelisting clients

By default, only your provider's @p will be whitelisted for use. You can whitelist any other ship or groups of ships using the following commands.

:: Individual ships ::
dojo> :btc-provider +bitcoin!btc-provider/command [%add-whitelist [%users users=(sy ~[~wallet-hodler])]]

:: Group members (provider ship must be a member) ::
dojo> :btc-provider +bitcoin!btc-provider/command [%add-whitelist [%groups groups=(sy ~[[~sampel %group-name]])]]

:: %kids ::
dojo> :btc-provider +bitcoin!btc-provider/command [%add-whitelist %kids ~]

:: Public whitelisting ::
dojo> :btc-provider +bitcoin!btc-provider/command [%add-whitelist %public ~]

For support, file an issue on GitHub or join ~matwet/networked-subject on Urbit.