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

package/dist/cjs/decoders/lookup-table.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Address Lookup Table decoder.
+ *
+ * Decodes v0 transaction lookup table accounts used for compressing
+ * transaction address lists.
+ *
+ * @module decoders/lookup-table
+ * @since 1.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOOKUP_TABLE_HEADER_SIZE = exports.LOOKUP_TABLE_PROGRAM_ID = void 0;
+exports.decodeLookupTable = decodeLookupTable;
+const types_1 = require("../core/types");
+const layout_1 = require("./layout");
+// ── Constants ──────────────────────────────────────────────────
+/** Address Lookup Table Program ID. @since 1.1.0 */
+exports.LOOKUP_TABLE_PROGRAM_ID = 'AddressLookupTab1e1111111111111111111111111';
+/** Header size of a lookup table account. @since 1.1.0 */
+exports.LOOKUP_TABLE_HEADER_SIZE = 56;
+/** Sentinel value for "no deactivation scheduled". @since 1.1.0 */
+const MAX_U64 = 0xffffffffffffffffn;
+// ── Decoder ────────────────────────────────────────────────────
+/**
+ * Decode an Address Lookup Table account from raw bytes.
+ *
+ * Layout:
+ * - [0..4]   u32     — discriminator (always 1)
+ * - [4..12]  u64     — deactivation slot (MAX_U64 = active)
+ * - [12..20] u64     — last extended slot
+ * - [20]     u8      — last extended slot start index
+ * - [21]     u8      — has authority (0 or 1)
+ * - [22..24] [u8;2]  — padding
+ * - [24..56] [u8;32] — authority (meaningful only if has_authority=1)
+ * - [56..]   [Pubkey] — addresses (32 bytes each)
+ *
+ * @param data - Raw account data (must be >= 56 bytes).
+ * @returns Decoded lookup table.
+ * @throws {Error} If data is too short.
+ * @since 1.1.0
+ */
+function decodeLookupTable(data) {
+    if (data.length < exports.LOOKUP_TABLE_HEADER_SIZE) {
+        throw new Error(`Lookup table data too short: expected >= ${exports.LOOKUP_TABLE_HEADER_SIZE} bytes, got ${data.length}`);
+    }
+    const r = new layout_1.AccountReader(data);
+    const discriminator = r.u32(); // [0..4]
+    const deactivationSlot = r.u64(); // [4..12]
+    const lastExtendedSlot = r.u64(); // [12..20]
+    const lastExtendedSlotStartIndex = r.u8(); // [20]
+    const hasAuthority = r.u8(); // [21]
+    r.skip(2); // [22..24] padding
+    const authorityPubkey = r.pubkey(); // [24..56]
+    const authority = hasAuthority === 1 ? authorityPubkey : null;
+    const isDeactivated = deactivationSlot !== MAX_U64;
+    // Parse addresses (remaining data, 32 bytes each)
+    const addressesData = data.slice(exports.LOOKUP_TABLE_HEADER_SIZE);
+    const numAddresses = Math.floor(addressesData.length / 32);
+    const addresses = [];
+    for (let i = 0; i < numAddresses; i++) {
+        const offset = i * 32;
+        const addrBytes = addressesData.slice(offset, offset + 32);
+        addresses.push((0, types_1.Pubkey)((0, layout_1.encodeBase58)(addrBytes)));
+    }
+    return {
+        discriminator,
+        deactivationSlot,
+        lastExtendedSlot,
+        lastExtendedSlotStartIndex,
+        authority,
+        addresses,
+        isDeactivated,
+    };
+}
+//# sourceMappingURL=lookup-table.js.map

