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

package/dist/esm/core/client.d.ts

@@ -38,6 +38,7 @@ import type { SolanaRpc } from '../rpc/solana-rpc';
 import type { DasClient } from '../das/client';
 import type { WsClient } from '../websocket/client';
 import type { GrpcTransport } from '../grpc/transport';
+import type { AccountsClient } from '../accounts/index';
 import type { EndpointConnectConfig } from '../utils/synapse';
 /**
  * Configuration for {@link SynapseClient}.
@@ -58,6 +59,7 @@ export declare class SynapseClient {
     private _das?;
     private _ws?;
     private _grpc?;
+    private _accounts?;
     private _kitRpc?;
     private _kitSubs?;
     constructor(config: SynapseClientConfig);
@@ -131,6 +133,29 @@ export declare class SynapseClient {
      * @since 1.0.0
      */
     get grpc(): GrpcTransport;
+    /**
+     * Typed account fetchers with built-in binary decoding.
+     *
+     * Fetches raw accounts via RPC, base64-decodes the data, and applies
+     * zero-dep DataView decoders — returning fully typed objects for
+     * Token, Mint, Stake, Nonce, Lookup Table, and custom accounts.
+     *
+     * Lazy-loaded on first access.
+     *
+     * @since 1.1.0
+     *
+     * @example
+     * ```ts
+     * import { Pubkey } from '@oobe-protocol-labs/synapse-client-sdk';
+     *
+     * const mint = await client.accounts.fetchMint(Pubkey('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'));
+     * console.log(`USDC supply: ${mint?.decoded.supply}, decimals: ${mint?.decoded.decimals}`);
+     *
+     * const token = await client.accounts.fetchTokenAccount(Pubkey('...'));
+     * console.log(`Balance: ${token?.decoded.amount}`);
+     * ```
+     */
+    get accounts(): AccountsClient;
     /**
      * Gracefully shut down all active connections (WebSocket, gRPC).
      * @since 1.0.0

package/dist/esm/core/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAIpF,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAGlG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9D;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;IAG1C,OAAO,CAAC,IAAI,CAAC,CAAY;IACzB,OAAO,CAAC,IAAI,CAAC,CAAY;IACzB,OAAO,CAAC,GAAG,CAAC,CAAW;IACvB,OAAO,CAAC,KAAK,CAAC,CAAgB;IAG9B,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAC,CAA8C;gBAEnD,MAAM,EAAE,mBAAmB;IAUvC;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,qBAAqB,GAAG,aAAa;IAajE;;;;;;;;;OASG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IAI7F;;;;;;;;OAQG;IACH,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAM5G;;;;OAIG;IACH,IAAI,GAAG,IAAI,SAAS,CAMnB;IAED;;;;OAIG;IACH,IAAI,GAAG,IAAI,SAAS,CAMnB;IAED;;;;OAIG;IACH,IAAI,EAAE,IAAI,QAAQ,CAMjB;IAED;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,aAAa,CAaxB;IAID;;;OAGG;IACH,OAAO,IAAI,IAAI;IAMf;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,MAAM,IAAI,GAAG,CAAC,YAAY,CAAC,CAc9B;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,yBAAyB,CAAC,CAkBlE;CACF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAIpF,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAGlG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9D;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;IAG1C,OAAO,CAAC,IAAI,CAAC,CAAY;IACzB,OAAO,CAAC,IAAI,CAAC,CAAY;IACzB,OAAO,CAAC,GAAG,CAAC,CAAW;IACvB,OAAO,CAAC,KAAK,CAAC,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAiB;IAGnC,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAC,CAA8C;gBAEnD,MAAM,EAAE,mBAAmB;IAUvC;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,qBAAqB,GAAG,aAAa;IAajE;;;;;;;;;OASG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IAI7F;;;;;;;;OAQG;IACH,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAM5G;;;;OAIG;IACH,IAAI,GAAG,IAAI,SAAS,CAMnB;IAED;;;;OAIG;IACH,IAAI,GAAG,IAAI,SAAS,CAMnB;IAED;;;;OAIG;IACH,IAAI,EAAE,IAAI,QAAQ,CAMjB;IAED;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,aAAa,CAaxB;IAID;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,QAAQ,IAAI,cAAc,CAM7B;IAED;;;OAGG;IACH,OAAO,IAAI,IAAI;IAMf;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,MAAM,IAAI,GAAG,CAAC,YAAY,CAAC,CAc9B;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,yBAAyB,CAAC,CAkBlE;CACF"}

package/dist/esm/core/client.js

@@ -43,6 +43,7 @@ export class SynapseClient {
     _das;
     _ws;
     _grpc;
+    _accounts;
     // Kit-native lazy singletons
     _kitRpc;
     _kitSubs;
@@ -167,6 +168,35 @@ export class SynapseClient {
         return this._grpc;
     }
     // ── Lifecycle ─────────────────────────────────────────────────
+    /**
+     * Typed account fetchers with built-in binary decoding.
+     *
+     * Fetches raw accounts via RPC, base64-decodes the data, and applies
+     * zero-dep DataView decoders — returning fully typed objects for
+     * Token, Mint, Stake, Nonce, Lookup Table, and custom accounts.
+     *
+     * Lazy-loaded on first access.
+     *
+     * @since 1.1.0
+     *
+     * @example
+     * ```ts
+     * import { Pubkey } from '@oobe-protocol-labs/synapse-client-sdk';
+     *
+     * const mint = await client.accounts.fetchMint(Pubkey('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'));
+     * console.log(`USDC supply: ${mint?.decoded.supply}, decimals: ${mint?.decoded.decimals}`);
+     *
+     * const token = await client.accounts.fetchTokenAccount(Pubkey('...'));
+     * console.log(`Balance: ${token?.decoded.amount}`);
+     * ```
+     */
+    get accounts() {
+        if (!this._accounts) {
+            const { AccountsClient: Ctor } = require('../accounts/index');
+            this._accounts = new Ctor(this.transport);
+        }
+        return this._accounts;
+    }
     /**
      * Gracefully shut down all active connections (WebSocket, gRPC).
      * @since 1.0.0

package/dist/esm/core/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,aAAa,EAA0C,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAWzC,OAAO,EAAE,eAAe,IAAI,gBAAgB,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAe1G,MAAM,OAAO,aAAa;IACf,SAAS,CAAgB;IACjB,GAAG,CAAsB;IAE1C,kBAAkB;IACV,IAAI,CAAa;IACjB,IAAI,CAAa;IACjB,GAAG,CAAY;IACf,KAAK,CAAiB;IAE9B,6BAA6B;IACrB,OAAO,CAAqB;IAC5B,QAAQ,CAA+C;IAE/D,YAAY,MAA2B;QACrC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC;QAClB,IAAI,CAAC,SAAS,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,MAAM,CAAC,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;IAC1H,CAAC;IAED;;yEAEqE;IAErE;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,YAAY,CAAC,MAA6B;QAC/C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,EAAE;YAC1C,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QACH,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,iEAAiE;IAEjE;;;;;;;;;OASG;IACH,IAAI,CAAc,MAAc,EAAE,SAAoB,EAAE,EAAE,OAAoB,EAAE;QAC9E,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAI,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAc,QAAkD,EAAE,OAAoB,EAAE;QAC3F,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAI,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,iEAAiE;IAEjE;;;;OAIG;IACH,IAAI,GAAG;QACL,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAuC,CAAC;YAC/F,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,IAAI,GAAG;QACL,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,eAAe,CAAmC,CAAC;YACvF,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,IAAI,EAAE;QACJ,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAyC,CAAC;YAClG,IAAI,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACpG,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,IAAI;QACN,IAAI,SAAS,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,0DAA0D;gBAC1D,yDAAyD;gBACzD,oEAAoE,CACrE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAuC,CAAC;YACnG,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,iEAAiE;IAEjE;;;OAGG;IACH,OAAO;QACL,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,gEAAgE;IAEhE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,MAAM;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,EACJ,SAAS,EACT,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,GACnB,GAAG,OAAO,CAAC,aAAa,CAAiC,CAAC;YAC3D,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;gBACvB,GAAG,EAAE,kBAAkB,CAAC,kBAAkB,CAAC;gBAC3C,SAAS,EAAE,yBAAyB,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;aACjE,CAAsB,CAAC;QAC1B,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,gBAAgB;QAClB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,EACJ,qBAAqB,EACrB,+BAA+B,EAC/B,sCAAsC,EACtC,iDAAiD,EACjD,gCAAgC,GACjC,GAAG,OAAO,CAAC,aAAa,CAAiC,CAAC;YAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC7E,IAAI,CAAC,QAAQ,GAAG,qBAAqB,CAAC;gBACpC,GAAG,EAAE,+BAA+B,CAAC,gCAAgC,CAAC;gBACtE,SAAS,EAAE,sCAAsC,CAAC;oBAChD,aAAa,EAAE,iDAAiD,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;iBACjF,CAAC;aACH,CAAgD,CAAC;QACpD,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,36 @@
+/**
+ * Native Solana account data decoders.
+ *
+ * Zero-dependency, DataView-based decoders for the most common Solana
+ * account types. Each decoder is a pure function that takes raw bytes
+ * and returns a fully typed object.
+ *
+ * @module decoders
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import {
+ *   decodeTokenAccount, decodeMint, decodeStakeAccount,
+ *   decodeNonceAccount, decodeLookupTable, decodeMultisig,
+ * } from '@oobe-protocol-labs/synapse-client-sdk/decoders';
+ *
+ * const tokenAcct = decodeTokenAccount(rawBytes);
+ * const mint      = decodeMint(mintBytes);
+ * const stake     = decodeStakeAccount(stakeBytes);
+ * ```
+ */
+export { AccountReader, encodeBase58 } from './layout';
+export { decodeTokenAccount, decodeMint, TOKEN_ACCOUNT_SIZE, MINT_SIZE, TOKEN_PROGRAM_ID, } from './token';
+export type { DecodedTokenAccount, DecodedMint, TokenAccountState, } from './token';
+export { decodeToken2022Account, decodeToken2022Mint, TokenExtensionType, TOKEN_2022_PROGRAM_ID, } from './token-2022';
+export type { DecodedToken2022Account, DecodedToken2022Mint, DecodedExtension, TransferFeeConfig, TransferFeeAmount, MintCloseAuthorityExt, DefaultAccountStateExt, ImmutableOwnerExt, MemoTransferExt, NonTransferableExt, InterestBearingConfigExt, PermanentDelegateExt, MetadataPointerExt, UnknownExtension, } from './token-2022';
+export { decodeStakeAccount, STAKE_PROGRAM_ID, } from './stake';
+export type { DecodedStakeAccount, StakeAccountType, StakeMeta, StakeAuthorized, StakeLockup, StakeDelegation, } from './stake';
+export { decodeNonceAccount, NONCE_ACCOUNT_SIZE, SYSTEM_PROGRAM_ID, } from './nonce';
+export type { DecodedNonceAccount, NonceState, } from './nonce';
+export { decodeLookupTable, LOOKUP_TABLE_PROGRAM_ID, LOOKUP_TABLE_HEADER_SIZE, } from './lookup-table';
+export type { DecodedLookupTable, } from './lookup-table';
+export { decodeMultisig, MAX_MULTISIG_SIGNERS, MULTISIG_SIZE, } from './multisig';
+export type { DecodedMultisig, } from './multisig';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/decoders/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGvD,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,gBAAgB,GACjB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,WAAW,EACX,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,mBAAmB,EACnB,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/esm/decoders/index.js

