@picon-finance/dlmm-sdk 1.2.0 → 1.3.0

package/dist/entities/position_pool.js

@@ -0,0 +1,30 @@
+import { getAddressDecoder, parseBase64RpcAccount, } from "@solana/kit";
+import { fetchInChunks } from "../utils/chunk";
+import { MAX_ACCOUNTS_PER_RPC_BATCH } from "../utils/constants";
+export async function fetchAllMaybePositionPoolsChunked(rpc, addresses, config) {
+    return await fetchInChunks(addresses, MAX_ACCOUNTS_PER_RPC_BATCH, chunkAddresses => fetchAllMaybePositionPools(rpc, chunkAddresses, config));
+}
+const POSITION_POOL_SLICE = Object.freeze({ offset: 8, length: 32 });
+async function fetchAllMaybePositionPools(rpc, addresses, config) {
+    const { abortSignal, ...rpcConfig } = config ?? {};
+    const { value: accounts } = await rpc.getMultipleAccounts(addresses, {
+        ...rpcConfig,
+        dataSlice: POSITION_POOL_SLICE,
+        encoding: "base64",
+    }).send({ abortSignal });
+    return decodeAllMaybePositionPools(addresses, accounts);
+}
+const addressDecoder = getAddressDecoder();
+function decodeMaybePositionPool(address, account) {
+    if (!account) {
+        return;
+    }
+    const pool = addressDecoder.decode(parseBase64RpcAccount(address, account).data);
+    return { address, pool };
+}
+function decodeAllMaybePositionPools(addresses, accounts) {
+    return accounts.map((account, i) => {
+        const address = addresses[i];
+        return decodeMaybePositionPool(address, account);
+    });
+}

package/dist/entities/types.d.ts

@@ -0,0 +1,5 @@
+import { type Address } from "@solana/kit";
+export type ProgramConfig = {
+    programAddress: Address;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/entities/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/entities/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG;IAAE,cAAc,EAAE,OAAO,CAAA;CAAE,CAAC"}

package/dist/events.d.ts

@@ -1,4 +1,4 @@
-import { type Address } from "@solana/kit";
+import { type Address, type Commitment, type createSolanaRpcSubscriptions } from "@solana/kit";
 export type CreatePoolEvent = {
     pool: Address;
     binStep: number;
@@ -90,4 +90,12 @@ export type DlmmEvent = {
 };
 export declare function decodeEventFromLogLine(logLine: string): DlmmEvent | undefined;
 export declare function decodeEventsFromLogs(logs: readonly string[], programAddress?: Address): DlmmEvent[];
+type RpcSubscriptions = ReturnType<typeof createSolanaRpcSubscriptions>;
+export declare function onEvent(rpcSubscriptions: RpcSubscriptions, handler: (event: DlmmEvent) => void, { address, programAddress, commitment, onError, }?: {
+    address?: Address;
+    programAddress?: Address;
+    commitment?: Commitment;
+    onError?: (error: unknown) => void;
+}): Promise<() => void>;
+export {};
 //# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -164,3 +164,51 @@ export function decodeEventsFromLogs(logs, programAddress = PICON_DLMM_PROGRAM_A
     }
     return events;
 }
