@mixrpay/agent-sdk 0.4.1 → 0.5.0

package/dist/index.cjs

@@ -353,6 +353,9 @@ async function createSessionAuthPayload(sessionKey) {
   };
 }
 
+// src/agent-wallet.ts
+var import_accounts2 = require("viem/accounts");
+
 // src/x402.ts
 async function parse402Response(response) {
   let paymentData = null;
@@ -442,7 +445,7 @@ function getAmountUsd(requirements) {
 }
 
 // src/agent-wallet.ts
-var SDK_VERSION = "0.4.1";
+var SDK_VERSION = "0.5.0";
 var DEFAULT_BASE_URL = process.env.MIXRPAY_BASE_URL || "https://www.mixrpay.com";
 var DEFAULT_TIMEOUT = 3e4;
 var NETWORKS = {
@@ -586,6 +589,237 @@ var AgentWallet = class {
     }
   }
   // ===========================================================================
+  // Static Agent Registration Methods
+  // ===========================================================================
+  /**
+   * Register a new agent with MixrPay.
+   * 
+   * This creates a Privy-managed embedded wallet for the agent's payments.
+   * The agent proves ownership of their external wallet by signing a challenge.
+   * 
+   * @param options - Registration options including the private key
+   * @returns Registration result with deposit address
+   * @throws {MixrPayError} If registration fails
+   * 
+   * @example
+   * ```typescript
+   * const { depositAddress, userId } = await AgentWallet.register({
+   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+   *   name: 'My Trading Agent',
+   * });
+   * 
+   * console.log(`Fund your agent at: ${depositAddress}`);
+   * ```
+   */
+  static async register(options) {
+    const { privateKey, name } = options;
+    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    const account = (0, import_accounts2.privateKeyToAccount)(privateKey);
+    const walletAddress = account.address;
+    const challengeResponse = await fetch(
+      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=register`
+    );
+    if (!challengeResponse.ok) {
+      const error = await challengeResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
+    }
+    const { challenge, message } = await challengeResponse.json();
+    const signature = await (0, import_accounts2.signMessage)({ message, privateKey });
+    const registerResponse = await fetch(`${baseUrl}/api/v1/agent/register`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        challenge,
+        external_wallet: walletAddress,
+        signature,
+        name
+      })
+    });
+    if (!registerResponse.ok) {
+      const error = await registerResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Registration failed: ${registerResponse.status}`);
+    }
+    const data = await registerResponse.json();
+    return {
+      userId: data.user_id,
+      depositAddress: data.deposit_address
+    };
+  }
+  /**
+   * Get a session key for an already-registered agent.
+   * 
+   * Session keys allow the agent to make payments within the specified limits.
+   * The private key is returned ONCE - store it securely!
+   * 
+   * @param options - Session key options
+   * @returns Session key result with the sk_live_ format key
+   * @throws {MixrPayError} If session key creation fails
+   * 
+   * @example
+   * ```typescript
+   * const result = await AgentWallet.getSessionKey({
+   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+   *   spendingLimitUsd: 100,
+   *   durationDays: 30,
+   * });
+   * 
+   * // Store this securely - it's your payment key!
+   * console.log(`Session key: ${result.sessionKey}`);
+   * 
+   * // Use it to create an AgentWallet
+   * const wallet = new AgentWallet({ sessionKey: result.sessionKey });
+   * ```
+   */
+  static async getSessionKey(options) {
+    const { privateKey, spendingLimitUsd, maxPerTxUsd, maxDailyUsd, durationDays } = options;
+    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    const account = (0, import_accounts2.privateKeyToAccount)(privateKey);
+    const walletAddress = account.address;
+    const challengeResponse = await fetch(
+      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=session-key`
+    );
+    if (!challengeResponse.ok) {
+      const error = await challengeResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
+    }
+    const { challenge, message } = await challengeResponse.json();
+    const signature = await (0, import_accounts2.signMessage)({ message, privateKey });
+    const sessionKeyResponse = await fetch(`${baseUrl}/api/v1/agent/session-key`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        challenge,
+        external_wallet: walletAddress,
+        signature,
+        spending_limit_usd: spendingLimitUsd,
+        max_per_tx_usd: maxPerTxUsd,
+        max_daily_usd: maxDailyUsd,
+        duration_days: durationDays
+      })
+    });
+    if (!sessionKeyResponse.ok) {
+      const error = await sessionKeyResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Session key creation failed: ${sessionKeyResponse.status}`);
+    }
+    const data = await sessionKeyResponse.json();
+    return {
+      sessionKey: data.session_key,
+      address: data.address,
+      sessionKeyId: data.session_key_id,
+      expiresAt: new Date(data.expires_at),
+      limits: {
+        maxTotalUsd: data.limits.max_total_usd,
+        maxPerTxUsd: data.limits.max_per_tx_usd,
+        maxDailyUsd: data.limits.max_daily_usd
+      }
+    };
+  }
+  /**
+   * Get the status of a registered agent.
+   * 
+   * Returns balance, active sessions, and spending information.
+   * 
+   * @param options - Status options
+   * @returns Agent status
+   * @throws {MixrPayError} If status fetch fails
+   * 
+   * @example
+   * ```typescript
+   * const status = await AgentWallet.getStatus({
+   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+   * });
+   * 
+   * console.log(`Balance: $${status.balanceUsd}`);
+   * console.log(`Active sessions: ${status.activeSessions.length}`);
+   * ```
+   */
+  static async getStatus(options) {
+    const { privateKey } = options;
+    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    const account = (0, import_accounts2.privateKeyToAccount)(privateKey);
+    const walletAddress = account.address;
+    const challengeResponse = await fetch(
+      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=status`
+    );
+    if (!challengeResponse.ok) {
+      const error = await challengeResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
+    }
+    const { challenge, message } = await challengeResponse.json();
+    const signature = await (0, import_accounts2.signMessage)({ message, privateKey });
+    const statusResponse = await fetch(
+      `${baseUrl}/api/v1/agent/status?challenge=${challenge}&external_wallet=${walletAddress}&signature=${encodeURIComponent(signature)}`
+    );
+    if (!statusResponse.ok) {
+      const error = await statusResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get status: ${statusResponse.status}`);
+    }
+    const data = await statusResponse.json();
+    return {
+      depositAddress: data.deposit_address,
+      balanceUsd: data.balance_usd,
+      activeSessions: data.active_sessions.map((s) => ({
+        id: s.id,
+        expiresAt: new Date(s.expires_at),
+        totalSpentUsd: s.total_spent_usd,
+        remainingUsd: s.remaining_usd,
+        maxTotalUsd: s.max_total_usd
+      })),
+      totalSpentUsd: data.total_spent_usd
+    };
+  }
+  /**
+   * Revoke a session key.
+   * 
+   * After revocation, the session key can no longer be used for payments.
+   * 
+   * @param options - Revoke options
+   * @returns true if revoked successfully
+   * @throws {MixrPayError} If revocation fails
+   * 
+   * @example
+   * ```typescript
+   * const success = await AgentWallet.revokeSessionKey({
+   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+   *   sessionKeyId: 'session-key-uuid',
+   * });
+   * 
+   * if (success) {
+   *   console.log('Session key revoked');
+   * }
+   * ```
+   */
+  static async revokeSessionKey(options) {
+    const { privateKey, sessionKeyId } = options;
+    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    const account = (0, import_accounts2.privateKeyToAccount)(privateKey);
+    const walletAddress = account.address;
+    const challengeResponse = await fetch(
+      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=revoke`
+    );
+    if (!challengeResponse.ok) {
+      const error = await challengeResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
+    }
+    const { challenge, message } = await challengeResponse.json();
+    const signature = await (0, import_accounts2.signMessage)({ message, privateKey });
+    const revokeResponse = await fetch(`${baseUrl}/api/v1/agent/session-key/revoke`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        challenge,
+        external_wallet: walletAddress,
+        signature,
+        session_key_id: sessionKeyId
+      })
+    });
+    if (!revokeResponse.ok) {
+      const error = await revokeResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Revocation failed: ${revokeResponse.status}`);
+    }
+    return true;
+  }
+  // ===========================================================================
   // Core Methods
   // ===========================================================================
   /**

package/dist/index.d.cts

@@ -359,7 +359,7 @@ interface SessionStats {
  */
 
 /** Current SDK version */
