@ar.io/sdk 3.24.0 → 4.0.0-solana.1

package/lib/types/solana/generated/mpl-core/types/transferDelegate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder } from '@solana/kit';
+export type TransferDelegate = {};
+export type TransferDelegateArgs = TransferDelegate;
+export declare function getTransferDelegateEncoder(): FixedSizeEncoder<TransferDelegateArgs>;
+export declare function getTransferDelegateDecoder(): FixedSizeDecoder<TransferDelegate>;
+export declare function getTransferDelegateCodec(): FixedSizeCodec<TransferDelegateArgs, TransferDelegate>;

package/lib/types/solana/generated/mpl-core/types/updateAuthority.d.ts

@@ -0,0 +1,27 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type Codec, type Decoder, type Encoder, type GetDiscriminatedUnionVariant, type GetDiscriminatedUnionVariantContent } from '@solana/kit';
+export type UpdateAuthority = {
+    __kind: "None";
+} | {
+    __kind: "Address";
+    fields: readonly [Address];
+} | {
+    __kind: "Collection";
+    fields: readonly [Address];
+};
+export type UpdateAuthorityArgs = UpdateAuthority;
+export declare function getUpdateAuthorityEncoder(): Encoder<UpdateAuthorityArgs>;
+export declare function getUpdateAuthorityDecoder(): Decoder<UpdateAuthority>;
+export declare function getUpdateAuthorityCodec(): Codec<UpdateAuthorityArgs, UpdateAuthority>;
+export declare function updateAuthority(kind: 'None'): GetDiscriminatedUnionVariant<UpdateAuthorityArgs, '__kind', 'None'>;
+export declare function updateAuthority(kind: 'Address', data: GetDiscriminatedUnionVariantContent<UpdateAuthorityArgs, '__kind', 'Address'>['fields']): GetDiscriminatedUnionVariant<UpdateAuthorityArgs, '__kind', 'Address'>;
+export declare function updateAuthority(kind: 'Collection', data: GetDiscriminatedUnionVariantContent<UpdateAuthorityArgs, '__kind', 'Collection'>['fields']): GetDiscriminatedUnionVariant<UpdateAuthorityArgs, '__kind', 'Collection'>;
+export declare function isUpdateAuthority<K extends UpdateAuthority['__kind']>(kind: K, value: UpdateAuthority): value is UpdateAuthority & {
+    __kind: K;
+};

package/lib/types/solana/generated/mpl-core/types/updateDelegate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type Codec, type Decoder, type Encoder } from '@solana/kit';
+export type UpdateDelegate = {
+    additionalDelegates: Array<Address>;
+};
+export type UpdateDelegateArgs = UpdateDelegate;
+export declare function getUpdateDelegateEncoder(): Encoder<UpdateDelegateArgs>;
+export declare function getUpdateDelegateDecoder(): Decoder<UpdateDelegate>;
+export declare function getUpdateDelegateCodec(): Codec<UpdateDelegateArgs, UpdateDelegate>;

package/lib/types/solana/generated/mpl-core/types/updateGroupV1Args.d.ts

@@ -0,0 +1,19 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Codec, type Decoder, type Encoder, type Option, type OptionOrNullable } from '@solana/kit';
+export type UpdateGroupV1Args = {
+    newName: Option<string>;
+    newUri: Option<string>;
+};
+export type UpdateGroupV1ArgsArgs = {
+    newName: OptionOrNullable<string>;
+    newUri: OptionOrNullable<string>;
+};
+export declare function getUpdateGroupV1ArgsEncoder(): Encoder<UpdateGroupV1ArgsArgs>;
+export declare function getUpdateGroupV1ArgsDecoder(): Decoder<UpdateGroupV1Args>;
+export declare function getUpdateGroupV1ArgsCodec(): Codec<UpdateGroupV1ArgsArgs, UpdateGroupV1Args>;

package/lib/types/solana/generated/mpl-core/types/updateType.d.ts

