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

package/dist/esm/errors.d.ts

@@ -0,0 +1,119 @@
+/** Generic SDK error */
+export declare class SapError extends Error {
+    constructor(message: string);
+}
+/** Validation-specific SDK error */
+export declare class SapValidationError extends Error {
+    constructor(message: string);
+}
+/** All v0.13 SapError variants with recovery hints */
+export declare enum SapErrorCode {
+    NameTooLong = 6000,
+    NameTooShort = 6001,
+    InvalidEndpoint = 6002,
+    EndpointTooLong = 6003,
+    InvalidDIDHash = 6004,
+    AgentNotInitialized = 6005,
+    AgentAlreadyInitialized = 6006,
+    AgentClosed = 6007,
+    NameEmpty = 6010,
+    NameWhitespace = 6011,
+    DescriptionTooLong = 6012,
+    CategoryOutOfRange = 6013,
+    ToolNameExists = 6014,
+    ToolNotFound = 6015,
+    CallerNotAgentOwner = 6016,
+    CallerNotToolOwner = 6017,
+    ToolCategoryMismatch = 6018,
+    StakeBelowMinimum = 6020,
+    NotStaked = 6021,
+    UnstakeTooSoon = 6022,
+    UnstakeExceedsStake = 6023,
+    AlreadyStaked = 6024,
+    UnstakeWindowNotOpen = 6025,
+    UnstakeAlreadyPending = 6026,
+    CannotCloseAgentWithActiveEscrows = 6027,
+    StakeNotFound = 6028,
+    AgentStatsNotFound = 6029,
+    InsufficientStake = 6030,
+    InsufficientEscrowBalance = 6032,
+    EscrowNotFound = 6033,
+    EscrowNotForAgent = 6034,
+    EscrowNotForDepositor = 6035,
+    AmountMustBePositive = 6036,
+    PricePerCallMustBePositive = 6037,
+    InvalidEscrowNonce = 6038,
+    InvalidVolumeCurve = 6039,
+    VolumeCurveNotDescending = 6040,
+    TooManyVolumeCurvePoints = 6041,
+    SettlementNotPending = 6042,
+    SettlementAlreadyFinalized = 6043,
+    DisputeWindowNotExpired = 6044,
+    DisputeWindowExpired = 6045,
+    NotDepositor = 6046,
+    DisputeAlreadyFiled = 6047,
+    DisputeStillOpen = 6048,
+    NotArbiter = 6049,
+    InvalidArbiter = 6050,
+    ArbiterRequired = 6051,
+    CoSignerRequired = 6052,
+    InvalidCoSigner = 6053,
+    InvalidDisputeOutcome = 6054,
+    EscrowEmpty = 6055,
+    EscrowAlreadyExpired = 6056,
+    EscrowExpired = 6057,
+    EscrowNonceReused = 6058,
+    ReceiptBatchNotFound = 6060,
+    ReceiptTreeEmpty = 6061,
+    ReceiptNotFound = 6062,
+    ReceiptAlreadyDisputed = 6063,
+    ReceiptNotInWindow = 6064,
+    InvalidReceiptProof = 6065,
+    InvalidMerkleProof = 6066,
+    NotAgentOwner = 6067,
+    SubscriptionNotFound = 6070,
+    NotSubscriber = 6071,
+    SubscriptionInsufficientBalance = 6072,
+    SubscriptionIntervalOverflow = 6073,
+    SubscriptionDurationTooLong = 6074,
+    PendingAmountMismatch = 6080,
+    MaxCallsPerSettlementExceeded = 6081,
+    InvalidVolumeCurvePrice = 6082,
+    EscrowCoverageExceeded = 6083,
+    CoSignerIsAgentWallet = 6084,
+    PendingSettlementExists = 6085,
+    TokenAccountOwnerMismatch = 6086,
+    MaxReceiptProofExceeded = 6087,
+    MaxMerkleDepthExceeded = 6088,
+    StakeSlashLocksUnstake = 6089,
+    ArithmeticOverflow = 6300,
+    VaultNotFound = 6350,
+    VaultAlreadyInitialized = 6351,
+    VaultNotInitialized = 6352,
+    NotVaultOwner = 6353,
+    NotDelegate = 6354,
+    DelegateExpired = 6355,
+    InvalidPermissions = 6356,
+    SessionNotFound = 6357,
+    EpochNotFound = 6358,
+    VaultAlreadyOpen = 6359,
+    InvalidSequence = 6360,
+    FragmentTooLarge = 6361,
+    VaultClosed = 6362,
+    InsufficientVaultBalance = 6363
+}
+export interface SapErrorInfo {
+    code: SapErrorCode;
+    name: string;
+    message: string;
+    recovery: string;
+}
+/** Decode an Anchor transaction error into structured info */
+export declare function decodeSapError(err: unknown): SapErrorInfo;
+/** Is this error retryable? */
+export declare function isRetryableError(err: SapErrorInfo): boolean;
+/** Is this a client-side validation error that should have been caught before sending?
+ *  If true, the SDK's validate functions have a bug.
+ */
+export declare function isClientValidationFailure(err: SapErrorInfo): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/errors.d.ts.map

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

package/dist/esm/errors.js

