@oobe-protocol-labs/synapse-client-sdk 1.0.2 → 1.0.3

package/dist/esm/decoders/stake.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Solana Stake Account decoder.
+ *
+ * Decodes the native stake program account layout into typed objects,
+ * including meta (authorized, lockup) and delegation fields.
+ *
+ * @module decoders/stake
+ * @since 1.1.0
+ */
+import type { Pubkey } from '../core/types';
+/** Stake account type discriminator. @since 1.1.0 */
+export type StakeAccountType = 'uninitialized' | 'initialized' | 'delegated' | 'rewardsPool';
+/** Authorized staker and withdrawer. @since 1.1.0 */
+export interface StakeAuthorized {
+    staker: Pubkey;
+    withdrawer: Pubkey;
+}
+/** Lockup configuration. @since 1.1.0 */
+export interface StakeLockup {
+    /** Unix timestamp until which stake is locked. 0 = no time lock. */
+    unixTimestamp: bigint;
+    /** Epoch until which stake is locked. 0 = no epoch lock. */
+    epoch: bigint;
+    /** Custodian who can override the lockup. */
+    custodian: Pubkey;
+}
+/** Stake account metadata (always present after initialization). @since 1.1.0 */
+export interface StakeMeta {
+    rentExemptReserve: bigint;
+    authorized: StakeAuthorized;
+    lockup: StakeLockup;
+}
+/** Stake delegation information (only present when type = 'delegated'). @since 1.1.0 */
+export interface StakeDelegation {
+    voterPubkey: Pubkey;
+    stake: bigint;
+    activationEpoch: bigint;
+    deactivationEpoch: bigint;
+    /** @deprecated Unused in modern Solana runtime, always 0.25 */
+    warmupCooldownRate: number;
+}
+/** Fully decoded stake account. @since 1.1.0 */
+export interface DecodedStakeAccount {
+    type: StakeAccountType;
+    meta: StakeMeta | null;
+    stake: StakeDelegation | null;
+    creditsObserved: bigint | null;
+}
+/** Stake Program ID. @since 1.1.0 */
+export declare const STAKE_PROGRAM_ID = "Stake11111111111111111111111111111111111111";
+/**
+ * Decode a Solana stake account from raw bytes.
+ *
+ * Layout (200 bytes for delegated):
+ * - [0..4]     u32   — discriminator (0=uninit, 1=init, 2=stake, 3=rewards)
+ * - [4..124]   meta  — rentExemptReserve(8) + authorized(64) + lockup(48)
+ * - [124..200] stake — delegation(72) + creditsObserved(8) [only if type=2]
+ *
+ * @param data - Raw stake account data.
+ * @returns Decoded stake account.
+ * @throws {Error} If data is too short.
+ * @since 1.1.0
+ */
+export declare function decodeStakeAccount(data: Uint8Array): DecodedStakeAccount;
+//# sourceMappingURL=stake.d.ts.map

package/dist/esm/decoders/stake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stake.d.ts","sourceRoot":"","sources":["../../../src/decoders/stake.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAK5C,qDAAqD;AACrD,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,CAAC;AAQ7F,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iFAAiF;AACjF,MAAM,WAAW,SAAS;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAID,qCAAqC;AACrC,eAAO,MAAM,gBAAgB,gDAAgD,CAAC;AAI9E;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,mBAAmB,CAgExE"}

package/dist/esm/decoders/stake.js

@@ -0,0 +1,82 @@
+/**
+ * Solana Stake Account decoder.
+ *
+ * Decodes the native stake program account layout into typed objects,
+ * including meta (authorized, lockup) and delegation fields.
+ *
+ * @module decoders/stake
+ * @since 1.1.0
+ */
+import { AccountReader } from './layout.js';
+const STAKE_TYPES = [
+    'uninitialized', 'initialized', 'delegated', 'rewardsPool',
+];
+// ── Constants ──────────────────────────────────────────────────
+/** Stake Program ID. @since 1.1.0 */
+export const STAKE_PROGRAM_ID = 'Stake11111111111111111111111111111111111111';
+// ── Decoder ────────────────────────────────────────────────────
+/**
+ * Decode a Solana stake account from raw bytes.
+ *
+ * Layout (200 bytes for delegated):
+ * - [0..4]     u32   — discriminator (0=uninit, 1=init, 2=stake, 3=rewards)
+ * - [4..124]   meta  — rentExemptReserve(8) + authorized(64) + lockup(48)
+ * - [124..200] stake — delegation(72) + creditsObserved(8) [only if type=2]
+ *
+ * @param data - Raw stake account data.
+ * @returns Decoded stake account.
+ * @throws {Error} If data is too short.
+ * @since 1.1.0
+ */
+export function decodeStakeAccount(data) {
+    if (data.length < 4) {
+        throw new Error(`Stake account data too short: expected >= 4 bytes, got ${data.length}`);
+    }
+    const r = new AccountReader(data);
+    const typeIdx = r.u32(); // [0..4]
+    const type = STAKE_TYPES[typeIdx] ?? 'uninitialized';
+    if (type === 'uninitialized') {
+        return { type, meta: null, stake: null, creditsObserved: null };
+    }
+    // Meta is always present for initialized/delegated/rewardsPool
+    if (data.length < 124) {
+        throw new Error(`Stake account data too short for meta: expected >= 124 bytes, got ${data.length}`);
+    }
+    const rentExemptReserve = r.u64(); // [4..12]
+    const staker = r.pubkey(); // [12..44]
+    const withdrawer = r.pubkey(); // [44..76]
+    const unixTimestamp = r.i64(); // [76..84]
+    const epoch = r.u64(); // [84..92]
+    const custodian = r.pubkey(); // [92..124]
+    const meta = {
+        rentExemptReserve,
+        authorized: { staker, withdrawer },
+        lockup: { unixTimestamp, epoch, custodian },
+    };
+    if (type !== 'delegated') {
+        return { type, meta, stake: null, creditsObserved: null };
+    }
+    // Delegation is present for type=2 (delegated)
+    if (data.length < 200) {
+        throw new Error(`Stake account data too short for delegation: expected >= 200 bytes, got ${data.length}`);
+    }
+    const voterPubkey = r.pubkey(); // [124..156]
+    const stakeAmount = r.u64(); // [156..164]
+    const activationEpoch = r.u64(); // [164..172]
+    const deactivationEpoch = r.u64(); // [172..180]
+    const warmupCooldownRate = r.f64(); // [180..188]
+    const creditsObserved = r.u64(); // [188..196]
+    return {
+        type,
+        meta,
+        stake: {
+            voterPubkey,
+            stake: stakeAmount,
+            activationEpoch,
+            deactivationEpoch,
+            warmupCooldownRate,
+        },
+        creditsObserved,
+    };
+}
+//# sourceMappingURL=stake.js.map

package/dist/esm/decoders/stake.js.map

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

package/dist/esm/decoders/token-2022.d.ts

