@oobe-protocol-labs/synapse-sap-sdk 0.14.0 → 0.15.0

package/dist/esm/utils/anchor-errors.js

@@ -0,0 +1,447 @@
+/**
+ * @module utils/anchor-errors
+ * @description Full SAP program error table (147 entries, codes 6000-6146)
+ *   plus decoder utilities. Mirrors `programs/synapse-agent-sap/src/errors.rs`.
+ *
+ *   Use {@link decodeAnchorError} to extract a structured error from any
+ *   thrown RPC / simulation error. Use {@link SAP_ERRORS} for direct lookups.
+ *
+ * @category Utils
+ * @since v0.13.0
+ */
+export const SAP_ERRORS = Object.freeze({
+    6000: { code: 6000, name: "NameTooLong", msg: "name>64" },
+    6001: { code: 6001, name: "DescriptionTooLong", msg: "desc>256" },
+    6002: { code: 6002, name: "UriTooLong", msg: "uri>256" },
+    6003: { code: 6003, name: "TooManyCapabilities", msg: "caps>10" },
+    6004: { code: 6004, name: "TooManyPricingTiers", msg: "tiers>5" },
+    6005: { code: 6005, name: "TooManyProtocols", msg: "protos>5" },
+    6006: { code: 6006, name: "TooManyPlugins", msg: "plugins>5" },
+    6007: { code: 6007, name: "AlreadyActive", msg: "already active" },
+    6008: { code: 6008, name: "AlreadyInactive", msg: "already inactive" },
+    6009: { code: 6009, name: "InvalidFeedbackScore", msg: "score 0-1000" },
+    6010: { code: 6010, name: "TagTooLong", msg: "tag>32" },
+    6011: { code: 6011, name: "SelfReviewNotAllowed", msg: "self review" },
+    6012: { code: 6012, name: "FeedbackAlreadyRevoked", msg: "already revoked" },
+    6013: { code: 6013, name: "CapabilityIndexFull", msg: "cap idx full" },
+    6014: { code: 6014, name: "ProtocolIndexFull", msg: "proto idx full" },
+    6015: { code: 6015, name: "AgentNotInIndex", msg: "not in idx" },
+    6016: { code: 6016, name: "InvalidCapabilityHash", msg: "cap hash" },
+    6017: { code: 6017, name: "InvalidProtocolHash", msg: "proto hash" },
+    6018: { code: 6018, name: "InvalidPluginType", msg: "bad plugin type" },
+    6019: { code: 6019, name: "ChunkDataTooLarge", msg: "chunk>900" },
+    6020: { code: 6020, name: "ContentTypeTooLong", msg: "ctype>max" },
+    6021: { code: 6021, name: "IpfsCidTooLong", msg: "cid>max" },
+    6022: { code: 6022, name: "EmptyName", msg: "empty name" },
+    6023: { code: 6023, name: "ControlCharInName", msg: "ctrl char" },
+    6024: { code: 6024, name: "EmptyDescription", msg: "empty desc" },
+    6025: { code: 6025, name: "AgentIdTooLong", msg: "agentid>128" },
+    6026: { code: 6026, name: "InvalidCapabilityFormat", msg: "cap format" },
+    6027: { code: 6027, name: "DuplicateCapability", msg: "dup cap" },
+    6028: { code: 6028, name: "EmptyTierId", msg: "empty tier" },
+    6029: { code: 6029, name: "DuplicateTierId", msg: "dup tier" },
+    6030: { code: 6030, name: "InvalidRateLimit", msg: "rate=0" },
+    6031: { code: 6031, name: "SplRequiresTokenMint", msg: "spl needs mint" },
+    6032: { code: 6032, name: "InvalidX402Endpoint", msg: "x402 https" },
+    6033: { code: 6033, name: "InvalidVolumeCurve", msg: "curve order" },
+    6034: { code: 6034, name: "TooManyVolumeCurvePoints", msg: "curve>5" },
+    6035: { code: 6035, name: "MinPriceExceedsMax", msg: "min>max price" },
+    6036: { code: 6036, name: "InvalidUptimePercent", msg: "uptime 0-100" },
+    6037: { code: 6037, name: "SessionClosed", msg: "session closed" },
+    6038: { code: 6038, name: "InvalidSequence", msg: "bad seq" },
+    6039: { code: 6039, name: "InvalidFragmentIndex", msg: "frag idx" },
+    6040: { code: 6040, name: "InscriptionTooLarge", msg: "data>750" },
+    6041: { code: 6041, name: "EmptyInscription", msg: "empty data" },
+    6042: { code: 6042, name: "InvalidTotalFragments", msg: "frags<1" },
+    6043: { code: 6043, name: "EpochMismatch", msg: "epoch mismatch" },
+    6044: { code: 6044, name: "VaultNotClosed", msg: "vault open" },
+    6045: { code: 6045, name: "SessionNotClosed", msg: "session open" },
+    6046: { code: 6046, name: "DelegateExpired", msg: "delegate expired" },
+    6047: { code: 6047, name: "InvalidDelegate", msg: "bad delegate" },
+    6048: { code: 6048, name: "ToolNameTooLong", msg: "tool>32" },
+    6049: { code: 6049, name: "EmptyToolName", msg: "empty tool" },
+    6050: { code: 6050, name: "InvalidToolNameHash", msg: "tool hash" },
+    6051: { code: 6051, name: "InvalidToolHttpMethod", msg: "bad method" },
+    6052: { code: 6052, name: "InvalidToolCategory", msg: "bad category" },
+    6053: { code: 6053, name: "ToolAlreadyInactive", msg: "tool inactive" },
+    6054: { code: 6054, name: "ToolAlreadyActive", msg: "tool active" },
+    6055: { code: 6055, name: "InvalidSchemaHash", msg: "schema hash" },
+    6056: { code: 6056, name: "InvalidSchemaType", msg: "schema type" },
+    6057: { code: 6057, name: "InvalidCheckpointIndex", msg: "cp index" },
+    6058: { code: 6058, name: "FeedbackNotRevoked", msg: "not revoked" },
+    6059: { code: 6059, name: "IndexNotEmpty", msg: "idx not empty" },
+    6060: { code: 6060, name: "SessionStillOpen", msg: "session open" },
+    6061: { code: 6061, name: "NoFieldsToUpdate", msg: "no fields" },
+    6062: { code: 6062, name: "InsufficientEscrowBalance", msg: "low balance" },
+    6063: { code: 6063, name: "EscrowMaxCallsExceeded", msg: "max calls" },
+    6064: { code: 6064, name: "EscrowEmpty", msg: "escrow empty" },
+    6065: { code: 6065, name: "EscrowNotEmpty", msg: "escrow!=0" },
+    6066: { code: 6066, name: "InvalidSettlementCalls", msg: "calls<1" },
+    6067: { code: 6067, name: "AttestationTypeTooLong", msg: "atype>32" },
+    6068: { code: 6068, name: "EmptyAttestationType", msg: "empty atype" },
+    6069: { code: 6069, name: "SelfAttestationNotAllowed", msg: "self attest" },
+    6070: { code: 6070, name: "AttestationAlreadyRevoked", msg: "already revoked" },
+    6071: { code: 6071, name: "AttestationNotRevoked", msg: "not revoked" },
+    6072: { code: 6072, name: "ToolCategoryIndexFull", msg: "cat idx full" },
+    6073: { code: 6073, name: "ToolNotInCategoryIndex", msg: "not in cat" },
+    6074: { code: 6074, name: "ToolCategoryMismatch", msg: "cat mismatch" },
+    6075: { code: 6075, name: "ArithmeticOverflow", msg: "overflow" },
+    6076: { code: 6076, name: "EscrowExpired", msg: "escrow expired" },
+    6077: { code: 6077, name: "AgentInactive", msg: "agent inactive" },
+    6078: { code: 6078, name: "AttestationExpired", msg: "attest expired" },
+    6079: { code: 6079, name: "BufferFull", msg: "buf full" },
+    6080: { code: 6080, name: "BufferDataTooLarge", msg: "buf>750" },
+    6081: { code: 6081, name: "Unauthorized", msg: "unauthorized" },
+    6082: { code: 6082, name: "InvalidSession", msg: "bad session" },
+    6083: { code: 6083, name: "EmptyDigestHash", msg: "empty hash" },
+    6084: { code: 6084, name: "LedgerDataTooLarge", msg: "ledger>750" },
+    6085: { code: 6085, name: "LedgerRingEmpty", msg: "ring empty" },
+    6086: { code: 6086, name: "BatchEmpty", msg: "batch empty" },
+    6087: { code: 6087, name: "BatchTooLarge", msg: "batch>10" },
+    6088: { code: 6088, name: "SplTokenRequired", msg: "spl accts" },
+    6089: { code: 6089, name: "InvalidTokenAccount", msg: "bad token" },
+    6090: { code: 6090, name: "InvalidTokenProgram", msg: "bad prog" },
+    6091: { code: 6091, name: "InvalidSettlementSecurity", msg: "bad security" },
+    6092: { code: 6092, name: "CoSignerRequired", msg: "cosigner" },
+    6093: { code: 6093, name: "InvalidCoSigner", msg: "bad cosigner" },
+    6094: { code: 6094, name: "InvalidArbiter", msg: "bad arbiter" },
+    6095: { code: 6095, name: "ArbiterRequired", msg: "arbiter=0" },
+    6096: { code: 6096, name: "EscrowNonceReused", msg: "nonce reused" },
+    6097: { code: 6097, name: "SettlementNotPending", msg: "not pending" },
+    6098: { code: 6098, name: "SettlementAlreadyFinalized", msg: "already final" },
+    6099: { code: 6099, name: "DisputeWindowNotExpired", msg: "too early" },
+    6100: { code: 6100, name: "DisputeWindowExpired", msg: "window closed" },
+    6101: { code: 6101, name: "NotDepositor", msg: "not depositor" },
+    6102: { code: 6102, name: "DisputeAlreadyFiled", msg: "dup dispute" },
+    6103: { code: 6103, name: "DisputeStillOpen", msg: "dispute open" },
+    6104: { code: 6104, name: "NotArbiter", msg: "not arbiter" },
+    6105: { code: 6105, name: "InvalidDisputeOutcome", msg: "bad outcome" },
+    6106: { code: 6106, name: "StakeBelowMinimum", msg: "stake<min" },
+    6107: { code: 6107, name: "NoStakeAccount", msg: "no stake" },
+    6108: { code: 6108, name: "UnstakeAlreadyPending", msg: "unstake pending" },
+    6109: { code: 6109, name: "UnstakeCooldownNotMet", msg: "cooldown" },
+    6110: { code: 6110, name: "NoUnstakePending", msg: "no unstake" },
+    6111: { code: 6111, name: "SlashExceedsStake", msg: "slash>stake" },
+    6112: { code: 6112, name: "SubscriptionAlreadyActive", msg: "sub active" },
+    6113: { code: 6113, name: "SubscriptionCancelled", msg: "sub cancelled" },
+    6114: { code: 6114, name: "NoIntervalDue", msg: "no due" },
+    6115: { code: 6115, name: "SubscriptionInsufficientBalance", msg: "sub low bal" },
+    6116: { code: 6116, name: "InvalidBillingInterval", msg: "bad interval" },
+    6117: { code: 6117, name: "InvalidShardIndex", msg: "bad shard" },
+    6118: { code: 6118, name: "IndexPageFull", msg: "page full" },
+    6119: { code: 6119, name: "InvalidPageIndex", msg: "bad page" },
+    6120: { code: 6120, name: "IndexPageNotEmpty", msg: "page≠empty" },
+    6121: { code: 6121, name: "AlreadyMigrated", msg: "already v2" },
+    6122: { code: 6122, name: "MigrationV1Only", msg: "v1 only" },
+    6123: { code: 6123, name: "SettlementDisputed", msg: "disputed" },
+    6124: { code: 6124, name: "InvalidAgentWallet", msg: "bad agent wallet" },
+    6125: { code: 6125, name: "StakeAgentMismatch", msg: "stake agent mismatch" },
+    6126: { code: 6126, name: "NotAuthority", msg: "not authority" },
+    6127: { code: 6127, name: "UnstakeBelowRent", msg: "unstake below rent" },
+    6128: { code: 6128, name: "InsufficientStake", msg: "insufficient stake" },
+    6129: { code: 6129, name: "SelfReportDeprecated", msg: "SelfReport deprecated" },
+    6130: { code: 6130, name: "ArbiterDeprecated", msg: "arbiter deprecated" },
+    6131: { code: 6131, name: "InvalidBatchIndex", msg: "bad batch idx" },
+    6132: { code: 6132, name: "InvalidPeriod", msg: "bad period" },
+    6133: { code: 6133, name: "InvalidDisputeType", msg: "bad dispute type" },
+    6134: { code: 6134, name: "ProofDeadlineExpired", msg: "proof expired" },
+    6135: { code: 6135, name: "ProofDeadlineNotExpired", msg: "proof not expired" },
+    6136: { code: 6136, name: "InvalidReceiptProof", msg: "bad receipt proof" },
+    6137: { code: 6137, name: "SettlementReplay", msg: "settlement replay" },
+    6138: { code: 6138, name: "PaymentTokenNotAllowed", msg: "token not allowed" },
+    6139: { code: 6139, name: "AgentStakeRequired", msg: "agent stake required" },
+    6140: { code: 6140, name: "DelegateExpiryInvalid", msg: "delegate expiry invalid" },
+    6141: { code: 6141, name: "EscrowNotClosed", msg: "escrow not closed" },
+    6142: { code: 6142, name: "VolumeCurveNotDescending", msg: "curve not descending" },
+    6143: { code: 6143, name: "DuplicateServiceHash", msg: "dup service hash" },
+    6144: { code: 6144, name: "StakeBelowCoverage", msg: "stake under coverage" },
+    6145: { code: 6145, name: "StakeNotClosable", msg: "stake not closable" },
+    6146: { code: 6146, name: "AgentStakeAccountMissing", msg: "agent stake account missing" },
+});
+export const SAP_ERROR_BY_NAME = Object.freeze({
+    NameTooLong: 6000,
+    DescriptionTooLong: 6001,
+    UriTooLong: 6002,
+    TooManyCapabilities: 6003,
+    TooManyPricingTiers: 6004,
+    TooManyProtocols: 6005,
+    TooManyPlugins: 6006,
+    AlreadyActive: 6007,
+    AlreadyInactive: 6008,
+    InvalidFeedbackScore: 6009,
+    TagTooLong: 6010,
+    SelfReviewNotAllowed: 6011,
+    FeedbackAlreadyRevoked: 6012,
+    CapabilityIndexFull: 6013,
+    ProtocolIndexFull: 6014,
+    AgentNotInIndex: 6015,
+    InvalidCapabilityHash: 6016,
+    InvalidProtocolHash: 6017,
+    InvalidPluginType: 6018,
+    ChunkDataTooLarge: 6019,
+    ContentTypeTooLong: 6020,
+    IpfsCidTooLong: 6021,
+    EmptyName: 6022,
+    ControlCharInName: 6023,
+    EmptyDescription: 6024,
+    AgentIdTooLong: 6025,
+    InvalidCapabilityFormat: 6026,
+    DuplicateCapability: 6027,
+    EmptyTierId: 6028,
+    DuplicateTierId: 6029,
+    InvalidRateLimit: 6030,
+    SplRequiresTokenMint: 6031,
+    InvalidX402Endpoint: 6032,
+    InvalidVolumeCurve: 6033,
+    TooManyVolumeCurvePoints: 6034,
+    MinPriceExceedsMax: 6035,
+    InvalidUptimePercent: 6036,
+    SessionClosed: 6037,
+    InvalidSequence: 6038,
+    InvalidFragmentIndex: 6039,
+    InscriptionTooLarge: 6040,
+    EmptyInscription: 6041,
+    InvalidTotalFragments: 6042,
+    EpochMismatch: 6043,
+    VaultNotClosed: 6044,
+    SessionNotClosed: 6045,
+    DelegateExpired: 6046,
+    InvalidDelegate: 6047,
+    ToolNameTooLong: 6048,
+    EmptyToolName: 6049,
+    InvalidToolNameHash: 6050,
+    InvalidToolHttpMethod: 6051,
+    InvalidToolCategory: 6052,
+    ToolAlreadyInactive: 6053,
+    ToolAlreadyActive: 6054,
+    InvalidSchemaHash: 6055,
+    InvalidSchemaType: 6056,
+    InvalidCheckpointIndex: 6057,
+    FeedbackNotRevoked: 6058,
+    IndexNotEmpty: 6059,
+    SessionStillOpen: 6060,
+    NoFieldsToUpdate: 6061,
+    InsufficientEscrowBalance: 6062,
+    EscrowMaxCallsExceeded: 6063,
+    EscrowEmpty: 6064,
+    EscrowNotEmpty: 6065,
+    InvalidSettlementCalls: 6066,
+    AttestationTypeTooLong: 6067,
+    EmptyAttestationType: 6068,
+    SelfAttestationNotAllowed: 6069,
+    AttestationAlreadyRevoked: 6070,
+    AttestationNotRevoked: 6071,
+    ToolCategoryIndexFull: 6072,
+    ToolNotInCategoryIndex: 6073,
+    ToolCategoryMismatch: 6074,
+    ArithmeticOverflow: 6075,
+    EscrowExpired: 6076,
+    AgentInactive: 6077,
+    AttestationExpired: 6078,
+    BufferFull: 6079,
+    BufferDataTooLarge: 6080,
+    Unauthorized: 6081,
+    InvalidSession: 6082,
+    EmptyDigestHash: 6083,
+    LedgerDataTooLarge: 6084,
+    LedgerRingEmpty: 6085,
+    BatchEmpty: 6086,
+    BatchTooLarge: 6087,
+    SplTokenRequired: 6088,
+    InvalidTokenAccount: 6089,
+    InvalidTokenProgram: 6090,
+    InvalidSettlementSecurity: 6091,
+    CoSignerRequired: 6092,
+    InvalidCoSigner: 6093,
+    InvalidArbiter: 6094,
+    ArbiterRequired: 6095,
+    EscrowNonceReused: 6096,
+    SettlementNotPending: 6097,
+    SettlementAlreadyFinalized: 6098,
+    DisputeWindowNotExpired: 6099,
+    DisputeWindowExpired: 6100,
+    NotDepositor: 6101,
+    DisputeAlreadyFiled: 6102,
+    DisputeStillOpen: 6103,
+    NotArbiter: 6104,
+    InvalidDisputeOutcome: 6105,
+    StakeBelowMinimum: 6106,
+    NoStakeAccount: 6107,
+    UnstakeAlreadyPending: 6108,
+    UnstakeCooldownNotMet: 6109,
+    NoUnstakePending: 6110,
+    SlashExceedsStake: 6111,
+    SubscriptionAlreadyActive: 6112,
+    SubscriptionCancelled: 6113,
+    NoIntervalDue: 6114,
+    SubscriptionInsufficientBalance: 6115,
+    InvalidBillingInterval: 6116,
+    InvalidShardIndex: 6117,
+    IndexPageFull: 6118,
+    InvalidPageIndex: 6119,
+    IndexPageNotEmpty: 6120,
+    AlreadyMigrated: 6121,
+    MigrationV1Only: 6122,
+    SettlementDisputed: 6123,
+    InvalidAgentWallet: 6124,
+    StakeAgentMismatch: 6125,
+    NotAuthority: 6126,
+    UnstakeBelowRent: 6127,
+    InsufficientStake: 6128,
+    SelfReportDeprecated: 6129,
+    ArbiterDeprecated: 6130,
+    InvalidBatchIndex: 6131,
+    InvalidPeriod: 6132,
+    InvalidDisputeType: 6133,
+    ProofDeadlineExpired: 6134,
+    ProofDeadlineNotExpired: 6135,
+    InvalidReceiptProof: 6136,
+    SettlementReplay: 6137,
+    PaymentTokenNotAllowed: 6138,
+    AgentStakeRequired: 6139,
+    DelegateExpiryInvalid: 6140,
+    EscrowNotClosed: 6141,
+    VolumeCurveNotDescending: 6142,
+    DuplicateServiceHash: 6143,
+    StakeBelowCoverage: 6144,
+    StakeNotClosable: 6145,
+    AgentStakeAccountMissing: 6146,
+});
+const FRIENDLY_OVERRIDES = Object.freeze({
+    Unauthorized: "Unauthorized — wallet does not match the on-chain authority for this PDA.",
+    AgentInactive: "Agent is inactive (deactivated). Reactivate before publishing tools or accepting escrows.",
+    AgentStakeRequired: "Agent stake account missing or below MIN_STAKE (0.1 SOL). Initialize stake first.",
+    StakeBelowMinimum: "Stake below minimum (0.1 SOL). Top up before requesting unstake or accepting escrows.",
+    StakeBelowCoverage: "Stake below coverage requirement for outstanding escrow. Increase stake or wait for escrows to settle.",
+    PaymentTokenNotAllowed: "Token mint not in allowlist. Use SOL (null) or USDC (mainnet/devnet).",
+    DelegateExpiryInvalid: "Delegate expiry exceeds MAX_DELEGATE_DURATION_SECS (365 days) from now.",
+    EscrowNotEmpty: "Escrow balance != 0. Withdraw or settle remaining funds before closing.",
+    EscrowEmpty: "Escrow balance is zero — cannot settle.",
+    InsufficientEscrowBalance: "Insufficient escrow balance for the requested settlement amount.",
+    ArithmeticOverflow: "Arithmetic overflow — likely an orphan PendingSettlement, mismatched amount, or unsigned subtraction. Run `escrowV2.diagnoseOrphanPending()` to inspect.",
+    EscrowNonceReused: "Escrow nonce already used by this depositor. Pick a fresh nonce.",
+    SettlementNotPending: "PendingSettlement is not in pending state (already finalized or never created).",
+    SettlementAlreadyFinalized: "PendingSettlement already finalized — cannot finalize twice.",
+    DisputeWindowNotExpired: "Dispute window still open. Wait until escrow.dispute_window_slots elapse before finalizing.",
+    DisputeWindowExpired: "Dispute window already closed. Cannot file dispute.",
+    CoSignerRequired: "Settlement security mode requires a co-signer. Pass the co-signer keypair.",
+    InvalidCoSigner: "Co-signer pubkey does not match the on-chain `escrow.co_signer`.",
+    InvalidSettlementSecurity: "Settlement security mode mismatch with on-chain escrow config.",
+    SettlementReplay: "Settlement receipt PDA already exists for this serviceHash/batchRoot. Replay blocked.",
+    DuplicateServiceHash: "Two settlements in the same batch share the same serviceHash. Make each call unique.",
+    BatchTooLarge: "Batch settle exceeds 10 entries. Split across multiple transactions.",
+    BatchEmpty: "Batch settle requires at least 1 settlement.",
+    InscriptionTooLarge: "Inscription chunk exceeds 750 bytes. Split into more fragments.",
+    InvalidSchemaHash: "Tool schema hash is empty / invalid. v0.2.0+ requires every tool to publish a JSON schema (or schema_hash).",
+    EmptyToolName: "Tool name cannot be empty.",
+    ToolNameTooLong: "Tool name exceeds 32 bytes.",
+    EscrowExpired: "Escrow expired (expiresAt passed). Create a new escrow.",
+    UnstakeCooldownNotMet: "Unstake cooldown not elapsed. Wait for the cooldown window before completing unstake.",
+    UnstakeBelowRent: "Resulting stake balance would fall below the rent-exempt minimum. Reduce unstake amount.",
+});
+/**
+ * @name decodeAnchorError
+ * @description Pull an Anchor / SAP error out of any caught value.
+ *   Handles: AnchorError, raw RPC SimulateError, `0x...` hex codes,
+ *   nested `error.errorCode.number`, and direct `code` numbers.
+ * @returns Structured {@link DecodedAnchorError} or `null` if not a SAP error.
+ * @since v0.13.0
+ */
+export function decodeAnchorError(err) {
+    if (err == null || typeof err !== "object")
+        return null;
+    const code = extractCode(err);
+    if (code == null)
+        return null;
+    const entry = SAP_ERRORS[code];
+    if (!entry) {
+        return {
+            code,
+            name: "Unknown",
+            msg: `custom program error 0x${code.toString(16)}`,
+            friendly: `Unknown SAP error (code ${code}). Check IDL.`,
+            logs: extractLogs(err),
+        };
+    }
+    return {
+        code: entry.code,
+        name: entry.name,
+        msg: entry.msg,
+        friendly: FRIENDLY_OVERRIDES[entry.name] ?? `${entry.name}: ${entry.msg}`,
+        logs: extractLogs(err),
+    };
+}
+function extractCode(err) {
+    if (typeof err !== "object" || err == null)
+        return null;
+    const e = err;
+    if (typeof e.code === "number")
+        return e.code;
+    const nested = e.error;
+    if (nested && typeof nested === "object") {
+        const errorCode = nested.errorCode;
+        if (errorCode && typeof errorCode === "object") {
+            const num = errorCode.number;
+            if (typeof num === "number")
+                return num;
+        }
+    }
+    const msg = err.message;
+    if (typeof msg === "string") {
+        const hex = msg.match(/custom program error:\s*0x([0-9a-fA-F]+)/);
+        if (hex?.[1])
+            return parseInt(hex[1], 16);
+        const dec = msg.match(/Error Number:\s*(\d+)/);
+        if (dec?.[1])
+            return parseInt(dec[1], 10);
+    }
+    return null;
+}
+function extractLogs(err) {
+    if (typeof err !== "object" || err == null)
+        return undefined;
+    const logs = err.logs;
+    if (Array.isArray(logs))
+        return logs;
+    const nested = err.simulationResponse;
+    if (nested && typeof nested === "object") {
+        const inner = nested.logs;
+        if (Array.isArray(inner))
+            return inner;
+    }
+    return undefined;
+}
+/**
+ * @name SapPreflightError
+ * @description Thrown by SDK preflights when an on-chain check is guaranteed
+ *   to fail. Carries the predicted error code/name so callers can branch
+ *   without parsing strings.
+ * @since v0.13.0
+ */
+export class SapPreflightError extends Error {
+    predictedCode;
+    predictedName;
+    hint;
+    preflight = true;
+    constructor(message, predictedCode, predictedName, hint) {
+        super(message);
+        this.predictedCode = predictedCode;
+        this.predictedName = predictedName;
+        this.hint = hint;
+        this.name = "SapPreflightError";
+    }
+}
+/**
+ * @name throwPredicted
+ * @description Helper for SDK preflights. Throws a {@link SapPreflightError}
+ *   carrying the on-chain error name + friendly message.
+ * @since v0.13.0
+ */
+export function throwPredicted(name, hint) {
+    const code = SAP_ERROR_BY_NAME[name] ?? -1;
+    const entry = code >= 0 ? SAP_ERRORS[code] : undefined;
+    const friendly = FRIENDLY_OVERRIDES[name] ?? `${String(name)}: ${entry?.msg ?? ""}`;
+    const full = hint ? `${friendly} (${hint})` : friendly;
+    throw new SapPreflightError(full, code, name, hint);
+}
+//# sourceMappingURL=anchor-errors.js.map

