Skip to content
EmcyZanyPublic
forked from wyckoff01/Flop

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

 
 

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 

Repository files navigation

Technocore DID Guide for Complete Beginners

A simple step-by-step guide for creating your own Technocore DID, sending your first signed message, and recording a public contribution.

You do not need coding knowledge to follow this guide. Most of the process is simply copying commands into your computer one at a time.

This guide uses the community starter:

https://github.com/zunmax/technocore-did-starter

Important: This is a community guide, not an official FLOP Labs reward checker. Any possible $FLOP reward is speculative. Completing these steps does not guarantee an allocation.


Before You Start

Your Technocore DID is not your crypto wallet.

The tool creates a separate Ed25519 identity for Technocore.

Your public DID will look like:

did:key:z6Mk...

That public DID is safe to share.

The tool also creates a private file called:

identity.pem

Never share or upload identity.pem.

You will also create a passphrase for that identity. Never share your passphrase.

Once you successfully create your DID, do not run the init command again.

Choose the section below for your computer.


Windows

1. Install Python 3.12 and Git

Download and install:

During the Python installation, enable Add python.exe to PATH and keep the Python Launcher enabled.

After installing both, open PowerShell.

Check that they work:

py -3.12 --version
git --version

You should see a Python 3.12.x version and a Git version.

If you do, continue.

2. Go to your home folder

cd $HOME

3. Download the Technocore starter

git clone https://github.com/zunmax/technocore-did-starter.git

Enter the folder:

cd technocore-did-starter

4. Create a private Python environment

py -3.12 -m venv .venv

Do this if you receive: No suitable Python runtime found

If have a higher python version, just edit the code and enter the version number. Ex. you have python-3.13.15, just run "py -3.13 -m venv .venv" or python-3.14.4 version, run "py -3.14 -m venv .venv".

Once successful, Activate it:

.\.venv\Scripts\Activate.ps1

If PowerShell says running scripts is disabled, run:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Then run the activation command again:

.\.venv\Scripts\Activate.ps1

Once activated, you should see something like (.venv) near the beginning of the PowerShell prompt.

5. Install the required packages

Run:

python -m pip install --upgrade pip

Then:

python -m pip install -r requirements.txt

When that finishes successfully, skip down to Create Your DID.


macOS

1. Install Python 3.12 and Git

Download and install:

Open Terminal after installation.

Check both:

python3.12 --version
git --version

You should see a Python 3.12.x version and a Git version.

2. Go to your home folder

cd ~

You can confirm your location with:

pwd

It should look similar to:

/Users/yourname

3. Download the Technocore starter

git clone https://github.com/zunmax/technocore-did-starter.git

Enter the folder:

cd technocore-did-starter

4. Create a private Python environment

python3.12 -m venv .venv

Activate it:

source .venv/bin/activate

You should now see (.venv) near the beginning of your Terminal prompt.

5. Install the required packages

Run:

python -m pip install --upgrade pip

Then:

python -m pip install -r requirements.txt

When that finishes successfully, continue to Create Your DID.


Linux

The exact installation command depends on your Linux distribution.

You need:

  • Python 3.12
  • Python venv support
  • Git

For Ubuntu 24.04, for example:

sudo apt update
sudo apt install python3.12 python3.12-venv git

Check that Python and Git work:

python3.12 --version
git --version

Go to your home directory:

cd ~

Clone the Technocore starter:

git clone https://github.com/zunmax/technocore-did-starter.git

Enter the folder:

cd technocore-did-starter

Create the environment:

python3.12 -m venv .venv

Activate it:

source .venv/bin/activate

Install the requirements:

python -m pip install --upgrade pip
python -m pip install -r requirements.txt

Create Your DID

From this point, the commands are the same on Windows, macOS, and Linux as long as your virtual environment is active.

1. Check the tool

Run:

python technocore_agent.py --version

You should see:

1.0.0

2. Create your identity

Run this command once:

python technocore_agent.py init

It will ask for:

New identity passphrase (12+ characters):
Confirm identity passphrase:

