@oobe-protocol-labs/synapse-client-sdk 1.2.2 → 2.0.0

package/dist/cjs/ai/plugins/token/schemas.js

@@ -0,0 +1,268 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allTokenMethods = exports.tokenBridgingMethods = exports.tokenStakingMethods = exports.tokenSplMethods = void 0;
+/**
+ * @module ai/plugins/token/schemas
+ * @description Token Plugin — Zod schemas for SPL token operations.
+ *
+ * Covers:
+ *  - SPL Token operations    (deploy, transfer, burn, freeze, mint-to, close)
+ *  - Balance checks          (token + SOL native)
+ *  - Token metadata          (Metaplex token-metadata lookups)
+ *  - Staking                 (native SOL staking, JupSOL, Solayer sSOL)
+ *  - Bridging                (Wormhole cross-chain, deBridge DLN)
+ *  - Rug / safety checks     (token security analysis)
+ *
+ * @since 2.0.0
+ */
+const zod_1 = require("zod");
+const shared_1 = require("../../tools/protocols/shared");
+/* ═══════════════════════════════════════════════════════════════
+ *  Shared primitives
+ * ═══════════════════════════════════════════════════════════════ */
+const zMint = zod_1.z.string().describe('Token mint address (base58)');
+const zPubkey = zod_1.z.string().describe('Solana public key (base58)');
+const zAmount = zod_1.z.string().describe('Raw token amount (smallest unit, no decimals)');
+const zTx = zod_1.z.string().describe('Base64-encoded serialized transaction');
+/* ═══════════════════════════════════════════════════════════════
+ *  1. SPL Token — core operations
+ * ═══════════════════════════════════════════════════════════════ */
+const { register: regSpl, methods: splMethods } = (0, shared_1.createMethodRegistry)('spl-token');
+regSpl('deployToken', zod_1.z.object({
+    owner: zPubkey.describe('Token owner / mint authority wallet'),
+    name: zod_1.z.string().describe('Token name (stored in Metaplex metadata)'),
+    symbol: zod_1.z.string().max(10).describe('Token symbol (e.g. "MYTKN")'),
+    decimals: zod_1.z.number().int().min(0).max(18).default(9).describe('Token decimals (default: 9)'),
+    initialSupply: zAmount.optional().describe('Initial supply to mint to owner (default: 0)'),
+    uri: zod_1.z.string().url().optional().describe('URI to off-chain metadata JSON (image, description, etc.)'),
+    isMutable: zod_1.z.boolean().optional().default(true).describe('Whether metadata is mutable (default: true)'),
+    freezeAuthority: zPubkey.optional().describe('Freeze authority (default: owner). Set to null to disable.'),
+    mintAuthority: zPubkey.optional().describe('Mint authority (default: owner). Set to null for fixed supply.'),
+    sellerFeeBasisPoints: zod_1.z.number().int().min(0).max(10000).optional().describe('Royalty fee in bps (for fungible with metadata)'),
+}), zod_1.z.object({
+    mint: zMint.describe('Newly created mint address'),
+    ata: zPubkey.describe('Associated token account for the owner'),
+    metadataAddress: zPubkey.optional().describe('Metaplex metadata PDA address'),
+    tx: zTx,
+    signature: zod_1.z.string().optional(),
+}), 'Deploy a new SPL token with Metaplex metadata. Returns the mint address and an unsigned transaction.');
+regSpl('transfer', zod_1.z.object({
+    from: zPubkey.describe('Sender wallet address'),
+    to: zPubkey.describe('Recipient wallet address'),
+    mint: zMint.describe('Token mint address'),
+    amount: zAmount.describe('Amount to transfer (raw, smallest unit)'),
+    createAta: zod_1.z.boolean().optional().default(true).describe('Create recipient ATA if needed (default: true)'),
+    memo: zod_1.z.string().optional().describe('Optional memo to attach to the transaction'),
+}), zod_1.z.object({
+    tx: zTx,
+    fromAta: zPubkey.describe('Sender associated token account'),
+    toAta: zPubkey.describe('Recipient associated token account'),
+    signature: zod_1.z.string().optional(),
+}), 'Transfer SPL tokens between wallets. Optionally creates the recipient ATA.');
+regSpl('transferSol', zod_1.z.object({
+    from: zPubkey.describe('Sender wallet address'),
+    to: zPubkey.describe('Recipient wallet address'),
+    amount: zAmount.describe('Amount in lamports (1 SOL = 1_000_000_000 lamports)'),
+    memo: zod_1.z.string().optional().describe('Optional memo to attach'),
+}), zod_1.z.object({
+    tx: zTx,
+    signature: zod_1.z.string().optional(),
+}), 'Transfer native SOL between wallets via SystemProgram.transfer.');
+regSpl('getBalance', zod_1.z.object({
+    wallet: zPubkey.describe('Wallet address to check'),
+    mint: zMint.optional().describe('Token mint to check balance for (omit for SOL)'),
+}), zod_1.z.object({
+    balance: zAmount,
+    decimals: zod_1.z.number(),
+    uiAmount: zod_1.z.number().describe('Human-readable amount with decimals applied'),
+    mint: zMint.optional(),
+    symbol: zod_1.z.string().optional(),
+}), 'Get token or SOL balance for a wallet. If mint is omitted, returns native SOL balance.');
+regSpl('getTokenAccounts', zod_1.z.object({
+    wallet: zPubkey.describe('Wallet to query all token accounts for'),
+    showZeroBalance: zod_1.z.boolean().optional().default(false).describe('Include zero-balance accounts'),
+}), zod_1.z.object({
+    accounts: zod_1.z.array(zod_1.z.object({
+        mint: zMint,
+        ata: zPubkey,
+        amount: zAmount,
+        decimals: zod_1.z.number(),
+        uiAmount: zod_1.z.number(),
+        symbol: zod_1.z.string().optional(),
+        name: zod_1.z.string().optional(),
+        logoURI: zod_1.z.string().optional(),
+    })),
+    totalAccounts: zod_1.z.number(),
+    nativeSolBalance: zAmount,
+}), 'List all SPL token accounts for a wallet with balances and metadata.');
+regSpl('mintTo', zod_1.z.object({
+    mint: zMint.describe('Token mint address'),
+    mintAuthority: zPubkey.describe('Mint authority wallet'),
+    destination: zPubkey.describe('Wallet to receive minted tokens'),
+    amount: zAmount.describe('Amount to mint (raw, smallest unit)'),
+}), zod_1.z.object({ tx: zTx, signature: zod_1.z.string().optional() }), 'Mint additional tokens to a destination wallet (requires mint authority).');
+regSpl('burn', zod_1.z.object({
+    mint: zMint,
+    owner: zPubkey.describe('Token account owner'),
+    amount: zAmount.describe('Amount to burn'),
+}), zod_1.z.object({ tx: zTx, signature: zod_1.z.string().optional() }), 'Burn SPL tokens from the owner\'s token account.');
+regSpl('freezeAccount', zod_1.z.object({
+    mint: zMint,
+    account: zPubkey.describe('Token account to freeze'),
+    freezeAuthority: zPubkey.describe('Freeze authority wallet'),
+}), zod_1.z.object({ tx: zTx, signature: zod_1.z.string().optional() }), 'Freeze a token account (prevents all transfers). Requires freeze authority.');
+regSpl('thawAccount', zod_1.z.object({
+    mint: zMint,
+    account: zPubkey.describe('Token account to thaw'),
+    freezeAuthority: zPubkey.describe('Freeze authority wallet'),
+}), zod_1.z.object({ tx: zTx, signature: zod_1.z.string().optional() }), 'Thaw (unfreeze) a previously frozen token account.');
+regSpl('closeAccount', zod_1.z.object({
+    account: zPubkey.describe('Token account to close'),
+    owner: zPubkey.describe('Token account owner'),
+    destination: zPubkey.optional().describe('Wallet to receive rent SOL (default: owner)'),
+}), zod_1.z.object({ tx: zTx, reclaimedLamports: zAmount, signature: zod_1.z.string().optional() }), 'Close a token account and reclaim the rent SOL.');
+regSpl('rugCheck', zod_1.z.object({
+    mint: zMint.describe('Token mint to analyze'),
+}), zod_1.z.object({
+    mint: zMint,
+    riskLevel: zod_1.z.enum(['safe', 'low', 'medium', 'high', 'critical']),
+    risks: zod_1.z.array(zod_1.z.object({
+        type: zod_1.z.string(),
+        severity: zod_1.z.enum(['info', 'warning', 'critical']),
+        message: zod_1.z.string(),
+    })),
+    details: zod_1.z.object({
+        hasMintAuthority: zod_1.z.boolean(),
+        hasFreezeAuthority: zod_1.z.boolean(),
+        topHoldersPercent: zod_1.z.number().optional(),
+        isVerified: zod_1.z.boolean().optional(),
+        liquidity: zod_1.z.number().optional(),
+        holderCount: zod_1.z.number().optional(),
+    }),
+}), 'Check a token for potential rug pull risks: mint/freeze authority, holder concentration, liquidity.');
+/* ═══════════════════════════════════════════════════════════════
+ *  2. Staking — SOL staking + liquid staking protocols
+ * ═══════════════════════════════════════════════════════════════ */
+const { register: regStake, methods: stakingMethods } = (0, shared_1.createMethodRegistry)('staking');
+regStake('stakeSOL', zod_1.z.object({
+    wallet: zPubkey.describe('Wallet to stake from'),
+    amount: zAmount.describe('Amount in lamports to stake'),
+    validator: zPubkey.optional().describe('Validator vote account (default: auto-selected high-quality validator)'),
+}), zod_1.z.object({
+    stakeAccount: zPubkey,
+    tx: zTx,
+    estimatedApy: zod_1.z.number().optional(),
+    signature: zod_1.z.string().optional(),
+}), 'Stake native SOL to a validator. Creates a stake account and delegates.');
+regStake('unstakeSOL', zod_1.z.object({
+    wallet: zPubkey,
+    stakeAccount: zPubkey.describe('Stake account to deactivate and withdraw'),
+}), zod_1.z.object({ tx: zTx, signature: zod_1.z.string().optional() }), 'Deactivate and withdraw SOL from a stake account.');
+regStake('getStakeAccounts', zod_1.z.object({
+    wallet: zPubkey.describe('Wallet to query stake accounts for'),
+}), zod_1.z.object({
+    accounts: zod_1.z.array(zod_1.z.object({
+        address: zPubkey,
+        lamports: zAmount,
+        state: zod_1.z.enum(['activating', 'active', 'deactivating', 'inactive']),
+        validator: zPubkey.optional(),
+        activationEpoch: zod_1.z.number().optional(),
+        deactivationEpoch: zod_1.z.number().optional(),
+    })),
+    totalStaked: zAmount,
+}), 'List all stake accounts for a wallet with delegation status.');
+regStake('stakeJupSOL', zod_1.z.object({
+    wallet: zPubkey,
+    amount: zAmount.describe('Amount in lamports to stake for jupSOL'),
+}), zod_1.z.object({
+    tx: zTx,
+    jupsolAmount: zAmount.describe('Expected jupSOL received'),
+    exchangeRate: zod_1.z.number().describe('SOL/jupSOL exchange rate'),
+    signature: zod_1.z.string().optional(),
+}), 'Stake SOL for jupSOL (Jupiter liquid staking). Instant liquidity, auto-compounding.');
+regStake('unstakeJupSOL', zod_1.z.object({
+    wallet: zPubkey,
+    amount: zAmount.describe('Amount of jupSOL to unstake'),
+}), zod_1.z.object({
+    tx: zTx,
+    solAmount: zAmount.describe('Expected SOL received'),
+    signature: zod_1.z.string().optional(),
+}), 'Unstake jupSOL back to SOL.');
+regStake('stakeSolayer', zod_1.z.object({
+    wallet: zPubkey,
+    amount: zAmount.describe('Amount in lamports to stake for sSOL'),
+}), zod_1.z.object({
+    tx: zTx,
+    ssolAmount: zAmount.describe('Expected sSOL received'),
+    exchangeRate: zod_1.z.number().describe('SOL/sSOL exchange rate'),
+    signature: zod_1.z.string().optional(),
+}), 'Stake SOL for sSOL via Solayer. Re-staking protocol with additional yield.');
+regStake('unstakeSolayer', zod_1.z.object({
+    wallet: zPubkey,
+    amount: zAmount.describe('Amount of sSOL to unstake'),
+}), zod_1.z.object({
+    tx: zTx,
+    solAmount: zAmount.describe('Expected SOL received'),
+    signature: zod_1.z.string().optional(),
+}), 'Unstake sSOL back to SOL via Solayer.');
+/* ═══════════════════════════════════════════════════════════════
+ *  3. Bridging — Wormhole + deBridge DLN
+ * ═══════════════════════════════════════════════════════════════ */
+const { register: regBridge, methods: bridgingMethods } = (0, shared_1.createMethodRegistry)('bridging');
+regBridge('bridgeWormhole', zod_1.z.object({
+    sourceChain: zod_1.z.string().describe('Source chain identifier (e.g. "solana", "ethereum", "base", "polygon")'),
+    destinationChain: zod_1.z.string().describe('Destination chain identifier'),
+    token: zMint.describe('Token address on source chain'),
+    amount: zAmount.describe('Amount to bridge (raw, smallest unit)'),
+    sender: zPubkey.describe('Sender wallet on source chain'),
+    recipient: zod_1.z.string().describe('Recipient address on destination chain'),
+    relayerFee: zAmount.optional().describe('Relayer fee amount (if using automatic relaying)'),
+}), zod_1.z.object({
+    tx: zTx,
+    sequence: zod_1.z.string().describe('Wormhole sequence number'),
+    emitterAddress: zod_1.z.string(),
+    estimatedArrival: zod_1.z.string().optional().describe('Estimated arrival time (ISO 8601)'),
+    signature: zod_1.z.string().optional(),
+}), 'Bridge tokens across chains via Wormhole. Supports Solana ↔ EVM chains.');
+regBridge('bridgeWormholeStatus', zod_1.z.object({
+    sequence: zod_1.z.string().describe('Wormhole sequence number from bridgeWormhole response'),
+    sourceChain: zod_1.z.string(),
+}), zod_1.z.object({
+    status: zod_1.z.enum(['pending', 'signed', 'completed', 'failed']),
+    vaaHash: zod_1.z.string().optional(),
+    destinationTx: zod_1.z.string().optional(),
+    completedAt: zod_1.z.string().optional(),
+}), 'Check the status of a Wormhole bridge transfer.');
+regBridge('bridgeDeBridge', zod_1.z.object({
+    sourceChain: zod_1.z.number().describe('Source chain ID (e.g. 7565164 for Solana)'),
+    destinationChain: zod_1.z.number().describe('Destination chain ID'),
+    tokenIn: zod_1.z.string().describe('Token address on source chain'),
+    tokenOut: zod_1.z.string().describe('Token address on destination chain (use "0x0" for native)'),
+    amount: zAmount.describe('Amount to bridge (raw)'),
+    sender: zod_1.z.string().describe('Sender address'),
+    recipient: zod_1.z.string().describe('Recipient address on destination chain'),
+    slippageBps: zod_1.z.number().optional().default(50).describe('Slippage tolerance in bps'),
+}), zod_1.z.object({
+    tx: zTx,
+    orderId: zod_1.z.string().describe('deBridge DLN order ID'),
+    estimatedOutput: zAmount,
+    fee: zAmount.describe('Bridge fee'),
+    estimatedArrival: zod_1.z.string().optional(),
+    signature: zod_1.z.string().optional(),
+}), 'Bridge tokens across chains via deBridge DLN. Fast cross-chain transfers with deterministic pricing.');
+regBridge('bridgeDeBridgeStatus', zod_1.z.object({
+    orderId: zod_1.z.string().describe('deBridge DLN order ID'),
+}), zod_1.z.object({
+    status: zod_1.z.enum(['created', 'fulfilled', 'cancelled', 'expired']),
+    sourceChainTx: zod_1.z.string().optional(),
+    destinationChainTx: zod_1.z.string().optional(),
+    completedAt: zod_1.z.string().optional(),
+}), 'Check the status of a deBridge DLN cross-chain transfer.');
+/* ═══════════════════════════════════════════════════════════════
+ *  Exports
+ * ═══════════════════════════════════════════════════════════════ */
+exports.tokenSplMethods = splMethods;
+exports.tokenStakingMethods = stakingMethods;
+exports.tokenBridgingMethods = bridgingMethods;
+exports.allTokenMethods = [...splMethods, ...stakingMethods, ...bridgingMethods];
+//# sourceMappingURL=schemas.js.map