@@ -0,0 +1,134 @@
+/**
+ * SPL Token-2022 (Token Extensions) decoder.
+ *
+ * Parses TLV (Type-Length-Value) extensions appended after the standard
+ * 165-byte token account or 82-byte mint layout.
+ *
+ * @module decoders/token-2022
+ * @since 1.1.0
+ */
+import type { DecodedTokenAccount, DecodedMint } from './token';
+import type { Pubkey } from '../core/types';
+/** Known Token-2022 extension types. @since 1.1.0 */
+export declare enum TokenExtensionType {
+    Uninitialized = 0,
+    TransferFeeConfig = 1,
+    TransferFeeAmount = 2,
+    MintCloseAuthority = 3,
+    ConfidentialTransferMint = 4,
+    ConfidentialTransferAccount = 5,
+    DefaultAccountState = 6,
+    ImmutableOwner = 7,
+    MemoTransfer = 8,
+    NonTransferable = 9,
+    InterestBearingConfig = 10,
+    CpiGuard = 11,
+    PermanentDelegate = 12,
+    NonTransferableAccount = 13,
+    TransferHook = 14,
+    TransferHookAccount = 15,
+    MetadataPointer = 18,
+    TokenMetadata = 19,
+    GroupPointer = 20,
+    GroupMemberPointer = 22
+}
+/** Transfer fee configuration extension. @since 1.1.0 */
+export interface TransferFeeConfig {
+    type: 'TransferFeeConfig';
+    transferFeeConfigAuthority: Pubkey;
+    withdrawWithheldAuthority: Pubkey;
+    withheldAmount: bigint;
+    olderTransferFee: {
+        epoch: bigint;
+        maximumFee: bigint;
+        transferFeeBasisPoints: number;
+    };
+    newerTransferFee: {
+        epoch: bigint;
+        maximumFee: bigint;
+        transferFeeBasisPoints: number;
+    };
+}
+/** Transfer fee amount (on token accounts). @since 1.1.0 */
+export interface TransferFeeAmount {
+    type: 'TransferFeeAmount';
+    withheldAmount: bigint;
+}
+/** Mint close authority extension. @since 1.1.0 */
+export interface MintCloseAuthorityExt {
+    type: 'MintCloseAuthority';
+    closeAuthority: Pubkey;
+}
+/** Default account state extension. @since 1.1.0 */
+export interface DefaultAccountStateExt {
+    type: 'DefaultAccountState';
+    state: number;
+}
+/** Immutable owner extension (marker, no data). @since 1.1.0 */
+export interface ImmutableOwnerExt {
+    type: 'ImmutableOwner';
+}
+/** Memo transfer extension. @since 1.1.0 */
+export interface MemoTransferExt {
+    type: 'MemoTransfer';
+    requireIncomingTransferMemos: boolean;
+}
+/** Non-transferable extension (marker). @since 1.1.0 */
+export interface NonTransferableExt {
+    type: 'NonTransferable';
+}
+/** Interest-bearing config extension. @since 1.1.0 */
+export interface InterestBearingConfigExt {
+    type: 'InterestBearingConfig';
+    rateAuthority: Pubkey;
+    initializationTimestamp: bigint;
+    preUpdateAverageRate: number;
+    lastUpdateTimestamp: bigint;
+    currentRate: number;
+}
+/** Permanent delegate extension. @since 1.1.0 */
+export interface PermanentDelegateExt {
+    type: 'PermanentDelegate';
+    delegate: Pubkey;
+}
+/** Metadata pointer extension. @since 1.1.0 */
+export interface MetadataPointerExt {
+    type: 'MetadataPointer';
+    authority: Pubkey;
+    metadataAddress: Pubkey;
+}
+/** Unknown / unrecognized extension. @since 1.1.0 */
+export interface UnknownExtension {
+    type: 'Unknown';
+    extensionType: number;
+    data: Uint8Array;
+}
+/** Union of all decoded extensions. @since 1.1.0 */
+export type DecodedExtension = TransferFeeConfig | TransferFeeAmount | MintCloseAuthorityExt | DefaultAccountStateExt | ImmutableOwnerExt | MemoTransferExt | NonTransferableExt | InterestBearingConfigExt | PermanentDelegateExt | MetadataPointerExt | UnknownExtension;
+/** Decoded Token-2022 account with extensions. @since 1.1.0 */
+export interface DecodedToken2022Account extends DecodedTokenAccount {
+    extensions: DecodedExtension[];
+}
+/** Decoded Token-2022 mint with extensions. @since 1.1.0 */
+export interface DecodedToken2022Mint extends DecodedMint {
+    extensions: DecodedExtension[];
+}
+/** SPL Token-2022 Program ID. @since 1.1.0 */
+export declare const TOKEN_2022_PROGRAM_ID = "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb";
+/**
+ * Decode a Token-2022 token account (base layout + TLV extensions).
+ *
+ * @param data - Raw account data (>= 165 bytes).
+ * @returns Decoded account with parsed extensions.
+ * @since 1.1.0
+ */
+export declare function decodeToken2022Account(data: Uint8Array): DecodedToken2022Account;
+/**
+ * Decode a Token-2022 mint (base layout + TLV extensions).
+ *
+ * @param data - Raw account data (>= 82 bytes).
+ * @returns Decoded mint with parsed extensions.
+ * @since 1.1.0
+ */
+export declare function decodeToken2022Mint(data: Uint8Array): DecodedToken2022Mint;
+//# sourceMappingURL=token-2022.d.ts.map

package/dist/esm/decoders/token-2022.d.ts.map

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

package/dist/esm/decoders/token-2022.js

