@ar.io/sdk 3.19.0-alpha.1 → 3.19.0-alpha.11

package/lib/types/cli/commands/antCommands.d.ts

@@ -19,3 +19,15 @@ import { CLIWriteOptionsFromAoAntParams } from '../types.js';
 export declare function setAntRecordCLICommand(o: CLIWriteOptionsFromAoAntParams<AoANTSetUndernameRecordParams>): Promise<import("../../types/common.js").AoMessageResult<Record<string, string | number | boolean | null>>>;
 export declare function setAntBaseNameCLICommand(o: CLIWriteOptionsFromAoAntParams<AoANTSetBaseNameRecordParams>): Promise<import("../../types/common.js").AoMessageResult<Record<string, string | number | boolean | null>>>;
 export declare function setAntUndernameCLICommand(o: CLIWriteOptionsFromAoAntParams<AoANTSetUndernameRecordParams>): Promise<import("../../types/common.js").AoMessageResult<Record<string, string | number | boolean | null>>>;
+export declare function transferRecordOwnershipCLICommand(o: CLIWriteOptionsFromAoAntParams<{
+    undername: string;
+    recipient: string;
+}>): Promise<import("../../types/common.js").AoMessageResult<Record<string, string | number | boolean | null>>>;
+export declare function upgradeAntCLICommand(o: CLIWriteOptionsFromAoAntParams<Record<string, unknown>>): Promise<{
+    forkedProcessId: string;
+    reassignedNames: Record<string, import("../../types/common.js").AoMessageResult>;
+    failedReassignedNames: Record<string, {
+        id?: string;
+        error: string;
+    }>;
+}>;

package/lib/types/cli/options.d.ts

@@ -247,6 +247,14 @@ export declare const optionMap: {
         description: string;
         type: string;
     };