@@ -0,0 +1,17 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder } from '@solana/kit';
+export declare enum UpdateType {
+    Mint = 0,
+    Add = 1,
+    Remove = 2
+}
+export type UpdateTypeArgs = UpdateType;
+export declare function getUpdateTypeEncoder(): FixedSizeEncoder<UpdateTypeArgs>;
+export declare function getUpdateTypeDecoder(): FixedSizeDecoder<UpdateType>;
+export declare function getUpdateTypeCodec(): FixedSizeCodec<UpdateTypeArgs, UpdateType>;

package/lib/types/solana/generated/mpl-core/types/validationResult.d.ts

@@ -0,0 +1,18 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder } from '@solana/kit';
+export declare enum ValidationResult {
+    Approved = 0,
+    Rejected = 1,
+    Pass = 2,
+    ForceApproved = 3
+}
+export type ValidationResultArgs = ValidationResult;
+export declare function getValidationResultEncoder(): FixedSizeEncoder<ValidationResultArgs>;
+export declare function getValidationResultDecoder(): FixedSizeDecoder<ValidationResult>;
+export declare function getValidationResultCodec(): FixedSizeCodec<ValidationResultArgs, ValidationResult>;

package/lib/types/solana/generated/mpl-core/types/validationResultsOffset.d.ts

@@ -0,0 +1,33 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Codec, type Decoder, type Encoder, type GetDiscriminatedUnionVariant, type GetDiscriminatedUnionVariantContent } from '@solana/kit';
+export type ValidationResultsOffset = {
+    __kind: "NoOffset";
+} | {
+    __kind: "Anchor";
+} | {
+    __kind: "Custom";
+    fields: readonly [bigint];
+};
+export type ValidationResultsOffsetArgs = {
+    __kind: "NoOffset";
+} | {
+    __kind: "Anchor";
+} | {
+    __kind: "Custom";
+    fields: readonly [number | bigint];
+};
+export declare function getValidationResultsOffsetEncoder(): Encoder<ValidationResultsOffsetArgs>;
+export declare function getValidationResultsOffsetDecoder(): Decoder<ValidationResultsOffset>;
+export declare function getValidationResultsOffsetCodec(): Codec<ValidationResultsOffsetArgs, ValidationResultsOffset>;
+export declare function validationResultsOffset(kind: 'NoOffset'): GetDiscriminatedUnionVariant<ValidationResultsOffsetArgs, '__kind', 'NoOffset'>;
+export declare function validationResultsOffset(kind: 'Anchor'): GetDiscriminatedUnionVariant<ValidationResultsOffsetArgs, '__kind', 'Anchor'>;
+export declare function validationResultsOffset(kind: 'Custom', data: GetDiscriminatedUnionVariantContent<ValidationResultsOffsetArgs, '__kind', 'Custom'>['fields']): GetDiscriminatedUnionVariant<ValidationResultsOffsetArgs, '__kind', 'Custom'>;
+export declare function isValidationResultsOffset<K extends ValidationResultsOffset['__kind']>(kind: K, value: ValidationResultsOffset): value is ValidationResultsOffset & {
+    __kind: K;
+};

package/lib/types/solana/generated/mpl-core/types/verifiedCreators.d.ts

@@ -0,0 +1,18 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Codec, type Decoder, type Encoder } from '@solana/kit';
+import { type VerifiedCreatorsSignature, type VerifiedCreatorsSignatureArgs } from './index.js';
+export type VerifiedCreators = {
+    signatures: Array<VerifiedCreatorsSignature>;
+};
+export type VerifiedCreatorsArgs = {
+    signatures: Array<VerifiedCreatorsSignatureArgs>;
+};
+export declare function getVerifiedCreatorsEncoder(): Encoder<VerifiedCreatorsArgs>;
+export declare function getVerifiedCreatorsDecoder(): Decoder<VerifiedCreators>;
+export declare function getVerifiedCreatorsCodec(): Codec<VerifiedCreatorsArgs, VerifiedCreators>;