@@ -0,0 +1,155 @@
+/**
+ * SPL Token-2022 (Token Extensions) decoder.
+ *
+ * Parses TLV (Type-Length-Value) extensions appended after the standard
+ * 165-byte token account or 82-byte mint layout.
+ *
+ * @module decoders/token-2022
+ * @since 1.1.0
+ */
+import { AccountReader } from './layout.js';
+import { decodeTokenAccount, decodeMint, TOKEN_ACCOUNT_SIZE, MINT_SIZE, } from './token.js';
+// ── Extension type enum ────────────────────────────────────────
+/** Known Token-2022 extension types. @since 1.1.0 */
+export var TokenExtensionType;
+(function (TokenExtensionType) {
+    TokenExtensionType[TokenExtensionType["Uninitialized"] = 0] = "Uninitialized";
+    TokenExtensionType[TokenExtensionType["TransferFeeConfig"] = 1] = "TransferFeeConfig";
+    TokenExtensionType[TokenExtensionType["TransferFeeAmount"] = 2] = "TransferFeeAmount";
+    TokenExtensionType[TokenExtensionType["MintCloseAuthority"] = 3] = "MintCloseAuthority";
+    TokenExtensionType[TokenExtensionType["ConfidentialTransferMint"] = 4] = "ConfidentialTransferMint";
+    TokenExtensionType[TokenExtensionType["ConfidentialTransferAccount"] = 5] = "ConfidentialTransferAccount";
+    TokenExtensionType[TokenExtensionType["DefaultAccountState"] = 6] = "DefaultAccountState";
+    TokenExtensionType[TokenExtensionType["ImmutableOwner"] = 7] = "ImmutableOwner";
+    TokenExtensionType[TokenExtensionType["MemoTransfer"] = 8] = "MemoTransfer";
+    TokenExtensionType[TokenExtensionType["NonTransferable"] = 9] = "NonTransferable";
+    TokenExtensionType[TokenExtensionType["InterestBearingConfig"] = 10] = "InterestBearingConfig";
+    TokenExtensionType[TokenExtensionType["CpiGuard"] = 11] = "CpiGuard";
+    TokenExtensionType[TokenExtensionType["PermanentDelegate"] = 12] = "PermanentDelegate";
+    TokenExtensionType[TokenExtensionType["NonTransferableAccount"] = 13] = "NonTransferableAccount";
+    TokenExtensionType[TokenExtensionType["TransferHook"] = 14] = "TransferHook";
+    TokenExtensionType[TokenExtensionType["TransferHookAccount"] = 15] = "TransferHookAccount";
+    TokenExtensionType[TokenExtensionType["MetadataPointer"] = 18] = "MetadataPointer";
+    TokenExtensionType[TokenExtensionType["TokenMetadata"] = 19] = "TokenMetadata";
+    TokenExtensionType[TokenExtensionType["GroupPointer"] = 20] = "GroupPointer";
+    TokenExtensionType[TokenExtensionType["GroupMemberPointer"] = 22] = "GroupMemberPointer";
+})(TokenExtensionType || (TokenExtensionType = {}));
+/** SPL Token-2022 Program ID. @since 1.1.0 */
+export const TOKEN_2022_PROGRAM_ID = 'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb';
+// ── TLV parser ─────────────────────────────────────────────────
+/**
+ * Parse TLV extensions from raw account data.
+ *
+ * Layout after base account:
+ * - 1 byte: AccountType discriminator (1 = Mint, 2 = Account)
+ * - TLV entries: [u16 type, u16 length, ...data] repeated
+ *
+ * @internal
+ */
+function parseTlvExtensions(data, baseSize) {
+    const extensions = [];
+    // Skip base layout + 1-byte AccountType discriminator
+    let offset = baseSize + 1;
+    while (offset + 4 <= data.length) {
+        const extType = data[offset] | (data[offset + 1] << 8); // u16 LE
+        const extLen = data[offset + 2] | (data[offset + 3] << 8); // u16 LE
+        offset += 4;
+        // End marker: type=0 && length=0
+        if (extType === 0 && extLen === 0)
+            break;
+        if (offset + extLen > data.length)
+            break;
+        const extData = data.slice(offset, offset + extLen);
+        extensions.push(decodeExtension(extType, extData));
+        offset += extLen;
+    }
+    return extensions;
+}
+/** @internal */
+function decodeExtension(extType, data) {
+    const r = new AccountReader(data);
+    switch (extType) {
+        case TokenExtensionType.TransferFeeConfig: {
+            const transferFeeConfigAuthority = r.pubkey();
+            const withdrawWithheldAuthority = r.pubkey();
+            const withheldAmount = r.u64();
+            const olderEpoch = r.u64();
+            const olderMax = r.u64();
+            const olderBps = r.u16();
+            const newerEpoch = r.u64();
+            const newerMax = r.u64();
+            const newerBps = r.u16();
+            return {
+                type: 'TransferFeeConfig',
+                transferFeeConfigAuthority,
+                withdrawWithheldAuthority,
+                withheldAmount,
+                olderTransferFee: { epoch: olderEpoch, maximumFee: olderMax, transferFeeBasisPoints: olderBps },
+                newerTransferFee: { epoch: newerEpoch, maximumFee: newerMax, transferFeeBasisPoints: newerBps },
+            };
+        }
+        case TokenExtensionType.TransferFeeAmount:
+            return { type: 'TransferFeeAmount', withheldAmount: r.u64() };
+        case TokenExtensionType.MintCloseAuthority:
+            return { type: 'MintCloseAuthority', closeAuthority: r.pubkey() };
+        case TokenExtensionType.DefaultAccountState:
+            return { type: 'DefaultAccountState', state: r.u8() };
+        case TokenExtensionType.ImmutableOwner:
+            return { type: 'ImmutableOwner' };
+        case TokenExtensionType.MemoTransfer:
+            return { type: 'MemoTransfer', requireIncomingTransferMemos: r.bool() };
+        case TokenExtensionType.NonTransferable:
+            return { type: 'NonTransferable' };
+        case TokenExtensionType.InterestBearingConfig: {
+            const rateAuthority = r.pubkey();
+            const initializationTimestamp = r.i64();
+            const preUpdateAverageRate = r.u16();
+            const lastUpdateTimestamp = r.i64();
+            const currentRate = r.u16();
+            return {
+                type: 'InterestBearingConfig',
+                rateAuthority,
+                initializationTimestamp,
+                preUpdateAverageRate,
+                lastUpdateTimestamp,
+                currentRate,
+            };
+        }
+        case TokenExtensionType.PermanentDelegate:
+            return { type: 'PermanentDelegate', delegate: r.pubkey() };
+        case TokenExtensionType.MetadataPointer:
+            return { type: 'MetadataPointer', authority: r.pubkey(), metadataAddress: r.pubkey() };
+        default:
+            return { type: 'Unknown', extensionType: extType, data };
+    }
+}
+// ── Public decoders ────────────────────────────────────────────
+/**
+ * Decode a Token-2022 token account (base layout + TLV extensions).
+ *
+ * @param data - Raw account data (>= 165 bytes).
+ * @returns Decoded account with parsed extensions.
+ * @since 1.1.0
+ */
+export function decodeToken2022Account(data) {
+    const base = decodeTokenAccount(data);
+    const extensions = data.length > TOKEN_ACCOUNT_SIZE + 1
+        ? parseTlvExtensions(data, TOKEN_ACCOUNT_SIZE)
+        : [];
+    return { ...base, extensions };
+}
+/**
+ * Decode a Token-2022 mint (base layout + TLV extensions).
+ *
+ * @param data - Raw account data (>= 82 bytes).
+ * @returns Decoded mint with parsed extensions.
+ * @since 1.1.0
+ */
+export function decodeToken2022Mint(data) {
+    const base = decodeMint(data);
+    const extensions = data.length > MINT_SIZE + 1
+        ? parseTlvExtensions(data, MINT_SIZE)
+        : [];
+    return { ...base, extensions };
+}
+//# sourceMappingURL=token-2022.js.map

