从零搭建 Amiko 受控金库｜Solidity 链下签名链上执行实战

前言

本文基于OpenZeppelin V5 + Solidity 0.8.24原版开发调试，打造出签名式受控金库合约系统，实操性拉满、安全合规、适配各类Web3项目落地。

核心核心逻辑超级简单好懂：链下系统做决策签名，链上合约只做验证执行。不用把复杂逻辑写进合约、不高额耗Gas、不泄露私钥资产，完美适配机器人自动化、Web3游戏、DAO财务管理、DeFi量化交易等所有主流场景，新手也能直接部署即用。

一、四大核心落地使用场景

1、DeFi自动化量化交易&策略跟单

量化套利、多因子交易这类复杂策略，不适合写在智能合约里，Gas成本太高还容易触发风控。咱们直接把策略大脑放在链下服务器运行，量化算法触发买卖信号后，自动生成合规签名，金库合约收到有效签名，才会自动完成DEX资产划转交易。

核心安全亮点：所有资产全程锁在金库合约内，链下机器人只有签名权限，没有资产私钥控制权。就算服务器意外被攻击，黑客也只能执行预设合规策略，绝对没法盗走金库资产，安全性拉满。

2、Web3意图交易代付模式

用户不用自己操作复杂交易路径，只需要提交交易结果意愿就行。比如用户签署授权：自愿用1个ETH兑换足额USDT，专业链上求解器自动匹配最优交易路径，带上用户合规签名，调用金库合约完成交易即可。

实用核心：支持第三方中继器代为支付Gas费用，用户零Gas就能完成链上交易，体验拉满，也是当下Web3主流合规交易新模式。

3、Web3游戏&元宇宙经济系统

Web3游戏频繁链上交互，不仅影响玩家体验，还会产生大量Gas消耗。这套金库合约完美解决痛点：玩家通关、打怪完成游戏任务后，游戏后端服务器验证战绩合规后，自动生成专属掉落奖励签名。玩家凭有效签名，就能去合约一键领取代币、道具铸造或转账奖励。

核心作用：严格防作弊，只有官方授权后台认可的有效游戏战绩，合约才会发放对应奖励，杜绝恶意薅空投、刷道具行为。

4、DAO/团队企业级财务分权管理

初创Web3团队、DAO组织财务管理必备，完美实现财务审批和链上执行分离。财务负责人离线审核工资、转账账单后，生成批量合规签名；技术人员或自动化脚本，只负责把签名提交链上即可完成转账发放。

双重安全保障：签名设置有效期防止过期滥用，专属随机数避免重复转账发薪，搭配权限管控，只有指定财务负责人能签署有效指令，资金流转全程可追溯、合规可控。

---

场景对比总结表

场景名称	核心需求	authorizedSigner 身份
量化交易	极速响应、逻辑解耦	自动化量化脚本 (Bot)
资产领取	防作弊、低 Gas 交互	游戏后台/中心化服务器
代付方案	用户无 Gas 体验	中继器 (Relayer)
智能体金库	硬件隔离、自主权	TEE 隔离区中的私钥

二、智能合约

A. 权限代币合约：AmikoToken.sol

使用 OZ V5 的 AccessControl，明确定义了“铸币者”角色。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import {ERC20} from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import {ERC20Permit} from "@openzeppelin/contracts/token/ERC20/extensions/ERC20Permit.sol";
import {AccessControl} from "@openzeppelin/contracts/access/AccessControl.sol";

contract AmikoToken is ERC20, ERC20Permit, AccessControl {
    bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE");

    constructor(address admin) 
        ERC20("Amiko Token", "AKT") 
        ERC20Permit("Amiko Token") 
    {
        // 初始角色分配
        _grantRole(DEFAULT_ADMIN_ROLE, admin);
        _grantRole(MINTER_ROLE, admin);
    }

    function mint(address to, uint256 amount) external {
        require(hasRole(MINTER_ROLE, msg.sender), "Caller is not a minter");
        _mint(to, amount);
    }
}

B. 签名验证金库：AmikoVault.sol