package/lib/types/solana/generated/mpl-core/types/verifiedCreatorsSignature.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder } from '@solana/kit';
+export type VerifiedCreatorsSignature = {
+    address: Address;
+    verified: boolean;
+};
+export type VerifiedCreatorsSignatureArgs = VerifiedCreatorsSignature;
+export declare function getVerifiedCreatorsSignatureEncoder(): FixedSizeEncoder<VerifiedCreatorsSignatureArgs>;
+export declare function getVerifiedCreatorsSignatureDecoder(): FixedSizeDecoder<VerifiedCreatorsSignature>;
+export declare function getVerifiedCreatorsSignatureCodec(): FixedSizeCodec<VerifiedCreatorsSignatureArgs, VerifiedCreatorsSignature>;

package/lib/types/solana/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Solana backend for the AR.IO SDK.
+ *
+ * This module provides Solana-native implementations of the AR.IO read/write
+ * interfaces, allowing consumers to interact with AR.IO protocol state
+ * stored on Solana instead of AO. All primitives come from `@solana/kit` —
+ * `@solana/web3.js` is not used.
+ *
+ * Usage:
+ * ```ts
+ * import {
+ *   createSolanaRpc,
+ *   createSolanaRpcSubscriptions,
+ *   generateKeyPairSigner,
+ * } from '@solana/kit';
+ * import {
+ *   SolanaARIOReadable,
+ *   SolanaARIOWriteable,
+ *   SolanaANTReadable,
+ * } from '@ar.io/sdk/solana';
+ *
+ * const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com');
+ *
+ * // Read-only (RPC only)
+ * const ario = new SolanaARIOReadable({ rpc });
+ *
+ * // Read-write (signer + subscriptions client needed for confirmation)
+ * const rpcSubscriptions = createSolanaRpcSubscriptions(
+ *   'wss://api.mainnet-beta.solana.com',
+ * );
+ * const signer = await generateKeyPairSigner();
+ * const arioWrite = new SolanaARIOWriteable({ rpc, rpcSubscriptions, signer });
+ *
+ * // ANT (Arweave Name Token)
+ * const ant = new SolanaANTReadable({
+ *   rpc,
+ *   processId: 'MetaplexCoreAssetAddress...',
+ * });
+ * ```
+ */
+export { SolanaARIOReadable } from './io-readable.js';
+export { SolanaARIOWriteable } from './io-writeable.js';
+export { SolanaANTReadable } from './ant-readable.js';
+export { SolanaANTWriteable } from './ant-writeable.js';
+export { SolanaANTRegistryReadable } from './ant-registry-readable.js';
+export type { SolanaANTRegistryConfig } from './ant-registry-readable.js';
+export { SolanaANTRegistryWriteable } from './ant-registry-writeable.js';
+export type { SolanaANTRegistryWriteableConfig } from './ant-registry-writeable.js';
+export type { AclMaintenanceOp, AclMaintenanceRole, } from '../types/ant-registry.js';
+export { ANTEscrow, TokenEscrow } from './escrow.js';
+export type { ANTEscrowConfig, EscrowAntState, EscrowAssetType, EscrowProtocol, EscrowTokenState, } from './escrow.js';
+export { canonicalMessage, canonicalMessageV2, bytesToHexLower, } from './canonical-message.js';
+export type { CanonicalMessageInput, CanonicalMessageV2Input, EscrowNetwork, } from './canonical-message.js';
+export { spawnSolanaANT, ARIO_LOGO_TX_ID, DEFAULT_ANT_TRANSACTION_ID, } from './spawn-ant.js';
+export type { SpawnSolanaANTParams, SpawnSolanaANTResult, SpawnSolanaANTState, } from './spawn-ant.js';
+export { hashName, getArioConfigPDA, getBalancePDA, getVaultPDA, getVaultCounterPDA, getPrimaryNamePDA, getPrimaryNameRequestPDA, getGatewayRegistryPDA, getGarSettingsPDA, getGatewayPDA, getDelegationPDA, getWithdrawalPDA, getWithdrawalCounterPDA, getAllowlistPDA, getEpochPDA, getEpochSettingsPDA, getObservationPDA, getArnsRegistryPDA, getArnsSettingsPDA, getArnsRecordPDA, getArnsRecordPDAFromHash, getReservedNamePDA, getReturnedNamePDA, getDemandFactorPDA, getPrimaryNameReversePDA, getRedelegationRecordPDA, getAntConfigPDA, getAntControllersPDA, getAntRecordPDA, getAclConfigPDA, getAclPagePDA, getEscrowAntPDA, getEscrowTokenPDA, getEscrowVaultPDA, } from './pda.js';
+export { BorshReader, BorshWriter, deserializeGateway, deserializeArnsRecord, deserializeVault, deserializeDelegation, deserializeBalance, deserializeEpochSettings, deserializeArioConfig, deserializeDemandFactor, deserializeReservedName, deserializeReturnedName, deserializeWithdrawal, deserializeRedelegationRecord, deserializePrimaryNameRequest, deserializePrimaryName, deserializeAllowlist, deserializeGarSettings, deserializeEpochSettingsFull, deserializeEpoch, deserializeObservation, deserializeAntConfig, deserializeAntControllers, deserializeAntRecord, deserializeAclConfig, deserializeAclPage, } from './deserialize.js';
+export type { DeserializedAclEntry } from './deserialize.js';
+export * from './constants.js';
+export * from './clusters.js';
+export type { SolanaConfig, SolanaReadConfig, SolanaWriteConfig, SolanaRpc, SolanaRpcSubscriptions, SolanaSigner, SolanaTransactionResult, AccountData, } from './types.js';
+export { parseTransactionEvents, parseEventsFromLogs, isEvent, } from './events.js';
+export type { AnyEvent, AnyArioCoreEvent, AnyArioGarEvent, AnyArioArnsEvent, AnyArioAntEvent, AnyArioAntEscrowEvent, EventName, } from './events.js';

