paypol-sdk 1.0.0

package/dist/adapters/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/adapters/anthropic.ts"],"names":[],"mappings":"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"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PayPol SDK - Framework Adapters
+ *
+ * Adapters that convert PayPol agents into native tool definitions
+ * for popular AI frameworks.
+ *
+ * Usage:
+ *   import { toOpenAITools } from 'paypol-sdk/adapters/openai';
+ *   import { toAnthropicTools } from 'paypol-sdk/adapters/anthropic';
+ */
+export { toOpenAITools, handleOpenAIToolCall, getAgentCatalog as getOpenAICatalog, } from './openai';
+export type { OpenAITool, OpenAIToolCall, } from './openai';
+export { toAnthropicTools, handleAnthropicToolUse, getAgentCatalog as getAnthropicCatalog, } from './anthropic';
+export type { AnthropicTool, AnthropicToolUse, AnthropicToolResult, } from './anthropic';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,eAAe,IAAI,gBAAgB,GACpC,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,UAAU,EACV,cAAc,GACf,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,IAAI,mBAAmB,GACvC,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,aAAa,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * PayPol SDK - Framework Adapters
+ *
+ * Adapters that convert PayPol agents into native tool definitions
+ * for popular AI frameworks.
+ *
+ * Usage:
+ *   import { toOpenAITools } from 'paypol-sdk/adapters/openai';
+ *   import { toAnthropicTools } from 'paypol-sdk/adapters/anthropic';
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAnthropicCatalog = exports.handleAnthropicToolUse = exports.toAnthropicTools = exports.getOpenAICatalog = exports.handleOpenAIToolCall = exports.toOpenAITools = void 0;
+var openai_1 = require("./openai");
+Object.defineProperty(exports, "toOpenAITools", { enumerable: true, get: function () { return openai_1.toOpenAITools; } });
+Object.defineProperty(exports, "handleOpenAIToolCall", { enumerable: true, get: function () { return openai_1.handleOpenAIToolCall; } });
+Object.defineProperty(exports, "getOpenAICatalog", { enumerable: true, get: function () { return openai_1.getAgentCatalog; } });
+var anthropic_1 = require("./anthropic");
+Object.defineProperty(exports, "toAnthropicTools", { enumerable: true, get: function () { return anthropic_1.toAnthropicTools; } });
+Object.defineProperty(exports, "handleAnthropicToolUse", { enumerable: true, get: function () { return anthropic_1.handleAnthropicToolUse; } });
+Object.defineProperty(exports, "getAnthropicCatalog", { enumerable: true, get: function () { return anthropic_1.getAgentCatalog; } });
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,mCAIkB;AAHhB,uGAAA,aAAa,OAAA;AACb,8GAAA,oBAAoB,OAAA;AACpB,0GAAA,eAAe,OAAoB;AAQrC,yCAIqB;AAHnB,6GAAA,gBAAgB,OAAA;AAChB,mHAAA,sBAAsB,OAAA;AACtB,gHAAA,eAAe,OAAuB"}

package/dist/adapters/openai.d.ts

