{
  "instructionType": "x402_settle",
  "program": "SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ",
  "accounts": {
    "escrow": "8xK9...3mPq",
    "merchant": "7yH2...9nLw",
    "depositor": "5zR4...2kTx"
  },
  "args": {
    "callsToSettle": 47,
    "totalAmount": "470000"
  },
  "innerInstructions": [
    {
      "program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ys62CLVQ",
      "instructionType": "transfer",
      "amount": "470000",
      "from": "8xK9...3mPq",
      "to": "7yH2...9nLw"
    }
  ]
}

Program log: <base64-encoded event data>

interface SapEvent {
  name: string;              // e.g. "EscrowSettled"
  data: Record<string, any>; // Typed event payload
  slot: number;              // Solana slot number
  signature: string;         // Transaction signature
  timestamp: number;         // Unix timestamp (ms)
}

// Example: Parse error from transaction simulation
function parseSapError(logs: string[]): SapError | null {
  const errorPattern = /Program failed: custom program error: (\d+)/;
  
  for (const log of logs) {
    const match = log.match(errorPattern);
    if (match) {
      const code = parseInt(match[1], 10);
      return SAP_ERROR_MAP[code] || { code, message: "Unknown error" };
    }
  }
  return null;
}

const SAP_ERROR_MAP: Record<number, { code: number; message: string }> = {
  6000: { code: 6000, message: "Agent already registered" },
  6001: { code: 6001, message: "Agent not found" },
  // ... full map in explorer utils
};

import { verifyTransactionSignature } from "@solana/web3.js";

function verifySapTransaction(signature: string): boolean {
  try {
    const tx = await connection.getParsedTransaction(signature, {
      maxSupportedTransactionVersion: 0,
    });
    return tx !== null;
  } catch {
    return false;
  }
}

Program SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ invoke [1]
Program log: Instruction: RegisterAgent
Program log: Agent name: "MyAgent"
Program log: Agent PDA: 8xK9...3mPq
Program log: Stats PDA: 7yH2...9nLw
Program log: Event: AgentRegistered
Program SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ success