@profullstack/coinpay 0.4.15 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profullstack/coinpay",
-  "version": "0.4.15",
+  "version": "0.5.0",
   "description": "CoinPay SDK & CLI — Accept cryptocurrency payments (BTC, ETH, SOL, POL, BCH, USDC) with wallet and swap support",
   "type": "module",
   "main": "./src/index.js",

package/src/index.d.ts

@@ -96,5 +96,21 @@ export type {
   SwapHistoryResult,
 } from './swap.js';
 
+// Reputation exports
+export {
+  submitReceipt,
+  getReputation,
+  getCredential,
+  verifyCredential,
+  getRevocationList,
+} from './reputation.js';
+export type {
+  TaskReceipt,
+  ReputationSummary,
+  MultiWindowReputation,
+  CredentialVerification,
+  RevocationList,
+} from './reputation.js';
+
 import { CoinPayClient } from './client.js';
 export default CoinPayClient;

package/src/index.js

@@ -78,6 +78,14 @@ import {
 } from './wallet.js';
 
 // Swap exports
+import {
+  submitReceipt,
+  getReputation,
+  getCredential,
+  verifyCredential,
+  getRevocationList,
+} from './reputation.js';
+
 import {
   SwapClient,
   SwapCoins,
@@ -134,6 +142,13 @@ export {
   PaymentStatus,
   FiatCurrency,
   
+  // Reputation
+  submitReceipt,
+  getReputation,
+  getCredential,
+  verifyCredential,
+  getRevocationList,
+  
   // Webhook utilities
   verifyWebhookSignature,
   generateWebhookSignature,

package/src/reputation.d.ts

@@ -0,0 +1,69 @@
+import { CoinPayClient } from './client';
+
+export interface TaskReceipt {
+  receipt_id: string;
+  task_id: string;
+  agent_did: string;
+  buyer_did: string;
+  platform_did: string;
+  escrow_tx?: string;
+  amount: number;
+  currency: string;
+  category?: string;
+  sla?: Record<string, unknown>;
+  outcome: 'completed' | 'failed' | 'disputed' | 'cancelled';
+  dispute?: boolean;
+  artifact_hash?: string;
+  signatures: {
+    agent?: string;
+    buyer?: string;
+    platform?: string;
+  };
+  finalized_at?: string;
+}
+
+export interface ReputationSummary {
+  agent_did: string;
+  total_tasks: number;
+  completed: number;
+  failed: number;
+  disputed: number;
+  cancelled: number;
+  completion_rate: number;
+  dispute_rate: number;
+  total_volume: number;
+  avg_task_value: number;
+  unique_buyers: number;
+  categories: Record<string, { count: number; volume: number }>;
+  anti_gaming: {
+    circular_payment: boolean;
+    burst_detected: boolean;
+    below_economic_threshold: boolean;
+    insufficient_unique_buyers: boolean;
+    flagged: boolean;
+    details: string[];
+  };
+}
+
+export interface MultiWindowReputation {
+  '30d': ReputationSummary;
+  '90d': ReputationSummary;
+  all: ReputationSummary;
+}
+
+export interface CredentialVerification {
+  valid: boolean;
+  reason: string;
+  credential?: Record<string, unknown>;
+}
+
+export interface RevocationList {
+  revoked: string[];
+  details: Array<{ credential_id: string; reason: string; revoked_at: string }>;
+}
+
+export function submitReceipt(client: CoinPayClient, receipt: TaskReceipt): Promise<{ id: string; verified_signatures: string[] }>;
+export function getReputation(client: CoinPayClient, agentDid: string): Promise<MultiWindowReputation>;
+export function getCredential(client: CoinPayClient, credentialId: string): Promise<Record<string, unknown>>;
+export function verifyCredential(client: CoinPayClient, credentialId: string): Promise<CredentialVerification>;
+export function getRevocationList(client: CoinPayClient): Promise<RevocationList>;

package/src/reputation.js

@@ -0,0 +1,51 @@
+/**
+ * Reputation SDK Module
+ *
+ * Submit receipts, query reputation, verify credentials.
+ *
+ * @example
+ * import { CoinPayClient } from '@profullstack/coinpay';
+ * const client = new CoinPayClient({ apiKey: 'your-key' });
+ *
+ * // Submit a task receipt
+ * const result = await client.submitReceipt({ ... });
+ *
+ * // Get agent reputation
+ * const rep = await client.getReputation('did:web:agent.example.com');
+ */
+
+/**
+ * Submit a task receipt
+ */
+export async function submitReceipt(client, receipt) {
+  return client._request('POST', '/api/reputation/receipt', receipt);
+}
+
+/**
+ * Get aggregated reputation for an agent DID
+ */
+export async function getReputation(client, agentDid) {
+  const encoded = encodeURIComponent(agentDid);
+  return client._request('GET', `/api/reputation/agent/${encoded}/reputation`);
+}
+
+/**
+ * Get a specific credential by ID
+ */
+export async function getCredential(client, credentialId) {
+  return client._request('GET', `/api/reputation/credential/${credentialId}`);
+}
+
+/**
+ * Verify a credential
+ */
+export async function verifyCredential(client, credentialId) {
+  return client._request('POST', '/api/reputation/verify', { credential_id: credentialId });
+}
+
+/**
+ * Get the revocation list
+ */
+export async function getRevocationList(client) {
+  return client._request('GET', '/api/reputation/revocation-list');
+}