npm - @q00bs/agent-sdk - Versions diffs - 1.2.1 → 1.4.0 - Mend

@q00bs/agent-sdk 1.2.1 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/dist/index.js CHANGED Viewed

@@ -21,17 +21,18 @@
  *
  * ARCHITECTURE:
  *   Q00bsAgent (this file's default export)
- *     ├── TrustResolver   — trust-path queries
- *     ├── EscrowManager   — agent-to-agent payments
- *     ├── ConsensusManager — multi-agent voting
- *     ├── AgentDiscovery  — find peer agents
- *     └── ERC8004Manager  — cross-platform identity & reputation
+ *     ├── TrustResolver      — trust-path queries
+ *     ├── EscrowManager      — agent-to-agent payments
+ *     ├── ConsensusManager   — multi-agent voting
+ *     ├── AgentDiscovery     — find peer agents
+ *     ├── ERC8004Manager     — cross-platform identity & reputation
+ *     └── MarketingManager   — agent-to-agent marketing (campaigns, bids, referrals)
  *
  * All sub-modules are also exported for advanced use cases.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONSENSUS_MODULE_ABI = exports.AGENT_ESCROW_ABI = exports.AGENT_REGISTRY_ABI = exports.THE_Q00BS_ABI = exports.Q00B_FACTORY_ABI = exports.ERC8004_NAMESPACE = exports.ERC8004_VALIDATION_REGISTRY_ADDRESS = exports.ERC8004_REPUTATION_REGISTRY_ADDRESS = exports.ERC8004_IDENTITY_REGISTRY_ADDRESS = exports.DEFAULT_MAX_HOPS = exports.PROTOCOL_FEE_BPS = exports.TRUST_DECAY_PER_HOP_PERCENT = exports.MAX_TRUST_SCORE = exports.CONSENSUS_MODULE_ADDRESS = exports.AGENT_ESCROW_ADDRESS = exports.AGENT_REGISTRY_ADDRESS = exports.GENESIS_Q00B_ADDRESS = exports.Q00B_FACTORY_ADDRESS = exports.DEFAULT_RPC_URL = exports.BASE_CHAIN_ID = exports.ERC8004NotConfiguredError = exports.ERC8004RegistryError = exports.ERC8004SelfFeedbackError = exports.ERC8004IdentityNotFoundError = exports.ERC8004Error = exports.PrivyApiError = exports.PrivyPolicyViolationError = exports.PrivyWalletError = exports.ContractCallError = exports.AgentInactiveError = exports.ConsensusRejectedError = exports.ConsensusTimeoutError = exports.EscrowStateError = exports.SpendLimitExceededError = exports.InsufficientTrustError = exports.TrustPathNotFoundError = exports.AgentNotRegisteredError = exports.Q00bsError = exports.ConsensusState = exports.EscrowState = exports.ERC8004Manager = exports.PrivyWalletManager = exports.createLogger = exports.createPrivyClients = exports.createClients = exports.AgentDiscovery = exports.ConsensusManager = exports.EscrowManager = exports.TrustResolver = exports.Q00bsAgent = void 0;
-exports.ERC8004_VALIDATION_ABI = exports.ERC8004_REPUTATION_ABI = exports.ERC8004_IDENTITY_ABI = void 0;
+exports.AGENT_ESCROW_ABI = exports.AGENT_REGISTRY_ABI = exports.THE_Q00BS_ABI = exports.Q00B_FACTORY_ABI = exports.ERC8004_NAMESPACE = exports.ERC8004_VALIDATION_REGISTRY_ADDRESS = exports.ERC8004_REPUTATION_REGISTRY_ADDRESS = exports.ERC8004_IDENTITY_REGISTRY_ADDRESS = exports.DEFAULT_MAX_HOPS = exports.PROTOCOL_FEE_BPS = exports.TRUST_DECAY_PER_HOP_PERCENT = exports.MAX_TRUST_SCORE = exports.CONSENSUS_MODULE_ADDRESS = exports.AGENT_ESCROW_ADDRESS = exports.AGENT_REGISTRY_ADDRESS = exports.GENESIS_Q00B_ADDRESS = exports.Q00B_FACTORY_ADDRESS = exports.DEFAULT_RPC_URL = exports.BASE_CHAIN_ID = exports.ERC8004NotConfiguredError = exports.ERC8004RegistryError = exports.ERC8004SelfFeedbackError = exports.ERC8004IdentityNotFoundError = exports.ERC8004Error = exports.PrivyApiError = exports.PrivyPolicyViolationError = exports.PrivyWalletError = exports.ContractCallError = exports.AgentInactiveError = exports.ConsensusRejectedError = exports.ConsensusTimeoutError = exports.EscrowStateError = exports.SpendLimitExceededError = exports.InsufficientTrustError = exports.TrustPathNotFoundError = exports.AgentNotRegisteredError = exports.Q00bsError = exports.ConsensusState = exports.EscrowState = exports.MarketingManager = exports.ERC8004Manager = exports.PrivyWalletManager = exports.createLogger = exports.createPrivyClients = exports.createClients = exports.AgentDiscovery = exports.ConsensusManager = exports.EscrowManager = exports.TrustResolver = exports.Q00bsAgent = void 0;
+exports.ERC8004_VALIDATION_ABI = exports.ERC8004_REPUTATION_ABI = exports.ERC8004_IDENTITY_ABI = exports.CONSENSUS_MODULE_ABI = void 0;
 // ── Main class ────────────────────────────────────────────────
 var Q00bsAgent_1 = require("./Q00bsAgent");
 Object.defineProperty(exports, "Q00bsAgent", { enumerable: true, get: function () { return Q00bsAgent_1.Q00bsAgent; } });
@@ -55,6 +56,9 @@ Object.defineProperty(exports, "PrivyWalletManager", { enumerable: true, get: fu
 // ── ERC-8004 Trustless Agents ─────────────────────────────────
 var erc8004_1 = require("./erc8004");
 Object.defineProperty(exports, "ERC8004Manager", { enumerable: true, get: function () { return erc8004_1.ERC8004Manager; } });
+// ── Agent-to-Agent Marketing ─────────────────────────────────
+var marketing_1 = require("./marketing");
+Object.defineProperty(exports, "MarketingManager", { enumerable: true, get: function () { return marketing_1.MarketingManager; } });
 var types_1 = require("./types");
 Object.defineProperty(exports, "EscrowState", { enumerable: true, get: function () { return types_1.EscrowState; } });
 Object.defineProperty(exports, "ConsensusState", { enumerable: true, get: function () { return types_1.ConsensusState; } });

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG~~;;;;AAEH,iEAAiE;AACjE,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AAEnB,iEAAiE;AACjE,iCAAwC;AAA/B,sGAAA,aAAa,OAAA;AACtB,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AACtB,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA;AACzB,yCAA6C;AAApC,2GAAA,cAAc,OAAA;AAEvB,iEAAiE;AACjE,mCAA2E;AAAlE,uGAAA,aAAa,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAAE,sGAAA,YAAY,OAAA;AAGxD,gEAAgE;AAChE,iCAA6C;AAApC,2GAAA,kBAAkB,OAAA;AAE3B,iEAAiE;AACjE,qCAA2C;AAAlC,yGAAA,cAAc,OAAA;~~AA0CvB~~,iCAAsD;AAA7C,oGAAA,WAAW,OAAA;AAAE,uGAAA,cAAc,OAAA;AAEpC,iEAAiE;AACjE,mCAqBkB;AApBhB,oGAAA,UAAU,OAAA;AACV,iHAAA,uBAAuB,OAAA;AACvB,gHAAA,sBAAsB,OAAA;AACtB,gHAAA,sBAAsB,OAAA;AACtB,iHAAA,uBAAuB,OAAA;AACvB,0GAAA,gBAAgB,OAAA;AAChB,+GAAA,qBAAqB,OAAA;AACrB,gHAAA,sBAAsB,OAAA;AACtB,4GAAA,kBAAkB,OAAA;AAClB,2GAAA,iBAAiB,OAAA;AACjB,eAAe;AACf,0GAAA,gBAAgB,OAAA;AAChB,mHAAA,yBAAyB,OAAA;AACzB,uGAAA,aAAa,OAAA;AACb,kBAAkB;AAClB,sGAAA,YAAY,OAAA;AACZ,sHAAA,4BAA4B,OAAA;AAC5B,kHAAA,wBAAwB,OAAA;AACxB,8GAAA,oBAAoB,OAAA;AACpB,mHAAA,yBAAyB,OAAA;AAG3B,iEAAiE;AACjE,yCAiBqB;AAhBnB,0GAAA,aAAa,OAAA;AACb,4GAAA,eAAe,OAAA;AACf,iHAAA,oBAAoB,OAAA;AACpB,iHAAA,oBAAoB,OAAA;AACpB,mHAAA,sBAAsB,OAAA;AACtB,iHAAA,oBAAoB,OAAA;AACpB,qHAAA,wBAAwB,OAAA;AACxB,4GAAA,eAAe,OAAA;AACf,wHAAA,2BAA2B,OAAA;AAC3B,6GAAA,gBAAgB,OAAA;AAChB,6GAAA,gBAAgB,OAAA;AAChB,qBAAqB;AACrB,8HAAA,iCAAiC,OAAA;AACjC,gIAAA,mCAAmC,OAAA;AACnC,gIAAA,mCAAmC,OAAA;AACnC,8GAAA,iBAAiB,OAAA;AAGnB,iEAAiE;AACjE,kDAAsD;AAA7C,+GAAA,gBAAgB,OAAA;AACzB,4CAAgD;AAAvC,yGAAA,aAAa,OAAA;AACtB,sDAA0D;AAAjD,mHAAA,kBAAkB,OAAA;AAC3B,kDAAsD;AAA7C,+GAAA,gBAAgB,OAAA;AACzB,0DAA8D;AAArD,uHAAA,oBAAoB,OAAA;AAE7B,iEAAiE;AACjE,0DAA8D;AAArD,uHAAA,oBAAoB,OAAA;AAC7B,8DAAkE;AAAzD,2HAAA,sBAAsB,OAAA;AAC/B,8DAAkE;AAAzD,2HAAA,sBAAsB,OAAA"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;;;AAEH,iEAAiE;AACjE,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AAEnB,iEAAiE;AACjE,iCAAwC;AAA/B,sGAAA,aAAa,OAAA;AACtB,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AACtB,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA;AACzB,yCAA6C;AAApC,2GAAA,cAAc,OAAA;AAEvB,iEAAiE;AACjE,mCAA2E;AAAlE,uGAAA,aAAa,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAAE,sGAAA,YAAY,OAAA;AAGxD,gEAAgE;AAChE,iCAA6C;AAApC,2GAAA,kBAAkB,OAAA;AAE3B,iEAAiE;AACjE,qCAA2C;AAAlC,yGAAA,cAAc,OAAA;AAEvB,gEAAgE;AAChE,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA;AA0DzB,iCAAsD;AAA7C,oGAAA,WAAW,OAAA;AAAE,uGAAA,cAAc,OAAA;AAEpC,iEAAiE;AACjE,mCAqBkB;AApBhB,oGAAA,UAAU,OAAA;AACV,iHAAA,uBAAuB,OAAA;AACvB,gHAAA,sBAAsB,OAAA;AACtB,gHAAA,sBAAsB,OAAA;AACtB,iHAAA,uBAAuB,OAAA;AACvB,0GAAA,gBAAgB,OAAA;AAChB,+GAAA,qBAAqB,OAAA;AACrB,gHAAA,sBAAsB,OAAA;AACtB,4GAAA,kBAAkB,OAAA;AAClB,2GAAA,iBAAiB,OAAA;AACjB,eAAe;AACf,0GAAA,gBAAgB,OAAA;AAChB,mHAAA,yBAAyB,OAAA;AACzB,uGAAA,aAAa,OAAA;AACb,kBAAkB;AAClB,sGAAA,YAAY,OAAA;AACZ,sHAAA,4BAA4B,OAAA;AAC5B,kHAAA,wBAAwB,OAAA;AACxB,8GAAA,oBAAoB,OAAA;AACpB,mHAAA,yBAAyB,OAAA;AAG3B,iEAAiE;AACjE,yCAiBqB;AAhBnB,0GAAA,aAAa,OAAA;AACb,4GAAA,eAAe,OAAA;AACf,iHAAA,oBAAoB,OAAA;AACpB,iHAAA,oBAAoB,OAAA;AACpB,mHAAA,sBAAsB,OAAA;AACtB,iHAAA,oBAAoB,OAAA;AACpB,qHAAA,wBAAwB,OAAA;AACxB,4GAAA,eAAe,OAAA;AACf,wHAAA,2BAA2B,OAAA;AAC3B,6GAAA,gBAAgB,OAAA;AAChB,6GAAA,gBAAgB,OAAA;AAChB,qBAAqB;AACrB,8HAAA,iCAAiC,OAAA;AACjC,gIAAA,mCAAmC,OAAA;AACnC,gIAAA,mCAAmC,OAAA;AACnC,8GAAA,iBAAiB,OAAA;AAGnB,iEAAiE;AACjE,kDAAsD;AAA7C,+GAAA,gBAAgB,OAAA;AACzB,4CAAgD;AAAvC,yGAAA,aAAa,OAAA;AACtB,sDAA0D;AAAjD,mHAAA,kBAAkB,OAAA;AAC3B,kDAAsD;AAA7C,+GAAA,gBAAgB,OAAA;AACzB,0DAA8D;AAArD,uHAAA,oBAAoB,OAAA;AAE7B,iEAAiE;AACjE,0DAA8D;AAArD,uHAAA,oBAAoB,OAAA;AAC7B,8DAAkE;AAAzD,2HAAA,sBAAsB,OAAA;AAC/B,8DAAkE;AAAzD,2HAAA,sBAAsB,OAAA"}

package/dist/marketing.d.ts ADDED Viewed

@@ -0,0 +1,254 @@
+/**
+ * @q00bs/agent-sdk — MarketingManager
+ *
+ * Agent-to-agent marketing module for the Q00bs trust network.
+ * Manages campaigns (service listings), bids (priority discovery),
+ * and referrals (agent introductions) — all trust-verified.
+ *
+ * WHAT THIS MODULE DOES:
+ *   - Creates marketing campaigns for agent services
+ *   - Places bids for priority placement in discovery results
+ *   - Creates and tracks referrals between agents
+ *   - Queries campaign analytics and referral earnings
+ *   - Discovers services with trust-weighted + bid-boosted ranking
+ *
+ * TRUST INTEGRATION:
+ *   - Only registered agents can create campaigns/bids
+ *   - Bid weight = bidAmount × (trustScore / 10000) — spam can't outbid trust
+ *   - Referrals require trust path between referrer and referred agent
+ *   - Campaign visibility gated by trust floor
+ *
+ * REVENUE:
+ *   - 2% protocol fee on campaign impression spend
+ *   - 2% protocol fee on bid spend
+ *   - 2% protocol fee on referral commissions (10% of escrow)
+ */
+import type { PublicClient, Chain, Transport } from 'viem';
+import type { Logger } from './types';
+export interface CampaignRecord {
+    id: number;
+    agentId: number;
+    capability: string;
+    capabilityHash: string;
+    description: string;
+    pricePerTask: string;
+    dailyBudget: string;
+    totalBudget: string;
+    spent: string;
+    impressions: number;
+    conversions: number;
+    trustFloor: number;
+    active: boolean;
+    createdAt: number;
+    roi: number;
+}
+export interface CreateCampaignParams {
+    capability: string;
+    description: string;
+    pricePerTask: string;
+    dailyBudget: string;
+    totalBudget: string;
+    trustFloor?: number;
+}
+export interface BidRecord {
+    id: number;
+    agentId: number;
+    capabilitySlot: string;
+    bidPerImpression: string;
+    maxDaily: string;
+    totalDeposit: string;
+    totalSpent: string;
+    active: boolean;
+    effectiveWeight: number;
+    createdAt: number;
+}
+export interface PlaceBidParams {
+    capabilitySlot: string;
+    bidPerImpression: string;
+    maxDaily: string;
+}
+export interface ReferralRecord {
+    id: number;
+    referrerAgentId: number;
+    referredAgentId: number;
+    clientAgentId: number;
+    escrowId: number | null;
+    escrowValue: string;
+    commission: string;
+    settled: boolean;
+    createdAt: number;
+}
+export interface CreateReferralParams {
+    referredAgentId: number;
+    clientAgentId: number;
+    reason?: string;
+}
+export interface ReferralEarnings {
+    total: string;
+    active: number;
+    settled: number;
+    referrals: ReferralRecord[];
+}
+export interface CampaignStats {
+    campaignId: number;
+    impressions: number;
+    conversions: number;
+    spent: string;
+    revenue: string;
+    roi: number;
+    conversionRate: number;
+}
+export interface DiscoverServicesParams {
+    capability?: string;
+    minTrust?: number;
+    maxPrice?: string;
+    sortBy?: 'trust_weighted' | 'price' | 'reputation' | 'conversions';
+    limit?: number;
+}
+export interface DiscoveredService {
+    campaignId: number;
+    agentId: number;
+    capability: string;
+    description: string;
+    pricePerTask: string;
+    trustScore: number;
+    erc8004Rating: number;
+    ratingCount: number;
+    conversions: number;
+    effectiveTrust: number;
+    isBidBoosted: boolean;
+}
+export interface MarketRates {
+    capability: string;
+    avgPrice: string;
+    minPrice: string;
+    maxPrice: string;
+    providerCount: number;
+    avgTrustScore: number;
+}
+export declare class MarketingManager {
+    private publicClient;
+    private logger;
+    private trustApiUrl?;
+    private walletId?;
+    constructor(publicClient: PublicClient<Transport, Chain>, logger: Logger, trustApiUrl?: string, walletId?: string);
+    /**
+     * Create a marketing campaign for your agent's services.
+     *
+     * @param agentId - Your registered agent ID.
+     * @param params - Campaign parameters.
+     * @returns The new campaign ID.
+     *
+     * @example
+     * ```ts
+     * const campaignId = await marketing.createCampaign(myAgentId, {
+     *   capability: 'data_analysis',
+     *   description: 'Enterprise-grade dataset analysis',
+     *   pricePerTask: '0.01',
+     *   dailyBudget: '0.1',
+     *   totalBudget: '1.0',
+     *   trustFloor: 40,
+     * });
+     * ```
+     */
+    createCampaign(agentId: number, params: CreateCampaignParams): Promise<number>;
+    /**
+     * Get campaign details by ID.
+     */
+    getCampaign(campaignId: number): Promise<CampaignRecord>;
+    /**
+     * Get detailed analytics for a campaign.
+     */
+    getCampaignStats(campaignId: number): Promise<CampaignStats>;
+    /**
+     * Pause an active campaign.
+     */
+    pauseCampaign(campaignId: number): Promise<void>;
+    /**
+     * Resume a paused campaign.
+     */
+    resumeCampaign(campaignId: number): Promise<void>;
+    /**
+     * Add more budget to an existing campaign.
+     */
+    fundCampaign(campaignId: number, amountEth: string): Promise<void>;
+    /**
+     * List all campaigns for an agent.
+     */
+    listMyCampaigns(agentId: number): Promise<CampaignRecord[]>;
+    /**
+     * Place a bid for priority placement in discovery results.
+     * Effective weight = bidAmount × (trustScore / 10000) — trust beats money.
+     *
+     * @param agentId - Your registered agent ID.
+     * @param params - Bid parameters.
+     * @returns The new bid ID.
+     */
+    placeBid(agentId: number, params: PlaceBidParams): Promise<number>;
+    /**
+     * Cancel a bid and reclaim remaining escrowed funds.
+     */
+    cancelBid(bidId: number): Promise<string>;
+    /**
+     * Get current bid status and position.
+     */
+    getBidStatus(bidId: number): Promise<BidRecord>;
+    /**
+     * List available bid slots and current top bidders for a capability.
+     */
+    listBidSlots(capability: string): Promise<BidRecord[]>;
+    /**
+     * Create a referral — recommend another agent to a potential client.
+     * Earns 10% commission on the resulting escrow (minus 2% protocol fee).
+     * Requires a trust path between you and the referred agent.
+     *
+     * @param agentId - Your registered agent ID (the referrer).
+     * @param params - Referral parameters.
+     * @returns The new referral ID.
+     */
+    createReferral(agentId: number, params: CreateReferralParams): Promise<number>;
+    /**
+     * Get referral details.
+     */
+    getReferral(referralId: number): Promise<ReferralRecord>;
+    /**
+     * Get total referral earnings for an agent.
+     */
+    getReferralEarnings(agentId: number): Promise<ReferralEarnings>;
+    /**
+     * List all referrals for an agent (as referrer).
+     */
+    listMyReferrals(agentId: number): Promise<ReferralRecord[]>;
+    /**
+     * Discover agent services with trust-weighted + bid-boosted ranking.
+     * Results are ranked by: (trustScore × reputationBonus) + bidWeight.
+     *
+     * @param fromAgentId - Your agent ID (for trust path calculation).
+     * @param params - Discovery filters.
+     * @returns Ranked list of available services.
+     */
+    discoverServices(fromAgentId: number, params?: DiscoverServicesParams): Promise<DiscoveredService[]>;
+    /**
+     * Get average market rates for a capability across the network.
+     */
+    getMarketRates(capability: string): Promise<MarketRates>;
+    /**
+     * Compare multiple agents side-by-side (trust, reputation, price).
+     */
+    compareAgents(fromAgentId: number, targetAgentIds: number[]): Promise<DiscoveredService[]>;
+    /**
+     * Get network-wide marketing analytics.
+     */
+    getNetworkAnalytics(): Promise<{
+        totalCampaigns: number;
+        activeCampaigns: number;
+        totalImpressions: number;
+        totalConversions: number;
+        totalMktVolume: string;
+        totalReferralsPaid: string;
+        protocolRevenue: string;
+    }>;
+    private apiCall;
+    private handleResponse;
+}
+//# sourceMappingURL=marketing.d.ts.map

package/dist/marketing.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"marketing.d.ts","sourceRoot":"","sources":["../src/marketing.ts"],"names":[],"mappings":"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"}

package/dist/marketing.js ADDED Viewed

@@ -0,0 +1,366 @@
+"use strict";
+/**
+ * @q00bs/agent-sdk — MarketingManager
+ *
+ * Agent-to-agent marketing module for the Q00bs trust network.
+ * Manages campaigns (service listings), bids (priority discovery),
+ * and referrals (agent introductions) — all trust-verified.
+ *
+ * WHAT THIS MODULE DOES:
+ *   - Creates marketing campaigns for agent services
+ *   - Places bids for priority placement in discovery results
+ *   - Creates and tracks referrals between agents
+ *   - Queries campaign analytics and referral earnings
+ *   - Discovers services with trust-weighted + bid-boosted ranking
+ *
+ * TRUST INTEGRATION:
+ *   - Only registered agents can create campaigns/bids
+ *   - Bid weight = bidAmount × (trustScore / 10000) — spam can't outbid trust
+ *   - Referrals require trust path between referrer and referred agent
+ *   - Campaign visibility gated by trust floor
+ *
+ * REVENUE:
+ *   - 2% protocol fee on campaign impression spend
+ *   - 2% protocol fee on bid spend
+ *   - 2% protocol fee on referral commissions (10% of escrow)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarketingManager = void 0;
+const viem_1 = require("viem");
+// ─────────────────────────────────────────────────────────────
+// MARKETING MANAGER
+// ─────────────────────────────────────────────────────────────
+class MarketingManager {
+    publicClient;
+    logger;
+    trustApiUrl;
+    walletId;
+    constructor(publicClient, logger, trustApiUrl, walletId) {
+        this.publicClient = publicClient;
+        this.logger = logger;
+        this.trustApiUrl = trustApiUrl;
+        this.walletId = walletId;
+    }
+    // ─────────────────────────────────────────────────────────────
+    // CAMPAIGNS
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Create a marketing campaign for your agent's services.
+     *
+     * @param agentId - Your registered agent ID.
+     * @param params - Campaign parameters.
+     * @returns The new campaign ID.
+     *
+     * @example
+     * ```ts
+     * const campaignId = await marketing.createCampaign(myAgentId, {
+     *   capability: 'data_analysis',
+     *   description: 'Enterprise-grade dataset analysis',
+     *   pricePerTask: '0.01',
+     *   dailyBudget: '0.1',
+     *   totalBudget: '1.0',
+     *   trustFloor: 40,
+     * });
+     * ```
+     */
+    async createCampaign(agentId, params) {
+        this.logger.info(`Creating campaign for agent #${agentId}: ${params.capability}`);
+        if (this.trustApiUrl) {
+            const result = await this.apiCall('POST', '/api/v1/mkt/campaigns', {
+                agentId,
+                walletId: this.walletId,
+                capability: params.capability,
+                description: params.description,
+                pricePerTask: params.pricePerTask,
+                dailyBudget: params.dailyBudget,
+                totalBudget: params.totalBudget,
+                trustFloor: params.trustFloor || 0,
+            });
+            this.logger.info(`Campaign #${result.campaignId} created`);
+            return result.campaignId;
+        }
+        throw new Error('Campaign creation requires trustApiUrl');
+    }
+    /**
+     * Get campaign details by ID.
+     */
+    async getCampaign(campaignId) {
+        if (this.trustApiUrl) {
+            return this.apiCall('GET', `/api/v1/mkt/campaigns/${campaignId}`);
+        }
+        throw new Error('getCampaign requires trustApiUrl');
+    }
+    /**
+     * Get detailed analytics for a campaign.
+     */
+    async getCampaignStats(campaignId) {
+        if (this.trustApiUrl) {
+            return this.apiCall('GET', `/api/v1/mkt/campaigns/${campaignId}/stats`);
+        }
+        throw new Error('getCampaignStats requires trustApiUrl');
+    }
+    /**
+     * Pause an active campaign.
+     */
+    async pauseCampaign(campaignId) {
+        this.logger.info(`Pausing campaign #${campaignId}`);
+        if (this.trustApiUrl) {
+            await this.apiCall('PUT', `/api/v1/mkt/campaigns/${campaignId}/pause`, {
+                walletId: this.walletId,
+            });
+            return;
+        }
+        throw new Error('pauseCampaign requires trustApiUrl');
+    }
+    /**
+     * Resume a paused campaign.
+     */
+    async resumeCampaign(campaignId) {
+        this.logger.info(`Resuming campaign #${campaignId}`);
+        if (this.trustApiUrl) {
+            await this.apiCall('PUT', `/api/v1/mkt/campaigns/${campaignId}/resume`, {
+                walletId: this.walletId,
+            });
+            return;
+        }
+        throw new Error('resumeCampaign requires trustApiUrl');
+    }
+    /**
+     * Add more budget to an existing campaign.
+     */
+    async fundCampaign(campaignId, amountEth) {
+        this.logger.info(`Funding campaign #${campaignId} with ${amountEth} ETH`);
+        if (this.trustApiUrl) {
+            await this.apiCall('POST', `/api/v1/mkt/campaigns/${campaignId}/fund`, {
+                walletId: this.walletId,
+                amount: amountEth,
+            });
+            return;
+        }
+        throw new Error('fundCampaign requires trustApiUrl');
+    }
+    /**
+     * List all campaigns for an agent.
+     */
+    async listMyCampaigns(agentId) {
+        if (this.trustApiUrl) {
+            return this.apiCall('GET', `/api/v1/mkt/campaigns/agent/${agentId}`);
+        }
+        throw new Error('listMyCampaigns requires trustApiUrl');
+    }
+    // ─────────────────────────────────────────────────────────────
+    // BIDS
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Place a bid for priority placement in discovery results.
+     * Effective weight = bidAmount × (trustScore / 10000) — trust beats money.
+     *
+     * @param agentId - Your registered agent ID.
+     * @param params - Bid parameters.
+     * @returns The new bid ID.
+     */
+    async placeBid(agentId, params) {
+        this.logger.info(`Placing bid for agent #${agentId} on slot: ${params.capabilitySlot}`);
+        if (this.trustApiUrl) {
+            const result = await this.apiCall('POST', '/api/v1/mkt/bids', {
+                agentId,
+                walletId: this.walletId,
+                capabilitySlot: params.capabilitySlot,
+                bidPerImpression: params.bidPerImpression,
+                maxDaily: params.maxDaily,
+            });
+            this.logger.info(`Bid #${result.bidId} placed (weight: ${result.effectiveWeight})`);
+            return result.bidId;
+        }
+        throw new Error('placeBid requires trustApiUrl');
+    }
+    /**
+     * Cancel a bid and reclaim remaining escrowed funds.
+     */
+    async cancelBid(bidId) {
+        this.logger.info(`Cancelling bid #${bidId}`);
+        if (this.trustApiUrl) {
+            const result = await this.apiCall('DELETE', `/api/v1/mkt/bids/${bidId}`, {
+                walletId: this.walletId,
+            });
+            this.logger.info(`Bid #${bidId} cancelled, refund: ${result.refundAmount} ETH`);
+            return result.refundAmount;
+        }
+        throw new Error('cancelBid requires trustApiUrl');
+    }
+    /**
+     * Get current bid status and position.
+     */
+    async getBidStatus(bidId) {
+        if (this.trustApiUrl) {
+            return this.apiCall('GET', `/api/v1/mkt/bids/${bidId}`);
+        }
+        throw new Error('getBidStatus requires trustApiUrl');
+    }
+    /**
+     * List available bid slots and current top bidders for a capability.
+     */
+    async listBidSlots(capability) {
+        if (this.trustApiUrl) {
+            const hash = (0, viem_1.keccak256)((0, viem_1.toHex)(capability));
+            return this.apiCall('GET', `/api/v1/mkt/bids/slots/${hash}`);
+        }
+        throw new Error('listBidSlots requires trustApiUrl');
+    }
+    // ─────────────────────────────────────────────────────────────
+    // REFERRALS
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Create a referral — recommend another agent to a potential client.
+     * Earns 10% commission on the resulting escrow (minus 2% protocol fee).
+     * Requires a trust path between you and the referred agent.
+     *
+     * @param agentId - Your registered agent ID (the referrer).
+     * @param params - Referral parameters.
+     * @returns The new referral ID.
+     */
+    async createReferral(agentId, params) {
+        this.logger.info(`Creating referral: agent #${agentId} refers agent #${params.referredAgentId} to agent #${params.clientAgentId}`);
+        if (this.trustApiUrl) {
+            const result = await this.apiCall('POST', '/api/v1/mkt/referrals', {
+                referrerAgentId: agentId,
+                walletId: this.walletId,
+                referredAgentId: params.referredAgentId,
+                clientAgentId: params.clientAgentId,
+                reason: params.reason,
+            });
+            this.logger.info(`Referral #${result.referralId} created`);
+            return result.referralId;
+        }
+        throw new Error('createReferral requires trustApiUrl');
+    }
+    /**
+     * Get referral details.
+     */
+    async getReferral(referralId) {
+        if (this.trustApiUrl) {
+            return this.apiCall('GET', `/api/v1/mkt/referrals/${referralId}`);
+        }
+        throw new Error('getReferral requires trustApiUrl');
+    }
+    /**
+     * Get total referral earnings for an agent.
+     */
+    async getReferralEarnings(agentId) {
+        if (this.trustApiUrl) {
+            return this.apiCall('GET', `/api/v1/mkt/referrals/agent/${agentId}/earnings`);
+        }
+        throw new Error('getReferralEarnings requires trustApiUrl');
+    }
+    /**
+     * List all referrals for an agent (as referrer).
+     */
+    async listMyReferrals(agentId) {
+        if (this.trustApiUrl) {
+            return this.apiCall('GET', `/api/v1/mkt/referrals/agent/${agentId}`);
+        }
+        throw new Error('listMyReferrals requires trustApiUrl');
+    }
+    // ─────────────────────────────────────────────────────────────
+    // DISCOVERY (Enhanced with MKT signals)
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Discover agent services with trust-weighted + bid-boosted ranking.
+     * Results are ranked by: (trustScore × reputationBonus) + bidWeight.
+     *
+     * @param fromAgentId - Your agent ID (for trust path calculation).
+     * @param params - Discovery filters.
+     * @returns Ranked list of available services.
+     */
+    async discoverServices(fromAgentId, params) {
+        if (this.trustApiUrl) {
+            return this.apiCall('GET', '/api/v1/mkt/discover', {
+                fromAgentId,
+                ...params,
+            });
+        }
+        throw new Error('discoverServices requires trustApiUrl');
+    }
+    /**
+     * Get average market rates for a capability across the network.
+     */
+    async getMarketRates(capability) {
+        if (this.trustApiUrl) {
+            return this.apiCall('GET', `/api/v1/mkt/rates/${encodeURIComponent(capability)}`);
+        }
+        throw new Error('getMarketRates requires trustApiUrl');
+    }
+    /**
+     * Compare multiple agents side-by-side (trust, reputation, price).
+     */
+    async compareAgents(fromAgentId, targetAgentIds) {
+        if (this.trustApiUrl) {
+            return this.apiCall('POST', '/api/v1/mkt/compare', {
+                fromAgentId,
+                targetAgentIds,
+            });
+        }
+        throw new Error('compareAgents requires trustApiUrl');
+    }
+    // ─────────────────────────────────────────────────────────────
+    // ANALYTICS
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Get network-wide marketing analytics.
+     */
+    async getNetworkAnalytics() {
+        if (this.trustApiUrl) {
+            return this.apiCall('GET', '/api/v1/mkt/analytics');
+        }
+        throw new Error('getNetworkAnalytics requires trustApiUrl');
+    }
+    // ─────────────────────────────────────────────────────────────
+    // INTERNAL
+    // ─────────────────────────────────────────────────────────────
+    async apiCall(method, path, body) {
+        const url = `${this.trustApiUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        this.logger.debug(`MKT API ${method} ${path}`);
+        const fetchOptions = {
+            method,
+            headers,
+        };
+        // For GET requests, append body as query params
+        if (method === 'GET' && body) {
+            const params = new URLSearchParams();
+            for (const [key, value] of Object.entries(body)) {
+                if (value !== undefined && value !== null) {
+                    if (Array.isArray(value)) {
+                        params.set(key, value.join(','));
+                    }
+                    else {
+                        params.set(key, String(value));
+                    }
+                }
+            }
+            const queryString = params.toString();
+            if (queryString) {
+                const separator = url.includes('?') ? '&' : '?';
+                const fullUrl = `${url}${separator}${queryString}`;
+                const response = await fetch(fullUrl, fetchOptions);
+                return this.handleResponse(response, path);
+            }
+        }
+        if (method !== 'GET' && body) {
+            fetchOptions.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, fetchOptions);
+        return this.handleResponse(response, path);
+    }
+    async handleResponse(response, path) {
+        const data = await response.json();
+        if (!response.ok) {
+            throw new Error(`MKT API error (${response.status}): ${data.message || data.error || JSON.stringify(data)}`);
+        }
+        return data;
+    }
+}
+exports.MarketingManager = MarketingManager;
+//# sourceMappingURL=marketing.js.map