Serbisyo ng Pangalan
Rehistro ng pangalan
Ang pagpapatala ng pangalan ay nag-iimbak ng impormasyon tungkol sa pangalan ng domain. Ito ay gawa sa dalawang bagay:
- Ang header
- Ang data
Ang data para sa isang domain name ay palaging prefix ng header, sa ibaba ay ang istraktura ng header sa JS:
import { PublicKey } from "@solana/web3.js";
import { Schema } from "borsh";
export class NameRegistryState {
  parentName: PublicKey;
  owner: PublicKey;
  class: PublicKey;
  data: Buffer | undefined;
  static HEADER_LEN = 96;
  static schema: Schema = new Map([
    [
      NameRegistryState,
      {
        kind: "struct",
        fields: [
          ["parentName", [32]],
          ["owner", [32]],
          ["class", [32]],
        ],
      },
    ],
  ]);
  constructor(obj: {
    parentName: Uint8Array;
    owner: Uint8Array;
    class: Uint8Array;
  }) {
    this.parentName = new PublicKey(obj.parentName);
    this.owner = new PublicKey(obj.owner);
    this.class = new PublicKey(obj.class);
  }
}
export class NameRegistryState {
  parentName: PublicKey;
  owner: PublicKey;
  class: PublicKey;
  data: Buffer | undefined;
  static HEADER_LEN = 96;
  static schema: Schema = new Map([
    [
      NameRegistryState,
      {
        kind: "struct",
        fields: [
          ["parentName", [32]],
          ["owner", [32]],
          ["class", [32]],
        ],
      },
    ],
  ]);
  constructor(obj: {
    parentName: Uint8Array;
    owner: Uint8Array;
    class: Uint8Array;
  }) {
    this.parentName = new PublicKey(obj.parentName);
    this.owner = new PublicKey(obj.owner);
    this.class = new PublicKey(obj.class);
  }
}
Pag-resolve ng mga domain ng SOL
Ang mga .SOL na domain ay natatangi, pang-tao na mga pangalan ng domain na nagko-convert sa publicKeys. Ginagamit ito ng maraming wallet bilang isa pang opsyon upang magpadala ng mga token o SOL. Maaari kang mag-convert .SOL na mga domain sa kanilang publicKey na may sumusunod:
import {
  getHashedName,
  getNameAccountKey,
  NameRegistryState,
} from "@bonfida/spl-name-service";
import { Connection, clusterApiUrl, PublicKey } from "@solana/web3.js";
(async () => {
  const domain = "levi.sol";
  const hashedName = await getHashedName(domain.replace(".sol", ""));
  const nameAccountKey = await getNameAccountKey(
    hashedName,
    undefined,
    new PublicKey("58PwtjSDuFHuUkYjH9BYnnQKHfwo9reZhC2zMJv9JPkx") // SOL TLD Authority
  );
  const owner = await NameRegistryState.retrieve(
    new Connection(clusterApiUrl("mainnet-beta")),
    nameAccountKey
  );
  console.log(owner.registry.owner.toBase58());
  // JUskoxS2PTiaBpxfGaAPgf3cUNhdeYFGMKdL6mZKKfR
})();
const domain = "levi.sol";
const hashedName = await getHashedName(domain.replace(".sol", ""));
const nameAccountKey = await getNameAccountKey(
  hashedName,
  undefined,
  new PublicKey("58PwtjSDuFHuUkYjH9BYnnQKHfwo9reZhC2zMJv9JPkx") // SOL TLD Authority
);
const owner = await NameRegistryState.retrieve(
  new Connection(clusterApiUrl("mainnet-beta")),
  nameAccountKey
);
console.log(owner.registry.owner.toBase58());
// JUskoxS2PTiaBpxfGaAPgf3cUNhdeYFGMKdL6mZKKfR
Reverse lookup
Magagamit ito upang malutas ang pangalan ng domain mula sa pampublikong key nito
import { performReverseLookup } from "@bonfida/spl-name-service";
import { PublicKey, Connection, clusterApiUrl } from "@solana/web3.js";
async () => {
  const connection = new Connection(clusterApiUrl("mainnet-beta"));
  // Public key of bonfida.sol
  const domainKey = new PublicKey(
    "Crf8hzfthWGbGbLTVCiqRqV5MVnbpHB1L9KQMd6gsinb"
  );
  const domainName = await performReverseLookup(connection, domainKey); // bonfida
};
// Public key of bonfida.sol
const domainKey = new PublicKey("Crf8hzfthWGbGbLTVCiqRqV5MVnbpHB1L9KQMd6gsinb");
const domainName = await performReverseLookup(connection, domainKey); // bonfida
Hanapin ang subdomain
Upang malutas ang isang subdomain kailangan mong:
- Kunin ang parent domain key
- Kunin ang subdomain key
- Kunin ang impormasyon ng account
import {
  getHashedName,
  getNameAccountKey,
  NameRegistryState,
  getDNSRecordAddress,
} from "@bonfida/spl-name-service";
import { Connection, clusterApiUrl, PublicKey } from "@solana/web3.js";
async () => {
  const SOL_TLD_AUTHORITY = new PublicKey(
    "58PwtjSDuFHuUkYjH9BYnnQKHfwo9reZhC2zMJv9JPkx"
  );
  const connection = new Connection(clusterApiUrl("mainnet-beta"));
  // Resolution of demo.bonfida.sol
  const parentDomain = "bonfida";
  const subDomain = "demo";
  // Step 1
  const hashedParentDomain = await getHashedName(parentDomain);
  const parentDomainKey = await getNameAccountKey(
    hashedParentDomain,
    undefined,
    SOL_TLD_AUTHORITY
  );
  // Step 2
  const subDomainKey = await getDNSRecordAddress(parentDomainKey, subDomain);
  // Step 3
  const registry = await NameRegistryState.retrieve(connection, subDomainKey);
};
const parentDomain = "bonfida";
const subDomain = "demo";
// Step 1
const hashedParentDomain = await getHashedName(parentDomain);
const parentDomainKey = await getNameAccountKey(
  hashedParentDomain,
  undefined,
  SOL_TLD_AUTHORITY
);
// Step 2
const subDomainKey = await getDNSRecordAddress(parentDomainKey, subDomain);
// Step 3
const registry = await NameRegistryState.retrieve(connection, subDomainKey);
Hanapin ang lahat ng domain name na pagmamay-ari ng isang pampublikong key
Makukuha mo ang lahat ng domain name ng isang wallet sa pamamagitan ng paggawa ng kahilingan sa getProgramAccounts na may filter na memcmp
import { Connection, PublicKey } from "@solana/web3.js";
import { NAME_PROGRAM_ID } from "@bonfida/spl-name-service";
export async function findOwnedNameAccountsForUser(
  connection: Connection,
  userAccount: PublicKey
): Promise<PublicKey[]> {
  const filters = [
    {
      memcmp: {
        offset: 32,
        bytes: userAccount.toBase58(),
      },
    },
  ];
  const accounts = await connection.getProgramAccounts(NAME_PROGRAM_ID, {
    filters,
  });
  return accounts.map((a) => a.publicKey);
}
export async function findOwnedNameAccountsForUser(
  connection: Connection,
  userAccount: PublicKey
): Promise<PublicKey[]> {
  const filters = [
    {
      memcmp: {
        offset: 32,
        bytes: userAccount.toBase58(),
      },
    },
  ];
  const accounts = await connection.getProgramAccounts(NAME_PROGRAM_ID, {
    filters,
  });
  return accounts.map((a) => a.publicKey);
}
Lutasin ang isang Twitter handle
Ang mga handle ng Twitter ay maaaring nakarehistro sa serbisyo ng pangalan ng Solana at magamit tulad ng mga .SOL na domain name
import { PublicKey, clusterApiUrl, Connection } from "@solana/web3.js";
import { getHandleAndRegistryKey } from "@bonfida/spl-name-service";
async () => {
  const connection = new Connection(clusterApiUrl("mainnet-beta"));
  // Pubkey of the wallet you want to retrieve the Twitter handle
  const pubkey = new PublicKey("FidaeBkZkvDqi1GXNEwB8uWmj9Ngx2HXSS5nyGRuVFcZ");
  const [handle, registryKey] = await getHandleAndRegistryKey(
    connection,
    pubkey
  );
};
// Pubkey of the wallet you want to retrieve the Twitter handle
const pubkey = new PublicKey("FidaeBkZkvDqi1GXNEwB8uWmj9Ngx2HXSS5nyGRuVFcZ");
const [handle, registryKey] = await getHandleAndRegistryKey(connection, pubkey);
Baliktarin ang paghahanap ng isang Twitter handle
Upang mahanap ang SOL address na nauugnay sa isang Twitter handle maaari kang magsagawa ng reverse look up
import { getTwitterRegistry } from "@bonfida/spl-name-service";
import { Connection, clusterApiUrl } from "@solana/web3.js";
async () => {
  const handle = "bonfida";
  const connection = new Connection(clusterApiUrl("mainnet-beta"));
  const registry = await getTwitterRegistry(connection, handle);
};
const handle = "bonfida";
const registry = await getTwitterRegistry(connection, handle);