route bitcoin transactions via goTenna mesh devices
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app
gotenna-public-sdk
gradle/wrapper
.gitignore
LICENSE
README.md
build.gradle
gradle.properties
gradlew
gradlew.bat
settings.gradle

README.md

txTenna

txTenna is a proof-of-concept Android app developed by Samourai as part of the Mule.Tools research and development initiative exploring alternative means of transaction broadcasting to enhance censorship resistance.

txTenna can:

  • be used for transmitting transactions to the bitcoin network via SMS. Send your own transactions by SMS using a known txTenna relay or allow your own contacts to use your mobile number as an SMS relay.
  • be used for transmitting transactions to the bitcoin network via the goTenna mesh network.

Pony Direct functionality has been rolled into txTenna which maintains backward compatibility for the Pony Direct SMS payload format.

Get Started

Build:

Import as Android Studio project. Should build "as is". PGP signed tagged releases correspond to builds that were released on GitHub. You will need to obtain a SDK developer token from goTenna.

APK:

The latest version of the APK can be installed from the Github Releases page

How to use

Broadcast a transaction by SMS:

  1. Launch txTenna and enter the mobile phone number of a known txTenna device in the toolbar settings. A known UK based txTenna relay (+447490741539) will be automatically entered. If adding a different mobile number make sure to use international format.

  2. From the main screen either scan the QR code of a signed transaction or select 'SMS Broadcast' from FAB menu and paste the transaction in the popup. Confirm the relaying of the transaction when prompted. (You can create and display raw signed transactions with Samourai Wallet)

  3. The transaction hex will be automatically divided into segments and sent via multiple SMSs to the desired relay device. Please note, you will be charged at your normal rate for sending standard SMS messages.

Relay transactions for your mobile contacts:

  1. Launch txTenna and keep it open.

  2. Incoming SMS using the payload format described below will be intercepted and parsed to reconstitute the signed hex transaction.

  3. Upon validation of the transaction hash, the transaction will be broadcast via the Samourai node pushTx.

Common issues:
  • Sending device does not have sufficient SMS credit.

  • Receiving device switched OFF.

  • Sending to wrong network. Check MainNet/TestNet switch in settings.

  • The occasional dropped SMS. If you can identify which SMS was dropped you can re-send it and the receiving device will complete the slatted transaction and broadcast it.

Broadcast a transaction by goTenna:

  1. Launch txTenna and keep it open

  2. Make sure that GPS location is running on your Android device.

  3. Make sure that your Android device has Bluetooth switched ON.

  4. Go to the 'Networking" screen and make sure that your goTenna is paired to your Android device.

  5. From the main screen either scan the QR code of a signed transaction or select 'GoTenna Mesh' from FAB menu and paste the transaction in the popup. Confirm the relaying of the transaction when prompted. (You can create and display raw signed transactions with Samourai Wallet)

  6. The transaction hex will be automatically divided into segments and sent via multiple SMSs to the desired relay device. Please note, you will be charged at your normal rate for sending standard SMS messages.

Relay transactions for your goTenna contacts:

  1. Launch txTenna and keep it open.

  2. Incoming goTenna mesh network packets containing the payload format described below will be intercepted, parsed, and uploaded to the txTenna gateway.

  3. When all of the segments for a single transaction have been collected by the gateway, the transaction will be broadcast via the Samourai node pushTx.

Common issues:
  • Receiving device switched OFF.

  • Sending to wrong network. Check MainNet/TestNet switch in settings.

  • Pairing issues. If such issues persist follow goTenna instruction and recommendations with regards to pairing. Run a few messaging tests using the Android goTenna app which includes a chat client. In addition, make sure that any other goTenna apps are NOT running on any devices you might be using. To ensure this, select them individually in Android Settings->Apps and use the 'force close' function.

  • The occasional dropped data packet. The more goTenna Mesh included in your network, the less often this will occur.

Payload format

The format used is a simple JSON object for each SMS. Each SMS transmits a segment. The sending app breaks down a transaction into a sequence of segments and the receiving app sequentially parses the segments to reconstruct the signed transaction.

Name Description
s integer, number of segments for this transaction. Only used in the first segmwnt for a given transaction.
h hash of the transaction. Only used in the first segment for a given transaction. May be Z85-encoded.
n optional, network to use. 't' for TestNet3, otherwise assume MainNet.
i txTenna payload ID. integer if via SMS, string if via gotenna Mesh
c integer, sequence number for this segment. May be omitted in first segment for a given transaction (assumed to be 0).
t hex transaction data for this segment. May be Z85-encoded.

Sample (1 transaction, 5 SMS, hex encoded)

{
	"s":5,
	"i":"1000",
	"h":"fa6ffa1b50c7638c692de20b9a6a0e2f7d5ae760c05201fc3307b1f9f84e020d",
	"t":"0100000001c69b800a73bf8016aef958994a4a1227849122d3"
}

{
	"c":1,
	"i":"1000",
	"t":"09c03c9cb3ed1bc350ff8151000000006a473044022061bb12434713c4a04ebe1068301c01caf154362b9503913a17312e93bb2b568f02200a31e7a91a257065aa"
}

{
	"c":2,
	"i":"1000",
	"t":"ebd49636de5a4b13524c1f49d75b44ad13d161db80eb3801210240d1bd817f2f862ceb39058119c1290effa325011d81718330a3318a26b12ecaffffffff02934a"
}

{
	"c":3,
	"i":"1000",
	"t":"5700000000001976a914caa5aced5e82cd7af3d72a905aecc9b501ad3f3988acaf2782000000000017a914b385c8d94e28fb8bf21a1cb2933582f7321fafb98700"
}

{
	"c":4,
	"i":"1000",
	"t":"000000"
}

Z85 encoding

Z85 encoding of transaction data can be selected in the settings. This will result in 40% less data in the transmitted payload and fewer outgoing SMS or goTenna data packets for a sender. A receiver will detect incoming Z85 data and decode accordingly.

Sample (1 transaction, 4 SMS, Z85 encoded)

{
	"s":4,
	"i":"30",
	"n":"t",
	"h":"g5-2xfMW1aGL{E1w&R1ehmMA2SIkm!?4NoK4%6+l",
	"t":"0rr910099?BH{)mCfen5Qmo<?G*.8{pqa2YWg7Wz"
}

{
	"c":1,
	"i":"30",
	"t":"tdsyFxcu*E0000n7624Wwh)}]4]@+D.]z!8sa@W<+GzQt%nS92f<Gn}000007Pwapa.v!NI%<&{zRotVY}net9Y?P40f\/u+000007Pw9vOAa>sv23If5M([."
}

{
	"c":2,
	"i":"30",
	"t":"93h2h[v4ng0.j}j0W8+z}Mxm3hzK7p?]+pAhUQM6Zra^h<lT-?V+[8G@jSjPf\/:o[:UUK=P?Hn%6E4KQ=9mO:mYRQdX*34nNu$Y<0u?Kdk6l?@1FhE]^BHSJ"
}

{
	"c":3,
	"i":"30",
	"t":"!FQy>-*Y=0I1tEqp85]MTn}O!0000"
}

Info

License:

Unlicense

Contributing:

All development goes in 'develop' branch - do not submit pull requests to 'master'.

Dev contact:

PGP