package/dist/esm/decoders/token-2022.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-2022.js","sourceRoot":"","sources":["../../../src/decoders/token-2022.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,kBAAkB,EAAE,UAAU,EAC9B,kBAAkB,EAAE,SAAS,GAC9B,MAAM,SAAS,CAAC;AAIjB,kEAAkE;AAElE,qDAAqD;AACrD,MAAM,CAAN,IAAY,kBAqBX;AArBD,WAAY,kBAAkB;IAC5B,6EAA+B,CAAA;IAC/B,qFAA+B,CAAA;IAC/B,qFAA+B,CAAA;IAC/B,uFAA+B,CAAA;IAC/B,mGAA+B,CAAA;IAC/B,yGAA+B,CAAA;IAC/B,yFAA+B,CAAA;IAC/B,+EAA+B,CAAA;IAC/B,2EAA+B,CAAA;IAC/B,iFAA+B,CAAA;IAC/B,8FAAgC,CAAA;IAChC,oEAAgC,CAAA;IAChC,sFAAgC,CAAA;IAChC,gGAAgC,CAAA;IAChC,4EAAgC,CAAA;IAChC,0FAAgC,CAAA;IAChC,kFAAgC,CAAA;IAChC,8EAAgC,CAAA;IAChC,4EAAgC,CAAA;IAChC,wFAAgC,CAAA;AAClC,CAAC,EArBW,kBAAkB,KAAlB,kBAAkB,QAqB7B;AAwGD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,qBAAqB,GAAG,6CAA6C,CAAC;AAEnF,kEAAkE;AAElE;;;;;;;;GAQG;AACH,SAAS,kBAAkB,CAAC,IAAgB,EAAE,QAAgB;IAC5D,MAAM,UAAU,GAAuB,EAAE,CAAC;IAE1C,sDAAsD;IACtD,IAAI,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC;IAE1B,OAAO,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAG,SAAS;QACnE,MAAM,MAAM,GAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QACrE,MAAM,IAAI,CAAC,CAAC;QAEZ,iCAAiC;QACjC,IAAI,OAAO,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC;YAAE,MAAM;QACzC,IAAI,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,MAAM;YAAE,MAAM;QAEzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;QACpD,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACnD,MAAM,IAAI,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,gBAAgB;AAChB,SAAS,eAAe,CAAC,OAAe,EAAE,IAAgB;IACxD,MAAM,CAAC,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IAElC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAAC;YAC1C,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YAC9C,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YAC7C,MAAM,cAAc,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACzB,OAAO;gBACL,IAAI,EAAE,mBAAmB;gBACzB,0BAA0B;gBAC1B,yBAAyB;gBACzB,cAAc;gBACd,gBAAgB,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,sBAAsB,EAAE,QAAQ,EAAE;gBAC/F,gBAAgB,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,sBAAsB,EAAE,QAAQ,EAAE;aAChG,CAAC;QACJ,CAAC;QAED,KAAK,kBAAkB,CAAC,iBAAiB;YACvC,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,cAAc,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QAEhE,KAAK,kBAAkB,CAAC,kBAAkB;YACxC,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAEpE,KAAK,kBAAkB,CAAC,mBAAmB;YACzC,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;QAExD,KAAK,kBAAkB,CAAC,cAAc;YACpC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;QAEpC,KAAK,kBAAkB,CAAC,YAAY;YAClC,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,4BAA4B,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAE1E,KAAK,kBAAkB,CAAC,eAAe;YACrC,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAErC,KAAK,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAAC;YAC9C,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,uBAAuB,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACxC,MAAM,oBAAoB,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACrC,MAAM,mBAAmB,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACpC,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAC5B,OAAO;gBACL,IAAI,EAAE,uBAAuB;gBAC7B,aAAa;gBACb,uBAAuB;gBACvB,oBAAoB;gBACpB,mBAAmB;gBACnB,WAAW;aACZ,CAAC;QACJ,CAAC;QAED,KAAK,kBAAkB,CAAC,iBAAiB;YACvC,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAE7D,KAAK,kBAAkB,CAAC,eAAe;YACrC,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAEzF;YACE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,kEAAkE;AAElE;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAgB;IACrD,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,kBAAkB,GAAG,CAAC;QACrD,CAAC,CAAC,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,CAAC;QAC9C,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAgB;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,SAAS,GAAG,CAAC;QAC5C,CAAC,CAAC,kBAAkB,CAAC,IAAI,EAAE,SAAS,CAAC;QACrC,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC"}