@@ -0,0 +1,252 @@
+/** Generic SDK error */
+export class SapError extends Error {
+    constructor(message) { super(message); this.name = "SapError"; }
+}
+/** Validation-specific SDK error */
+export class SapValidationError extends Error {
+    constructor(message) { super(message); this.name = "SapValidationError"; }
+}
+// ================================================================
+//  synapse-sap-sdk / src/errors.ts
+//  On-chain error codes ↔ human-readable messages + recovery actions
+// ================================================================
+/** All v0.13 SapError variants with recovery hints */
+export var SapErrorCode;
+(function (SapErrorCode) {
+    // ── Agent ──
+    SapErrorCode[SapErrorCode["NameTooLong"] = 6000] = "NameTooLong";
+    SapErrorCode[SapErrorCode["NameTooShort"] = 6001] = "NameTooShort";
+    SapErrorCode[SapErrorCode["InvalidEndpoint"] = 6002] = "InvalidEndpoint";
+    SapErrorCode[SapErrorCode["EndpointTooLong"] = 6003] = "EndpointTooLong";
+    SapErrorCode[SapErrorCode["InvalidDIDHash"] = 6004] = "InvalidDIDHash";
+    SapErrorCode[SapErrorCode["AgentNotInitialized"] = 6005] = "AgentNotInitialized";
+    SapErrorCode[SapErrorCode["AgentAlreadyInitialized"] = 6006] = "AgentAlreadyInitialized";
+    SapErrorCode[SapErrorCode["AgentClosed"] = 6007] = "AgentClosed";
+    // ── Tool / Registry ──
+    SapErrorCode[SapErrorCode["NameEmpty"] = 6010] = "NameEmpty";
+    SapErrorCode[SapErrorCode["NameWhitespace"] = 6011] = "NameWhitespace";
+    SapErrorCode[SapErrorCode["DescriptionTooLong"] = 6012] = "DescriptionTooLong";
+    SapErrorCode[SapErrorCode["CategoryOutOfRange"] = 6013] = "CategoryOutOfRange";
+    SapErrorCode[SapErrorCode["ToolNameExists"] = 6014] = "ToolNameExists";
+    SapErrorCode[SapErrorCode["ToolNotFound"] = 6015] = "ToolNotFound";
+    SapErrorCode[SapErrorCode["CallerNotAgentOwner"] = 6016] = "CallerNotAgentOwner";
+    SapErrorCode[SapErrorCode["CallerNotToolOwner"] = 6017] = "CallerNotToolOwner";
+    SapErrorCode[SapErrorCode["ToolCategoryMismatch"] = 6018] = "ToolCategoryMismatch";
+    // ── Stake ──
+    SapErrorCode[SapErrorCode["StakeBelowMinimum"] = 6020] = "StakeBelowMinimum";
+    SapErrorCode[SapErrorCode["NotStaked"] = 6021] = "NotStaked";
+    SapErrorCode[SapErrorCode["UnstakeTooSoon"] = 6022] = "UnstakeTooSoon";
+    SapErrorCode[SapErrorCode["UnstakeExceedsStake"] = 6023] = "UnstakeExceedsStake";
+    SapErrorCode[SapErrorCode["AlreadyStaked"] = 6024] = "AlreadyStaked";
+    SapErrorCode[SapErrorCode["UnstakeWindowNotOpen"] = 6025] = "UnstakeWindowNotOpen";
+    SapErrorCode[SapErrorCode["UnstakeAlreadyPending"] = 6026] = "UnstakeAlreadyPending";
+    SapErrorCode[SapErrorCode["CannotCloseAgentWithActiveEscrows"] = 6027] = "CannotCloseAgentWithActiveEscrows";
+    SapErrorCode[SapErrorCode["StakeNotFound"] = 6028] = "StakeNotFound";
+    SapErrorCode[SapErrorCode["AgentStatsNotFound"] = 6029] = "AgentStatsNotFound";
+    SapErrorCode[SapErrorCode["InsufficientStake"] = 6030] = "InsufficientStake";
+    // ── Escrow ──
+    SapErrorCode[SapErrorCode["InsufficientEscrowBalance"] = 6032] = "InsufficientEscrowBalance";
+    SapErrorCode[SapErrorCode["EscrowNotFound"] = 6033] = "EscrowNotFound";
+    SapErrorCode[SapErrorCode["EscrowNotForAgent"] = 6034] = "EscrowNotForAgent";
+    SapErrorCode[SapErrorCode["EscrowNotForDepositor"] = 6035] = "EscrowNotForDepositor";
+    SapErrorCode[SapErrorCode["AmountMustBePositive"] = 6036] = "AmountMustBePositive";
+    SapErrorCode[SapErrorCode["PricePerCallMustBePositive"] = 6037] = "PricePerCallMustBePositive";
+    SapErrorCode[SapErrorCode["InvalidEscrowNonce"] = 6038] = "InvalidEscrowNonce";
+    SapErrorCode[SapErrorCode["InvalidVolumeCurve"] = 6039] = "InvalidVolumeCurve";
+    SapErrorCode[SapErrorCode["VolumeCurveNotDescending"] = 6040] = "VolumeCurveNotDescending";
+    SapErrorCode[SapErrorCode["TooManyVolumeCurvePoints"] = 6041] = "TooManyVolumeCurvePoints";
+    SapErrorCode[SapErrorCode["SettlementNotPending"] = 6042] = "SettlementNotPending";
+    SapErrorCode[SapErrorCode["SettlementAlreadyFinalized"] = 6043] = "SettlementAlreadyFinalized";
+    SapErrorCode[SapErrorCode["DisputeWindowNotExpired"] = 6044] = "DisputeWindowNotExpired";
+    SapErrorCode[SapErrorCode["DisputeWindowExpired"] = 6045] = "DisputeWindowExpired";
+    SapErrorCode[SapErrorCode["NotDepositor"] = 6046] = "NotDepositor";
+    SapErrorCode[SapErrorCode["DisputeAlreadyFiled"] = 6047] = "DisputeAlreadyFiled";
+    SapErrorCode[SapErrorCode["DisputeStillOpen"] = 6048] = "DisputeStillOpen";
+    SapErrorCode[SapErrorCode["NotArbiter"] = 6049] = "NotArbiter";
+    SapErrorCode[SapErrorCode["InvalidArbiter"] = 6050] = "InvalidArbiter";
+    SapErrorCode[SapErrorCode["ArbiterRequired"] = 6051] = "ArbiterRequired";
+    SapErrorCode[SapErrorCode["CoSignerRequired"] = 6052] = "CoSignerRequired";
+    SapErrorCode[SapErrorCode["InvalidCoSigner"] = 6053] = "InvalidCoSigner";
+    SapErrorCode[SapErrorCode["InvalidDisputeOutcome"] = 6054] = "InvalidDisputeOutcome";
+    SapErrorCode[SapErrorCode["EscrowEmpty"] = 6055] = "EscrowEmpty";
+    SapErrorCode[SapErrorCode["EscrowAlreadyExpired"] = 6056] = "EscrowAlreadyExpired";
+    SapErrorCode[SapErrorCode["EscrowExpired"] = 6057] = "EscrowExpired";
+    SapErrorCode[SapErrorCode["EscrowNonceReused"] = 6058] = "EscrowNonceReused";
+    // ── Receipt ──
+    SapErrorCode[SapErrorCode["ReceiptBatchNotFound"] = 6060] = "ReceiptBatchNotFound";
+    SapErrorCode[SapErrorCode["ReceiptTreeEmpty"] = 6061] = "ReceiptTreeEmpty";
+    SapErrorCode[SapErrorCode["ReceiptNotFound"] = 6062] = "ReceiptNotFound";
+    SapErrorCode[SapErrorCode["ReceiptAlreadyDisputed"] = 6063] = "ReceiptAlreadyDisputed";
+    SapErrorCode[SapErrorCode["ReceiptNotInWindow"] = 6064] = "ReceiptNotInWindow";
+    SapErrorCode[SapErrorCode["InvalidReceiptProof"] = 6065] = "InvalidReceiptProof";
+    SapErrorCode[SapErrorCode["InvalidMerkleProof"] = 6066] = "InvalidMerkleProof";
+    SapErrorCode[SapErrorCode["NotAgentOwner"] = 6067] = "NotAgentOwner";
+    // ── Subscription ──
+    SapErrorCode[SapErrorCode["SubscriptionNotFound"] = 6070] = "SubscriptionNotFound";
+    SapErrorCode[SapErrorCode["NotSubscriber"] = 6071] = "NotSubscriber";
+    SapErrorCode[SapErrorCode["SubscriptionInsufficientBalance"] = 6072] = "SubscriptionInsufficientBalance";
+    SapErrorCode[SapErrorCode["SubscriptionIntervalOverflow"] = 6073] = "SubscriptionIntervalOverflow";
+    SapErrorCode[SapErrorCode["SubscriptionDurationTooLong"] = 6074] = "SubscriptionDurationTooLong";
+    // ── Dispute / Security (v0.13) ──
+    SapErrorCode[SapErrorCode["PendingAmountMismatch"] = 6080] = "PendingAmountMismatch";
+    SapErrorCode[SapErrorCode["MaxCallsPerSettlementExceeded"] = 6081] = "MaxCallsPerSettlementExceeded";
+    SapErrorCode[SapErrorCode["InvalidVolumeCurvePrice"] = 6082] = "InvalidVolumeCurvePrice";
+    SapErrorCode[SapErrorCode["EscrowCoverageExceeded"] = 6083] = "EscrowCoverageExceeded";
+    SapErrorCode[SapErrorCode["CoSignerIsAgentWallet"] = 6084] = "CoSignerIsAgentWallet";
+    SapErrorCode[SapErrorCode["PendingSettlementExists"] = 6085] = "PendingSettlementExists";
+    SapErrorCode[SapErrorCode["TokenAccountOwnerMismatch"] = 6086] = "TokenAccountOwnerMismatch";
+    SapErrorCode[SapErrorCode["MaxReceiptProofExceeded"] = 6087] = "MaxReceiptProofExceeded";
+    SapErrorCode[SapErrorCode["MaxMerkleDepthExceeded"] = 6088] = "MaxMerkleDepthExceeded";
+    SapErrorCode[SapErrorCode["StakeSlashLocksUnstake"] = 6089] = "StakeSlashLocksUnstake";
+    // ── Math ──
+    SapErrorCode[SapErrorCode["ArithmeticOverflow"] = 6300] = "ArithmeticOverflow";
+    // ── Vault ──
+    SapErrorCode[SapErrorCode["VaultNotFound"] = 6350] = "VaultNotFound";
+    SapErrorCode[SapErrorCode["VaultAlreadyInitialized"] = 6351] = "VaultAlreadyInitialized";
+    SapErrorCode[SapErrorCode["VaultNotInitialized"] = 6352] = "VaultNotInitialized";
+    SapErrorCode[SapErrorCode["NotVaultOwner"] = 6353] = "NotVaultOwner";
+    SapErrorCode[SapErrorCode["NotDelegate"] = 6354] = "NotDelegate";
+    SapErrorCode[SapErrorCode["DelegateExpired"] = 6355] = "DelegateExpired";
+    SapErrorCode[SapErrorCode["InvalidPermissions"] = 6356] = "InvalidPermissions";
+    SapErrorCode[SapErrorCode["SessionNotFound"] = 6357] = "SessionNotFound";
+    SapErrorCode[SapErrorCode["EpochNotFound"] = 6358] = "EpochNotFound";
+    SapErrorCode[SapErrorCode["VaultAlreadyOpen"] = 6359] = "VaultAlreadyOpen";
+    SapErrorCode[SapErrorCode["InvalidSequence"] = 6360] = "InvalidSequence";
+    SapErrorCode[SapErrorCode["FragmentTooLarge"] = 6361] = "FragmentTooLarge";
+    SapErrorCode[SapErrorCode["VaultClosed"] = 6362] = "VaultClosed";
+    SapErrorCode[SapErrorCode["InsufficientVaultBalance"] = 6363] = "InsufficientVaultBalance";
+})(SapErrorCode || (SapErrorCode = {}));
+const ERROR_MAP = {
+    [SapErrorCode.NameTooLong]: { code: SapErrorCode.NameTooLong, name: "NameTooLong", message: "Agent name exceeds 64 characters.", recovery: "Shorten the agent name to ≤64 chars." },
+    [SapErrorCode.NameTooShort]: { code: SapErrorCode.NameTooShort, name: "NameTooShort", message: "Agent name is too short.", recovery: "Use at least 3 characters for the agent name." },
+    [SapErrorCode.InvalidEndpoint]: { code: SapErrorCode.InvalidEndpoint, name: "InvalidEndpoint", message: "Endpoint URI must start with http:// or https://.", recovery: "Provide a valid HTTP or HTTPS URL." },
+    [SapErrorCode.EndpointTooLong]: { code: SapErrorCode.EndpointTooLong, name: "EndpointTooLong", message: "Endpoint URI exceeds 256 characters.", recovery: "Shorten the endpoint URL." },
+    [SapErrorCode.AgentClosed]: { code: SapErrorCode.AgentClosed, name: "AgentClosed", message: "Agent has been closed.", recovery: "Re-register the agent or use a different wallet." },
+    [SapErrorCode.CallerNotAgentOwner]: { code: SapErrorCode.CallerNotAgentOwner, name: "CallerNotAgentOwner", message: "Signer is not the agent owner.", recovery: "Sign with the wallet that owns the agent." },
+    [SapErrorCode.StakeBelowMinimum]: { code: SapErrorCode.StakeBelowMinimum, name: "StakeBelowMinimum", message: `Stake is below minimum (${1} SOL).`, recovery: "Increase the stake amount to at least 1 SOL." },
+    [SapErrorCode.NotStaked]: { code: SapErrorCode.NotStaked, name: "NotStaked", message: "Wallet has no stake account.", recovery: "Call stake() first to create a stake account." },
+    [SapErrorCode.UnstakeTooSoon]: { code: SapErrorCode.UnstakeTooSoon, name: "UnstakeTooSoon", message: "Cannot unstake yet — wait for the cooldown period.", recovery: "Wait 14 days after requesting unstake before completing." },
+    [SapErrorCode.UnstakeExceedsStake]: { code: SapErrorCode.UnstakeExceedsStake, name: "UnstakeExceedsStake", message: "Unstake amount exceeds staked amount.", recovery: "Reduce unstake amount to ≤ staked amount." },
+    [SapErrorCode.CannotCloseAgentWithActiveEscrows]: { code: SapErrorCode.CannotCloseAgentWithActiveEscrows, name: "CannotCloseAgentWithActiveEscrows", message: "Agent has active escrows.", recovery: "Close all escrows or wait for expiry before closing agent." },
+    [SapErrorCode.InsufficientEscrowBalance]: { code: SapErrorCode.InsufficientEscrowBalance, name: "InsufficientEscrowBalance", message: "Escrow has insufficient balance for the operation.", recovery: "Deposit more funds or reduce the settlement/withdraw amount." },
+    [SapErrorCode.EscrowNotFound]: { code: SapErrorCode.EscrowNotFound, name: "EscrowNotFound", message: "Escrow account does not exist.", recovery: "Verify the PDA seeds or create the escrow first." },
+    [SapErrorCode.AmountMustBePositive]: { code: SapErrorCode.AmountMustBePositive, name: "AmountMustBePositive", message: "Amount must be > 0.", recovery: "Provide a positive amount." },
+    [SapErrorCode.PricePerCallMustBePositive]: { code: SapErrorCode.PricePerCallMustBePositive, name: "PricePerCallMustBePositive", message: "price_per_call must be > 0.", recovery: "Set price_per_call to a positive value." },
+    [SapErrorCode.InvalidVolumeCurve]: { code: SapErrorCode.InvalidVolumeCurve, name: "InvalidVolumeCurve", message: "Volume curve breakpoints are not strictly increasing.", recovery: "Ensure each breakpoint's after_calls > the previous." },
+    [SapErrorCode.VolumeCurveNotDescending]: { code: SapErrorCode.VolumeCurveNotDescending, name: "VolumeCurveNotDescending", message: "Volume curve prices are not non-increasing.", recovery: "Ensure each breakpoint's price ≤ previous." },
+    [SapErrorCode.TooManyVolumeCurvePoints]: { code: SapErrorCode.TooManyVolumeCurvePoints, name: "TooManyVolumeCurvePoints", message: "Volume curve exceeds max 10 points.", recovery: "Reduce volume curve to ≤10 breakpoints." },
+    [SapErrorCode.SettlementNotPending]: { code: SapErrorCode.SettlementNotPending, name: "SettlementNotPending", message: "Settlement is not in pending state.", recovery: "Verify the settlement index or file a dispute." },
+    [SapErrorCode.SettlementAlreadyFinalized]: { code: SapErrorCode.SettlementAlreadyFinalized, name: "SettlementAlreadyFinalized", message: "Settlement already finalized.", recovery: "Nothing to do — settlement is complete." },
+    [SapErrorCode.DisputeWindowNotExpired]: { code: SapErrorCode.DisputeWindowNotExpired, name: "DisputeWindowNotExpired", message: "Dispute window has not expired yet.", recovery: "Wait for the dispute window to close." },
+    [SapErrorCode.DisputeWindowExpired]: { code: SapErrorCode.DisputeWindowExpired, name: "DisputeWindowExpired", message: "Dispute window has expired.", recovery: "The deadline for filing a dispute has passed." },
+    [SapErrorCode.NotDepositor]: { code: SapErrorCode.NotDepositor, name: "NotDepositor", message: "Signer is not the depositor.", recovery: "Sign with the wallet that deposited into the escrow." },
+    [SapErrorCode.DisputeAlreadyFiled]: { code: SapErrorCode.DisputeAlreadyFiled, name: "DisputeAlreadyFiled", message: "A dispute has already been filed for this settlement.", recovery: "Wait for the dispute to resolve or file on a different settlement." },
+    [SapErrorCode.DisputeStillOpen]: { code: SapErrorCode.DisputeStillOpen, name: "DisputeStillOpen", message: "Dispute is still open.", recovery: "Wait for the dispute to reach a final outcome." },
+    [SapErrorCode.NotArbiter]: { code: SapErrorCode.NotArbiter, name: "NotArbiter", message: "Signer is not the designated arbiter.", recovery: "Sign with the arbiter wallet or wait for auto-resolution." },
+    [SapErrorCode.ArbiterRequired]: { code: SapErrorCode.ArbiterRequired, name: "ArbiterRequired", message: "Arbiter must be set for DisputeWindow mode.", recovery: "Provide a valid arbiter public key when creating the escrow." },
+    [SapErrorCode.CoSignerRequired]: { code: SapErrorCode.CoSignerRequired, name: "CoSignerRequired", message: "CoSigner must be set for CoSigned mode.", recovery: "Provide a valid co-signer public key when creating the escrow." },
+    [SapErrorCode.InvalidCoSigner]: { code: SapErrorCode.InvalidCoSigner, name: "InvalidCoSigner", message: "Invalid co-signer public key.", recovery: "Provide a valid public key for the co-signer." },
+    [SapErrorCode.InvalidDisputeOutcome]: { code: SapErrorCode.InvalidDisputeOutcome, name: "InvalidDisputeOutcome", message: "Invalid dispute outcome.", recovery: "Outcome must be DepositorWins (1), AgentWins (2), or Refunded (3)." },
+    [SapErrorCode.EscrowEmpty]: { code: SapErrorCode.EscrowEmpty, name: "EscrowEmpty", message: "Escrow balance is zero.", recovery: "Deposit funds before withdrawing or settling." },
+    [SapErrorCode.EscrowAlreadyExpired]: { code: SapErrorCode.EscrowAlreadyExpired, name: "EscrowAlreadyExpired", message: "Escrow has already expired at the time of creation.", recovery: "Set expires_at to a future timestamp or 0 (never)." },
+    [SapErrorCode.EscrowExpired]: { code: SapErrorCode.EscrowExpired, name: "EscrowExpired", message: "Escrow has expired.", recovery: "Create a new escrow or withdraw remaining balance." },
+    [SapErrorCode.ReceiptBatchNotFound]: { code: SapErrorCode.ReceiptBatchNotFound, name: "ReceiptBatchNotFound", message: "Receipt batch not found.", recovery: "Create a receipt batch first." },
+    [SapErrorCode.InvalidReceiptProof]: { code: SapErrorCode.InvalidReceiptProof, name: "InvalidReceiptProof", message: "Receipt proof does not verify.", recovery: "Verify the receipt hash and merkle proof are correct." },
+    [SapErrorCode.InvalidMerkleProof]: { code: SapErrorCode.InvalidMerkleProof, name: "InvalidMerkleProof", message: "Merkle proof structure is invalid.", recovery: "Check merkle proof depth (≤16) and sibling hashes." },
+    [SapErrorCode.SubscriptionNotFound]: { code: SapErrorCode.SubscriptionNotFound, name: "SubscriptionNotFound", message: "Subscription account does not exist.", recovery: "Create a subscription first." },
+    [SapErrorCode.NotSubscriber]: { code: SapErrorCode.NotSubscriber, name: "NotSubscriber", message: "Signer is not the subscriber.", recovery: "Sign with the wallet that created the subscription." },
+    [SapErrorCode.SubscriptionInsufficientBalance]: { code: SapErrorCode.SubscriptionInsufficientBalance, name: "SubscriptionInsufficientBalance", message: "Subscription has insufficient balance.", recovery: "Fund the subscription before claiming." },
+    [SapErrorCode.SubscriptionIntervalOverflow]: { code: SapErrorCode.SubscriptionIntervalOverflow, name: "SubscriptionIntervalOverflow", message: "Claimable intervals exceed u32 range.", recovery: "Claim in smaller batches." },
+    [SapErrorCode.SubscriptionDurationTooLong]: { code: SapErrorCode.SubscriptionDurationTooLong, name: "SubscriptionDurationTooLong", message: "Subscription duration exceeds 10 years.", recovery: "Reduce the subscription duration." },
+    [SapErrorCode.ArithmeticOverflow]: { code: SapErrorCode.ArithmeticOverflow, name: "ArithmeticOverflow", message: "Arithmetic operation overflow.", recovery: "Reduce amounts to stay within u64 range." },
+    [SapErrorCode.VaultNotFound]: { code: SapErrorCode.VaultNotFound, name: "VaultNotFound", message: "Vault account does not exist.", recovery: "Create a vault first." },
+    [SapErrorCode.VaultAlreadyInitialized]: { code: SapErrorCode.VaultAlreadyInitialized, name: "VaultAlreadyInitialized", message: "Vault is already initialized.", recovery: "Use the existing vault or close it first." },
+    [SapErrorCode.NotVaultOwner]: { code: SapErrorCode.NotVaultOwner, name: "NotVaultOwner", message: "Signer is not the vault owner.", recovery: "Sign with the agent wallet that owns the vault." },
+    [SapErrorCode.NotDelegate]: { code: SapErrorCode.NotDelegate, name: "NotDelegate", message: "Signer is not a vault delegate.", recovery: "Add the signer as a vault delegate first." },
+    [SapErrorCode.DelegateExpired]: { code: SapErrorCode.DelegateExpired, name: "DelegateExpired", message: "Vault delegate has expired.", recovery: "Renew the delegate or use the owner wallet." },
+    [SapErrorCode.InvalidPermissions]: { code: SapErrorCode.InvalidPermissions, name: "InvalidPermissions", message: "Invalid vault delegate permissions.", recovery: "Use a valid permission bitmask (1=inscribe, 2=close, 4=open)." },
+    [SapErrorCode.SessionNotFound]: { code: SapErrorCode.SessionNotFound, name: "SessionNotFound", message: "Session ledger does not exist.", recovery: "Create a session first." },
+    [SapErrorCode.EpochNotFound]: { code: SapErrorCode.EpochNotFound, name: "EpochNotFound", message: "Epoch page does not exist.", recovery: "Create an epoch first." },
+    [SapErrorCode.VaultAlreadyOpen]: { code: SapErrorCode.VaultAlreadyOpen, name: "VaultAlreadyOpen", message: "Vault is already open.", recovery: "Vault is already initialized — proceed with inscription." },
+    [SapErrorCode.InvalidSequence]: { code: SapErrorCode.InvalidSequence, name: "InvalidSequence", message: "Inscription sequence is invalid.", recovery: "Use the next expected sequence number." },
+    [SapErrorCode.FragmentTooLarge]: { code: SapErrorCode.FragmentTooLarge, name: "FragmentTooLarge", message: "Inscription fragment exceeds max size.", recovery: "Split the inscription into smaller fragments." },
+    [SapErrorCode.VaultClosed]: { code: SapErrorCode.VaultClosed, name: "VaultClosed", message: "Vault has been closed.", recovery: "Re-open the vault or create a new one." },
+    [SapErrorCode.InsufficientVaultBalance]: { code: SapErrorCode.InsufficientVaultBalance, name: "InsufficientVaultBalance", message: "Vault has insufficient balance.", recovery: "Deposit more funds into the vault." },
+    // ── v0.13 Hardening Errors ──
+    [SapErrorCode.PendingAmountMismatch]: { code: SapErrorCode.PendingAmountMismatch, name: "PendingAmountMismatch", message: "Pending settlement amount does not match escrow.", recovery: "This is a protocol bug — escalate immediately." },
+    [SapErrorCode.MaxCallsPerSettlementExceeded]: { code: SapErrorCode.MaxCallsPerSettlementExceeded, name: "MaxCallsPerSettlementExceeded", message: "Calls per settlement exceeds 10,000.", recovery: "Split settlement into multiple batches of ≤10,000 calls." },
+    [SapErrorCode.InvalidVolumeCurvePrice]: { code: SapErrorCode.InvalidVolumeCurvePrice, name: "InvalidVolumeCurvePrice", message: "Volume curve breakpoint price must be > 0.", recovery: "Set price_per_call > 0 for all breakpoints." },
+    [SapErrorCode.EscrowCoverageExceeded]: { code: SapErrorCode.EscrowCoverageExceeded, name: "EscrowCoverageExceeded", message: "Escrow deposit would exceed agent staked coverage.", recovery: "Increase agent stake or reduce deposit amount." },
+    [SapErrorCode.CoSignerIsAgentWallet]: { code: SapErrorCode.CoSignerIsAgentWallet, name: "CoSignerIsAgentWallet", message: "Co-signer cannot be the agent's own wallet.", recovery: "Use a different wallet for the co-signer." },
+    [SapErrorCode.PendingSettlementExists]: { code: SapErrorCode.PendingSettlementExists, name: "PendingSettlementExists", message: "Escrow has an unresolved pending settlement.", recovery: "Finalize or dispute the pending settlement before closing." },
+    [SapErrorCode.TokenAccountOwnerMismatch]: { code: SapErrorCode.TokenAccountOwnerMismatch, name: "TokenAccountOwnerMismatch", message: "SPL token account owner mismatch.", recovery: "Verify the destination token account belongs to the depositor." },
+    [SapErrorCode.MaxReceiptProofExceeded]: { code: SapErrorCode.MaxReceiptProofExceeded, name: "MaxReceiptProofExceeded", message: "Receipt proof exceeds 128 receipts.", recovery: "Submit proof in chunks of ≤128 receipts." },
+    [SapErrorCode.MaxMerkleDepthExceeded]: { code: SapErrorCode.MaxMerkleDepthExceeded, name: "MaxMerkleDepthExceeded", message: "Merkle proof depth exceeds 16.", recovery: "Verify merkle tree depth (≤16)." },
+    [SapErrorCode.StakeSlashLocksUnstake]: { code: SapErrorCode.StakeSlashLocksUnstake, name: "StakeSlashLocksUnstake", message: "Stake slash would lock unstake request.", recovery: "The unstake was reduced proportionally — retry." },
+};
+/** Decode an Anchor transaction error into structured info */
+export function decodeSapError(err) {
+    // Anchor custom error format: { error: { errorCode: { code: number, number: number, ... }, ... } }
+    const anyErr = err;
+    let code;
+    // Anchor 0.30 format
+    if (anyErr.error?.errorCode?.code != null) {
+        code = anyErr.error.errorCode.code;
+    }
+    else if (anyErr.error?.errorCode?.number != null) {
+        code = anyErr.error.errorCode.number;
+    }
+    else if (anyErr.error?.instructionError?.[1]?.Custom != null) {
+        code = anyErr.error.instructionError[1].Custom;
+    }
+    if (code != null && ERROR_MAP[code]) {
+        return ERROR_MAP[code];
+    }
+    // Attempt log-based detection
+    if (anyErr.logs) {
+        for (const log of anyErr.logs) {
+            const match = log.match(/Error Code:\s*(\d+)/);
+            if (match) {
+                const logCode = parseInt(match[1], 10);
+                if (ERROR_MAP[logCode])
+                    return ERROR_MAP[logCode];
+            }
+        }
+    }
+    return {
+        code: (code ?? -9999),
+        name: "UnknownError",
+        message: err?.message ?? "Unknown transaction error",
+        recovery: "Check transaction logs or retry with a different configuration.",
+    };
+}
+/** Is this error retryable? */
+export function isRetryableError(err) {
+    const retryable = [
+        SapErrorCode.DisputeWindowNotExpired,
+        SapErrorCode.UnstakeTooSoon,
+        SapErrorCode.EscrowExpired, // can retry with new escrow
+    ];
+    return retryable.includes(err.code);
+}
+/** Is this a client-side validation error that should have been caught before sending?
+ *  If true, the SDK's validate functions have a bug.
+ */
+export function isClientValidationFailure(err) {
+    const client = [
+        SapErrorCode.AmountMustBePositive,
+        SapErrorCode.PricePerCallMustBePositive,
+        SapErrorCode.InvalidVolumeCurve,
+        SapErrorCode.VolumeCurveNotDescending,
+        SapErrorCode.TooManyVolumeCurvePoints,
+        SapErrorCode.MaxCallsPerSettlementExceeded,
+        SapErrorCode.InvalidVolumeCurvePrice,
+        SapErrorCode.EscrowAlreadyExpired,
+        SapErrorCode.CoSignerIsAgentWallet,
+        SapErrorCode.MaxReceiptProofExceeded,
+        SapErrorCode.MaxMerkleDepthExceeded,
+        SapErrorCode.SubscriptionDurationTooLong,
+    ];
+    return client.includes(err.code);
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

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

package/dist/esm/events/geyser.d.ts

@@ -0,0 +1,150 @@
+/**
+ * @module events/geyser
+ * @description Yellowstone gRPC (Geyser) event stream for SAP v2.
+ *
+ * Drop-in alternative to the WebSocket `connection.onLogs()` pipeline.
+ * Uses Triton / Helius / any Yellowstone-compatible gRPC endpoint to
+ * receive program transaction updates with sub-second latency and
+ * automatic reconnection.
+ *
+ * @category Events
+ * @since v0.6.3
+ *
+ * @example
+ * ```ts
+ * import { GeyserEventStream } from "@oobe-protocol-labs/synapse-sap-sdk";
+ * import { EventParser }       from "@oobe-protocol-labs/synapse-sap-sdk";
+ *
+ * const stream = new GeyserEventStream({
+ *   endpoint:  "https://grpc.triton.one",
+ *   token:     process.env.GEYSER_TOKEN!,
+ *   programId: "SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ",
+ * });
+ *
+ * const parser = new EventParser(program);
+ *
+ * stream.on("logs", (logs, signature, slot) => {
+ *   const events = parser.parseLogs(logs);
+ *   for (const event of events) {
+ *     console.log(event.name, event.data);
+ *   }
+ * });
+ *
+ * stream.on("error", (err) => console.error("gRPC error:", err));
+ *
+ * await stream.connect();
+ * // ... later
+ * await stream.disconnect();
+ * ```
+ */
+import { EventEmitter } from "events";
+/**
+ * Configuration for the Yellowstone gRPC event stream.
+ *
+ * @interface GeyserConfig
+ * @since v0.6.3
+ */
+export interface GeyserConfig {
+    /** Yellowstone gRPC endpoint URL (e.g. "https://grpc.triton.one") */
+    endpoint: string;
+    /** Authentication token for the gRPC endpoint */
+    token: string;
+    /** SAP program ID to filter. Defaults to SAP v2 program. */
+    programId?: string;
+    /**
+     * Commitment level for the subscription.
+     * @default "confirmed"
+     */
+    commitment?: "processed" | "confirmed" | "finalized";
+    /**
+     * Automatically reconnect on disconnect.
+     * @default true
+     */
+    autoReconnect?: boolean;
+    /**
+     * Delay between reconnection attempts in ms.
+     * @default 3000
+     */
+    reconnectDelayMs?: number;
+    /**
+     * Maximum number of reconnection attempts. 0 = unlimited.
+     * @default 0
+     */
+    maxReconnectAttempts?: number;
+    /**
+     * Include failed transactions in the stream.
+     * @default false
+     */
+    includeFailedTxs?: boolean;
+}
+/**
+ * Events emitted by {@link GeyserEventStream}.
+ *
+ * @interface GeyserStreamEvents
+ * @since v0.6.3
+ */
+export interface GeyserStreamEvents {
+    /**
+     * Emitted for each transaction's log messages.
+     * Same shape as `connection.onLogs()` callback — plug into `EventParser.parseLogs()`.
+     */
+    logs: (logs: string[], signature: string, slot: number) => void;
+    /** Emitted when the gRPC stream connects or reconnects. */
+    connected: () => void;
+    /** Emitted when the stream disconnects. */
+    disconnected: (reason: string) => void;
+    /** Emitted on transport or parsing errors. */
+    error: (err: Error) => void;
+    /** Emitted on reconnection attempt. */
+    reconnecting: (attempt: number) => void;
+}
+/**
+ * Yellowstone gRPC event stream for SAP v2 programs.
+ *
+ * Wraps `@triton-one/yellowstone-grpc` and emits parsed log lines
+ * compatible with the existing {@link EventParser}.
+ *
+ * @name GeyserEventStream
+ * @category Events
+ * @since v0.6.3
+ *
+ * @example
+ * ```ts
+ * const stream = new GeyserEventStream({
+ *   endpoint: "https://grpc.triton.one",
+ *   token:    process.env.GEYSER_TOKEN!,
+ * });
+ *
+ * stream.on("logs", (logs, sig, slot) => {
+ *   const events = parser.parseLogs(logs);
+ *   events.forEach(e => db.insertEvent(e));
+ * });
+ *
+ * await stream.connect();
+ * ```
+ */
+export declare class GeyserEventStream extends EventEmitter {
+    private readonly config;
+    private client;
+    private stream;
+    private reconnectAttempts;
+    private _connected;
+    private _stopped;
+    constructor(config: GeyserConfig);
+    /** Whether the gRPC stream is currently connected. */
+    get connected(): boolean;
+    /**
+     * Connect to the Yellowstone gRPC endpoint and start streaming.
+     *
+     * @throws If `@triton-one/yellowstone-grpc` is not installed.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the gRPC stream and stop reconnection.
+     */
+    disconnect(): Promise<void>;
+    private subscribe;
+    private handleMessage;
+    private maybeReconnect;
+}
+//# sourceMappingURL=geyser.d.ts.map

package/dist/esm/events/geyser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geyser.d.ts","sourceRoot":"","sources":["../../../src/events/geyser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IAEjB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IAEd,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;IAErD;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhE,2DAA2D;IAC3D,SAAS,EAAE,MAAM,IAAI,CAAC;IAEtB,2CAA2C;IAC3C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEvC,8CAA8C;IAC9C,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAE5B,uCAAuC;IACvC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,OAAO,CAAC,MAAM,CAAa;IAE3B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,YAAY;IAchC,sDAAsD;IACtD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBnB,SAAS;IA8EvB,OAAO,CAAC,aAAa;YA2BP,cAAc;CAqB7B"}

package/dist/esm/events/index.d.ts

@@ -0,0 +1,17 @@
+import { TransactionSignature } from "@solana/web3.js";
+import { Program } from "@coral-xyz/anchor";
+export type SapEventName = "EscrowCreated" | "SettlementFiled" | "SettlementFinalized" | "DisputeFiled" | "DisputeResolved" | "StakeEvent" | "SubscriptionEvent";
+export interface ParsedEvent {
+    name: SapEventName;
+    data: Record<string, unknown>;
+    signature: TransactionSignature;
+    slot: number;
+}
+export declare class EventParser {
+    private program;
+    constructor(program: Program);
+    parseLogs(logs: string[]): ParsedEvent[];
+}
+export declare function parseEventsFromLogs(logs: string[], signature: TransactionSignature): ParsedEvent[];
+export declare function fetchTransactionEvents(connection: any, signature: TransactionSignature): Promise<ParsedEvent[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/events/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,MAAM,MAAM,YAAY,GACpB,eAAe,GACf,iBAAiB,GACjB,qBAAqB,GACrB,cAAc,GACd,iBAAiB,GACjB,YAAY,GACZ,mBAAmB,CAAC;AAExB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,oBAAoB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,WAAW;IACV,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAEpC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE;CAsBzC;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,oBAAoB,GAC9B,WAAW,EAAE,CAGf;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,oBAAoB,GAC9B,OAAO,CAAC,WAAW,EAAE,CAAC,CAIxB"}