@@ -0,0 +1,37 @@
+/**
+ * Native Solana account data decoders.
+ *
+ * Zero-dependency, DataView-based decoders for the most common Solana
+ * account types. Each decoder is a pure function that takes raw bytes
+ * and returns a fully typed object.
+ *
+ * @module decoders
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import {
+ *   decodeTokenAccount, decodeMint, decodeStakeAccount,
+ *   decodeNonceAccount, decodeLookupTable, decodeMultisig,
+ * } from '@oobe-protocol-labs/synapse-client-sdk/decoders';
+ *
+ * const tokenAcct = decodeTokenAccount(rawBytes);
+ * const mint      = decodeMint(mintBytes);
+ * const stake     = decodeStakeAccount(stakeBytes);
+ * ```
+ */
+// ── Core reader ────────────────────────────────────────────────
+export { AccountReader, encodeBase58 } from './layout.js';
+// ── SPL Token (v1) ─────────────────────────────────────────────
+export { decodeTokenAccount, decodeMint, TOKEN_ACCOUNT_SIZE, MINT_SIZE, TOKEN_PROGRAM_ID, } from './token.js';
+// ── SPL Token-2022 ─────────────────────────────────────────────
+export { decodeToken2022Account, decodeToken2022Mint, TokenExtensionType, TOKEN_2022_PROGRAM_ID, } from './token-2022.js';
+// ── Stake ──────────────────────────────────────────────────────
+export { decodeStakeAccount, STAKE_PROGRAM_ID, } from './stake.js';
+// ── Nonce ──────────────────────────────────────────────────────
+export { decodeNonceAccount, NONCE_ACCOUNT_SIZE, SYSTEM_PROGRAM_ID, } from './nonce.js';
+// ── Address Lookup Table ───────────────────────────────────────
+export { decodeLookupTable, LOOKUP_TABLE_PROGRAM_ID, LOOKUP_TABLE_HEADER_SIZE, } from './lookup-table.js';
+// ── Multisig ───────────────────────────────────────────────────
+export { decodeMultisig, MAX_MULTISIG_SIGNERS, MULTISIG_SIZE, } from './multisig.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decoders/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,kEAAkE;AAClE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEvD,kEAAkE;AAClE,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAOjB,kEAAkE;AAClE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAkBtB,kEAAkE;AAClE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAUjB,kEAAkE;AAClE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAMjB,kEAAkE;AAClE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAKxB,kEAAkE;AAClE,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,aAAa,GACd,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,105 @@
+/**
+ * AccountReader — zero-dependency DataView-based binary reader for Solana account data.
+ *
+ * Provides typed reading primitives (u8, u16, u32, u64, i64, f64, pubkey, bool)
+ * with automatic offset tracking and little-endian byte order (Solana standard).
+ *
+ * @module decoders/layout
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { AccountReader } from '@oobe-protocol-labs/synapse-client-sdk/decoders';
+ *
+ * const reader = new AccountReader(rawBytes);
+ * const mint   = reader.pubkey();
+ * const owner  = reader.pubkey();
+ * const amount = reader.u64();
+ * ```
+ */
+import { Pubkey } from '../core/types';
+/**
+ * Encode a Uint8Array to a base58 string.
+ *
+ * Used internally for converting 32-byte pubkey buffers to base58.
+ * Self-contained — no external dependencies.
+ *
+ * @param bytes - Raw byte array to encode.
+ * @returns Base58-encoded string.
+ * @since 1.1.0
+ */
+export declare function encodeBase58(bytes: Uint8Array): string;
+/**
+ * Zero-allocation binary reader for Solana account data.
+ *
+ * Reads little-endian integers, pubkeys, booleans, and COption fields
+ * from a Uint8Array with automatic offset tracking. All reads advance
+ * the internal cursor.
+ *
+ * @since 1.1.0
+ */
+export declare class AccountReader {
+    private offset;
+    private readonly view;
+    private readonly bytes;
+    constructor(data: Uint8Array);
+    /** Current read position. @since 1.1.0 */
+    get position(): number;
+    /** Total data length. @since 1.1.0 */
+    get length(): number;
+    /** Remaining bytes after current position. @since 1.1.0 */
+    get remaining(): number;
+    /** Read an unsigned 8-bit integer. @since 1.1.0 */
+    u8(): number;
+    /** Read an unsigned 16-bit integer (little-endian). @since 1.1.0 */
+    u16(): number;
+    /** Read an unsigned 32-bit integer (little-endian). @since 1.1.0 */
+    u32(): number;
+    /** Read an unsigned 64-bit integer (little-endian). @since 1.1.0 */
+    u64(): bigint;
+    /** Read a signed 64-bit integer (little-endian). @since 1.1.0 */
+    i64(): bigint;
+    /** Read a 64-bit float (little-endian). @since 1.1.0 */
+    f64(): number;
+    /** Read a boolean (1 byte, 0 = false, non-zero = true). @since 1.1.0 */
+    bool(): boolean;
+    /**
+     * Read a 32-byte Solana public key and return as branded {@link Pubkey}.
+     * @since 1.1.0
+     */
+    pubkey(): Pubkey;
+    /**
+     * Read a 32-byte hash and return as base58 string.
+     * @since 1.1.0
+     */
+    hash(): string;
+    /**
+     * Read a raw byte slice of the given length.
+     * @since 1.1.0
+     */
+    slice(length: number): Uint8Array;
+    /**
+     * Read a Solana COption — 4-byte discriminator (0 = None, 1 = Some)
+     * followed by the inner value.
+     *
+     * **Important:** The reader function is ALWAYS called to advance the
+     * offset past the fixed-size data region (C ABI: data is always present,
+     * only the tag indicates validity).
+     *
+     * @param reader - Function to read the inner value.
+     * @returns The inner value or `null` if tag is 0 (None).
+     * @since 1.1.0
+     */
+    coption<T>(reader: () => T): T | null;
+    /**
+     * Skip N bytes without reading.
+     * @since 1.1.0
+     */
+    skip(n: number): void;
+    /**
+     * Seek to an absolute offset.
+     * @since 1.1.0
+     */
+    seek(offset: number): void;
+}
+//# sourceMappingURL=layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/decoders/layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAMvC;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CA2BtD;AAID;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAEvB,IAAI,EAAE,UAAU;IAK5B,0CAA0C;IAC1C,IAAI,QAAQ,IAAI,MAAM,CAAwB;IAE9C,sCAAsC;IACtC,IAAI,MAAM,IAAI,MAAM,CAAkC;IAEtD,2DAA2D;IAC3D,IAAI,SAAS,IAAI,MAAM,CAAgD;IAEvE,mDAAmD;IACnD,EAAE,IAAI,MAAM;IAMZ,oEAAoE;IACpE,GAAG,IAAI,MAAM;IAMb,oEAAoE;IACpE,GAAG,IAAI,MAAM;IAMb,oEAAoE;IACpE,GAAG,IAAI,MAAM;IAMb,iEAAiE;IACjE,GAAG,IAAI,MAAM;IAMb,wDAAwD;IACxD,GAAG,IAAI,MAAM;IAMb,wEAAwE;IACxE,IAAI,IAAI,OAAO;IAIf;;;OAGG;IACH,MAAM,IAAI,MAAM;IAMhB;;;OAGG;IACH,IAAI,IAAI,MAAM;IAMd;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IAMjC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI;IAMrC;;;OAGG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAIrB;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAG3B"}

