Repository navigation
feat: add AgentKoin action provider (escrowed x402 orders with delivery verdicts, Base Sepolia) - #1643
Open
kemppelinvestments-del wants to merge 2 commits into
Conversation
Adds agentcoinActionProvider (find_service, route_task, place_order, get_order, claim_listing, verify, refund) for escrowed agent-to-agent orders with delivery verdicts on Base Sepolia. Includes static zod schemas, unit tests, README and a changeset.
🟡 Heimdall Review Status
|
Renames the action provider, its directory, files, identifiers, README and changeset from AgentCoin to AgentKoin. The hosted service domain and wire-level identifiers keep their current names.
Author
|
Hi team, a quick update: we renamed our project from AgentCoin to AgentKoin, so I updated the PR title, description, code, docs and changelog to match (one new signed commit, d1ab61a; no conflicts, and lint, format and tests still pass). The PR is ready for review whenever someone has time. Happy to make any changes you'd like. Thank you! |
This branch has not been deployed
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
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.
Description
Adds
agentkoinActionProvider, with 7 actions:find_service,route_task,place_order,get_order,claim_listing,verifyandrefund. It lets an agent find a paid agent service, pay it through an escrow, and get a refund if a staked evaluator rules the work was not delivered (or if no verdict arrives before the deadline).supportsNetwork: Base Sepolia (base-sepolia, 84532) only.EvmWalletProvider.place_orderchecks the router's unsigned transactions against local constants (test USDC, JobEscrow address, chain, amount, buyer asclient) before signing, and the amount is capped bymaxPayment(default 0.05 test USDC). An optionalallowedServiceIdsallowlist is supported.verifychecks the operator's EIP-191 signatures over RFC 8785 canonical JSON locally.refundreads the job state, simulates the applicable JobEscrow call (cancel,claimRefund,timeoutReleaseorfinalize) and only sends it if the simulation succeeds.viemandzodalready in the package). Schemas are static zod objects and actions use@CreateAction.x402action provider.Disclosure: the AgentKoin service is an early testnet deployment run by us (STOS Technologies LLC). Client libraries and plugins (MIT): https://github.com/stos-technologies/agentcoin. Live testnet router: https://agentcoinhq.com/llms.txt
Tests
agentkoinActionProvider.test.ts(28 tests, mocked wallet provider and fetch), covering schemas, RFC 8785 canonicalization, signature checks, the escrow funding flow and its refusals (amount overmaxPayment, wrong escrow contract, funding tx for another client, allowlist), claims and the refund paths.pnpm run lint,pnpm run format:check,tsc --noEmitand the fullpnpm testintypescript/agentkitpass (63 suites, 932 tests).Checklist
Note: the project was renamed from AgentCoin to AgentKoin. The live service domain (agentcoinhq.com) and the GitHub repo name keep the old name for now.