You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
133 lines
3.7 KiB
133 lines
3.7 KiB
3 years ago
|
<!doctype html>
|
||
|
|
<head>
|
||
|
|
<title>Urbit Bitcoin Connector</title>
|
||
|
|
<style>
|
||
|
|
body {
|
||
|
|
font-family: monospace;
|
||
|
|
max-width: 40em;
|
||
|
|
}
|
||
|
|
|
||
|
|
.box {
|
||
|
|
border: 1px solid black;
|
||
|
|
margin: 1em;
|
||
|
|
padding: 1em;
|
||
|
|
}
|
||
|
|
|
||
|
|
.indent {
|
||
|
|
margin-left: 1em;
|
||
|
|
}
|
||
|
|
|
||
|
|
.list {
|
||
|
|
list-style-type: none;
|
||
|
|
}
|
||
|
|
|
||
|
|
.bold {
|
||
|
|
font-weight: bold;
|
||
|
|
}
|
||
|
|
|
||
|
|
.wrap: {
|
||
|
|
overflow: hidden;
|
||
|
|
position: relative;
|
||
|
|
}
|
||
|
|
.bg-img {
|
||
|
|
background-image:url('/logo.png');
|
||
|
|
background-size: contain;
|
||
|
|
align: left;
|
||
|
|
background-repeat:no-repeat;
|
||
|
|
}
|
||
|
|
|
||
|
|
.title {
|
||
|
|
border: 2px solid black;
|
||
|
|
margin: 1em;
|
||
|
|
padding: 1em;
|
||
|
|
text-align: center;
|
||
|
|
}
|
||
|
|
|
||
|
|
h1 {
|
||
|
|
color: #ffffff;
|
||
|
|
text-shadow: 1px 0 0 #000, 0 -1px 0 #000, 0 1px 0 #000, -1px 0 0 #000;
|
||
|
|
}
|
||
|
|
|
||
|
|
#submit {
|
||
|
|
background-color: #fff;
|
||
|
|
-moz-border-radius: 2px;
|
||
|
|
-webkit-border-radius: 2px;
|
||
|
|
border-style: outset;
|
||
|
|
border-radius: 2px solid #000;
|
||
|
|
border-color: #000;
|
||
|
|
color: #000;
|
||
|
|
font-family: monospace;
|
||
|
|
font-size: 14px;
|
||
|
|
text-decoration: underline;
|
||
|
|
cursor: pointer;
|
||
|
|
border:none;
|
||
|
|
}
|
||
|
|
pre code {
|
||
|
|
display: block;
|
||
|
|
background: #D3D3D3;
|
||
|
|
white-space: pre;
|
||
|
|
-webkit-overflow-scrolling: touch;
|
||
|
|
overflow-x: auto;
|
||
|
|
max-width: 100%;
|
||
|
|
min-width: 100px;
|
||
|
|
padding: 0;
|
||
|
|
}
|
||
|
|
</style>
|
||
|
|
</head>
|
||
|
|
|
||
|
|
<body>
|
||
|
|
<div class="wrap">
|
||
|
|
<div class="bg-img">
|
||
|
|
<div class="title">
|
||
|
|
<h1>Urbit Bitcoin Connector</h1>
|
||
|
|
</div></div></div>
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<div class="box">
|
||
|
|
<p><b>This app will allow you to connect your Urbit's Bitcoin wallet to your Umbrel.</b></p>
|
||
|
|
<p>Urbit's Bitcoin wallet talks to the blockchain like this:</p>
|
||
|
|
<p><pre><code>[%btc-wallet] <--> [%btc-provider] <--> [Full node]</code></pre></p>
|
||
|
|
<p>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.</p>
|
||
|
|
</div></div>
|
||
|
|
|
||
|
|
<div><div class="box">
|
||
|
|
<p><b>Connecting your ship</b></p>
|
||
|
|
<p>First configure your provider:</p>
|
||
|
|
<p><ul>
|
||
|
|
<li>Open the dojo on your ship ('Terminal')</li>
|
||
|
|
<li>Enter the following commands:</li>
|
||
|
|
</ul>
|
||
|
|
<pre><code>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]</code></pre>
|
||
|
|
You should see a new block announcement in the dojo. (If your ship is on another host, change the IP address.)</p>
|
||
|
|
<p><ul><li>Next, go to your Bitcoin wallet in your Urbit's web UI.</li>
|
||
|
|
<li>Configure your provider by entering the @p (ship name) of the provider you just configured.</li>
|
||
|
|
<li>Enter your xPub from <a href="https://bridge.urbit.org">Bridge</a> or an <a href="https://blog.blockonomics.co/how-to-find-your-xpub-key-with-these-8-popular-bitcoin-wallets-ce8ea665ffdc">external wallet</a>.
|
||
|
|
</div></div>
|
||
|
|
|
||
|
|
<div><div class="box">
|
||
|
|
<p><b>Whitelisting clients</b></p>
|
||
|
|
<p>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.</p>
|
||
|
|
<pre><code>:: 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 ~]</pre></code>
|
||
|
|
<p></p>
|
||
|
|
</div></div>
|
||
|
|
|
||
|
|
<div><div class="box">
|
||
|
|
For support, file an issue on <a href="https://github.com/yapishu/urbit-bitcoin-node">GitHub</a> or join ~matwet/networked-subject on Urbit.
|
||
|
|
</div></div>
|
||
|
|
<div><div class="title">
|
||
|
|
<h2 style="text-align:center;">(~)</h2>
|
||
|
|
</div></div>
|
||
|
|
</body>
|