# Using pnpm
pnpm add @oobe-protocol-labs/synapse-sap-sdk @coral-xyz/anchor @solana/web3.js

# Using yarn
yarn add @oobe-protocol-labs/synapse-sap-sdk @coral-xyz/anchor @solana/web3.js

# Using npm
npm install @oobe-protocol-labs/synapse-sap-sdk @coral-xyz/anchor @solana/web3.js

# Optional: only needed for the plugin adapter (LangChain tools)
pnpm add zod

synapse-sap-sdk/src/
├── core/
│   ├── client.ts          SapClient root entry point
│   └── connection.ts      SapConnection cluster helpers
├── modules/
│   ├── base.ts            BaseModule abstract class
│   ├── agent.ts           AgentModule
│   ├── feedback.ts        FeedbackModule
│   ├── indexing.ts        IndexingModule
│   ├── tools.ts           ToolsModule
│   ├── vault.ts           VaultModule
│   ├── escrow.ts          EscrowModule
│   ├── attestation.ts     AttestationModule
│   └── ledger.ts          LedgerModule (renamed from staking in v0.20.0)
├── registries/
│   ├── discovery.ts       DiscoveryRegistry
│   ├── x402.ts            X402Registry
│   ├── session.ts         SessionManager
│   └── builder.ts         AgentBuilder
├── plugin/
│   ├── index.ts           SynapseAgentKit (LangChain adapter)
│   ├── protocols.ts       Protocol handlers
│   └── schemas.ts         Zod schemas for 52 tools
├── constants/
│   ├── programs.ts        SAP_PROGRAM_ID
│   ├── seeds.ts           PDA seed prefixes
│   └── limits.ts          On-chain size/count limits
├── pda/
│   └── index.ts           All PDA derivation functions (17 total)
├── events/
│   └── index.ts           EventParser (38 events decoded)
├── errors/
│   └── index.ts           Typed error handling (SapError, SapRpcError, etc.)
├── types/
│   ├── accounts.ts        Deserialized account interfaces (17 parsers)
│   ├── instructions.ts    Instruction argument DTOs
│   ├── common.ts          Shared structs
│   └── enums.ts           Anchor-style enum kinds
├── utils/
│   ├── hash.ts            SHA-256, content hashing
│   ├── serialization.ts   Buffer encoding helpers
│   └── validation.ts      Input validation guards
└── idl/
    └── synapse_agent_sap.json  Embedded IDL

@oobe-protocol-labs/synapse-sap-sdk@0.20.0
├── Domain Modules (8)     # Low-level instruction builders
│   ├── agent              # Register, update, close agents
│   ├── escrow             # V2 escrow lifecycle
│   ├── vault              # Memory vault operations
│   ├── tools              # Tool publishing + schemas
│   ├── attestation        # Web-of-trust attestations
│   ├── dispute            # Dispute filing + resolution
│   ├── indexing           # Capability/protocol indexes
│   └── ledger             # Ring buffer memory writes
│
├── High-Level Registries (4)  # Abstracted workflows
│   ├── discovery          # Agent discovery + enrichment
│   ├── x402               # Payment headers + calls
│   ├── sessionManager     # Session lifecycle
│   └── agentBuilder       # Fluent agent registration
│
└── Plugin Adapter         # SynapseAgentKit integration
    └── plugin             # 52 tools for LangChain/ACP

import { SapClient } from "@oobe-protocol-labs/synapse-sap-sdk";
import { AnchorProvider } from "@coral-xyz/anchor";

// Initialize client
const client = SapClient.from(AnchorProvider.env());

// Register an agent
const agent = await client.agent.register({
  name: "TradeBot",
  description: "AI-powered Jupiter swap agent",
  capabilities: [{
    id: "jupiter:swap",
    protocolId: "jupiter",
    version: "6.0",
  }],
  pricing: [],
  protocols: ["jupiter", "A2A"],
});

// Start a session
const session = await client.session.start("conv-001");
await client.session.write(session, "User requested SOL to USDC swap");

// Write to ledger
await client.ledger.write(session, {
  tool: "jupiter:swap",
  input: { inputMint: "So11111111111111111111111111111111111111112" },
});