Skip to content

prestwich/turnturnturn

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Turnturnturn, an Op Return message util

This is a small CLI to embed messages in Bitcoin Op Return fields. It creates a local ephemeral address, watches the chain for funding, and sends a special transaction containing your message.

This software is ALPHA QUALITY. It has been tested on testnet. Please do not send any amount of money you are unwilling to lose. It has NO WARRANTY OF ANY KIND.

Flow

Don't forget to install rustup :)

  1. Use $ cargo run -- --help to see the help messages
  2. Specify the message, fee, and optionally a change address:
    • Your message may be between 12 and 74 characters.
    • $ cargo run -- -m "when true simplicity is gained" -f 10000
    • Specify -c YOUR_CHANGE_ADDRESS to receive change. Otherwise, excess sats will be donated to the creator of the tool :)
  3. The tool will print an address to fund, and then keep running
  4. Send sats to that address
  5. The tool will build and broadcast the transaction, and send funds to the change address.
  6. After that it will stop.

If you close the tool (using ctrl+c), your in progress message and key are saved. Simply re-run the tool and it will detect any funds you've sent to the address.

To run on testnet, adjust the commands above to specify cargo run --no-default-features --features=testnet --.

If you encounter any problems, post an issue. The ephemeral key is stored in the JSON files. So DO NOT share or delete those.

About

Bitcoin OpReturn message CLI

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages