登录从零搭建 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、实操性高：全套合约、测试脚本、部署脚本配齐，复制即可编译测试、一键上线部署，无需复杂二次开发。
