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

package/dist/cjs/das/methods/search-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-assets.d.ts","sourceRoot":"","sources":["../../../../src/das/methods/search-assets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,CAChC,CAAC,EAAE,aAAa,EAChB,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE,OAAO,GAAG,WAAgB,GAC/B,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAG5B"}

package/dist/cjs/das/methods/search-assets.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchAssets = searchAssets;
+/**
+ * Search for digital assets using flexible filter criteria.
+ *
+ * @param t - HTTP transport instance
+ * @param params - Search filters including owner, creator, authority, grouping, etc.
+ * @param opts - Commitment level and call options
+ * @returns Paginated list of matching assets
+ *
+ * @example
+ * ```ts
+ * const page = await searchAssets(transport, {
+ *   ownerAddress: 'Owner111...',
+ *   compressed: true,
+ *   page: 1,
+ * });
+ * console.log(page.total, page.items.length);
+ * ```
+ *
+ * @since 1.0.0
+ */
+async function searchAssets(t, params, opts = {}) {
+    const { commitment, ...rest } = opts;
+    return t.request('searchAssets', [{ ...params, ...(commitment ? { commitment } : {}) }], rest);
+}
+//# sourceMappingURL=search-assets.js.map

package/dist/cjs/das/methods/search-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-assets.js","sourceRoot":"","sources":["../../../../src/das/methods/search-assets.ts"],"names":[],"mappings":";;AA4BA,oCAOC;AA3BD;;;;;;;;;;;;;;;;;;;GAmBG;AACI,KAAK,UAAU,YAAY,CAChC,CAAgB,EAChB,MAAuB,EACvB,OAA8B,EAAE;IAEhC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;AACjG,CAAC"}

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

