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

package/dist/esm/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/esm/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/esm/decoders/multisig.js

@@ -0,0 +1,46 @@
+/**
+ * SPL Token Multisig account decoder.
+ *
+ * Decodes the SPL Token multisig account layout (355 bytes).
+ *
+ * @module decoders/multisig
+ * @since 1.1.0
+ */
+import { AccountReader } from './layout.js';
+// ── Constants ──────────────────────────────────────────────────
+/** Maximum number of signers in a multisig. @since 1.1.0 */
+export const MAX_MULTISIG_SIGNERS = 11;
+/** SPL Multisig account size. @since 1.1.0 */
+export const 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
+ */
+export function decodeMultisig(data) {
+    if (data.length < MULTISIG_SIZE) {
+        throw new Error(`Multisig data too short: expected >= ${MULTISIG_SIZE} bytes, got ${data.length}`);
+    }
+    const r = new AccountReader(data);
+    const m = r.u8(); // [0]
+    const n = r.u8(); // [1]
+    const isInitialized = r.bool(); // [2]
+    const signers = [];
+    for (let i = 0; i < 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/esm/decoders/multisig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multisig.js","sourceRoot":"","sources":["../../../src/decoders/multisig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAyBzC,kEAAkE;AAElE,4DAA4D;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC,kEAAkE;AAElE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,IAAgB;IAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,wCAAwC,aAAa,eAAe,IAAI,CAAC,MAAM,EAAE,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,aAAa,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,oBAAoB,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/esm/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/esm/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/esm/decoders/nonce.js

@@ -0,0 +1,44 @@
+/**
+ * Solana Nonce Account decoder.
+ *
+ * Decodes durable nonce accounts used for offline/delayed transaction signing.
+ *
+ * @module decoders/nonce
+ * @since 1.1.0
+ */
+import { AccountReader } from './layout.js';
+// ── Constants ──────────────────────────────────────────────────
+/** System Program ID. @since 1.1.0 */
+export const SYSTEM_PROGRAM_ID = '11111111111111111111111111111111';
+/** Nonce account data size. @since 1.1.0 */
+export const 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
+ */
+export function decodeNonceAccount(data) {
+    if (data.length < NONCE_ACCOUNT_SIZE) {
+        throw new Error(`Nonce account data too short: expected >= ${NONCE_ACCOUNT_SIZE} bytes, got ${data.length}`);
+    }
+    const r = new 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/esm/decoders/nonce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonce.js","sourceRoot":"","sources":["../../../src/decoders/nonce.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA8BzC,kEAAkE;AAElE,sCAAsC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AAEpE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,kEAAkE;AAElE;;;;;;;;;;;;;;GAcG;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,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/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":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAOzC,MAAM,WAAW,GAAgC;IAC/C,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa;CAC3D,CAAC;AA6CF,kEAAkE;AAElE,qCAAqC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,6CAA6C,CAAC;AAE9E,kEAAkE;AAElE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAgB;IACjD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,0DAA0D,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IAElC,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAyB,SAAS;IAC1D,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,eAAe,CAAC;IAErD,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;IAClE,CAAC;IAED,+DAA+D;IAC/D,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,qEAAqE,IAAI,CAAC,MAAM,EAAE,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAe,UAAU;IAC3D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAuB,WAAW;IAC5D,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAmB,WAAW;IAC5D,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAmB,WAAW;IAC5D,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAA2B,WAAW;IAC5D,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAoB,YAAY;IAE7D,MAAM,IAAI,GAAc;QACtB,iBAAiB;QACjB,UAAU,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;QAClC,MAAM,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE;KAC5C,CAAC;IAEF,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;IAC5D,CAAC;IAED,+CAA+C;IAC/C,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,2EAA2E,IAAI,CAAC,MAAM,EAAE,CACzF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAkB,aAAa;IAC9D,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAqB,aAAa;IAC9D,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAiB,aAAa;IAC9D,MAAM,iBAAiB,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAe,aAAa;IAC9D,MAAM,kBAAkB,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAc,aAAa;IAC9D,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAiB,aAAa;IAE9D,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,KAAK,EAAE;YACL,WAAW;YACX,KAAK,EAAE,WAAW;YAClB,eAAe;YACf,iBAAiB;YACjB,kBAAkB;SACnB;QACD,eAAe;KAChB,CAAC;AACJ,CAAC"}

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