@skillzmarket/sdk 0.1.0

package/dist/creator/types.d.ts

@@ -0,0 +1,173 @@
+import type { Hex } from 'viem';
+/**
+ * JSON Schema type for describing skill input/output
+ */
+export interface JsonSchema {
+    type: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    [key: string]: unknown;
+}
+/**
+ * Options for defining a skill
+ */
+export interface SkillOptions {
+    /**
+     * Price per call in human-friendly format.
+     * Examples: '$0.001', '0.005 USDC', '0.01'
+     */
+    price: string;
+    /**
+     * Description of what the skill does
+     */
+    description?: string;
+    /**
+     * Maximum timeout in milliseconds (default: 60000)
+     */
+    timeout?: number;
+    /**
+     * JSON Schema describing the expected input format
+     */
+    inputSchema?: JsonSchema;
+    /**
+     * JSON Schema describing the output format
+     */
+    outputSchema?: JsonSchema;
+}
+/**
+ * Parsed price information
+ */
+export interface ParsedPrice {
+    /** Amount as a decimal string (e.g., '0.001') */
+    amount: string;
+    /** Currency (currently only 'USDC' supported) */
+    currency: 'USDC';
+}
+/**
+ * Handler function for a skill
+ */
+export type SkillHandler<TInput = unknown, TOutput = unknown> = (input: TInput) => Promise<TOutput>;
+/**
+ * A defined skill ready to be served
+ */
+export interface SkillDefinition<TInput = unknown, TOutput = unknown> {
+    options: SkillOptions;
+    handler: SkillHandler<TInput, TOutput>;
+    parsedPrice: ParsedPrice;
+}
+/**
+ * Map of skill names to their definitions
+ * Uses `any` for type parameters to allow mixing skills with different input/output types
+ */
+export type SkillsMap = Record<string, SkillDefinition<any, any>>;
+/**
+ * Options for skill registration
+ */
+export interface RegistrationOptions {
+    /**
+     * API URL for the Skillz Market registry.
+     * Default: 'https://api.skillz.market'
+     */
+    apiUrl?: string;
+    /**
+     * Public endpoint URL where the skill server is accessible.
+     * This is required for registration.
+     */
+    endpoint: string;
+    /**
+     * Whether registration is enabled.
+     * Default: true
+     */
+    enabled?: boolean;
+    /**
+     * Error handling mode.
+     * - 'throw': Throw an error if registration fails
+     * - 'warn': Log a warning if registration fails (default)
+     * - 'silent': Silently ignore registration failures
+     */
+    onError?: 'throw' | 'warn' | 'silent';
+}
+/**
+ * Result of registering a skill
+ */
+export interface RegistrationResult {
+    /** Name of the skill */
+    name: string;
+    /** Whether registration was successful */
+    success: boolean;
+    /** Slug assigned by the registry (if successful) */
+    slug?: string;
+    /** Error message (if failed) */
+    error?: string;
+}
+/**
+ * Options for the serve function
+ */
+export interface ServeOptions {
+    /**
+     * Port to listen on (default: 3002)
+     */
+    port?: number;
+    /**
+     * Wallet private key for receiving payments.
+     * Falls back to SKILLZ_WALLET_KEY environment variable.
+     */
+    wallet?: Hex;
+    /**
+     * Network identifier for x402 payments.
+     * Default: 'eip155:8453' (Base mainnet)
+     */
+    network?: `${string}:${string}`;
+    /**
+     * Facilitator URL for x402.
+     * Default: 'https://x402.dexter.cash'
+     */
+    facilitatorUrl?: string;
+    /**
+     * App name shown in payment prompts.
+     * Default: 'Skillz Market Skill'
+     */
+    appName?: string;
+    /**
+     * Callback when a skill is called
+     */
+    onCall?: (skillName: string, input: unknown) => void;
+    /**
+     * Callback when an error occurs
+     */
+    onError?: (skillName: string, error: Error) => void;
+    /**
+     * Registration options for auto-registering skills with the Skillz Market registry.
+     * If provided, skills will be registered after the server starts.
+     */
+    register?: RegistrationOptions;
+    /**
+     * Whether to track skill calls to Skillz Market analytics.
+     * Default: true
+     */
+    trackCalls?: boolean;
+    /**
+     * API URL for analytics tracking.
+     * Default: 'https://api.skillz.market'
+     */
+    apiUrl?: string;
+}
+/**
+ * x402 protected route configuration
+ */
+export interface ProtectedRoute {
+    accepts: {
+        scheme: 'exact';
+        price: string;
+        network: `${string}:${string}`;
+        payTo: string;
+        maxTimeoutSeconds: number;
+    };
+    description: string;
+}
+/**
+ * Map of route patterns to their x402 configuration
+ */
+export type ProtectedRoutes = Record<`${string} ${string}`, ProtectedRoute>;
+//# sourceMappingURL=types.d.ts.map

