@oobe-protocol-labs/synapse-sap-sdk 0.1.0

package/dist/types/types/instructions.d.ts

@@ -0,0 +1,366 @@
+/**
+ * @module types/instructions
+ * @description Instruction argument DTOs and helper enumerations.
+ *
+ * These interfaces map 1:1 to the Anchor instruction argument structs.
+ * Use them when calling SDK module methods.
+ *
+ * @category Types
+ * @since v0.1.0
+ */
+import type { PublicKey } from "@solana/web3.js";
+import type BN from "bn.js";
+import type { Capability, PricingTier, VolumeCurveBreakpoint } from "./common";
+/**
+ * @interface RegisterAgentArgs
+ * @description Arguments for the `registerAgent` instruction.
+ *
+ * Creates a new on-chain agent identity with the given profile,
+ * capabilities, pricing tiers, and protocol support.
+ *
+ * @category Types
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { TokenType } from "@synapse-sap/sdk";
+ *
+ * const args: RegisterAgentArgs = {
+ *   name: "My Agent",
+ *   description: "A helpful Solana agent",
+ *   capabilities: [{ id: "jupiter:swap", description: null, protocolId: "jupiter", version: "1.0" }],
+ *   pricing: [],
+ *   protocols: ["solana-agent-protocol"],
+ * };
+ * ```
+ */
+export interface RegisterAgentArgs {
+    /** Agent display name. */
+    readonly name: string;
+    /** Agent description. */
+    readonly description: string;
+    /** Capabilities the agent exposes. */
+    readonly capabilities: Capability[];
+    /** Pricing tiers for the agent's services. */
+    readonly pricing: PricingTier[];
+    /** Supported protocol identifiers. */
+    readonly protocols: string[];
+    /** Optional off-chain agent identifier. */
+    readonly agentId?: string | null;
+    /** Optional URI to extended metadata. */
+    readonly agentUri?: string | null;
+    /** Optional x402 payment endpoint. */
+    readonly x402Endpoint?: string | null;
+}
+/**
+ * @interface UpdateAgentArgs
+ * @description Arguments for the `updateAgent` instruction.
+ *
+ * All fields are optional — pass only the fields you want to change.
+ * `null` values are ignored on-chain.
+ *
+ * @category Types
+ * @since v0.1.0
+ */
+export interface UpdateAgentArgs {
+    readonly name?: string | null;
+    readonly description?: string | null;
+    readonly capabilities?: Capability[] | null;
+    readonly pricing?: PricingTier[] | null;
+    readonly protocols?: string[] | null;
+    readonly agentId?: string | null;
+    readonly agentUri?: string | null;
+    readonly x402Endpoint?: string | null;
+}
+/**
+ * @interface GiveFeedbackArgs
+ * @description Arguments for the `giveFeedback` instruction.
+ *
+ * Submits a reputation score and tag for the target agent.
+ * Each reviewer can only submit one feedback per agent.
+ *
+ * @category Types
+ * @since v0.1.0
+ */
+export interface GiveFeedbackArgs {
+    /** Reputation score (1–100). */
+    readonly score: number;
+    /** Freeform tag / category for the feedback. */
+    readonly tag: string;
+    /** Optional SHA-256 hash of an off-chain comment. */
+    readonly commentHash?: number[] | null;
+}
+/**
+ * @interface UpdateFeedbackArgs
+ * @description Arguments for the `updateFeedback` instruction.
+ *
+ * Allows the original reviewer to revise their score and/or tag.
+ *
+ * @category Types
+ * @since v0.1.0
+ */
+export interface UpdateFeedbackArgs {
+    /** Updated reputation score (1–100). */
+    readonly newScore: number;
+    /** Updated tag (optional). */
+    readonly newTag?: string | null;
+    /** Updated off-chain comment hash (optional). */
+    readonly commentHash?: number[] | null;
+}
+/**
+ * @interface PublishToolArgs
+ * @description Arguments for the `publishTool` instruction.
+ *
+ * Registers a new tool descriptor on-chain with hashed metadata.
+ * Hash fields are SHA-256 digests of the corresponding off-chain content.
+ *
+ * @category Types
+ * @since v0.1.0
+ */
+export interface PublishToolArgs {
+    /** Human-readable tool name. */
+    readonly toolName: string;
+    /** SHA-256 hash of the tool name (PDA seed). */
+    readonly toolNameHash: number[];
+    /** SHA-256 hash of the protocol identifier. */
+    readonly protocolHash: number[];
+    /** SHA-256 hash of the tool description. */
+    readonly descriptionHash: number[];
+    /** SHA-256 hash of the input JSON schema. */
+    readonly inputSchemaHash: number[];
+    /** SHA-256 hash of the output JSON schema. */
+    readonly outputSchemaHash: number[];
+    /** HTTP method discriminant index. */
+    readonly httpMethod: number;
+    /** Tool category discriminant index. */
+    readonly category: number;
+    /** Total number of parameters. */
+    readonly paramsCount: number;
+    /** Number of required parameters. */
+    readonly requiredParams: number;
+    /** Whether the tool is a compound (multi-step) operation. */
+    readonly isCompound: boolean;
+}
+/**
+ * @interface UpdateToolArgs
+ * @description Arguments for the `updateTool` instruction.
+ *
+ * All fields are optional — only pass the fields to update.
+ *
+ * @category Types
+ * @since v0.1.0
+ */
+export interface UpdateToolArgs {
+    readonly descriptionHash?: number[] | null;
+    readonly inputSchemaHash?: number[] | null;
+    readonly outputSchemaHash?: number[] | null;
+    readonly httpMethod?: number | null;
+    readonly category?: number | null;
+    readonly paramsCount?: number | null;
+    readonly requiredParams?: number | null;
+}
+/**
+ * @interface InscribeToolSchemaArgs
+ * @description Arguments for the `inscribeToolSchema` instruction.
+ *
+ * Writes a tool’s JSON schema (input, output, or description) on-chain
+ * as an inscription, with optional compression.
+ *
+ * @category Types
+ * @since v0.1.0
+ * @see {@link SchemaType} for schema type discriminants.
+ * @see {@link CompressionType} for compression discriminants.
+ */
+export interface InscribeToolSchemaArgs {
+    /** Schema type discriminant (input / output / description). */
+    readonly schemaType: number;
+    /** Raw (optionally compressed) schema bytes. */
+    readonly schemaData: Buffer;
+    /** SHA-256 hash of the uncompressed schema. */
+    readonly schemaHash: number[];
+    /** Compression algorithm discriminant. */
+    readonly compression: number;
+}
+/**
+ * @interface InscribeMemoryArgs
+ * @description Arguments for the `inscribeMemory` instruction.
+ *
+ * Writes an encrypted memory fragment into a vault session.
+ * Supports multi-fragment inscriptions and epoch-based partitioning.
+ *
+ * @category Types
+ * @since v0.1.0
+ */
+export interface InscribeMemoryArgs {
+    /** Sequence number within the session. */
+    readonly sequence: number;
+    /** NaCl-encrypted payload. */
+    readonly encryptedData: Buffer;
+    /** Encryption nonce (12 bytes). */
+    readonly nonce: number[];
+    /** SHA-256 hash of the plaintext content. */
+    readonly contentHash: number[];
+    /** Total fragments in this inscription. */
+    readonly totalFragments: number;
+    /** Zero-based index of this fragment. */
+    readonly fragmentIndex: number;
+    /** Compression algorithm discriminant. */
+    readonly compression: number;
+    /** Target epoch index. */
+    readonly epochIndex: number;
+}
+/**
+ * @interface CompactInscribeArgs
+ * @description Arguments for the `compactInscribe` instruction.
+ *
+ * A simplified inscription variant that omits fragmentation and epoch
+ * fields — ideal for small, single-fragment payloads.
+ *
+ * @category Types
+ * @since v0.1.0
+ */
+export interface CompactInscribeArgs {
+    /** Sequence number within the session. */
+    readonly sequence: number;
+    /** NaCl-encrypted payload. */
+    readonly encryptedData: Buffer;
+    /** Encryption nonce (12 bytes). */
+    readonly nonce: number[];
+    /** SHA-256 hash of the plaintext content. */
+    readonly contentHash: number[];
+}
+/**
+ * @interface CreateEscrowArgs
+ * @description Arguments for the `createEscrow` instruction.
+ *
+ * Creates a pre-funded escrow account for micropayments to an agent,
+ * optionally with volume-based discount breakpoints.
+ *
+ * @category Types
+ * @since v0.1.0
+ * @see {@link VolumeCurveBreakpoint} for discount curve details.
+ */
+export interface CreateEscrowArgs {
+    /** Base price per call in token base units. */
+    readonly pricePerCall: BN;
+    /** Maximum number of calls the escrow should fund. */
+    readonly maxCalls: BN;
+    /** Initial deposit amount. */
+    readonly initialDeposit: BN;
+    /** Unix timestamp when the escrow expires. */
+    readonly expiresAt: BN;
+    /** Volume discount breakpoints (pass `[]` for none). */
+    readonly volumeCurve: VolumeCurveBreakpoint[];
+    /** SPL token mint (pass `null` for native SOL). */
+    readonly tokenMint: PublicKey | null;
+    /** Decimal places for the token. */
+    readonly tokenDecimals: number;
+}
+/**
+ * @interface CreateAttestationArgs
+ * @description Arguments for the `createAttestation` instruction.
+ *
+ * Issues a web-of-trust attestation for a target agent.
+ *
+ * @category Types
+ * @since v0.1.0
+ */
+export interface CreateAttestationArgs {
+    /** Freeform attestation type (e.g. `"kyc"`, `"audit"`). */
+    readonly attestationType: string;
+    /** SHA-256 hash of off-chain attestation metadata. */
+    readonly metadataHash: number[];
+    /** Unix timestamp when the attestation expires. */
+    readonly expiresAt: BN;
+}
+/**
+ * @name DelegatePermission
+ * @description Bitmask constants for vault delegate permissions.
+ *
+ * Combine with bitwise OR to grant multiple permissions.
+ *
+ * | Bit | Value | Permission          |
+ * | --- | ----- | ------------------- |
+ * | 0   | 1     | Inscribe memories   |
+ * | 1   | 2     | Close sessions      |
+ * | 2   | 4     | Open sessions       |
+ * | —   | 7     | All permissions     |
+ *
+ * @category Types
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { DelegatePermission } from "@synapse-sap/sdk";
+ *
+ * // Grant inscribe + open session
+ * const perms = DelegatePermission.Inscribe | DelegatePermission.OpenSession;
+ * ```
+ */
+export declare const DelegatePermission: {
+    readonly Inscribe: 1;
+    readonly CloseSession: 2;
+    readonly OpenSession: 4;
+    readonly All: 7;
+};
+/**
+ * @name DelegatePermissionBit
+ * @description Union of valid {@link DelegatePermission} bit values.
+ */
+export type DelegatePermissionBit = (typeof DelegatePermission)[keyof typeof DelegatePermission];
+/**
+ * @name SchemaType
+ * @description Numeric discriminants for tool schema types.
+ *
+ * Used in the `inscribeToolSchema` instruction to specify which schema
+ * is being written on-chain.
+ *
+ * @category Types
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { SchemaType } from "@synapse-sap/sdk";
+ *
+ * const args = { schemaType: SchemaType.Input, ... };
+ * ```
+ */
+export declare const SchemaType: {
+    readonly Input: 0;
+    readonly Output: 1;
+    readonly Description: 2;
+};
+/**
+ * @name SchemaTypeValue
+ * @description Union of valid {@link SchemaType} discriminant values.
+ */
+export type SchemaTypeValue = (typeof SchemaType)[keyof typeof SchemaType];
+/**
+ * @name CompressionType
+ * @description Numeric discriminants for compression algorithms.
+ *
+ * Used in inscription instructions to declare the compression format
+ * of the payload so consumers can decompress correctly.
+ *
+ * @category Types
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { CompressionType } from "@synapse-sap/sdk";
+ *
+ * const args = { compression: CompressionType.Gzip, ... };
+ * ```
+ */
+export declare const CompressionType: {
+    readonly None: 0;
+    readonly Deflate: 1;
+    readonly Gzip: 2;
+    readonly Brotli: 3;
+};
+/**
+ * @name CompressionTypeValue
+ * @description Union of valid {@link CompressionType} discriminant values.
+ */
+export type CompressionTypeValue = (typeof CompressionType)[keyof typeof CompressionType];
+//# sourceMappingURL=instructions.d.ts.map