package/dist/cjs/decoders/lookup-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-table.js","sourceRoot":"","sources":["../../../src/decoders/lookup-table.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAkEH,8CAwCC;AAvGD,yCAAmD;AACnD,qCAAuD;AA+BvD,kEAAkE;AAElE,oDAAoD;AACvC,QAAA,uBAAuB,GAAG,6CAA6C,CAAC;AAErF,0DAA0D;AAC7C,QAAA,wBAAwB,GAAG,EAAE,CAAC;AAE3C,mEAAmE;AACnE,MAAM,OAAO,GAAG,mBAAmB,CAAC;AAEpC,kEAAkE;AAElE;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,iBAAiB,CAAC,IAAgB;IAChD,IAAI,IAAI,CAAC,MAAM,GAAG,gCAAwB,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,4CAA4C,gCAAwB,eAAe,IAAI,CAAC,MAAM,EAAE,CACjG,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,sBAAa,CAAC,IAAI,CAAC,CAAC;IAElC,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAuB,SAAS;IAC9D,MAAM,gBAAgB,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAoB,UAAU;IAC/D,MAAM,gBAAgB,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAoB,WAAW;IAChE,MAAM,0BAA0B,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAW,OAAO;IAC5D,MAAM,YAAY,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAyB,OAAO;IAC5D,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAA2C,mBAAmB;IACxE,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAkB,WAAW;IAEhE,MAAM,SAAS,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,aAAa,GAAG,gBAAgB,KAAK,OAAO,CAAC;IAEnD,kDAAkD;IAClD,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,gCAAwB,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;QAC3D,SAAS,CAAC,IAAI,CAAC,IAAA,cAAQ,EAAC,IAAA,qBAAY,EAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO;QACL,aAAa;QACb,gBAAgB;QAChB,gBAAgB;QAChB,0BAA0B;QAC1B,SAAS;QACT,SAAS;QACT,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/cjs/decoders/multisig.d.ts

@@ -0,0 +1,49 @@
+/**
+ * SPL Token Multisig account decoder.
+ *
+ * Decodes the SPL Token multisig account layout (355 bytes).
+ *
+ * @module decoders/multisig
+ * @since 1.1.0
+ */
+import type { Pubkey } from '../core/types';
+/**
+ * Decoded SPL Multisig account (355 bytes).
+ *
+ * @example
+ * ```ts
+ * const ms = decodeMultisig(rawBytes);
+ * console.log(`Threshold: ${ms.m} of ${ms.n}, Signers: ${ms.signers.length}`);
+ * ```
+ * @since 1.1.0
+ */
+export interface DecodedMultisig {
+    /** Number of signers required (threshold). */
+    m: number;
+    /** Number of valid signers in the list. */
+    n: number;
+    /** Whether the multisig is initialized. */
+    isInitialized: boolean;
+    /** List of valid signer public keys (up to 11). */
+    signers: Pubkey[];
+}
+/** Maximum number of signers in a multisig. @since 1.1.0 */
+export declare const MAX_MULTISIG_SIGNERS = 11;
+/** SPL Multisig account size. @since 1.1.0 */
+export declare const MULTISIG_SIZE = 355;
+/**
+ * Decode an SPL Token Multisig account from raw bytes.
+ *
+ * Layout (355 bytes):
+ * - [0]       u8         — m (threshold)
+ * - [1]       u8         — n (total valid signers)
+ * - [2]       u8         — is_initialized
+ * - [3..355]  [Pubkey;11] — signer slots (32 bytes each, only first n are valid)
+ *
+ * @param data - Raw account data (must be >= 355 bytes).
+ * @returns Decoded multisig account.
+ * @throws {Error} If data is too short.
+ * @since 1.1.0
+ */
+export declare function decodeMultisig(data: Uint8Array): DecodedMultisig;
+//# sourceMappingURL=multisig.d.ts.map

package/dist/cjs/decoders/multisig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multisig.d.ts","sourceRoot":"","sources":["../../../src/decoders/multisig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAK5C;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,CAAC,EAAE,MAAM,CAAC;IACV,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC;IACV,2CAA2C;IAC3C,aAAa,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAID,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,8CAA8C;AAC9C,eAAO,MAAM,aAAa,MAAM,CAAC;AAIjC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAoBhE"}