package/dist/cjs/ai/plugins/token/schemas.js.map

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

package/dist/cjs/ai/plugins/types.d.ts

@@ -0,0 +1,176 @@
+import type { ProtocolMethod, ProtocolToolkit, ProtocolTool, CreateProtocolToolsOpts } from '../tools/protocols/shared';
+import type { SynapseClientLike } from '../../core/client';
+/**
+ * @description Metadata about a plugin — displayed in tooling and MCP manifests.
+ * @since 2.0.0
+ */
+export interface PluginMeta {
+    /** Unique plugin identifier (e.g. 'token', 'nft', 'defi'). */
+    id: string;
+    /** Human-readable name. */
+    name: string;
+    /** Short description of the plugin's capabilities. */
+    description: string;
+    /** Semantic version string. */
+    version: string;
+    /** Plugin author or org. */
+    author?: string;
+    /** Capability tags for SAP/MCP discovery. */
+    tags?: string[];
+    /** MCP resource URIs this plugin can serve. */
+    mcpResources?: string[];
+    /** Dependent plugin IDs (auto-loaded if available). */
+    dependencies?: string[];
+}
+/**
+ * @description A protocol within a plugin — groups methods under a namespace.
+ *
+ * Each plugin can contain multiple protocols (e.g. the DeFi plugin has
+ * 'orca', 'meteora', 'drift', etc.).
+ *
+ * @since 2.0.0
+ */
+export interface PluginProtocol {
+    /** Protocol identifier (e.g. 'orca', 'meteora', 'pump'). */
+    id: string;
+    /** Human-readable name (e.g. 'Orca Whirlpool'). */
+    name: string;
+    /** Registered methods for this protocol. */
+    methods: readonly ProtocolMethod[];
+    /** Default API base URL (for REST-based protocols). */
+    baseUrl?: string;
+    /** Whether this protocol requires the Synapse RPC client. */
+    requiresClient?: boolean;
+}
+/**
+ * @description Configuration passed to a plugin's `install()` function.
+ * @since 2.0.0
+ */
+export interface PluginContext {
+    /** The Synapse RPC client (for on-chain reads, transaction building). */
+    client: SynapseClientLike;
+    /** Wallet public key for signing/identity. */
+    walletPubkey?: string;
+    /** Per-protocol config overrides. */
+    config?: Record<string, unknown>;
+    /** Tool creation options (include/exclude, prefix, etc.). */
+    toolOpts?: CreateProtocolToolsOpts;
+}
+/**
+ * @description A plugin executor — called to run a method within the plugin.
+ * @since 2.0.0
+ */
+export type PluginExecutor = (method: ProtocolMethod, input: Record<string, unknown>, context: PluginContext) => Promise<unknown>;
+/**
+ * @description The core plugin interface — implement this to create a plugin.
+ *
+ * Plugins are stateless factories: `install()` is called once, returns
+ * an executor and the protocol methods. The agent kit wires them together.
+ *
+ * @example
+ * ```ts
+ * const MyPlugin: SynapsePlugin = {
+ *   meta: { id: 'my-plugin', name: 'My Plugin', description: '...', version: '1.0.0' },
+ *   protocols: [{ id: 'my-proto', name: 'My Protocol', methods: myMethods }],
+ *   install(context) {
+ *     return {
+ *       executor: async (method, input) => { ... },
+ *       teardown: async () => { ... },
+ *     };
+ *   },
+ * };
+ * ```
+ *
+ * @since 2.0.0
+ */
+export interface SynapsePlugin {
+    /** Plugin metadata for discovery and documentation. */
+    meta: PluginMeta;
+    /** Protocols contained in this plugin. */
+    protocols: readonly PluginProtocol[];
+    /**
+     * Install the plugin — called once when `.use(plugin)` is invoked.
+     * Returns an executor function and optional teardown hook.
+     */
+    install(context: PluginContext): PluginInstallResult;
+}
+/**
+ * @description Result of installing a plugin.
+ * @since 2.0.0
+ */
+export interface PluginInstallResult {
+    /** The method executor for all protocols in this plugin. */
+    executor: PluginExecutor;
+    /** Optional teardown hook (called on `.destroy()`). */
+    teardown?: () => Promise<void>;
+    /** Optional per-protocol HTTP clients (for direct access). */
+    httpClients?: Record<string, {
+        baseUrl: string;
+        getHeaders: () => Record<string, string>;
+    }>;
+}
+/**
+ * @description Runtime state of an installed plugin.
+ * @since 2.0.0
+ */
+export interface InstalledPlugin {
+    /** The original plugin definition. */
+    plugin: SynapsePlugin;
+    /** Toolkit per protocol (keyed by protocol ID). */
+    toolkits: Record<string, ProtocolToolkit>;
+    /** Flat array of all tools from this plugin. */
+    tools: ProtocolTool[];
+    /** Install result (executor, teardown). */
+    installResult: PluginInstallResult;
+}
+/**
+ * @description Configuration for the SynapseAgentKit.
+ * @since 2.0.0
+ */
+export interface AgentKitConfig {
+    /** Solana RPC endpoint URL. */
+    rpcUrl: string;
+    /** API key for the RPC endpoint. */
+    apiKey?: string;
+    /** Wallet public key (base58). */
+    walletPubkey?: string;
+    /** Per-protocol config overrides (keyed by protocol ID). */
+    protocolConfig?: Record<string, unknown>;
+    /** Default tool creation options. */
+    toolOpts?: CreateProtocolToolsOpts;
+    /** Whether to enable MCP context output (default: false). */
+    mcpEnabled?: boolean;
+}
+/**
+ * @description MCP tool descriptor — compatible with MCP servers.
+ * @since 2.0.0
+ */
+export interface McpToolDescriptor {
+    /** Tool name (e.g. 'token_transfer'). */
+    name: string;
+    /** Human-readable description. */
+    description: string;
+    /** JSON Schema for input parameters. */
+    inputSchema: Record<string, unknown>;
+    /** JSON Schema for output (optional). */
+    outputSchema?: Record<string, unknown>;
+    /** Protocol this tool belongs to. */
+    protocol: string;
+    /** Plugin this tool belongs to. */
+    plugin: string;
+}
+/**
+ * @description MCP resource descriptor.
+ * @since 2.0.0
+ */
+export interface McpResourceDescriptor {
+    /** Resource URI (e.g. 'solana://token/{mint}'). */
+    uri: string;
+    /** Human-readable name. */
+    name: string;
+    /** Description of the resource. */
+    description: string;
+    /** MIME type of the resource. */
+    mimeType: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/ai/plugins/types.d.ts.map

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

package/dist/cjs/ai/plugins/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/ai/plugins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ai/plugins/types.ts"],"names":[],"mappings":""}

package/dist/cjs/ai/sap/adapter.d.ts

@@ -0,0 +1,140 @@
+/**
+ * @module ai/sap/adapter
+ * @description SAP — On-chain persistence adapter for {@link AgentRegistry}.
+ *
+ * Implements the {@link PersistenceAdapter} interface using SAP on-chain
+ * data, enabling the `AgentRegistry` to persist and discover agents
+ * directly on the Solana blockchain.
+ *
+ * @example
+ * ```ts
+ * import { AgentRegistry, OnChainPersistenceAdapter } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const adapter = new OnChainPersistenceAdapter(client, { programId: 'SAPAgnt1...' });
+ * const registry = new AgentRegistry({ adapter });
+ *
+ * // Agents registered via the registry are now backed by on-chain data
+ * ```
+ *
+ * @since 1.3.0
+ */
+import type { SAPConfig } from './types';
+import { SAPDiscovery } from './discovery';
+/**
+ * @description Persistence adapter interface (matches gateway/registry).
+ * @since 1.3.0
+ */
+interface PersistenceAdapterLike {
+    save(id: string, data: unknown): Promise<void>;
+    load(id: string): Promise<unknown | null>;
+    loadAll(): Promise<Array<{
+        id: string;
+        data: unknown;
+    }>>;
+    remove(id: string): Promise<void>;
+}
+/**
+ * @description Minimal RPC client interface.
+ * @since 1.3.0
+ */
+interface RpcClient {
+    transport: {
+        request<T = unknown>(method: string, params: unknown[]): Promise<T>;
+    };
+}
+/**
+ * @description Persistence adapter backed by SAP on-chain data.
+ *
+ * **Read operations** (`load`, `loadAll`) query the blockchain via
+ * {@link SAPDiscovery}. **Write operations** (`save`, `remove`) are
+ * cached locally — the actual on-chain write must be done by the user
+ * via {@link SAPInstructionBuilder} + transaction signing.
+ *
+ * This design separates read (automatic) from write (user-driven)
+ * because on-chain writes require a signature from the agent's wallet.
+ *
+ * @implements {PersistenceAdapterLike}
+ * @since 1.3.0
+ */
+export declare class OnChainPersistenceAdapter implements PersistenceAdapterLike {
+    private readonly discovery;
+    private readonly pendingWrites;
+    private readonly removed;
+    /**
+     * @param {RpcClient} client - Client providing RPC transport
+     * @param {Partial<SAPConfig>} [config] - SAP configuration
+     */
+    constructor(client: RpcClient, config?: Partial<SAPConfig>);
+    /**
+     * @description Get the underlying discovery instance for direct queries.
+     * @returns {SAPDiscovery} Discovery engine
+     * @since 1.3.0
+     */
+    getDiscovery(): SAPDiscovery;
+    /**
+     * @description Stage agent data for persistence.
+     *
+     * This caches the data locally. To actually write on-chain, build and
+     * send a transaction using {@link SAPInstructionBuilder}.
+     *
+     * @param {string} id - Agent wallet pubkey or DID
+     * @param {unknown} data - Agent data to persist
+     * @returns {Promise<void>}
+     * @since 1.3.0
+     */
+    save(id: string, data: unknown): Promise<void>;
+    /**
+     * @description Load agent data from on-chain PDA.
+     *
+     * First checks pending writes (local cache), then queries the blockchain.
+     *
+     * @param {string} id - Agent wallet pubkey
+     * @returns {Promise<AgentPDAAccount | unknown | null>} Agent data or null
+     * @since 1.3.0
+     */
+    load(id: string): Promise<unknown | null>;
+    /**
+     * @description Load all agents from the blockchain.
+     *
+     * Merges on-chain data with pending local writes, excluding removed entries.
+     *
+     * @returns {Promise<Array<{ id: string; data: unknown }>>} All agent records
+     * @since 1.3.0
+     */
+    loadAll(): Promise<Array<{
+        id: string;
+        data: unknown;
+    }>>;
+    /**
+     * @description Mark an agent for removal (locally cached).
+     *
+     * On-chain removal requires sending a `deactivate` instruction
+     * via {@link SAPInstructionBuilder}.
+     *
+     * @param {string} id - Agent wallet pubkey
+     * @returns {Promise<void>}
+     * @since 1.3.0
+     */
+    remove(id: string): Promise<void>;
+    /**
+     * @description Get pending writes that need to be committed on-chain.
+     * @returns {Map<string, unknown>} Map of agent ID → staged data
+     * @since 1.3.0
+     */
+    getPendingWrites(): ReadonlyMap<string, unknown>;
+    /**
+     * @description Get IDs of agents marked for removal.
+     * @returns {ReadonlySet<string>} Set of removed agent IDs
+     * @since 1.3.0
+     */
+    getRemovedIds(): ReadonlySet<string>;
+    /**
+     * @description Clear all pending local writes and removals.
+     * Call after successfully committing transactions on-chain.
+     * @returns {void}
+     * @since 1.3.0
+     */
+    clearPending(): void;
+}
+export {};
+//# sourceMappingURL=adapter.d.ts.map

package/dist/cjs/ai/sap/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/ai/sap/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,SAAS,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAS3C;;;GAGG;AACH,UAAU,sBAAsB;IAC9B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC1C,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;IACzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,UAAU,SAAS;IACjB,SAAS,EAAE;QACT,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;KACrE,CAAC;CACH;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmC;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAElD;;;OAGG;gBACS,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;IAQ1D;;;;OAIG;IACH,YAAY,IAAI,YAAY;IAI5B;;;;;;;;;;OAUG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD;;;;;;;;OAQG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAa/C;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IA+B9D;;;;;;;;;OASG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC;;;;OAIG;IACH,gBAAgB,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC;IAIhD;;;;OAIG;IACH,aAAa,IAAI,WAAW,CAAC,MAAM,CAAC;IAIpC;;;;;OAKG;IACH,YAAY,IAAI,IAAI;CAIrB"}