package/dist/esm/decoders/layout.js

@@ -0,0 +1,183 @@
+/**
+ * AccountReader — zero-dependency DataView-based binary reader for Solana account data.
+ *
+ * Provides typed reading primitives (u8, u16, u32, u64, i64, f64, pubkey, bool)
+ * with automatic offset tracking and little-endian byte order (Solana standard).
+ *
+ * @module decoders/layout
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { AccountReader } from '@oobe-protocol-labs/synapse-client-sdk/decoders';
+ *
+ * const reader = new AccountReader(rawBytes);
+ * const mint   = reader.pubkey();
+ * const owner  = reader.pubkey();
+ * const amount = reader.u64();
+ * ```
+ */
+import { Pubkey } from '../core/types.js';
+// ── Minimal base58 encoder (self-contained, no deps) ──────────
+const B58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+/**
+ * Encode a Uint8Array to a base58 string.
+ *
+ * Used internally for converting 32-byte pubkey buffers to base58.
+ * Self-contained — no external dependencies.
+ *
+ * @param bytes - Raw byte array to encode.
+ * @returns Base58-encoded string.
+ * @since 1.1.0
+ */
+export function encodeBase58(bytes) {
+    if (bytes.length === 0)
+        return '';
+    let zeros = 0;
+    while (zeros < bytes.length && bytes[zeros] === 0)
+        zeros++;
+    const size = ((bytes.length - zeros) * 138 / 100 + 1) >>> 0;
+    const b58 = new Uint8Array(size);
+    let length = 0;
+    for (let i = zeros; i < bytes.length; i++) {
+        let carry = bytes[i];
+        let j = 0;
+        for (let k = size - 1; (carry !== 0 || j < length) && k >= 0; k--, j++) {
+            carry += 256 * b58[k];
+            b58[k] = carry % 58;
+            carry = (carry / 58) >>> 0;
+        }
+        length = j;
+    }
+    let idx = size - length;
+    while (idx < size && b58[idx] === 0)
+        idx++;
+    let str = '1'.repeat(zeros);
+    for (; idx < size; idx++)
+        str += B58_ALPHABET[b58[idx]];
+    return str;
+}
+// ── AccountReader ──────────────────────────────────────────────
+/**
+ * Zero-allocation binary reader for Solana account data.
+ *
+ * Reads little-endian integers, pubkeys, booleans, and COption fields
+ * from a Uint8Array with automatic offset tracking. All reads advance
+ * the internal cursor.
+ *
+ * @since 1.1.0
+ */
+export class AccountReader {
+    offset = 0;
+    view;
+    bytes;
+    constructor(data) {
+        this.bytes = data;
+        this.view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    }
+    /** Current read position. @since 1.1.0 */
+    get position() { return this.offset; }
+    /** Total data length. @since 1.1.0 */
+    get length() { return this.bytes.byteLength; }
+    /** Remaining bytes after current position. @since 1.1.0 */
+    get remaining() { return this.bytes.byteLength - this.offset; }
+    /** Read an unsigned 8-bit integer. @since 1.1.0 */
+    u8() {
+        const v = this.view.getUint8(this.offset);
+        this.offset += 1;
+        return v;
+    }
+    /** Read an unsigned 16-bit integer (little-endian). @since 1.1.0 */
+    u16() {
+        const v = this.view.getUint16(this.offset, true);
+        this.offset += 2;
+        return v;
+    }
+    /** Read an unsigned 32-bit integer (little-endian). @since 1.1.0 */
+    u32() {
+        const v = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        return v;
+    }
+    /** Read an unsigned 64-bit integer (little-endian). @since 1.1.0 */
+    u64() {
+        const v = this.view.getBigUint64(this.offset, true);
+        this.offset += 8;
+        return v;
+    }
+    /** Read a signed 64-bit integer (little-endian). @since 1.1.0 */
+    i64() {
+        const v = this.view.getBigInt64(this.offset, true);
+        this.offset += 8;
+        return v;
+    }
+    /** Read a 64-bit float (little-endian). @since 1.1.0 */
+    f64() {
+        const v = this.view.getFloat64(this.offset, true);
+        this.offset += 8;
+        return v;
+    }
+    /** Read a boolean (1 byte, 0 = false, non-zero = true). @since 1.1.0 */
+    bool() {
+        return this.u8() !== 0;
+    }
+    /**
+     * Read a 32-byte Solana public key and return as branded {@link Pubkey}.
+     * @since 1.1.0
+     */
+    pubkey() {
+        const slice = this.bytes.slice(this.offset, this.offset + 32);
+        this.offset += 32;
+        return Pubkey(encodeBase58(slice));
+    }
+    /**
+     * Read a 32-byte hash and return as base58 string.
+     * @since 1.1.0
+     */
+    hash() {
+        const slice = this.bytes.slice(this.offset, this.offset + 32);
+        this.offset += 32;
+        return encodeBase58(slice);
+    }
+    /**
+     * Read a raw byte slice of the given length.
+     * @since 1.1.0
+     */
+    slice(length) {
+        const s = this.bytes.slice(this.offset, this.offset + length);
+        this.offset += length;
+        return s;
+    }
+    /**
+     * Read a Solana COption — 4-byte discriminator (0 = None, 1 = Some)
+     * followed by the inner value.
+     *
+     * **Important:** The reader function is ALWAYS called to advance the
+     * offset past the fixed-size data region (C ABI: data is always present,
+     * only the tag indicates validity).
+     *
+     * @param reader - Function to read the inner value.
+     * @returns The inner value or `null` if tag is 0 (None).
+     * @since 1.1.0
+     */
+    coption(reader) {
+        const tag = this.u32();
+        const value = reader(); // Always read to advance offset past fixed-size data
+        return tag === 0 ? null : value;
+    }
+    /**
+     * Skip N bytes without reading.
+     * @since 1.1.0
+     */
+    skip(n) {
+        this.offset += n;
+    }
+    /**
+     * Seek to an absolute offset.
+     * @since 1.1.0
+     */
+    seek(offset) {
+        this.offset = offset;
+    }
+}
+//# sourceMappingURL=layout.js.map

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

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

