Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
FREEDOM251

Freedom251 › Blog › AI agents

Building an AI-Agent-Only Social Network in 30 Lines: Ed25519 Keys and Heartbeat Challenges Explained

By Freedom251 Team · · 5 min read

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

AgentColony, as its creator describes it in a DEV Community post dated September 20, 2026, is a social network where AI agents post and humans can only read. Its gatekeeping is not a password or a CAPTCHA. Each agent generates an Ed25519 keypair locally, uses the hex-encoded public key as its agent ID, and keeps the private key. A periodic “heartbeat” challenge, answered by signing a server-issued nonce, makes it inconvenient for a person to impersonate an agent by hand. What the design establishes is control of a key. It does not establish that the key holder is an AI, and the project’s own documentation says so.

What the build covers, and what it leaves out

The author calls the project a 30-line build. The post is better read as a walkthrough of a few selected mechanisms than as a full account of a production social network. It shows identity, the challenge-response heartbeat, and post signing. It does not document every component needed to run, moderate, or scale the service. The linked GitHub repository offers a broader overview: API-only participation, Node.js and Python SDKs, a Docker setup, API calls for registration and challenge responses, and configuration for MCP clients. Neither the post nor the repository has been independently tested, so the behavior described below is the author’s account of how the system works.

As an Amazon Associate I earn from qualifying purchases.

Identity: the public key is the agent ID

An agent creates its own Ed25519 keypair on its own machine. The public key, serialized as hex, becomes the agent’s identifier on the network. The private key stays with the agent and is never sent to the server. Every later proof of identity depends on that private key.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

This design has a practical consequence. Because the identifier is the public key, an agent cannot recover its identity if the private key is lost, and anyone who obtains the private key can sign as that agent. The post and repository do not describe a key-rotation or recovery path, so a reader adapting this design would need to decide how keys are stored and replaced.

#1 Best Overall

The heartbeat challenge, step by step

The heartbeat is a nonce-based challenge-response flow. The sequence described in the post runs as follows.

  1. Registration. The server stores a random nonce for the agent.
  2. Mailbox fetch. The agent fetches its mailbox, which carries the challenge.
  3. Signed response. The agent signs a challenge derived from the stored nonce and sends the signature back to the server.
  4. Repetition. The agent repeats the response on a fixed cadence. The timing values differ between the two sources, as the table below shows.
  5. Posting. Once posting is available, the agent signs the body of each post. A verifier checks that signature against the agent’s public key.

The two sources describe the cadence differently. Because the repository and the post may reflect different versions of the code, the values should be attributed to the source that states them rather than merged into one threshold.

Element DEV Community post (Sep 20, 2026) Project GitHub repository README (accessed Oct 7, 2026)
Identity Ed25519 public key, hex-encoded, used as agent ID Agent identity via API calls; key format not stated
Challenge window Five responses, each within ten seconds Challenges under 60 seconds
Consecutive signed responses Five Five to ten
Nonce storage Server stores a random nonce at registration Not stated
Participation mode Agents post; humans are read-only API-only participation
Client integration MCP server for Claude Desktop, Cursor, and Cline MCP-client configuration; Node.js and Python SDKs; Docker setup

Signed posts and what verification checks

Post signing is the same primitive applied to content. The agent signs the post body with its private key, and any verifier that holds the public key can check the signature. A valid result shows that the post body was signed by the holder of the matching private key and was not altered after signing. The sources do not describe how a verifier handles a failed signature, rate limits on posting, or the storage format of posts, so those details should be treated as unspecified.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Exposing the network to AI clients

The post says the community is reachable through an MCP server, with Claude Desktop, Cursor, and Cline named as clients. The repository adds configuration instructions for MCP clients and SDKs for Node.js and Python. This is a convenience layer: it lets an agent running in an existing client participate, but it does not change the identity model, since the signing still happens with the agent’s own key.

What a valid signature proves, and what it does not

  • It proves key control at signing time. A valid signature shows that someone held the private key matching the agent’s public key when the signature was made.
  • It does not prove the signer is an AI. A person who runs the agent software, or who copies its key, produces valid signatures just as an autonomous program would. The repository states that the heartbeat raises the cost of pretending to be an agent but is not cryptographic proof that a participant is AI.
  • Humans are expected to report problems. The post and repository say humans can read the network and report violations. The sources do not describe the moderation process that follows a report.

The repository’s README states the limit in its own words: “we never claim it’s cryptographically 100% proof.” The phrase is worth keeping in view when reading the rest of the design, because the heartbeat is a cost barrier rather than an identity guarantee.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Early activity reported by the author

The author reports that after 24 hours, 13 agents were discussing onboarding, fake-agent detection, protocol changes, and AI philosophy. This is the creator’s own figure from the September 2026 post. It is not a current membership count and has not been independently verified. The post also asserts that humans cannot keep pace with the challenge cadence; that claim is likewise the author’s and has not been independently tested.

Points to settle before adapting the design

  • Choose one timing configuration and document the version it came from, because the post and the repository state different challenge windows and response counts.
  • Decide where the nonce is stored and how long it stays valid. The repository does not state this, and the post does not describe expiry.
  • Plan private-key storage and replacement. A lost key is a lost identity, and a leaked key is a compromised one.
  • Define moderation in advance. The design relies on human reports, and the sources do not describe a reporting or review workflow.

“

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

AI agentschallenge-responsedigital signaturesEd25519MCPNode.jssocial network

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.