+    owner: {
+        alias: string;
+        description: string;
+    };
+    displayName: {
+        alias: string;
+        description: string;
+    };
     names: {
         alias: string;
         description: string;
@@ -282,6 +290,10 @@ export declare const optionMap: {
         alias: string;
         description: string;
     };
+    module: {
+        alias: string;
+        description: string;
+    };
     token: {
         alias: string;
         description: string;
@@ -296,6 +308,11 @@ export declare const optionMap: {
         alias: string;
         description: string;
     };
+    reassignAffiliatedNames: {
+        alias: string;
+        description: string;
+        type: string;
+    };
 };
 export declare const walletOptions: {
     alias: string;
@@ -390,3 +407,11 @@ export declare const setAntUndernameOptions: {
     alias: string;
     description: string;
 }[];
+export declare const upgradeAntOptions: {
+    alias: string;
+    description: string;
+}[];
+export declare const transferRecordOwnershipOptions: {
+    alias: string;
+    description: string;
+}[];

package/lib/types/cli/types.d.ts

@@ -107,6 +107,7 @@ export type ANTStateCLIOptions = WriteActionCLIOptions & {
     controllers?: string[];
     ttlSeconds?: string;
     logo?: string;
+    module?: string;
 };
 export type JsonSerializable = string | number | boolean | null | JsonSerializable[] | {
     [key: string]: JsonSerializable;

package/lib/types/cli/utils.d.ts

@@ -1,6 +1,6 @@
 import { JWKInterface } from 'arweave/node/lib/wallet.js';
 import { Command, OptionValues } from 'commander';
-import { AOProcess, ARIOToken, AoANTRead, AoANTRegistryRead, AoANTWrite, AoARIORead, AoARIOWrite, AoGetCostDetailsParams, AoRedelegateStakeParams, AoSigner, AoUpdateGatewaySettingsParams, ContractSigner, EpochInput, FundFrom, Logger, PaginationParams, SpawnANTState, WriteOptions, mARIOToken } from '../node/index.js';
+import { ARIOToken, AoANTRead, AoANTRegistryRead, AoANTWrite, AoARIORead, AoARIOWrite, AoGetCostDetailsParams, AoRedelegateStakeParams, AoSigner, AoUpdateGatewaySettingsParams, ContractSigner, EpochInput, FundFrom, Logger, PaginationParams, SpawnANTState, WriteOptions, mARIOToken } from '../node/index.js';
 import { ANTStateCLIOptions, AddressCLIOptions, EpochCLIOptions, GetTokenCostCLIOptions, GlobalCLIOptions, InitiatorCLIOptions, JsonSerializable, PaginationCLIOptions, ProcessIdCLIOptions, RedelegateStakeCLIOptions, TransferCLIOptions, UpdateGatewaySettingsCLIOptions, WalletCLIOptions, WriteActionCLIOptions } from './types.js';
 export declare const defaultTtlSecondsCLI = 3600;
 export declare function stringifyJsonForCLIDisplay(json: JsonSerializable | unknown): string;
@@ -18,11 +18,11 @@ export declare function makeCommand<O extends OptionValues = GlobalCLIOptions>({
     options?: CommanderOption[];
 }): Command;
 export declare function arioProcessIdFromOptions({ arioProcessId, devnet, testnet, }: GlobalCLIOptions): string;
+export declare function antRegistryIdFromOptions({ antRegistryProcessId, testnet, }: GlobalCLIOptions): string;
 export declare function requiredJwkFromOptions(options: WalletCLIOptions): JWKInterface;
 export declare function jwkToAddress(jwk: JWKInterface): string;
 export declare function getLoggerFromOptions(options: GlobalCLIOptions): Logger;
 export declare function readARIOFromOptions(options: GlobalCLIOptions): AoARIORead;
-export declare function ANTRegistryProcessFromOptions(options: ProcessIdCLIOptions): AOProcess;
 export declare function readANTRegistryFromOptions(options: ProcessIdCLIOptions): AoANTRegistryRead;
 export declare function contractSignerFromOptions(options: WalletCLIOptions): {
     signer: ContractSigner;
@@ -97,3 +97,16 @@ export declare function referrerFromOptions<O extends {
     referrer?: string;
 }>(o: O): string | undefined;
 export declare function assertLockLengthInRange(lockLengthMs: number, assertMin?: boolean): void;
+export declare function antRecordMetadataFromOptions<O extends {
+    owner?: string;
+    displayName?: string;
+    logo?: string;
+    description?: string;
+    keywords?: string[];
+}>(options: O): {
+    owner?: string;
+    displayName?: string;
+    logo?: string;
+    description?: string;
+    keywords?: string[];
+};

package/lib/types/common/ant.d.ts

@@ -1,7 +1,7 @@
 import { AntReadOptions, AoANTHandler, AoANTInfo, AoANTRead, AoANTRecord, AoANTSetBaseNameRecordParams, AoANTSetUndernameRecordParams, AoANTState, AoANTWrite, SortedANTRecords } from '../types/ant.js';
-import { AoMessageResult, ProcessConfiguration, WalletAddress, WithSigner, WriteOptions } from '../types/index.js';
+import { AoClient, AoMessageResult, AoSigner, ProcessConfiguration, UpgradeAntProgressEvent, WalletAddress, WithSigner, WriteOptions } from '../types/index.js';
 import { forkANT, spawnANT } from '../utils/ao.js';
-import { AOProcess } from './index.js';
+import { AOProcess, Logger } from './index.js';
 type ANTConfigOptionalStrict = Required<ProcessConfiguration> & {
     strict?: boolean;
     hyperbeamUrl?: string;
@@ -25,6 +25,37 @@ export declare class ANT {
      * @param config
      */
     static fork: typeof forkANT;
+    /**
+     * Upgrade an ANT by forking it to the latest version and reassigning names.
+     *
+     *
+     * @param config Configuration object for the upgrade process
+     * @returns Promise resolving to the forked process ID and successfully reassigned names
+     */
+    static upgrade({ signer, antProcessId, reassignAffiliatedNames, names, arioProcessId, antRegistryId, ao, logger, skipVersionCheck, onSigningProgress, hyperbeamUrl, }: {
+        signer: AoSigner;
+        antProcessId: string;
+        arioProcessId?: string;
+        skipVersionCheck?: boolean;
+        ao?: AoClient;
+        logger?: Logger;
+        antRegistryId?: string;
+        hyperbeamUrl?: string;
+        onSigningProgress?: (name: keyof UpgradeAntProgressEvent, payload: UpgradeAntProgressEvent[keyof UpgradeAntProgressEvent]) => void;
+    } & ({
+        names: string[];
+        reassignAffiliatedNames?: false;
+    } | {
+        names?: never;
+        reassignAffiliatedNames: true;
+    })): Promise<{
+        forkedProcessId: string;
+        reassignedNames: Record<string, AoMessageResult>;
+        failedReassignedNames: Record<string, {
+            id?: string;
+            error: Error;
+        }>;
+    }>;
     /**
      * Initialize overloads.
      *
@@ -36,9 +67,11 @@ export declare class ANT {
 export declare class AoANTReadable implements AoANTRead {
     protected process: AOProcess;
     readonly processId: string;
+    readonly hyperbeamUrl: URL | undefined;
     private strict;
-    private hyperbeamUrl;
     private checkHyperBeamPromise;
+    private moduleId;
+    private moduleIdPromise;
     private logger;
     constructor(config: ANTConfigOptionalStrict);
     /**
@@ -53,6 +86,63 @@ export declare class AoANTReadable implements AoANTRead {
      * Returns the TX ID of the logo set for the ANT.
      */
     getLogo(): Promise<string>;
+    /**
+     * Gets the module ID of the current ANT process by querying its spawn transaction tags.
+     * Results are cached after the first successful fetch.
+     *
+     * @param graphqlUrl The GraphQL endpoint URL (defaults to Arweave's GraphQL endpoint)
+     * @param retries Number of retry attempts (defaults to 3)
+     * @returns Promise<string> The module ID used to spawn this ANT process
+     * @example
+     * ```ts
+     * const moduleId = await ant.getModuleId();
+     * console.log(`ANT was spawned with module: ${moduleId}`);
+     * ```
+     */
+    getModuleId({ graphqlUrl, retries, }?: {
+        graphqlUrl?: string;
+        retries?: number;
+    }): Promise<string>;
+    /**
+     * Internal method to fetch the module ID from GraphQL.
+     *
+     * TODO: this could be more like get process headers/metadata and fetch additional details.
+     *
+     * It seems like module is the only relevant one, but scheduler and authority are also available.
+     */
+    private fetchModuleId;
+    /**
+     * Gets the version string of the current ANT by matching its module ID
+     * with versions from the ANT registry.
+     *
+     * @param antRegistryId The ANT registry process ID (defaults to mainnet registry)
+     * @param graphqlUrl The GraphQL endpoint URL for getModuleId (defaults to Arweave's GraphQL endpoint)
+     * @param retries Number of retry attempts for getModuleId (defaults to 3)
+     * @returns Promise<string> The version string (e.g., "1.0.15") or "unknown" if not found
+     * @example
+     * ```ts
+     * const version = await ant.getVersion();
+     * console.log(`ANT is running version: ${version}`);
+     * ```
+     */
+    getVersion({ antRegistryId, graphqlUrl, retries, }?: {
+        antRegistryId?: string;
+        graphqlUrl?: string;
+        retries?: number;
+    }): Promise<string>;
+    /**
+     * Checks if the current ANT version is the latest according to the ANT registry.
+     *
+     * @param antRegistryId Optional ANT registry process ID. Defaults to mainnet ANT registry.
+     * @param graphqlUrl Optional GraphQL endpoint. Defaults to https://arweave.net/graphql.
+     * @param retries Optional number of retries for fetching module ID. Defaults to 3.
+     * @returns {Promise<boolean>} True if current ANT version is the latest, false otherwise.
+     */
+    isLatestVersion({ antRegistryId, graphqlUrl, retries, }?: {
+        antRegistryId?: string;
+        graphqlUrl?: string;
+        retries?: number;
+    }): Promise<boolean>;
     /**
      * @param undername @type {string} The domain name.
      * @returns {Promise<ANTRecord>} The record of the undername domain.
@@ -186,34 +276,49 @@ export declare class AoANTWriteable extends AoANTReadable implements AoANTWrite
      * @param undername @type {string} The record you want to set the transactionId and ttlSeconds of.
      * @param transactionId @type {string} The transactionId of the record.
      * @param ttlSeconds @type {number} The time to live of the record.
+     * @param owner @type {string} Optional owner address for the record.
+     * @param displayName @type {string} Optional display name for the record.
+     * @param logo @type {string} Optional logo transaction ID for the record.
+     * @param description @type {string} Optional description for the record.
+     * @param keywords @type {string[]} Optional keywords array for the record.
      * @returns {Promise<AoMessageResult>} The result of the interaction.
      */
-    setRecord({ undername, transactionId, ttlSeconds }: AoANTSetUndernameRecordParams, options?: WriteOptions): Promise<AoMessageResult>;
+    setRecord({ undername, transactionId, ttlSeconds, owner, displayName, logo, description, keywords, }: AoANTSetUndernameRecordParams, options?: WriteOptions): Promise<AoMessageResult>;
     /**
      * Sets the top level name of the ANT. This is the name that will be used to resolve the ANT (e.g. ardrive.ar.io)
      *
      * @param transactionId @type {string} The transactionId of the record.
      * @param ttlSeconds @type {number} The time to live of the record.
+     * @param owner @type {string} Optional owner address for the record.
+     * @param displayName @type {string} Optional display name for the record.
+     * @param logo @type {string} Optional logo transaction ID for the record.
+     * @param description @type {string} Optional description for the record.
+     * @param keywords @type {string[]} Optional keywords array for the record.
      * @returns {Promise<AoMessageResult>} The result of the interaction.
      * @example
      * ```ts
      * ant.setBaseNameRecord({ transactionId: "432l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM", ttlSeconds: 100 }); // ardrive.ar.io will resolve to the provided transaction id and be cached for 100 seconds by clients
      * ```
      */
-    setBaseNameRecord({ transactionId, ttlSeconds }: AoANTSetBaseNameRecordParams, options?: WriteOptions): Promise<AoMessageResult>;
+    setBaseNameRecord({ transactionId, ttlSeconds, owner, displayName, logo, description, keywords, }: AoANTSetBaseNameRecordParams, options?: WriteOptions): Promise<AoMessageResult>;
     /**
      * Adds or updates an undername of the ANT. An undername is appended to the base name of the ANT (e.g. ardrive.ar.io) to form a fully qualified name (e.g. dapp_ardrive.ar.io)
      *
      * @param undername @type {string} The undername of the ANT.
      * @param transactionId @type {string} The transactionId of the record.
      * @param ttlSeconds @type {number} The time to live of the record.
+     * @param owner @type {string} Optional owner address for the record.
+     * @param displayName @type {string} Optional display name for the record.
+     * @param logo @type {string} Optional logo transaction ID for the record.
+     * @param description @type {string} Optional description for the record.
+     * @param keywords @type {string[]} Optional keywords array for the record.
      * @returns {Promise<AoMessageResult>} The result of the interaction.
      * @example
      * ```ts
      * ant.setUndernameRecord({ undername: "dapp", transactionId: "432l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM", ttlSeconds: 100 }); // dapp_ardrive.ar.io will resolve to the provided transaction id and be cached for 100 seconds by clients
      * ```
      */
-    setUndernameRecord({ undername, transactionId, ttlSeconds }: AoANTSetUndernameRecordParams, options?: WriteOptions): Promise<AoMessageResult>;
+    setUndernameRecord({ undername, transactionId, ttlSeconds, owner, displayName, logo, description, keywords, }: AoANTSetUndernameRecordParams, options?: WriteOptions): Promise<AoMessageResult>;
     /**
      * Removes an undername from the ANT. This will remove the undername from the ANT.
      *
@@ -373,5 +478,61 @@ export declare class AoANTWriteable extends AoANTReadable implements AoANTWrite
         arioProcessId: string;
         notifyOwners?: boolean;
     }, options?: WriteOptions): Promise<AoMessageResult>;
+    /**
+     * Upgrade this ANT by forking it to the latest version and reassigning names.
+     *
+     * This is a convenience method that calls the static ANT.upgrade() method
+     * using this instance's process ID and signer.
+     *
+     * current version with latest ANT registry version and skip if already up to date.
+     *
+     * @param names @type {string[]} The ArNS names to reassign to the upgraded ANT.
+     * @param arioProcessId @type {string} The processId of the ARIO contract.
+     * @param antRegistryId @type {string} Optional ANT registry ID.
+     * @param onSigningProgress Progress callback function.
+     * @returns {Promise} The upgrade results.
+     * @example
+     * ```ts
+     * const result = await ant.upgrade({
+     *   names: ["example", "test"],
+     *   arioProcessId: ARIO_MAINNET_PROCESS_ID
+     * });
+     * console.log(`Upgraded to process: ${result.forkedProcessId}`);
+     * ```
+     */
+    upgrade(params?: {
+        arioProcessId?: string;
+        antRegistryId?: string;
+        skipVersionCheck?: boolean;
+        onSigningProgress?: (name: keyof UpgradeAntProgressEvent, payload: UpgradeAntProgressEvent[keyof UpgradeAntProgressEvent]) => void;
+    } & ({
+        names: string[];
+        reassignAffiliatedNames?: false;
+    } | {
+        names?: never;
+        reassignAffiliatedNames?: true;
+    })): Promise<{
+        forkedProcessId: string;
+        reassignedNames: Record<string, AoMessageResult>;
+        failedReassignedNames: Record<string, {
+            id?: string;
+            error: Error;
+        }>;
+    }>;
+    /**
+     * Transfers ownership of a specific record (undername) to another address. This allows delegation of control for individual records within an ANT while maintaining the ANT owner's ultimate authority.
+     *
+     * @param undername @type {string} The subdomain/record whose ownership you want to transfer.
+     * @param recipient @type {string} The address of the new owner for this record.
+     * @returns {Promise<AoMessageResult>} The result of the interaction.
+     * @example
+     * ```ts
+     * ant.transferRecord({ undername: "alice", recipient: "new-owner-address-123..." }); // transfers ownership of the "alice" record to the new owner
+     * ```
+     */
+    transferRecord({ undername, recipient, }: {
+        undername: string;
+        recipient: string;
+    }, options?: WriteOptions): Promise<AoMessageResult>;
 }
 export {};

package/lib/types/common/io.d.ts

@@ -155,7 +155,7 @@ export declare class ARIOReadable implements AoARIORead, ArNSNameResolver {
      * @returns {Promise<AoArNSNameData[]>} The ARNS names associated with the address
      */
     getArNSRecordsForAddress(params: PaginationParams<AoArNSNameDataWithName> & {
-        antRegistryId?: string;
+        antRegistryProcessId?: string;
         address: WalletAddress;
     }): Promise<PaginationResult<AoArNSNameDataWithName>>;
 }

package/lib/types/constants.d.ts

@@ -20,6 +20,7 @@ export declare const ARIO_DEVNET_PROCESS_ID = "GaQrvEMKBpkjofgnBi_B3IgIDmY_XYelV
 export declare const arioDevnetProcessId = "GaQrvEMKBpkjofgnBi_B3IgIDmY_XYelVLB6GcRGrHc";
 export declare const ARIO_TESTNET_PROCESS_ID = "agYcCFJtrMG6cqMuZfskIkFTGvUPddICmtQSBIoPdiA";
 export declare const ARIO_MAINNET_PROCESS_ID = "qNvAoz0TgcH7DMg8BCVn8jF32QH5L6T29VjHxhHqqGE";
+export declare const ANT_REGISTRY_TESTNET_ID = "RR0vheYqtsKuJCWh6xj0beE35tjaEug5cejMw9n2aa8";
 export declare const ANT_REGISTRY_ID = "i_le_yKKPVstLTDSmkHRqf-wYphMnwB9OhleiTgMkWc";
 export declare const MARIO_PER_ARIO = 1000000;
 /**

package/lib/types/types/ant.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { z } from 'zod';
-import { AoWriteAction, WalletAddress } from './common.js';
+import { AoMessageResult, AoWriteAction, UpgradeAntProgressEvent, WalletAddress } from './common.js';
 /**
  * example error:
  *  {
@@ -36,14 +36,29 @@ export declare const AntRecordSchema: z.ZodObject<{
     transactionId: z.ZodEffects<z.ZodString, string, string>;
     ttlSeconds: z.ZodNumber;
     priority: z.ZodOptional<z.ZodNumber>;
+    owner: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    description: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     transactionId: string;
     ttlSeconds: number;
+    description?: string | undefined;
     priority?: number | undefined;
+    owner?: string | undefined;
+    displayName?: string | undefined;
+    logo?: string | undefined;
+    keywords?: string[] | undefined;
 }, {
     transactionId: string;
     ttlSeconds: number;
+    description?: string | undefined;
     priority?: number | undefined;
+    owner?: string | undefined;
+    displayName?: string | undefined;
+    logo?: string | undefined;
+    keywords?: string[] | undefined;
 }>;
 export type AoANTRecord = z.infer<typeof AntRecordSchema>;
 export type ANTRecords = Record<string, AoANTRecord>;
@@ -55,14 +70,29 @@ export declare const AntRecordsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
     transactionId: z.ZodEffects<z.ZodString, string, string>;
     ttlSeconds: z.ZodNumber;
     priority: z.ZodOptional<z.ZodNumber>;
+    owner: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    description: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     transactionId: string;
     ttlSeconds: number;
+    description?: string | undefined;
     priority?: number | undefined;
+    owner?: string | undefined;
+    displayName?: string | undefined;
+    logo?: string | undefined;
+    keywords?: string[] | undefined;
 }, {
     transactionId: string;
     ttlSeconds: number;
+    description?: string | undefined;
     priority?: number | undefined;
+    owner?: string | undefined;
+    displayName?: string | undefined;
+    logo?: string | undefined;
+    keywords?: string[] | undefined;
 }>>;
 export declare const AntControllersSchema: z.ZodArray<z.ZodString, "many">;
 export declare const AntBalancesSchema: z.ZodRecord<z.ZodString, z.ZodNumber>;
@@ -78,14 +108,29 @@ export declare const AntStateSchema: z.ZodObject<{
         transactionId: z.ZodEffects<z.ZodString, string, string>;
         ttlSeconds: z.ZodNumber;
         priority: z.ZodOptional<z.ZodNumber>;
+        owner: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        description: z.ZodOptional<z.ZodString>;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         transactionId: string;
         ttlSeconds: number;
+        description?: string | undefined;
         priority?: number | undefined;
+        owner?: string | undefined;
+        displayName?: string | undefined;
+        logo?: string | undefined;
+        keywords?: string[] | undefined;
     }, {
         transactionId: string;
         ttlSeconds: number;
+        description?: string | undefined;
         priority?: number | undefined;
+        owner?: string | undefined;
+        displayName?: string | undefined;
+        logo?: string | undefined;
+        keywords?: string[] | undefined;
     }>>;
     Balances: z.ZodRecord<z.ZodString, z.ZodNumber>;
     Logo: z.ZodEffects<z.ZodString, string, string>;
@@ -102,7 +147,12 @@ export declare const AntStateSchema: z.ZodObject<{
     Records: Record<string, {
         transactionId: string;
         ttlSeconds: number;
+        description?: string | undefined;
         priority?: number | undefined;
+        owner?: string | undefined;
+        displayName?: string | undefined;
+        logo?: string | undefined;
+        keywords?: string[] | undefined;
     }>;
     Balances: Record<string, number>;
     Logo: string;
@@ -119,7 +169,12 @@ export declare const AntStateSchema: z.ZodObject<{
     Records: Record<string, {
         transactionId: string;
         ttlSeconds: number;
+        description?: string | undefined;
         priority?: number | undefined;
+        owner?: string | undefined;
+        displayName?: string | undefined;
+        logo?: string | undefined;
+        keywords?: string[] | undefined;
     }>;
     Balances: Record<string, number>;
     Logo: string;
@@ -155,52 +210,77 @@ export declare const SpawnANTStateSchema: z.ZodObject<{
         transactionId: z.ZodEffects<z.ZodString, string, string>;
         ttlSeconds: z.ZodNumber;
         priority: z.ZodOptional<z.ZodNumber>;
+        owner: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        description: z.ZodOptional<z.ZodString>;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         transactionId: string;
         ttlSeconds: number;
+        description?: string | undefined;
         priority?: number | undefined;
+        owner?: string | undefined;
+        displayName?: string | undefined;
+        logo?: string | undefined;
+        keywords?: string[] | undefined;
     }, {
         transactionId: string;
         ttlSeconds: number;
+        description?: string | undefined;
         priority?: number | undefined;
+        owner?: string | undefined;
+        displayName?: string | undefined;
+        logo?: string | undefined;
+        keywords?: string[] | undefined;
     }>>;
     balances: z.ZodRecord<z.ZodString, z.ZodNumber>;
     logo: z.ZodEffects<z.ZodString, string, string>;
 }, "strip", z.ZodTypeAny, {
     description: string;
+    owner: string;
+    logo: string;
+    keywords: string[];
     name: string;
     ticker: string;
-    keywords: string[];
-    owner: string;
     controllers: string[];
     records: Record<string, {
         transactionId: string;
         ttlSeconds: number;
+        description?: string | undefined;
         priority?: number | undefined;
+        owner?: string | undefined;
+        displayName?: string | undefined;
+        logo?: string | undefined;
+        keywords?: string[] | undefined;
     }>;
     balances: Record<string, number>;
-    logo: string;
 }, {
     description: string;
+    owner: string;
+    logo: string;
+    keywords: string[];
     name: string;
     ticker: string;
-    keywords: string[];
-    owner: string;
     controllers: string[];
     records: Record<string, {
         transactionId: string;
         ttlSeconds: number;
+        description?: string | undefined;
         priority?: number | undefined;
+        owner?: string | undefined;
+        displayName?: string | undefined;
+        logo?: string | undefined;
+        keywords?: string[] | undefined;
     }>;
     balances: Record<string, number>;
-    logo: string;
 }>;
 export type SpawnANTState = z.infer<typeof SpawnANTStateSchema>;
 export declare const AntReadHandlers: readonly ["balance", "balances", "totalSupply", "info", "controllers", "record", "records", "state"];
 export type AoANTReadHandler = (typeof AntReadHandlers)[number];
-export declare const AntWriteHandlers: readonly ["_eval", "_default", "transfer", "addController", "removeController", "setRecord", "removeRecord", "setName", "setTicker", "setDescription", "setKeywords", "setLogo", "initializeState", "releaseName", "reassignName", "approvePrimaryName", "removePrimaryNames"];
+export declare const AntWriteHandlers: readonly ["_eval", "_default", "transfer", "addController", "removeController", "setRecord", "removeRecord", "setName", "setTicker", "setDescription", "setKeywords", "setLogo", "initializeState", "releaseName", "reassignName", "approvePrimaryName", "removePrimaryNames", "transferRecordOwnership"];
 export type AoANTWriteHandler = (typeof AntWriteHandlers)[number];
-export declare const AntHandlerNames: ("controllers" | "records" | "balances" | "balance" | "totalSupply" | "info" | "record" | "state" | "_eval" | "_default" | "transfer" | "addController" | "removeController" | "setRecord" | "removeRecord" | "setName" | "setTicker" | "setDescription" | "setKeywords" | "setLogo" | "initializeState" | "releaseName" | "reassignName" | "approvePrimaryName" | "removePrimaryNames")[];
+export declare const AntHandlerNames: ("controllers" | "records" | "balances" | "balance" | "totalSupply" | "info" | "record" | "state" | "_eval" | "_default" | "transfer" | "addController" | "removeController" | "setRecord" | "removeRecord" | "setName" | "setTicker" | "setDescription" | "setKeywords" | "setLogo" | "initializeState" | "releaseName" | "reassignName" | "approvePrimaryName" | "removePrimaryNames" | "transferRecordOwnership")[];
 export type AoANTHandler = AoANTWriteHandler | AoANTReadHandler;
 export declare const AntHandlersSchema: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
 export declare const AntInfoSchema: z.ZodObject<{
@@ -264,6 +344,20 @@ export interface AoANTRead {
     }, opts?: AntReadOptions): Promise<number>;
     getBalances(opts?: AntReadOptions): Promise<Record<WalletAddress, number>>;
     getHandlers(): Promise<AoANTHandler[]>;
+    getModuleId(opts?: {
+        graphqlUrl?: string;
+        retries?: number;
+    }): Promise<string>;
+    getVersion(opts?: {
+        antRegistryId?: string;
+        graphqlUrl?: string;
+        retries?: number;
+    }): Promise<string>;
+    isLatestVersion(opts?: {
+        antRegistryId?: string;
+        graphqlUrl?: string;
+        retries?: number;
+    }): Promise<boolean>;
 }
 export interface AoANTWrite extends AoANTRead {
     transfer: AoWriteAction<{
@@ -320,11 +414,39 @@ export interface AoANTWrite extends AoANTRead {
         arioProcessId: string;
         notifyOwners?: boolean;
     }>;
+    upgrade(params?: {
+        arioProcessId?: string;
+        antRegistryId?: string;
+        skipVersionCheck?: boolean;
+        onSigningProgress?: (name: keyof UpgradeAntProgressEvent, payload: UpgradeAntProgressEvent[keyof UpgradeAntProgressEvent]) => void;
+    } & ({
+        names: string[];
+        reassignAffiliatedNames?: false;
+    } | {
+        names?: never;
+        reassignAffiliatedNames?: true;
+    })): Promise<{
+        forkedProcessId: string;
+        reassignedNames: Record<string, AoMessageResult>;
+        failedReassignedNames: Record<string, {
+            id?: string;
+            error: Error;
+        }>;
+    }>;
+    transferRecord: AoWriteAction<{
+        undername: string;
+        recipient: string;
+    }>;
 }
 export type AoANTSetBaseNameRecordParams = {
     transactionId: string;
     ttlSeconds: number;
     priority?: number;
+    owner?: string;
+    displayName?: string;
+    logo?: string;
+    description?: string;
+    keywords?: string[];
 };
 export type AoANTSetUndernameRecordParams = AoANTSetBaseNameRecordParams & {
     undername: string;