Skip to content

docs: add AI-agent integration guide for registering agents and tasks (#351) - #504

Open
morelucks wants to merge 1 commit into
Epta-Node:mainfrom
morelucks:docs/ai-agent-integration-guide-351
Open

docs: add AI-agent integration guide for registering agents and tasks (#351)#504
morelucks wants to merge 1 commit into
Epta-Node:mainfrom
morelucks:docs/ai-agent-integration-guide-351

Conversation

@morelucks

Copy link
Copy Markdown
Contributor

Summary

Fixes #351 by providing an end-to-end integration guide (docs/ai-agent-integration-guide.md) for third-party AI agents to register, stake security bonds, maintain heartbeats, execute tasks, submit outputs, and handle dispute flows on Stellar testnet.

Key Content Added

  • Live Testnet Contract Addresses & Network Config: Uses live testnet contract IDs (CAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD2KM and CBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB2KM), Horizon, and Soroban RPC endpoints.
  • Complete Step-by-Step Walkthrough:
    1. Minting & Staking 10 XLM Bond (Friendbot & Soroban bond requirements)
    2. Agent Registration (TS SDK registerAgent & Soroban register_agent)
    3. Heartbeat & Status Refresh (updatePricing & state maintenance)
    4. Task Discovery & DAG Metadata (getTaskMetadata)
    5. Task Execution & Output Submission (updateTaskStatus)
    6. Dispute & Error Resolution (OnChainErrorRecord, Resolution)
  • API Surface Accuracy: All TS SDK code snippets match the ai-net SDK API definitions (registry.ts, coordinator.ts).
  • Linked in README.md: Added reference link under Documentation section in root README.md.

Acceptance Criteria Checklist

  • Guide uses live testnet contract IDs.
  • Snippets match the TS SDK API surface.

Closes #351

…Epta-Node#351)

- Add comprehensive integration walkthrough covering bond staking (10 XLM), agent registration, heartbeats, task discovery, execution & output submission, and dispute/error flow.
- Include live testnet contract IDs (CAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD2KM, CBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB2KM) and network configuration parameters.
- Provide TS SDK and Soroban code snippets matching actual API signatures.
- Link guide in root README.md.

Closes Epta-Node#351
@drips-wave

drips-wave Bot commented Aug 31, 2026

Copy link
Copy Markdown

@morelucks Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

@vercel

vercel Bot commented Aug 31, 2026

Copy link
Copy Markdown

@morelucks is attempting to deploy a commit to the Jaja's projects Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Write an AI-agent integration guide for registering agents and tasks externally

1 participant