@moltium/world-core 0.1.22 → 0.1.24

package/dist/index.cjs

@@ -1,9 +1,9 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5;
 
 
 
 
-var _chunkDHQFXIEWcjs = require('./chunk-DHQFXIEW.cjs');
+var _chunkWI7EASJJcjs = require('./chunk-WI7EASJJ.cjs');
 
 // src/config/types.ts
 function profileFromCard(card, walletAddress) {
@@ -430,7 +430,7 @@ async function createLevelDBAdapter(config) {
 var _uuid = require('uuid');
 
 // src/discovery/AgentEvaluator.ts
-var logger2 = _chunkDHQFXIEWcjs.createLogger.call(void 0, "AgentEvaluator");
+var logger2 = _chunkWI7EASJJcjs.createLogger.call(void 0, "AgentEvaluator");
 var AgentEvaluator = class {
   constructor(rules) {
     this.rules = rules;
@@ -544,7 +544,7 @@ var AgentEvaluator = class {
 
 // src/blockchain/BlockchainClient.ts
 var _ethers = require('ethers');
-var logger3 = _chunkDHQFXIEWcjs.createLogger.call(void 0, "BlockchainClient");
+var logger3 = _chunkWI7EASJJcjs.createLogger.call(void 0, "BlockchainClient");
 var AGENT_REGISTRY_ABI = [
   "function registerAgent(string agentUrl, string name) external",
   "function isAgentValid(address wallet) external view returns (bool)",
@@ -567,8 +567,8 @@ var WORLD_TOKEN_ABI = [
   "function balanceOf(address account) external view returns (uint256)",
   "function transfer(address to, uint256 amount) external returns (bool)"
 ];
-var BlockchainClient = class {
-  constructor(config) {
+var BlockchainClient = (_class2 = class {
+  constructor(config) {;_class2.prototype.__init4.call(this);
     this.config = config;
     this.provider = new _ethers.ethers.JsonRpcProvider(config.rpcUrl);
     this.wallet = new _ethers.ethers.Wallet(config.privateKey, this.provider);
@@ -766,7 +766,7 @@ var BlockchainClient = class {
     return this.wallet.address;
   }
   /**
-   * Get entry fee in MON
+   * Get entry fee in MON (formatted)
    */
   async getEntryFee() {
     if (!this.membershipContract) {
@@ -780,13 +780,85 @@ var BlockchainClient = class {
       return "0";
     }
   }
-};
+  /**
+   * Get entry fee in wei (raw BigInt string)
+   */
+  async getEntryFeeWei() {
+    if (!this.membershipContract) {
+      return "0";
+    }
+    try {
+      const fee = await this.membershipContract.entryFee();
+      return fee.toString();
+    } catch (error) {
+      logger3.error("Failed to get entry fee (wei)", { error: error.message });
+      return "0";
+    }
+  }
+  // Track used payment tx hashes to prevent replay attacks
+  __init4() {this.usedPayments = /* @__PURE__ */ new Set()}
+  /**
+   * Verify a payment transaction from an agent.
+   * Checks: tx confirmed, correct sender, correct recipient (world wallet), sufficient amount.
+   * Prevents replay attacks by tracking used tx hashes.
+   */
+  async verifyPayment(txHash, expectedSender, expectedAmountWei) {
+    const normalizedHash = txHash.toLowerCase();
+    if (this.usedPayments.has(normalizedHash)) {
+      logger3.warn("Payment verification: transaction already used", { txHash });
+      return false;
+    }
+    try {
+      const receipt = await this.provider.getTransactionReceipt(txHash);
+      if (!receipt || receipt.status !== 1) {
+        logger3.warn("Payment verification: transaction not confirmed or failed", { txHash });
+        return false;
+      }
+      const tx = await this.provider.getTransaction(txHash);
+      if (!tx) {
+        logger3.warn("Payment verification: transaction not found", { txHash });
+        return false;
+      }
+      if (tx.from.toLowerCase() !== expectedSender.toLowerCase()) {
+        logger3.warn("Payment verification: wrong sender", {
+          expected: expectedSender,
+          actual: tx.from
+        });
+        return false;
+      }
+      if (_optionalChain([tx, 'access', _13 => _13.to, 'optionalAccess', _14 => _14.toLowerCase, 'call', _15 => _15()]) !== this.wallet.address.toLowerCase()) {
+        logger3.warn("Payment verification: wrong recipient", {
+          expected: this.wallet.address,
+          actual: tx.to
+        });
+        return false;
+      }
+      if (tx.value < BigInt(expectedAmountWei)) {
+        logger3.warn("Payment verification: insufficient amount", {
+          expected: expectedAmountWei,
+          actual: tx.value.toString()
+        });
+        return false;
+      }
+      this.usedPayments.add(normalizedHash);
+      logger3.info("Payment verified successfully", {
+        txHash,
+        sender: tx.from,
+        amount: _ethers.ethers.formatEther(tx.value)
+      });
+      return true;
+    } catch (error) {
+      logger3.error("Payment verification error", { txHash, error: error.message });
+      return false;
+    }
+  }
+}, _class2);
 
 // src/a2a/WorldA2AClient.ts
 var _core = require('@moltium/core');
-var logger4 = _chunkDHQFXIEWcjs.createLogger.call(void 0, "WorldA2AClient");
-var WorldA2AClient = (_class2 = class {constructor() { _class2.prototype.__init4.call(this); }
-  __init4() {this.clients = /* @__PURE__ */ new Map()}
+var logger4 = _chunkWI7EASJJcjs.createLogger.call(void 0, "WorldA2AClient");
+var WorldA2AClient = (_class3 = class {constructor() { _class3.prototype.__init5.call(this); }
+  __init5() {this.clients = /* @__PURE__ */ new Map()}
   /**
    * Add an agent to the client pool
    */
@@ -827,7 +899,7 @@ var WorldA2AClient = (_class2 = class {constructor() { _class2.prototype.__init4
       logger4.error(`Failed to send A2A message to ${agentUrl}:`, error);
       return {
         success: false,
-        error: _optionalChain([error, 'optionalAccess', _13 => _13.message]) || String(error),
+        error: _optionalChain([error, 'optionalAccess', _16 => _16.message]) || String(error),
         agentUrl
       };
     }
@@ -879,12 +951,12 @@ var WorldA2AClient = (_class2 = class {constructor() { _class2.prototype.__init4
       return url;
     }
   }
-}, _class2);
+}, _class3);
 
 // src/engine/WorldActions.ts
-var logger5 = _chunkDHQFXIEWcjs.createLogger.call(void 0, "WorldActions");
-var WorldActionsRegistry = (_class3 = class {constructor() { _class3.prototype.__init5.call(this); }
-  __init5() {this.actions = /* @__PURE__ */ new Map()}
+var logger5 = _chunkWI7EASJJcjs.createLogger.call(void 0, "WorldActions");
+var WorldActionsRegistry = (_class4 = class {constructor() { _class4.prototype.__init6.call(this); }
+  __init6() {this.actions = /* @__PURE__ */ new Map()}
   /**
    * Register a world action
    */
@@ -974,11 +1046,11 @@ var WorldActionsRegistry = (_class3 = class {constructor() { _class3.prototype._
       ...a.parameters && { parameters: a.parameters }
     }));
   }
-}, _class3);
+}, _class4);
 
 // src/engine/ActionProcessor.ts
 
-var logger6 = _chunkDHQFXIEWcjs.createLogger.call(void 0, "ActionProcessor");
+var logger6 = _chunkWI7EASJJcjs.createLogger.call(void 0, "ActionProcessor");
 var ActionProcessor = class {
   constructor(rules, actionsRegistry) {
     this.rules = rules;
@@ -1080,16 +1152,16 @@ var ActionProcessor = class {
 
 // src/engine/TickOrchestrator.ts
 
-var logger7 = _chunkDHQFXIEWcjs.createLogger.call(void 0, "TickOrchestrator");
+var logger7 = _chunkWI7EASJJcjs.createLogger.call(void 0, "TickOrchestrator");
 var TickOrchestrator = class {
   constructor(a2aClient, actionsRegistry, rules, config) {
     this.a2aClient = a2aClient;
     this.actionsRegistry = actionsRegistry;
     this.actionProcessor = new ActionProcessor(rules, actionsRegistry);
     this.orchestrationConfig = {
-      broadcastOnTick: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _14 => _14.broadcastOnTick]), () => ( true)),
-      tickTimeout: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _15 => _15.tickTimeout]), () => ( 1e4)),
-      promptTemplate: _optionalChain([config, 'optionalAccess', _16 => _16.promptTemplate])
+      broadcastOnTick: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _17 => _17.broadcastOnTick]), () => ( true)),
+      tickTimeout: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _18 => _18.tickTimeout]), () => ( 1e4)),
+      promptTemplate: _optionalChain([config, 'optionalAccess', _19 => _19.promptTemplate])
     };
   }
   
@@ -1245,31 +1317,72 @@ var TickOrchestrator = class {
 };
 
 // src/a2a/MessageRouter.ts
-var logger8 = _chunkDHQFXIEWcjs.createLogger.call(void 0, "MessageRouter");
+var logger8 = _chunkWI7EASJJcjs.createLogger.call(void 0, "MessageRouter");
+var c = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  blue: "\x1B[34m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  magenta: "\x1B[35m",
+  cyan: "\x1B[36m",
+  red: "\x1B[31m",
+  gray: "\x1B[90m"
+};
 var MessageRouter = class {
   constructor(a2aClient, getAgents) {
     this.a2aClient = a2aClient;
     this.getAgents = getAgents;
   }
+  /**
+   * Extract base URL (protocol://host:port) from a full URL for comparison.
+   * Agent cards use full URLs (e.g. http://localhost:3001/a2a/jsonrpc)
+   * while agents send base URLs (e.g. http://localhost:3001).
+   */
+  extractBaseUrl(url) {
+    try {
+      const parsed = new URL(url);
+      return `${parsed.protocol}//${parsed.host}`;
+    } catch (e6) {
+      return url;
+    }
+  }
+  /**
+   * Find an agent by URL, normalizing both sides to base URL for comparison
+   */
+  findAgent(agents, url) {
+    const baseUrl = this.extractBaseUrl(url);
+    return agents.find((a) => this.extractBaseUrl(a.url) === baseUrl);
+  }
   /**
    * Route a message from one agent to another
    */
   async route(fromAgentUrl, toAgentUrl, message) {
     const agents = this.getAgents();
-    const sender = agents.find((a) => a.url === fromAgentUrl);
+    const sender = this.findAgent(agents, fromAgentUrl);
     if (!sender) {
+      logger8.warn(`Message rejected \u2014 sender not in world: ${fromAgentUrl}`);
       return {
         success: false,
         error: `Sender not in world: ${fromAgentUrl}`
       };
     }
-    const recipient = agents.find((a) => a.url === toAgentUrl);
+    const recipient = this.findAgent(agents, toAgentUrl);
     if (!recipient) {
+      logger8.warn(`Message rejected \u2014 recipient not in world: ${toAgentUrl}`);
       return {
         success: false,
         error: `Recipient not in world: ${toAgentUrl}`
       };
     }
+    console.log(
+      `
+${c.cyan}\u2501\u2501\u2501 MESSAGE \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501${c.reset}
+${c.bold}${c.blue}${sender.name}${c.reset} ${c.dim}\u2192${c.reset} ${c.bold}${c.green}${recipient.name}${c.reset}
+${c.dim}\u2502${c.reset} ${this.truncate(message, 300)}
+${c.cyan}\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501${c.reset}`
+    );
     const wrappedMessage = JSON.stringify({
       type: "world_message",
       from: {
@@ -1279,19 +1392,33 @@ var MessageRouter = class {
       },
       message
     });
-    logger8.info(`Routing message: ${sender.name} \u2192 ${recipient.name}`);
-    return this.a2aClient.sendToAgent(toAgentUrl, wrappedMessage, {
+    const response = await this.a2aClient.sendToAgent(toAgentUrl, wrappedMessage, {
       type: "world_message",
       fromAgentUrl
     });
+    if (response.success && response.reply) {
+      console.log(
+        `
+${c.green}\u2501\u2501\u2501 REPLY \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501${c.reset}
+${c.bold}${c.green}${recipient.name}${c.reset} ${c.dim}\u2192${c.reset} ${c.bold}${c.blue}${sender.name}${c.reset}
+${c.dim}\u2502${c.reset} ${this.truncate(response.reply, 300)}
+${c.green}\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501${c.reset}`
+      );
+    } else if (!response.success) {
+      console.log(
+        `${c.red}  \u2717 ${recipient.name} failed to respond: ${response.error || "no response"}${c.reset}`
+      );
+    }
+    return response;
   }
   /**
    * Broadcast a message from one agent to all other agents in the world
    */
   async routeToAll(fromAgentUrl, message) {
     const agents = this.getAgents();
-    const sender = agents.find((a) => a.url === fromAgentUrl);
+    const sender = this.findAgent(agents, fromAgentUrl);
     if (!sender) {
+      logger8.warn(`Broadcast rejected \u2014 sender not in world: ${fromAgentUrl}`);
       const result = /* @__PURE__ */ new Map();
       result.set(fromAgentUrl, {
         success: false,
@@ -1299,6 +1426,15 @@ var MessageRouter = class {
       });
       return result;
     }
+    const senderBaseUrl = this.extractBaseUrl(fromAgentUrl);
+    const recipients = agents.filter((a) => this.extractBaseUrl(a.url) !== senderBaseUrl);
+    console.log(
+      `
+${c.yellow}\u2501\u2501\u2501 BROADCAST \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501${c.reset}
+${c.bold}${c.blue}${sender.name}${c.reset} ${c.dim}\u2192${c.reset} ${c.bold}${c.yellow}ALL (${recipients.length} agents)${c.reset}
+${c.dim}\u2502${c.reset} ${this.truncate(message, 300)}
+${c.yellow}\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501${c.reset}`
+    );
     const wrappedMessage = JSON.stringify({
       type: "world_broadcast",
       from: {
@@ -1309,7 +1445,6 @@ var MessageRouter = class {
       message
     });
     const results = /* @__PURE__ */ new Map();
-    const recipients = agents.filter((a) => a.url !== fromAgentUrl);
     const promises = recipients.map(async (recipient) => {
       const response = await this.a2aClient.sendToAgent(
         recipient.url,
@@ -1317,17 +1452,38 @@ var MessageRouter = class {
         { type: "world_broadcast", fromAgentUrl }
       );
       results.set(recipient.url, response);
+      if (response.success && response.reply) {
+        console.log(
+          `${c.green}  \u21A9 ${c.bold}${recipient.name}${c.reset}${c.green} replied:${c.reset} ${this.truncate(response.reply, 200)}`
+        );
+      } else if (!response.success) {
+        console.log(
+          `${c.red}  \u2717 ${recipient.name} failed: ${response.error || "no response"}${c.reset}`
+        );
+      }
     });
     await Promise.allSettled(promises);
-    logger8.info(`Broadcast from ${sender.name} to ${recipients.length} agents`);
+    const succeeded = Array.from(results.values()).filter((r) => r.success).length;
+    const failed = Array.from(results.values()).filter((r) => !r.success).length;
+    console.log(
+      `${c.dim}  Broadcast complete: ${c.green}${succeeded} replied${c.reset}${c.dim}${failed > 0 ? `, ${c.red}${failed} failed${c.reset}` : ""}${c.reset}
+`
+    );
     return results;
   }
+  /**
+   * Truncate long messages for logging
+   */
+  truncate(text, maxLen) {
+    if (text.length <= maxLen) return text;
+    return text.slice(0, maxLen) + "...";
+  }
 };
 
 // src/engine/World.ts
-var logger9 = _chunkDHQFXIEWcjs.createLogger.call(void 0, "World");
-var World = (_class4 = class {
-  constructor(config) {;_class4.prototype.__init6.call(this);_class4.prototype.__init7.call(this);_class4.prototype.__init8.call(this);_class4.prototype.__init9.call(this);
+var logger9 = _chunkWI7EASJJcjs.createLogger.call(void 0, "World");
+var World = (_class5 = class {
+  constructor(config) {;_class5.prototype.__init7.call(this);_class5.prototype.__init8.call(this);_class5.prototype.__init9.call(this);_class5.prototype.__init10.call(this);
     this.config = config;
     validateWorldConfig(config);
     this.state = {
@@ -1338,7 +1494,7 @@ var World = (_class4 = class {
       metadata: {}
     };
     this.agents = /* @__PURE__ */ new Map();
-    this.cardFetcher = new (0, _chunkDHQFXIEWcjs.CardFetcher)();
+    this.cardFetcher = new (0, _chunkWI7EASJJcjs.CardFetcher)();
     this.evaluator = new AgentEvaluator(config.admission);
     this.a2aClient = new WorldA2AClient();
     this.actionsRegistry = new WorldActionsRegistry();
@@ -1359,17 +1515,17 @@ var World = (_class4 = class {
     logger9.info(`World "${config.name}" created`, {
       type: config.type || "generic",
       maxAgents: config.admission.maxAgents,
-      orchestration: !!_optionalChain([config, 'access', _17 => _17.orchestration, 'optionalAccess', _18 => _18.broadcastOnTick])
+      orchestration: !!_optionalChain([config, 'access', _20 => _20.orchestration, 'optionalAccess', _21 => _21.broadcastOnTick])
     });
   }
   
   
-  __init6() {this.persistence = null}
-  __init7() {this.blockchainClient = null}
+  __init7() {this.persistence = null}
+  __init8() {this.blockchainClient = null}
   
   
-  __init8() {this.tickInterval = null}
-  __init9() {this.autoSaveInterval = null}
+  __init9() {this.tickInterval = null}
+  __init10() {this.autoSaveInterval = null}
   // Agent-World bridge components
   
   
@@ -1425,7 +1581,7 @@ var World = (_class4 = class {
       this.setState("ready");
       logger9.info("World initialized successfully", {
         agents: this.agents.size,
-        persistence: _optionalChain([this, 'access', _19 => _19.config, 'access', _20 => _20.persistence, 'optionalAccess', _21 => _21.type]) || "none"
+        persistence: _optionalChain([this, 'access', _22 => _22.config, 'access', _23 => _23.persistence, 'optionalAccess', _24 => _24.type]) || "none"
       });
     } catch (error) {
       logger9.error("Failed to initialize world:", error);
@@ -1448,7 +1604,7 @@ var World = (_class4 = class {
       type: "world_started",
       timestamp: Date.now()
     });
-    if (_optionalChain([this, 'access', _22 => _22.config, 'access', _23 => _23.simulation, 'optionalAccess', _24 => _24.tickIntervalMs])) {
+    if (_optionalChain([this, 'access', _25 => _25.config, 'access', _26 => _26.simulation, 'optionalAccess', _27 => _27.tickIntervalMs])) {
       this.startTicking();
     }
   }
@@ -1476,24 +1632,61 @@ var World = (_class4 = class {
     });
     logger9.info("World stopped");
   }
+  /**
+   * Get the blockchain client (for server endpoints)
+   */
+  getBlockchainClient() {
+    return this.blockchainClient;
+  }
   /**
    * Admit an agent to the world
    */
-  async admitAgent(card, walletAddress) {
+  async admitAgent(card, walletAddress, paymentTxHash) {
+    if (this.agents.has(card.url)) {
+      logger9.info(`Agent already in world, skipping re-admission: ${card.name}`);
+      return;
+    }
     const decision = await this.evaluator.evaluate(card, this.agents.size, walletAddress);
     if (!decision.admitted) {
       throw new Error(`Agent admission denied: ${decision.reason}`);
     }
-    if (this.blockchainClient && _optionalChain([this, 'access', _25 => _25.config, 'access', _26 => _26.blockchain, 'optionalAccess', _27 => _27.enforceOnChainValidation]) && walletAddress) {
+    if (this.blockchainClient && _optionalChain([this, 'access', _28 => _28.config, 'access', _29 => _29.blockchain, 'optionalAccess', _30 => _30.enforceOnChainValidation]) && walletAddress) {
       const isValid = await this.blockchainClient.validateAgent(walletAddress);
       if (!isValid) {
         throw new Error("Agent not registered in on-chain AgentRegistry");
       }
       logger9.info(`Agent validated on-chain: ${card.name}`);
     }
-    if (this.blockchainClient && _optionalChain([this, 'access', _28 => _28.config, 'access', _29 => _29.blockchain, 'optionalAccess', _30 => _30.requireMembership]) && walletAddress) {
+    if (this.blockchainClient && _optionalChain([this, 'access', _31 => _31.config, 'access', _32 => _32.blockchain, 'optionalAccess', _33 => _33.requireMembership])) {
+      if (!walletAddress) {
+        throw new Error(
+          "This world requires blockchain membership. Provide a walletAddress when joining. Set AGENT_WALLET_PRIVATE_KEY in your .env file to auto-derive a wallet address."
+        );
+      }
       const hasMembership = await this.blockchainClient.hasMembership(walletAddress);
       if (!hasMembership) {
+        const entryFeeWei = await this.blockchainClient.getEntryFeeWei();
+        if (entryFeeWei !== "0" && BigInt(entryFeeWei) > 0n) {
+          if (!paymentTxHash) {
+            throw new Error(
+              `Entry fee required: ${entryFeeWei} wei. Query GET /world/join-info for payment details, pay the fee, then include paymentTxHash in your join request.`
+            );
+          }
+          const paymentValid = await this.blockchainClient.verifyPayment(
+            paymentTxHash,
+            walletAddress,
+            entryFeeWei
+          );
+          if (!paymentValid) {
+            throw new Error(
+              `Payment verification failed for tx ${paymentTxHash}. Ensure the transaction is confirmed, sent from ${walletAddress}, to ${this.blockchainClient.getWalletAddress()}, for at least ${entryFeeWei} wei.`
+            );
+          }
+          logger9.info(`Entry fee payment verified for ${card.name}`, {
+            txHash: paymentTxHash,
+            amount: entryFeeWei
+          });
+        }
         logger9.info(`Minting membership NFT for agent: ${card.name}`);
         await this.blockchainClient.mintMembership(walletAddress);
       } else {
@@ -1599,7 +1792,7 @@ var World = (_class4 = class {
    * Start auto-save interval
    */
   startAutoSave() {
-    const interval = _optionalChain([this, 'access', _31 => _31.config, 'access', _32 => _32.persistence, 'optionalAccess', _33 => _33.autoSaveIntervalMs]) || 1e4;
+    const interval = _optionalChain([this, 'access', _34 => _34.config, 'access', _35 => _35.persistence, 'optionalAccess', _36 => _36.autoSaveIntervalMs]) || 1e4;
     this.autoSaveInterval = setInterval(async () => {
       if (this.persistence) {
         await this.persistence.saveState(this.state);
@@ -1635,22 +1828,22 @@ var World = (_class4 = class {
           id: _uuid.v4.call(void 0, ),
           type: "tick_error",
           timestamp: Date.now(),
-          data: { tick: this.state.tick, error: _optionalChain([error, 'optionalAccess', _34 => _34.message]) || String(error) }
+          data: { tick: this.state.tick, error: _optionalChain([error, 'optionalAccess', _37 => _37.message]) || String(error) }
         });
       }
       logger9.debug(`Tick ${this.state.tick}`);
-      if (_optionalChain([this, 'access', _35 => _35.config, 'access', _36 => _36.simulation, 'optionalAccess', _37 => _37.maxTicks]) && this.state.tick >= this.config.simulation.maxTicks) {
+      if (_optionalChain([this, 'access', _38 => _38.config, 'access', _39 => _39.simulation, 'optionalAccess', _40 => _40.maxTicks]) && this.state.tick >= this.config.simulation.maxTicks) {
         logger9.info("Max ticks reached, stopping world");
         await this.stop();
       }
     }, interval);
     logger9.info(`Simulation ticking enabled (interval: ${interval}ms)`);
   }
-}, _class4);
+}, _class5);
 
 // src/server/app.ts
 var _express = require('express'); var _express2 = _interopRequireDefault(_express);
-var logger10 = _chunkDHQFXIEWcjs.createLogger.call(void 0, "WorldServer");
+var logger10 = _chunkWI7EASJJcjs.createLogger.call(void 0, "WorldServer");
 function createWorldApp(world) {
   const app = _express2.default.call(void 0, );
   app.use(_express2.default.json());
@@ -1677,9 +1870,40 @@ function createWorldApp(world) {
       }
     });
   });
+  app.get("/world/join-info", async (req, res) => {
+    try {
+      const blockchain = world.config.blockchain;
+      const client = world.getBlockchainClient();
+      if (!blockchain || !client) {
+        return res.json({
+          worldName: world.config.name,
+          requiresPayment: false,
+          entryFee: "0",
+          paymentAddress: null,
+          chainId: null,
+          rpcUrl: null
+        });
+      }
+      const entryFeeWei = await client.getEntryFeeWei();
+      res.json({
+        worldName: world.config.name,
+        requiresPayment: entryFeeWei !== "0" && BigInt(entryFeeWei) > 0n,
+        entryFee: entryFeeWei,
+        paymentAddress: client.getWalletAddress(),
+        chainId: blockchain.chainId || null,
+        rpcUrl: blockchain.rpcUrl
+      });
+    } catch (error) {
+      logger10.error("Failed to get join info:", error);
+      res.status(500).json({
+        success: false,
+        error: error.message || "Failed to get join info"
+      });
+    }
+  });
   app.post("/world/join", async (req, res) => {
     try {
-      const { agentUrl, walletAddress } = req.body;
+      const { agentUrl, walletAddress, paymentTxHash } = req.body;
       if (!agentUrl) {
         return res.status(400).json({
           success: false,
@@ -1687,9 +1911,10 @@ function createWorldApp(world) {
         });
       }
       logger10.info(`Agent join request from: ${agentUrl}`, {
-        wallet: walletAddress || "none"
+        wallet: walletAddress || "none",
+        paymentTx: paymentTxHash ? `${paymentTxHash.slice(0, 10)}...` : "none"
       });
-      const cardFetcher = new (await Promise.resolve().then(() => _interopRequireWildcard(require("./CardFetcher-UCJGPZ7X.cjs")))).CardFetcher();
+      const cardFetcher = new (await Promise.resolve().then(() => _interopRequireWildcard(require("./CardFetcher-ZD4YSGJE.cjs")))).CardFetcher();
       const result = await cardFetcher.fetchCard(agentUrl);
       if (!result.success || !result.card) {
         return res.status(400).json({
@@ -1697,7 +1922,7 @@ function createWorldApp(world) {
           error: `Failed to fetch agent card: ${result.error}`
         });
       }
-      await world.admitAgent(result.card, walletAddress);
+      await world.admitAgent(result.card, walletAddress, paymentTxHash);
       res.json({
         success: true,
         message: "Agent admitted to world",
@@ -1855,6 +2080,7 @@ async function startWorldServer(world) {
     logger10.info("");
     logger10.info("Endpoints:");
     logger10.info(`  GET    /                    - World info`);
+    logger10.info(`  GET    /world/join-info     - Join requirements & entry fee`);
     logger10.info(`  POST   /world/join          - Agent join request`);
     logger10.info(`  GET    /world/agents        - List agents`);
     logger10.info(`  GET    /world/state         - World state`);
@@ -1904,5 +2130,5 @@ async function startWorldServer(world) {
 
 
 
-exports.ActionProcessor = ActionProcessor; exports.AdmissionRulesSchema = AdmissionRulesSchema; exports.AgentEvaluator = AgentEvaluator; exports.BlockchainClient = BlockchainClient; exports.BlockchainConfigSchema = BlockchainConfigSchema; exports.CardFetcher = _chunkDHQFXIEWcjs.CardFetcher; exports.InMemoryAdapter = InMemoryAdapter; exports.MessageRouter = MessageRouter; exports.PersistenceConfigSchema = PersistenceConfigSchema; exports.TickOrchestrator = TickOrchestrator; exports.TokenConfigSchema = TokenConfigSchema; exports.World = World; exports.WorldA2AClient = WorldA2AClient; exports.WorldActionsRegistry = WorldActionsRegistry; exports.WorldConfigSchema = WorldConfigSchema; exports.createLogger = _chunkDHQFXIEWcjs.createLogger; exports.createPersistence = createPersistence; exports.createWorldApp = createWorldApp; exports.isValidWorldConfig = isValidWorldConfig; exports.logger = _chunkDHQFXIEWcjs.logger; exports.normalizeAgentUrl = _chunkDHQFXIEWcjs.normalizeAgentUrl; exports.profileFromCard = profileFromCard; exports.startWorldServer = startWorldServer; exports.validateWorldConfig = validateWorldConfig;
+exports.ActionProcessor = ActionProcessor; exports.AdmissionRulesSchema = AdmissionRulesSchema; exports.AgentEvaluator = AgentEvaluator; exports.BlockchainClient = BlockchainClient; exports.BlockchainConfigSchema = BlockchainConfigSchema; exports.CardFetcher = _chunkWI7EASJJcjs.CardFetcher; exports.InMemoryAdapter = InMemoryAdapter; exports.MessageRouter = MessageRouter; exports.PersistenceConfigSchema = PersistenceConfigSchema; exports.TickOrchestrator = TickOrchestrator; exports.TokenConfigSchema = TokenConfigSchema; exports.World = World; exports.WorldA2AClient = WorldA2AClient; exports.WorldActionsRegistry = WorldActionsRegistry; exports.WorldConfigSchema = WorldConfigSchema; exports.createLogger = _chunkWI7EASJJcjs.createLogger; exports.createPersistence = createPersistence; exports.createWorldApp = createWorldApp; exports.isValidWorldConfig = isValidWorldConfig; exports.logger = _chunkWI7EASJJcjs.logger; exports.normalizeAgentUrl = _chunkWI7EASJJcjs.normalizeAgentUrl; exports.profileFromCard = profileFromCard; exports.startWorldServer = startWorldServer; exports.validateWorldConfig = validateWorldConfig;
 //# sourceMappingURL=index.cjs.map