https://github.com/skhomuti/address-namify

Weird name for your Ethereum address
https://github.com/skhomuti/address-namify

Last synced: about 1 month ago
JSON representation

Weird name for your Ethereum address

• Host: GitHub
• URL: https://github.com/skhomuti/address-namify
• Owner: skhomuti
• Created: 2023-10-30T15:53:26.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-11-21T15:07:54.000Z (12 months ago)
• Last Synced: 2023-11-22T06:23:15.039Z (12 months ago)
• Language: Python
• Size: 13.7 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# address-namify

> let things be weird

This simple tool allows you to create a name for an Ethereum address.

Based on [corpora](https://github.com/dariusk/corpora) collections.

## Usage

First of all, make sure that submodules are initialized:

```bash

git submodule update --init --recursive

```

Generate {num} random names to play with variants:

```bash

python3 ./namify.py --generate {num}

```

Generate name using Ethereum address:

```bash

python3 ./namify.py --address {address}

```

Rough calculation of the collision chance:

```bash

python3 ./namify.py --collisions

```

Set a custom string template:

```bash

# default template

python3 ./namify.py --generate 10 --template="{adj1}-{adj2}-{noun}"

# 2-words template

python3 ./namify.py --generate 10 --template="{adj1}-{noun}"

```

## Misc

This tool provides constant names per address as long as dictionaries stay the same.

The names are *not unique* and there might be collisions. E.g. `{adj1} {adj2} {noun}` has ~0.0005% chance of collision per 100_000 iterations. 

It's possible to use it on-chain by additionally checking the given name for uniqueness 

and optionally adding a numeric prefix like `{name}-{i}` where `i` is the name count already used in the contract.   

Words count and sentence probably might be revised.