@moltium/world-core 0.1.21 → 0.1.23

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
@@ -1264,6 +1340,10 @@ declare class WorldA2AClient {
      * Get all agent URLs in the pool
      */
     getAgentUrls(): string[];
+    /**
+     * Extract base URL (protocol://host:port) from a full URL
+     */
+    private extractBaseUrl;
 }
 
 /**
@@ -1287,6 +1367,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;
 }
 
 /**
@@ -1328,10 +1412,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
      */
@@ -1444,71 +1532,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
@@ -1264,6 +1340,10 @@ declare class WorldA2AClient {
      * Get all agent URLs in the pool
      */
     getAgentUrls(): string[];
+    /**
+     * Extract base URL (protocol://host:port) from a full URL
+     */
+    private extractBaseUrl;
 }
 
 /**
@@ -1287,6 +1367,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;
 }
 
 /**
@@ -1328,10 +1412,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
      */
@@ -1444,71 +1532,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