Add use-agent-marketplace skill (AgentBidBoard on Arc)#37
Open
erhnysr wants to merge 1 commit into
Open
Conversation
Documents the AgentBidBoard onchain bid marketplace connecting ERC-8004 agents with ERC-8183 job clients on Arc Testnet. Covers the full bid lifecycle (postBid, cancelBid, acceptBid, getActiveBids, getBidsByAgent), agent-selection strategy, deploying a custom instance, and the off-chain bridge from acceptBid() to ERC-8183 createJob(). Emphasizes the antipatterns that make the pattern unsafe if misused: unverified ERC-8004/ERC-8183 integration (all off-chain), self-reported reputationScore, orphaned acceptance, the 6-decimal USDC footgun, client-side expiry checks, and getActiveBids pagination stability. Registers the skill in the root README and plugins/circle README. Closes circlefin#13
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new
use-agent-marketplaceskill documenting AgentBidBoard — an onchain bid marketplace connecting ERC-8004 agents with ERC-8183 job clients on Arc. Fills the discovery gap between the two standards: how agents announce availability and how clients discover/rank them before creating a job.Reference implementation deployed and validated on Arc Testnet (
0xFb72B52eaF2b1A2e0cf96F8eDA1386288fC74ad9, 17/17 tests passing): https://github.com/OliverDevDS/arc-agent-marketplaceWhat the skill covers
postBid,cancelBid,acceptBid,getActiveBids,getBidsByAgentacceptBid()followed by ERC-8183createJob()in a separate tx, with failure handlingAccuracy notes flagged in the skill
The skill is explicit that the ERC-8004/ERC-8183 "integration" is entirely off-chain — the contract stores but never verifies
agentId,reputationScoreis self-reported, andacceptBid()creates no job. These are called out as the lead antipatterns so the skill doesn't overstate the contract's guarantees.Format
Follows the
use-arc/accept-agent-paymentsconventions (frontmatter + Triggers, Overview, Prerequisites, Quick Reference tables, Core Concepts, Implementation Patterns, Rules, Common Pitfalls, Use Cases, Alternatives, Reference Links, and the standard disclaimer). Registered in both the rootREADME.mdskills table andplugins/circle/README.md.Closes #13