@@ -0,0 +1,257 @@
+/**
+ * @module das/types
+ * @description DAS type definitions for the Metaplex Read API — fully typed
+ * interfaces for NFTs, compressed NFTs, assets, proofs, and search queries
+ * conforming to the Digital Asset Standard specification.
+ * @since 1.0.0
+ */
+import type { Pubkey, Commitment } from '../core/types';
+/**
+ * Common request options for DAS API calls.
+ *
+ * Shared optional parameters passed to every DAS method.
+ * @since 1.0.0
+ */
+export interface DasOpts {
+    commitment?: Commitment;
+}
+/**
+ * A file reference attached to a digital asset's content.
+ *
+ * Represents a single off-chain file (image, video, etc.) linked to an asset.
+ * @since 1.0.0
+ */
+export interface DasFile {
+    uri?: string;
+    mime?: string;
+    quality?: string;
+    contexts?: string[];
+}
+/**
+ * On-chain and off-chain content metadata for a digital asset.
+ *
+ * Contains the JSON schema URI, associated files, metadata attributes,
+ * and external links for an asset.
+ * @since 1.0.0
+ */
+export interface DasContent {
+    $schema?: string;
+    json_uri?: string;
+    files?: DasFile[];
+    metadata?: {
+        name?: string;
+        symbol?: string;
+        description?: string;
+        token_standard?: string;
+        attributes?: {
+            trait_type: string;
+            value: string;
+        }[];
+    };
+    links?: Record<string, string>;
+}
+/**
+ * Ownership details of a digital asset.
+ *
+ * Tracks the current owner, delegation status, and ownership model.
+ * @since 1.0.0
+ */
+export interface DasOwnership {
+    frozen: boolean;
+    delegated: boolean;
+    delegate: Pubkey | null;
+    ownership_model: 'single' | 'token';
+    owner: Pubkey;
+}
+/**
+ * An authority associated with a digital asset.
+ *
+ * Represents an on-chain authority address and its permission scopes.
+ * @since 1.0.0
+ */
+export interface DasAuthority {
+    address: Pubkey;
+    scopes: string[];
+}
+/**
+ * Compression metadata for a compressed NFT (cNFT).
+ *
+ * Contains Merkle tree hashes, tree address, sequence number,
+ * and leaf index for state-compressed assets.
+ * @since 1.0.0
+ */
+export interface DasCompression {
+    eligible: boolean;
+    compressed: boolean;
+    data_hash: string;
+    creator_hash: string;
+    asset_hash: string;
+    tree: Pubkey;
+    seq: number;
+    leaf_id: number;
+}
+/**
+ * Grouping information for a digital asset (e.g. collection membership).
+ *
+ * Links an asset to a group such as a verified collection.
+ * @since 1.0.0
+ */
+export interface DasGrouping {
+    group_key: string;
+    group_value: string;
+    verified?: boolean;
+    collection_metadata?: DasContent;
+}
+/**
+ * Royalty configuration for a digital asset.
+ *
+ * Specifies the royalty model, target, basis points, and sale status.
+ * @since 1.0.0
+ */
+export interface DasRoyalty {
+    royalty_model: string;
+    target: Pubkey | null;
+    percent: number;
+    basis_points: number;
+    primary_sale_happened: boolean;
+    locked: boolean;
+}
+/**
+ * A creator entry on a digital asset.
+ *
+ * Represents a co-creator with their revenue share and verification status.
+ * @since 1.0.0
+ */
+export interface DasCreator {
+    address: Pubkey;
+    share: number;
+    verified: boolean;
+}
+/**
+ * Supply information for a digital asset edition.
+ *
+ * Tracks max supply, current supply, and edition nonce for print editions.
+ * @since 1.0.0
+ */
+export interface DasSupply {
+    print_max_supply: number;
+    print_current_supply: number;
+    edition_nonce: number | null;
+}
+/**
+ * The full representation of a Metaplex Digital Asset.
+ *
+ * Core response type returned by `getAsset` and search endpoints,
+ * containing content, ownership, compression, grouping, royalty, and token info.
+ * @since 1.0.0
+ */
+export interface DasAsset {
+    interface: string;
+    id: Pubkey;
+    content: DasContent;
+    authorities: DasAuthority[];
+    compression: DasCompression;
+    grouping: DasGrouping[];
+    royalty: DasRoyalty;
+    creators: DasCreator[];
+    ownership: DasOwnership;
+    supply: DasSupply | null;
+    mutable: boolean;
+    burnt: boolean;
+    mint_extensions?: Record<string, unknown>;
+    token_info?: {
+        symbol?: string;
+        balance?: number;
+        supply?: number;
+        decimals?: number;
+        token_program?: Pubkey;
+        associated_token_address?: Pubkey;
+        mint_authority?: Pubkey;
+        freeze_authority?: Pubkey;
+        price_info?: {
+            price_per_token?: number;
+            currency?: string;
+            total_price?: number;
+        };
+    };
+}
+/**
+ * Merkle proof for a compressed digital asset.
+ *
+ * Used to verify or modify a cNFT's state on the concurrent Merkle tree.
+ * @since 1.0.0
+ */
+export interface DasAssetProof {
+    root: string;
+    proof: string[];
+    node_index: number;
+    leaf: string;
+    tree_id: Pubkey;
+}
+/**
+ * Paginated result set returned by DAS list/search endpoints.
+ *
+ * Wraps an array of items with total count, page size, and cursor
+ * for efficient pagination.
+ * @typeParam T - The type of items in the page (defaults to {@link DasAsset}).
+ * @since 1.0.0
+ */
+export interface DasPage<T = DasAsset> {
+    total: number;
+    limit: number;
+    page: number;
+    cursor?: string;
+    items: T[];
+}
+/**
+ * Fields by which DAS search results can be sorted.
+ * @since 1.0.0
+ */
+export type DasSortBy = 'created' | 'updated' | 'recent_action' | 'none';
+/**
+ * Sort direction for DAS search results.
+ * @since 1.0.0
+ */
+export type DasSortDirection = 'asc' | 'desc';
+/**
+ * Comprehensive search parameters for the DAS `searchAssets` endpoint.
+ *
+ * Supports filtering by owner, creator, authority, collection grouping,
+ * token type, compression status, and many other asset attributes.
+ * @since 1.0.0
+ */
+export interface DasSearchParams {
+    page?: number;
+    limit?: number;
+    cursor?: string;
+    before?: string;
+    after?: string;
+    sortBy?: {
+        sortBy: DasSortBy;
+        sortDirection: DasSortDirection;
+    };
+    ownerAddress?: Pubkey;
+    creatorAddress?: Pubkey;
+    creatorVerified?: boolean;
+    authorityAddress?: Pubkey;
+    grouping?: [string, string];
+    burnt?: boolean;
+    compressed?: boolean;
+    compressible?: boolean;
+    frozen?: boolean;
+    supplyMint?: Pubkey;
+    supply?: number;
+    interface?: string;
+    delegate?: Pubkey;
+    jsonUri?: string;
+    name?: string;
+    tokenType?: 'fungible' | 'nonFungible' | 'regularNft' | 'compressedNft' | 'all';
+    showUnverifiedCollections?: boolean;
+    showCollectionMetadata?: boolean;
+    showGrandTotal?: boolean;
+    showFungible?: boolean;
+    showNativeBalance?: boolean;
+    showInscription?: boolean;
+    showZeroBalance?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/cjs/das/types.js

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

package/dist/cjs/das/types.js.map

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

package/dist/cjs/grpc/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * gRPC transport + Geyser subscription parser.
+ *
+ * @module grpc
+ * @since 1.0.0
+ */
+export * from './types';
+export * from './transport';
+export * from './parser/index';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/grpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/grpc/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/cjs/grpc/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * gRPC transport + Geyser subscription parser.
+ *
+ * @module grpc
+ * @since 1.0.0
+ */
+__exportStar(require("./types"), exports);
+__exportStar(require("./transport"), exports);
+__exportStar(require("./parser/index"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/grpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/grpc/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;GAKG;AACH,0CAAwB;AACxB,8CAA4B;AAC5B,iDAA+B"}

package/dist/cjs/grpc/parser/decoder.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Geyser gRPC Subscription Parser — Core decoder.
+ *
+ * Converts raw Yellowstone/Geyser protobuf-style messages into
+ * typed, developer-friendly objects. Handles:
+ *
+ * - Buffer → base58 conversion (signatures, pubkeys)
+ * - Balance diff calculation (SOL + SPL tokens)
+ * - Known program resolution
+ * - Inner instruction extraction
+ * - Transaction message decoding (v0 + legacy)
+ *
+ * Developers get both the **raw** update (pass-through) and the
+ * **parsed** version — they pick what they need.
+ *
+ * @module grpc/parser/decoder
+ * @since 1.0.0
+ */
+import type { RawBuffer, RawTimestamp, RawTransactionInfo, RawAccountInfo, RawSlotInfo, RawBlockMeta, RawEntry, RawGeyserUpdate, RawTokenBalance, BalanceChange, TokenBalanceChange, ParsedTransaction, ParsedAccountUpdate, ParsedSlotUpdate, ParsedBlockMeta, ParsedEntry, ParsedGeyserUpdate, GeyserParserConfig } from './types';
+/**
+ * Pure-JS base58 encode (no dependency on bs58).
+ * Used for converting raw signature/pubkey buffers to base58 strings.
+ * @since 1.0.0
+ */
+export declare function base58Encode(bytes: Uint8Array): string;
+/**
+ * Convert a raw protobuf Buffer descriptor to a Uint8Array.
+ * Handles both `{ type: 'Buffer', data: number[] }` and direct `number[]`.
+ * @since 1.0.0
+ */
+export declare function rawBufferToBytes(buf: RawBuffer | number[]): Uint8Array;
+/** Convert a raw buffer to a base58 string. @since 1.0.0 */
+export declare function rawBufferToBase58(buf: RawBuffer | number[]): string;
+/** Convert a raw buffer to hex string. @since 1.0.0 */
+export declare function rawBufferToHex(buf: RawBuffer | number[]): string;
+/** Convert a raw buffer to base64 string. @since 1.0.0 */
+export declare function rawBufferToBase64(buf: RawBuffer | number[]): string;
+/** Parse raw protobuf timestamp → Date. @since 1.0.0 */
+export declare function parseTimestamp(ts?: RawTimestamp): Date | undefined;
+/**
+ * Compute SOL balance changes from pre/post arrays.
+ * @since 1.0.0
+ */
+export declare function computeBalanceChanges(preBalances: string[], postBalances: string[], skipZero?: boolean): BalanceChange[];
+/**
+ * Compute SPL token balance changes from pre/post arrays.
+ * @since 1.0.0
+ */
+export declare function computeTokenBalanceChanges(preTokenBalances?: RawTokenBalance[], postTokenBalances?: RawTokenBalance[]): TokenBalanceChange[];
+/**
+ * Parse a raw gRPC transaction update into a developer-friendly object.
+ * @since 1.0.0
+ */
+export declare function parseTransaction(raw: {
+    transaction: RawTransactionInfo;
+    slot: string;
+}, config?: GeyserParserConfig, timestamp?: Date): ParsedTransaction;
+/**
+ * Parse a raw gRPC account update into a developer-friendly object.
+ * @since 1.0.0
+ */
+export declare function parseAccountUpdate(raw: {
+    account: RawAccountInfo;
+    slot: string;
+    is_startup: boolean;
+}, config?: GeyserParserConfig, timestamp?: Date): ParsedAccountUpdate;
+/**
+ * Parse a raw slot update.
+ * @since 1.0.0
+ */
+export declare function parseSlotUpdate(raw: RawSlotInfo, timestamp?: Date): ParsedSlotUpdate;
+/**
+ * Parse a raw block meta update.
+ * @since 1.0.0
+ */
+export declare function parseBlockMeta(raw: RawBlockMeta, timestamp?: Date): ParsedBlockMeta;
+/**
+ * Parse a raw entry notification.
+ * @since 1.0.0
+ */
+export declare function parseEntry(raw: RawEntry, timestamp?: Date): ParsedEntry;
+/**
+ * Parse any raw Geyser subscription update into a typed discriminated union.
+ *
+ * This is the main entry point — pass any raw update message from the
+ * gRPC stream and get back a fully parsed, typed object.
+ *
+ * @param raw - The raw update object from the gRPC subscribe() stream.
+ * @param config - Optional parser configuration.
+ * @returns Parsed update with `type` discriminant, or `null` if the update
+ *          was filtered out (e.g. vote transaction with `skipVotes: true`).
+ *
+ * @example
+ * ```ts
+ * import { parseGeyserUpdate } from '@oobe-protocol-labs/synapse-client-sdk/grpc';
+ *
+ * stream.on('data', (raw) => {
+ *   const parsed = parseGeyserUpdate(raw);
+ *   if (!parsed) return; // filtered out
+ *
+ *   switch (parsed.type) {
+ *     case 'transaction':
+ *       console.log(parsed.data.signature, parsed.data.programsInvoked);
+ *       break;
+ *     case 'account':
+ *       console.log(parsed.data.pubkey, parsed.data.sol);
+ *       break;
+ *     case 'slot':
+ *       console.log(parsed.data.slot, parsed.data.status);
+ *       break;
+ *   }
+ * });
+ * ```
+ * @since 1.0.0
+ */
+export declare function parseGeyserUpdate(raw: RawGeyserUpdate, config?: GeyserParserConfig): ParsedGeyserUpdate | null;
+//# sourceMappingURL=decoder.d.ts.map

package/dist/cjs/grpc/parser/decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../../../src/grpc/parser/decoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,eAAe,EAEf,aAAa,EACb,kBAAkB,EAElB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AASjB;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CA+BtD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,UAAU,CAGtE;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,MAAM,CAEnE;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,MAAM,CAOhE;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,MAAM,CAUnE;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,EAAE,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,CAIlE;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EAAE,EACrB,YAAY,EAAE,MAAM,EAAE,EACtB,QAAQ,UAAO,GACd,aAAa,EAAE,CAqBjB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,gBAAgB,CAAC,EAAE,eAAe,EAAE,EACpC,iBAAiB,CAAC,EAAE,eAAe,EAAE,GACpC,kBAAkB,EAAE,CA2CtB;AAgJD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE;IAAE,WAAW,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACtD,MAAM,GAAE,kBAAuB,EAC/B,SAAS,CAAC,EAAE,IAAI,GACf,iBAAiB,CA8HnB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,EACnE,MAAM,GAAE,kBAAuB,EAC/B,SAAS,CAAC,EAAE,IAAI,GACf,mBAAmB,CA0BrB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,EAChB,SAAS,CAAC,EAAE,IAAI,GACf,gBAAgB,CAkBlB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,YAAY,EACjB,SAAS,CAAC,EAAE,IAAI,GACf,eAAe,CAajB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,QAAQ,EACb,SAAS,CAAC,EAAE,IAAI,GACf,WAAW,CAYb;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,eAAe,EACpB,MAAM,GAAE,kBAAuB,GAC9B,kBAAkB,GAAG,IAAI,CA+D3B"}