package/dist/esm/decoders/token.d.ts

@@ -0,0 +1,87 @@
+/**
+ * SPL Token account and mint decoders.
+ *
+ * Decodes raw bytes from SPL Token program accounts into typed objects.
+ * Supports both Token Account (165 bytes) and Mint (82 bytes) layouts.
+ *
+ * @module decoders/token
+ * @since 1.1.0
+ */
+import type { Pubkey } from '../core/types';
+/** SPL Token account state. @since 1.1.0 */
+export type TokenAccountState = 'uninitialized' | 'initialized' | 'frozen';
+/**
+ * Decoded SPL Token Account (165 bytes).
+ *
+ * @example
+ * ```ts
+ * const decoded = decodeTokenAccount(rawBytes);
+ * console.log(`Mint: ${decoded.mint}, Amount: ${decoded.amount}`);
+ * ```
+ * @since 1.1.0
+ */
+export interface DecodedTokenAccount {
+    /** Token mint address. */
+    mint: Pubkey;
+    /** Account owner (wallet). */
+    owner: Pubkey;
+    /** Token balance (raw, not UI-adjusted). */
+    amount: bigint;
+    /** Delegate address (if approved). */
+    delegate: Pubkey | null;
+    /** Account state. */
+    state: TokenAccountState;
+    /** Native SOL balance if this is a wrapped SOL account. */
+    isNative: bigint | null;
+    /** Amount delegated to the delegate. */
+    delegatedAmount: bigint;
+    /** Close authority (who can close this account). */
+    closeAuthority: Pubkey | null;
+}
+/**
+ * Decoded SPL Token Mint (82 bytes).
+ *
+ * @example
+ * ```ts
+ * const mint = decodeMint(rawBytes);
+ * console.log(`Supply: ${mint.supply}, Decimals: ${mint.decimals}`);
+ * ```
+ * @since 1.1.0
+ */
+export interface DecodedMint {
+    /** Mint authority (who can mint new tokens). `null` if fixed supply. */
+    mintAuthority: Pubkey | null;
+    /** Total token supply. */
+    supply: bigint;
+    /** Number of decimal places. */
+    decimals: number;
+    /** Whether the mint is initialized. */
+    isInitialized: boolean;
+    /** Freeze authority (who can freeze accounts). `null` if not freezable. */
+    freezeAuthority: Pubkey | null;
+}
+/** Expected size of an SPL Token Account. @since 1.1.0 */
+export declare const TOKEN_ACCOUNT_SIZE = 165;
+/** Expected size of an SPL Token Mint. @since 1.1.0 */
+export declare const MINT_SIZE = 82;
+/** SPL Token Program ID. @since 1.1.0 */
+export declare const TOKEN_PROGRAM_ID = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+/**
+ * Decode raw bytes into a {@link DecodedTokenAccount}.
+ *
+ * @param data - Raw account data (must be >= 165 bytes).
+ * @returns Decoded token account.
+ * @throws {Error} If data is too short.
+ * @since 1.1.0
+ */
+export declare function decodeTokenAccount(data: Uint8Array): DecodedTokenAccount;
+/**
+ * Decode raw bytes into a {@link DecodedMint}.
+ *
+ * @param data - Raw account data (must be >= 82 bytes).
+ * @returns Decoded mint.
+ * @throws {Error} If data is too short.
+ * @since 1.1.0
+ */
+export declare function decodeMint(data: Uint8Array): DecodedMint;
+//# sourceMappingURL=token.d.ts.map

