概述

本指南展示如何使用 SDK 执行 Æternity 命名系统 (AENS) 生命周期中的所有操作。

认领 AENS 域名需要至少 2 笔交易：

Pre-claim 预认领

import { AeSdk, Name } from '@aeternity/aepp-sdk';

const aeSdk = new AeSdk({ ... }); // 初始化 SDK

// getContext() 用于绑定 AeSdk 到 Name 实例
const name = new Name('myname.chain', aeSdk.getContext());

const preClaimTx = await name.preclaim();
console.log(preClaimTx);
/*
{
  blockHeight: 449499,
  hash: 'th_48RktjEutZC8TCubaq9YhjaF1cKLV9D3VRCJyzJLs7oSp4Ry6',
  tx: {
    accountId: 'ak_...',
    commitmentId: 'cm_...',
    type: 'NamePreclaimTx',
    ...
  }
}
*/

Claim 认领

根据域名（punycode）长度决定结果：

• 长度 > 12：立即获得所有权
• 长度 ≤ 12：启动竞价拍卖

// SDK 自动计算最低 nameFee
// 如需自定义，可通过选项传入
const claimTx = await name.claim();
console.log(claimTx);
/*
{
  blockHeight: 449507,
  hash: 'th_2sWNusGUf2wuRn7d453wPWTAe8pKVbtNF4DqakvippsxjvF8g1',
  tx: {
    name: 'myname.chain',
    nameFee: 2865700000000000000n,
    type: 'NameClaimTx',
    ...
  }
}
*/

竞价出价

如果域名处于拍卖中，需要出价竞标：

import { computeBidFee, computeAuctionEndBlock } from '@aeternity/aepp-sdk';

const name = new Name('short.chain', aeSdk.getContext());

const startFee = ...; // 从中间件获取当前最高出价
const increment = 0.05; // 5%，最低加价幅度

// 计算出价金额
const nameFee = computeBidFee(name.value, { startFee, increment });
const bidTx = await name.bid(nameFee);

console.log(`出价区块: ${bidTx.blockHeight}`);
console.log(`拍卖结束区块: ${computeAuctionEndBlock(name.value, bidTx.blockHeight)}`);

拥有域名后，你可以：

• 设置指向 账户、预言机、合约、通道 的指针，或存储二进制数据
• 延长 TTL 以防过期（最长 180,000 区块）

设置指针和更新 TTL

import { getDefaultPointerKey, encode, Encoding } from '@aeternity/aepp-sdk';

const oracle = 'ok_...';
const pointers = {
  account_pubkey: 'ak_...', // 账户指针
  oracle_pubkey: oracle,     // 预言机指针
  contract_pubkey: 'ct_...', // 合约指针
  channel: 'ch_...',         // 通道指针
  customKey: encode(Buffer.from('自定义数据'), Encoding.Bytearray),
};

const nameUpdateTx = await name.update(pointers);
console.log(nameUpdateTx);

仅延长 TTL（保留指针）

// 延长到 100000 个区块
const nameUpdateTx = await name.extendTtl(100000);
console.log(nameUpdateTx);

将域名所有权转让给另一个账户：

const recipient = 'ak_...'; // 接收方地址
const nameTransferTx = await name.transfer(recipient);
console.log(nameTransferTx);
/*
{
  tx: {
    recipientId: 'ak_...',
    nameId: 'nm_...',
    type: 'NameTransferTx',
    ...
  }
}
*/

在过期前主动撤销域名：

const nameRevokeTx = await name.revoke();
console.log(nameRevokeTx);
/*
{
  tx: {
    nameId: 'nm_...',
    type: 'NameRevokeTx',
    ...
  }
}
*/

可以授权 Sophia 合约代表你的账户管理 AENS 域名。这可用于构建 AENS 市场等应用。

import { packDelegation, DelegationTag } from '@aeternity/aepp-sdk';

const contractAddress = 'ct_...';
const nameId = 'example.chain';

const commonParams = {
  contractAddress,
  accountAddress: aeSdk.address,
};

// 授权合约执行 pre-claim
let delegation = packDelegation({ 
  tag: DelegationTag.AensPreclaim, 
  ...commonParams 
});

// 授权合约管理特定域名的所有操作
delegation = packDelegation({ 
  tag: DelegationTag.AensName, 
  nameId, 
  ...commonParams 
});

// 授权合约管理你拥有的所有域名（通配符）
delegation = packDelegation({ 
  tag: DelegationTag.AensWildcard, 
  ...commonParams 
});

// 生成委托签名
const delegationSignature = await aeSdk.signDelegation(delegation);