@moltium/world-core 0.1.22 → 0.1.24

package/dist/index.d.cts

@@ -1157,6 +1157,82 @@ declare const logger: winston.Logger;
  */
 declare function createLogger(moduleName: string): winston.Logger;
 
+/**
+ * ============================================================================
+ * BLOCKCHAIN CLIENT
+ * ============================================================================
+ *
+ * Handles all blockchain interactions for the World SDK:
+ * - Agent registry validation
+ * - Membership NFT minting
+ * - Entry fee collection
+ * - World token operations
+ */
+declare class BlockchainClient {
+    private config;
+    private provider;
+    private wallet;
+    private agentRegistry?;
+    private membershipContract?;
+    private worldToken?;
+    constructor(config: BlockchainConfig);
+    /**
+     * Initialize contract connections
+     */
+    init(): Promise<void>;
+    /**
+     * Validate agent on-chain
+     * @param walletAddress Agent's wallet address
+     * @returns True if agent is registered and valid
+     */
+    validateAgent(walletAddress: string): Promise<boolean>;
+    /**
+     * Mint membership NFT for an agent
+     * @param agentWallet Agent's wallet address
+     * @returns Transaction hash
+     */
+    mintMembership(agentWallet: string): Promise<string>;
+    /**
+     * Check if agent has membership
+     * @param agentWallet Agent's wallet address
+     * @returns True if agent has membership
+     */
+    hasMembership(agentWallet: string): Promise<boolean>;
+    /**
+     * Revoke membership NFT
+     * @param agentWallet Agent's wallet address
+     * @returns Transaction hash
+     */
+    revokeMembership(agentWallet: string): Promise<string>;
+    /**
+     * Get total number of members
+     */
+    getTotalMembers(): Promise<number>;
+    /**
+     * Withdraw collected entry fees (world owner only)
+     */
+    withdrawFees(): Promise<string>;
+    /**
+     * Get world owner's wallet address
+     */
+    getWalletAddress(): string;
+    /**
+     * Get entry fee in MON (formatted)
+     */
+    getEntryFee(): Promise<string>;
+    /**
+     * Get entry fee in wei (raw BigInt string)
+     */
+    getEntryFeeWei(): Promise<string>;
+    private usedPayments;
+    /**
+     * 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.
+     */
+    verifyPayment(txHash: string, expectedSender: string, expectedAmountWei: string): Promise<boolean>;
+}
+
 /**
  * ============================================================================
  * WORLD ACTION DEFINITIONS
@@ -1283,6 +1359,16 @@ declare class MessageRouter {
     private a2aClient;
     private getAgents;
     constructor(a2aClient: WorldA2AClient, getAgents: () => AgentProfile[]);
+    /**
+     * 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).
+     */
+    private extractBaseUrl;
+    /**
+     * Find an agent by URL, normalizing both sides to base URL for comparison
+     */
+    private findAgent;
     /**
      * Route a message from one agent to another
      */
@@ -1291,6 +1377,10 @@ declare class MessageRouter {
      * Broadcast a message from one agent to all other agents in the world
      */
     routeToAll(fromAgentUrl: string, message: string): Promise<Map<string, A2AMessageResponse>>;
+    /**
+     * Truncate long messages for logging
+     */
+    private truncate;
 }
 
 /**
@@ -1332,10 +1422,14 @@ declare class World {
      * Stop the world simulation
      */
     stop(): Promise<void>;
+    /**
+     * Get the blockchain client (for server endpoints)
+     */
+    getBlockchainClient(): BlockchainClient | null;
     /**
      * Admit an agent to the world
      */
-    admitAgent(card: any, walletAddress?: string): Promise<void>;
+    admitAgent(card: any, walletAddress?: string, paymentTxHash?: string): Promise<void>;
     /**
      * Remove an agent from the world
      */
@@ -1448,71 +1542,6 @@ declare class AgentEvaluator {
     private meetsProtocolVersion;
 }
 
-/**
- * ============================================================================
- * BLOCKCHAIN CLIENT
- * ============================================================================
- *
- * Handles all blockchain interactions for the World SDK:
- * - Agent registry validation
- * - Membership NFT minting
- * - Entry fee collection
- * - World token operations
- */
-declare class BlockchainClient {
-    private config;
-    private provider;
-    private wallet;
-    private agentRegistry?;
-    private membershipContract?;
-    private worldToken?;
-    constructor(config: BlockchainConfig);
-    /**
-     * Initialize contract connections
-     */
-    init(): Promise<void>;
-    /**
-     * Validate agent on-chain
-     * @param walletAddress Agent's wallet address
-     * @returns True if agent is registered and valid
-     */
-    validateAgent(walletAddress: string): Promise<boolean>;
-    /**
-     * Mint membership NFT for an agent
-     * @param agentWallet Agent's wallet address
-     * @returns Transaction hash
-     */
-    mintMembership(agentWallet: string): Promise<string>;
-    /**
-     * Check if agent has membership
-     * @param agentWallet Agent's wallet address
-     * @returns True if agent has membership
-     */
-    hasMembership(agentWallet: string): Promise<boolean>;
-    /**
-     * Revoke membership NFT
-     * @param agentWallet Agent's wallet address
-     * @returns Transaction hash
-     */
-    revokeMembership(agentWallet: string): Promise<string>;
-    /**
-     * Get total number of members
-     */
-    getTotalMembers(): Promise<number>;
-    /**
-     * Withdraw collected entry fees (world owner only)
-     */
-    withdrawFees(): Promise<string>;
-    /**
-     * Get world owner's wallet address
-     */
-    getWalletAddress(): string;
-    /**
-     * Get entry fee in MON
-     */
-    getEntryFee(): Promise<string>;
-}
-
 /**
  * ============================================================================
  * ACTION PROCESSOR

package/dist/index.d.ts

@@ -1157,6 +1157,82 @@ declare const logger: winston.Logger;
  */
 declare function createLogger(moduleName: string): winston.Logger;
 