package/dist/esm/decoders/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/decoders/token.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAK5C,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,aAAa,GAAG,QAAQ,CAAC;AAQ3E;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qBAAqB;IACrB,KAAK,EAAE,iBAAiB,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,aAAa,EAAE,OAAO,CAAC;IACvB,2EAA2E;IAC3E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAID,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,uDAAuD;AACvD,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,yCAAyC;AACzC,eAAO,MAAM,gBAAgB,gDAAgD,CAAC;AAI9E;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,mBAAmB,CAoBxE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAgBxD"}

package/dist/esm/decoders/token.js

@@ -0,0 +1,66 @@
+/**
+ * SPL Token account and mint decoders.
+ *
+ * Decodes raw bytes from SPL Token program accounts into typed objects.
+ * Supports both Token Account (165 bytes) and Mint (82 bytes) layouts.
+ *
+ * @module decoders/token
+ * @since 1.1.0
+ */
+import { AccountReader } from './layout.js';
+const TOKEN_ACCOUNT_STATES = [
+    'uninitialized', 'initialized', 'frozen',
+];
+// ── Constants ──────────────────────────────────────────────────
+/** Expected size of an SPL Token Account. @since 1.1.0 */
+export const TOKEN_ACCOUNT_SIZE = 165;
+/** Expected size of an SPL Token Mint. @since 1.1.0 */
+export const MINT_SIZE = 82;
+/** SPL Token Program ID. @since 1.1.0 */
+export const TOKEN_PROGRAM_ID = 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA';
+// ── Decoder functions ──────────────────────────────────────────
+/**
+ * Decode raw bytes into a {@link DecodedTokenAccount}.
+ *
+ * @param data - Raw account data (must be >= 165 bytes).
+ * @returns Decoded token account.
+ * @throws {Error} If data is too short.
+ * @since 1.1.0
+ */
+export function decodeTokenAccount(data) {
+    if (data.length < TOKEN_ACCOUNT_SIZE) {
+        throw new Error(`Token account data too short: expected >= ${TOKEN_ACCOUNT_SIZE} bytes, got ${data.length}`);
+    }
+    const r = new AccountReader(data);
+    const mint = r.pubkey(); // 32 bytes  [0..32]
+    const owner = r.pubkey(); // 32 bytes  [32..64]
+    const amount = r.u64(); // 8 bytes   [64..72]
+    const delegate = r.coption(() => r.pubkey()); // 4+32=36 bytes [72..108]
+    const stateIdx = r.u8(); // 1 byte    [108]
+    const state = TOKEN_ACCOUNT_STATES[stateIdx] ?? 'uninitialized';
+    const isNative = r.coption(() => r.u64()); // 4+8=12 bytes  [109..121]
+    const delegatedAmount = r.u64(); // 8 bytes   [121..129]
+    const closeAuthority = r.coption(() => r.pubkey()); // 4+32=36 bytes [129..165]
+    return { mint, owner, amount, delegate, state, isNative, delegatedAmount, closeAuthority };
+}
+/**
+ * Decode raw bytes into a {@link DecodedMint}.
+ *
+ * @param data - Raw account data (must be >= 82 bytes).
+ * @returns Decoded mint.
+ * @throws {Error} If data is too short.
+ * @since 1.1.0
+ */
+export function decodeMint(data) {
+    if (data.length < MINT_SIZE) {
+        throw new Error(`Mint data too short: expected >= ${MINT_SIZE} bytes, got ${data.length}`);
+    }
+    const r = new AccountReader(data);
+    const mintAuthority = r.coption(() => r.pubkey()); // 4+32=36 bytes [0..36]
+    const supply = r.u64(); // 8 bytes       [36..44]
+    const decimals = r.u8(); // 1 byte        [44]
+    const isInitialized = r.bool(); // 1 byte        [45]
+    const freezeAuthority = r.coption(() => r.pubkey()); // 4+32=36 bytes [46..82]
+    return { mintAuthority, supply, decimals, isInitialized, freezeAuthority };
+}
+//# sourceMappingURL=token.js.map

