scrow

KO | EN

gitlite — search

#python #react #ai #typescript #llm #golang #android #java #nodejs #windows #awesome #kubernetes #pytorch #ios

(★ 33)

Satoshi Escrow: A Bitcoin non-custodial peer-to-peer dispute resolution using only Nostr keys

scrow Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Satoshi Escrow

Satoshi Escrow (`scrow`): A Bitcoin non-custodial peer-to-peer dispute resolution using Nostr keys.

## Motivation

Buyer wants to buy something for $P$ (as in price) BTC from Seller.
Buyer does not trust Seller.
What he can do is to use a 2-of-2 multisig escrow address:
Buyer sends $2P$ and Seller sends $P$ to this address.
Hence this address now holds $3P$ locked to a 2-of-2 multisig.
Buyer and Seller just need to have their respective Nostr secret keys (nsec)
and each other's Nostr public keys (npub).

If the trade went well,
then it is both interests to sign the transaction,
because Buyer would want his $P$ BTC back and so does Seller.
They can do this by spending the Escrow address and sending Buyer his $P$ BTC back
and Seller $2P$ ($P$ for his escrow back and $P$ for the sale).
If the trade does not went well then the parties have
the game-theoretic incentives to try an alternate solution between themselves.

Additionally, both Buyer and Seller can optionally choose a third party that they both trust
that can spend the Escrow address timelocked to $N$ day(s) together with one of them.
The third-party as for now would have a social interest to solve the dispute
as he can use the escrow in the future and need a dispute solution. So now there are two possible ways to refund the users addresses:

1. Collaborative resolution: 2-of-2 Buyer + Seller.
1. Timelocked dispute resolution: 2-of-3 (Buyer or Seller) + Third Party.

Satoshi Escrow is a static webpage that can be used offline (or online)
in an air gapped computer for you to generate, sign,
and broadcast raw transactions directly through the webpage or using a wallet of choice.
The main working principle is the users use coinjoin to fund an escrow address
that was generated using the parties npubs and they can resolve the escrow using a collaborative
or a dispute approach with respectively 2-of-2 and 2-of-3 multisig with timelock.

## Technical Implementation

Under the hood we use Pay-to-Taproot (P2TR) multisig scripth path spends,
with a verified unknown discrete-log unspendable internal key.

For collaborative escrow option, we use a 2-of-2 multisig between the two parties without timelocks.
This is a simple one script path spend that is the root of the Taproot Merkle tree.

For the dispute escrow option, we use a 3 script path spend.
Here's how the Taproot Merkle tree is constructed:

1. Script `A`: 2-of-2 multisig between the two parties without timelocks.
2. Script `B`: 2-of-3 multisig between the first of the parties and the arbitrator with a timelock
   (if using an arbitrator).
3. Script `C`: 2-of-3 multisig between the second of the parties and the arbitrator with a timelock
   (if using an arbitrator).

`A` is at depth 1, and `B` and `C` are at depth 2.

```text
    root
       \
       /\
      /  \
     A    *
         / \
        /   \
       B     C
```

## State of the Art

This was first proposed by
[Satoshi Nakamoto in 2010](https://satoshi.nakamotoinstitute.org/posts/bitcointalk/threads/169/).

Bisq does something similar, the 2-of-2,
but with a caveat that the both parties can spend timelocked to 10 or 20 days the 2-of-2
into a Bisq DAO Address that will be used in arbitration disputes.
See: [Bisq Trading Rules](https://docs.bisq.network/trading-rules#dispute-resolution).

[Private Law Society](https://privatelawsociety.net/)
(PLS) also does escrow dispute resolution with third-parties,
but assumes that the third-party needs to be onboarded
and does not provide easy Nostr npub/nsec signing.

## Development

Satoshi Escrow is a pure Rust web application built with [Dioxus](https://dioxuslabs.com/).

In order to run the application locally, you need to have Rust and Cargo installed.
To preview the application,
install the `dx` Dioxus CLI,
run the following command:

```bash
dx serve
```

Also if you change Tailwind CSS,
you need to run the following command
(make sure you have `tailwindcss` installed):

```bash
npx tailwindcss -i ./input.css -o ./assets/tailwind.css --watch
```

scrow

scrow Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

scrow

scrow Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README