package/dist/creator/types.d.ts.map

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

package/dist/creator/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/creator/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/creator/types.ts"],"names":[],"mappings":""}

package/dist/creator/utils/price.d.ts

@@ -0,0 +1,19 @@
+import type { ParsedPrice } from '../types.js';
+/**
+ * Parse a human-friendly price string into structured price info.
+ *
+ * Supported formats:
+ * - '$0.001' → { amount: '0.001', currency: 'USDC' }
+ * - '0.005 USDC' → { amount: '0.005', currency: 'USDC' }
+ * - '0.01' → { amount: '0.01', currency: 'USDC' }
+ *
+ * @param price - Human-friendly price string
+ * @returns Parsed price with amount and currency
+ * @throws Error if price format is invalid
+ */
+export declare function parsePrice(price: string): ParsedPrice;
+/**
+ * Format a parsed price back to x402 format (e.g., '$0.001')
+ */
+export declare function formatPriceForX402(parsed: ParsedPrice): string;
+//# sourceMappingURL=price.d.ts.map

package/dist/creator/utils/price.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price.d.ts","sourceRoot":"","sources":["../../../src/creator/utils/price.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAgCrD;AAwBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAE9D"}

package/dist/creator/utils/price.js

@@ -0,0 +1,62 @@
+/**
+ * Parse a human-friendly price string into structured price info.
+ *
+ * Supported formats:
+ * - '$0.001' → { amount: '0.001', currency: 'USDC' }
+ * - '0.005 USDC' → { amount: '0.005', currency: 'USDC' }
+ * - '0.01' → { amount: '0.01', currency: 'USDC' }
+ *
+ * @param price - Human-friendly price string
+ * @returns Parsed price with amount and currency
+ * @throws Error if price format is invalid
+ */
+export function parsePrice(price) {
+    const trimmed = price.trim();
+    // Format: $0.001
+    if (trimmed.startsWith('$')) {
+        const amount = trimmed.slice(1).trim();
+        // Use strict decimal regex to prevent malformed values like "1.2.3"
+        if (!/^\d+(?:\.\d+)?$/.test(amount)) {
+            throw new Error(`Invalid price amount: "${amount}" is not a valid decimal number`);
+        }
+        validateAmount(amount);
+        return { amount, currency: 'USDC' };
+    }
+    // Format: 0.005 USDC (with proper decimal validation)
+    const usdcMatch = trimmed.match(/^(\d+(?:\.\d+)?)\s*USDC$/i);
+    if (usdcMatch?.[1]) {
+        const amount = usdcMatch[1];
+        validateAmount(amount);
+        return { amount, currency: 'USDC' };
+    }
+    // Format: just a number (assume USDC) with proper decimal validation
+    if (/^\d+(?:\.\d+)?$/.test(trimmed)) {
+        validateAmount(trimmed);
+        return { amount: trimmed, currency: 'USDC' };
+    }
+    throw new Error(`Invalid price format: "${price}". ` +
+        `Expected formats: '$0.001', '0.005 USDC', or '0.01'`);
+}
+/**
+ * Validate that an amount is a valid positive number
+ */
+function validateAmount(amount) {
+    const num = parseFloat(amount);
+    if (isNaN(num)) {
+        throw new Error(`Invalid price amount: "${amount}" is not a number`);
+    }
+    if (num <= 0) {
+        throw new Error(`Invalid price amount: "${amount}" must be positive`);
+    }
+    if (num > 1000) {
+        throw new Error(`Invalid price amount: "${amount}" seems too high. ` +
+            `Did you mean $${amount}?`);
+    }
+}
+/**
+ * Format a parsed price back to x402 format (e.g., '$0.001')
+ */
+export function formatPriceForX402(parsed) {
+    return `$${parsed.amount}`;
+}
+//# sourceMappingURL=price.js.map