这是核心业务逻辑。金库本身不具备“意识”，它只在验证了来自特定地址（authorizedSigner）的有效 EIP-712 签名后才释放资产。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import {SafeERC20, IERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import {ECDSA} from "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
import {EIP712} from "@openzeppelin/contracts/utils/cryptography/EIP712.sol";
import {Nonces} from "@openzeppelin/contracts/utils/Nonces.sol";

contract AmikoVault is EIP712, Nonces {
    using SafeERC20 for IERC20;
    using ECDSA for bytes32;

    address public immutable authorizedSigner; // 授权的外部执行者地址

    bytes32 private constant _EXECUTE_TYPEHASH = 
        keccak256("ExecuteAction(address token,address to,uint256 amount,uint256 nonce,uint256 deadline)");

    event ActionExecuted(address indexed token, address indexed to, uint256 amount);

    constructor(address _signer) EIP712("AmikoVault", "1") {
        authorizedSigner = _signer;
    }

    /**
     * @notice 执行由授权签名者批准的转账
     */
    function executeAction(
        address token,
        address to,
        uint256 amount,
        uint256 deadline,
        bytes calldata signature
    ) external {
        require(block.timestamp <= deadline, "Amiko: Action expired");

        // 构建并校验 EIP-712 结构化数据
        bytes32 structHash = keccak256(
            abi.encode(_EXECUTE_TYPEHASH, token, to, amount, _useNonce(authorizedSigner), deadline)
        );
        bytes32 hash = _hashTypedDataV4(structHash);

        address signer = hash.recover(signature);
        require(signer == authorizedSigner, "Amiko: Invalid signature");

        // 执行资产划转
        IERC20(token).safeTransfer(to, amount);
        
        emit ActionExecuted(token, to, amount);
    }

    receive() external payable {}
}

---

三、测试脚本 (Amiko.test.ts)

该脚本利用 Viem 模拟了外部系统签署指令并提交给合约的全过程。

import assert from "node:assert/strict";
import { describe, it, beforeEach } from "node:test";
import { parseEther } from 'viem';
import { network } from "hardhat";

describe("Amiko Smart Contract Suite", async function () {
    let publicClient: any;
    let admin: any, signer: any, user: any;
    let token: any, vault: any;

    beforeEach(async function () {
        const { viem } = await network.connect();
        publicClient = await viem.getPublicClient();
        [admin, signer, user] = await viem.getWalletClients();

        // 部署代币
        token = await viem.deployContract("AmikoToken", [admin.account.address]);
        
        // 部署金库，指定授权签名地址
        vault = await viem.deployContract("AmikoVault", [signer.account.address]);

        // 给金库注资
        const hash = await admin.writeContract({
            address: token.address,
            abi: token.abi,
            functionName: "mint",
            args: [vault.address, parseEther("1000")],
        });
        await publicClient.waitForTransactionReceipt({ hash });
    });

    it("应该能够通过有效的外部签名执行转账", async function () {
        const amount = parseEther("50");
        const deadline = BigInt(Math.floor(Date.now() / 1000) + 3600);
        const nonce = await publicClient.readContract({
            address: vault.address,
            abi: vault.abi,
            functionName: "nonces",
            args: [signer.account.address],
        });

        // 准备签名数据
        const domain = {
            name: 'AmikoVault',
            version: '1',
            chainId: await publicClient.getChainId(),
            verifyingContract: vault.address,
        };

        const types = {
            ExecuteAction: [
                { name: 'token', type: 'address' },
                { name: 'to', type: 'address' },
                { name: 'amount', type: 'uint256' },
                { name: 'nonce', type: 'uint256' },
                { name: 'deadline', type: 'uint256' },
            ],
        };

        const signature = await signer.signTypedData({
            domain,
            types,
            primaryType: 'ExecuteAction',
            message: { token: token.address, to: user.account.address, amount, nonce, deadline },
        });

        // 链上执行
        await admin.writeContract({
            address: vault.address,
            abi: vault.abi,
            functionName: "executeAction",
            args: [token.address, user.account.address, amount, deadline, signature],
        });

        const finalBalance = await publicClient.readContract({
            address: token.address,
            abi: token.abi,
            functionName: "balanceOf",
            args: [user.account.address],
        });

        assert.equal(finalBalance, amount);
    });
});

四、部署脚本

// scripts/deploy.js
import { network, artifacts } from "hardhat";
async function main() {
  // 连接网络
  const { viem } = await network.connect({ network: network.name });//指定网络进行链接
  
  // 获取客户端
  const [deployer,agent] = await viem.getWalletClients();
  const publicClient = await viem.getPublicClient();
 
  const deployerAddress = deployer.account.address;
   console.log("部署者的地址:", deployerAddress);
  // 加载合约
  const AmikoTokenArtifact = await artifacts.readArtifact("AmikoToken");

 
  // 部署
  const AmikoTokenHash = await deployer.deployContract({
    abi: AmikoTokenArtifact.abi,//获取abi
    bytecode: AmikoTokenArtifact.bytecode,//硬编码
    args: [deployerAddress],
  });
   const AmikoTokenReceipt = await publicClient.waitForTransactionReceipt({ hash: AmikoTokenHash });
   console.log("AmikoToken合约地址:", AmikoTokenReceipt.contractAddress);
  const AmikoVaultArtifact = await artifacts.readArtifact("AmikoVault");

 
  // 部署
  const AmikoVaultHash = await deployer.deployContract({
    abi: AmikoVaultArtifact.abi,//获取abi
    bytecode: AmikoVaultArtifact.bytecode,//硬编码
    args: [agent.account.address],
  });
   const AmikoVaultReceipt = await publicClient.waitForTransactionReceipt({ hash: AmikoVaultHash });
   console.log("AmikoVault合约地址:", AmikoVaultReceipt.contractAddress);
}

main().catch(console.error);

总结

1、安全核心：资产链上合约托管，签名链下生成，私钥和资产控制权分离，从根源规避盗币、黑客攻击风险；

2、适配性强：DeFi量化、Web3游戏、DAO财务、意图交易全场景通用，OpenZeppelin V5原版库开发，无安全漏洞、合规稳定；

3、实操性高：全套合约、测试脚本、部署脚本配齐，复制即可编译测试、一键上线部署，无需复杂二次开发。