@avalanche-sdk/client/src/methods/admin/aliasChain.ts

A TypeScript SDK for interacting with the Avalanche network through JSON-RPC APIs. This SDK provides a comprehensive set of tools to interact with all Avalanche chains (P-Chain, X-Chain, C-Chain) and various APIs, including wallet functionality for transa

import { Chain, Transport } from "viem";
import {
  AvalancheCoreClient,
  AvalancheCoreClient as Client,
} from "../../clients/createAvalancheCoreClient.js";
import { AdminRpcSchema } from "./adminRpcSchema.js";
import { AliasChainParameters } from "./types/aliasChain.js";

/**
 * Give a blockchain an alias, a different name that can be used any place the blockchain's ID is used.
 * Note: The alias is set for each chain on each node individually.
 *
 * - Docs: https://build.avax.network/docs/api-reference/admin-api#adminaliaschain
 *
 * @param client - The client to use. {@link AvalancheCoreClient}
 * @param params - The chain and alias. {@link AliasChainParameters}
 * @returns Promise that resolves when the chain alias is set
 *
 * @example
 * ```ts
 * import { createAvalancheCoreClient } from '@avalanche-sdk/client'
 * import { avalanche } from '@avalanche-sdk/client/chains'
 * import { aliasChain } from '@avalanche-sdk/client/methods/admin'
 *
 * const client = createAvalancheCoreClient({
 *   chain: avalanche,
 *   transport: {
 *     type: "http",
 *     url: "<url>",
 *   },
 * });
 *
 * await aliasChain(client, {
 *   chain: "sV6o671RtkGBcno1FiaDbVcFv2sG5aVXMZYzKdP4VQAWmJQnM",
 *   alias: "myBlockchainAlias"
 * });
 * ```
 */
export async function aliasChain<chain extends Chain | undefined>(
  client: Client<Transport, chain>,
  params: AliasChainParameters
): Promise<void> {
  return client.request<
    AdminRpcSchema,
    {
      method: "admin.aliasChain";
      params: AliasChainParameters;
    },
    void
  >({
    method: "admin.aliasChain",
    params: params,
  });
}