feat(ant): support releasing of name of ANTs

Permabought names can be released by the ANT owner. They will go into auction and if a bid is received, it will be split between the owner at the time of the release and the protocol balance. Otherwise, the name will be returned and can be reregistered by anyone.

src/common/ant.ts

@@ -457,7 +457,7 @@ export class AoANTWriteable extends AoANTReadable implements AoANTWrite {
    * @returns {Promise<AoMessageResult>} The result of the interaction.
    * @example
    * ```ts
-   * ant.setName({ name: "ships at sea" });
+   * ant.setName({ name: "test" }); // results in the resolution of `test_<apexName>.ar.io`
    * ```
    */
   async setName(
@@ -473,4 +473,28 @@ export class AoANTWriteable extends AoANTReadable implements AoANTWrite {
       signer: this.signer,
     });
   }
+
+  /**
+   * @param name @type {string} The name you want to release. The name will be put up for auction on the IO contract. 50% of the winning bid will be distributed to the ANT owner at the time of release. If no bids, the name will be released and can be reregistered by anyone.
+   * @param ioProcessId @type {string} The processId of the IO contract. This is where the ANT will send the message to release the name.
+   * @returns {Promise<AoMessageResult>} The result of the interaction.
+   * @example
+   * ```ts
+   * ant.releaseName({ name: "ardrive", ioProcessId: IO_TESTNET_PROCESS_ID });
+   * ```
+   */
+  async releaseName(
+    { name, ioProcessId }: { name: string; ioProcessId: string },
+    options?: WriteOptions,
+  ): Promise<AoMessageResult> {
+    return this.process.send({
+      tags: [
+        ...(options?.tags ?? []),
+        { name: 'Action', value: 'Release-Name' },
+        { name: 'Name', value: name },
+        { name: 'IO-Process-Id', value: ioProcessId },
+      ],
+      signer: this.signer,
+    });
+  }
 }

src/types/ant.ts

@@ -226,4 +226,8 @@ export interface AoANTWrite extends AoANTRead {
     { name }: { name: string },
     options?: WriteOptions,
   ): Promise<AoMessageResult>;
+  releaseName(
+    { name, ioProcessId }: { name: string; ioProcessId: string },
+    options?: WriteOptions,
+  ): Promise<AoMessageResult>;
 }