+// `address` defaults to `programAddress` (every pool the program touches); pass a pool
+// address to scope it. `programAddress` also scopes CPI-log filtering (see decodeEventsFromLogs
+// above), so it should match whatever cluster's program this subscription is watching —
+// defaults to mainnet. Resolves once the subscription is active, with an unsubscribe function.
+// Errors — from the stream itself (e.g. a dropped websocket) or thrown by `handler` — are
+// reported to `onError` instead of rejecting an unheld promise; a `handler` throw only drops
+// that one event, the subscription keeps running.
+export async function onEvent(rpcSubscriptions, handler, { address, programAddress = PICON_DLMM_PROGRAM_ADDRESS, commitment, onError, } = {}) {
+    const abortController = new AbortController();
+    const eventStream = await subscribeToEvents(rpcSubscriptions, {
+        address: address ?? programAddress,
+        programAddress,
+        commitment,
+        abortSignal: abortController.signal,
+    });
+    (async () => {
+        try {
+            for await (const event of eventStream) {
+                try {
+                    handler(event);
+                }
+                catch (error) {
+                    onError?.(error);
+                }
+            }
+        }
+        catch (error) {
+            if (!abortController.signal.aborted) {
+                onError?.(error);
+            }
+        }
+    })();
+    return () => abortController.abort();
+}
+// Resolves once the subscription is active, so callers know they won't miss anything.
+async function subscribeToEvents(rpcSubscriptions, { address, programAddress, commitment = "confirmed", abortSignal, }) {
+    const notifications = await rpcSubscriptions
+        .logsNotifications({ mentions: [address] }, { commitment })
+        .subscribe({ abortSignal });
+    return (async function* () {
+        for await (const notification of notifications) {
+            if (notification.value.err != null) {
+                continue;
+            }
+            yield* decodeEventsFromLogs(notification.value.logs, programAddress);
+        }
+    })();
+}

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 export * as generated from "./generated";
 export { DistributionMode } from "./generated/types/distributionMode";
 export * as events from "./events";
+export * from "./entities";
 export * from "./utils/constants";
 export { NATIVE_MINT_ADDRESS } from "./utils/ata";
-export * from "./actions";
+export type { QuoteInput, QuoteOutput, PoolState, TransferFee } from "./quote";
 export * from "./program_addresses";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC/E,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,7 +1,7 @@
 export * as generated from "./generated";
 export { DistributionMode } from "./generated/types/distributionMode";
 export * as events from "./events";
+export * from "./entities";
 export * from "./utils/constants";
 export { NATIVE_MINT_ADDRESS } from "./utils/ata";
-export * from "./actions";
 export * from "./program_addresses";

