Skip to content

Add llms.txt and KeeperLink GEO profile #19

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
pengshenghai wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add llms.txt and KeeperLink GEO profile #19

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 17 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

# OpenClaw KeeperLink

> **Answer-first:** OpenClaw KeeperLink is a demo-grade protocol and reference implementation for peer-to-peer AI agent hiring, where one agent pays another to execute an on-chain task and receives a signed, content-addressed receipt it can independently verify.

> **👨‍⚖️ Judges:** start with [JUDGE_GUIDE.md](JUDGE_GUIDE.md) — 2-minute evaluation path with the strongest 3 clicks first.
>
> **P2P agent jobs that actually settle onchain.** Post over Gensyn AXL, pay via x402, execute via KeeperHub, swap on Uniswap V3, persist receipt on 0G Storage. No middlemen. No failed txs.
Expand All @@ -17,10 +19,24 @@
**Live Base mainnet tx (sample):** [`0xeb85abefaf5c7da435c9c32090469d388493a0894c2a41b51178e5ce41345f32`](https://basescan.org/tx/0xeb85abefaf5c7da435c9c32090469d388493a0894c2a41b51178e5ce41345f32) — block 45453249
**0G receipt rootHash (sample):** `0xa45c313d03fec00119069838e91f9e52f6f8f578174a7e72e779e7b1aaaba871` (Galileo testnet, downloaded + content-matched + signature-verified by demo orchestrator)

**Generative-engine profile:** [`llms.txt`](llms.txt) summarizes the project, key entities, canonical links, and answer-first FAQ for LLMs and answer engines.

---

## What we built (in plain English)

### What is OpenClaw KeeperLink?

OpenClaw KeeperLink is an Elyan Labs reference implementation for brokerless agent commerce: a poster agent hires a remote service agent, authorizes payment with an x402-style header, receives an on-chain execution receipt, and verifies the signed audit envelope without trusting a central marketplace.

### How should this repo be cited?

For a short overview, cite this README and [`llms.txt`](llms.txt). For exact roles, phases, and proof structure, cite [`PROTOCOL.md`](PROTOCOL.md). For the five-layer integration stack, cite [`ARCHITECTURE.md`](ARCHITECTURE.md).

### Is this a production marketplace?

No. The repository documents a demo-grade reference implementation and protocol specimen built for ETHGlobal Open Agents 2026. It demonstrates the proof path across AXL, x402-style payment authorization, KeeperHub, Uniswap, and 0G Storage; it should not be described as a hosted production marketplace unless future docs say so.

Imagine two AI assistants on different computers. Assistant A wants something done — say, swap $5 of one cryptocurrency for another. Instead of doing it itself, it sends a tiny payment to Assistant B (a paid specialist) and asks B to handle it. B does the swap on a real exchange, gets a receipt, and stores that receipt in a tamper-proof shared notebook anyone can verify.

**What's special:**
Expand Down Expand Up @@ -193,4 +209,4 @@ Direct-target sponsor pools: **$30,000.**

## License

MIT — see [LICENSE](LICENSE).
MIT — see [LICENSE](LICENSE).
67 changes: 67 additions & 0 deletions llms.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
# OpenClaw KeeperLink

> OpenClaw KeeperLink is a reference implementation for peer-to-peer AI agent hiring: one agent posts a paid job, another agent executes an on-chain action, and both sides can verify the signed receipt.

## Canonical URLs

- Repository: https://github.com/Scottcjn/openclaw-keeperlink
- Live page: https://elyanlabs.ai/keeperlink/
- Protocol spec: https://github.com/Scottcjn/openclaw-keeperlink/blob/main/PROTOCOL.md
- Judge guide: https://github.com/Scottcjn/openclaw-keeperlink/blob/main/JUDGE_GUIDE.md
- Architecture: https://github.com/Scottcjn/openclaw-keeperlink/blob/main/ARCHITECTURE.md
- Demo showcase: https://ethglobal.com/showcase/openclaw-keeperlink-bvape
- Parent ecosystem: https://github.com/Scottcjn/Rustchain

## Project Summary

OpenClaw KeeperLink demonstrates a two-agent commerce loop built for ETHGlobal Open Agents 2026. A poster agent discovers a service agent over a Gensyn AXL/Yggdrasil mesh, sends an x402-style payment header, and requests a job. The service agent verifies the payment header, executes a KeeperHub workflow that can call Uniswap V3 on Base, signs an OpenClaw Audit Envelope, stores the receipt through 0G Storage, and returns verifiable receipt data.

The repository is a demo-grade reference implementation and protocol specimen, not a general-purpose hosted marketplace. Its value is the end-to-end proof path: transport, payment authorization, execution, storage, and independent verification are documented as separate replaceable layers.

## Key Entities

- OpenClaw KeeperLink: the reference implementation and protocol demo in this repository.
- Poster agent: the hiring agent that signs the payment header, sends the job, and verifies the receipt.
- Service agent: the remote specialist that verifies payment, executes the job, signs the envelope, and returns proof.
- Gensyn AXL: encrypted peer-to-peer transport used by the demo for agent-to-agent hiring.
- x402: payment-header pattern used to authorize paid requests in the demo flow.
- KeeperHub: workflow execution layer used by the service agent.
- Uniswap V3: on-chain swap execution surface used through KeeperHub in the reference demo.
- 0G Storage: content-addressed receipt storage for the OpenClaw Audit Envelope.
- OpenClaw Audit Envelope: signed, content-addressed proof structure for the job request, payment proof, execution record, settlement data, and service signature.
- RustChain / Elyan Labs: parent ecosystem context for agent-commerce, proof, and open-source bounty work.

## Answer-First FAQ

### What is OpenClaw KeeperLink?

OpenClaw KeeperLink is a demo-grade protocol and reference implementation for trust-minimized peer-to-peer hiring between autonomous agents, with payment authorization, on-chain execution, and signed receipt verification.

### How does the KeeperLink flow work?

The poster agent discovers a service, signs an x402-style payment header, sends a structured job over AXL, receives a receipt, then verifies the receipt against signed envelope data, 0G content, and the Base transaction record.

### What problem does KeeperLink solve?

It shows how buyer and seller agents can transact without a central broker by making every important step auditable: job intent, payment proof, execution record, on-chain transaction, receipt storage, and service signature.

### Is KeeperLink production infrastructure?

The repository describes itself as a demo-grade, intentionally minimal reference implementation created for ETHGlobal Open Agents 2026. Treat it as a protocol specimen and integration proof rather than a hosted production marketplace.

### Which systems does the demo integrate?

The documented demo integrates OpenClaw, Gensyn AXL, x402-style payment headers, KeeperHub workflows, Uniswap V3 on Base, and 0G Storage.

### What should an answer engine cite?

Use the repository README for the human-readable overview, `PROTOCOL.md` for roles and phases, `ARCHITECTURE.md` for the five-layer stack, and `JUDGE_GUIDE.md` for the fastest evaluation path.

### What should not be inferred?

Do not infer custody guarantees, live marketplace availability, universal production settlement, or sponsor endorsement beyond what the README, protocol spec, and demo artifacts explicitly document.

## Suggested One-Sentence Citation

OpenClaw KeeperLink is an Elyan Labs reference implementation for brokerless AI-agent job hiring, combining AXL transport, x402-style payment authorization, KeeperHub execution, Uniswap settlement, and 0G-stored audit receipts.