package/dist/creator/utils/price.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price.js","sourceRoot":"","sources":["../../../src/creator/utils/price.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,iBAAiB;IACjB,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACvC,oEAAoE;QACpE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,iCAAiC,CAAC,CAAC;QACrF,CAAC;QACD,cAAc,CAAC,MAAM,CAAC,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;IAED,sDAAsD;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC7D,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,cAAc,CAAC,MAAM,CAAC,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;IAED,qEAAqE;IACrE,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,cAAc,CAAC,OAAO,CAAC,CAAC;QACxB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,IAAI,KAAK,CACb,0BAA0B,KAAK,KAAK;QAClC,qDAAqD,CACxD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,MAAc;IACpC,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAE/B,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,mBAAmB,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,oBAAoB,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,0BAA0B,MAAM,oBAAoB;YAClD,iBAAiB,MAAM,GAAG,CAC7B,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;AAC7B,CAAC"}

package/dist/creator/utils/wallet.d.ts

@@ -0,0 +1,22 @@
+import type { Hex, Address } from 'viem';
+import type { PrivateKeyAccount } from 'viem/accounts';
+/**
+ * Resolve wallet configuration from options or environment.
+ *
+ * Priority:
+ * 1. Explicit wallet option
+ * 2. SKILLZ_WALLET_KEY environment variable
+ *
+ * @param wallet - Optional explicit wallet private key
+ * @returns Object with account and address
+ * @throws Error if no wallet is configured
+ */
+export declare function resolveWallet(wallet?: Hex): {
+    account: PrivateKeyAccount;
+    address: Address;
+};
+/**
+ * Mask a private key for safe logging (show first 6 and last 4 chars)
+ */
+export declare function maskPrivateKey(key: Hex): string;
+//# sourceMappingURL=wallet.d.ts.map

package/dist/creator/utils/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../../src/creator/utils/wallet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG;IAC3C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CAClB,CA8BA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAK/C"}

package/dist/creator/utils/wallet.js