package/dist/program_addresses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program_addresses.d.ts","sourceRoot":"","sources":["../src/program_addresses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,EAAE,0BAA0B,IAAI,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAIpF,eAAO,MAAM,sBAAsB,EAAoD,OAAO,CAAC"}
+{"version":3,"file":"program_addresses.d.ts","sourceRoot":"","sources":["../src/program_addresses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,0BAA0B,IAAI,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACpF,eAAO,MAAM,sBAAsB,EAAoD,OAAO,CAAC"}

package/dist/program_addresses.js

@@ -1,7 +1,2 @@
-// SDK codegen always targets the mainnet IDL (see package.json's `copy-idl`), so this is the
-// same value as `generated.PICON_DLMM_PROGRAM_ADDRESS` — exported under a clearer name here
-// since it's meant to be read standalone, not discovered via the generated namespace.
 export { PICON_DLMM_PROGRAM_ADDRESS as MAINNET_PROGRAM_ADDRESS } from "./generated";
-// Not baked into codegen (the IDL's structure is identical across clusters — only the address
-// differs) — pass this as the `programAddress` argument on any SDK action to target devnet.
 export const DEVNET_PROGRAM_ADDRESS = "tDLMMKoxBt7UkZapYHsEgLGydmFvSQXh5mGzrRovoeM";

package/dist/utils/assert.d.ts

@@ -0,0 +1,9 @@
+import type { Address } from "@solana/kit";
+import type { BinIdRange } from "./bin_location";
+export declare function assertRangeWithinRange(inner: BinIdRange, outer: BinIdRange): void;
+export declare function assertPositionBelongsToPool(position: {
+    pool: Address;
+}, pool: {
+    address: Address;
+}): void;
+//# sourceMappingURL=assert.d.ts.map

package/dist/utils/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,UAAU,GAChB,IAAI,CAMN;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,EAC3B,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GACzB,IAAI,CAMN"}

package/dist/utils/assert.js

@@ -0,0 +1,10 @@
+export function assertRangeWithinRange(inner, outer) {
+    if (inner.lowerBinId < outer.lowerBinId || inner.upperBinId > outer.upperBinId) {
+        throw new RangeError(`Range (${inner.lowerBinId} to ${inner.upperBinId}) must be inside range (${outer.lowerBinId} to ${outer.upperBinId})`);
+    }
+}
+export function assertPositionBelongsToPool(position, pool) {
+    if (position.pool !== pool.address) {
+        throw new Error(`Position's pool (${position.pool}) does not match expected pool (${pool.address})`);
+    }
+}

package/dist/utils/bin_location.d.ts

@@ -1,3 +1,7 @@
+export type BinIdRange = {
+    lowerBinId: number;
+    upperBinId: number;
+};
 export declare function getBinArrayIndex(binId: number): number;
 export declare function getBinIndex(binId: number): number;
 export declare function getBinId(binArrayIndex: number, binIndex: number): number;

package/dist/utils/bin_location.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bin_location.d.ts","sourceRoot":"","sources":["../../src/utils/bin_location.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,wBAAwB,CACtC,kBAAkB,EAAE,MAAM,EAC1B,kBAAkB,EAAE,MAAM,GACzB,MAAM,EAAE,CAKV;AAMD,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB;IAAE,kBAAkB,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,CAM7D;AAKD,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,MAAM,GACnB,MAAM,EAAE,CAMV;AAOD,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,MAAM,EAAE,CAeV"}
+{"version":3,"file":"bin_location.d.ts","sourceRoot":"","sources":["../../src/utils/bin_location.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,wBAAwB,CACtC,kBAAkB,EAAE,MAAM,EAC1B,kBAAkB,EAAE,MAAM,GACzB,MAAM,EAAE,CAKV;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB;IAAE,kBAAkB,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,CAM7D;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,MAAM,GACnB,MAAM,EAAE,CAMV;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,MAAM,EAAE,CAeV"}

package/dist/utils/bin_location.js

@@ -11,10 +11,6 @@ export function getBinId(binArrayIndex, binIndex) {
 export function getBinArrayIndexSequence(lowerBinArrayIndex, upperBinArrayIndex) {
     return Array.from({ length: upperBinArrayIndex - lowerBinArrayIndex + 1 }, (_, i) => lowerBinArrayIndex + i);
 }
-// A position spans at most MAX_BIN_ARRAYS_PER_POSITION (2) bin arrays — the lower and
-// (only if distinct) upper one covering its range. Shared by every position-scoped
-// instruction that needs to enumerate exactly those arrays (open_position's bin-array
-// bootstrap, withdraw/claim_fee's account derivation).
 export function getPositionBinArrayIndices(lowerBinId, upperBinId) {
     const lowerBinArrayIndex = getBinArrayIndex(lowerBinId);
     const upperBinArrayIndex = getBinArrayIndex(upperBinId);
@@ -22,9 +18,6 @@ export function getPositionBinArrayIndices(lowerBinId, upperBinId) {
         ? { lowerBinArrayIndex }
         : { lowerBinArrayIndex, upperBinArrayIndex };
 }
-// One bin array of margin is kept on the opposite side of travel: if the live active bin
-// drifts one array against the expected direction between quote time and execution (e.g. a
-// competing swap lands first), it's still covered by this range instead of reverting.
 export function generateBinArrayIndicesForSwap(activeBinId, xToY, maxBinArrays) {
     const activeBinArrayIndex = getBinArrayIndex(activeBinId);
     const [lowerBinArrayIndex, upperBinArrayIndex] = xToY
@@ -32,11 +25,6 @@ export function generateBinArrayIndicesForSwap(activeBinId, xToY, maxBinArrays)
         : [activeBinArrayIndex - 1, activeBinArrayIndex + (maxBinArrays - 2)];
     return getBinArrayIndexSequence(lowerBinArrayIndex, upperBinArrayIndex);
 }
-// Spans from the live `activeBinId` to the caller's exact `desiredBinId` target, plus one
-// bin array of margin beyond the active end (the side subject to drift — `desiredBinId` is
-// a fixed target, but the live active bin could move further away from it before this tx
-// lands). Capped at `maxBinArrays`, trimming from the `desiredBinId` end so the active+margin
-// anchor stays intact — a sync toward a distant target simply converges partially in that case.
 export function generateBinArrayIndicesForSync(activeBinId, desiredBinId, maxBinArrays) {
     const activeBinArrayIndex = getBinArrayIndex(activeBinId);
     const desiredBinArrayIndex = getBinArrayIndex(desiredBinId);

package/dist/utils/chunk.d.ts

@@ -1,2 +1,3 @@
 export declare function chunk<T>(items: T[], size: number): T[][];
+export declare function fetchInChunks<T, R>(items: T[], size: number, fetcher: (chunkItems: T[]) => Promise<R[]>): Promise<R[]>;
 //# sourceMappingURL=chunk.d.ts.map

package/dist/utils/chunk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../../src/utils/chunk.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAMxD"}
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../../src/utils/chunk.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAMxD;AAED,wBAAsB,aAAa,CAAC,CAAC,EAAE,CAAC,EACtC,KAAK,EAAE,CAAC,EAAE,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CAGd"}

package/dist/utils/chunk.js

@@ -5,3 +5,7 @@ export function chunk(items, size) {
     }
     return chunks;
 }
+export async function fetchInChunks(items, size, fetcher) {
+    const chunks = await Promise.all(chunk(items, size).map(fetcher));
+    return chunks.flat();
+}

package/dist/utils/type_guards.d.ts

@@ -1,2 +1,4 @@
+import { type Account } from "@solana/kit";
 export declare function isUndefined<T>(value: T | undefined): value is undefined;
+export declare function isAccount<TData extends object>(value: any): value is Account<TData>;
 //# sourceMappingURL=type_guards.d.ts.map

package/dist/utils/type_guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type_guards.d.ts","sourceRoot":"","sources":["../../src/utils/type_guards.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,KAAK,IAAI,SAAS,CAEvE"}
+{"version":3,"file":"type_guards.d.ts","sourceRoot":"","sources":["../../src/utils/type_guards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,KAAK,IAAI,SAAS,CAEvE;AAED,wBAAgB,SAAS,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAQnF"}

package/dist/utils/type_guards.js

@@ -1,3 +1,10 @@
 export function isUndefined(value) {
     return value === undefined;
 }
+export function isAccount(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "address" in value &&
+        "data" in value &&
+        "executable" in value);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picon-finance/dlmm-sdk",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Typescript SDK for interacting with the Picon DLMM protocol",
   "author": "Picon Finance",
   "license": "MIT",
@@ -41,7 +41,6 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@solana-program/compute-budget": "^0.17.0",
     "@solana-program/system": "^0.13.0",
     "@solana-program/token": "^0.15.0",
     "@solana-program/token-2022": "^0.13.0",

package/src/entities/admin_config.ts

@@ -0,0 +1,122 @@
+import {
+  createSolanaRpc,
+  getAddressEncoder,
+  getProgramDerivedAddress,
+  type Address,
+  type Account,
+  type Instruction,
+  type TransactionSigner,
+  type FetchAccountConfig,
+} from "@solana/kit";
+import { SYSTEM_PROGRAM_ADDRESS } from "@solana-program/system";
+
+import { generated } from "..";
+import { findAdminConfigPda, type AdminConfig } from "../generated";
+import { type ProgramConfig } from "./types";
+
+const LOADER_V3_PROGRAM_ADDRESS = "BPFLoaderUpgradeab1e11111111111111111111111" as Address;
+
+async function findProgramDataAddress(programAddress: Address): Promise<Address> {
+  const [programData] = await getProgramDerivedAddress({
+    programAddress: LOADER_V3_PROGRAM_ADDRESS,
+    seeds: [getAddressEncoder().encode(programAddress)],
+  });
+  return programData;
+}
+
+export async function resolveAdminConfigAddress(programAddress: Address): Promise<Address> {
+  const [adminConfig] = await findAdminConfigPda({ programAddress });
+  return adminConfig;
+}
+
+export async function createAdminConfig(
+  {
+    deployer,
+    authority,
+    metadataUpdateAuthority,
+  }: {
+    deployer: TransactionSigner,
+    authority: Address,
+    metadataUpdateAuthority?: Address,
+  },
+  config: ProgramConfig,
+): Promise<Instruction> {
+  const [adminConfig, programData] = await Promise.all([
+    resolveAdminConfigAddress(config.programAddress),
+    findProgramDataAddress(config.programAddress),
+  ]);
+  return await generated.getCreateAdminConfigInstructionAsync({
+    deployer,
+    authority,
+    metadataUpdateAuthority: metadataUpdateAuthority ?? null,
+    adminConfig,
+    program: config.programAddress,
+    programData,
+  }, config);
+}
+
+export async function transferAdminAuthority(
+  {
+    authority,
+    newAuthority,
+  }: {
+    authority: TransactionSigner,
+    newAuthority: Address,
+  },
+  config: ProgramConfig,
+): Promise<Instruction> {
+  const adminConfig = await resolveAdminConfigAddress(config.programAddress);
+  return await generated.getTransferAdminAuthorityInstructionAsync(
+    { authority, newAuthority, adminConfig },
+    config,
+  );
+}
+
+export async function acceptAdminAuthority(
+  { pendingAuthority }: { pendingAuthority: TransactionSigner },
+  config: ProgramConfig,
+): Promise<Instruction> {
+  const adminConfig = await resolveAdminConfigAddress(config.programAddress);
+  return await generated.getAcceptAdminAuthorityInstructionAsync(
+    { pendingAuthority, adminConfig },
+    config,
+  );
+}
+
+export async function setMetadataUpdateAuthority(
+  {
+    authority,
+    metadataUpdateAuthority,
+  }: {
+    authority: TransactionSigner,
+    metadataUpdateAuthority: Address,
+  },
+  config: ProgramConfig,
+): Promise<Instruction> {
+  const adminConfig = await resolveAdminConfigAddress(config.programAddress);
+  return await generated.getSetMetadataUpdateAuthorityInstructionAsync(
+    { authority, metadataUpdateAuthority, adminConfig },
+    config,
+  );
+}
+
+export async function getAdminConfig(
+  rpc: ReturnType<typeof createSolanaRpc>,
+  config: ProgramConfig & FetchAccountConfig,
+): Promise<Account<generated.AdminConfig>> {
+  const adminConfig = await resolveAdminConfigAddress(config.programAddress);
+  return await generated.fetchAdminConfig(rpc, adminConfig, config);
+}
+
+function isActive(adminConfig: AdminConfig): boolean {
+  return adminConfig.authority !== SYSTEM_PROGRAM_ADDRESS;
+}
+
+export async function isAdminConfigActive(
+  rpc: ReturnType<typeof createSolanaRpc>,
+  config: ProgramConfig & FetchAccountConfig,
+): Promise<boolean> {
+  const adminConfig = await resolveAdminConfigAddress(config.programAddress);
+  const maybeAdminConfig = await generated.fetchMaybeAdminConfig(rpc, adminConfig, config);
+  return maybeAdminConfig.exists && isActive(maybeAdminConfig.data);
+}

package/src/entities/bin_array.ts

@@ -0,0 +1,156 @@
+import {
+  decodeAccount,
+  createSolanaRpc,
+  assertAccountsExist,
+  type Address,
+  type Account,
+  type Instruction,
+  type TransactionSigner,
+  type FetchAccountConfig,
+  type FetchAccountsConfig,
+  type MaybeEncodedAccount,
+} from "@solana/kit";
+
+import { generated } from "..";
+import { isAccount } from "../utils/type_guards";
+import { fetchInChunks } from "../utils/chunk";
+import { MAX_ACCOUNTS_PER_RPC_BATCH } from "../utils/constants";
+import { resolveAdminConfigAddress } from "./admin_config";
+import { type ProgramConfig } from "./types";
+
+export class BinArray {
+  #rpc: ReturnType<typeof createSolanaRpc>;
+  #account: Account<generated.BinArray>;
+  #programAddress: Address;
+
+  private constructor(
+    rpc: ReturnType<typeof createSolanaRpc>,
+    account: Account<generated.BinArray>,
+    programAddress: Address,
+  ) {
+    this.#rpc = rpc;
+    this.#account = account;
+    this.#programAddress = programAddress;
+  }
+
+  public get address() { return this.#account.address; }
+  public get data() { return this.#account.data; }
+
+  public async refresh(data: Account<generated.BinArray>): Promise<void>;
+  public async refresh(config?: FetchAccountConfig): Promise<void>;
+  public async refresh(arg?: Account<generated.BinArray> | FetchAccountConfig) {
+    if (!isAccount<generated.BinArray>(arg)) {
+      arg = await generated.fetchBinArray(this.#rpc, this.address, arg);
+    }
+    this.#account = arg;
+  }
+
+  public static async loadAll(
+    rpc: ReturnType<typeof createSolanaRpc>,
+    pool: Address,
+    indices: number[],
+    programAddress: Address,
+    config?: FetchAccountsConfig,
+  ): Promise<BinArray[]> {
+    const addresses = await findAllBinArrayAddresses(
+      { indices, pool },
+      { programAddress },
+    );
+    const accounts = await fetchAllBinArraysChunked(rpc, addresses, config);
+    return accounts.map(account => new BinArray(rpc, account, programAddress));
+  }
+
+  public async delete(authority: TransactionSigner): Promise<Instruction> {
+    const adminConfig = await resolveAdminConfigAddress(this.#programAddress);
+    return await generated.getDeleteBinArrayInstructionAsync({
+      authority,
+      pool: this.data.pool,
+      index: this.data.index,
+      receiver: this.data.payer,
+      binArray: this.address,
+      adminConfig,
+    }, { programAddress: this.#programAddress });
+  }
+}
+
+export async function createBinArray(
+  {
+    payer,
+    pool,
+    index,
+    idempotent = true,
+  }: {
+    payer: TransactionSigner,
+    pool: Address,
+    index: number,
+    idempotent?: boolean,
+  },
+  config: ProgramConfig,
+): Promise<Instruction> {
+  const binArray = await findBinArrayAddress(
+    { pool, index },
+    config,
+  );
+  return await generated.getCreateBinArrayInstructionAsync(
+    { payer, pool, index, idempotent, binArray },
+    config,
+  );
+}
+
+export async function createAllBinArrays(
+  {
+    payer,
+    pool,
+    indices,
+    idempotent = true,
+  }: {
+    payer: TransactionSigner,
+    pool: Address,
+    indices: number[],
+    idempotent?: boolean,
+  },
+  config: ProgramConfig,
+): Promise<Instruction[]> {
+  return await Promise.all(
+    indices.map(index =>
+      createBinArray({ payer, pool, index, idempotent }, config)),
+  );
+}
+
+export async function findBinArrayAddress(
+  seeds: { pool: Address, index: number },
+  config: ProgramConfig,
+): Promise<Address> {
+  const [address] = await generated.findBinArrayPda(seeds, config);
+  return address;
+}
+
+export async function findAllBinArrayAddresses(
+  { pool, indices }: { pool: Address, indices: number[] },
+  config: ProgramConfig,
+): Promise<Address[]> {
+  return await Promise.all(
+    indices.map(index => findBinArrayAddress({ index, pool }, config)),
+  );
+}
+
+export async function fetchAllBinArraysChunked(
+  rpc: ReturnType<typeof createSolanaRpc>,
+  addresses: Address[],
+  config?: FetchAccountsConfig,
+) {
+  return await fetchInChunks(
+    addresses,
+    MAX_ACCOUNTS_PER_RPC_BATCH,
+    chunkAddresses => generated.fetchAllBinArray(rpc, chunkAddresses, config),
+  );
+}
+
+const binArrayDecoder = generated.getBinArrayDecoder();
+
+export function decodeAllBinArrays(
+  maybeAccounts: MaybeEncodedAccount<string>[],
+): Account<generated.BinArray>[] {
+  assertAccountsExist(maybeAccounts);
+  return maybeAccounts.map(a => decodeAccount(a, binArrayDecoder));
+}