package/lib/types/solana/instruction.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Common Solana program/sysvar addresses used by the SDK.
+ *
+ * All AR.IO and Metaplex Core instructions are now built via Codama-generated
+ * builders under `./generated/<program>/instructions/*`. This module only
+ * re-exports the AR.IO program IDs and a few sysvar/system constants that
+ * the rest of the SDK still references by name.
+ */
+import { type Address } from '@solana/kit';
+import { ARIO_ANT_PROGRAM_ID, ARIO_ARNS_PROGRAM_ID, ARIO_CORE_PROGRAM_ID, ARIO_GAR_PROGRAM_ID } from './constants.js';
+/**
+ * System program (11111111111111111111111111111111).
+ * Kit-native equivalent of web3.js's `SystemProgram.programId`.
+ */
+export declare const SYSTEM_PROGRAM_ADDRESS: Address;
+/**
+ * SPL Token program address.
+ */
+export declare const TOKEN_PROGRAM_ADDRESS: Address;
+/**
+ * Rent sysvar address.
+ */
+export declare const SYSVAR_RENT_ADDRESS: Address;
+export { ARIO_CORE_PROGRAM_ID, ARIO_GAR_PROGRAM_ID, ARIO_ARNS_PROGRAM_ID, ARIO_ANT_PROGRAM_ID, };