@@ -0,0 +1,77 @@
+/**
+ * OpenAI Function-Calling Adapter for PayPol Agents
+ *
+ * Converts PayPol marketplace agents into OpenAI function-calling tools.
+ * Works with the OpenAI Chat Completions API (GPT-4, GPT-3.5-turbo, etc.)
+ *
+ * @example
+ * ```typescript
+ * import { AgentClient } from 'paypol-sdk';
+ * import { toOpenAITools, handleOpenAIToolCall } from 'paypol-sdk/adapters/openai';
+ *
+ * const client = new AgentClient('https://paypol.xyz');
+ * const tools = await toOpenAITools(client);
+ *
+ * const response = await openai.chat.completions.create({
+ *   model: 'gpt-4',
+ *   messages: [{ role: 'user', content: 'Audit this Solidity contract' }],
+ *   tools,
+ * });
+ *
+ * // Handle tool call
+ * const toolCall = response.choices[0].message.tool_calls?.[0];
+ * if (toolCall) {
+ *   const result = await handleOpenAIToolCall(client, toolCall, '0xMyWallet');
+ * }
+ * ```
+ */
+import { AgentClient } from '../AgentClient';
+export interface OpenAITool {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: 'object';
+            properties: Record<string, {
+                type: string;
+                description: string;
+            }>;
+            required: string[];
+        };
+    };
+}
+export interface OpenAIToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/**
+ * Convert PayPol agents to OpenAI function-calling tools.
+ *
+ * @param client  AgentClient instance (used for dynamic agent list)
+ * @param agentIds  Optional filter - only include these agent IDs
+ */
+export declare function toOpenAITools(client?: AgentClient, agentIds?: string[]): Promise<OpenAITool[]>;
+/**
+ * Handle an OpenAI tool call by dispatching it to the correct PayPol agent.
+ *
+ * @param client       AgentClient instance
+ * @param toolCall     The tool call from OpenAI's response
+ * @param callerWallet Wallet address of the caller
+ * @returns            JSON string of the agent's result
+ */
+export declare function handleOpenAIToolCall(client: AgentClient, toolCall: OpenAIToolCall, callerWallet: string): Promise<string>;
+/**
+ * Get the static agent catalog (no API call needed).
+ */
+export declare function getAgentCatalog(): {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+}[];
+//# sourceMappingURL=openai.d.ts.map

package/dist/adapters/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/adapters/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAI7C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ,CAAC;YACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,WAAW,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YAClE,QAAQ,EAAE,MAAM,EAAE,CAAC;SACpB,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAyCD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CA8CvB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED;;GAEG;AACH,wBAAgB,eAAe;QAvIJ,MAAM;UAAQ,MAAM;iBAAe,MAAM;cAAY,MAAM;IAyIrF"}

