@oobe-protocol-labs/synapse-client-sdk 1.0.0-beta → 1.0.2

package/dist/cjs/core/transport.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * JSON-RPC HTTP transport — the single I/O boundary for all RPC calls.
+ *
+ * Handles serialization, timeout abort via `AbortController`,
+ * upstream rotation on method-not-allowed, retry with configurable
+ * max attempts, and optional debug logging.
+ *
+ * @module core/transport
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * import { HttpTransport } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * const t = new HttpTransport({ endpoint: 'https://rpc.synapse.com', apiKey: 'sk-…' });
+ * const slot = await t.request<number>('getSlot');
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpTransport = void 0;
+const errors_1 = require("./errors");
+const env_1 = require("../utils/env");
+// ── Transport class ────────────────────────────────────────────
+/**
+ * Low-level JSON-RPC 2.0 HTTP transport.
+ *
+ * All Synapse SDK RPC calls flow through this class. It is instantiated
+ * once by {@link SynapseClient} and shared by every sub-module.
+ *
+ * @since 1.0.0
+ */
+class HttpTransport {
+    cfg;
+    id = 0;
+    timeout;
+    maxRetries;
+    debug;
+    headers;
+    constructor(cfg) {
+        this.cfg = cfg;
+        this.timeout = cfg.timeout ?? 30_000;
+        this.maxRetries = cfg.maxRetries ?? 3;
+        this.debug = cfg.debug ?? false;
+        this.headers = {
+            'Content-Type': 'application/json',
+            ...(cfg.apiKey ? { Authorization: `Bearer ${cfg.apiKey}` } : {}),
+            // User-Agent is only settable on server-side fetch; browsers silently ignore it.
+            ...(!(0, env_1.isBrowser)() ? { 'User-Agent': env_1.SDK_USER_AGENT } : {}),
+            ...(cfg.headers ?? {})
+        };
+    }
+    /**
+     * Execute a single JSON-RPC 2.0 call.
+     *
+     * Retries transparently on `method-not-allowed` (code `-32601`) up to
+     * `maxRetries` times, rotating upstreams if configured.
+     *
+     * @typeParam T - Expected result type.
+     * @param method - RPC method name (e.g. `'getBalance'`).
+     * @param params - Positional parameters array.
+     * @param opts   - Per-call overrides.
+     * @returns The JSON-RPC `result` payload, typed as `T`.
+     * @throws {TimeoutError} If the request exceeds the timeout.
+     * @throws {NetworkError} On HTTP / network failures.
+     * @throws {UpstreamError} If the upstream returns an RPC error with upstream metadata.
+     * @throws {SynapseError} For all other RPC errors.
+     * @since 1.0.0
+     */
+    async request(method, params = [], opts = {}) {
+        const maxAttempts = Math.max(1, opts.maxRetries ?? this.maxRetries);
+        let lastErr = null;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            const req = { jsonrpc: '2.0', id: ++this.id, method, params };
+            const t0 = this.debug ? performance.now() : 0;
+            if (this.debug)
+                console.log(`> [${req.id}] ${method}`, params.length ? params : '');
+            const res = await this.send(req, opts.timeout);
+            if (!res.error) {
+                if (this.debug)
+                    console.log(`< [${req.id}] OK ${Math.round(performance.now() - t0)}ms`);
+                return res.result;
+            }
+            // Method-not-allowed -- try next upstream
+            const msg = (res.error.message ?? '').toLowerCase();
+            if (res.error.code === -32601 || msg.includes('method not allowed')) {
+                lastErr = res;
+                continue;
+            }
+            // Build typed error
+            this.throwRpcError(res.error, method);
+        }
+        if (lastErr?.error)
+            this.throwRpcError(lastErr.error, method);
+        throw new errors_1.SynapseError('Unknown RPC error', -32000);
+    }
+    /**
+     * Execute a batch of JSON-RPC 2.0 calls in a single HTTP request.
+     *
+     * @typeParam T - Expected result type for each call.
+     * @param requests - Array of `{ method, params }` objects.
+     * @param opts     - Per-call overrides (applied to the batch request).
+     * @returns Array of results in the same order as `requests`.
+     * @throws {TimeoutError} If the batch exceeds the timeout.
+     * @throws {NetworkError} On HTTP / network failures.
+     * @since 1.0.0
+     */
+    async batch(requests, opts = {}) {
+        const reqs = requests.map(r => ({
+            jsonrpc: '2.0',
+            id: ++this.id,
+            method: r.method,
+            params: r.params ?? []
+        }));
+        const timeout = opts.timeout ?? this.timeout;
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), timeout);
+        try {
+            const res = await fetch(this.cfg.endpoint, {
+                method: 'POST',
+                headers: this.headers,
+                body: JSON.stringify(reqs),
+                signal: ctrl.signal
+            });
+            if (!res.ok)
+                throw new errors_1.NetworkError(`HTTP ${res.status}: ${res.statusText}`);
+            const body = await res.json();
+            return body.map(r => {
+                if (r.error)
+                    this.throwRpcError(r.error, 'batch');
+                return r.result;
+            });
+        }
+        catch (e) {
+            if (e instanceof errors_1.SynapseError)
+                throw e;
+            if (e.name === 'AbortError')
+                throw new errors_1.TimeoutError(timeout);
+            throw new errors_1.NetworkError(`Batch failed: ${e.message}`, e);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    // ── Private ────────────────────────────────────────────────────
+    async send(req, timeoutMs) {
+        const timeout = timeoutMs ?? this.timeout;
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), timeout);
+        try {
+            const res = await fetch(this.cfg.endpoint, {
+                method: 'POST',
+                headers: this.headers,
+                body: JSON.stringify(req),
+                signal: ctrl.signal
+            });
+            if (!res.ok)
+                throw new errors_1.NetworkError(`HTTP ${res.status}: ${res.statusText}`);
+            return await res.json();
+        }
+        catch (e) {
+            if (e instanceof errors_1.SynapseError)
+                throw e;
+            if (e.name === 'AbortError')
+                throw new errors_1.TimeoutError(timeout);
+            throw new errors_1.NetworkError(`Request failed: ${e.message}`, e);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    throwRpcError(err, method) {
+        const data = err.data;
+        if (data?.upstreamName || data?.upstreamUrl) {
+            throw new errors_1.UpstreamError(err.message, err.code, data.upstreamName, data.upstreamUrl);
+        }
+        throw new errors_1.SynapseError(`[${method}] ${err.message}`, err.code, err.data);
+    }
+}
+exports.HttpTransport = HttpTransport;
+//# sourceMappingURL=transport.js.map