@@ -0,0 +1,45 @@
+import { privateKeyToAccount } from 'viem/accounts';
+/**
+ * Resolve wallet configuration from options or environment.
+ *
+ * Priority:
+ * 1. Explicit wallet option
+ * 2. SKILLZ_WALLET_KEY environment variable
+ *
+ * @param wallet - Optional explicit wallet private key
+ * @returns Object with account and address
+ * @throws Error if no wallet is configured
+ */
+export function resolveWallet(wallet) {
+    const privateKey = wallet ?? process.env.SKILLZ_WALLET_KEY;
+    if (!privateKey) {
+        throw new Error('No wallet configured. Either:\n' +
+            '1. Pass `wallet` option to serve(): serve({ skills }, { wallet: "0x..." })\n' +
+            '2. Set SKILLZ_WALLET_KEY environment variable\n\n' +
+            'The wallet receives payments from skill calls.');
+    }
+    if (!privateKey.startsWith('0x')) {
+        throw new Error('Invalid wallet format. Private key must start with "0x".\n' +
+            'Example: 0x1234567890abcdef...');
+    }
+    try {
+        const account = privateKeyToAccount(privateKey);
+        return {
+            account,
+            address: account.address,
+        };
+    }
+    catch (error) {
+        throw new Error(`Invalid wallet private key: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Mask a private key for safe logging (show first 6 and last 4 chars)
+ */
+export function maskPrivateKey(key) {
+    if (key.length < 20) {
+        return '0x****';
+    }
+    return `${key.slice(0, 6)}...${key.slice(-4)}`;
+}
+//# sourceMappingURL=wallet.js.map

package/dist/creator/utils/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../../src/creator/utils/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAIpD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,MAAY;IAIxC,MAAM,UAAU,GAAG,MAAM,IAAK,OAAO,CAAC,GAAG,CAAC,iBAAqC,CAAC;IAEhF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,iCAAiC;YAC/B,8EAA8E;YAC9E,mDAAmD;YACnD,gDAAgD,CACnD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,4DAA4D;YAC1D,gCAAgC,CACnC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAChD,OAAO;YACL,OAAO;YACP,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAC1F,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAQ;IACrC,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACjD,CAAC"}

package/dist/discovery.d.ts

@@ -0,0 +1,10 @@
+import type { Skill, Creator, Review, SearchFilters } from './types.js';
+export declare class DiscoveryClient {
+    private apiUrl;
+    constructor(apiUrl: string);
+    search(query: string, filters?: SearchFilters): Promise<Skill[]>;
+    getSkill(slug: string): Promise<Skill>;
+    getCreator(address: string): Promise<Creator>;
+    getReviews(skillSlug: string): Promise<Review[]>;
+}
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExE,qBAAa,eAAe;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE5B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAYhE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAMtC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM7C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAKvD"}

package/dist/discovery.js

@@ -0,0 +1,40 @@
+export class DiscoveryClient {
+    apiUrl;
+    constructor(apiUrl) {
+        this.apiUrl = apiUrl;
+    }
+    async search(query, filters) {
+        const params = new URLSearchParams({ q: query });
+        if (filters?.category)
+            params.set('category', filters.category);
+        if (filters?.minPrice)
+            params.set('minPrice', filters.minPrice);
+        if (filters?.maxPrice)
+            params.set('maxPrice', filters.maxPrice);
+        if (filters?.creator)
+            params.set('creator', filters.creator);
+        const res = await fetch(`${this.apiUrl}/skills?${params}`);
+        if (!res.ok)
+            throw new Error(`Search failed: ${res.statusText}`);
+        return res.json();
+    }
+    async getSkill(slug) {
+        const res = await fetch(`${this.apiUrl}/skills/${slug}`);
+        if (!res.ok)
+            throw new Error(`Skill not found: ${slug}`);
+        return res.json();
+    }
+    async getCreator(address) {
+        const res = await fetch(`${this.apiUrl}/creators/${address}`);
+        if (!res.ok)
+            throw new Error(`Creator not found: ${address}`);
+        return res.json();
+    }
+    async getReviews(skillSlug) {
+        const res = await fetch(`${this.apiUrl}/skills/${skillSlug}/reviews`);
+        if (!res.ok)
+            throw new Error(`Failed to get reviews`);
+        return res.json();
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAe;IACN;IAApB,YAAoB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAEtC,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAuB;QACjD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACjD,IAAI,OAAO,EAAE,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChE,IAAI,OAAO,EAAE,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChE,IAAI,OAAO,EAAE,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChE,IAAI,OAAO,EAAE,OAAO;YAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAE7D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,WAAW,MAAM,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QACjE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,WAAW,IAAI,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;QACzD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,aAAa,OAAO,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QAC9D,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,WAAW,SAAS,UAAU,CAAC,CAAC;QACtE,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACtD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { SkillzMarket } from './client.js';
+export { DiscoveryClient } from './discovery.js';
+export { createPaymentFetch, resolveAccount, getWalletAddress, DEFAULT_NETWORK } from './payment.js';
+export type { Skill, Creator, Review, SearchFilters, SkillzMarketOptions, WalletConfig, } from './types.js';
+export type { SkillOptions, ParsedPrice } from './creator/types.js';
+//# 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,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACrG,YAAY,EACV,KAAK,EACL,OAAO,EACP,MAAM,EACN,aAAa,EACb,mBAAmB,EACnB,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { SkillzMarket } from './client.js';
+export { DiscoveryClient } from './discovery.js';
+export { createPaymentFetch, resolveAccount, getWalletAddress, DEFAULT_NETWORK } from './payment.js';
+//# 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,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/payment.d.ts

@@ -0,0 +1,20 @@
+import { type PrivateKeyAccount } from 'viem/accounts';
+import type { WalletConfig } from './types.js';
+/**
+ * Default network for x402 payments (Base mainnet).
+ */
+export declare const DEFAULT_NETWORK: `${string}:${string}`;
+/**
+ * Converts a WalletConfig to a PrivateKeyAccount.
+ */
+export declare function resolveAccount(walletConfig: WalletConfig): PrivateKeyAccount;
+/**
+ * Creates a fetch function that automatically handles x402 payments.
+ * Uses the official x402 registration pattern with wildcard network support.
+ */
+export declare function createPaymentFetch(walletConfig: WalletConfig, _network?: `${string}:${string}`): typeof fetch;
+/**
+ * Gets the wallet address from a WalletConfig.
+ */
+export declare function getWalletAddress(walletConfig: WalletConfig): string;
+//# sourceMappingURL=payment.d.ts.map

package/dist/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../src/payment.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,GAAG,MAAM,IAAI,MAAM,EAAkB,CAAC;AAEpE;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,YAAY,GAAG,iBAAiB,CAK5E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,YAAY,EAC1B,QAAQ,GAAE,GAAG,MAAM,IAAI,MAAM,EAAoB,GAChD,OAAO,KAAK,CAOd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAGnE"}

package/dist/payment.js

@@ -0,0 +1,34 @@
+import { x402Client, wrapFetchWithPayment } from '@x402/fetch';
+import { registerExactEvmScheme } from '@x402/evm/exact/client';
+import { privateKeyToAccount } from 'viem/accounts';
+/**
+ * Default network for x402 payments (Base mainnet).
+ */
+export const DEFAULT_NETWORK = 'eip155:8453';
+/**
+ * Converts a WalletConfig to a PrivateKeyAccount.
+ */
+export function resolveAccount(walletConfig) {
+    if (typeof walletConfig === 'string') {
+        return privateKeyToAccount(walletConfig);
+    }
+    return walletConfig;
+}
+/**
+ * Creates a fetch function that automatically handles x402 payments.
+ * Uses the official x402 registration pattern with wildcard network support.
+ */
+export function createPaymentFetch(walletConfig, _network = DEFAULT_NETWORK) {
+    const account = resolveAccount(walletConfig);
+    const client = new x402Client();
+    registerExactEvmScheme(client, { signer: account });
+    return wrapFetchWithPayment(fetch, client);
+}
+/**
+ * Gets the wallet address from a WalletConfig.
+ */
+export function getWalletAddress(walletConfig) {
+    const account = resolveAccount(walletConfig);
+    return account.address;
+}
+//# sourceMappingURL=payment.js.map

package/dist/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../src/payment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAA0B,MAAM,eAAe,CAAC;AAI5E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAA0B,aAAa,CAAC;AAEpE;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,YAA0B;IACvD,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,mBAAmB,CAAC,YAAmB,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,YAAiC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,YAA0B,EAC1B,WAAkC,eAAe;IAEjD,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAChC,sBAAsB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAEpD,OAAO,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAA0B;IACzD,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,OAAO,CAAC;AACzB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+export interface Skill {
+    id: string;
+    slug: string;
+    name: string;
+    description: string | null;
+    price: string;
+    currency: string;
+    endpoint: string;
+    inputSchema: Record<string, unknown> | null;
+    outputSchema: Record<string, unknown> | null;
+    paymentAddress: string;
+    isActive: boolean;
+    creatorId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Creator {
+    id: string;
+    walletAddress: string;
+    name: string | null;
+    avatar: string | null;
+    bio: string | null;
+    createdAt: string;
+}
+export interface Review {
+    id: string;
+    skillId: string;
+    consumerAddress: string;
+    score: number;
+    comment: string | null;
+    createdAt: string;
+}
+export interface SearchFilters {
+    category?: string;
+    minPrice?: string;
+    maxPrice?: string;
+    creator?: string;
+}
+import type { Hex } from 'viem';
+import type { PrivateKeyAccount } from 'viem/accounts';
+/**
+ * Wallet configuration for x402 payments.
+ * Can be either:
+ * - A viem PrivateKeyAccount object (from privateKeyToAccount)
+ * - A private key hex string (will be converted to account internally)
+ */
+export type WalletConfig = PrivateKeyAccount | Hex;
+export interface SkillzMarketOptions {
+    apiUrl?: string;
+    /**
+     * Wallet for x402 payments. Can be:
+     * - A viem PrivateKeyAccount object (from privateKeyToAccount)
+     * - A private key hex string (0x...)
+     */
+    wallet?: WalletConfig;
+    /**
+     * Network identifier for x402 payments (e.g., 'eip155:8453' for Base mainnet).
+     * Defaults to Base mainnet (eip155:8453).
+     */
+    network?: `${string}:${string}`;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,GAAG,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;CACjC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@skillzmarket/sdk",
+  "version": "0.1.0",
+  "description": "SDK for discovering and calling paid AI skills with automatic x402 payments",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./creator": {
+      "types": "./dist/creator/index.d.ts",
+      "import": "./dist/creator/index.js",
+      "default": "./dist/creator/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "keywords": [
+    "ai",
+    "skills",
+    "marketplace",
+    "x402",
+    "crypto",
+    "payments",
+    "usdc",
+    "base",
+    "ethereum",
+    "sdk",
+    "creator",
+    "monetize"
+  ],
+  "author": "Hiich",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/skillzmarket/sdk.git"
+  },
+  "homepage": "https://skillz.market",
+  "bugs": {
+    "url": "https://github.com/skillzmarket/sdk/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.19.9",
+    "@x402/core": "^2.2.0",
+    "@x402/evm": "^2.2.0",
+    "@x402/fetch": "^2.2.0",
+    "@x402/hono": "^2.2.0",
+    "hono": "^4.0.0",
+    "viem": "^2.0.0"
+  },
+  "peerDependencies": {
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}