+/**
+ * ============================================================================
+ * BLOCKCHAIN CLIENT
+ * ============================================================================
+ *
+ * Handles all blockchain interactions for the World SDK:
+ * - Agent registry validation
+ * - Membership NFT minting
+ * - Entry fee collection
+ * - World token operations
+ */
+declare class BlockchainClient {
+    private config;
+    private provider;
+    private wallet;
+    private agentRegistry?;
+    private membershipContract?;
+    private worldToken?;
+    constructor(config: BlockchainConfig);
+    /**
+     * Initialize contract connections
+     */
+    init(): Promise<void>;
+    /**
+     * Validate agent on-chain
+     * @param walletAddress Agent's wallet address
+     * @returns True if agent is registered and valid
+     */
+    validateAgent(walletAddress: string): Promise<boolean>;
+    /**
+     * Mint membership NFT for an agent
+     * @param agentWallet Agent's wallet address
+     * @returns Transaction hash
+     */
+    mintMembership(agentWallet: string): Promise<string>;
+    /**
+     * Check if agent has membership
+     * @param agentWallet Agent's wallet address
+     * @returns True if agent has membership
+     */
+    hasMembership(agentWallet: string): Promise<boolean>;
+    /**
+     * Revoke membership NFT
+     * @param agentWallet Agent's wallet address
+     * @returns Transaction hash
+     */
+    revokeMembership(agentWallet: string): Promise<string>;
+    /**
+     * Get total number of members
+     */
+    getTotalMembers(): Promise<number>;
+    /**
+     * Withdraw collected entry fees (world owner only)
+     */
+    withdrawFees(): Promise<string>;
+    /**
+     * Get world owner's wallet address
+     */
+    getWalletAddress(): string;
+    /**
+     * Get entry fee in MON (formatted)
+     */
+    getEntryFee(): Promise<string>;
+    /**
+     * Get entry fee in wei (raw BigInt string)
+     */
+    getEntryFeeWei(): Promise<string>;
+    private usedPayments;
+    /**
+     * 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.
+     */
+    verifyPayment(txHash: string, expectedSender: string, expectedAmountWei: string): Promise<boolean>;
+}
+
 /**
  * ============================================================================
  * WORLD ACTION DEFINITIONS
@@ -1283,6 +1359,16 @@ declare class MessageRouter {
     private a2aClient;
     private getAgents;
     constructor(a2aClient: WorldA2AClient, getAgents: () => AgentProfile[]);
+    /**
+     * 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).
+     */
+    private extractBaseUrl;
+    /**
+     * Find an agent by URL, normalizing both sides to base URL for comparison
+     */
+    private findAgent;
     /**
      * Route a message from one agent to another
      */
@@ -1291,6 +1377,10 @@ declare class MessageRouter {
      * Broadcast a message from one agent to all other agents in the world
      */
     routeToAll(fromAgentUrl: string, message: string): Promise<Map<string, A2AMessageResponse>>;
+    /**
+     * Truncate long messages for logging
+     */
+    private truncate;
 }
 
 /**
@@ -1332,10 +1422,14 @@ declare class World {
      * Stop the world simulation
      */
     stop(): Promise<void>;
+    /**
+     * Get the blockchain client (for server endpoints)
+     */
+    getBlockchainClient(): BlockchainClient | null;
     /**
      * Admit an agent to the world
      */
-    admitAgent(card: any, walletAddress?: string): Promise<void>;
+    admitAgent(card: any, walletAddress?: string, paymentTxHash?: string): Promise<void>;
     /**
      * Remove an agent from the world
      */
@@ -1448,71 +1542,6 @@ declare class AgentEvaluator {
     private meetsProtocolVersion;
 }
 
-/**
- * ============================================================================
- * BLOCKCHAIN CLIENT
- * ============================================================================
- *
- * Handles all blockchain interactions for the World SDK:
- * - Agent registry validation
- * - Membership NFT minting
- * - Entry fee collection
- * - World token operations
- */
-declare class BlockchainClient {
-    private config;
-    private provider;
-    private wallet;
-    private agentRegistry?;
-    private membershipContract?;
-    private worldToken?;
-    constructor(config: BlockchainConfig);
-    /**
-     * Initialize contract connections
-     */
-    init(): Promise<void>;
-    /**
-     * Validate agent on-chain
-     * @param walletAddress Agent's wallet address
-     * @returns True if agent is registered and valid
-     */
-    validateAgent(walletAddress: string): Promise<boolean>;
-    /**
-     * Mint membership NFT for an agent
-     * @param agentWallet Agent's wallet address
-     * @returns Transaction hash
-     */
-    mintMembership(agentWallet: string): Promise<string>;
-    /**
-     * Check if agent has membership
-     * @param agentWallet Agent's wallet address
-     * @returns True if agent has membership
-     */
-    hasMembership(agentWallet: string): Promise<boolean>;
-    /**
-     * Revoke membership NFT
-     * @param agentWallet Agent's wallet address
-     * @returns Transaction hash
-     */
-    revokeMembership(agentWallet: string): Promise<string>;
-    /**
-     * Get total number of members
-     */
-    getTotalMembers(): Promise<number>;
-    /**
-     * Withdraw collected entry fees (world owner only)
-     */
-    withdrawFees(): Promise<string>;
-    /**
-     * Get world owner's wallet address
-     */
-    getWalletAddress(): string;
-    /**
-     * Get entry fee in MON
-     */
-    getEntryFee(): Promise<string>;
-}
-
 /**
  * ============================================================================
  * ACTION PROCESSOR