dpth 0.3.0 → 0.4.0

package/dist/experimental/economics.d.ts

@@ -0,0 +1,203 @@
+/**
+ * dpth.io Economics Engine
+ *
+ * The credit system that makes agents want to contribute.
+ * Every contribution earns credits, every query costs credits.
+ * Designed for future token migration without rebuilding.
+ *
+ * Core concepts:
+ * - Credits are minted on contribution (storage, compute, GPU)
+ * - Credits are burned on consumption (queries, inference)
+ * - Tier multipliers reward long-term contributors
+ * - Rate limits prevent abuse without killing free access
+ * - Migration snapshots enable future token claims
+ */
+export type CreditAction = 'earn' | 'spend' | 'bonus' | 'penalty' | 'transfer' | 'migration_snapshot';
+export type CreditCategory = 'storage' | 'compute' | 'gpu' | 'inference' | 'query' | 'training' | 'bonus' | 'penalty' | 'transfer' | 'system';
+export interface CreditTransaction {
+    id: string;
+    agentId: string;
+    action: CreditAction;
+    amount: number;
+    reason: string;
+    category: CreditCategory;
+    reference?: string;
+    balanceAfter: number;
+    timestamp: string;
+    /** For transfers: recipient agent */
+    toAgentId?: string;
+}
+export interface AgentBalance {
+    agentId: string;
+    balance: number;
+    totalEarned: number;
+    totalSpent: number;
+    earningsByCategory: Record<string, number>;
+    spendingByCategory: Record<string, number>;
+    transactionCount: number;
+    /** Claimable for future token migration */
+    claimableCredits: number;
+    /** Rate limit state */
+    rateLimit: RateLimitState;
+    /** Migration snapshot (if taken) */
+    migrationSnapshot?: {
+        balance: number;
+        timestamp: string;
+        snapshotId: string;
+    };
+    lastActivity: string;
+    createdAt: string;
+}
+export interface RateLimitState {
+    /** Queries remaining in current window */
+    queriesRemaining: number;
+    /** Inference requests remaining in current window */
+    inferenceRemaining: number;
+    /** Window reset time */
+    windowResetAt: string;
+    /** Current tier limits */
+    tier: string;
+}
+export interface CreditRates {
+    storagePerMbPerDay: number;
+    computePerTask: number;
+    gpuPerInferenceTask: number;
+    gpuPer1kTokens: number;
+    gpuPerImage: number;
+    storageProofBonus: number;
+    trainingRoundBonus: number;
+    queryBaseCost: number;
+    inferenceBaseCost: number;
+    /** Per 1k tokens for inference requests */
+    inferencePer1kTokens: number;
+    tierMultipliers: Record<string, number>;
+}
+export interface TierLimits {
+    /** Queries per hour */
+    queriesPerHour: number;
+    /** Inference requests per hour */
+    inferencePerHour: number;
+    /** Max single transaction */
+    maxTransactionSize: number;
+    /** Can participate in training */
+    canTrain: boolean;
+    /** Can transfer credits */
+    canTransfer: boolean;
+}
+export interface NetworkSupply {
+    totalMinted: number;
+    totalBurned: number;
+    totalCirculating: number;
+    totalTransactions: number;
+    /** Velocity: transactions in last 24h */
+    velocity24h: number;
+    /** Gini coefficient (0=equal, 1=concentrated) */
+    giniCoefficient: number;
+}
+export interface PricingSignal {
+    /** Current demand multiplier (>1 = high demand, <1 = low) */
+    demandMultiplier: number;
+    /** Network utilization (0-1) */
+    utilization: number;
+    /** Suggested query price */
+    queryPrice: number;
+    /** Suggested inference price */
+    inferencePrice: number;
+    timestamp: string;
+}
+export declare const DEFAULT_RATES: CreditRates;
+export declare const TIER_LIMITS: Record<string, TierLimits>;
+/**
+ * Earn credits for a contribution.
+ * Amount is multiplied by the agent's tier multiplier.
+ */
+export declare function earnCredits(agentId: string, amount: number, reason: string, category: CreditCategory, options?: {
+    reference?: string;
+    tier?: string;
+}): CreditTransaction;
+/**
+ * Spend credits for a service (query, inference, etc).
+ * Throws if insufficient balance.
+ */
+export declare function spendCredits(agentId: string, amount: number, reason: string, category: CreditCategory, options?: {
+    reference?: string;
+}): CreditTransaction;
+/**
+ * Transfer credits between agents.
+ * Requires trusted tier or above.
+ */
+export declare function transferCredits(fromAgentId: string, toAgentId: string, amount: number, reason: string, fromTier?: string): {
+    fromTx: CreditTransaction;
+    toTx: CreditTransaction;
+};
+/**
+ * Apply a penalty (bad behavior, failed proofs, etc).
+ */
+export declare function penalizeAgent(agentId: string, amount: number, reason: string, reference?: string): CreditTransaction;
+/**
+ * Check if an agent can perform an action under rate limits.
+ * Automatically resets windows and adjusts by tier.
+ */
+export declare function checkRateLimit(agentId: string, action: 'query' | 'inference', tier?: string): {
+    allowed: boolean;
+    remaining: number;
+    resetAt: string;
+};
+/**
+ * Calculate current pricing based on network conditions.
+ * High demand → higher prices → incentivizes more supply.
+ * Low demand → lower prices → encourages usage.
+ */
+export declare function getPricingSignal(): PricingSignal;
+/**
+ * Auto-calculate and award credits for a storage contribution.
+ */
+export declare function rewardStorage(agentId: string, megabytes: number, tier?: string): CreditTransaction;
+/**
+ * Auto-calculate and award credits for a compute task.
+ */
+export declare function rewardCompute(agentId: string, taskId: string, tier?: string): CreditTransaction;
+/**
+ * Auto-calculate and award credits for GPU inference.
+ */
+export declare function rewardGpuInference(agentId: string, tokensGenerated: number, taskId: string, tier?: string): CreditTransaction;
+/**
+ * Auto-calculate and award credits for a training round.
+ */
+export declare function rewardTraining(agentId: string, roundId: string, tier?: string): CreditTransaction;
+/**
+ * Charge for an inference request based on token count.
+ */
+export declare function chargeInference(agentId: string, tokensUsed: number, requestId: string): CreditTransaction;
+/**
+ * Create a migration snapshot of all balances.
+ * Used when transitioning from credits to tokens.
+ * Returns snapshot metadata.
+ */
+export declare function createMigrationSnapshot(): {
+    snapshotId: string;
+    timestamp: string;
+    agentsSnapshotted: number;
+    totalClaimable: number;
+};
+export declare function getBalance(agentId: string): AgentBalance | undefined;
+export declare function getSupply(): NetworkSupply;
+export declare function getLeaderboard(limit?: number, sortBy?: 'balance' | 'earned' | 'spent'): Array<{
+    rank: number;
+    agentId: string;
+    balance: number;
+    totalEarned: number;
+    totalSpent: number;
+}>;
+export declare function getTransactionHistory(agentId: string, limit?: number): CreditTransaction[];
+export declare function getRates(): CreditRates;
+export declare function updateRates(updates: Partial<CreditRates>): CreditRates;
+export declare function getTierLimits(tier: string): TierLimits;
+export declare function clearEconomics(): void;
+export declare class InsufficientCreditsError extends Error {
+    readonly agentId: string;
+    readonly balance: number;
+    readonly required: number;
+    constructor(agentId: string, balance: number, required: number);
+}
+//# sourceMappingURL=economics.d.ts.map

package/dist/experimental/economics.d.ts.map

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