@oobe-protocol-labs/synapse-client-sdk 2.0.2 → 2.0.5

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

@@ -1,205 +0,0 @@
-/**
- * @module ai/sap/pda
- * @description SAP — PDA derivation, account serialization & deserialization.
- *
- * Provides Solana Program Derived Address (PDA) computation for agent
- * identity accounts, plus Borsh-compatible binary serialization for
- * reading and writing on-chain agent data.
- *
- * PDA seeds: `["synapse_agent", <wallet_pubkey_32_bytes>]`
- *
- * @example
- * ```ts
- * import { deriveAgentPDA, deserializeAgentAccount } from '@oobe-protocol-labs/synapse-client-sdk/ai';
- *
- * const { address, bump } = deriveAgentPDA(walletPubkey, programId);
- * const account = deserializeAgentAccount(address, rawBytes);
- * ```
- *
- * @since 1.3.0
- */
-import type { AgentPDAAccount } from './types';
-/**
- * @description Decode a base58-encoded string to raw bytes.
- * @param {string} str - Base58-encoded string
- * @returns {Uint8Array} Decoded bytes
- * @since 1.3.0
- */
-export declare function base58Decode(str: string): Uint8Array;
-/**
- * @description Encode raw bytes to a base58 string.
- * @param {Uint8Array} bytes - Raw bytes
- * @returns {string} Base58-encoded string
- * @since 1.3.0
- */
-export declare function base58Encode(bytes: Uint8Array): string;
-/**
- * @description Check whether a 32-byte hash lies on the ed25519 curve.
- * Uses Node.js `crypto.createPublicKey` to attempt point decompression.
- *
- * @param {Uint8Array} point - 32-byte candidate
- * @returns {boolean} `true` if the point is a valid ed25519 public key (on curve)
- * @since 1.3.0
- */
-export declare function isOnCurve(point: Uint8Array): boolean;
-/**
- * @description Result of a PDA derivation.
- * @since 1.3.0
- */
-export interface DerivedPDA {
-    /** PDA address (base58). */
-    address: string;
-    /** Bump seed used (255 → 0). */
-    bump: number;
-    /** Raw 32-byte PDA address. */
-    bytes: Uint8Array;
-}
-/**
- * @description Derive the agent PDA address for a given wallet public key.
- *
- * Algorithm (Solana `findProgramAddress`):
- * 1. For bump = 255 → 0:
- *    - candidate = SHA-256(seed_prefix + wallet_bytes + [bump] + program_id + "ProgramDerivedAddress")
- *    - If candidate is NOT on the ed25519 curve → return (candidate, bump)
- *
- * @param {string} walletPubkey - Agent's wallet pubkey (base58)
- * @param {string} programId - SAP program ID (base58)
- * @returns {DerivedPDA} The derived PDA address and bump seed
- * @throws {Error} If no valid PDA can be found (theoretically impossible)
- *
- * @example
- * ```ts
- * const pda = deriveAgentPDA('7xKX...wallet', 'SAPAgnt1...');
- * console.log(pda.address); // base58 PDA address
- * console.log(pda.bump);    // 254
- * ```
- *
- * @since 1.3.0
- */
-export declare function deriveAgentPDA(walletPubkey: string, programId: string): DerivedPDA;
-/**
- * @description Minimal Borsh-compatible binary reader for deserializing
- * agent PDA account data from the Solana blockchain.
- * @since 1.3.0
- */
-export declare class BorshReader {
-    private readonly data;
-    private offset;
-    /**
-     * @param {Buffer | Uint8Array} data - Raw account data bytes
-     */
-    constructor(data: Buffer | Uint8Array);
-    /** Current read position. */
-    get position(): number;
-    /** Remaining unread bytes. */
-    get remaining(): number;
-    /**
-     * @description Read a single unsigned byte.
-     * @returns {number} u8 value
-     */
-    readU8(): number;
-    /**
-     * @description Read a 32-bit unsigned integer (little-endian).
-     * @returns {number} u32 value
-     */
-    readU32(): number;
-    /**
-     * @description Read a 64-bit signed integer (little-endian) as bigint.
-     * @returns {bigint} i64 value
-     */
-    readI64(): bigint;
-    /**
-     * @description Read a 64-bit unsigned integer (little-endian) as bigint.
-     * @returns {bigint} u64 value
-     */
-    readU64(): bigint;
-    /**
-     * @description Read a fixed-length byte array.
-     * @param {number} len - Number of bytes to read
-     * @returns {Uint8Array} Raw bytes
-     */
-    readBytes(len: number): Uint8Array;
-    /**
-     * @description Read a Borsh-encoded string (u32 length prefix + UTF-8 bytes).
-     * @returns {string} Decoded string
-     */
-    readString(): string;
-    /**
-     * @description Read an optional value (1 byte flag + value if present).
-     * @param {() => T} readFn - Reader function for the inner value
-     * @returns {T | undefined}
-     */
-    readOption<T>(readFn: () => T): T | undefined;
-    /**
-     * @description Read a Borsh-encoded Vec (u32 length prefix + elements).
-     * @param {() => T} readFn - Reader function for each element
-     * @returns {T[]} Array of decoded elements
-     */
-    readVec<T>(readFn: () => T): T[];
-}
-/**
- * @description Minimal Borsh-compatible binary writer for serializing
- * instruction data to send to the SAP program.
- * @since 1.3.0
- */
-export declare class BorshWriter {
-    private buf;
-    /** Get the serialized bytes. */
-    toBytes(): Uint8Array;
-    /** @description Write a single unsigned byte. */
-    writeU8(val: number): this;
-    /** @description Write a 32-bit unsigned integer (little-endian). */
-    writeU32(val: number): this;
-    /** @description Write a 64-bit signed integer (little-endian) as bigint. */
-    writeI64(val: bigint): this;
-    /** @description Write a 64-bit unsigned integer (little-endian) as bigint. */
-    writeU64(val: bigint): this;
-    /** @description Write raw bytes. */
-    writeBytes(bytes: Uint8Array): this;
-    /** @description Write a Borsh-encoded string (u32 length + UTF-8 bytes). */
-    writeString(str: string): this;
-    /** @description Write an optional value (1-byte flag + value). */
-    writeOption<T>(val: T | undefined, writeFn: (v: T) => void): this;
-    /** @description Write a Borsh-encoded Vec (u32 length + elements). */
-    writeVec<T>(items: T[], writeFn: (v: T) => void): this;
-}
-/**
- * @description Deserialize raw account bytes into an {@link AgentPDAAccount}.
- *
- * @param {string} address - PDA address (base58)
- * @param {Buffer | Uint8Array} data - Raw account data from `getAccountInfo`
- * @returns {AgentPDAAccount} Fully deserialized agent account
- * @throws {Error} If discriminator doesn't match or data is malformed
- *
- * @example
- * ```ts
- * const raw = await transport.request('getAccountInfo', [pdaAddress, { encoding: 'base64' }]);
- * const decoded = Buffer.from(raw.value.data[0], 'base64');
- * const agent = deserializeAgentAccount(pdaAddress, decoded);
- * ```
- *
- * @since 1.3.0
- */
-export declare function deserializeAgentAccount(address: string, data: Buffer | Uint8Array): AgentPDAAccount;
-/**
- * @description Serialize agent data into instruction data for the `register` instruction.
- * Does NOT include the instruction discriminator — that is prepended by
- * {@link SAPInstructionBuilder}.
- *
- * @param {RegisterAgentParams} params - Registration parameters
- * @returns {Uint8Array} Borsh-serialized instruction data (without discriminator)
- *
- * @since 1.3.0
- */
-export declare function serializeRegisterData(params: import('./types').RegisterAgentParams): Uint8Array;
-/**
- * @description Serialize update data for the `update` instruction.
- * Uses Option encoding for each field — `None` means "don't change".
- *
- * @param {UpdateAgentParams} params - Fields to update
- * @returns {Uint8Array} Borsh-serialized instruction data (without discriminator)
- *
- * @since 1.4.0
- */
-export declare function serializeUpdateData(params: import('./types').UpdateAgentParams): Uint8Array;
-//# sourceMappingURL=pda.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"pda.d.ts","sourceRoot":"","sources":["../../../../src/ai/sap/pda.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAgE,MAAM,SAAS,CAAC;AAS7G;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAoBpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAuBtD;AASD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAWpD;AAMD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CA2BlF;AAMD;;;;GAIG;AACH,qBAAa,WAAW;IAMV,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,MAAM,CAAK;IAEnB;;OAEG;gBAC0B,IAAI,EAAE,MAAM,GAAG,UAAU;IAEtD,6BAA6B;IAC7B,IAAI,QAAQ,IAAI,MAAM,CAAwB;IAE9C,8BAA8B;IAC9B,IAAI,SAAS,IAAI,MAAM,CAA2C;IAElE;;;OAGG;IACH,MAAM,IAAI,MAAM;IAMhB;;;OAGG;IACH,OAAO,IAAI,MAAM;IAUjB;;;OAGG;IACH,OAAO,IAAI,MAAM;IAMjB;;;OAGG;IACH,OAAO,IAAI,MAAM;IAMjB;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAMlC;;;OAGG;IACH,UAAU,IAAI,MAAM;IAMpB;;;;OAIG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS;IAK7C;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE;CAMjC;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAAgB;IAE3B,gCAAgC;IAChC,OAAO,IAAI,UAAU;IAIrB,iDAAiD;IACjD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK1B,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK3B,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ3B,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI3B,oCAAoC;IACpC,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAKnC,4EAA4E;IAC5E,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAO9B,kEAAkE;IAClE,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAUjE,sEAAsE;IACtE,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;CAKvD;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,eAAe,CAyGnG;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,SAAS,EAAE,mBAAmB,GAAG,UAAU,CA6C/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,SAAS,EAAE,iBAAiB,GAAG,UAAU,CAgD3F"}