package/lib/types/solana/io-readable.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Solana implementation of the AoARIORead interface.
+ *
+ * Reads AR.IO protocol state directly from Solana PDAs using RPC,
+ * returning the same types that the AO implementation returns.
+ * This allows consumers to switch backends transparently.
+ */
+import { type Address, type Commitment } from '@solana/kit';
+import { type ILogger } from '../common/logger.js';
+import type { AoPrimaryName, AoPrimaryNameRequest, AoRedelegationFeeInfo, WalletAddress } from '../types/common.js';
+import type { AoAddressParams, AoAllDelegates, AoAllGatewayVaults, AoArNSNameData, AoArNSNameDataWithName, AoArNSReservedNameData, AoArNSReservedNameDataWithName, AoBalanceWithAddress, AoDelegation, AoEligibleDistribution, AoEpochData, AoEpochDistributionData, AoEpochObservationData, AoEpochSettings, AoGateway, AoGatewayDelegateWithAddress, AoGatewayRegistrySettings, AoGatewayVault, AoGatewayWithAddress, AoGetArNSRecordsParams, AoGetCostDetailsParams, AoPaginatedAddressParams, AoRegistrationFees, AoReturnedName, AoTokenCostParams, AoTokenSupplyData, AoVaultData, AoWalletVault, AoWeightedObserver, CostDetailsResult, DemandFactorSettings, EpochInput, PaginationParams, PaginationResult } from '../types/io.js';
+import type { SolanaReadConfig, SolanaRpc } from './types.js';
+/**
+ * Solana-backed read-only client for the AR.IO protocol.
+ *
+ * Usage:
+ * ```ts
+ * import { createSolanaRpc } from '@solana/kit';
+ * import { SolanaARIOReadable } from '@ar.io/sdk/solana';
+ *
+ * const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com');
+ * const ario = new SolanaARIOReadable({ rpc });
+ *
+ * const gateway = await ario.getGateway({ address: 'GatewayOperatorPubkey...' });
+ * const record = await ario.getArNSRecord({ name: 'ardrive' });
+ * ```
+ */
+export declare class SolanaARIOReadable {
+    protected readonly rpc: SolanaRpc;
+    protected readonly commitment: Commitment;
+    protected readonly logger: ILogger;
+    protected readonly coreProgram: Address;
+    protected readonly garProgram: Address;
+    protected readonly arnsProgram: Address;
+    protected readonly antProgram: Address;
+    private _arioMint?;
+    constructor(config: SolanaReadConfig & {
+        logger?: ILogger;
+        coreProgramId?: Address;
+        garProgramId?: Address;
+        arnsProgramId?: Address;
+        antProgramId?: Address;
+    });
+    /** Helper to fetch an encoded account (kit's replacement for Connection.getAccountInfo). */
+    private getAccount;
+    /**
+     * Helper for `getProgramAccounts` with a discriminator memcmp filter.
+     *
+     * Pass the Codama-generated `<NAME>_DISCRIMINATOR: Uint8Array` constant
+     * directly — kit's RPC requires a base58 string for `memcmp.bytes`, so
+     * we bs58-encode here to keep call sites from doing it inline (and to
+     * keep the IDL-derived bytes as the single source of truth).
+     */
+    private getAccountsByDiscriminator;
+    /** Read the gateway registry and return addresses in registry index order */
+    protected getRegistryGatewayAddresses(): Promise<string[]>;
+    getInfo(): Promise<{
+        epochSettings?: {
+            epochZeroStartTimestamp: number;
+            durationMs: number;
+            prescribedNameCount: number;
+            maxObservers: number;
+        } | undefined;
+        totalSupply?: number | undefined;
+        protocolBalance?: number | undefined;
+        Ticker: string;
+        Name: string;
+        Logo: string;
+        Denomination: number;
+        Handlers: never[];
+        LastCreatedEpochIndex: number;
+        LastDistributedEpochIndex: number;
+    }>;
+    getTokenSupply(): Promise<AoTokenSupplyData>;
+    /**
+     * Resolve the ARIO SPL mint address from the on-chain `ArioConfig`.
+     *
+     * `ArioConfig` layout: [8 disc][32 authority][32 mint][...]. We decode
+     * the mint at offset 40 and cache it for the lifetime of this instance —
+     * the mint never changes once the protocol is deployed.
+     */
+    protected getArioMint(): Promise<Address>;
+    /**
+     * Liquid ARIO balance for an address.
+     *
+     * On Solana the ARIO token is a real SPL mint, so the canonical liquid
+     * balance lives on the user's Associated Token Account — *not* the
+     * `ario-core::Balance` PDA. The Balance PDA is only populated by the
+     * one-shot AO-to-Solana migration importer for legacy snapshot accounts;
+     * spending it requires a separate claim flow that mints/transfers SPL
+     * tokens to the user's ATA. Steady-state instructions like `buy_name`,
+     * gateway/delegate stake, and ARIO transfers all move SPL tokens, so the
+     * ATA is what every UI and on-chain caller cares about.
+     *
+     * Returns 0 if the user has no ATA initialized yet.
+     */
+    getBalance({ address: owner, }: {
+        address: WalletAddress;
+    }): Promise<number>;
+    /**
+     * Enumerate liquid ARIO balances by querying the SPL Token program for
+     * every initialized token account on the ARIO mint.
+     *
+     * Filters: token-account size = 165, mint at offset 0. We then decode
+     * `owner` (offset 32) and `amount` (offset 64) from each.
+     */
+    getBalances(params?: PaginationParams<AoBalanceWithAddress>): Promise<PaginationResult<AoBalanceWithAddress>>;
+    getVault({ address: owner, vaultId, }: {
+        address: WalletAddress;
+        vaultId: string;
+    }): Promise<AoVaultData>;
+    getVaults(params?: PaginationParams<AoWalletVault>): Promise<PaginationResult<AoWalletVault>>;
+    getGateway({ address: addr }: AoAddressParams): Promise<AoGateway>;
+    getGateways(params?: PaginationParams<AoGatewayWithAddress>): Promise<PaginationResult<AoGatewayWithAddress>>;
+    getGatewayDelegates(params: AoAddressParams & PaginationParams<AoGatewayDelegateWithAddress>): Promise<PaginationResult<AoGatewayDelegateWithAddress>>;
+    getGatewayDelegateAllowList(params: AoPaginatedAddressParams): Promise<PaginationResult<WalletAddress>>;
+    getDelegations(params: PaginationParams<AoDelegation> & {
+        address: WalletAddress;
+    }): Promise<PaginationResult<AoDelegation>>;
+    getAllowedDelegates(params: AoPaginatedAddressParams): Promise<PaginationResult<WalletAddress>>;
+    getGatewayVaults(params: PaginationParams<AoGatewayVault> & {
+        address: WalletAddress;
+    }): Promise<PaginationResult<AoGatewayVault>>;
+    getArNSRecord({ name }: {
+        name: string;
+    }): Promise<AoArNSNameData>;
+    getArNSRecords(params?: AoGetArNSRecordsParams): Promise<PaginationResult<AoArNSNameDataWithName>>;
+    /**
+     * Fetch every `ArnsRecord` whose `ant` field equals one of `mints`.
+     *
+     * Issues one `getProgramAccounts` per mint with a memcmp filter at
+     * `ARNS_RECORD_ANT_OFFSET`, in parallel. Cheaper than scanning the
+     * whole registry as soon as the caller has fewer mints than the
+     * registry has records (today the break-even is ≈ a few hundred
+     * mints against ≈ 4k records, and rises as the registry grows).
+     *
+     * The shape mirrors `getArNSRecord` / `getArNSRecords` — same
+     * `AoArNSNameDataWithName` items, no pagination wrapper. Callers
+     * that want pagination should drive it via `getArNSRecords({
+     * filters: { processId: mints } })` instead.
+     */
+    getArNSRecordsByAntMints({ mints, }: {
+        mints: ReadonlyArray<string>;
+    }): Promise<AoArNSNameDataWithName[]>;
+    private fetchArnsRecordsByAntMints;
+    /**
+     * Resolve every ArNS record currently controlled by `address`.
+     *
+     * Mirrors the AO backend: walk the on-chain ANT ACL for the wallet
+     * (`Owned ∪ Controlled`), then issue point-queries against the
+     * ArNS registry for those mints. This is semantically *not* a query
+     * over `ArnsRecord.owner` — that field is a write-once "purchase
+     * receipt" and never reflects current control on Solana (see
+     * ISSUES.md). Authoritative control flows through the ANT NFT
+     * owner / `AntControllers`, which is exactly what the ACL
+     * indexes.
+     */
+    getArNSRecordsForAddress(params: PaginationParams<AoArNSNameDataWithName> & {
+        address: WalletAddress;
+        antRegistryProcessId?: string;
+    }): Promise<PaginationResult<AoArNSNameDataWithName>>;
+    getArNSReservedNames(params?: PaginationParams<AoArNSReservedNameDataWithName>): Promise<PaginationResult<AoArNSReservedNameDataWithName>>;
+    getArNSReservedName({ name, }: {
+        name: string;
+    }): Promise<AoArNSReservedNameData>;
+    getArNSReturnedNames(params?: PaginationParams<AoReturnedName>): Promise<PaginationResult<AoReturnedName>>;
+    getArNSReturnedName({ name, }: {
+        name: string;
+    }): Promise<AoReturnedName>;
+    getEpochSettings(): Promise<AoEpochSettings>;
+    /**
+     * Resolve an EpochInput to an epoch index number.
+     * - undefined: returns current epoch index from EpochSettings
+     * - { epochIndex }: returns directly
+     * - { timestamp }: computes from genesis timestamp and epoch duration
+     */
+    private resolveEpochIndex;
+    /** Fetch and deserialize an Epoch account by index */
+    private fetchEpoch;
+    getEpoch(epoch?: EpochInput): Promise<AoEpochData>;
+    getCurrentEpoch(): Promise<AoEpochData>;
+    getPrescribedObservers(epoch?: EpochInput): Promise<AoWeightedObserver[]>;
+    getPrescribedNames(epoch?: EpochInput): Promise<string[]>;
+    getObservations(epoch?: EpochInput): Promise<AoEpochObservationData>;
+    getDistributions(epoch?: EpochInput): Promise<AoEpochDistributionData>;
+    getEligibleEpochRewards(epoch?: EpochInput, params?: PaginationParams<AoEligibleDistribution>): Promise<PaginationResult<AoEligibleDistribution>>;
+    /**
+     * Compute the token cost for an ArNS operation.
+     *
+     * Mirrors the Rust pricing functions in ario-arns/src/pricing.rs.
+     * Uses BigInt for u128-equivalent overflow-safe arithmetic.
+     */
+    getTokenCost(params: AoTokenCostParams): Promise<number>;
+    getCostDetails(params: AoGetCostDetailsParams): Promise<CostDetailsResult>;
+    getRegistrationFees(): Promise<AoRegistrationFees>;
+    getDemandFactor(): Promise<number>;
+    getDemandFactorSettings(): Promise<DemandFactorSettings>;
+    getPrimaryName(params: {
+        address: WalletAddress;
+    } | {
+        name: string;
+    }): Promise<AoPrimaryName>;
+    getPrimaryNameRequest(params: {
+        initiator: WalletAddress;
+    }): Promise<AoPrimaryNameRequest>;
+    getPrimaryNameRequests(params?: PaginationParams<AoPrimaryNameRequest>): Promise<PaginationResult<AoPrimaryNameRequest>>;
+    getPrimaryNames(params?: PaginationParams<AoPrimaryName>): Promise<PaginationResult<AoPrimaryName>>;
+    getRedelegationFee(params: {
+        address: WalletAddress;
+    }): Promise<AoRedelegationFeeInfo>;
+    getGatewayRegistrySettings(): Promise<AoGatewayRegistrySettings>;
+    getAllDelegates(params?: PaginationParams<AoAllDelegates>): Promise<PaginationResult<AoAllDelegates>>;
+    getAllGatewayVaults(params?: PaginationParams<AoAllGatewayVaults>): Promise<PaginationResult<AoAllGatewayVaults>>;
+    resolveArNSName({ name }: {
+        name: string;
+    }): Promise<{
+        name: string;
+        txId: string;
+        type: "lease" | "permabuy";
+        processId: string;
+        ttlSeconds: number;
+        undernameLimit: number;
+    }>;
+}