@usearete/sdk 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -751,10 +751,26 @@ interface StackEndpoints {
 type ReadTransportMethod = 'GET' | 'POST';
 interface ProgramAccountReadDefinition<T> {
     readonly account: string;
-    readonly path: string;
     readonly schema?: Schema<T>;
     readonly _result?: T;
 }
+type ProgramAccountBatchItem<T> = {
+    readonly address: string;
+    readonly status: 'ok';
+    readonly value: T;
+} | {
+    readonly address: string;
+    readonly status: 'missing';
+} | {
+    readonly address: string;
+    readonly status: 'error';
+    readonly error: {
+        readonly code: string;
+    };
+};
+interface ProgramAccountBatchResult<T> {
+    readonly items: readonly ProgramAccountBatchItem<T>[];
+}
 interface ProgramQueryDefinition<TParams = unknown, TResult = unknown> {
     readonly name: string;
     readonly path: string;
@@ -774,8 +790,11 @@ interface StackQueryDefinition<TParams = unknown, TResult = unknown> {
 interface ProgramSdkDefinition {
     readonly name: string;
     readonly programId?: string;
-    /** Stable fingerprint of the generated program behavior used for client caching. */
-    readonly definitionHash?: string;
+    /** Typed identity of the generated program behavior and compiler provenance. */
+    readonly sdkDefinitionHash?: string;
+    readonly programSpecHash?: string;
+    readonly idlContentHash?: string;
+    readonly normalizedIdlHash?: string;
     readonly schemas?: Record<string, Schema<unknown>>;
     readonly pdas?: Record<string, unknown>;
     readonly accounts?: Record<string, ProgramAccountReadDefinition<unknown>>;
@@ -786,14 +805,88 @@ interface ProgramSdkDefinition {
     readonly defaults?: unknown;
     readonly math?: unknown;
 }
-interface StackDefinition {
+interface ProgramReleaseReference {
+    readonly programReleaseHash: string;
+    readonly programSpecHash: string;
+}
+/** Public, non-secret metadata describing how an HTTP bearer token is acquired. */
+interface HttpAuthMetadata {
+    readonly required?: boolean;
+    readonly mode?: string;
+    readonly sessionEndpoint: string;
+    readonly jwksUrl?: string;
+    readonly tokenTransport?: string;
+    readonly audience?: string;
+    readonly targetKind: 'program-read-binding';
+    readonly targetId: string;
+    readonly scopes?: readonly string[];
+    readonly acceptedKeyClasses?: readonly string[];
+}
+interface ProgramReadBinding {
+    readonly endpoint: string;
+    readonly programReadBindingId: string;
+    readonly auth: HttpAuthMetadata;
+}
+type SolanaGatewayAuthScope = 'read' | 'transaction:inspect' | 'transaction:send';
+/** Complete public auth metadata emitted for a hosted Solana gateway binding. */
+interface SolanaGatewayAuthMetadata {
+    readonly required: boolean;
+    readonly mode: string;
+    readonly sessionEndpoint: string;
+    readonly jwksUrl: string;
+    readonly tokenTransport: string;
+    readonly audience: 'arete:solana-gateway';
+    readonly targetKind: 'solana-gateway-binding';
+    readonly targetId: string;
+    readonly scopes: readonly SolanaGatewayAuthScope[];
+    readonly acceptedKeyClasses: readonly string[];
+    readonly transactionEntitlementRequired: boolean;
+}
+/** One generated, non-inheriting hosted Solana gateway capability binding. */
+interface HostedSolanaGatewayCapabilityBinding {
+    readonly endpoint: string;
+    readonly authPolicy: string;
+    readonly solanaGatewayBindingId: string;
+    readonly cluster: string;
+    readonly region: string;
+    readonly auth: SolanaGatewayAuthMetadata;
+}
+interface HostedSolanaGatewayBindings {
+    readonly chain: HostedSolanaGatewayCapabilityBinding;
+    readonly transactions: HostedSolanaGatewayCapabilityBinding;
+}
+/** Generated release identity with one explicit, non-inheriting read transport. */
+type ProgramReadDescriptor = {
+    readonly release: ProgramReleaseReference;
+    readonly transport: {
+        readonly kind: 'local-http';
+        readonly endpointSource: 'connect-http-url';
+    };
+} | {
+    readonly release: ProgramReleaseReference;
+    readonly transport: {
+        readonly kind: 'hosted-binding';
+        readonly binding: ProgramReadBinding;
+    };
+};
+/** Runtime overrides replace the complete generated descriptor. */
+type ProgramReadOverride = ProgramReadDescriptor;
+type ProgramReadDescriptors<TPrograms extends Record<string, ProgramSdkDefinition> | undefined> = TPrograms extends Record<string, ProgramSdkDefinition> ? {
+    readonly [K in keyof TPrograms]: ProgramReadDescriptor;
+} : Record<string, never>;
+type ProgramReadOverrides<TPrograms extends Record<string, ProgramSdkDefinition> | undefined> = TPrograms extends Record<string, ProgramSdkDefinition> ? {
+    readonly [K in keyof TPrograms]?: ProgramReadOverride;
+} : Record<string, never>;
+interface StackDefinition<TPrograms extends Record<string, ProgramSdkDefinition> = Record<string, ProgramSdkDefinition>> {
     readonly name: string;
     readonly endpoints: StackEndpoints;
     readonly views: Record<string, ViewGroup>;
     readonly schemas?: Record<string, Schema<unknown>>;
     readonly patchSchemas?: Record<string, Schema<unknown>>;
     readonly queries?: Record<string, StackQueryDefinition<unknown, unknown>>;
-    readonly programs?: Record<string, ProgramSdkDefinition>;
+    readonly programs?: TPrograms;
+    /** Release and transport metadata keyed in parallel with `programs`. */
+    readonly programReads?: ProgramReadDescriptors<TPrograms>;
 }
 interface ViewGroup {
     state?: ViewDef<any, 'state', any>;
@@ -886,9 +979,27 @@ interface AuthTokenResult {
     expires_at?: number;
     scopes?: readonly string[];
 }
-interface AuthTokenRequest {
-    scopes: readonly string[];
-}
+interface ProgramReadBindingAuthTarget {
+    readonly targetKind: 'program-read-binding';
+    readonly targetId: string;
+    readonly programReleaseHash: string;
+}
+interface SolanaGatewayBindingAuthTarget {
+    readonly targetKind: 'solana-gateway-binding';
+    readonly targetId: string;
+    readonly programReleaseHash?: never;
+}
+type AuthTokenTarget = ProgramReadBindingAuthTarget | SolanaGatewayBindingAuthTarget;
+type AuthTokenRequest = {
+    readonly scopes: readonly string[];
+    readonly targetKind?: never;
+    readonly targetId?: never;
+    readonly programReleaseHash?: never;
+} | ({
+    readonly scopes: readonly string[];
+} & ProgramReadBindingAuthTarget) | ({
+    readonly scopes: readonly string[];
+} & SolanaGatewayBindingAuthTarget);
 interface WebSocketFactoryInit {
     headers?: Record<string, string>;
 }
@@ -924,6 +1035,8 @@ interface AreteConfig {
     maxEntriesPerView?: number | null;
     /** Authentication configuration */
     auth?: AuthConfig;
+    /** Fetch implementation used for authentication token requests. */
+    fetch?: typeof fetch;
 }
 interface SocketIssue {
     error: string;
@@ -1054,6 +1167,7 @@ declare class ConnectionManager {
     private tokenRefreshTimeout;
     private tokenRefreshInFlight;
     private tokenRequestInFlight;
+    private readonly httpAuthTokenStates;
     private currentState;
     private subscriptionQueue;
     private activeSubscriptions;
@@ -1063,6 +1177,7 @@ declare class ConnectionManager {
     private stateHandlers;
     private socketIssueHandlers;
     private authConfig?;
+    private readonly authFetch;
     private currentToken?;
     private tokenExpiry?;
     private tokenScopes;
@@ -1078,8 +1193,14 @@ declare class ConnectionManager {
     private tokenCovers;
     private getOrRefreshToken;
     private fetchAuthToken;
+    private requestAuthToken;
+    private updateHttpTokenState;
+    private getTargetedHttpAuthToken;
+    private touchHttpAuthTokenState;
+    private trimHttpAuthTokenStates;
     private createTokenEndpointRequestBody;
     private fetchTokenFromEndpoint;
+    private isExpiryExpired;
     private isTokenExpired;
     private scheduleTokenRefresh;
     private clearTokenRefreshTimeout;
@@ -1094,7 +1215,14 @@ declare class ConnectionManager {
     getState(): ConnectionState;
     getHttpAuthToken(forceRefresh?: boolean): Promise<string | undefined>;
     getHttpAuthToken(requiredScopes?: readonly string[], forceRefresh?: boolean): Promise<string | undefined>;
+    getHttpAuthToken(request: AuthTokenRequest, forceRefresh?: boolean): Promise<string | undefined>;
+    getHttpAuthToken(target: AuthTokenTarget, forceRefresh?: boolean): Promise<string | undefined>;
+    getHttpAuthToken(target: AuthTokenTarget, requiredScopes: readonly string[], forceRefresh?: boolean): Promise<string | undefined>;
+    getHttpAuthToken(requiredScopes: readonly string[], target: AuthTokenTarget, forceRefresh?: boolean): Promise<string | undefined>;
+    getHttpAuthToken(requiredScopes: readonly string[], forceRefresh: boolean, target: AuthTokenTarget): Promise<string | undefined>;
     clearHttpAuthToken(): void;
+    clearHttpAuthToken(request: AuthTokenRequest): void;
+    clearHttpAuthToken(target: AuthTokenTarget, requiredScopes?: readonly string[]): void;
     onFrame(handler: FrameHandler): () => void;
     onStateChange(handler: ConnectionStateCallback): () => void;
     onSocketIssue(handler: SocketIssueCallback): () => void;
@@ -1674,7 +1802,7 @@ interface ProgramRuntimeExtensionCarrier<TOperations extends AnyProgramOperation
 }
 type ProgramOperationsOf<TProgram> = TProgram extends ProgramRuntimeExtensionCarrier<infer TOperations> ? TOperations : ProgramOperations;
 type MergeProgramOperations<TBase extends AnyProgramOperations, TExtension extends AnyProgramOperations> = ProgramOperations<Extract<MergeField<InstructionOperationsOf<TBase>, InstructionOperationsOf<TExtension>>, InstructionOperationNamespace | EmptyRecord>, Extract<MergeField<TransactionOperationsOf<TBase>, TransactionOperationsOf<TExtension>>, TransactionOperationNamespace | EmptyRecord>, Extract<MergeField<FlowOperationsOf<TBase>, FlowOperationsOf<TExtension>>, FlowOperationNamespace | EmptyRecord>>;
-type ExtendedProgramDefinition<TBase extends ProgramSdkDefinition, TAddresses = never, TConstants = never, TDefaults = never, TOperations extends AnyProgramOperations = ProgramOperations, TMath = never> = Omit<TBase, 'definitionHash'> & MaybeField<'addresses', TAddresses> & MaybeField<'constants', TConstants> & MaybeField<'defaults', TDefaults> & MaybeField<'math', TMath> & ProgramRuntimeExtensionCarrier<MergeProgramOperations<ProgramOperationsOf<TBase>, TOperations>>;
+type ExtendedProgramDefinition<TBase extends ProgramSdkDefinition, TAddresses = never, TConstants = never, TDefaults = never, TOperations extends AnyProgramOperations = ProgramOperations, TMath = never> = Omit<TBase, 'sdkDefinitionHash'> & MaybeField<'addresses', TAddresses> & MaybeField<'constants', TConstants> & MaybeField<'defaults', TDefaults> & MaybeField<'math', TMath> & ProgramRuntimeExtensionCarrier<MergeProgramOperations<ProgramOperationsOf<TBase>, TOperations>>;
 interface ProgramExtensionInput<TAddresses = never, TConstants = never, TDefaults = never, TOperations extends AnyProgramOperations = ProgramOperations, TProgram extends ProgramSdkDefinition = ProgramSdkDefinition, TMath = never> {
     readonly pdas?: Record<string, unknown>;
     readonly accounts?: Record<string, unknown>;
@@ -1742,8 +1870,9 @@ type MergeProgramMaps<TStackPrograms, TAttachedPrograms> = Omit<NormalizeProgram
 type StackWithAttachedPrograms<TStack extends StackDefinition, TAttachedPrograms extends ProgramMap | undefined> = Omit<TStack, 'programs'> & {
     programs: MergeProgramMaps<TStack['programs'], TAttachedPrograms>;
 };
+declare function validateProgramReadDescriptor(programName: string, descriptor: ProgramReadDescriptor): void;
 declare function withPrograms<TStack extends StackDefinition, TAttachedPrograms extends ProgramMap | undefined>(stack: TStack, attachedPrograms: TAttachedPrograms): StackWithAttachedPrograms<TStack, TAttachedPrograms>;
-interface ConnectOptions<TPrograms extends ProgramMap | undefined = undefined> {
+interface ConnectOptions<TPrograms extends ProgramMap | undefined = undefined, TStackPrograms extends ProgramMap | undefined = ProgramMap> {
     url?: string;
     httpUrl?: string;
     /**
@@ -1777,6 +1906,12 @@ interface ConnectOptions<TPrograms extends ProgramMap | undefined = undefined> {
     fetch?: typeof fetch;
     /** Additional program SDKs exposed under client.programs.<key>. */
     programs?: TPrograms;
+    /** Per-program complete descriptor replacements. */
+    programReads?: ProgramReadOverrides<MergeProgramMaps<TStackPrograms, TPrograms>>;
+    /** Explicit chain transport, used by composition sessions. */
+    chain?: ChainClient;
+    /** Explicit transaction transport, used by composition sessions. */
+    transactions?: TransactionTransport;
     /** Default semantic-operation execution settings. */
     execution?: OperationExecutionOptions<any>;
 }
@@ -1790,6 +1925,8 @@ interface AreteOptionsWithStorage<TStack extends StackDefinition> extends AreteO
     wallet?: WalletAdapter;
     fetch?: typeof fetch;
     execution?: OperationExecutionOptions<any>;
+    chain?: ChainClient;
+    transactions?: TransactionTransport;
     onFrameValidationError?: (diagnostic: FrameValidationDiagnostic) => void;
 }
 interface TransactionOptions<TSigner = unknown> {
@@ -1813,7 +1950,7 @@ interface TypedInstruction<TParams, TError> {
 }
 interface TypedAccountReader<T> {
     fetch(address: string): Promise<T | null>;
-    fetchMany(addresses: readonly string[]): Promise<Array<T | null>>;
+    fetchMany(addresses: readonly string[]): Promise<ProgramAccountBatchResult<T>>;
     exists(address: string): Promise<boolean>;
 }
 type TypedQueryExecutor<TParams, TResult> = (params: TParams) => Promise<TResult>;
@@ -1871,7 +2008,10 @@ declare class Arete$1<TStack extends StackDefinition> {
     private readonly _transactions;
     private readonly stack;
     private readonly httpBaseUrl;
+    private readonly connectHttpUrl;
+    private readonly programReadOverrides;
     private readonly fetchImpl;
+    private readonly auth;
     private readonly executionDefaults?;
     private _wallet?;
     private _aggregatedErrors?;
@@ -1880,14 +2020,16 @@ declare class Arete$1<TStack extends StackDefinition> {
     private buildQueries;
     private buildPrograms;
     private createTypedInstruction;
+    private createProgramTransport;
     private createAccountReader;
     private createQueryExecutor;
     private readJson;
     private authenticatedFetch;
+    private authenticatedStackFetch;
     private resolveReadUrl;
     /** Merge the client's default wallet into call options (call options win). */
     private withWallet;
-    static connect<T extends StackDefinition, TPrograms extends ProgramMap | undefined = undefined>(stack: T, options?: ConnectOptions<TPrograms>): Promise<ConnectedArete<StackWithAttachedPrograms<T, TPrograms>, T>>;
+    static connect<T extends StackDefinition, TPrograms extends ProgramMap | undefined = undefined>(stack: T, options?: ConnectOptions<TPrograms, T['programs']>): Promise<ConnectedArete<StackWithAttachedPrograms<T, TPrograms>, T>>;
     get views(): TypedViews<TStack['views']>;
     get queries(): QueriesInterface<TStack['queries']>;
     get programs(): ProgramsInterface<TStack['programs']>;
@@ -1951,9 +2093,12 @@ declare class Arete$1<TStack extends StackDefinition> {
  * composition of programs + views, and a standalone program member reuses the
  * exact same machinery as a stack with no views, connected HTTP-only.
  */
-interface SessionDefinition {
+interface SessionDefinition<TPrograms extends Record<string, ProgramSdkDefinition> = Record<string, ProgramSdkDefinition>> {
+    readonly mode?: 'composition';
     readonly stacks?: Record<string, StackDefinition>;
-    readonly programs?: Record<string, ProgramSdkDefinition>;
+    readonly programs?: TPrograms;
+    /** Generated descriptors keyed in parallel with standalone `programs`. */
+    readonly programReads?: ProgramReadDescriptors<TPrograms>;
 }
 type SessionStackPrograms<TDef extends SessionDefinition> = Partial<{
     [K in keyof NonNullable<TDef['stacks']>]: Record<string, ProgramSdkDefinition> | undefined;
@@ -1972,6 +2117,10 @@ interface SessionMemberOptions<TPrograms extends Record<string, ProgramSdkDefini
     autoConnect?: boolean;
     autoReconnect?: boolean;
     programs?: TPrograms;
+    /** Override applied to every program owned by this member. */
+    programRead?: ProgramReadOverride;
+    /** Per-program overrides for this member. */
+    programReads?: Readonly<Record<string, ProgramReadOverride>>;
 }
 interface SessionOptions<TDef extends SessionDefinition = SessionDefinition, TStackPrograms extends SessionStackPrograms<TDef> = {}> {
     /** One wallet governs execution across every member. */
@@ -1998,7 +2147,18 @@ interface SessionOptions<TDef extends SessionDefinition = SessionDefinition, TSt
         [K in keyof NonNullable<TDef['stacks']>]?: SessionMemberOptions<K extends keyof TStackPrograms ? TStackPrograms[K] : undefined>;
     };
     programs?: Record<string, SessionMemberOptions>;
-}
+    /** Override applied to every program in the session. */
+    programRead?: ProgramReadOverride;
+    /** Session-wide per-program overrides, keyed by program key. */
+    programReads?: Readonly<Record<string, ProgramReadOverride>>;
+}
+type CompositionSessionOptions<TDef extends SessionDefinition = SessionDefinition, TStackPrograms extends SessionStackPrograms<TDef> = {}> = Omit<SessionOptions<TDef, TStackPrograms>, 'chain' | 'transactions' | 'endpoints'> & {
+    /** Chain reads never inherit a live member's HTTP endpoint. */
+    chain: ChainClient;
+    /** Transactions never inherit a live member's HTTP endpoint. */
+    transactions: TransactionTransport;
+    endpoints?: never;
+};
 type SessionStacks<TDef extends SessionDefinition, TStackPrograms extends SessionStackPrograms<TDef> = {}> = {
     readonly [K in keyof NonNullable<TDef['stacks']>]: NonNullable<TDef['stacks']>[K] extends StackDefinition ? K extends keyof TStackPrograms ? ConnectedArete<StackWithAttachedPrograms<NonNullable<TDef['stacks']>[K], TStackPrograms[K]>, NonNullable<TDef['stacks']>[K]> : ConnectedArete<NonNullable<TDef['stacks']>[K], NonNullable<TDef['stacks']>[K]> : never;
 };
@@ -2011,7 +2171,9 @@ type PromotedSessionPrograms<TDef extends SessionDefinition, TStackPrograms exte
 type ExplicitSessionPrograms<TDef extends SessionDefinition> = {
     readonly [K in keyof NonNullable<TDef['programs']>]: NonNullable<TDef['programs']>[K] extends ProgramSdkDefinition ? ProgramInterface<NonNullable<TDef['programs']>[K]> : never;
 };
-type SessionPrograms<TDef extends SessionDefinition, TStackPrograms extends SessionStackPrograms<TDef> = {}> = Omit<PromotedSessionPrograms<TDef, TStackPrograms>, keyof NonNullable<TDef['programs']>> & ExplicitSessionPrograms<TDef>;
+type SessionPrograms<TDef extends SessionDefinition, TStackPrograms extends SessionStackPrograms<TDef> = {}> = TDef extends {
+    readonly mode: 'composition';
+} ? ExplicitSessionPrograms<TDef> : Omit<PromotedSessionPrograms<TDef, TStackPrograms>, keyof NonNullable<TDef['programs']>> & ExplicitSessionPrograms<TDef>;
 interface Session<TDef extends SessionDefinition = SessionDefinition, TStackPrograms extends SessionStackPrograms<TDef> = {}> {
     readonly stacks: SessionStacks<TDef, TStackPrograms>;
     readonly programs: SessionPrograms<TDef, TStackPrograms>;
@@ -2024,7 +2186,23 @@ interface Session<TDef extends SessionDefinition = SessionDefinition, TStackProg
     setWallet(wallet: WalletAdapter | undefined): void;
     close(): void;
 }
-declare function createSession<TDef extends SessionDefinition, TStackPrograms extends SessionStackPrograms<TDef> = {}>(definition: TDef, options?: SessionOptions<TDef, TStackPrograms>): Promise<Session<TDef, TStackPrograms>>;
+declare function createSession<TDef extends SessionDefinition, TStackPrograms extends SessionStackPrograms<TDef> = {}>(definition: TDef, ...args: TDef extends {
+    readonly mode: 'composition';
+} ? [options: CompositionSessionOptions<TDef, TStackPrograms>] : [options?: SessionOptions<TDef, TStackPrograms>]): Promise<Session<TDef, TStackPrograms>>;
+
+interface HostedSolanaGatewayTransportOptions {
+    readonly auth?: AuthConfig;
+    readonly fetch?: typeof fetch;
+}
+interface HostedSolanaGatewayTransports {
+    readonly chain: ChainClient;
+    readonly transactions: TransactionTransport;
+}
+/**
+ * Construct explicit hosted chain and transaction transports from generated
+ * gateway descriptors. Tokens are isolated by exact binding target and scope.
+ */
+declare function createHostedSolanaGatewayTransports(bindings: HostedSolanaGatewayBindings, options?: HostedSolanaGatewayTransportOptions): HostedSolanaGatewayTransports;
 
 interface AccountLoader {
     getAccount(address: string): Promise<{
@@ -2119,7 +2297,6 @@ declare class ReadRequestError extends Error {
 }
 declare function programAccountRead<T>(input: {
     account: string;
-    path: string;
     schema?: Schema<T>;
 }): ProgramAccountReadDefinition<T>;
 declare function programQuery<TParams = unknown, TResult = unknown>(input: {
@@ -2135,6 +2312,23 @@ declare function stackQuery<TParams = unknown, TResult = unknown>(input: {
     schema?: Schema<TResult>;
 }): StackQueryDefinition<TParams, TResult>;
 
+type ProgramReadRequest = {
+    readonly operation: 'fetch';
+    readonly account: string;
+    readonly address: string;
+} | {
+    readonly operation: 'fetchMany';
+    readonly account: string;
+    readonly addresses: readonly string[];
+} | {
+    readonly operation: 'exists';
+    readonly account: string;
+    readonly address: string;
+};
+interface ProgramReadTransport {
+    read<T>(request: ProgramReadRequest): Promise<T>;
+}
+
 declare class MemoryAdapter implements StorageAdapter {
     private views;
     private updateCallbacks;
@@ -2170,5 +2364,5 @@ declare const Arete: typeof Arete$1 & {
     session: typeof createSession;
 };
 
-export { ASSOCIATED_TOKEN_PROGRAM_ADDRESS, Arete, AreteError, ConnectionManager, DEFAULT_CONFIG, DEFAULT_MAX_ENTRIES_PER_VIEW, FrameProcessor, InstructionError, MemoryAdapter, OperationCallbackError, OperationExecutionError, PROGRAM_OPERATION_EXTENSIONS, ProcessedSlotTimeoutError, QueryStore, ReadRequestError, SPL_TOKEN_PROGRAM_ADDRESS, STACK_RUNTIME_EXTENSIONS, SYSTEM_PROGRAM_ADDRESS, SubscriptionRegistry, TOKEN_2022_PROGRAM_ADDRESS, TransactionExecutionError, TransactionTransportError, account, appendFlowTransactions, appendTransactionInstructions, applyConnectedStackExtensions, arg, buildInstruction, bytes, canonicalQueryKey, chainAccountLoader, createChainClient, createEntityStream, createInstructionExecutor, createInstructionHandler, createPreparedFlow, createPreparedInstruction, createPreparedTransaction, createPreparedTransactionBody, createProgramPdas, createPublicKeySeed, createRichUpdateStream, createSeed, createSession, createSignerRegistry, createSubscriptionId, createTransactionTransport, createTypedListView, createTypedStateView, createTypedViews, createUpdateStream, decodeBase58, defineProgramExtensions, defineStackExtensions, deriveAssociatedTokenAccount, deriveHttpEndpoint, findProgramAddress as derivePda, describePreparedOperation, encodeBase58, executeInstruction, executePreparedOperation, extendProgram, extendPrograms, extendStack, findProgramAddress, findProgramAddressSync, flowOperation, formatPreparedOperation, formatProgramError, formatRawToUi, getMintDecimals, getProgramRuntimeExtensions, getStackRuntimeExtensions, getTransactionFailureOutcome, inspectPreparedOperation, instructionOperation, isEntityFrame, isErrorFrame, isHostedAreteEndpoint, isSnapshotFrame, isSubscribedFrame, isUnsubscribedFrame, isValidFrame, literal, normalizeSubscription, normalizeSubscriptionQuery, normalizeSubscriptionRequest, normalizeTransactionError, parseFrame, parseFrameFromBlob, parseInstructionError, parseUiAmountToRaw, pda, prependFlowTransactionInstructions, prependTransactionInstructions, programAccountRead, programQuery, resolveAccounts, resolveAmount, resolveAmountToRaw, resolveAmountsToRaw, resolveTokenProgramAddress, safeToRawAmount, serializeInstructionData, serializeViewKey, stackQuery, stringifyBigints, toJsonValue, toRawAmount, transactionOperation, unwrapOperationExecutionError, validateAccountResolution, validateSubscriptionId, withPrograms };
-export type { AccountCategory, AccountLoader, AccountMeta, AccountResolutionOptions, AccountResolutionResult, AmountInput, AnyOperation, AreteConfig, AreteOptions, AreteOptionsWithStorage, ArgSchema, ArgType, AuthConfig, AuthTokenRequest, AuthTokenResult, BuildOptions, BuiltAccountMeta, BuiltInstruction, ChainClient, ChainClock, ChainFailedTransactionOutcome, ConfirmationLevel, ConfirmedTransactionOutcome, ConnectOptions, ConnectedArete, ConnectedStackClient, ConnectionState, ConnectionStateCallback, ContextSlotOptions, CreatePreparedFlowInput, CreatePreparedInstructionInput, CreatePreparedTransactionInput, DefaultViewKey, EntityFrame, ErrorFrame, ErrorMetadata, ExecuteOptions, ExecutionResult, ExtendedProgramDefinition, ExtendedStackDefinition, FlowOperation, FlowOperationNamespace, FlowOperationReceipt, Frame, FrameMode, FrameOp, FrameProcessorConfig, FrameValidationDiagnostic, InstructionExecutor, InstructionHandler, InstructionHandlerConfig, InstructionOperation, InstructionOperationNamespace, JsonObject, JsonPrimitive, JsonValue, LatestBlockhashResult, MergeProgramMaps, MintAccountInfo, NativeBalanceInfo, NonEmptyReadonlyArray, NotSubmittedTransactionOutcome, OperationCallbackPhase, OperationExecutionEvent, OperationExecutionHost, OperationExecutionOptions, OperationExecutionSuccessEvent, OperationInspection, OperationInspectionOptions, OperationKind, OperationNamespace, OperationPlan, OperationReceiptFor, OperationTransactionReceipt, PdaConfig, PdaDeriveContext, PdaFactory, PdaSeed, PreparedFlow, PreparedInstruction, PreparedOperation, PreparedOperationDescription, PreparedTransaction, PreparedTransactionBody, PreparedTransactionInstruction, PreparedTransactionOperation, ProgramAccountReadDefinition, ProgramError, ProgramExtensionInput, ProgramInterface, ProgramOperationContext, ProgramOperations, ProgramOperationsOf, ProgramPdas, ProgramQueryDefinition, ProgramRuntimeExtensionCarrier, ProgramRuntimeExtensions, ProgramSdkDefinition, ProgramsInterface, QueriesInterface, QueryLease, QuerySnapshot, RawAccountInfo, RawInstructionsInterface, RawProgramsInterface, ReadArgumentCount, ReadArgumentCounts, ReadTransportMethod, ResolvedAccount, ResolvedAccounts, RichUpdate, RichUpdateCallback, Schema, SchemaResult, SeedDef, SendOptions, SendResult, Session, SessionDefinition, SessionMemberOptions, SessionOptions, SignerRegistry, SingleTransactionOperationReceipt, SnapshotEntity, SnapshotFrame, SocketIssue, SocketIssueCallback, SortConfig, SortOrder, StackConnectedExtensions, StackDefinition, StackEndpoints, StackExtensionClient, StackExtensionInput, StackQueryDefinition, StackRuntimeExtensionCarrier, StackRuntimeExtensions, StackWithAttachedPrograms, StorageAdapter, StorageAdapterConfig, StringifiedBigints, SubmittedUnknownTransactionOutcome, SubscribeCallback, SubscribedFrame, Subscription, SubscriptionIdentity, SubscriptionOptions, SubscriptionQuery, SubscriptionRequest, SubscriptionSnapshotOptions, TokenAccountInfo, TokenBalanceInfo, TokenBalanceInput, TransactionCommitment, TransactionFailureOutcome, TransactionFailurePhase, TransactionFailureStatus, TransactionFeeResult, TransactionInspectionOptions, TransactionInspectionResult, TransactionOperation, TransactionOperationNamespace, TransactionOptions, TransactionOutcome, TransactionRequestContext, TransactionSendOptions, TransactionSendResult, TransactionSignatureStatus, TransactionSimulationOptions, TransactionSimulationResult, TransactionTransport, TransactionTransportErrorBody, TypedAccountReader, TypedInstruction, TypedListView, TypedQueryExecutor, TypedStateView, TypedViewGroup, TypedViews, UnsubscribeFn, UnsubscribedFrame, Update, UpdateCallback, ViewDef, ViewGroup, ViewKeyFields, ViewKeyValue, ViewSortConfig, WaitForProcessedSlotOptions, WalletAdapter, WalletConnectOptions, WalletExecutionContext, WalletState, WatchOptions, WebSocketFactoryInit };
+export { ASSOCIATED_TOKEN_PROGRAM_ADDRESS, Arete, AreteError, ConnectionManager, DEFAULT_CONFIG, DEFAULT_MAX_ENTRIES_PER_VIEW, FrameProcessor, InstructionError, MemoryAdapter, OperationCallbackError, OperationExecutionError, PROGRAM_OPERATION_EXTENSIONS, ProcessedSlotTimeoutError, QueryStore, ReadRequestError, SPL_TOKEN_PROGRAM_ADDRESS, STACK_RUNTIME_EXTENSIONS, SYSTEM_PROGRAM_ADDRESS, SubscriptionRegistry, TOKEN_2022_PROGRAM_ADDRESS, TransactionExecutionError, TransactionTransportError, account, appendFlowTransactions, appendTransactionInstructions, applyConnectedStackExtensions, arg, buildInstruction, bytes, canonicalQueryKey, chainAccountLoader, createChainClient, createEntityStream, createHostedSolanaGatewayTransports, createInstructionExecutor, createInstructionHandler, createPreparedFlow, createPreparedInstruction, createPreparedTransaction, createPreparedTransactionBody, createProgramPdas, createPublicKeySeed, createRichUpdateStream, createSeed, createSession, createSignerRegistry, createSubscriptionId, createTransactionTransport, createTypedListView, createTypedStateView, createTypedViews, createUpdateStream, decodeBase58, defineProgramExtensions, defineStackExtensions, deriveAssociatedTokenAccount, deriveHttpEndpoint, findProgramAddress as derivePda, describePreparedOperation, encodeBase58, executeInstruction, executePreparedOperation, extendProgram, extendPrograms, extendStack, findProgramAddress, findProgramAddressSync, flowOperation, formatPreparedOperation, formatProgramError, formatRawToUi, getMintDecimals, getProgramRuntimeExtensions, getStackRuntimeExtensions, getTransactionFailureOutcome, inspectPreparedOperation, instructionOperation, isEntityFrame, isErrorFrame, isHostedAreteEndpoint, isSnapshotFrame, isSubscribedFrame, isUnsubscribedFrame, isValidFrame, literal, normalizeSubscription, normalizeSubscriptionQuery, normalizeSubscriptionRequest, normalizeTransactionError, parseFrame, parseFrameFromBlob, parseInstructionError, parseUiAmountToRaw, pda, prependFlowTransactionInstructions, prependTransactionInstructions, programAccountRead, programQuery, resolveAccounts, resolveAmount, resolveAmountToRaw, resolveAmountsToRaw, resolveTokenProgramAddress, safeToRawAmount, serializeInstructionData, serializeViewKey, stackQuery, stringifyBigints, toJsonValue, toRawAmount, transactionOperation, unwrapOperationExecutionError, validateAccountResolution, validateProgramReadDescriptor, validateSubscriptionId, withPrograms };
+export type { AccountCategory, AccountLoader, AccountMeta, AccountResolutionOptions, AccountResolutionResult, AmountInput, AnyOperation, AreteConfig, AreteOptions, AreteOptionsWithStorage, ArgSchema, ArgType, AuthConfig, AuthTokenRequest, AuthTokenResult, AuthTokenTarget, BuildOptions, BuiltAccountMeta, BuiltInstruction, ChainClient, ChainClock, ChainFailedTransactionOutcome, CompositionSessionOptions, ConfirmationLevel, ConfirmedTransactionOutcome, ConnectOptions, ConnectedArete, ConnectedStackClient, ConnectionState, ConnectionStateCallback, ContextSlotOptions, CreatePreparedFlowInput, CreatePreparedInstructionInput, CreatePreparedTransactionInput, DefaultViewKey, EntityFrame, ErrorFrame, ErrorMetadata, ExecuteOptions, ExecutionResult, ExtendedProgramDefinition, ExtendedStackDefinition, FlowOperation, FlowOperationNamespace, FlowOperationReceipt, Frame, FrameMode, FrameOp, FrameProcessorConfig, FrameValidationDiagnostic, HostedSolanaGatewayBindings, HostedSolanaGatewayCapabilityBinding, HostedSolanaGatewayTransportOptions, HostedSolanaGatewayTransports, HttpAuthMetadata, InstructionExecutor, InstructionHandler, InstructionHandlerConfig, InstructionOperation, InstructionOperationNamespace, JsonObject, JsonPrimitive, JsonValue, LatestBlockhashResult, MergeProgramMaps, MintAccountInfo, NativeBalanceInfo, NonEmptyReadonlyArray, NotSubmittedTransactionOutcome, OperationCallbackPhase, OperationExecutionEvent, OperationExecutionHost, OperationExecutionOptions, OperationExecutionSuccessEvent, OperationInspection, OperationInspectionOptions, OperationKind, OperationNamespace, OperationPlan, OperationReceiptFor, OperationTransactionReceipt, PdaConfig, PdaDeriveContext, PdaFactory, PdaSeed, PreparedFlow, PreparedInstruction, PreparedOperation, PreparedOperationDescription, PreparedTransaction, PreparedTransactionBody, PreparedTransactionInstruction, PreparedTransactionOperation, ProgramAccountBatchItem, ProgramAccountBatchResult, ProgramAccountReadDefinition, ProgramError, ProgramExtensionInput, ProgramInterface, ProgramOperationContext, ProgramOperations, ProgramOperationsOf, ProgramPdas, ProgramQueryDefinition, ProgramReadBinding, ProgramReadBindingAuthTarget, ProgramReadDescriptor, ProgramReadDescriptors, ProgramReadOverride, ProgramReadOverrides, ProgramReadRequest, ProgramReadTransport, ProgramReleaseReference, ProgramRuntimeExtensionCarrier, ProgramRuntimeExtensions, ProgramSdkDefinition, ProgramsInterface, QueriesInterface, QueryLease, QuerySnapshot, RawAccountInfo, RawInstructionsInterface, RawProgramsInterface, ReadArgumentCount, ReadArgumentCounts, ReadTransportMethod, ResolvedAccount, ResolvedAccounts, RichUpdate, RichUpdateCallback, Schema, SchemaResult, SeedDef, SendOptions, SendResult, Session, SessionDefinition, SessionMemberOptions, SessionOptions, SignerRegistry, SingleTransactionOperationReceipt, SnapshotEntity, SnapshotFrame, SocketIssue, SocketIssueCallback, SolanaGatewayAuthMetadata, SolanaGatewayAuthScope, SolanaGatewayBindingAuthTarget, SortConfig, SortOrder, StackConnectedExtensions, StackDefinition, StackEndpoints, StackExtensionClient, StackExtensionInput, StackQueryDefinition, StackRuntimeExtensionCarrier, StackRuntimeExtensions, StackWithAttachedPrograms, StorageAdapter, StorageAdapterConfig, StringifiedBigints, SubmittedUnknownTransactionOutcome, SubscribeCallback, SubscribedFrame, Subscription, SubscriptionIdentity, SubscriptionOptions, SubscriptionQuery, SubscriptionRequest, SubscriptionSnapshotOptions, TokenAccountInfo, TokenBalanceInfo, TokenBalanceInput, TransactionCommitment, TransactionFailureOutcome, TransactionFailurePhase, TransactionFailureStatus, TransactionFeeResult, TransactionInspectionOptions, TransactionInspectionResult, TransactionOperation, TransactionOperationNamespace, TransactionOptions, TransactionOutcome, TransactionRequestContext, TransactionSendOptions, TransactionSendResult, TransactionSignatureStatus, TransactionSimulationOptions, TransactionSimulationResult, TransactionTransport, TransactionTransportErrorBody, TypedAccountReader, TypedInstruction, TypedListView, TypedQueryExecutor, TypedStateView, TypedViewGroup, TypedViews, UnsubscribeFn, UnsubscribedFrame, Update, UpdateCallback, ViewDef, ViewGroup, ViewKeyFields, ViewKeyValue, ViewSortConfig, WaitForProcessedSlotOptions, WalletAdapter, WalletConnectOptions, WalletExecutionContext, WalletState, WatchOptions, WebSocketFactoryInit };