package/dist/adapters/openai.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * OpenAI Function-Calling Adapter for PayPol Agents
+ *
+ * Converts PayPol marketplace agents into OpenAI function-calling tools.
+ * Works with the OpenAI Chat Completions API (GPT-4, GPT-3.5-turbo, etc.)
+ *
+ * @example
+ * ```typescript
+ * import { AgentClient } from 'paypol-sdk';
+ * import { toOpenAITools, handleOpenAIToolCall } from 'paypol-sdk/adapters/openai';
+ *
+ * const client = new AgentClient('https://paypol.xyz');
+ * const tools = await toOpenAITools(client);
+ *
+ * const response = await openai.chat.completions.create({
+ *   model: 'gpt-4',
+ *   messages: [{ role: 'user', content: 'Audit this Solidity contract' }],
+ *   tools,
+ * });
+ *
+ * // Handle tool call
+ * const toolCall = response.choices[0].message.tool_calls?.[0];
+ * if (toolCall) {
+ *   const result = await handleOpenAIToolCall(client, toolCall, '0xMyWallet');
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toOpenAITools = toOpenAITools;
+exports.handleOpenAIToolCall = handleOpenAIToolCall;
+exports.getAgentCatalog = getAgentCatalog;
+// ── Agent Catalog ────────────────────────────────────────
+const AGENT_CATALOG = [
+    { id: 'contract-auditor', name: 'Contract Auditor', description: 'Audit Solidity smart contracts for vulnerabilities and security issues', category: 'security' },
+    { id: 'yield-optimizer', name: 'Yield Optimizer', description: 'Analyze and optimize DeFi yield farming strategies', category: 'defi' },
+    { id: 'payroll-planner', name: 'Payroll Planner', description: 'Plan and execute crypto payroll distributions', category: 'payroll' },
+    { id: 'gas-predictor', name: 'Gas Predictor', description: 'Predict gas costs and optimal transaction timing', category: 'analytics' },
+    { id: 'arbitrage-scanner', name: 'Arbitrage Scanner', description: 'Scan for cross-DEX arbitrage opportunities', category: 'defi' },
+    { id: 'compliance-advisor', name: 'Compliance Advisor', description: 'Provide regulatory compliance analysis for crypto operations', category: 'compliance' },
+    { id: 'nft-forensics', name: 'NFT Forensics', description: 'Analyze NFT provenance and detect fraud patterns', category: 'security' },
+    { id: 'bridge-analyzer', name: 'Bridge Analyzer', description: 'Analyze cross-chain bridge security and efficiency', category: 'security' },
+    { id: 'dao-advisor', name: 'DAO Advisor', description: 'Provide governance analysis and proposal recommendations', category: 'analytics' },
+    { id: 'risk-analyzer', name: 'Risk Analyzer', description: 'Assess portfolio risk and provide mitigation strategies', category: 'analytics' },
+    { id: 'crypto-tax-navigator', name: 'Crypto Tax Navigator', description: 'Navigate crypto tax regulations and optimize reporting', category: 'compliance' },
+    { id: 'portfolio-rebalancer', name: 'Portfolio Rebalancer', description: 'Rebalance crypto portfolio based on market conditions', category: 'defi' },
+    { id: 'token-deployer', name: 'Token Deployer', description: 'Deploy ERC20 tokens with custom parameters on Tempo L1', category: 'deployment' },
+    { id: 'airdrop-tracker', name: 'Airdrop Tracker', description: 'Track and claim eligible airdrops for a wallet', category: 'analytics' },
+    { id: 'mev-sentinel', name: 'MEV Sentinel', description: 'Monitor and protect against MEV attacks', category: 'security' },
+    { id: 'liquidity-manager', name: 'Liquidity Manager', description: 'Manage LP positions and optimize liquidity provisioning', category: 'defi' },
+    { id: 'whale-tracker', name: 'Whale Tracker', description: 'Track large wallet movements and whale activity', category: 'analytics' },
+    { id: 'social-radar', name: 'Social Radar', description: 'Monitor social media sentiment for crypto assets', category: 'analytics' },
+    { id: 'omnibridge-router', name: 'OmniBridge Router', description: 'Find optimal cross-chain bridging routes', category: 'defi' },
+    { id: 'nft-appraiser', name: 'NFT Appraiser', description: 'Appraise NFT value based on market data', category: 'analytics' },
+    { id: 'proposal-writer', name: 'Proposal Writer', description: 'Draft governance proposals for DAOs', category: 'analytics' },
+    { id: 'vesting-planner', name: 'Vesting Planner', description: 'Plan and manage token vesting schedules', category: 'payroll' },
+    { id: 'defi-insurance', name: 'DeFi Insurance', description: 'Analyze DeFi insurance options and coverage', category: 'defi' },
+    { id: 'contract-deploy-pro', name: 'Contract Deploy Pro', description: 'Deploy and verify smart contracts on Tempo L1', category: 'deployment' },
+    { id: 'escrow-guardian', name: 'Escrow Guardian', description: 'Create and manage escrow transactions on NexusV2', category: 'escrow' },
+    { id: 'shield-master', name: 'Shield Master', description: 'Execute ZK-shielded private payments via ShieldVaultV2', category: 'privacy' },
+    { id: 'multisend-pro', name: 'Multisend Pro', description: 'Batch send payments to multiple recipients via MultisendV2', category: 'payments' },
+    { id: 'stream-architect', name: 'Stream Architect', description: 'Create and manage milestone-based payment streams', category: 'streams' },
+    { id: 'proof-verifier', name: 'Proof Verifier', description: 'Verify AI execution proofs on-chain via AIProofRegistry', category: 'verification' },
+    { id: 'agent-coordinator', name: 'Agent Coordinator', description: 'Orchestrate multi-agent A2A workflows', category: 'orchestration' },
+    { id: 'payroll-autopilot', name: 'Payroll Autopilot', description: 'Set up recurring automated payroll with conditional rules', category: 'payroll' },
+    { id: 'admin-dashboard', name: 'Admin Dashboard', description: 'Monitor protocol health, TVL, and agent performance', category: 'admin' },
+];
+// ── Converters ───────────────────────────────────────────
+/**
+ * Convert PayPol agents to OpenAI function-calling tools.
+ *
+ * @param client  AgentClient instance (used for dynamic agent list)
+ * @param agentIds  Optional filter - only include these agent IDs
+ */
+async function toOpenAITools(client, agentIds) {
+    let agents = AGENT_CATALOG;
+    // If client provided, try to fetch live agent list
+    if (client) {
+        try {
+            const live = await client.listAgents();
+            if (live.length > 0) {
+                agents = live.map(a => ({
+                    id: a.id,
+                    name: a.name,
+                    description: a.description,
+                    category: a.category,
+                }));
+            }
+        }
+        catch {
+            // Fall back to static catalog
+        }
+    }
+    // Filter if specific IDs requested
+    if (agentIds) {
+        agents = agents.filter(a => agentIds.includes(a.id));
+    }
+    return agents.map(agent => ({
+        type: 'function',
+        function: {
+            name: `paypol_${agent.id.replace(/-/g, '_')}`,
+            description: `[PayPol Agent] ${agent.name}: ${agent.description}`,
+            parameters: {
+                type: 'object',
+                properties: {
+                    prompt: {
+                        type: 'string',
+                        description: `Task instruction for ${agent.name}`,
+                    },
+                    payload: {
+                        type: 'string',
+                        description: 'Optional JSON payload with additional data (e.g. contract source code)',
+                    },
+                },
+                required: ['prompt'],
+            },
+        },
+    }));
+}
+/**
+ * Handle an OpenAI tool call by dispatching it to the correct PayPol agent.
+ *
+ * @param client       AgentClient instance
+ * @param toolCall     The tool call from OpenAI's response
+ * @param callerWallet Wallet address of the caller
+ * @returns            JSON string of the agent's result
+ */
+async function handleOpenAIToolCall(client, toolCall, callerWallet) {
+    const fnName = toolCall.function.name;
+    const agentId = fnName.replace('paypol_', '').replace(/_/g, '-');
+    let args;
+    try {
+        args = JSON.parse(toolCall.function.arguments);
+    }
+    catch {
+        return JSON.stringify({ error: 'Invalid tool call arguments' });
+    }
+    try {
+        const result = await client.hire(agentId, args.prompt, callerWallet, {
+            payload: args.payload ? JSON.parse(args.payload) : undefined,
+        });
+        return JSON.stringify(result);
+    }
+    catch (err) {
+        return JSON.stringify({ error: err.message || 'Agent execution failed' });
+    }
+}
+/**
+ * Get the static agent catalog (no API call needed).
+ */
+function getAgentCatalog() {
+    return [...AGENT_CATALOG];
+}
+//# sourceMappingURL=openai.js.map

package/dist/adapters/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/adapters/openai.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * PayPol Agent SDK
+ *
+ * Two main building blocks:
+ *   1. PayPolAgentClient  - dispatch payroll payments via the PayPol API
+ *   2. PayPolAgent        - build marketplace agents that earn on every job
+ *   3. AgentClient        - hire agents from the marketplace
+ *
+ * @example - send a shielded payment
+ *   const client = new PayPolAgentClient({ apiKey: '...', workspaceId: '...' });
+ *   await client.dispatchShieldedPayload({ recipientName: 'Alice', walletAddress: '0x...', amount: 100 });
+ *
+ * @example - build a marketplace agent
+ *   const agent = new PayPolAgent({ id: 'my-agent', name: 'My Agent', ... });
+ *   agent.onJob(async (job) => ({ ...job, status: 'success', result: {}, executionTimeMs: 0, timestamp: Date.now() }));
+ *   agent.listen(3002);
+ *
+ * @example - hire an agent
+ *   const market = new AgentClient('http://localhost:3001');
+ *   const result = await market.hire('contract-auditor', 'Audit this Solidity file...', '0x...');
+ */
+export interface PayPolConfig {
+    apiKey: string;
+    workspaceId: string;
+    environment?: 'mainnet' | 'testnet';
+}
+export interface PayloadParams {
+    recipientName: string;
+    walletAddress: string;
+    amount: number;
+    token?: string;
+    reference?: string;
+}
+/** Low-level client for dispatching PayPol payroll payments. */
+export declare class PayPolAgentClient {
+    private apiKey;
+    private workspaceId;
+    private baseURL;
+    constructor(config: PayPolConfig);
+    private request;
+    /** Dispatch a public (non-private) payment. */
+    dispatchPublicPayload(params: PayloadParams): Promise<any>;
+    /**
+     * Dispatch a ZK-shielded payment.
+     * Proof generation is handled server-side - callers do not need snarkjs.
+     */
+    dispatchShieldedPayload(params: PayloadParams): Promise<any>;
+    /** Poll payment status. Returns: 'Awaiting_Boardroom' | 'Vaulted' | 'Settled' */
+    getPayloadStatus(payloadId: string): Promise<any>;
+}
+export { PayPolAgent } from './PayPolAgent';
+export { AgentClient } from './AgentClient';
+export { registerAgent } from './register';
+export type { AgentManifest, AgentCategory, AgentConfig, JobRequest, JobResult, HireOptions, AgentRegistrationPayload, AgentRegistrationResponse, EscrowParams, ReputationScore, } from './types';
+export type { APS1Manifest, APS1Category, APS1Pricing, APS1PaymentMethod, APS1TokenConfig, APS1Endpoints, APS1ExecutionEnvelope, APS1Result, APS1Transaction, APS1Settlement, APS1NegotiationMessage, APS1EscrowParams, APS1Milestone, } from '@paypol-protocol/aps-1';
+export { APS1_VERSION, APS1_CHAIN_ID, APS1_NETWORK, APS1_PLATFORM_FEE_BPS, APS1_DEFAULT_TOKENS, APS1_CONTRACTS, } from '@paypol-protocol/aps-1';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,gEAAgE;AAChE,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,YAAY;YAQlB,OAAO;IAcrB,+CAA+C;IACzC,qBAAqB,CAAC,MAAM,EAAE,aAAa;IAIjD;;;OAGG;IACG,uBAAuB,CAAC,MAAM,EAAE,aAAa;IAInD,iFAAiF;IAC3E,gBAAgB,CAAC,SAAS,EAAE,MAAM;CAM3C;AAID,OAAO,EAAE,WAAW,EAAE,MAAO,eAAe,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAO,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EACR,aAAa,EACb,aAAa,EACb,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACZ,eAAe,GAClB,MAAM,SAAS,CAAC;AAOjB,YAAY,EACR,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,UAAU,EACV,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,GAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACH,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACjB,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * PayPol Agent SDK
+ *
+ * Two main building blocks:
+ *   1. PayPolAgentClient  - dispatch payroll payments via the PayPol API
+ *   2. PayPolAgent        - build marketplace agents that earn on every job
+ *   3. AgentClient        - hire agents from the marketplace
+ *
+ * @example - send a shielded payment
+ *   const client = new PayPolAgentClient({ apiKey: '...', workspaceId: '...' });
+ *   await client.dispatchShieldedPayload({ recipientName: 'Alice', walletAddress: '0x...', amount: 100 });
+ *
+ * @example - build a marketplace agent
+ *   const agent = new PayPolAgent({ id: 'my-agent', name: 'My Agent', ... });
+ *   agent.onJob(async (job) => ({ ...job, status: 'success', result: {}, executionTimeMs: 0, timestamp: Date.now() }));
+ *   agent.listen(3002);
+ *
+ * @example - hire an agent
+ *   const market = new AgentClient('http://localhost:3001');
+ *   const result = await market.hire('contract-auditor', 'Audit this Solidity file...', '0x...');
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APS1_CONTRACTS = exports.APS1_DEFAULT_TOKENS = exports.APS1_PLATFORM_FEE_BPS = exports.APS1_NETWORK = exports.APS1_CHAIN_ID = exports.APS1_VERSION = exports.registerAgent = exports.AgentClient = exports.PayPolAgent = exports.PayPolAgentClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+/** Low-level client for dispatching PayPol payroll payments. */
+class PayPolAgentClient {
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.workspaceId = config.workspaceId;
+        this.baseURL = config.environment === 'mainnet'
+            ? 'https://api.paypol.xyz/v1'
+            : 'https://testnet.api.paypol.xyz/v1';
+    }
+    async request(endpoint, data) {
+        try {
+            const response = await axios_1.default.post(`${this.baseURL}${endpoint}`, data, {
+                headers: {
+                    'Authorization': `Bearer ${this.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw new Error(`PayPol API Error: ${error.response?.data?.message ?? error.message}`);
+        }
+    }
+    /** Dispatch a public (non-private) payment. */
+    async dispatchPublicPayload(params) {
+        return this.request('/payload/dispatch', { ...params, workspaceId: this.workspaceId, isShielded: false });
+    }
+    /**
+     * Dispatch a ZK-shielded payment.
+     * Proof generation is handled server-side - callers do not need snarkjs.
+     */
+    async dispatchShieldedPayload(params) {
+        return this.request('/payload/dispatch', { ...params, workspaceId: this.workspaceId, isShielded: true });
+    }
+    /** Poll payment status. Returns: 'Awaiting_Boardroom' | 'Vaulted' | 'Settled' */
+    async getPayloadStatus(payloadId) {
+        const response = await axios_1.default.get(`${this.baseURL}/payload/${payloadId}`, {
+            headers: { 'Authorization': `Bearer ${this.apiKey}` },
+        });
+        return response.data;
+    }
+}
+exports.PayPolAgentClient = PayPolAgentClient;
+// ── Agent Marketplace SDK ─────────────────────────────────
+var PayPolAgent_1 = require("./PayPolAgent");
+Object.defineProperty(exports, "PayPolAgent", { enumerable: true, get: function () { return PayPolAgent_1.PayPolAgent; } });
+var AgentClient_1 = require("./AgentClient");
+Object.defineProperty(exports, "AgentClient", { enumerable: true, get: function () { return AgentClient_1.AgentClient; } });
+var register_1 = require("./register");
+Object.defineProperty(exports, "registerAgent", { enumerable: true, get: function () { return register_1.registerAgent; } });
+var aps_1_1 = require("@paypol-protocol/aps-1");
+Object.defineProperty(exports, "APS1_VERSION", { enumerable: true, get: function () { return aps_1_1.APS1_VERSION; } });
+Object.defineProperty(exports, "APS1_CHAIN_ID", { enumerable: true, get: function () { return aps_1_1.APS1_CHAIN_ID; } });
+Object.defineProperty(exports, "APS1_NETWORK", { enumerable: true, get: function () { return aps_1_1.APS1_NETWORK; } });
+Object.defineProperty(exports, "APS1_PLATFORM_FEE_BPS", { enumerable: true, get: function () { return aps_1_1.APS1_PLATFORM_FEE_BPS; } });
+Object.defineProperty(exports, "APS1_DEFAULT_TOKENS", { enumerable: true, get: function () { return aps_1_1.APS1_DEFAULT_TOKENS; } });
+Object.defineProperty(exports, "APS1_CONTRACTS", { enumerable: true, get: function () { return aps_1_1.APS1_CONTRACTS; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;AAEH,kDAA0B;AAkB1B,gEAAgE;AAChE,MAAa,iBAAiB;IAK1B,YAAY,MAAoB;QAC5B,IAAI,CAAC,MAAM,GAAQ,MAAM,CAAC,MAAM,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,OAAO,GAAO,MAAM,CAAC,WAAW,KAAK,SAAS;YAC/C,CAAC,CAAC,2BAA2B;YAC7B,CAAC,CAAC,mCAAmC,CAAC;IAC9C,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,IAAa;QACjD,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,EAAE,IAAI,EAAE;gBAClE,OAAO,EAAE;oBACL,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;oBACxC,cAAc,EAAG,kBAAkB;iBACtC;aACJ,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,IAAI,CAAC;QACzB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3F,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,qBAAqB,CAAC,MAAqB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9G,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,uBAAuB,CAAC,MAAqB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7G,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,gBAAgB,CAAC,SAAiB;QACpC,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,YAAY,SAAS,EAAE,EAAE;YACrE,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE,EAAE;SACxD,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;CACJ;AA/CD,8CA+CC;AAED,6DAA6D;AAE7D,6CAA6C;AAApC,0GAAA,WAAW,OAAA;AACpB,6CAA6C;AAApC,0GAAA,WAAW,OAAA;AACpB,uCAA2C;AAAlC,yGAAA,aAAa,OAAA;AAmCtB,gDAOgC;AAN5B,qGAAA,YAAY,OAAA;AACZ,sGAAA,aAAa,OAAA;AACb,qGAAA,YAAY,OAAA;AACZ,8GAAA,qBAAqB,OAAA;AACrB,4GAAA,mBAAmB,OAAA;AACnB,uGAAA,cAAc,OAAA"}

package/dist/register.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Agent Self-Registration - register a community agent on the PayPol marketplace.
+ *
+ * Usage:
+ *   import { registerAgent } from 'paypol-sdk';
+ *   await registerAgent({
+ *     id: 'my-agent',
+ *     name: 'My Agent',
+ *     webhookUrl: 'https://my-server.com',
+ *     ...
+ *   });
+ */
+import { AgentRegistrationPayload, AgentRegistrationResponse } from './types';
+/**
+ * Register a community agent on the PayPol marketplace.
+ *
+ * @param payload  Agent metadata + webhook URL
+ * @param marketplaceUrl  Optional override for the marketplace base URL
+ * @returns Registration confirmation with marketplace ID
+ */
+export declare function registerAgent(payload: AgentRegistrationPayload, marketplaceUrl?: string): Promise<AgentRegistrationResponse>;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAI9E;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,wBAAwB,EACjC,cAAc,GAAE,MAAgC,GAC/C,OAAO,CAAC,yBAAyB,CAAC,CA6BpC"}

package/dist/register.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Agent Self-Registration - register a community agent on the PayPol marketplace.
+ *
+ * Usage:
+ *   import { registerAgent } from 'paypol-sdk';
+ *   await registerAgent({
+ *     id: 'my-agent',
+ *     name: 'My Agent',
+ *     webhookUrl: 'https://my-server.com',
+ *     ...
+ *   });
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAgent = registerAgent;
+const axios_1 = __importDefault(require("axios"));
+const DEFAULT_MARKETPLACE_URL = process.env.PAYPOL_MARKETPLACE_URL ?? 'http://localhost:3000';
+/**
+ * Register a community agent on the PayPol marketplace.
+ *
+ * @param payload  Agent metadata + webhook URL
+ * @param marketplaceUrl  Optional override for the marketplace base URL
+ * @returns Registration confirmation with marketplace ID
+ */
+async function registerAgent(payload, marketplaceUrl = DEFAULT_MARKETPLACE_URL) {
+    // Validate required fields
+    if (!payload.id || !/^[a-z0-9-]+$/.test(payload.id)) {
+        throw new Error('Agent ID must be lowercase alphanumeric with hyphens (e.g. "my-agent")');
+    }
+    if (!payload.webhookUrl) {
+        throw new Error('webhookUrl is required - the marketplace needs to reach your agent');
+    }
+    if (!payload.ownerWallet || !payload.ownerWallet.startsWith('0x')) {
+        throw new Error('ownerWallet must be a valid 0x address');
+    }
+    // Validate webhook is reachable
+    try {
+        const healthCheck = await axios_1.default.get(`${payload.webhookUrl}/health`, { timeout: 5000 });
+        if (healthCheck.data?.status !== 'ok') {
+            console.warn(`[register] Warning: ${payload.webhookUrl}/health did not return { status: 'ok' }`);
+        }
+    }
+    catch {
+        console.warn(`[register] Warning: Could not reach ${payload.webhookUrl}/health - make sure your agent is running`);
+    }
+    const res = await axios_1.default.post(`${marketplaceUrl}/api/marketplace/register`, payload, { timeout: 10000 });
+    return res.data;
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;AAcH,sCAgCC;AA5CD,kDAA0B;AAG1B,MAAM,uBAAuB,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,uBAAuB,CAAC;AAE9F;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CACjC,OAAiC,EACjC,iBAAyB,uBAAuB;IAEhD,2BAA2B;IAC3B,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,gCAAgC;IAChC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,eAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACvF,IAAI,WAAW,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,uBAAuB,OAAO,CAAC,UAAU,yCAAyC,CAAC,CAAC;QACnG,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,IAAI,CAAC,uCAAuC,OAAO,CAAC,UAAU,2CAA2C,CAAC,CAAC;IACrH,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,eAAK,CAAC,IAAI,CAC1B,GAAG,cAAc,2BAA2B,EAC5C,OAAO,EACP,EAAE,OAAO,EAAE,KAAK,EAAE,CACnB,CAAC;IAEF,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC"}