Upgrade

upgrade()

Upgrades an ANT by forking it to the latest version from the ANT registry and optionally reassigning ArNS names to the new process. This function first checks the version of the existing ANT, creates a new ANT using .fork() to the latest version, and then reassigns the ArNS names affiliated with this process to the new process.

Note: Requires signer to be provided on ANT.init to sign the transaction.

// Upgrade ANT and reassign all affiliated ArNS names to the new process
const result = await ant.upgrade();

// Upgrade ANT and reassign specific ArNS names to the new process
const result = await ant.upgrade({
  names: ['ardrive', 'example'],
});

// with callbacks
const result = await ant.upgrade({
  names: ['ardrive', 'example'],
  onSigningProgress: (event, payload) => {
    console.log(`${event}:`, payload);
    if (event === 'checking-version') {
      console.log(`Checking version: ${payload.antProcessId}`);
    }
    if (event === 'fetching-affiliated-names') {
      console.log(`Fetching affiliated names: ${payload.arioProcessId}`);
    }
    if (event === 'reassigning-name') {
      console.log(`Reassigning name: ${payload.name}`);
    }
    if (event === 'validating-names') {
      console.log(`Validating names: ${payload.names}`);
    }
    // other callback events...
  },
});

console.log(`Upgraded to process: ${result.forkedProcessId}`);
console.log(`Successfully reassigned names: ${result.reassignedNames}`);
console.log(`Failed to reassign names: ${result.failedReassignedNames}`);

Parameters:

• reassignAffiliatedNames?: boolean - If true, reassigns all names associated with this process to the new forked process (defaults to true when names is empty)
• names?: string[] - Optional array of specific names to reassign (cannot be used with reassignAffiliatedNames: true). These names must be affiliated with this ANT on the provided ARIO process.
• arioProcessId?: string - Optional ARIO process ID (defaults to mainnet)
• antRegistryId?: string - Optional ANT registry process ID used to resolve the latest version (defaults to mainnet registry)
• skipVersionCheck?: boolean - Skip checking if ANT is already latest version (defaults to false)
• onSigningProgress?: Function - Optional progress callback for tracking upgrade steps

Returns: Promise<{ forkedProcessId: string, reassignedNames: Record<string, AoMessageResult>, failedReassignedNames: Record<string, { id?: string; error: Error }> }>