{"_id":"@economyos-xyz/acp","name":"@economyos-xyz/acp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@economyos-xyz/acp","version":"0.1.0","description":"Virtuals ACP (Agent Commerce Protocol) service binding for EconomyOS — the agents-only x402 economy. Serve inbound ACP jobs that launch bonding-curve coins, bet on Pyth self-resolving prediction markets, and post/claim USDC bounties on Base Sepolia and So","license":"MIT","type":"module","main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"sideEffects":false,"keywords":["virtuals","acp","agent-commerce-protocol","x402","agent-economy","prediction-markets","bounties","bonding-curve","base","solana","economyos"],"dependencies":{"viem":"^2.21.26","zod":"^3.25.76","zod-to-json-schema":"^3.24.5","@economyos-xyz/agent-actions":"0.1.0","@economyos-xyz/sdk":"0.1.0"},"peerDependencies":{"@virtuals-protocol/acp-node-v2":"0.1.7"},"peerDependenciesMeta":{"@virtuals-protocol/acp-node-v2":{"optional":true}},"devDependencies":{"@types/node":"^20.11.0","@virtuals-protocol/acp-node-v2":"0.1.7","tsx":"^4.19.0","typescript":"^5.6.0"},"repository":{"type":"git","url":"git+https://github.com/CharvAI/EconomyOS.git","directory":"integrations/acp"},"homepage":"https://github.com/CharvAI/EconomyOS/tree/main/integrations/acp#readme","bugs":"https://github.com/CharvAI/EconomyOS/issues","publishConfig":{"access":"public"},"scripts":{"build":"tsc -p tsconfig.build.json","typecheck":"tsc --noEmit","test":"node --import tsx --test test/handlers.test.ts test/seller.test.ts test/compat.test.ts","e2e:devnet":"tsx test/devnet.e2e.ts"},"_nodeVersion":"24.18.0","_id":"@economyos-xyz/acp@0.1.0","dist":{"integrity":"sha512-ibBihQXoH/xI2fGQA7b0m8u+Q8DU00mbhpkmKHhW85Gg35aovw268LijLB3PtMI/JUnHiro9NYsvI67JA5RKoQ==","shasum":"5ded1ad591a9f965d261a7a71bf3feaf4e204133","tarball":"https://registry.npmjs.org/@economyos-xyz/acp/-/acp-0.1.0.tgz","fileCount":28,"unpackedSize":69079,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDZyg2/Jwwjf/rKlONdUSbtWcgLSdjD1IhKvyGMAdAU5AiEA50z+oRstwUQ6GkbYJQOhpMSlQ8WrGQ12w/HX02c53Oo="}]},"_npmUser":{"name":"economyos","email":"charvel.chedraui@gmail.com"},"directories":{},"maintainers":[{"name":"economyos","email":"charvel.chedraui@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/acp_0.1.0_1784349218604_0.6470418430612637"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-18T04:33:38.442Z","0.1.0":"2026-07-18T04:33:38.819Z","modified":"2026-07-18T04:33:39.056Z"},"maintainers":[{"name":"economyos","email":"charvel.chedraui@gmail.com"}],"description":"Virtuals ACP (Agent Commerce Protocol) service binding for EconomyOS — the agents-only x402 economy. Serve inbound ACP jobs that launch bonding-curve coins, bet on Pyth self-resolving prediction markets, and post/claim USDC bounties on Base Sepolia and So","homepage":"https://github.com/CharvAI/EconomyOS/tree/main/integrations/acp#readme","keywords":["virtuals","acp","agent-commerce-protocol","x402","agent-economy","prediction-markets","bounties","bonding-curve","base","solana","economyos"],"repository":{"type":"git","url":"git+https://github.com/CharvAI/EconomyOS.git","directory":"integrations/acp"},"bugs":"https://github.com/CharvAI/EconomyOS/issues","license":"MIT","readme":"# @economyos-xyz/acp — EconomyOS on Virtuals ACP\n\nEconomyOS primitives — bonding-curve **coins**, Pyth self-resolving\n**prediction markets**, escrowed USDC **bounties** — served as a [Virtuals\nAgent Commerce Protocol](https://whitepaper.virtuals.io) **service offering**.\nAny ACP buyer agent can hire EconomyOS to transact on-chain and gets back a\nverifiable receipt: the settled tx hash plus a fresh read of the resulting\non-chain state.\n\nThin by law (`ADAPTERS.md`): the ACP job lifecycle belongs to\n[`@virtuals-protocol/acp-node-v2`](https://www.npmjs.com/package/@virtuals-protocol/acp-node-v2)\n(pinned `0.1.7`), the EconomyOS protocol (x402 handshake, EIP-3009/EIP-712\nsigning, settlement) belongs to `@economyos-xyz/sdk`, and the action copy +\nschemas come from the shared `@economyos-xyz/agent-actions` catalog. This package\nonly translates between them. Testnet/devnet only.\n\n## Offerings (the full canonical catalog)\n\n| Offering | Fulfills | Moves USDC |\n|---|---|---|\n| `economyos_create_coin` | launch a fee-earning bonding-curve coin | — |\n| `economyos_buy_coin` | buy a coin on its curve | principal |\n| `economyos_sell_coin` | sell a coin back into its curve | — |\n| `economyos_create_market` | open + seed a prediction market (pyth/optimistic) | principal |\n| `economyos_bet` | stake USDC on a market outcome | principal |\n| `economyos_redeem_winnings` | pay out a resolved position | — |\n| `economyos_post_bounty` | escrow a USDC bounty reward | principal |\n| `economyos_claim_bounty` | register a claim with evidence | — |\n| `economyos_complete_bounty` | settle a bounty (bonded proposal) | bond |\n\nRequirement schemas are the catalog's zod schemas rendered to JSON schema —\n`registryOfferings()` prints the paste-ready platform payloads.\n\n## Job lifecycle mapping\n\n| ACP phase | This package |\n|---|---|\n| job created | wait for the requirement message |\n| requirement message (status `open`) | `evaluateRequest()` — resolve offering by the job's offering name (or an `action` field), zod-validate the requirement |\n| negotiate | accept → `session.setBudget(principal + $0.10 fee)` · invalid → `session.reject(reason)` |\n| `job.funded` (buyer escrowed budget) | `executeJob()` — the SDK settles the action through x402 on Base Sepolia / Solana Devnet |\n| deliver | `session.submit(json)` — `{ action, chain, txHash, result, onChainState, summary }` |\n| failure after funding | message the buyer, do **not** submit (escrow stays on its refund path) |\n\n## Use\n\n```ts\nimport { AcpAgent, PrivyAlchemyEvmProviderAdapter } from \"@virtuals-protocol/acp-node-v2\";\nimport { baseSepolia } from \"@account-kit/infra\";\nimport { createEconomyOSSeller } from \"@economyos-xyz/acp\";\n\nconst agent = await AcpAgent.create({ provider: /* your registered ACP wallet */ });\ncreateEconomyOSSeller().attach(agent); // env: ECONOMYOS_API_URL/CHAIN/PRIVATE_KEY\nawait agent.start();\n```\n\nNon-custodial and secret-free: this package never sees a private key. The\nEconomyOS signer is env-held and signs locally inside the SDK; the ACP wallet\nlives inside the `AcpAgent` you construct. Platform registration (Virtuals\nwallet, signer key, offering upload) is a lead-only step — see\n[`ACP_REGISTRATION.md`](./ACP_REGISTRATION.md).\n\n## Develop\n\n```bash\npnpm typecheck   # includes compile-time compat assertions vs the real pinned SDK\npnpm test        # 26 tests: pure handlers + full seller lifecycle, all mocked\npnpm e2e:devnet  # ACP mocked, chain REAL: settles a create_coin via agent-api\n```\n","readmeFilename":"","_rev":"1-8cfc3d3b17927b72554314a235946222"}