Terra 项目智能合约费用分成机制注册指南

费用分成模块概述

在 Terra 生态系统中，智能合约开发者可以通过 x/FeeShare 模块获得与其合约交互产生的部分交易费用。这一机制为开发者提供了额外的收入来源，激励他们构建高质量的智能合约。本文将详细介绍如何在 Terra 区块链上注册智能合约以参与费用分成。

注册现有合约

使用 Terrad 命令行工具

Terrad 是 Terra 区块链的官方命令行工具，可用于注册合约参与费用分成。执行注册操作的用户必须是合约的管理员或创建者。

terrad tx feeshare [合约地址] [提现地址] --from [您的地址]

参数说明：

• 合约地址：已部署智能合约的区块链地址
• 提现地址：接收分成费用的目标地址
• 您的地址：执行注册操作的签名者地址

使用 JSON 消息

开发者也可以直接构造 JSON 格式的交易消息进行注册：

{
  "@type": "/juno.feeshare.v1.MsgRegisterFeeShare",
  "contract_address": "terra1w8ta7vhpzwe0y99tvvtp7k0k8uex2jq8jts8k2hsyg009ya06qts5fwftt",
  "deployer_address": "terra1880xn49l4x947pjv4a9k2qe5mf423kjzkn4ceu",
  "withdrawer_address": "terra1zdpgj8am5nqqvht927k3etljyl6a52kwqup0je"
}

使用 Feather.js SDK

对于习惯使用 JavaScript 的开发者，可以通过 Feather.js SDK 实现合约注册：

import { LCDClient, MnemonicKey, MsgRegisterFeeShare } from "@terra-money/feather.js";

// 初始化环境
const lcd = LCDClient.fromDefaultConfig("testnet");
const mnemonic = new MnemonicKey({ mnemonic: "..." });
const deployerAddr = mnemonic.accAddress("terra");
const withdrawerAddr = mnemonic.accAddress("terra");
const wallet = lcd.wallet(mnemonic);
const contractAddr = "terra1eaxcahzxp0x8wqejqjlqaey53tp06l728qad6z395lyzgl026qkq20xj43";

(async () => {
    try {
        // 创建并签署费用分成注册交易
        let tx = await wallet.createAndSignTx({
            msgs: [new MsgRegisterFeeShare(
                contractAddr,
                deployerAddr,
                withdrawerAddr
            )],
            chainID: "pisco-1",
            memo: "Registering feeshare"
        });
        let result = await lcd.tx.broadcastSync(tx, "test-1");
        console.log("Transaction Hash", result.txhash);
    } catch (e) {
        console.log(e);
    }
})();

部署新合约并注册

开发者可以在合约部署的同时完成费用分成注册，以下是完整流程：

环境准备

import { getMnemonics } from "../helpers/mnemonics";
import { getLCDClient } from "../helpers/lcd.connection";
import { Coins, Fee, MnemonicKey, MsgExecuteContract, 
         MsgInstantiateContract, MsgRegisterFeeShare, 
         MsgStoreCode } from "@terra-money/feather.js";

// 初始化LCD客户端和钱包
const LCD = getLCDClient();
const accounts = getMnemonics();
const wallet = LCD.chain1.wallet(accounts.feeshareMnemonic);
const deployerAddress = accounts.feeshareMnemonic.accAddress("terra");
const withdrawerAddress = new MnemonicKey().accAddress("terra");
let contractAddress: string;

合约部署流程

1. 存储合约代码：

// 读取合约WASM文件并存储到链上
let tx = await wallet.createAndSignTx({
    msgs: [new MsgStoreCode(
        deployerAddress,
        fs.readFileSync(path.join(__dirname, "/../contracts/reflect.wasm")).toString("base64")
    )],
    chainID: "test-1"
});
let result = await LCD.chain1.tx.broadcastSync(tx, "test-1");
let codeId = Number(txResult.logs[0].events[1].attributes[1].value);

2. 实例化合约：

// 使用存储的代码ID实例化合约
tx = await wallet.createAndSignTx({
    msgs: [new MsgInstantiateContract(
        deployerAddress,
        deployerAddress,
        codeId,
        {},
        Coins.fromString("1uluna"),
        "Reflect contract " + Math.random()
    )],
    chainID: "test-1"
});
result = await LCD.chain1.tx.broadcastSync(tx, "test-1");
contractAddress = txResult.logs[0].eventsByType.instantiate._contract_address[0];

注册费用分成

// 注册合约参与费用分成
tx = await wallet.createAndSignTx({
    msgs: [new MsgRegisterFeeShare(
        contractAddress,
        deployerAddress,
        withdrawerAddress
    )],
    chainID: "test-1"
});
result = await LCD.chain1.tx.broadcastSync(tx, "test-1");

验证分成机制

1. 执行合约交易：

// 发送执行消息并附加交易费用
let msgExecute = new MsgExecuteContract(
    deployerAddress,
    contractAddress,
    { change_owner: { owner: withdrawerAddress } }
);
tx = await wallet.createAndSignTx({
    msgs: [msgExecute],
    chainID: "test-1",
    fee: new Fee(200_000, "400000uluna")
});
result = await LCD.chain1.tx.broadcastSync(tx, "test-1");

2. 验证分成结果：

// 查询提现地址余额验证分成是否到账
const bankAmount = await LCD.chain1.bank.balance(withdrawerAddress);
expect(bankAmount[0]).toMatchObject(Coins.fromString("200000uluna"));

技术要点解析

1. 权限控制：只有合约管理员或创建者才能注册费用分成，确保合约安全性。

2. 分成比例：默认情况下，费用分成比例为50%，即合约交互产生的一半交易费用会分配给注册的提现地址。

3. 交易费用：注册操作本身会产生区块链交易费用，开发者需要确保账户中有足够的代币支付gas费。

4. 合约状态：注册成功后，合约的每次交互都会自动执行费用分成，无需额外操作。

通过合理利用Terra的费用分成机制，开发者可以为其智能合约创造可持续的收入来源，同时为Terra生态系统贡献价值。