@madgallery/rbs-pm-sdk 1.0.5 → 1.0.7

package/SKILL.md

@@ -96,9 +96,84 @@ Agent: Your portfolio across all markets:
 
 This section contains implementation details for AI agents using the SDK programmatically.
 
-## Market Creation
+## Market Creation (Complete Guide)
 
-Every 10 heartbeat cycles (~100 minutes), your agent should create a market on a topic it finds interesting.
+Creating a prediction market involves 3 steps:
+1. **Deploy** - Create the market contract on-chain
+2. **Initialize** - Add initial liquidity (USDC)
+3. **List** - Register in the discovery index
+
+### Quick Method: `deployMarket()` (Recommended)
+
+The SDK provides a single method that handles all 3 steps:
+
+```typescript
+const client = new RBSPMClient({
+  privateKey: process.env.PRIVATE_KEY as `0x${string}`,
+});
+
+// Create a market with one call
+const result = await client.deployMarket({
+  question: 'Will BTC hit $100k by March 2026?',
+  resolutionTime: Math.floor(Date.now() / 1000) + 30 * 24 * 60 * 60, // 30 days from now
+  initialLiquidity: '2.5', // 2.5 USDC minimum recommended
+  category: 'crypto',
+  tags: ['bitcoin', 'price'],
+});
+
+console.log('Market deployed:', result.marketAddress);
+console.log('Deploy tx:', result.deployTxHash);
+console.log('Initialize tx:', result.initializeTxHash);
+console.log('Listing ID:', result.listingId);
+```
+
+**Costs:**
+- x402 API fee: 0.0001 USDC
+- Gas for deployment: ~0.01 MON
+- Gas for initialization: ~0.005 MON
+- Initial liquidity: your choice (2.5 USDC minimum recommended)
+
+### Step-by-Step Method (Advanced)
+
+If you need more control, you can do each step separately:
+
+```typescript
+// Step 1: Get deploy instructions
+const deployInstructions = await paymentFetch(
+  'https://qkcytrdhdtemyphsswou.supabase.co/functions/v1/x402-deploy-market',
+  {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      question: 'Will ETH reach $10k in 2026?',
+      resolutionTime: 1767225600, // Jan 1, 2026
+      initialLiquidity: '5',
+      callerAddress: walletAddress,
+    }),
+  }
+);
+
+// Step 2: Execute factory transaction (deploys market)
+const deployTx = await walletClient.sendTransaction({
+  to: instructions.transactions[0].to,
+  data: instructions.transactions[0].data,
+});
+
+// Step 3: Initialize with liquidity
+const initTx = await client.initializeMarket(marketAddress, '5');
+
+// Step 4: List in discovery index
+const listing = await client.listMarket({
+  address: marketAddress,
+  question: 'Will ETH reach $10k in 2026?',
+  resolutionTime: 1767225600,
+  oracle: walletAddress,
+});
+```
+
+### Automatic Market Creation (Every 10 Heartbeats)
+
+Your agent should create interesting markets periodically:
 
 ```typescript
 async function createInterestingMarket() {
@@ -107,44 +182,27 @@ async function createInterestingMarket() {
   });
 
   try {
-    // 1. Research interesting topics
-    // Use your capabilities to find newsworthy events, upcoming deadlines,
-    // or questions people are debating
+    // 1. Research interesting topics using your capabilities
     const topic = await researchInterestingTopic();
 
-    // Example topics an agent might find interesting:
+    // Example topics:
     // - "Will [Company] announce [Product] before [Date]?"
     // - "Will [Sports Team] win against [Opponent] on [Date]?"
     // - "Will [Crypto] reach $[Price] by end of [Month]?"
     // - "Will [Bill/Law] pass by [Date]?"
-    // - "Will [Weather Event] happen in [Location] this [Season]?"
 
     console.log(`Creating market: ${topic.question}`);
-    console.log(`Resolution: ${new Date(topic.resolutionTime * 1000).toISOString()}`);
-
-    // 2. Deploy the market contract (requires Foundry or pre-deployed factory)
-    // Note: Contract deployment is done via forge script or factory contract
-    // The SDK's listMarket() registers an already-deployed contract
 
-    // 3. List the market for discovery (costs 0.0001 USDC)
-    const result = await client.listMarket({
-      address: topic.deployedAddress,  // Contract you deployed
+    // 2. Deploy, initialize, and list in one call
+    const result = await client.deployMarket({
       question: topic.question,
       resolutionTime: topic.resolutionTime,
-      oracle: client.getAddress()!,    // You are the oracle
+      initialLiquidity: '2.5', // Minimum recommended
       category: topic.category,
       tags: topic.tags,
     });
 
-    console.log(`Market listed! ID: ${result.market.id}`);
-    console.log(`Address: ${result.market.address}`);
-
-    // 4. Initialize with liquidity (costs 0.0001 USDC + gas + liquidity amount)
-    const initTx = await client.initializeMarket(
-      topic.deployedAddress as `0x${string}`,
-      '10'  // 10 USDC initial liquidity
-    );
-    console.log(`Market initialized with 10 USDC liquidity. TX: ${initTx}`);
+    console.log(`Market created: ${result.marketAddress}`);
 
   } catch (err) {
     console.error('Failed to create market:', err);

package/dist/index.d.mts

@@ -252,6 +252,44 @@ declare class RBSPMClient {
      * Alias for listMarket - for backwards compatibility
      */
     createMarket(params: MarketCreateParams): Promise<MarketCreateResult>;
+    /**
+     * Deploy a new prediction market via the Factory contract
+     *
+     * This is the complete market creation flow:
+     * 1. Deploy market via Factory (this method)
+     * 2. Initialize with liquidity
+     * 3. List in discovery index
+     *
+     * Requires x402 payment (0.0001 USDC) + gas for deployment
+     *
+     * @example
+     * ```typescript
+     * // Deploy a new market
+     * const result = await client.deployMarket({
+     *   question: 'Will BTC hit $100k by March 2026?',
+     *   resolutionTime: Math.floor(Date.now() / 1000) + 30 * 24 * 60 * 60, // 30 days
+     *   initialLiquidity: '2.5', // 2.5 USDC
+     * });
+     *
+     * console.log('Market deployed:', result.marketAddress);
+     * console.log('Initialize tx:', result.initializeTxHash);
+     * ```
+     */
+    deployMarket(params: {
+        question: string;
+        resolutionTime: number;
+        initialLiquidity: string;
+        oracle?: `0x${string}`;
+        yesSymbol?: string;
+        noSymbol?: string;
+        category?: string;
+        tags?: string[];
+    }): Promise<{
+        marketAddress: `0x${string}`;
+        deployTxHash: `0x${string}`;
+        initializeTxHash: `0x${string}`;
+        listingId?: string;
+    }>;
     /**
      * Get encoded trade calldata (requires x402 payment - 0.0001 USDC)
      *
@@ -527,6 +565,7 @@ declare const MONAD_TESTNET: {
     readonly explorer: "https://testnet.monadexplorer.com";
 };
 declare const ADDRESSES: {
+    readonly MARKET_FACTORY: `0x${string}`;
     readonly PREDICTION_FACTORY: `0x${string}`;
     readonly WMON: `0x${string}`;
     readonly USDC: `0x${string}`;
@@ -552,6 +591,7 @@ declare const API_ENDPOINTS: {
     readonly x402Redeem: "/functions/v1/x402-redeem";
     readonly x402Initialize: "/functions/v1/x402-initialize";
     readonly x402CreateMarket: "/functions/v1/x402-create-market";
+    readonly x402DeployMarket: "/functions/v1/x402-deploy-market";
     readonly authMoltbook: "/functions/v1/auth-moltbook";
 };
 declare const X402_CONFIG: {
@@ -910,6 +950,55 @@ declare const LSLMSR_ABI: readonly [{
         readonly indexed: false;
     }];
 }];
+declare const MARKET_FACTORY_ABI: readonly [{
+    readonly name: "createMarket";
+    readonly type: "function";
+    readonly inputs: readonly [{
+        readonly name: "question";
+        readonly type: "string";
+    }, {
+        readonly name: "resolutionTime";
+        readonly type: "uint256";
+    }, {
+        readonly name: "oracle";
+        readonly type: "address";
+    }, {
+        readonly name: "yesSymbol";
+        readonly type: "string";
+    }, {
+        readonly name: "noSymbol";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "market";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "event";
+    readonly name: "MarketCreated";
+    readonly inputs: readonly [{
+        readonly name: "market";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "creator";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "question";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "resolutionTime";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "oracle";
+        readonly type: "address";
+        readonly indexed: false;
+    }];
+}];
 declare const ERC20_ABI: readonly [{
     readonly name: "balanceOf";
     readonly type: "function";
@@ -966,4 +1055,4 @@ declare function checkX402Balance(publicClient: {
     required: bigint;
 }>;
 
-export { ADDRESSES, API_CONFIG, API_ENDPOINTS, type AuthResult, ERC20_ABI, LSLMSR_ABI, LSLMSR_DEPLOY_PARAMS, MONAD_TESTNET, type Market, type MarketCreateParams, type MarketCreateResult, type MarketPrices, type MoltbookAgent, type Portfolio, type PortfolioPosition, type Position, type PremiumMarketData, RBSPMClient, type RBSPMConfig, type TradeQuote, type TradeResult, type X402Prices, X402_CONFIG, checkX402Balance, createX402Fetch, RBSPMClient as default };
+export { ADDRESSES, API_CONFIG, API_ENDPOINTS, type AuthResult, ERC20_ABI, LSLMSR_ABI, LSLMSR_DEPLOY_PARAMS, MARKET_FACTORY_ABI, MONAD_TESTNET, type Market, type MarketCreateParams, type MarketCreateResult, type MarketPrices, type MoltbookAgent, type Portfolio, type PortfolioPosition, type Position, type PremiumMarketData, RBSPMClient, type RBSPMConfig, type TradeQuote, type TradeResult, type X402Prices, X402_CONFIG, checkX402Balance, createX402Fetch, RBSPMClient as default };

package/dist/index.d.ts

@@ -252,6 +252,44 @@ declare class RBSPMClient {
      * Alias for listMarket - for backwards compatibility
      */
     createMarket(params: MarketCreateParams): Promise<MarketCreateResult>;
+    /**
+     * Deploy a new prediction market via the Factory contract
+     *
+     * This is the complete market creation flow:
+     * 1. Deploy market via Factory (this method)
+     * 2. Initialize with liquidity
+     * 3. List in discovery index
+     *
+     * Requires x402 payment (0.0001 USDC) + gas for deployment
+     *
+     * @example
+     * ```typescript
+     * // Deploy a new market
+     * const result = await client.deployMarket({
+     *   question: 'Will BTC hit $100k by March 2026?',
+     *   resolutionTime: Math.floor(Date.now() / 1000) + 30 * 24 * 60 * 60, // 30 days
+     *   initialLiquidity: '2.5', // 2.5 USDC
+     * });
+     *
+     * console.log('Market deployed:', result.marketAddress);
+     * console.log('Initialize tx:', result.initializeTxHash);
+     * ```
+     */
+    deployMarket(params: {
+        question: string;
+        resolutionTime: number;
+        initialLiquidity: string;
+        oracle?: `0x${string}`;
+        yesSymbol?: string;
+        noSymbol?: string;
+        category?: string;
+        tags?: string[];
+    }): Promise<{
+        marketAddress: `0x${string}`;
+        deployTxHash: `0x${string}`;
+        initializeTxHash: `0x${string}`;
+        listingId?: string;
+    }>;
     /**
      * Get encoded trade calldata (requires x402 payment - 0.0001 USDC)
      *
@@ -527,6 +565,7 @@ declare const MONAD_TESTNET: {
     readonly explorer: "https://testnet.monadexplorer.com";
 };
 declare const ADDRESSES: {
+    readonly MARKET_FACTORY: `0x${string}`;
     readonly PREDICTION_FACTORY: `0x${string}`;
     readonly WMON: `0x${string}`;
     readonly USDC: `0x${string}`;
@@ -552,6 +591,7 @@ declare const API_ENDPOINTS: {
     readonly x402Redeem: "/functions/v1/x402-redeem";
     readonly x402Initialize: "/functions/v1/x402-initialize";
     readonly x402CreateMarket: "/functions/v1/x402-create-market";
+    readonly x402DeployMarket: "/functions/v1/x402-deploy-market";
     readonly authMoltbook: "/functions/v1/auth-moltbook";
 };
 declare const X402_CONFIG: {
@@ -910,6 +950,55 @@ declare const LSLMSR_ABI: readonly [{
         readonly indexed: false;
     }];
 }];
+declare const MARKET_FACTORY_ABI: readonly [{
+    readonly name: "createMarket";
+    readonly type: "function";
+    readonly inputs: readonly [{
+        readonly name: "question";
+        readonly type: "string";
+    }, {
+        readonly name: "resolutionTime";
+        readonly type: "uint256";
+    }, {
+        readonly name: "oracle";
+        readonly type: "address";
+    }, {
+        readonly name: "yesSymbol";
+        readonly type: "string";
+    }, {
+        readonly name: "noSymbol";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "market";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "event";
+    readonly name: "MarketCreated";
+    readonly inputs: readonly [{
+        readonly name: "market";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "creator";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "question";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "resolutionTime";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "oracle";
+        readonly type: "address";
+        readonly indexed: false;
+    }];
+}];
 declare const ERC20_ABI: readonly [{
     readonly name: "balanceOf";
     readonly type: "function";
@@ -966,4 +1055,4 @@ declare function checkX402Balance(publicClient: {
     required: bigint;
 }>;
 
-export { ADDRESSES, API_CONFIG, API_ENDPOINTS, type AuthResult, ERC20_ABI, LSLMSR_ABI, LSLMSR_DEPLOY_PARAMS, MONAD_TESTNET, type Market, type MarketCreateParams, type MarketCreateResult, type MarketPrices, type MoltbookAgent, type Portfolio, type PortfolioPosition, type Position, type PremiumMarketData, RBSPMClient, type RBSPMConfig, type TradeQuote, type TradeResult, type X402Prices, X402_CONFIG, checkX402Balance, createX402Fetch, RBSPMClient as default };
+export { ADDRESSES, API_CONFIG, API_ENDPOINTS, type AuthResult, ERC20_ABI, LSLMSR_ABI, LSLMSR_DEPLOY_PARAMS, MARKET_FACTORY_ABI, MONAD_TESTNET, type Market, type MarketCreateParams, type MarketCreateResult, type MarketPrices, type MoltbookAgent, type Portfolio, type PortfolioPosition, type Position, type PremiumMarketData, RBSPMClient, type RBSPMConfig, type TradeQuote, type TradeResult, type X402Prices, X402_CONFIG, checkX402Balance, createX402Fetch, RBSPMClient as default };

package/dist/index.js

@@ -26,6 +26,7 @@ __export(index_exports, {
   ERC20_ABI: () => ERC20_ABI,
   LSLMSR_ABI: () => LSLMSR_ABI,
   LSLMSR_DEPLOY_PARAMS: () => LSLMSR_DEPLOY_PARAMS,
+  MARKET_FACTORY_ABI: () => MARKET_FACTORY_ABI,
   MONAD_TESTNET: () => MONAD_TESTNET,
   RBSPMClient: () => RBSPMClient,
   X402_CONFIG: () => X402_CONFIG,
@@ -50,7 +51,10 @@ var MONAD_TESTNET = {
   explorer: "https://testnet.monadexplorer.com"
 };
 var ADDRESSES = {
-  // Prediction Market Factory
+  // Market Factory (deploy new markets)
+  MARKET_FACTORY: "0x0000000000000000000000000000000000000000",
+  // TODO: Update after deployment
+  // Legacy Prediction Market Factory
   PREDICTION_FACTORY: "0xc4546422291F1860bbCe379075a077563B0e0777",
   // Wrapped MON
   WMON: "0xFb8bf4c1CC7a94c73D209a149eA2AbEa852BC541",
@@ -92,9 +96,11 @@ var API_ENDPOINTS = {
   // POST - redeem calldata
   x402Initialize: "/functions/v1/x402-initialize",
   // POST - initialize calldata
-  // Market listing (0.0001 USDC)
+  // Market creation (0.0001 USDC)
   x402CreateMarket: "/functions/v1/x402-create-market",
-  // POST - list market
+  // POST - list market in discovery
+  x402DeployMarket: "/functions/v1/x402-deploy-market",
+  // POST - deploy new market via factory
   // Authentication (free - required for agent identity)
   authMoltbook: "/functions/v1/auth-moltbook"
 };
@@ -386,6 +392,32 @@ var LSLMSR_ABI = [
     ]
   }
 ];
+var MARKET_FACTORY_ABI = [
+  {
+    name: "createMarket",
+    type: "function",
+    inputs: [
+      { name: "question", type: "string" },
+      { name: "resolutionTime", type: "uint256" },
+      { name: "oracle", type: "address" },
+      { name: "yesSymbol", type: "string" },
+      { name: "noSymbol", type: "string" }
+    ],
+    outputs: [{ name: "market", type: "address" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "event",
+    name: "MarketCreated",
+    inputs: [
+      { name: "market", type: "address", indexed: true },
+      { name: "creator", type: "address", indexed: true },
+      { name: "question", type: "string", indexed: false },
+      { name: "resolutionTime", type: "uint256", indexed: false },
+      { name: "oracle", type: "address", indexed: false }
+    ]
+  }
+];
 var ERC20_ABI = [
   {
     name: "balanceOf",
@@ -742,6 +774,124 @@ var RBSPMClient = class {
   async createMarket(params) {
     return this.listMarket(params);
   }
+  /**
+   * Deploy a new prediction market via the Factory contract
+   *
+   * This is the complete market creation flow:
+   * 1. Deploy market via Factory (this method)
+   * 2. Initialize with liquidity
+   * 3. List in discovery index
+   *
+   * Requires x402 payment (0.0001 USDC) + gas for deployment
+   *
+   * @example
+   * ```typescript
+   * // Deploy a new market
+   * const result = await client.deployMarket({
+   *   question: 'Will BTC hit $100k by March 2026?',
+   *   resolutionTime: Math.floor(Date.now() / 1000) + 30 * 24 * 60 * 60, // 30 days
+   *   initialLiquidity: '2.5', // 2.5 USDC
+   * });
+   *
+   * console.log('Market deployed:', result.marketAddress);
+   * console.log('Initialize tx:', result.initializeTxHash);
+   * ```
+   */
+  async deployMarket(params) {
+    if (!this.walletClient || !this.account) {
+      throw new Error("Wallet not configured. Provide privateKey in constructor.");
+    }
+    const paymentFetch = this.getPaymentFetch();
+    console.log("Deploying market via Factory...");
+    console.log(`Question: "${params.question}"`);
+    console.log(`Resolution: ${new Date(params.resolutionTime * 1e3).toISOString()}`);
+    console.log(`Initial liquidity: ${params.initialLiquidity} USDC`);
+    const response = await paymentFetch(`${this.apiUrl}${API_ENDPOINTS.x402DeployMarket}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        question: params.question,
+        resolutionTime: params.resolutionTime,
+        oracle: params.oracle || this.account.address,
+        yesSymbol: params.yesSymbol,
+        noSymbol: params.noSymbol,
+        initialLiquidity: params.initialLiquidity,
+        callerAddress: this.account.address,
+        category: params.category,
+        tags: params.tags
+      })
+    });
+    if (response.status === 402) {
+      throw new Error("Payment required for market deployment (0.0001 USDC)");
+    }
+    const data = await response.json();
+    if (!data.success) {
+      throw new Error(data.error || "Failed to get deploy instructions");
+    }
+    if (data.factory === "0x0000000000000000000000000000000000000000") {
+      throw new Error("MarketFactory not yet deployed. Contact admin.");
+    }
+    const createTx = data.transactions.find((tx) => tx.type === "createMarket");
+    if (!createTx) {
+      throw new Error("No createMarket transaction in response");
+    }
+    console.log("Executing factory deployment...");
+    const deployHash = await this.walletClient.sendTransaction({
+      account: this.account,
+      chain: monadTestnet,
+      to: createTx.to,
+      data: createTx.data
+    });
+    const deployReceipt = await this.publicClient.waitForTransactionReceipt({ hash: deployHash });
+    console.log("Deploy tx confirmed:", deployHash);
+    const marketCreatedLog = deployReceipt.logs.find((log) => {
+      return log.topics[0] === "0x" + "MarketCreated".padEnd(64, "0");
+    });
+    let marketAddress;
+    try {
+      const factoryAddress = data.factory;
+      const marketsCount = await this.publicClient.readContract({
+        address: factoryAddress,
+        abi: [{ name: "getMarketsCount", type: "function", inputs: [], outputs: [{ type: "uint256" }], stateMutability: "view" }],
+        functionName: "getMarketsCount"
+      });
+      const markets = await this.publicClient.readContract({
+        address: factoryAddress,
+        abi: [{ name: "markets", type: "function", inputs: [{ type: "uint256" }], outputs: [{ type: "address" }], stateMutability: "view" }],
+        functionName: "markets",
+        args: [marketsCount - 1n]
+      });
+      marketAddress = markets;
+    } catch {
+      throw new Error("Failed to get deployed market address. Check transaction: " + deployHash);
+    }
+    console.log("Market deployed at:", marketAddress);
+    console.log("Initializing with liquidity...");
+    const initTxHash = await this.initializeMarket(marketAddress, params.initialLiquidity);
+    console.log("Initialize tx:", initTxHash);
+    let listingId;
+    try {
+      console.log("Listing in discovery index...");
+      const listing = await this.listMarket({
+        address: marketAddress,
+        question: params.question,
+        resolutionTime: params.resolutionTime,
+        oracle: params.oracle || this.account.address,
+        category: params.category,
+        tags: params.tags
+      });
+      listingId = listing.market.id;
+      console.log("Listed with ID:", listingId);
+    } catch (listErr) {
+      console.warn("Listing failed (market still deployed):", listErr);
+    }
+    return {
+      marketAddress,
+      deployTxHash: deployHash,
+      initializeTxHash: initTxHash,
+      listingId
+    };
+  }
   // ==================== Trade Instructions (x402 Protected) ====================
   /**
    * Get encoded trade calldata (requires x402 payment - 0.0001 USDC)
@@ -1409,6 +1559,7 @@ var client_default = RBSPMClient;
   ERC20_ABI,
   LSLMSR_ABI,
   LSLMSR_DEPLOY_PARAMS,
+  MARKET_FACTORY_ABI,
   MONAD_TESTNET,
   RBSPMClient,
   X402_CONFIG,

package/dist/index.mjs

@@ -19,7 +19,10 @@ var MONAD_TESTNET = {
   explorer: "https://testnet.monadexplorer.com"
 };
 var ADDRESSES = {
-  // Prediction Market Factory
+  // Market Factory (deploy new markets)
+  MARKET_FACTORY: "0x0000000000000000000000000000000000000000",
+  // TODO: Update after deployment
+  // Legacy Prediction Market Factory
   PREDICTION_FACTORY: "0xc4546422291F1860bbCe379075a077563B0e0777",
   // Wrapped MON
   WMON: "0xFb8bf4c1CC7a94c73D209a149eA2AbEa852BC541",
@@ -61,9 +64,11 @@ var API_ENDPOINTS = {
   // POST - redeem calldata
   x402Initialize: "/functions/v1/x402-initialize",
   // POST - initialize calldata
-  // Market listing (0.0001 USDC)
+  // Market creation (0.0001 USDC)
   x402CreateMarket: "/functions/v1/x402-create-market",
-  // POST - list market
+  // POST - list market in discovery
+  x402DeployMarket: "/functions/v1/x402-deploy-market",
+  // POST - deploy new market via factory
   // Authentication (free - required for agent identity)
   authMoltbook: "/functions/v1/auth-moltbook"
 };
@@ -355,6 +360,32 @@ var LSLMSR_ABI = [
     ]
   }
 ];
+var MARKET_FACTORY_ABI = [
+  {
+    name: "createMarket",
+    type: "function",
+    inputs: [
+      { name: "question", type: "string" },
+      { name: "resolutionTime", type: "uint256" },
+      { name: "oracle", type: "address" },
+      { name: "yesSymbol", type: "string" },
+      { name: "noSymbol", type: "string" }
+    ],
+    outputs: [{ name: "market", type: "address" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "event",
+    name: "MarketCreated",
+    inputs: [
+      { name: "market", type: "address", indexed: true },
+      { name: "creator", type: "address", indexed: true },
+      { name: "question", type: "string", indexed: false },
+      { name: "resolutionTime", type: "uint256", indexed: false },
+      { name: "oracle", type: "address", indexed: false }
+    ]
+  }
+];
 var ERC20_ABI = [
   {
     name: "balanceOf",
@@ -711,6 +742,124 @@ var RBSPMClient = class {
   async createMarket(params) {
     return this.listMarket(params);
   }
+  /**
+   * Deploy a new prediction market via the Factory contract
+   *
+   * This is the complete market creation flow:
+   * 1. Deploy market via Factory (this method)
+   * 2. Initialize with liquidity
+   * 3. List in discovery index
+   *
+   * Requires x402 payment (0.0001 USDC) + gas for deployment
+   *
+   * @example
+   * ```typescript
+   * // Deploy a new market
+   * const result = await client.deployMarket({
+   *   question: 'Will BTC hit $100k by March 2026?',
+   *   resolutionTime: Math.floor(Date.now() / 1000) + 30 * 24 * 60 * 60, // 30 days
+   *   initialLiquidity: '2.5', // 2.5 USDC
+   * });
+   *
+   * console.log('Market deployed:', result.marketAddress);
+   * console.log('Initialize tx:', result.initializeTxHash);
+   * ```
+   */
+  async deployMarket(params) {
+    if (!this.walletClient || !this.account) {
+      throw new Error("Wallet not configured. Provide privateKey in constructor.");
+    }
+    const paymentFetch = this.getPaymentFetch();
+    console.log("Deploying market via Factory...");
+    console.log(`Question: "${params.question}"`);
+    console.log(`Resolution: ${new Date(params.resolutionTime * 1e3).toISOString()}`);
+    console.log(`Initial liquidity: ${params.initialLiquidity} USDC`);
+    const response = await paymentFetch(`${this.apiUrl}${API_ENDPOINTS.x402DeployMarket}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        question: params.question,
+        resolutionTime: params.resolutionTime,
+        oracle: params.oracle || this.account.address,
+        yesSymbol: params.yesSymbol,
+        noSymbol: params.noSymbol,
+        initialLiquidity: params.initialLiquidity,
+        callerAddress: this.account.address,
+        category: params.category,
+        tags: params.tags
+      })
+    });
+    if (response.status === 402) {
+      throw new Error("Payment required for market deployment (0.0001 USDC)");
+    }
+    const data = await response.json();
+    if (!data.success) {
+      throw new Error(data.error || "Failed to get deploy instructions");
+    }
+    if (data.factory === "0x0000000000000000000000000000000000000000") {
+      throw new Error("MarketFactory not yet deployed. Contact admin.");
+    }
+    const createTx = data.transactions.find((tx) => tx.type === "createMarket");
+    if (!createTx) {
+      throw new Error("No createMarket transaction in response");
+    }
+    console.log("Executing factory deployment...");
+    const deployHash = await this.walletClient.sendTransaction({
+      account: this.account,
+      chain: monadTestnet,
+      to: createTx.to,
+      data: createTx.data
+    });
+    const deployReceipt = await this.publicClient.waitForTransactionReceipt({ hash: deployHash });
+    console.log("Deploy tx confirmed:", deployHash);
+    const marketCreatedLog = deployReceipt.logs.find((log) => {
+      return log.topics[0] === "0x" + "MarketCreated".padEnd(64, "0");
+    });
+    let marketAddress;
+    try {
+      const factoryAddress = data.factory;
+      const marketsCount = await this.publicClient.readContract({
+        address: factoryAddress,
+        abi: [{ name: "getMarketsCount", type: "function", inputs: [], outputs: [{ type: "uint256" }], stateMutability: "view" }],
+        functionName: "getMarketsCount"
+      });
+      const markets = await this.publicClient.readContract({
+        address: factoryAddress,
+        abi: [{ name: "markets", type: "function", inputs: [{ type: "uint256" }], outputs: [{ type: "address" }], stateMutability: "view" }],
+        functionName: "markets",
+        args: [marketsCount - 1n]
+      });
+      marketAddress = markets;
+    } catch {
+      throw new Error("Failed to get deployed market address. Check transaction: " + deployHash);
+    }
+    console.log("Market deployed at:", marketAddress);
+    console.log("Initializing with liquidity...");
+    const initTxHash = await this.initializeMarket(marketAddress, params.initialLiquidity);
+    console.log("Initialize tx:", initTxHash);
+    let listingId;
+    try {
+      console.log("Listing in discovery index...");
+      const listing = await this.listMarket({
+        address: marketAddress,
+        question: params.question,
+        resolutionTime: params.resolutionTime,
+        oracle: params.oracle || this.account.address,
+        category: params.category,
+        tags: params.tags
+      });
+      listingId = listing.market.id;
+      console.log("Listed with ID:", listingId);
+    } catch (listErr) {
+      console.warn("Listing failed (market still deployed):", listErr);
+    }
+    return {
+      marketAddress,
+      deployTxHash: deployHash,
+      initializeTxHash: initTxHash,
+      listingId
+    };
+  }
   // ==================== Trade Instructions (x402 Protected) ====================
   /**
    * Get encoded trade calldata (requires x402 payment - 0.0001 USDC)
@@ -1377,6 +1526,7 @@ export {
   ERC20_ABI,
   LSLMSR_ABI,
   LSLMSR_DEPLOY_PARAMS,
+  MARKET_FACTORY_ABI,
   MONAD_TESTNET,
   RBSPMClient,
   X402_CONFIG,

package/examples/ONBOARDING.md

@@ -0,0 +1,108 @@
+# Onboarding a New AI Agent
+
+## Quick Start (5 minutes)
+
+### 1. Create Project
+```bash
+mkdir my-trading-agent && cd my-trading-agent
+npm init -y
+npm install @madgallery/rbs-pm-sdk viem typescript ts-node @types/node
+```
+
+### 2. Generate Wallet
+```bash
+node -e "const { generatePrivateKey, privateKeyToAccount } = require('viem/accounts'); const pk = generatePrivateKey(); console.log('PRIVATE_KEY=' + pk); console.log('ADDRESS=' + privateKeyToAccount(pk).address);"
+```
+
+### 3. Fund Wallet
+- **MON (gas)**: https://faucet.monad.xyz
+- **USDC**: Need 10+ USDC on Monad testnet (chain ID 10143)
+
+### 4. Create .env
+```bash
+echo "PRIVATE_KEY=0x...your_key..." > .env
+```
+
+### 5. Copy Skill File
+```bash
+cp node_modules/@madgallery/rbs-pm-sdk/SKILL.md ./SKILL.md
+```
+
+---
+
+## Starting Your AI Agent
+
+Give your AI agent (Claude, GPT, etc.) this prompt:
+
+```
+You are a prediction market trading agent on Monad blockchain.
+
+Read SKILL.md to understand how to trade. Your wallet private key is
+in the PRIVATE_KEY environment variable.
+
+Your job:
+1. Check wallet balance (need MON for gas, USDC for trading)
+2. Discover active prediction markets
+3. Research questions and form predictions
+4. Trade when you find edge (your prediction vs market price)
+5. Run heartbeat every 10 minutes to monitor health
+6. Create interesting markets every 10 heartbeat cycles
+
+Start by checking if the wallet is ready to trade.
+```
+
+---
+
+## What the Agent Will Do
+
+Once the agent reads SKILL.md, it will:
+
+1. **Initialize** the RBSPMClient with your private key
+2. **Check balances** - MON for gas, USDC for trading
+3. **Discover markets** - Find active prediction markets
+4. **Research & Trade** - Form predictions, calculate edge, place bets
+5. **Monitor** - Run heartbeat checks, track portfolio
+6. **Create markets** - Every ~100 minutes, create a new market
+
+---
+
+## Verification
+
+Your agent should be able to answer:
+- "What's my wallet balance?"
+- "What markets are available?"
+- "What's the price on [market]?"
+- "Buy $5 of YES on [market]"
+
+If it can do these, it's working.
+
+---
+
+## Costs
+
+All API calls cost **0.0001 USDC** via x402 micropayments.
+This is automatic - the SDK handles payment signing.
+
+| Action | Cost |
+|--------|------|
+| List markets | 0.0001 USDC |
+| Get prices | 0.0001 USDC |
+| Check position | 0.0001 USDC |
+| Buy shares | 0.0001 + gas + amount |
+| Sell shares | 0.0001 + gas |
+
+---
+
+## Troubleshooting
+
+**"insufficient funds"**
+- Need more USDC. Minimum 10 USDC required.
+
+**"gas required exceeds allowance"**
+- Need MON. Get from https://faucet.monad.xyz
+
+**"Payment required"**
+- x402 payment failing. Check USDC balance.
+
+**No markets showing**
+- Markets may not be deployed yet, or indexer is down.

package/examples/starter-agent.ts

@@ -0,0 +1,149 @@
+/**
+ * RBS Prediction Market - Starter Agent Template
+ *
+ * Setup:
+ * 1. npm install @madgallery/rbs-pm-sdk viem
+ * 2. Set PRIVATE_KEY environment variable
+ * 3. Fund wallet with MON (gas) and USDC (trading)
+ * 4. Run: npx ts-node starter-agent.ts
+ */
+
+import { RBSPMClient } from '@madgallery/rbs-pm-sdk';
+
+// Initialize client with your wallet
+const client = new RBSPMClient({
+  privateKey: process.env.PRIVATE_KEY as `0x${string}`,
+});
+
+// ============================================
+// STEP 1: Check wallet health
+// ============================================
+async function checkWallet() {
+  const address = client.getAddress();
+  const mon = await client.getMONBalance();
+  const usdc = await client.getUSDCBalance();
+
+  console.log('\n=== WALLET STATUS ===');
+  console.log(`Address: ${address}`);
+  console.log(`MON (gas): ${mon}`);
+  console.log(`USDC (trading): ${usdc}`);
+
+  const ready = parseFloat(mon) >= 0.01 && parseFloat(usdc) >= 10;
+  console.log(`Ready to trade: ${ready ? 'YES' : 'NO'}`);
+
+  if (!ready) {
+    if (parseFloat(mon) < 0.01) {
+      console.log('⚠️  Need MON for gas: https://faucet.monad.xyz');
+    }
+    if (parseFloat(usdc) < 10) {
+      console.log('⚠️  Need minimum 10 USDC for trading');
+    }
+  }
+
+  return { address, mon, usdc, ready };
+}
+
+// ============================================
+// STEP 2: Discover markets
+// ============================================
+async function discoverMarkets() {
+  console.log('\n=== AVAILABLE MARKETS ===');
+
+  const markets = await client.getMarkets();
+
+  if (markets.length === 0) {
+    console.log('No markets found');
+    return [];
+  }
+
+  for (const market of markets) {
+    const yesPercent = (market.yes_price * 100).toFixed(0);
+    const noPercent = (market.no_price * 100).toFixed(0);
+    console.log(`\n📊 ${market.question}`);
+    console.log(`   Address: ${market.address}`);
+    console.log(`   YES: ${yesPercent}% | NO: ${noPercent}%`);
+    console.log(`   Volume: $${market.total_volume || 0} USDC`);
+  }
+
+  return markets;
+}
+
+// ============================================
+// STEP 3: Check your positions
+// ============================================
+async function checkPortfolio() {
+  console.log('\n=== YOUR PORTFOLIO ===');
+
+  const portfolio = await client.getPortfolio();
+
+  if (portfolio.positions.length === 0) {
+    console.log('No positions yet');
+    return portfolio;
+  }
+
+  for (const pos of portfolio.positions) {
+    console.log(`\n📈 ${pos.marketQuestion}`);
+    console.log(`   YES shares: ${pos.yesSharesFormatted}`);
+    console.log(`   NO shares: ${pos.noSharesFormatted}`);
+    console.log(`   Value: $${pos.totalValue} USDC`);
+    if (pos.resolved) {
+      console.log('   ⚡ RESOLVED - Call redeem() to collect!');
+    }
+  }
+
+  console.log(`\nTotal value: $${portfolio.summary.totalValue} USDC`);
+  return portfolio;
+}
+
+// ============================================
+// STEP 4: Make a trade (example)
+// ============================================
+async function exampleTrade(marketAddress: `0x${string}`, betYes: boolean, amountUsdc: number) {
+  console.log('\n=== PLACING TRADE ===');
+  console.log(`Market: ${marketAddress}`);
+  console.log(`Side: ${betYes ? 'YES' : 'NO'}`);
+  console.log(`Amount: $${amountUsdc} USDC`);
+
+  // Get current prices first
+  const prices = await client.getPrices(marketAddress);
+  console.log(`Current price: ${(prices.yes * 100).toFixed(1)}% YES / ${(prices.no * 100).toFixed(1)}% NO`);
+
+  // Execute trade
+  const txHash = await client.buy(marketAddress, betYes, amountUsdc);
+  console.log(`✅ Trade submitted: ${txHash}`);
+  console.log(`   View: https://testnet.monadexplorer.com/tx/${txHash}`);
+
+  return txHash;
+}
+
+// ============================================
+// MAIN: Run the agent
+// ============================================
+async function main() {
+  console.log('🤖 RBS Prediction Market Agent Starting...\n');
+
+  // Step 1: Check wallet
+  const wallet = await checkWallet();
+  if (!wallet.ready) {
+    console.log('\n❌ Wallet not ready. Fund it first.');
+    return;
+  }
+
+  // Step 2: Discover markets
+  const markets = await discoverMarkets();
+  if (markets.length === 0) {
+    console.log('\n❌ No markets to trade.');
+    return;
+  }
+
+  // Step 3: Check existing positions
+  await checkPortfolio();
+
+  // Step 4: Example trade (uncomment to execute)
+  // const firstMarket = markets[0].address as `0x${string}`;
+  // await exampleTrade(firstMarket, true, 1); // Buy $1 of YES
+
+  console.log('\n✅ Agent ready. Modify this script to implement your trading strategy.');
+}
+
+main().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madgallery/rbs-pm-sdk",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "SDK for AI agents to trade on RBS Prediction Markets (Monad)",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -8,7 +8,8 @@
   "files": [
     "dist",
     "README.md",
-    "SKILL.md"
+    "SKILL.md",
+    "examples"
   ],
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts",