@x1scroll/agent-sdk 1.2.0 → 1.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x1scroll/agent-sdk",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Agent identity and on-chain memory protocol for X1 blockchain",
   "license": "BSL-1.1",
   "main": "src/index.js",

package/src/index.js

@@ -52,7 +52,7 @@ const PROGRAM_ID = new PublicKey('ECgaMEwH4KLSz3awDo1vz84mSrx5n6h1ZCrbmunB5UxB')
  */
 const TREASURY = new PublicKey('GmvrL1ymC9ENuQCUqymC9robGa9t9L59AbFiwhDDd4Ld');
 
-const DEFAULT_RPC_URL = 'https://rpc.x1.xyz';
+const DEFAULT_RPC_URL = 'https://x1scroll.io/rpc';
 
 // ── Anchor instruction discriminators (sha256("global:<name>")[0..8]) ─────────
 // Pre-computed from the IDL. These are fixed for the deployed program version.
@@ -355,6 +355,54 @@ class AgentClient {
     this._registryCacheExpiry = 0;
   }
 
+  /**
+   * Check RPC connectivity. Throws AgentSDKError with fallback suggestion if unreachable.
+   * @returns {Promise<{ ok: boolean, slot: number, rpcUrl: string }>}
+   */
+  async healthCheck() {
+    const conn = this._getConnection();
+    try {
+      const slot = await Promise.race([
+        conn.getSlot(),
+        new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), 8000)),
+      ]);
+      return { ok: true, slot, rpcUrl: this.rpcUrl };
+    } catch (err) {
+      throw new AgentSDKError(
+        `RPC endpoint unreachable: ${this.rpcUrl}. ` +
+        `Try the public fallback: https://x1scroll.io/rpc\n` +
+        `Original error: ${err.message}`,
+        'RPC_UNREACHABLE',
+        err
+      );
+    }
+  }
+
+  /**
+   * Check that a keypair has sufficient XNT balance for an operation.
+   * Throws AgentSDKError with current balance and required amount if insufficient.
+   * @param {Keypair} keypair
+   * @param {number}  requiredLamports
+   * @param {string}  [operationName]
+   */
+  async _assertSufficientBalance(keypair, requiredLamports, operationName = 'operation') {
+    const conn = this._getConnection();
+    const balance = await conn.getBalance(keypair.publicKey);
+    // Add 5000 lamports buffer for network tx fee
+    const totalRequired = requiredLamports + 5000;
+    if (balance < totalRequired) {
+      const balanceXNT  = (balance / 1e9).toFixed(6);
+      const requiredXNT = (totalRequired / 1e9).toFixed(6);
+      throw new AgentSDKError(
+        `Insufficient balance for ${operationName}. ` +
+        `Have: ${balanceXNT} XNT, Need: ${requiredXNT} XNT. ` +
+        `Fund wallet: ${keypair.publicKey.toBase58()}`,
+        'INSUFFICIENT_BALANCE'
+      );
+    }
+    return balance;
+  }
+
   // ── Internal ────────────────────────────────────────────────────────────────
 
   /** @returns {Connection} */
@@ -518,6 +566,10 @@ class AgentClient {
 
     const humanKeypair = this.keypair;
     const agentPubkey  = agentKeypair.publicKey;
+
+    // ── Pre-flight balance check (0.05 XNT registration fee) ──
+    await this._assertSufficientBalance(humanKeypair, 50_000_000, 'register_agent (0.05 XNT)');
+
     const { pda: agentRecordPDA } = AgentClient.deriveAgentRecord(agentPubkey);
 
     // Borsh-encode instruction data: discriminator + name + metadata_uri
@@ -945,6 +997,9 @@ class AgentClient {
     validateString(branchLabel, 'branchLabel', 64);
     validateString(cid, 'cid', 64);
 
+    // ── Pre-flight balance check (0.001 XNT decision write fee) ──
+    await this._assertSufficientBalance(agentKeypair, 1_000_000, 'decision_write (0.001 XNT)');
+
     if (typeof outcome !== 'number' || ![0, 1, 2].includes(outcome)) {
       throw new AgentSDKError('outcome must be 0 (pending), 1 (executed), or 2 (rejected)', 'INVALID_INPUT');
     }