package/dist/types/types/instructions.d.ts.map

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

package/dist/types/utils/hash.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @module utils/hash
+ * @description Cryptographic hashing utilities.
+ *
+ * @category Utils
+ * @since v0.1.0
+ */
+/**
+ * Compute the SHA-256 hash of a UTF-8 string or byte buffer.
+ *
+ * Returns a 32-byte `Uint8Array` suitable for PDA seeds
+ * and Anchor instruction arguments.
+ *
+ * @name sha256
+ * @description Hashes the input using Node’s `crypto.createHash("sha256")`.
+ * @param input - A UTF-8 string, `Buffer`, or `Uint8Array` to hash.
+ * @returns {Uint8Array} 32-byte SHA-256 digest.
+ * @category Utils
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { sha256 } from "@synapse-sap/sdk/utils";
+ *
+ * const hash = sha256("jupiter:swap"); // Uint8Array (32 bytes)
+ * ```
+ */
+export declare const sha256: (input: string | Buffer | Uint8Array) => Uint8Array;
+/**
+ * Convert a `Uint8Array` hash to a plain `number[]`.
+ *
+ * Anchor instruction argument types expect `number[]` for hash fields
+ * rather than typed arrays.
+ *
+ * @name hashToArray
+ * @description Converts a byte array (typically 32 bytes) to a plain JavaScript `number[]`.
+ * @param hash - The byte array to convert.
+ * @returns {number[]} Shallow copy as a plain array of numbers.
+ * @category Utils
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { sha256, hashToArray } from "@synapse-sap/sdk/utils";
+ *
+ * const arr = hashToArray(sha256("jupiter:swap")); // number[]
+ * ```
+ */
+export declare const hashToArray: (hash: Uint8Array) => number[];
+//# sourceMappingURL=hash.d.ts.map