package/dist/cjs/core/transport.js.map

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

package/dist/cjs/core/types.d.ts

@@ -0,0 +1,490 @@
+/**
+ * Solana-branded primitive types.
+ *
+ * Phantom brands enforce **nominal typing** at zero runtime cost.
+ * Every Solana concept (pubkey, signature, slot, lamports...) gets its own
+ * opaque type so the compiler prevents accidental cross-use.
+ *
+ * These types are Synapse-specific. For interop with `@solana/kit` native
+ * types ({@link Address}, {@link Signature}, etc.) see the bridge utilities
+ * in `@oobe-protocol-labs/synapse-client-sdk/kit`.
+ *
+ * @module core/types
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * import { Pubkey, Lamports, Slot } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * const pk  = Pubkey('So11111111111111111111111111111111111111112');
+ * const bal = Lamports(1_000_000_000n);
+ * const s   = Slot(250_000_000);
+ * ```
+ */
+/** @internal Unique symbol used for phantom branding. */
+declare const __brand: unique symbol;
+/**
+ * Phantom brand utility.
+ * Produces a nominal type `T & { [__brand]: B }` — the brand tag is
+ * erased at runtime so there is zero allocation overhead.
+ *
+ * @typeParam T - The underlying JavaScript type (`string`, `number`, `bigint`).
+ * @typeParam B - A unique string literal that identifies the brand.
+ * @since 1.0.0
+ */
+export type Brand<T, B extends string> = T & {
+    readonly [__brand]: B;
+};
+/** Base58-encoded string (Solana's default encoding). @since 1.0.0 */
+export type Base58 = Brand<string, 'Base58'>;
+/**
+ * Solana public key -- 32 bytes, base58-encoded.
+ *
+ * Use `toKitAddress()` from the `kit` module to convert to `@solana/kit`'s `Address` type.
+ * @since 1.0.0
+ */
+export type Pubkey = Brand<Base58, 'Pubkey'>;
+/**
+ * Transaction signature -- 64 bytes, base58-encoded.
+ *
+ * For `@solana/kit` interop see `kitSignature()` in the `kit` module.
+ * @since 1.0.0
+ */
+export type Signature = Brand<Base58, 'Signature'>;
+/** Slot number (absolute position in the ledger). @since 1.0.0 */
+export type Slot = Brand<number, 'Slot'>;
+/** Epoch number (Solana epoch counter). @since 1.0.0 */
+export type Epoch = Brand<number, 'Epoch'>;
+/**
+ * Lamport amount (1 SOL = 1 000 000 000 lamports).
+ *
+ * Use `toKitLamports()` from the `kit` module for `@solana/kit` interop.
+ * @since 1.0.0
+ */
+export type Lamports = Brand<bigint, 'Lamports'>;
+/** Unix timestamp in seconds. @since 1.0.0 */
+export type UnixTimestamp = Brand<number, 'UnixTimestamp'>;
+/**
+ * Create a branded {@link Pubkey} from a plain string.
+ * @param v - Base58-encoded public key string.
+ * @returns Branded `Pubkey`.
+ * @since 1.0.0
+ */
+export declare const Pubkey: (v: string) => Pubkey;
+/**
+ * Create a branded {@link Signature} from a plain string.
+ * @param v - Base58-encoded transaction signature.
+ * @returns Branded `Signature`.
+ * @since 1.0.0
+ */
+export declare const Sig: (v: string) => Signature;
+/**
+ * Create a branded {@link Slot} from a number.
+ * @param v - Numeric slot value.
+ * @returns Branded `Slot`.
+ * @since 1.0.0
+ */
+export declare const Slot: (v: number) => Slot;
+/**
+ * Create a branded {@link Epoch} from a number.
+ * @param v - Numeric epoch value.
+ * @returns Branded `Epoch`.
+ * @since 1.0.0
+ */
+export declare const Epoch: (v: number) => Epoch;
+/**
+ * Create a branded {@link Lamports} from a number or bigint.
+ * @param v - Lamport amount (will be coerced to `bigint`).
+ * @returns Branded `Lamports`.
+ * @since 1.0.0
+ */
+export declare const Lamports: (v: number | bigint) => Lamports;
+/**
+ * Create a branded {@link UnixTimestamp} from a number.
+ * @param v - Unix epoch seconds.
+ * @returns Branded `UnixTimestamp`.
+ * @since 1.0.0
+ */
+export declare const UnixTs: (v: number) => UnixTimestamp;
+/**
+ * Solana commitment level for RPC queries.
+ * - `processed` — fastest, may be rolled back.
+ * - `confirmed` — optimistic confirmation by super-majority.
+ * - `finalized` — guaranteed irreversible.
+ * @since 1.0.0
+ */
+export type Commitment = 'processed' | 'confirmed' | 'finalized';
+/**
+ * Account data encoding for RPC responses.
+ * @since 1.0.0
+ */
+export type Encoding = 'base58' | 'base64' | 'base64+zstd' | 'jsonParsed';
+/**
+ * Byte range to return for account data (used with `getAccountInfo`).
+ * @since 1.0.0
+ */
+export interface DataSlice {
+    /** Byte offset to start reading from. */
+    offset: number;
+    /** Number of bytes to read. */
+    length: number;
+}
+/**
+ * JSON-RPC 2.0 request envelope.
+ * @since 1.0.0
+ */
+export interface RpcRequest {
+    jsonrpc: '2.0';
+    id: number;
+    method: string;
+    params?: unknown[];
+}
+/**
+ * JSON-RPC 2.0 error object.
+ * @since 1.0.0
+ */
+export interface RpcError {
+    /** Numeric error code (e.g. `-32601` for method-not-found). */
+    code: number;
+    /** Human-readable error message. */
+    message: string;
+    /** Optional upstream-specific error data. */
+    data?: unknown;
+}
+/**
+ * JSON-RPC 2.0 response envelope.
+ * @typeParam T - The expected `result` payload type.
+ * @since 1.0.0
+ */
+export interface RpcResponse<T = unknown> {
+    jsonrpc: '2.0';
+    id: number | string;
+    result?: T;
+    error?: RpcError;
+}
+/**
+ * Solana RPC context wrapper — wraps a `value` with slot context.
+ * @typeParam T - The inner value type.
+ * @since 1.0.0
+ */
+export interface RpcContext<T> {
+    context: {
+        slot: Slot;
+        apiVersion?: string;
+    };
+    value: T;
+}
+/**
+ * On-chain account data returned by Solana RPC.
+ * @typeParam D - The encoding type for account data (`string`, `Buffer`, parsed JSON).
+ * @since 1.0.0
+ */
+export interface AccountInfo<D = string> {
+    /** Account data in the requested encoding. */
+    data: D;
+    /** Whether this account contains an executable program. */
+    executable: boolean;
+    /** Account balance in lamports. */
+    lamports: Lamports;
+    /** Owner program of this account. */
+    owner: Pubkey;
+    /** Rent epoch for this account. */
+    rentEpoch: Epoch;
+    /** Account data size in bytes. */
+    space: number;
+}
+/**
+ * Transaction metadata returned alongside confirmed transactions.
+ * @since 1.0.0
+ */
+export interface TransactionMeta {
+    /** Transaction error (`null` if success). */
+    err: unknown;
+    /** Transaction fee in lamports. */
+    fee: number;
+    /** Pre-transaction SOL balances for each account. */
+    preBalances: number[];
+    /** Post-transaction SOL balances for each account. */
+    postBalances: number[];
+    /** Pre-transaction token balances. */
+    preTokenBalances?: unknown[];
+    /** Post-transaction token balances. */
+    postTokenBalances?: unknown[];
+    /** Program log messages emitted during execution. */
+    logMessages?: string[];
+    /** Inner (CPI) instructions. */
+    innerInstructions?: unknown[];
+    /** Address table lookups (v0 transactions). */
+    loadedAddresses?: {
+        writable: Pubkey[];
+        readonly: Pubkey[];
+    };
+    /** Compute units consumed by the transaction. */
+    computeUnitsConsumed?: number;
+}
+/**
+ * A confirmed transaction with full metadata.
+ * @since 1.0.0
+ */
+export interface ConfirmedTransaction {
+    /** Slot in which the transaction was processed. */
+    slot: Slot;
+    /** Transaction metadata (fees, balances, logs). */
+    meta: TransactionMeta | null;
+    /** Raw transaction data. */
+    transaction: unknown;
+    /** Unix timestamp of the block. */
+    blockTime: UnixTimestamp | null;
+    /** Transaction version (`0` for v0, `'legacy'` for legacy). */
+    version?: number | 'legacy';
+}
+/**
+ * Status of a transaction signature.
+ * @since 1.0.0
+ */
+export interface SignatureStatus {
+    /** Slot where the transaction was processed. */
+    slot: Slot;
+    /** Number of confirmations (`null` = finalized). */
+    confirmations: number | null;
+    /** Error if the transaction failed. */
+    err: unknown;
+    /** Current confirmation status. */
+    confirmationStatus: Commitment | null;
+}
+/**
+ * Signature information returned by `getSignaturesForAddress`.
+ * @since 1.0.0
+ */
+export interface SignatureInfo {
+    /** Transaction signature (base58). */
+    signature: Signature;
+    /** Slot of the transaction. */
+    slot: Slot;
+    /** Error if the transaction failed. */
+    err: unknown;
+    /** Transaction memo (if present). */
+    memo: string | null;
+    /** Unix timestamp of the block. */
+    blockTime: UnixTimestamp | null;
+    /** Confirmation status at query time. */
+    confirmationStatus: Commitment | null;
+}
+/**
+ * Level of transaction detail to include in block responses.
+ * @since 1.0.0
+ */
+export type TransactionDetail = 'full' | 'accounts' | 'signatures' | 'none';
+/**
+ * Block production statistics from `getBlockProduction`.
+ * @since 1.0.0
+ */
+export interface BlockProduction {
+    /** Leader slots by validator identity: `[leaderSlots, blocksProduced]`. */
+    byIdentity: Record<Pubkey, [number, number]>;
+    /** Slot range covered. */
+    range: {
+        firstSlot: Slot;
+        lastSlot: Slot;
+    };
+}
+/**
+ * Current epoch information.
+ * @since 1.0.0
+ */
+export interface EpochInfo {
+    /** Current absolute slot. */
+    absoluteSlot: Slot;
+    /** Current block height. */
+    blockHeight: number;
+    /** Current epoch number. */
+    epoch: Epoch;
+    /** Current slot index within the epoch. */
+    slotIndex: number;
+    /** Total slots per epoch. */
+    slotsInEpoch: number;
+    /** Total transaction count (optional). */
+    transactionCount?: number;
+}
+/**
+ * Epoch schedule configuration.
+ * @since 1.0.0
+ */
+export interface EpochSchedule {
+    slotsPerEpoch: number;
+    leaderScheduleSlotOffset: number;
+    warmup: boolean;
+    firstNormalEpoch: Epoch;
+    firstNormalSlot: Slot;
+}
+/**
+ * Current inflation rate breakdown.
+ * @since 1.0.0
+ */
+export interface InflationRate {
+    total: number;
+    validator: number;
+    foundation: number;
+    epoch: Epoch;
+}
+/**
+ * Inflation governor parameters.
+ * @since 1.0.0
+ */
+export interface InflationGovernor {
+    initial: number;
+    terminal: number;
+    taper: number;
+    foundation: number;
+    foundationTerm: number;
+}
+/**
+ * Staking inflation reward for one epoch.
+ * @since 1.0.0
+ */
+export interface InflationReward {
+    epoch: Epoch;
+    effectiveSlot: Slot;
+    amount: number;
+    postBalance: number;
+    commission?: number;
+}
+/**
+ * Validator vote account information.
+ * @since 1.0.0
+ */
+export interface VoteAccount {
+    /** Vote account public key. */
+    votePubkey: Pubkey;
+    /** Validator node identity. */
+    nodePubkey: Pubkey;
+    /** Total activated stake in lamports. */
+    activatedStake: number;
+    /** Whether this account is active in the current epoch. */
+    epochVoteAccount: boolean;
+    /** Commission percentage (0–100). */
+    commission: number;
+    /** Last slot voted on. */
+    lastVote: Slot;
+    /** Epoch credit history: `[epoch, credits, previousCredits]`. */
+    epochCredits: [Epoch, number, number][];
+    /** Root slot. */
+    rootSlot: Slot;
+}
+/**
+ * Vote accounts grouped by status.
+ * @since 1.0.0
+ */
+export interface VoteAccountsResult {
+    /** Active validators. */
+    current: VoteAccount[];
+    /** Delinquent validators. */
+    delinquent: VoteAccount[];
+}
+/**
+ * Cluster node contact information.
+ * @since 1.0.0
+ */
+export interface ContactInfo {
+    pubkey: Pubkey;
+    gossip?: string;
+    tpu?: string;
+    rpc?: string;
+    version?: string;
+    featureSet?: number;
+    shredVersion?: number;
+}
+/**
+ * Recent performance sample.
+ * @since 1.0.0
+ */
+export interface PerfSample {
+    slot: Slot;
+    numSlots: number;
+    numTransactions: number;
+    numNonVoteTransactions: number;
+    samplePeriodSecs: number;
+}
+/**
+ * SOL supply breakdown.
+ * @since 1.0.0
+ */
+export interface Supply {
+    /** Total supply in lamports. */
+    total: Lamports;
+    /** Circulating supply in lamports. */
+    circulating: Lamports;
+    /** Non-circulating supply in lamports. */
+    nonCirculating: Lamports;
+    /** Accounts holding non-circulating supply. */
+    nonCirculatingAccounts: Pubkey[];
+}
+/**
+ * SPL token amount with UI formatting.
+ * @since 1.0.0
+ */
+export interface TokenAmount {
+    /** Raw amount as a string (avoids floating-point loss). */
+    amount: string;
+    /** Token decimals. */
+    decimals: number;
+    /** UI-friendly amount (`null` if zero). */
+    uiAmount: number | null;
+    /** UI-friendly amount as string. */
+    uiAmountString: string;
+}
+/**
+ * Token account with parsed owner/mint info.
+ * @since 1.0.0
+ */
+export interface TokenAccount {
+    /** Token account public key. */
+    pubkey: Pubkey;
+    /** Parsed account data including mint, owner, and balance. */
+    account: AccountInfo<{
+        parsed: {
+            info: {
+                mint: Pubkey;
+                owner: Pubkey;
+                tokenAmount: TokenAmount;
+            };
+            type: string;
+        };
+        program: string;
+        space: number;
+    }>;
+}
+/**
+ * Cursor-based pagination options.
+ * @since 1.0.0
+ */
+export interface PaginationOpts {
+    page?: number;
+    limit?: number;
+    before?: string;
+    after?: string;
+}
+/**
+ * Sort options for paginated queries.
+ * @since 1.0.0
+ */
+export interface SortOpts {
+    sortBy?: string;
+    sortDirection?: 'asc' | 'desc';
+}
+/** Memory comparison filter — matches account data at a specific offset. @since 1.0.0 */
+export type MemcmpFilter = {
+    memcmp: {
+        offset: number;
+        bytes: string;
+        encoding?: Encoding;
+    };
+};
+/** Data size filter — matches accounts with exactly N bytes. @since 1.0.0 */
+export type DataSizeFilter = {
+    dataSize: number;
+};
+/** Union of all supported `getProgramAccounts` filters. @since 1.0.0 */
+export type AccountFilter = MemcmpFilter | DataSizeFilter;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/core/types.d.ts.map

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