package/dist/esm/utils/anchor-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-errors.js","sourceRoot":"","sources":["../../../src/utils/anchor-errors.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/endpoint-validator.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @module utils/endpoint-validator
+ * @description Endpoint validation utilities for SAP agent discovery.
+ *
+ * Fetches advertised endpoints and verifies they respond with JSON,
+ * proper CORS headers, and SAP-compatible behavior. Designed to
+ * fail fast when an endpoint 404s, requires CSRF tokens, or
+ * serves HTML instead of JSON.
+ *
+ * Used by:
+ *   - CLI `discovery validate` command
+ *   - SDK programmatic validation before x402 calls
+ *   - Integration test harnesses
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+import type { EndpointDescriptor, HealthCheckDescriptor, EndpointValidationResult } from "../types/endpoint";
+/**
+ * @interface ValidateEndpointOptions
+ * @description Options for endpoint validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export interface ValidateEndpointOptions {
+    /** Timeout in milliseconds (default: 10000). */
+    readonly timeoutMs?: number;
+    /** Number of retries on failure (default: 1). */
+    readonly retries?: number;
+    /** HTTP method override (default: uses descriptor or HEAD). */
+    readonly method?: string;
+    /** Custom headers to include in the validation request. */
+    readonly headers?: Record<string, string>;
+    /** If true, also sends a preflight OPTIONS request. */
+    readonly checkCors?: boolean;
+}
+/**
+ * @name validateEndpoint
+ * @description Validate a single endpoint URL for SAP compatibility.
+ *
+ * Performs the following checks:
+ *   1. URL is reachable (no 4xx/5xx)
+ *   2. Response Content-Type is JSON
+ *   3. CORS headers are present (if checkCors enabled)
+ *   4. No redirect to HTML login pages
+ *   5. Measures response latency
+ *
+ * @param url - The endpoint URL to validate.
+ * @param opts - Validation options.
+ * @returns An {@link EndpointValidationResult} with detailed check results.
+ *
+ * @category Utils
+ * @since v0.6.0
+ *
+ * @example
+ * ```ts
+ * const result = await validateEndpoint("https://api.example.com/x402");
+ * if (!result.reachable) console.error(result.error);
+ * ```
+ */
+export declare function validateEndpoint(url: string, opts?: ValidateEndpointOptions): Promise<EndpointValidationResult>;
+/**
+ * @name validateEndpointDescriptor
+ * @description Validate an {@link EndpointDescriptor} with context-aware checks.
+ *
+ * Uses the descriptor's method, auth requirements, and other metadata to
+ * perform a more targeted validation than raw URL checking.
+ *
+ * @param descriptor - The endpoint descriptor to validate.
+ * @param opts - Additional options.
+ * @returns An {@link EndpointValidationResult}.
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function validateEndpointDescriptor(descriptor: EndpointDescriptor, opts?: ValidateEndpointOptions): Promise<EndpointValidationResult>;
+/**
+ * @name validateHealthCheck
+ * @description Validate an agent's health-check endpoint.
+ *
+ * @param health - The health-check descriptor.
+ * @returns An {@link EndpointValidationResult}.
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function validateHealthCheck(health: HealthCheckDescriptor): Promise<EndpointValidationResult>;
+/**
+ * @name validateAgentEndpoints
+ * @description Validate all endpoints for an agent (primary + health + tool overrides).
+ *
+ * @param params - Object containing the endpoints to validate.
+ * @param params.endpoint - Primary endpoint descriptor.
+ * @param params.healthCheck - Optional health-check descriptor.
+ * @param params.toolEndpoints - Optional array of tool-specific endpoint overrides.
+ * @param opts - Validation options.
+ * @returns A map of `label → EndpointValidationResult`.
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function validateAgentEndpoints(params: {
+    endpoint: EndpointDescriptor;
+    healthCheck?: HealthCheckDescriptor;
+    toolEndpoints?: Array<{
+        name: string;
+        endpoint: EndpointDescriptor;
+    }>;
+}, opts?: ValidateEndpointOptions): Promise<Map<string, EndpointValidationResult>>;
+//# sourceMappingURL=endpoint-validator.d.ts.map

package/dist/esm/utils/endpoint-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-validator.d.ts","sourceRoot":"","sources":["../../../src/utils/endpoint-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAM3B;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,uDAAuD;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA+FnC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,kBAAkB,EAC9B,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA6BnC;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,wBAAwB,CAAC,CAmBnC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE;IACN,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;CACvE,EACD,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAsBhD"}