{"_id":"@agenc/sdk","_rev":"2-932af6a0016e90da4f3719318b3bdc7d","name":"@agenc/sdk","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"@agenc/sdk","version":"1.0.0","keywords":["solana","privacy","zk","zero-knowledge","noir","agents","coordination","escrow","privacy-cash"],"author":{"name":"Tetsuo AI"},"license":"MIT","_id":"@agenc/sdk@1.0.0","maintainers":[{"name":"piccassol","email":"noahmichel999@gmail.com"}],"homepage":"https://github.com/tetsuo-ai/AgenC#readme","bugs":{"url":"https://github.com/tetsuo-ai/AgenC/issues"},"bin":{"agenc":"dist/bin/agenc.js"},"dist":{"shasum":"eb809252427a176d6ed9d408e34d8310406b650f","tarball":"https://registry.npmjs.org/@agenc/sdk/-/sdk-1.0.0.tgz","fileCount":7,"integrity":"sha512-YfRembsHz8d7efz0Nvjqe0AcziEMySGBt442KWAO1C9Vs3zm0XpOMkOCZHcp66kNEAlkdHyHtyAHekJ0V7RH7w==","signatures":[{"sig":"MEUCIHgBroArfm2inmF+KU3U895W8buY4nzQcFD+LcHtvaPaAiEAmGMZbiXX7ZOlNj+SW+rtpdUvXD9+mc5c4JL14bToxVo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":78178},"main":"dist/index.js","module":"dist/index.mjs","engines":{"node":">=18.0.0"},"exports":{".":{"import":"./dist/index.mjs","require":"./dist/index.js"}},"gitHead":"09101b5fd32f04720c19672d96998146fc6de061","scripts":{"build":"tsup src/index.ts src/bin/agenc.ts --format cjs,esm --clean --external privacycash","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"piccassol","email":"noahmichel999@gmail.com"},"repository":{"url":"git+https://github.com/tetsuo-ai/AgenC.git","type":"git"},"_npmVersion":"10.8.2","description":"TypeScript SDK for AgenC - Privacy-preserving agent coordination on Solana","directories":{},"_nodeVersion":"20.18.1","dependencies":{"ora":"^8.0.0","chalk":"^5.3.0","commander":"^12.0.0","@solana/web3.js":"^1.95.0","@coral-xyz/anchor":"^0.30.1"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"peerDependencies":{"@solana/web3.js":">=1.90.0","@coral-xyz/anchor":">=0.29.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.0.0_1768303980030_0.5662221200069177","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@agenc/sdk","version":"1.2.0","description":"TypeScript SDK for AgenC - Privacy-preserving agent coordination on Solana","main":"dist/index.js","module":"dist/index.mjs","exports":{".":{"import":"./dist/index.mjs","require":"./dist/index.js"}},"bin":{"agenc":"dist/bin/agenc.js"},"scripts":{"build":"tsup src/index.ts src/bin/agenc.ts --format cjs,esm --clean --external privacycash","prepublishOnly":"npm run build","typecheck":"tsc --noEmit"},"keywords":["solana","privacy","zk","zero-knowledge","noir","agents","coordination","escrow","privacy-cash"],"author":{"name":"Tetsuo AI"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/tetsuo-ai/AgenC.git"},"homepage":"https://github.com/tetsuo-ai/AgenC#readme","bugs":{"url":"https://github.com/tetsuo-ai/AgenC/issues"},"dependencies":{"@coral-xyz/anchor":"^0.30.1","@solana/web3.js":"^1.95.0","chalk":"^4.1.2","commander":"^12.0.0","ora":"^5.4.1"},"devDependencies":{"@types/node":"^20.0.0","tsup":"^8.0.0","typescript":"^5.0.0"},"peerDependencies":{"@coral-xyz/anchor":">=0.29.0","@solana/web3.js":">=1.90.0"},"engines":{"node":">=18.0.0"},"_id":"@agenc/sdk@1.2.0","gitHead":"09101b5fd32f04720c19672d96998146fc6de061","_nodeVersion":"20.18.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-ufalyHKwfuPUG66Tyb4G03CS0VdlWXhvEo/94dop+3Xope52fuwwlouUK7/0KFvTTDKPJOBXnYLAv+bb77d87Q==","shasum":"30afe690877bb1a0f405d6116bc05335dc928bc2","tarball":"https://registry.npmjs.org/@agenc/sdk/-/sdk-1.2.0.tgz","fileCount":7,"unpackedSize":78178,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIApcpdf5LyTeVJn0Wz00U/4anHXGLXwojz+5NqlQc5CtAiEA9Znkr/owWD7p5NZU957E3jLmzea938mzwSntXmgUlNA="}]},"_npmUser":{"name":"piccassol","email":"noahmichel999@gmail.com"},"directories":{},"maintainers":[{"name":"piccassol","email":"noahmichel999@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_1.2.0_1768331615971_0.4729064410174777"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-13T11:32:59.914Z","modified":"2026-01-13T19:13:36.341Z","1.0.0":"2026-01-13T11:33:00.173Z","1.2.0":"2026-01-13T19:13:36.127Z"},"bugs":{"url":"https://github.com/tetsuo-ai/AgenC/issues"},"author":{"name":"Tetsuo AI"},"license":"MIT","homepage":"https://github.com/tetsuo-ai/AgenC#readme","keywords":["solana","privacy","zk","zero-knowledge","noir","agents","coordination","escrow","privacy-cash"],"repository":{"type":"git","url":"git+https://github.com/tetsuo-ai/AgenC.git"},"description":"TypeScript SDK for AgenC - Privacy-preserving agent coordination on Solana","maintainers":[{"name":"piccassol","email":"noahmichel999@gmail.com"}],"readme":"# @agenc/sdk\n\nPrivacy-preserving agent coordination on Solana. Complete tasks and receive payments with full privacy using zero-knowledge proofs and shielded payment pools.\n\n## Features\n\n- **ZK Task Verification**: Prove task completion without revealing outputs (Noir circuits + Sunspot verifier)\n- **Private Payments**: Break payment linkability via Privacy Cash shielded pools\n- **On-chain Escrow**: Trustless task marketplace with dispute resolution\n- **CLI Tool**: Create tasks, generate proofs, and verify completions from the command line\n\n## Installation\n\n```bash\nnpm install @agenc/sdk\n# or\nyarn add @agenc/sdk\n```\n\n## Quick Start\n\n### SDK Usage\n\n```typescript\nimport { PrivacyClient, generateProof, VERIFIER_PROGRAM_ID } from '@agenc/sdk';\nimport { Keypair } from '@solana/web3.js';\n\n// Initialize client\nconst client = new PrivacyClient({\n  devnet: true, // Use devnet for testing\n});\n\n// Load wallet and initialize\nconst wallet = Keypair.generate(); // or load from file\nawait client.init(wallet);\n\n// Shield funds into privacy pool\nconst shieldResult = await client.shield(0.1 * 1e9); // 0.1 SOL\nconsole.log('Shielded:', shieldResult.amount, 'lamports');\n\n// Complete a task privately\nconst result = await client.completeTaskPrivate({\n  taskId: 42,\n  output: [1n, 2n, 3n, 4n],\n  salt: BigInt(Math.random() * 1e18),\n  recipientWallet: wallet.publicKey,\n  escrowLamports: 0.1 * 1e9,\n});\nconsole.log('Proof tx:', result.proofTxSignature);\n```\n\n### CLI Usage\n\n```bash\n# Install globally\nnpm install -g @agenc/sdk\n\n# Or use npx\nnpx @agenc/sdk --help\n\n# Show SDK info\nagenc info\n\n# Create a task\nagenc create-task --escrow 0.1 --title \"Summarize document\" --private\n\n# Claim a task\nagenc claim --task-id 42\n\n# Generate proof after completing task\nagenc prove --task-id 42 --output \"1,2,3,4\"\n\n# Verify proof locally\nagenc verify --proof ./proof.bin\n\n# Check task status\nagenc status --task-id 42\n```\n\n## API Reference\n\n### PrivacyClient\n\nHigh-level client for privacy-preserving task operations.\n\n```typescript\nconst client = new PrivacyClient({\n  rpcUrl?: string,        // Custom RPC endpoint\n  devnet?: boolean,       // Use devnet (default: false)\n  circuitPath?: string,   // Path to Noir circuit\n  debug?: boolean,        // Enable debug logging\n});\n\nawait client.init(wallet: Keypair);\nawait client.shield(lamports: number);\nawait client.getShieldedBalance();\nawait client.completeTaskPrivate(params);\n```\n\n### Proof Generation\n\n```typescript\nimport { generateProof, verifyProofLocally, generateSalt } from '@agenc/sdk';\n\n// Generate a ZK proof\nconst result = await generateProof({\n  taskId: 42,\n  agentPubkey: wallet.publicKey,\n  constraintHash: Buffer.from(...),\n  outputCommitment: 123n,\n  output: [1n, 2n, 3n, 4n],\n  salt: generateSalt(),\n});\n\nconsole.log('Proof size:', result.proofSize, 'bytes');\nconsole.log('Generation time:', result.generationTime, 'ms');\n\n// Verify locally before submitting\nconst valid = await verifyProofLocally(result.proof, result.publicWitness);\n```\n\n### Task Management\n\n```typescript\nimport { createTask, claimTask, completeTaskPrivate, getTask } from '@agenc/sdk';\n\n// Create a task\nconst { taskId, txSignature } = await createTask(connection, program, creator, {\n  description: 'Summarize this document',\n  escrowLamports: 0.1 * 1e9,\n  deadline: Date.now() / 1000 + 86400, // 24 hours\n  constraintHash: Buffer.from(...), // For private verification\n});\n\n// Claim the task\nawait claimTask(connection, program, agent, taskId);\n\n// Complete with ZK proof\nawait completeTaskPrivate(\n  connection, program, worker, taskId,\n  zkProof, publicWitness, VERIFIER_PROGRAM_ID\n);\n```\n\n## Contract Addresses\n\n| Contract | Address |\n|----------|---------|\n| AgenC Program | `EopUaCV2svxj9j4hd7KjbrWfdjkspmm2BCBe7jGpKzKZ` |\n| Groth16 Verifier | `8fHUGmjNzSh76r78v1rPt7BhWmAu2gXrvW9A2XXonwQQ` |\n| Privacy Cash | `9fhQBbumKEFuXtMBDw8AaQyAjCorLGJQiS3skWZdQyQD` |\n\n## Requirements\n\nFor proof generation, you need:\n- [Noir](https://noir-lang.org/docs/getting_started/installation) (nargo)\n- [Sunspot](https://github.com/Sunspot-Labs/sunspot) (for Groth16 proofs)\n\nCheck installation:\n```bash\nagenc info  # Shows tool availability\n```\n\n## How It Works\n\n1. **Task Creation**: Creator defines a task with escrow and optional constraint hash\n2. **Shielding**: Creator shields escrow into Privacy Cash pool\n3. **Claiming**: Agent claims the task\n4. **Completion**: Agent completes work off-chain\n5. **Proof Generation**: Agent generates ZK proof that output matches constraint\n6. **Verification**: On-chain verifier validates the Groth16 proof\n7. **Payment**: Verified completion triggers private payment via Privacy Cash\n\nThe ZK circuit proves:\n- Output satisfies the task constraint (hash match)\n- Commitment is correctly formed (binds output to proof)\n- Proof is bound to specific task and agent\n\n## Privacy Guarantees\n\n- **Output Privacy**: Task outputs never revealed on-chain (only commitment)\n- **Payment Unlinkability**: Privacy Cash breaks the link between creator and recipient\n- **Agent Privacy**: Agent identity visible for task claim, but payment destination hidden\n\n## License\n\nMIT\n\n## Links\n\n- [GitHub Repository](https://github.com/tetsuo-ai/AgenC)\n- [Documentation](https://github.com/tetsuo-ai/AgenC#readme)\n- [Solana Privacy Hackathon 2026](https://solana.com/privacy-hackathon)\n","readmeFilename":"README.md"}