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

package/dist/cjs/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/cjs/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/cjs/core/client.js

@@ -46,6 +46,7 @@ class SynapseClient {
     _das;
     _ws;
     _grpc;
+    _accounts;
     // Kit-native lazy singletons
     _kitRpc;
     _kitSubs;
@@ -170,6 +171,35 @@ 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/cjs/core/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;AAEH,2CAAoF;AACpF,sCAAyC;AAYzC,8CAA0G;AAe1G,MAAa,aAAa;IACf,SAAS,CAAgB;IACjB,GAAG,CAAsB;IAE1C,kBAAkB;IACV,IAAI,CAAa;IACjB,IAAI,CAAa;IACjB,GAAG,CAAY;IACf,KAAK,CAAiB;IACtB,SAAS,CAAkB;IAEnC,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,yBAAa,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,MAAM,CAAC,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAA,eAAS,GAAE,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,IAAA,yBAAgB,EAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,IAAA,wBAAe,EAAC,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,IAAA,eAAS,GAAE,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;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,QAAQ;QACV,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAuC,CAAC;YACpG,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;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;AA5QD,sCA4QC"}

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

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * 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);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MULTISIG_SIZE = exports.MAX_MULTISIG_SIGNERS = exports.decodeMultisig = exports.LOOKUP_TABLE_HEADER_SIZE = exports.LOOKUP_TABLE_PROGRAM_ID = exports.decodeLookupTable = exports.SYSTEM_PROGRAM_ID = exports.NONCE_ACCOUNT_SIZE = exports.decodeNonceAccount = exports.STAKE_PROGRAM_ID = exports.decodeStakeAccount = exports.TOKEN_2022_PROGRAM_ID = exports.TokenExtensionType = exports.decodeToken2022Mint = exports.decodeToken2022Account = exports.TOKEN_PROGRAM_ID = exports.MINT_SIZE = exports.TOKEN_ACCOUNT_SIZE = exports.decodeMint = exports.decodeTokenAccount = exports.encodeBase58 = exports.AccountReader = void 0;
+// ── Core reader ────────────────────────────────────────────────
+var layout_1 = require("./layout");
+Object.defineProperty(exports, "AccountReader", { enumerable: true, get: function () { return layout_1.AccountReader; } });
+Object.defineProperty(exports, "encodeBase58", { enumerable: true, get: function () { return layout_1.encodeBase58; } });
+// ── SPL Token (v1) ─────────────────────────────────────────────
+var token_1 = require("./token");
+Object.defineProperty(exports, "decodeTokenAccount", { enumerable: true, get: function () { return token_1.decodeTokenAccount; } });
+Object.defineProperty(exports, "decodeMint", { enumerable: true, get: function () { return token_1.decodeMint; } });
+Object.defineProperty(exports, "TOKEN_ACCOUNT_SIZE", { enumerable: true, get: function () { return token_1.TOKEN_ACCOUNT_SIZE; } });
+Object.defineProperty(exports, "MINT_SIZE", { enumerable: true, get: function () { return token_1.MINT_SIZE; } });
+Object.defineProperty(exports, "TOKEN_PROGRAM_ID", { enumerable: true, get: function () { return token_1.TOKEN_PROGRAM_ID; } });
+// ── SPL Token-2022 ─────────────────────────────────────────────
+var token_2022_1 = require("./token-2022");
+Object.defineProperty(exports, "decodeToken2022Account", { enumerable: true, get: function () { return token_2022_1.decodeToken2022Account; } });
+Object.defineProperty(exports, "decodeToken2022Mint", { enumerable: true, get: function () { return token_2022_1.decodeToken2022Mint; } });
+Object.defineProperty(exports, "TokenExtensionType", { enumerable: true, get: function () { return token_2022_1.TokenExtensionType; } });
+Object.defineProperty(exports, "TOKEN_2022_PROGRAM_ID", { enumerable: true, get: function () { return token_2022_1.TOKEN_2022_PROGRAM_ID; } });
+// ── Stake ──────────────────────────────────────────────────────
+var stake_1 = require("./stake");
+Object.defineProperty(exports, "decodeStakeAccount", { enumerable: true, get: function () { return stake_1.decodeStakeAccount; } });
+Object.defineProperty(exports, "STAKE_PROGRAM_ID", { enumerable: true, get: function () { return stake_1.STAKE_PROGRAM_ID; } });
+// ── Nonce ──────────────────────────────────────────────────────
+var nonce_1 = require("./nonce");
+Object.defineProperty(exports, "decodeNonceAccount", { enumerable: true, get: function () { return nonce_1.decodeNonceAccount; } });
+Object.defineProperty(exports, "NONCE_ACCOUNT_SIZE", { enumerable: true, get: function () { return nonce_1.NONCE_ACCOUNT_SIZE; } });
+Object.defineProperty(exports, "SYSTEM_PROGRAM_ID", { enumerable: true, get: function () { return nonce_1.SYSTEM_PROGRAM_ID; } });
+// ── Address Lookup Table ───────────────────────────────────────
+var lookup_table_1 = require("./lookup-table");
+Object.defineProperty(exports, "decodeLookupTable", { enumerable: true, get: function () { return lookup_table_1.decodeLookupTable; } });
+Object.defineProperty(exports, "LOOKUP_TABLE_PROGRAM_ID", { enumerable: true, get: function () { return lookup_table_1.LOOKUP_TABLE_PROGRAM_ID; } });
+Object.defineProperty(exports, "LOOKUP_TABLE_HEADER_SIZE", { enumerable: true, get: function () { return lookup_table_1.LOOKUP_TABLE_HEADER_SIZE; } });
+// ── Multisig ───────────────────────────────────────────────────
+var multisig_1 = require("./multisig");
+Object.defineProperty(exports, "decodeMultisig", { enumerable: true, get: function () { return multisig_1.decodeMultisig; } });
+Object.defineProperty(exports, "MAX_MULTISIG_SIGNERS", { enumerable: true, get: function () { return multisig_1.MAX_MULTISIG_SIGNERS; } });
+Object.defineProperty(exports, "MULTISIG_SIZE", { enumerable: true, get: function () { return multisig_1.MULTISIG_SIZE; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/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,mCAAuD;AAA9C,uGAAA,aAAa,OAAA;AAAE,sGAAA,YAAY,OAAA;AAEpC,kEAAkE;AAClE,iCAMiB;AALf,2GAAA,kBAAkB,OAAA;AAClB,mGAAA,UAAU,OAAA;AACV,2GAAA,kBAAkB,OAAA;AAClB,kGAAA,SAAS,OAAA;AACT,yGAAA,gBAAgB,OAAA;AAQlB,kEAAkE;AAClE,2CAKsB;AAJpB,oHAAA,sBAAsB,OAAA;AACtB,iHAAA,mBAAmB,OAAA;AACnB,gHAAA,kBAAkB,OAAA;AAClB,mHAAA,qBAAqB,OAAA;AAmBvB,kEAAkE;AAClE,iCAGiB;AAFf,2GAAA,kBAAkB,OAAA;AAClB,yGAAA,gBAAgB,OAAA;AAWlB,kEAAkE;AAClE,iCAIiB;AAHf,2GAAA,kBAAkB,OAAA;AAClB,2GAAA,kBAAkB,OAAA;AAClB,0GAAA,iBAAiB,OAAA;AAOnB,kEAAkE;AAClE,+CAIwB;AAHtB,iHAAA,iBAAiB,OAAA;AACjB,uHAAA,uBAAuB,OAAA;AACvB,wHAAA,wBAAwB,OAAA;AAM1B,kEAAkE;AAClE,uCAIoB;AAHlB,0GAAA,cAAc,OAAA;AACd,gHAAA,oBAAoB,OAAA;AACpB,yGAAA,aAAa,OAAA"}

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

@@ -0,0 +1,188 @@
+"use strict";
+/**
+ * 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();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountReader = void 0;
+exports.encodeBase58 = encodeBase58;
+const types_1 = require("../core/types");
+// ── 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
+ */
+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
+ */
+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 (0, types_1.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;
+    }
+}
+exports.AccountReader = AccountReader;
+//# sourceMappingURL=layout.js.map

package/dist/cjs/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/cjs/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/cjs/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"}