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

package/src/index.ts

@@ -1,421 +0,0 @@
-/**
- * @synapse-sap/sdk — TypeScript SDK for SAP v2 (Synapse Agent Protocol)
- *
- * Modular architecture:
- *
- * | Path              | Description                                   |
- * |-------------------|-----------------------------------------------|
- * | `core/`           | SapClient, SapConnection (RPC factory)        |
- * | `types/`          | On-chain enums, account data, instruction DTOs|
- * | `constants/`      | Program IDs, PDA seeds, size limits           |
- * | `pda/`            | Deterministic PDA derivation helpers          |
- * | `events/`         | Transaction-log event parser                  |
- * | `errors/`         | Typed SDK error classes                       |
- * | `utils/`          | Hashing, validation, serialization            |
- * | `modules/`        | Low-level per-domain instruction wrappers     |
- * | `registries/`     | High-level abstractions (discovery, x402, …)  |
- * | `plugin/`         | SynapseAgentKit adapter (52 tools)            |
- * | `parser/`         | Transaction decode, instruction + event parse |
- * | `idl/`            | Embedded Anchor IDL                           |
- *
- * @example
- * ```ts
- * import { SapClient, SapConnection } from "@synapse-sap/sdk";
- *
- * // Quick start — from Anchor provider
- * const client = SapClient.from(provider);
- *
- * // Or from RPC URL (synapse-client-sdk compatible)
- * const conn = SapConnection.devnet();
- * const client2 = conn.fromKeypair(keypair);
- *
- * // Use domain modules:
- * await client.agent.register({ ... });
- * await client.escrow.create(agentWallet, { ... });
- * await client.ledger.write(sessionPda, data, contentHash);
- *
- * // Use registries (high-level):
- * const agents = await client.discovery.findAgentsByProtocol("jupiter");
- * const ctx = await client.session.start("conv-123");
- * ```
- *
- * @packageDocumentation
- * @category SDK
- * @since v0.1.0
- */
-
-// ── Core ─────────────────────────────────────────────
-export { SapClient, SapConnection, KeypairWallet } from "./core";
-export type { SapCluster, SapConnectionConfig, SapWallet } from "./core";
-
-// ── Types ────────────────────────────────────────────
-export type {
-  // Enums
-  TokenTypeKind,
-  PluginTypeKind,
-  SettlementModeKind,
-  ToolHttpMethodKind,
-  ToolCategoryKind,
-  DelegatePermissionBit,
-  SchemaTypeValue,
-  CompressionTypeValue,
-  SettlementSecurityKind,
-  DisputeOutcomeKind,
-  BillingIntervalKind,
-  DisputeTypeValue,
-  ResolutionLayerKind,
-  // Helper structs
-  Capability,
-  VolumeCurveBreakpoint,
-  PricingTier,
-  PluginRef,
-  Settlement,
-  // Account data
-  AgentAccountData,
-  FeedbackAccountData,
-  CapabilityIndexData,
-  ProtocolIndexData,
-  GlobalRegistryData,
-  MemoryVaultData,
-  SessionLedgerData,
-  EpochPageData,
-  VaultDelegateData,
-  ToolDescriptorData,
-  SessionCheckpointData,
-  EscrowAccountData,
-  AgentStatsData,
-  ToolCategoryIndexData,
-  AgentAttestationData,
-  MemoryLedgerData,
-  LedgerPageData,
-  // V2.1 account data
-  EscrowAccountV2Data,
-  PendingSettlementData,
-  DisputeRecordData,
-  ReceiptBatchData,
-  AgentStakeData,
-  SubscriptionData,
-  CounterShardData,
-  IndexPageData,
-  // Instruction args
-  RegisterAgentArgs,
-  UpdateAgentArgs,
-  GiveFeedbackArgs,
-  UpdateFeedbackArgs,
-  PublishToolArgs,
-  UpdateToolArgs,
-  InscribeMemoryArgs,
-  CompactInscribeArgs,
-  CreateEscrowArgs,
-  CreateAttestationArgs,
-  InscribeToolSchemaArgs,
-  // V2.1 instruction args
-  CreateEscrowV2Args,
-  CreateSubscriptionArgs,
-  // v0.6.0 — Endpoint & Manifest types
-  EndpointDescriptor,
-  HealthCheckDescriptor,
-  ToolManifestEntry,
-  AgentManifest,
-  EndpointValidationResult,
-} from "./types";
-
-export {
-  TokenType,
-  PluginType,
-  SettlementMode,
-  ToolHttpMethod,
-  ToolCategory,
-  DelegatePermission,
-  SchemaType,
-  CompressionType,
-  SettlementSecurity,
-  DisputeOutcome,
-  BillingInterval,
-  DisputeType,
-  ResolutionLayer,
-} from "./types";
-
-// ── Constants ────────────────────────────────────────
-export {
-  SAP_PROGRAM_ADDRESS,
-  SAP_PROGRAM_ID,
-  MAINNET_SAP_PROGRAM_ID,
-  DEVNET_SAP_PROGRAM_ID,
-  LOCALNET_SAP_PROGRAM_ID,
-  SEEDS,
-  LIMITS,
-  AGENT_VERSION,
-  VAULT_PROTOCOL_VERSION,
-  TOOL_CATEGORY_VALUES,
-  HTTP_METHOD_VALUES,
-  SapNetwork,
-} from "./constants";
-export type { SapNetworkId } from "./constants";
-
-// ── IDL ──────────────────────────────────────────────
-export { SAP_IDL, IDL_PROGRAM_ADDRESS, IDL_METADATA } from "./idl/index";
-export type { SynapseAgentSapIDL } from "./idl/index";
-
-// ── PDA Derivation ───────────────────────────────────
-export {
-  deriveGlobalRegistry,
-  deriveAgent,
-  deriveAgentStats,
-  deriveFeedback,
-  deriveCapabilityIndex,
-  deriveProtocolIndex,
-  deriveToolCategoryIndex,
-  deriveVault,
-  deriveSession,
-  deriveEpochPage,
-  deriveVaultDelegate,
-  deriveCheckpoint,
-  deriveTool,
-  deriveEscrow,
-  deriveEscrowV2,
-  derivePendingSettlement,
-  deriveDispute,
-  deriveStake,
-  deriveSubscription,
-  deriveShard,
-  deriveIndexPage,
-  deriveAttestation,
-  deriveLedger,
-  deriveLedgerPage,
-  deriveReceiptBatch,
-  deriveSettlementReceipt,
-} from "./pda";
-
-// ── Utilities ────────────────────────────────────────
-export { sha256, hashToArray, assert, computeBatchRoot } from "./utils";
-export { serializeAccount, serializeValue } from "./utils";
-
-// v0.10 — payment + stake constants
-export {
-  USDC_MINT_MAINNET,
-  USDC_MINT_DEVNET,
-  MIN_AGENT_STAKE_LAMPORTS,
-  MAX_DELEGATE_DURATION_SECS,
-  isAcceptedUsdcMint,
-  isAcceptedPaymentToken,
-} from "./constants";
-
-// v0.6.0 — Network normalizer
-export {
-  normalizeNetworkId,
-  isNetworkEquivalent,
-  getNetworkGenesisHash,
-  getNetworkClusterName,
-  isKnownNetwork,
-} from "./utils";
-
-// v0.6.0 — Endpoint validation
-export {
-  validateEndpoint,
-  validateEndpointDescriptor,
-  validateHealthCheck,
-  validateAgentEndpoints,
-} from "./utils";
-export type { ValidateEndpointOptions } from "./utils";
-
-// v0.6.0 — RPC strategy & error classification
-export {
-  getRpcUrl,
-  getFallbackRpcUrl,
-  createDualConnection,
-  findATA,
-  classifyAnchorError,
-  extractAnchorErrorCode,
-} from "./utils";
-export type { RpcConfig, DualConnection, AtaResult } from "./utils";
-
-// v0.6.0 — Zod runtime schemas
-export {
-  createEnvSchema,
-  createEndpointDescriptorSchema,
-  createHealthCheckSchema,
-  createToolManifestEntrySchema,
-  createAgentManifestSchema,
-  createPreparePaymentSchema,
-  createRegisterAgentSchema,
-  createCallArgsSchema,
-  validateOrThrow,
-} from "./utils";
-
-// v0.6.2 — Priority fee & settle options
-export {
-  buildPriorityFeeIxs,
-  buildRpcOptions,
-  FAST_SETTLE_OPTIONS,
-  FAST_BATCH_SETTLE_OPTIONS,
-  DEFAULT_SETTLE_PRIORITY_FEE,
-  DEFAULT_SETTLE_COMPUTE_UNITS,
-  DEFAULT_BATCH_SETTLE_COMPUTE_UNITS,
-  computeBatchSettleCu,
-} from "./utils";
-export type {
-  PriorityFeeConfig,
-} from "./utils";
-
-// v0.6.4 — Escrow validation, merchant middleware, x402 direct
-export {
-  validateEscrowState,
-  attachSplAccounts,
-  toAccountMetas,
-  MissingEscrowAtaError,
-  SapMerchantValidator,
-  parseX402Headers,
-  getX402DirectPayments,
-} from "./utils";
-export type {
-  SplAccountMeta,
-  EscrowValidationResult,
-  ParsedX402Headers,
-  MerchantValidationResult,
-  X402DirectPayment,
-  SettlementPayload,
-  GetX402DirectOptions,
-} from "./utils";
-
-// ── Errors ───────────────────────────────────────────
-export {
-  SapError,
-  SapValidationError,
-  SapRpcError,
-  SapAccountNotFoundError,
-  SapTimeoutError,
-  SapPermissionError,
-} from "./errors";
-
-// ── Events ───────────────────────────────────────────
-export { EventParser, SAP_EVENT_NAMES } from "./events";
-export type {
-  SapEvent,
-  SapEventName,
-  ParsedEvent,
-  RegisteredEventData,
-  UpdatedEventData,
-  FeedbackEventData,
-  MemoryInscribedEventData,
-  PaymentSettledEventData,
-  LedgerEntryEventData,
-} from "./events";
-
-// ── Geyser (Yellowstone gRPC) ────────────────────────
-export { GeyserEventStream } from "./events/geyser";
-export type { GeyserConfig, GeyserStreamEvents } from "./events/geyser";
-
-// ── Modules (for advanced usage / tree-shaking) ──────
-export {
-  AgentModule,
-  FeedbackModule,
-  IndexingModule,
-  ToolsModule,
-  VaultModule,
-  EscrowModule,
-  EscrowV2Module,
-  ReceiptModule,
-  StakingModule,
-  SubscriptionModule,
-  AttestationModule,
-  LedgerModule,
-  BaseModule,
-} from "./modules/index";
-export type { SapProgram, SapTransactionResult } from "./modules/base";
-
-// ── Plugin (SynapseAgentKit integration) ─────────────
-export { createSAPPlugin, SAPPlugin } from "./plugin/index";
-export type {
-  SAPPluginConfig,
-  SynapsePlugin,
-  PluginMeta,
-  PluginContext,
-  PluginInstallResult,
-} from "./plugin/index";
-export type {
-  ProtocolMethod,
-  PluginProtocol,
-} from "./plugin/protocols";
-export { SAP_PROTOCOLS } from "./plugin/protocols";
-
-// ── PostgreSQL Adapter (off-chain mirror) ────────────────
-export { SapPostgres, SapSyncEngine, SAP_TABLE_MAP } from "./postgres";
-export type {
-  PgClient,
-  SyncAllResult,
-  SapAccountType,
-  SyncMeta,
-  AgentRow,
-  EscrowRow,
-  ToolRow,
-  LedgerRow,
-  EventRow,
-  SyncCursorRow,
-  SyncOptions,
-} from "./postgres";
-
-// ── Parser (transaction decode + instruction + events) ─
-export {
-  parseSapInstructionsFromTransaction,
-  parseSapInstructionNamesFromTransaction,
-  parseSapInstructionsFromList,
-  parseSapInstructionNamesFromList,
-  containsSapInstruction,
-  parseSapTransactionComplete,
-  parseSapTransactionBatch,
-  decodeInnerInstructions,
-  filterSapInnerInstructions,
-  extractAccountKeys,
-  TransactionParser,
-} from "./parser";
-export type {
-  DecodedSapInstruction,
-  DecodedInnerInstruction,
-  ParsedSapTransaction,
-  ParseFilterOptions,
-  SapInstructionCoder,
-  CompiledInner,
-  InnerInstructionGroup,
-} from "./parser";
-
-// ── Registries (high-level developer abstractions) ────
-export {
-  DiscoveryRegistry,
-  X402Registry,
-  SessionManager,
-  AgentBuilder,
-  MetaplexBridge,
-} from "./registries/index";
-export type {
-  DiscoveredAgent,
-  AgentProfile,
-  DiscoveredTool,
-  NetworkOverview,
-  ToolCategoryName,
-  CostEstimate,
-  PaymentContext,
-  PreparePaymentOptions,
-  X402Headers,
-  EscrowBalance,
-  SettlementResult,
-  BatchSettlementResult,
-  SettleOptions,
-  SessionContext,
-  WriteResult,
-  SealResult,
-  RingBufferEntry,
-  SessionStatus,
-  CapabilityInput,
-  PricingTierInput,
-  ToolInput,
-  RegisterResult,
-  RegisterWithToolsResult,
-  UnifiedProfile,
-  AgentIdentifierResolution,
-  MplAgentSnapshot,
-  Eip8004Registration,
-  Eip8004Service,
-  AttachAgentIdentityOpts,
-  UpdateAgentIdentityUriOpts,
-} from "./registries/index";