-declare const SDK_VERSION = "0.4.1";
+declare const SDK_VERSION = "0.5.0";
 /** Supported networks */
 declare const NETWORKS: {
     readonly BASE_MAINNET: {
@@ -373,6 +373,101 @@ declare const NETWORKS: {
         readonly isTestnet: true;
     };
 };
+/**
+ * Options for registering an agent
+ */
+interface AgentRegisterOptions {
+    /** The agent's external wallet private key (used for signing, NOT transmitted) */
+    privateKey: `0x${string}`;
+    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    baseUrl?: string;
+    /** Optional display name for the agent */
+    name?: string;
+}
+/**
+ * Result from agent registration
+ */
+interface AgentRegisterResult {
+    /** Internal user ID */
+    userId: string;
+    /** Address to fund the agent's payment wallet */
+    depositAddress: string;
+}
+/**
+ * Options for getting a session key
+ */
+interface AgentGetSessionKeyOptions {
+    /** The agent's external wallet private key (used for signing, NOT transmitted) */
+    privateKey: `0x${string}`;
+    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    baseUrl?: string;
+    /** Maximum total spending in USD (default: $25) */
+    spendingLimitUsd?: number;
+    /** Maximum per transaction in USD */
+    maxPerTxUsd?: number;
+    /** Maximum daily spending in USD */
+    maxDailyUsd?: number;
+    /** Session duration in days (default: 7, max: 365) */
+    durationDays?: number;
+}
+/**
+ * Result from getting a session key
+ */
+interface AgentGetSessionKeyResult {
+    /** The session key in sk_live_{hex} format - STORE SECURELY! */
+    sessionKey: string;
+    /** The derived public address */
+    address: string;
+    /** Session key database ID */
+    sessionKeyId: string;
+    /** When the session key expires */
+    expiresAt: Date;
+    /** Spending limits */
+    limits: {
+        maxTotalUsd: number | null;
+        maxPerTxUsd: number | null;
+        maxDailyUsd: number | null;
+    };
+}
+/**
+ * Options for getting agent status
+ */
+interface AgentGetStatusOptions {
+    /** The agent's external wallet private key (used for signing, NOT transmitted) */
+    privateKey: `0x${string}`;
+    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    baseUrl?: string;
+}
+/**
+ * Result from getting agent status
+ */
+interface AgentGetStatusResult {
+    /** Address of the agent's payment wallet */
+    depositAddress: string;
+    /** Current USDC balance in USD */
+    balanceUsd: number;
+    /** Active session keys */
+    activeSessions: Array<{
+        id: string;
+        expiresAt: Date;
+        totalSpentUsd: number;
+        remainingUsd: number | null;
+        maxTotalUsd: number | null;
+    }>;
+    /** Total spent across all sessions */
+    totalSpentUsd: number;
+}
+/**
+ * Options for revoking a session key
+ */
+interface AgentRevokeSessionKeyOptions {
+    /** The agent's external wallet private key (used for signing, NOT transmitted) */
+    privateKey: `0x${string}`;
+    /** The session key ID to revoke */
+    sessionKeyId: string;
+    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    baseUrl?: string;
+}
 type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'none';
 /**
  * A wallet wrapper for AI agents that handles x402 payments automatically.
@@ -454,6 +549,95 @@ declare class AgentWallet {
      * Validate the configuration before initialization.
      */
     private validateConfig;
+    /**
+     * Register a new agent with MixrPay.
+     *
+     * This creates a Privy-managed embedded wallet for the agent's payments.
+     * The agent proves ownership of their external wallet by signing a challenge.
+     *
+     * @param options - Registration options including the private key
+     * @returns Registration result with deposit address
+     * @throws {MixrPayError} If registration fails
+     *
+     * @example
+     * ```typescript
+     * const { depositAddress, userId } = await AgentWallet.register({
+     *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+     *   name: 'My Trading Agent',
+     * });
+     *
+     * console.log(`Fund your agent at: ${depositAddress}`);
+     * ```
+     */
+    static register(options: AgentRegisterOptions): Promise<AgentRegisterResult>;
+    /**
+     * Get a session key for an already-registered agent.
+     *
+     * Session keys allow the agent to make payments within the specified limits.
+     * The private key is returned ONCE - store it securely!
+     *
+     * @param options - Session key options
+     * @returns Session key result with the sk_live_ format key
+     * @throws {MixrPayError} If session key creation fails
+     *
+     * @example
+     * ```typescript
+     * const result = await AgentWallet.getSessionKey({
+     *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+     *   spendingLimitUsd: 100,
+     *   durationDays: 30,
+     * });
+     *
+     * // Store this securely - it's your payment key!
+     * console.log(`Session key: ${result.sessionKey}`);
+     *
+     * // Use it to create an AgentWallet
+     * const wallet = new AgentWallet({ sessionKey: result.sessionKey });
+     * ```
+     */
+    static getSessionKey(options: AgentGetSessionKeyOptions): Promise<AgentGetSessionKeyResult>;
+    /**
+     * Get the status of a registered agent.
+     *
+     * Returns balance, active sessions, and spending information.
+     *
+     * @param options - Status options
+     * @returns Agent status
+     * @throws {MixrPayError} If status fetch fails
+     *
+     * @example
+     * ```typescript
+     * const status = await AgentWallet.getStatus({
+     *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+     * });
+     *
+     * console.log(`Balance: $${status.balanceUsd}`);
+     * console.log(`Active sessions: ${status.activeSessions.length}`);
+     * ```
+     */
+    static getStatus(options: AgentGetStatusOptions): Promise<AgentGetStatusResult>;
+    /**
+     * Revoke a session key.
+     *
+     * After revocation, the session key can no longer be used for payments.
+     *
+     * @param options - Revoke options
+     * @returns true if revoked successfully
+     * @throws {MixrPayError} If revocation fails
+     *
+     * @example
+     * ```typescript
+     * const success = await AgentWallet.revokeSessionKey({
+     *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+     *   sessionKeyId: 'session-key-uuid',
+     * });
+     *
+     * if (success) {
+     *   console.log('Session key revoked');
+     * }
+     * ```
+     */
+    static revokeSessionKey(options: AgentRevokeSessionKeyOptions): Promise<boolean>;
     /**
      * Make an HTTP request, automatically handling x402 payment if required.
      *

package/dist/index.d.ts

@@ -359,7 +359,7 @@ interface SessionStats {
  */
 
 /** Current SDK version */
-declare const SDK_VERSION = "0.4.1";
+declare const SDK_VERSION = "0.5.0";
 /** Supported networks */
 declare const NETWORKS: {
     readonly BASE_MAINNET: {
@@ -373,6 +373,101 @@ declare const NETWORKS: {
         readonly isTestnet: true;
     };
 };
+/**
+ * Options for registering an agent
+ */
+interface AgentRegisterOptions {
+    /** The agent's external wallet private key (used for signing, NOT transmitted) */
+    privateKey: `0x${string}`;
+    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    baseUrl?: string;
+    /** Optional display name for the agent */
+    name?: string;
+}
+/**
+ * Result from agent registration
+ */
+interface AgentRegisterResult {
+    /** Internal user ID */
+    userId: string;
+    /** Address to fund the agent's payment wallet */
+    depositAddress: string;
+}
+/**
+ * Options for getting a session key
+ */
+interface AgentGetSessionKeyOptions {
+    /** The agent's external wallet private key (used for signing, NOT transmitted) */
+    privateKey: `0x${string}`;
+    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    baseUrl?: string;
+    /** Maximum total spending in USD (default: $25) */
+    spendingLimitUsd?: number;
+    /** Maximum per transaction in USD */
+    maxPerTxUsd?: number;
+    /** Maximum daily spending in USD */
+    maxDailyUsd?: number;
+    /** Session duration in days (default: 7, max: 365) */
+    durationDays?: number;
+}
+/**
+ * Result from getting a session key
+ */
+interface AgentGetSessionKeyResult {
+    /** The session key in sk_live_{hex} format - STORE SECURELY! */
+    sessionKey: string;
+    /** The derived public address */
+    address: string;
+    /** Session key database ID */
+    sessionKeyId: string;
+    /** When the session key expires */
+    expiresAt: Date;
+    /** Spending limits */
+    limits: {
+        maxTotalUsd: number | null;
+        maxPerTxUsd: number | null;
+        maxDailyUsd: number | null;
+    };
+}
+/**
+ * Options for getting agent status
+ */
+interface AgentGetStatusOptions {
+    /** The agent's external wallet private key (used for signing, NOT transmitted) */
+    privateKey: `0x${string}`;
+    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    baseUrl?: string;
+}
+/**
+ * Result from getting agent status
+ */
+interface AgentGetStatusResult {
+    /** Address of the agent's payment wallet */
+    depositAddress: string;
+    /** Current USDC balance in USD */
+    balanceUsd: number;
+    /** Active session keys */
+    activeSessions: Array<{
+        id: string;
+        expiresAt: Date;
+        totalSpentUsd: number;
+        remainingUsd: number | null;
+        maxTotalUsd: number | null;
+    }>;
+    /** Total spent across all sessions */
+    totalSpentUsd: number;
+}
+/**
+ * Options for revoking a session key
+ */
+interface AgentRevokeSessionKeyOptions {
+    /** The agent's external wallet private key (used for signing, NOT transmitted) */
+    privateKey: `0x${string}`;
+    /** The session key ID to revoke */
+    sessionKeyId: string;
+    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    baseUrl?: string;
+}
 type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'none';
 /**
  * A wallet wrapper for AI agents that handles x402 payments automatically.
@@ -454,6 +549,95 @@ declare class AgentWallet {
      * Validate the configuration before initialization.
      */
     private validateConfig;
+    /**
+     * Register a new agent with MixrPay.
+     *
+     * This creates a Privy-managed embedded wallet for the agent's payments.
+     * The agent proves ownership of their external wallet by signing a challenge.
+     *
+     * @param options - Registration options including the private key
+     * @returns Registration result with deposit address
+     * @throws {MixrPayError} If registration fails
+     *
+     * @example
+     * ```typescript
+     * const { depositAddress, userId } = await AgentWallet.register({
+     *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+     *   name: 'My Trading Agent',
+     * });
+     *
+     * console.log(`Fund your agent at: ${depositAddress}`);
+     * ```
+     */
+    static register(options: AgentRegisterOptions): Promise<AgentRegisterResult>;
+    /**
+     * Get a session key for an already-registered agent.
+     *
+     * Session keys allow the agent to make payments within the specified limits.
+     * The private key is returned ONCE - store it securely!
+     *
+     * @param options - Session key options
+     * @returns Session key result with the sk_live_ format key
+     * @throws {MixrPayError} If session key creation fails
+     *
+     * @example
+     * ```typescript
+     * const result = await AgentWallet.getSessionKey({
+     *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+     *   spendingLimitUsd: 100,
+     *   durationDays: 30,
+     * });
+     *
+     * // Store this securely - it's your payment key!
+     * console.log(`Session key: ${result.sessionKey}`);
+     *
+     * // Use it to create an AgentWallet
+     * const wallet = new AgentWallet({ sessionKey: result.sessionKey });
+     * ```
+     */
+    static getSessionKey(options: AgentGetSessionKeyOptions): Promise<AgentGetSessionKeyResult>;
+    /**
+     * Get the status of a registered agent.
+     *
+     * Returns balance, active sessions, and spending information.
+     *
+     * @param options - Status options
+     * @returns Agent status
+     * @throws {MixrPayError} If status fetch fails
+     *
+     * @example
+     * ```typescript
+     * const status = await AgentWallet.getStatus({
+     *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+     * });
+     *
+     * console.log(`Balance: $${status.balanceUsd}`);
+     * console.log(`Active sessions: ${status.activeSessions.length}`);
+     * ```
+     */
+    static getStatus(options: AgentGetStatusOptions): Promise<AgentGetStatusResult>;
+    /**
+     * Revoke a session key.
+     *
+     * After revocation, the session key can no longer be used for payments.
+     *
+     * @param options - Revoke options
+     * @returns true if revoked successfully
+     * @throws {MixrPayError} If revocation fails
+     *
+     * @example
+     * ```typescript
+     * const success = await AgentWallet.revokeSessionKey({
+     *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+     *   sessionKeyId: 'session-key-uuid',
+     * });
+     *
+     * if (success) {
+     *   console.log('Session key revoked');
+     * }
+     * ```
+     */
+    static revokeSessionKey(options: AgentRevokeSessionKeyOptions): Promise<boolean>;
     /**
      * Make an HTTP request, automatically handling x402 payment if required.
      *

package/dist/index.js

@@ -319,6 +319,9 @@ async function createSessionAuthPayload(sessionKey) {
   };
 }
 
+// src/agent-wallet.ts
+import { privateKeyToAccount as privateKeyToAccount2, signMessage } from "viem/accounts";
+
 // src/x402.ts
 async function parse402Response(response) {
   let paymentData = null;
@@ -408,7 +411,7 @@ function getAmountUsd(requirements) {
 }
 
 // src/agent-wallet.ts
-var SDK_VERSION = "0.4.1";
+var SDK_VERSION = "0.5.0";
 var DEFAULT_BASE_URL = process.env.MIXRPAY_BASE_URL || "https://www.mixrpay.com";
 var DEFAULT_TIMEOUT = 3e4;
 var NETWORKS = {
@@ -552,6 +555,237 @@ var AgentWallet = class {
     }
   }
   // ===========================================================================
+  // Static Agent Registration Methods
+  // ===========================================================================
+  /**
+   * Register a new agent with MixrPay.
+   * 
+   * This creates a Privy-managed embedded wallet for the agent's payments.
+   * The agent proves ownership of their external wallet by signing a challenge.
+   * 
+   * @param options - Registration options including the private key
+   * @returns Registration result with deposit address
+   * @throws {MixrPayError} If registration fails
+   * 
+   * @example
+   * ```typescript
+   * const { depositAddress, userId } = await AgentWallet.register({
+   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+   *   name: 'My Trading Agent',
+   * });
+   * 
+   * console.log(`Fund your agent at: ${depositAddress}`);
+   * ```
+   */
+  static async register(options) {
+    const { privateKey, name } = options;
+    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    const account = privateKeyToAccount2(privateKey);
+    const walletAddress = account.address;
+    const challengeResponse = await fetch(
+      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=register`
+    );
+    if (!challengeResponse.ok) {
+      const error = await challengeResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
+    }
+    const { challenge, message } = await challengeResponse.json();
+    const signature = await signMessage({ message, privateKey });
+    const registerResponse = await fetch(`${baseUrl}/api/v1/agent/register`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        challenge,
+        external_wallet: walletAddress,
+        signature,
+        name
+      })
+    });
+    if (!registerResponse.ok) {
+      const error = await registerResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Registration failed: ${registerResponse.status}`);
+    }
+    const data = await registerResponse.json();
+    return {
+      userId: data.user_id,
+      depositAddress: data.deposit_address
+    };
+  }
+  /**
+   * Get a session key for an already-registered agent.
+   * 
+   * Session keys allow the agent to make payments within the specified limits.
+   * The private key is returned ONCE - store it securely!
+   * 
+   * @param options - Session key options
+   * @returns Session key result with the sk_live_ format key
+   * @throws {MixrPayError} If session key creation fails
+   * 
+   * @example
+   * ```typescript
+   * const result = await AgentWallet.getSessionKey({
+   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+   *   spendingLimitUsd: 100,
+   *   durationDays: 30,
+   * });
+   * 
+   * // Store this securely - it's your payment key!
+   * console.log(`Session key: ${result.sessionKey}`);
+   * 
+   * // Use it to create an AgentWallet
+   * const wallet = new AgentWallet({ sessionKey: result.sessionKey });
+   * ```
+   */
+  static async getSessionKey(options) {
+    const { privateKey, spendingLimitUsd, maxPerTxUsd, maxDailyUsd, durationDays } = options;
+    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    const account = privateKeyToAccount2(privateKey);
+    const walletAddress = account.address;
+    const challengeResponse = await fetch(
+      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=session-key`
+    );
+    if (!challengeResponse.ok) {
+      const error = await challengeResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
+    }
+    const { challenge, message } = await challengeResponse.json();
+    const signature = await signMessage({ message, privateKey });
+    const sessionKeyResponse = await fetch(`${baseUrl}/api/v1/agent/session-key`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        challenge,
+        external_wallet: walletAddress,
+        signature,
+        spending_limit_usd: spendingLimitUsd,
+        max_per_tx_usd: maxPerTxUsd,
+        max_daily_usd: maxDailyUsd,
+        duration_days: durationDays
+      })
+    });
+    if (!sessionKeyResponse.ok) {
+      const error = await sessionKeyResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Session key creation failed: ${sessionKeyResponse.status}`);
+    }
+    const data = await sessionKeyResponse.json();
+    return {
+      sessionKey: data.session_key,
+      address: data.address,
+      sessionKeyId: data.session_key_id,
+      expiresAt: new Date(data.expires_at),
+      limits: {
+        maxTotalUsd: data.limits.max_total_usd,
+        maxPerTxUsd: data.limits.max_per_tx_usd,
+        maxDailyUsd: data.limits.max_daily_usd
+      }
+    };
+  }
+  /**
+   * Get the status of a registered agent.
+   * 
+   * Returns balance, active sessions, and spending information.
+   * 
+   * @param options - Status options
+   * @returns Agent status
+   * @throws {MixrPayError} If status fetch fails
+   * 
+   * @example
+   * ```typescript
+   * const status = await AgentWallet.getStatus({
+   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+   * });
+   * 
+   * console.log(`Balance: $${status.balanceUsd}`);
+   * console.log(`Active sessions: ${status.activeSessions.length}`);
+   * ```
+   */
+  static async getStatus(options) {
+    const { privateKey } = options;
+    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    const account = privateKeyToAccount2(privateKey);
+    const walletAddress = account.address;
+    const challengeResponse = await fetch(
+      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=status`
+    );
+    if (!challengeResponse.ok) {
+      const error = await challengeResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
+    }
+    const { challenge, message } = await challengeResponse.json();
+    const signature = await signMessage({ message, privateKey });
+    const statusResponse = await fetch(
+      `${baseUrl}/api/v1/agent/status?challenge=${challenge}&external_wallet=${walletAddress}&signature=${encodeURIComponent(signature)}`
+    );
+    if (!statusResponse.ok) {
+      const error = await statusResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get status: ${statusResponse.status}`);
+    }
+    const data = await statusResponse.json();
+    return {
+      depositAddress: data.deposit_address,
+      balanceUsd: data.balance_usd,
+      activeSessions: data.active_sessions.map((s) => ({
+        id: s.id,
+        expiresAt: new Date(s.expires_at),
+        totalSpentUsd: s.total_spent_usd,
+        remainingUsd: s.remaining_usd,
+        maxTotalUsd: s.max_total_usd
+      })),
+      totalSpentUsd: data.total_spent_usd
+    };
+  }
+  /**
+   * Revoke a session key.
+   * 
+   * After revocation, the session key can no longer be used for payments.
+   * 
+   * @param options - Revoke options
+   * @returns true if revoked successfully
+   * @throws {MixrPayError} If revocation fails
+   * 
+   * @example
+   * ```typescript
+   * const success = await AgentWallet.revokeSessionKey({
+   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+   *   sessionKeyId: 'session-key-uuid',
+   * });
+   * 
+   * if (success) {
+   *   console.log('Session key revoked');
+   * }
+   * ```
+   */
+  static async revokeSessionKey(options) {
+    const { privateKey, sessionKeyId } = options;
+    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    const account = privateKeyToAccount2(privateKey);
+    const walletAddress = account.address;
+    const challengeResponse = await fetch(
+      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=revoke`
+    );
+    if (!challengeResponse.ok) {
+      const error = await challengeResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
+    }
+    const { challenge, message } = await challengeResponse.json();
+    const signature = await signMessage({ message, privateKey });
+    const revokeResponse = await fetch(`${baseUrl}/api/v1/agent/session-key/revoke`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        challenge,
+        external_wallet: walletAddress,
+        signature,
+        session_key_id: sessionKeyId
+      })
+    });
+    if (!revokeResponse.ok) {
+      const error = await revokeResponse.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Revocation failed: ${revokeResponse.status}`);
+    }
+    return true;
+  }
+  // ===========================================================================
   // Core Methods
   // ===========================================================================
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mixrpay/agent-sdk",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "MixrPay Agent SDK - Enable AI agents to make x402 payments with session keys",
   "type": "module",
   "main": "./dist/index.js",