package/dist/esm/decoders/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../../src/decoders/token.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAOzC,MAAM,oBAAoB,GAAiC;IACzD,eAAe,EAAE,aAAa,EAAE,QAAQ;CACzC,CAAC;AAwDF,kEAAkE;AAElE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC,uDAAuD;AACvD,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAE5B,yCAAyC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,6CAA6C,CAAC;AAE9E,kEAAkE;AAElE;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAgB;IACjD,IAAI,IAAI,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,6CAA6C,kBAAkB,eAAe,IAAI,CAAC,MAAM,EAAE,CAC5F,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IAElC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAe,oBAAoB;IAC3D,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAc,qBAAqB;IAC5D,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAgB,qBAAqB;IAC5D,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,0BAA0B;IACxE,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAc,kBAAkB;IACxD,MAAM,KAAK,GAAG,oBAAoB,CAAC,QAAQ,CAAC,IAAI,eAAe,CAAC;IAChE,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,2BAA2B;IACtE,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAO,uBAAuB;IAC9D,MAAM,cAAc,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,2BAA2B;IAE/E,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;AAC7F,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,oCAAoC,SAAS,eAAe,IAAI,CAAC,MAAM,EAAE,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IAElC,MAAM,aAAa,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,wBAAwB;IAC3E,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAA4B,yBAAyB;IAC5E,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAA2B,qBAAqB;IACxE,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAoB,qBAAqB;IACxE,MAAM,eAAe,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,yBAAyB;IAE9E,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;AAC7E,CAAC"}

package/dist/esm/index.d.ts

@@ -29,6 +29,8 @@ export * from './das/index';
 export * from './websocket/index';
 export * from './utils/index';
 export * from './kit/index';
+export * from './decoders/index';
+export * from './accounts/index';
 import { SynapseClient, type SynapseClientConfig } from './core/client';
 /**
  * Convenience factory to create a {@link SynapseClient} instance.

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,cAAc,cAAc,CAAC;AAG7B,cAAc,aAAa,CAAC;AAG5B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACxE;;;;;;;;;;;GAWG,CAAA,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAE3E;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,cAAc,cAAc,CAAC;AAG7B,cAAc,aAAa,CAAC;AAG5B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACxE;;;;;;;;;;;GAWG,CAAA,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAE3E;AAED,eAAe,aAAa,CAAC"}

package/dist/esm/index.js

@@ -37,6 +37,10 @@ export * from './websocket/index.js';
 export * from './utils/index.js';
 // ── @solana/kit bridge (native types, signers, RPC) ────────────
 export * from './kit/index.js';
+// ── Native account data decoders (zero-dep, DataView-based) ────
+export * from './decoders/index.js';
+// ── Typed account fetchers (RPC + decode in one call) ──────────
+export * from './accounts/index.js';
 // ── Convenience factory ────────────────────────────────────────
 import { SynapseClient } from './core/client.js';
 /**