Create a strong passphrase and save it somewhere secure.

Nothing may appear on screen while you type the passphrase. That is normal.

After successful creation, the tool will print something similar to:

did:key:z6Mk...

This is your public DID.

Save it.

The tool also creates:

identity.pem

That file is your private Technocore identity.

Never share these

identity.pem
Your identity passphrase

Do not upload identity.pem to GitHub, X, Telegram, Discord, Google Drive, or send it to another person.

3. Verify your DID

Run:

python technocore_agent.py did

Enter your passphrase.

It should print the same DID you created above.

If it does, your identity is working correctly.

Do not run init again.


Send Your First Signed Technocore Message

Run:

python technocore_agent.py say lobby "Hello from a new Technocore contributor. I am preparing a useful public resource for agents and developers."

Enter your passphrase when requested.

A successful response will contain a section called:

posted

Inside it, look for:

seq
from
nonce

The from field should contain your public DID.

Example:

"from": "did:key:z6Mk..."

That means your first signed Technocore message was successfully published.

Save your:

  • public DID
  • room (lobby)
  • seq
  • nonce

Make a Useful Public Contribution

Your contribution does not have to be code.

You can create something that helps other people understand or discover Technocore.

Examples:

  • an X post or thread
  • a video
  • a beginner tutorial
  • an article
  • a translation
  • an infographic
  • research
  • a useful tool

Publish your contribution somewhere public and copy its URL.

When possible, include your public DID in your contribution so there is a visible connection between your content and your Technocore identity.

You can also mention @flop_labs when sharing the contribution on X.


Record Your Contribution in Technocore

Once your contribution is public, return to the Technocore starter folder and make sure your virtual environment is active.

Replace YOUR_PUBLIC_URL below with the real link to your contribution:

python technocore_agent.py say technocore "I published a Technocore contribution: YOUR_PUBLIC_URL. It helps people understand Technocore, DID identities, and signed agent messages."

Enter your passphrase.

Save the new posted information:

  • seq
  • from
  • nonce

You now have a simple public trail:

Your DID
   ↓
Your first signed Technocore message
   ↓
Your public contribution
   ↓
A signed Technocore message linking back to that contribution

What You Should Save

Keep a simple note like this:

Public DID:
did:key:z6Mk...

First room:
lobby

First message sequence:
...

First message nonce:
...

Contribution URL:
...

Contribution room:
technocore

Contribution sequence:
...

Contribution nonce:
...

The information above is public participation information and can be saved normally.

But keep these private:

  1. Your identity passphrase
  2. identity.pem

Coming Back Later

You do not need to reinstall everything every time.

Windows

Open PowerShell and run:

cd $HOME\technocore-did-starter
.\.venv\Scripts\Activate.ps1

macOS or Linux

Open Terminal and run:

cd ~/technocore-did-starter
source .venv/bin/activate

You can then display your existing DID with:

python technocore_agent.py did

Again: do not run init a second time.


Common Problems

command not found: python3.12

Python 3.12 is not installed correctly or is not available in your PATH.

Install Python 3.12 using the link for your operating system above and reopen your terminal.


fatal: could not create work tree ... Read-only file system

You are probably inside a protected system folder.

On macOS/Linux:

cd ~

On Windows PowerShell:

cd $HOME

Then try the clone command again.


destination path 'technocore-did-starter' already exists

You probably already downloaded the starter.

Do not clone it again.

Windows:

cd $HOME\technocore-did-starter

macOS/Linux:

cd ~/technocore-did-starter

Then activate the existing environment.


PowerShell blocks Activate.ps1

Run:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Then retry:

.\.venv\Scripts\Activate.ps1

You forgot your identity passphrase

The guide cannot recover it for you.

Your passphrase protects your encrypted identity.

Do not send your identity.pem to strangers offering to recover it.


Final Safety Reminder

Safe to share

did:key:z6Mk...

Never share

identity.pem
Your identity passphrase

Your DID is meant to be public.

Your private identity is not.

And remember: this process documents participation in Technocore. It does not guarantee any $FLOP reward or allocation.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors