https://github.com/rdkr/oniongen-go

🔑 v3 .onion vanity URL generator written in Go
https://github.com/rdkr/oniongen-go

golang onion tor

Last synced: 26 days ago
JSON representation

🔑 v3 .onion vanity URL generator written in Go

• Host: GitHub
• URL: https://github.com/rdkr/oniongen-go
• Owner: rdkr
• Created: 2017-03-19T23:48:33.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-10-19T20:36:49.000Z (about 1 year ago)
• Last Synced: 2024-08-03T17:12:12.048Z (4 months ago)
• Topics: golang, onion, tor
• Language: Go
• Homepage:
• Size: 12.7 KB
• Stars: 128
• Watchers: 6
• Forks: 25
• Open Issues: 6
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-network-stuff - **21**星

README

        
# oniongen-go

v3 .onion address vanity URL generator written in Go.

This implementation generates random ed25519 keys across all CPU cores. The ed25519 public key is converted to a Tor v3 .onion address which is then compared to a user supplied regex to find a vanity URL. If the regex for the .onion address matches, the secret key is expanded for use by Tor and the public key, secret key, and hostname are written to file in a new directory named for the .onion address. The program terminates when the user supplied number of addresses have been generated.

## Usage

```

go run main.go  

    regex   regex pattern addresses should match, consisiting of: A-Z, 2-7

    number  number of matching addresses to generate before exiting

```

## Example

```

go run main.go "^test" 5

    generate 5 onion addresses starting with "test"

```

## References

- public key -> onion: https://github.com/torproject/torspec/blob/12271f0e6db00dee9600425b2de063e02f19c1ee/rend-spec-v3.txt#L2136-L2158

- secret key expansion:

    - implementation in mkp224o: https://github.com/cathugger/mkp224o/blob/af5a7cfe122ba62e819b92c8b5a662151a284c69/ed25519/ed25519.h#L153-L161

    - possibly related: https://github.com/torproject/torspec/blob/12271f0e6db00dee9600425b2de063e02f19c1ee/rend-spec-v3.txt#L2268-L2327 ??