package/dist/cjs/decoders/multisig.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * SPL Token Multisig account decoder.
+ *
+ * Decodes the SPL Token multisig account layout (355 bytes).
+ *
+ * @module decoders/multisig
+ * @since 1.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MULTISIG_SIZE = exports.MAX_MULTISIG_SIGNERS = void 0;
+exports.decodeMultisig = decodeMultisig;
+const layout_1 = require("./layout");
+// ── Constants ──────────────────────────────────────────────────
+/** Maximum number of signers in a multisig. @since 1.1.0 */
+exports.MAX_MULTISIG_SIGNERS = 11;
+/** SPL Multisig account size. @since 1.1.0 */
+exports.MULTISIG_SIZE = 355;
+// ── Decoder ────────────────────────────────────────────────────
+/**
+ * Decode an SPL Token Multisig account from raw bytes.
+ *
+ * Layout (355 bytes):
+ * - [0]       u8         — m (threshold)
+ * - [1]       u8         — n (total valid signers)
+ * - [2]       u8         — is_initialized
+ * - [3..355]  [Pubkey;11] — signer slots (32 bytes each, only first n are valid)
+ *
+ * @param data - Raw account data (must be >= 355 bytes).
+ * @returns Decoded multisig account.
+ * @throws {Error} If data is too short.
+ * @since 1.1.0
+ */
+function decodeMultisig(data) {
+    if (data.length < exports.MULTISIG_SIZE) {
+        throw new Error(`Multisig data too short: expected >= ${exports.MULTISIG_SIZE} bytes, got ${data.length}`);
+    }
+    const r = new layout_1.AccountReader(data);
+    const m = r.u8(); // [0]
+    const n = r.u8(); // [1]
+    const isInitialized = r.bool(); // [2]
+    const signers = [];
+    for (let i = 0; i < exports.MAX_MULTISIG_SIGNERS; i++) {
+        const pk = r.pubkey();
+        if (i < n)
+            signers.push(pk);
+    }
+    return { m, n, isInitialized, signers };
+}
+//# sourceMappingURL=multisig.js.map

package/dist/cjs/decoders/multisig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multisig.js","sourceRoot":"","sources":["../../../src/decoders/multisig.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAoDH,wCAoBC;AArED,qCAAyC;AAyBzC,kEAAkE;AAElE,4DAA4D;AAC/C,QAAA,oBAAoB,GAAG,EAAE,CAAC;AAEvC,8CAA8C;AACjC,QAAA,aAAa,GAAG,GAAG,CAAC;AAEjC,kEAAkE;AAElE;;;;;;;;;;;;;GAaG;AACH,SAAgB,cAAc,CAAC,IAAgB;IAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,qBAAa,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,wCAAwC,qBAAa,eAAe,IAAI,CAAC,MAAM,EAAE,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,sBAAa,CAAC,IAAI,CAAC,CAAC;IAElC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAc,MAAM;IACrC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAc,MAAM;IACrC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM;IAEtC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,4BAAoB,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/dist/cjs/decoders/nonce.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Solana Nonce Account decoder.
+ *
+ * Decodes durable nonce accounts used for offline/delayed transaction signing.
+ *
+ * @module decoders/nonce
+ * @since 1.1.0
+ */
+import type { Pubkey } from '../core/types';
+/** Nonce account state. @since 1.1.0 */
+export type NonceState = 'uninitialized' | 'initialized';
+/**
+ * Decoded Solana Nonce Account (80 bytes).
+ *
+ * @example
+ * ```ts
+ * const nonce = decodeNonceAccount(rawBytes);
+ * console.log(`Blockhash: ${nonce.blockhash}, Authority: ${nonce.authority}`);
+ * ```
+ * @since 1.1.0
+ */
+export interface DecodedNonceAccount {
+    /** Nonce version discriminant (0 = Legacy, 1 = Current). Most nonces are Current (1). */
+    version: number;
+    /** Account state. */
+    state: NonceState;
+    /** Authority that can advance the nonce. */
+    authority: Pubkey;
+    /** Stored durable blockhash. */
+    blockhash: string;
+    /** Fee calculator lamports per signature at the stored blockhash. */
+    lamportsPerSignature: bigint;
+}
+/** System Program ID. @since 1.1.0 */
+export declare const SYSTEM_PROGRAM_ID = "11111111111111111111111111111111";
+/** Nonce account data size. @since 1.1.0 */
+export declare const NONCE_ACCOUNT_SIZE = 80;
+/**
+ * Decode a Solana nonce account from raw bytes.
+ *
+ * Layout (80 bytes):
+ * - [0..4]   u32     — version (0=Legacy, 1=Current)
+ * - [4..8]   u32     — state (0=uninitialized, 1=initialized)
+ * - [8..40]  [u8;32] — authority pubkey
+ * - [40..72] [u8;32] — durable blockhash
+ * - [72..80] u64     — lamports per signature
+ *
+ * @param data - Raw account data (must be >= 80 bytes).
+ * @returns Decoded nonce account.
+ * @throws {Error} If data is too short.
+ * @since 1.1.0
+ */
+export declare function decodeNonceAccount(data: Uint8Array): DecodedNonceAccount;
+//# sourceMappingURL=nonce.d.ts.map