package/dist/esm/decoders/lookup-table.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Address Lookup Table decoder.
+ *
+ * Decodes v0 transaction lookup table accounts used for compressing
+ * transaction address lists.
+ *
+ * @module decoders/lookup-table
+ * @since 1.1.0
+ */
+import type { Pubkey } from '../core/types';
+/**
+ * Decoded Address Lookup Table account.
+ *
+ * @example
+ * ```ts
+ * const lut = decodeLookupTable(rawBytes);
+ * console.log(`Addresses: ${lut.addresses.length}, Active: ${!lut.isDeactivated}`);
+ * ```
+ * @since 1.1.0
+ */
+export interface DecodedLookupTable {
+    /** Discriminator (always 1 for lookup tables). */
+    discriminator: number;
+    /** Slot at which deactivation was requested. `MAX_U64` if still active. */
+    deactivationSlot: bigint;
+    /** Last slot during which the table was extended. */
+    lastExtendedSlot: bigint;
+    /** Start index within the last extension batch. */
+    lastExtendedSlotStartIndex: number;
+    /** Authority that can extend/close the table. `null` if frozen. */
+    authority: Pubkey | null;
+    /** List of addresses stored in the table. */
+    addresses: Pubkey[];
+    /** Whether the table has been deactivated. */
+    isDeactivated: boolean;
+}
+/** Address Lookup Table Program ID. @since 1.1.0 */
+export declare const LOOKUP_TABLE_PROGRAM_ID = "AddressLookupTab1e1111111111111111111111111";
+/** Header size of a lookup table account. @since 1.1.0 */
+export declare const LOOKUP_TABLE_HEADER_SIZE = 56;
+/**
+ * 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
+ */
+export declare function decodeLookupTable(data: Uint8Array): DecodedLookupTable;
+//# sourceMappingURL=lookup-table.d.ts.map