package/dist/types/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/utils/hash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,GAAG,MAAM,GAAG,UAAU,KAAG,UAM5D,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,UAAU,KAAG,MAAM,EAAsB,CAAC"}

package/dist/types/utils/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module utils
+ * @description Shared utilities used across SDK modules.
+ *
+ * @category Utils
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { sha256, hashToArray, assert } from "@synapse-sap/sdk/utils";
+ *
+ * const hash = sha256("jupiter:swap");
+ * const arr  = hashToArray(hash);      // number[] for Anchor args
+ * ```
+ */
+export { sha256, hashToArray } from "./hash";
+export { assert } from "./validation";
+export { serializeAccount, serializeValue } from "./serialization";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/utils/serialization.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @module utils/serialization
+ * @description JSON-safe serialization helpers for on-chain account data.
+ *
+ * On-chain Anchor account objects contain `PublicKey` and `BN` instances
+ * that are not JSON-serializable. These helpers convert them to plain
+ * strings (`base58` and decimal `string`) recursively.
+ *
+ * @category Utils
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { serializeAccount } from "@synapse-sap/sdk/utils";
+ *
+ * const raw = await program.account.agent.fetch(pda);
+ * const json = serializeAccount(raw);
+ * // { authority: "GBL...", totalCalls: "42", ... }
+ * ```
+ */
+/**
+ * Recursively convert a single value for JSON serialization.
+ *
+ * - `PublicKey` → base58 string
+ * - `BN` → decimal string
+ * - `Uint8Array` / `Buffer` → hex string
+ * - `Array` → recursed
+ * - plain `object` → recursed via {@link serializeAccount}
+ * - primitives → identity
+ *
+ * @name serializeValue
+ * @description Transforms a single Anchor-typed value into its JSON-safe equivalent.
+ * @param value - The value to serialize.
+ * @returns The JSON-safe representation of `value`.
+ * @category Utils
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { serializeValue } from "@synapse-sap/sdk/utils";
+ *
+ * serializeValue(new PublicKey("11111111111111111111111111111111")); // "1111..."
+ * serializeValue(new BN(42)); // "42"
+ * ```
+ */
+export declare function serializeValue(value: unknown): any;
+/**
+ * Serialize an entire on-chain account object to a JSON-safe shape.
+ *
+ * Iterates over each key and delegates to {@link serializeValue}.
+ * Handles `PublicKey` → base58, `BN` → string, and nested
+ * objects / arrays recursively.
+ *
+ * @name serializeAccount
+ * @description Converts all non-primitive fields in an Anchor account record to JSON-safe strings.
+ * @param obj - The raw account object returned by `program.account.<name>.fetch()`.
+ * @returns A new plain object with all values converted.
+ * @category Utils
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { serializeAccount } from "@synapse-sap/sdk/utils";
+ *
+ * const raw = await program.account.agent.fetch(pda);
+ * const safe = serializeAccount(raw);
+ * console.log(JSON.stringify(safe));
+ * ```
+ */
+export declare function serializeAccount(obj: Record<string, any>): Record<string, any>;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/types/utils/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../../src/utils/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAYlD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,wBAAgB,gBAAgB,CAE9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAEvB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAOrB"}

package/dist/types/utils/validation.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @module utils/validation
+ * @description Runtime assertion helpers.
+ *
+ * @category Utils
+ * @since v0.1.0
+ */
+/**
+ * Assert that a condition holds, throwing a descriptive error otherwise.
+ *
+ * Uses TypeScript’s `asserts condition` return type so the compiler
+ * narrows the guarded value after the call.
+ *
+ * @name assert
+ * @description Runtime guard — throws `RangeError` with a `[SAP SDK]` prefix when the condition is falsy.
+ * @param condition - The boolean expression to verify.
+ * @param message   - Human-readable message included in the thrown error.
+ * @throws {RangeError} When `condition` is `false`.
+ * @category Utils
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { assert } from "@synapse-sap/sdk/utils";
+ *
+ * assert(name.length <= 64, "Agent name exceeds MAX_NAME_LEN");
+ * ```
+ */
+export declare function assert(condition: boolean, message: string): asserts condition;
+//# sourceMappingURL=validation.d.ts.map

package/dist/types/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CACpB,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAInB"}