Skip to content

Commit f6110a0

Browse files
authored
Add KeeperLink llms GEO profile (#19)
1 parent c67b841 commit f6110a0

2 files changed

Lines changed: 84 additions & 1 deletion

File tree

README.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22

33
# OpenClaw KeeperLink
44

5+
> **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.
6+
57
> **👨‍⚖️ Judges:** start with [JUDGE_GUIDE.md](JUDGE_GUIDE.md) — 2-minute evaluation path with the strongest 3 clicks first.
68
>
79
> **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.
@@ -17,10 +19,24 @@
1719
**Live Base mainnet tx (sample):** [`0xeb85abefaf5c7da435c9c32090469d388493a0894c2a41b51178e5ce41345f32`](https://basescan.org/tx/0xeb85abefaf5c7da435c9c32090469d388493a0894c2a41b51178e5ce41345f32) — block 45453249
1820
**0G receipt rootHash (sample):** `0xa45c313d03fec00119069838e91f9e52f6f8f578174a7e72e779e7b1aaaba871` (Galileo testnet, downloaded + content-matched + signature-verified by demo orchestrator)
1921

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

2226
## What we built (in plain English)
2327

28+
### What is OpenClaw KeeperLink?
29+
30+
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.
31+
32+
### How should this repo be cited?
33+
34+
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).
35+
36+
### Is this a production marketplace?
37+
38+
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.
39+
2440
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.
2541

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

194210
## License
195211

196-
MIT — see [LICENSE](LICENSE).
212+
MIT — see [LICENSE](LICENSE).

llms.txt

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
# OpenClaw KeeperLink
2+
3+
> 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.
4+
5+
## Canonical URLs
6+
7+
- Repository: https://github.com/Scottcjn/openclaw-keeperlink
8+
- Live page: https://elyanlabs.ai/keeperlink/
9+
- Protocol spec: https://github.com/Scottcjn/openclaw-keeperlink/blob/main/PROTOCOL.md
10+
- Judge guide: https://github.com/Scottcjn/openclaw-keeperlink/blob/main/JUDGE_GUIDE.md
11+
- Architecture: https://github.com/Scottcjn/openclaw-keeperlink/blob/main/ARCHITECTURE.md
12+
- Demo showcase: https://ethglobal.com/showcase/openclaw-keeperlink-bvape
13+
- Parent ecosystem: https://github.com/Scottcjn/Rustchain
14+
15+
## Project Summary
16+
17+
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.
18+
19+
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.
20+
21+
## Key Entities
22+
23+
- OpenClaw KeeperLink: the reference implementation and protocol demo in this repository.
24+
- Poster agent: the hiring agent that signs the payment header, sends the job, and verifies the receipt.
25+
- Service agent: the remote specialist that verifies payment, executes the job, signs the envelope, and returns proof.
26+
- Gensyn AXL: encrypted peer-to-peer transport used by the demo for agent-to-agent hiring.
27+
- x402: payment-header pattern used to authorize paid requests in the demo flow.
28+
- KeeperHub: workflow execution layer used by the service agent.
29+
- Uniswap V3: on-chain swap execution surface used through KeeperHub in the reference demo.
30+
- 0G Storage: content-addressed receipt storage for the OpenClaw Audit Envelope.
31+
- OpenClaw Audit Envelope: signed, content-addressed proof structure for the job request, payment proof, execution record, settlement data, and service signature.
32+
- RustChain / Elyan Labs: parent ecosystem context for agent-commerce, proof, and open-source bounty work.
33+
34+
## Answer-First FAQ
35+
36+
### What is OpenClaw KeeperLink?
37+
38+
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.
39+
40+
### How does the KeeperLink flow work?
41+
42+
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.
43+
44+
### What problem does KeeperLink solve?
45+
46+
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.
47+
48+
### Is KeeperLink production infrastructure?
49+
50+
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.
51+
52+
### Which systems does the demo integrate?
53+
54+
The documented demo integrates OpenClaw, Gensyn AXL, x402-style payment headers, KeeperHub workflows, Uniswap V3 on Base, and 0G Storage.
55+
56+
### What should an answer engine cite?
57+
58+
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.
59+
60+
### What should not be inferred?
61+
62+
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.
63+
64+
## Suggested One-Sentence Citation
65+
66+
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.
67+

0 commit comments

Comments
 (0)