package/dist/esm/decoders/lookup-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-table.d.ts","sourceRoot":"","sources":["../../../src/decoders/lookup-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAM5C;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,0BAA0B,EAAE,MAAM,CAAC;IACnC,mEAAmE;IACnE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,8CAA8C;IAC9C,aAAa,EAAE,OAAO,CAAC;CACxB;AAID,oDAAoD;AACpD,eAAO,MAAM,uBAAuB,gDAAgD,CAAC;AAErF,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAO3C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,kBAAkB,CAwCtE"}

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

@@ -0,0 +1,71 @@
+/**
+ * Address Lookup Table decoder.
+ *
+ * Decodes v0 transaction lookup table accounts used for compressing
+ * transaction address lists.
+ *
+ * @module decoders/lookup-table
+ * @since 1.1.0
+ */
+import { Pubkey as mkPubkey } from '../core/types.js';
+import { AccountReader, encodeBase58 } from './layout.js';
+// ── Constants ──────────────────────────────────────────────────
+/** Address Lookup Table Program ID. @since 1.1.0 */
+export const LOOKUP_TABLE_PROGRAM_ID = 'AddressLookupTab1e1111111111111111111111111';
+/** Header size of a lookup table account. @since 1.1.0 */
+export const 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
+ */
+export function decodeLookupTable(data) {
+    if (data.length < LOOKUP_TABLE_HEADER_SIZE) {
+        throw new Error(`Lookup table data too short: expected >= ${LOOKUP_TABLE_HEADER_SIZE} bytes, got ${data.length}`);
+    }
+    const r = new 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(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(mkPubkey(encodeBase58(addrBytes)));
+    }
+    return {
+        discriminator,
+        deactivationSlot,
+        lastExtendedSlot,
+        lastExtendedSlotStartIndex,
+        authority,
+        addresses,
+        isDeactivated,
+    };
+}
+//# sourceMappingURL=lookup-table.js.map

package/dist/esm/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;AAGH,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AA+BvD,kEAAkE;AAElE,oDAAoD;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,6CAA6C,CAAC;AAErF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAE3C,mEAAmE;AACnE,MAAM,OAAO,GAAG,mBAAmB,CAAC;AAEpC,kEAAkE;AAElE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAChD,IAAI,IAAI,CAAC,MAAM,GAAG,wBAAwB,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,4CAA4C,wBAAwB,eAAe,IAAI,CAAC,MAAM,EAAE,CACjG,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,aAAa,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,wBAAwB,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,QAAQ,CAAC,YAAY,CAAC,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"}