package/dist/cjs/decoders/nonce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonce.d.ts","sourceRoot":"","sources":["../../../src/decoders/nonce.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAK5C,wCAAwC;AACxC,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,aAAa,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,KAAK,EAAE,UAAU,CAAC;IAClB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAID,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,qCAAqC,CAAC;AAEpE,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAIrC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,mBAAmB,CAiBxE"}

package/dist/cjs/decoders/nonce.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Solana Nonce Account decoder.
+ *
+ * Decodes durable nonce accounts used for offline/delayed transaction signing.
+ *
+ * @module decoders/nonce
+ * @since 1.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NONCE_ACCOUNT_SIZE = exports.SYSTEM_PROGRAM_ID = void 0;
+exports.decodeNonceAccount = decodeNonceAccount;
+const layout_1 = require("./layout");
+// ── Constants ──────────────────────────────────────────────────
+/** System Program ID. @since 1.1.0 */
+exports.SYSTEM_PROGRAM_ID = '11111111111111111111111111111111';
+/** Nonce account data size. @since 1.1.0 */
+exports.NONCE_ACCOUNT_SIZE = 80;
+// ── Decoder ────────────────────────────────────────────────────
+/**
+ * Decode a Solana nonce account from raw bytes.
+ *
+ * Layout (80 bytes):
+ * - [0..4]   u32     — version (0=Legacy, 1=Current)
+ * - [4..8]   u32     — state (0=uninitialized, 1=initialized)
+ * - [8..40]  [u8;32] — authority pubkey
+ * - [40..72] [u8;32] — durable blockhash
+ * - [72..80] u64     — lamports per signature
+ *
+ * @param data - Raw account data (must be >= 80 bytes).
+ * @returns Decoded nonce account.
+ * @throws {Error} If data is too short.
+ * @since 1.1.0
+ */
+function decodeNonceAccount(data) {
+    if (data.length < exports.NONCE_ACCOUNT_SIZE) {
+        throw new Error(`Nonce account data too short: expected >= ${exports.NONCE_ACCOUNT_SIZE} bytes, got ${data.length}`);
+    }
+    const r = new layout_1.AccountReader(data);
+    const version = r.u32(); // [0..4]
+    const stateVal = r.u32(); // [4..8]
+    const state = stateVal === 1 ? 'initialized' : 'uninitialized';
+    const authority = r.pubkey(); // [8..40]
+    const blockhash = r.hash(); // [40..72]
+    const lamportsPerSignature = r.u64(); // [72..80]
+    return { version, state, authority, blockhash, lamportsPerSignature };
+}
+//# sourceMappingURL=nonce.js.map

package/dist/cjs/decoders/nonce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonce.js","sourceRoot":"","sources":["../../../src/decoders/nonce.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA0DH,gDAiBC;AAxED,qCAAyC;AA8BzC,kEAAkE;AAElE,sCAAsC;AACzB,QAAA,iBAAiB,GAAG,kCAAkC,CAAC;AAEpE,4CAA4C;AAC/B,QAAA,kBAAkB,GAAG,EAAE,CAAC;AAErC,kEAAkE;AAElE;;;;;;;;;;;;;;GAcG;AACH,SAAgB,kBAAkB,CAAC,IAAgB;IACjD,IAAI,IAAI,CAAC,MAAM,GAAG,0BAAkB,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,6CAA6C,0BAAkB,eAAe,IAAI,CAAC,MAAM,EAAE,CAC5F,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,sBAAa,CAAC,IAAI,CAAC,CAAC;IAElC,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAA2B,SAAS;IAC5D,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAA0B,SAAS;IAC5D,MAAM,KAAK,GAAe,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC;IAC3E,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAsB,UAAU;IAC7D,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAwB,WAAW;IAC9D,MAAM,oBAAoB,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAc,WAAW;IAE9D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAE,CAAC;AACxE,CAAC"}

package/dist/cjs/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/cjs/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/cjs/decoders/stake.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STAKE_PROGRAM_ID = void 0;
+exports.decodeStakeAccount = decodeStakeAccount;
+const layout_1 = require("./layout");
+const STAKE_TYPES = [
+    'uninitialized', 'initialized', 'delegated', 'rewardsPool',
+];
+// ── Constants ──────────────────────────────────────────────────
+/** Stake Program ID. @since 1.1.0 */
+exports.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
+ */
+function decodeStakeAccount(data) {
+    if (data.length < 4) {
+        throw new Error(`Stake account data too short: expected >= 4 bytes, got ${data.length}`);
+    }
+    const r = new layout_1.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/cjs/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/cjs/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/cjs/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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"}