
一.主要内容
-
跨链桥的基本概念
-
跨链桥的项目架构
-
跨链桥合约代码编写
-
跨链桥的链下服务(多链扫描的服务)
二.跨链桥的基本概念
在 Web3 世界里面,不同公链/联盟链之间数据,资产等是不能共同的,就像传统世界的两家不同的银行一样,为将不同链资产进行转移,数据进行转移,就产生了跨链互操作或者跨链桥的产品。
跨链桥是链与链之间资产互转的一个通道
【图示 1】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
其实就是任意链到任意链的资产互转
跨链在 Cosmos 玩法逻辑
【图示 2】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
其他链
【图示 3】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
三.跨链桥的项目架构
支持合约的链
【图示 4】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
不支持智能合约的
【图示 5】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
Layer1<—> Layer2 的跨桥
【图示 6】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
-
资产如果在 Layer2 和 Layer1 上都有发行,那么两边都是锁定资金和解锁资金
-
资产如果只发行在 layer1, Layer1 的资金是锁定和解锁,Layer2 的资金是 mint 和 burn
-
资产是发行在 Layer2, Layer2 的资金是锁定和解锁,Layer1 的资金是 mint 和 burn
四. 写一个特殊的 ERC20 Token (加餐)
Token 需要具备功能
-
Token 是一键发出进入不同分配地址
-
Mint
-
Burn
-
转账需要收手续费
-
交易收手续费
-
上涨收上涨税
-
下跌收下跌税
合约代码编写
- https://github.com/the-web3-contracts/token-contracts
代码的业务逻辑图
代币合约
重新了 ERC20 的 _update 函数,函数的主要逻辑是
-
产生交易的时候,收取交易手续费
-
代币下跌的时候,收取下跌税
【图示 7】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
- 代币分配
【图示 8】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
LpManager 合约
【图示 9】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
NFT Manager 合约
【图示 10】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
整个代码的架构
【图示 11】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
五.DappLink 跨链桥的项目
跨链桥的代码架构
合约代码的架构
【图示 12】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
链下服务的代码架构
【图示 13】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
合约代码解读
【图示 14】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
链下代码解读
合约事件扫描器
-
比前面项目多一个不同链的 synchronizer,每条链写一个进程去扫链上的合约事件,最终更新是 block_header_chainId 和 contract_events_chainid 这两种表
-
初始化不同链的 synchronizer
【图示 15】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
合约事件解析器
【图示 16】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
在合约事件解析器里面,这里面的代码是一次性把所有和事件解析完成之后,通过统一的事务将数据入到数据库表里面。
前面的 FishCake 项目是每个事件解析完了存库,这个项目这点是不一样的,将所有合约事件解析按照数据库的结构组成数字返回,在统一事务里面入库。
桥的交易发送器
- 流程概览
【图示 17】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
- 代码细节流程
【图示 18】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
-
用户发资金到源链的合约,会触发初始化合约事件,用户跨桥的前置操作
-
Relayer 程序会去读这初始化事件,调用桥 Finalized 的方法将资金从目标转给用户
-
Finalized 事件被监听到之后,才认为这个跨链转账成功,
交易关联的业务处理器
主要的就是使用 SendMessage 和 RelayMessage 将源链和目标交易进行管理,在界面可以展示出一笔跨桥交易操作,界面上展示需要包含
-
源链
-
目标链
-
源链 Hash
-
目标链 Hash
-
金额
-
手续费
-
From
-
To
【图示 19】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
六.要点总结(把以下描述做成作业)
-
不要使用 AI,自己去把写出来,运行起来
-
整理这些里面可能会存在哪些问题,还有哪些可以优化的地方
七.BNB 和 Sepolia 运行测试,链下服务本地运行
链上合约部署
第一步:地址准备
- BNB Relayer
Successfully created new keypair.
Address: 0xd449306df27faB97ec0431F4558ab75966743983
Private key: 0xb857bcf6f3ee005a79eea257a4ab467a3488b5006fa4a9dbba7d54a9a41aafa5
- Sepolia Relayer
Successfully created new keypair.
Address: 0xd449306df27faB97ec0431F4558ab75966743983
Private key: 0xb857bcf6f3ee005a79eea257a4ab467a3488b5006fa4a9dbba7d54a9a41aafa5
第二步:部署合约
- 环境变量配置
export PRIVATE_KEY=0xb857bcf6f3ee005a79eea257a4ab467a3488b5006fa4a9dbba7d54a9a41aafa5
export RELAYER_ADDRESS=0xd449306df27faB97ec0431F4558ab75966743983
export MULTI_SIGNER=0xd449306df27faB97ec0431F4558ab75966743983
export GAS_ORACLE_ADDRESS=0xd449306df27faB97ec0431F4558ab75966743983
export DOL_CHAIN_ID=1520
- 在 BNB 的testnet 上部署合约
forge script ./script/DeployerChainBridge.s.sol:DeployerChainBridgeScript --rpc-url https://bsc-testnet.bnbchain.org --broadcast
- 部署出来的地址
== Logs ==
deploy proxyMessageManager: 0xD87b57125E14B24F82Cd340A638F722904FA4259
deploy proxyPoolManager: 0xC2540063c743e14b53EC47f4270ADabbD534a484
- 在 sepolia 上部署合约
forge script ./script/DeployerChainBridge.s.sol:DeployerChainBridgeScript --rpc-url https://eth-sepolia-testnet.api.pocket.network --broadcast
- 部署出来的地址
第三步:部署测试币
- 配置环境变量
export PRIVATE_KEY=0xb857bcf6f3ee005a79eea257a4ab467a3488b5006fa4a9dbba7d54a9a41aafa5
- BNB Chain 部署
forge script ./script/deployDappLinkToken.s.sol:deploydDappLinkTokenScript --rpc-url https://bsc-testnet.bnbchain.org --broadcast
- Sepolia 链上的部署
forge script ./script/deployDappLinkToken.s.sol:deploydDappLinkTokenScript --rpc-url https://eth-sepolia-testnet.api.pocket.network --broadcast
0xA663CdBeA0fAB0815A2efA252d2Ab90DAb995856
链下服务的启动
第一步:配置环境变量
slave_db_enable: false
num_confirmations: 10
safe_abort_nonce_too_low_count: 3
caller_address: "0xd449306df27faB97ec0431F4558ab75966743983"
enable_api_cache: false
dol_chain_id: 1519
sync_loop_interval: 5
worker_loop_interval: 5
server:
host: 0.0.0.0
port: 8082
websocket_server:
host: 0.0.0.0
port: 8084
metrics:
host: 0.0.0.0
port: 8083
rpcs:
- rpc_url: 'https://bsc-testnet.bnbchain.org'
chain_id: 97
start_block: 125525010
第二步:编译代码
里面合约地址,开始区块和数据库等等信息一定配置正确
- 编译代码
make
- 这里面发生合约代码变更的,要重新生成 ABI,重新编译 go 文件之后调整代码继续
make bindings
- 创建数据,执行数据库脚本
create database s9relayernode;
./relayer-node migrate
guoshijiang=# \c s9relayernode
您现在已经连接到数据库 "s9relayernode",用户 "guoshijiang".
s9relayernode=# \d
关联列表
架构模式 | 名称 | 类型 | 拥有者
----------+--------------------------+--------+-------------
public | block_headers | 数据表 | guoshijiang
public | block_headers_11155111 | 数据表 | guoshijiang
public | block_headers_97 | 数据表 | guoshijiang
public | bridge_finalize | 数据表 | guoshijiang
public | bridge_initiate | 数据表 | guoshijiang
public | bridge_msg_hash | 数据表 | guoshijiang
public | bridge_msg_sent | 数据表 | guoshijiang
public | bridge_record | 数据表 | guoshijiang
public | claim_reward | 数据表 | guoshijiang
public | contract_events | 数据表 | guoshijiang
public | contract_events_11155111 | 数据表 | guoshijiang
public | contract_events_97 | 数据表 | guoshijiang
public | event_block | 数据表 | guoshijiang
public | lp_withdraw | 数据表 | guoshijiang
public | nft_manager_mint | 数据表 | guoshijiang
public | staking_record | 数据表 | guoshijiang
public | token_config | 数据表 | guoshijiang
(17 行记录)
- 配置文件里面每配置一条链,这里表结构都会新生成出来,下面是 bnb chain 和 sepolia 的示例代码
第三步:配置私钥
export RELAYER_NODE_PRIVATE_KEY=b857bcf6f3ee005a79eea257a4ab467a3488b5006fa4a9dbba7d54a9a41aafa5
在实际生成环境里面 RELAYER_NODE_PRIVATE_KEY 需要加密,配置在 AWS 或者其他云服务的 Secret Manager 里面。
第四步:启动服务
/relayer-node index
INFO [08-17|10:44:31.016] running indexer...
INFO [08-17|10:44:31.018] "New relayer node start️ 🕖"
INFO [08-17|10:44:31.018] Init rpc client ChainId=97 RpcUrl=https://bsc-testnet.bnbchain.org
发交易进行测试
补充不同链的资金的资金
- 打钱进入 BNB 的合约
cast send --rpc-url https://bnb-testnet.g.alchemy.com/v2/QySv9gLuQUaXy0BJnpNwW1d1N8ve0as4 --private-key 0xb857bcf6f3ee005a79eea257a4ab467a3488b5006fa4a9dbba7d54a9a41aafa5 0xC2540063c743e14b53EC47f4270ADabbD534a484 "setValidChainId(uint256,bool)" 97 true
cast send --rpc-url https://bnb-testnet.g.alchemy.com/v2/QySv9gLuQUaXy0BJnpNwW1d1N8ve0as4 --private-key 0xb857bcf6f3ee005a79eea257a4ab467a3488b5006fa4a9dbba7d54a9a41aafa5 0xC2540063c743e14b53EC47f4270ADabbD534a484 "setValidChainId(uint256,bool)" 11155111 true
cast send --rpc-url https://bnb-testnet.g.alchemy.com/v2/QySv9gLuQUaXy0BJnpNwW1d1N8ve0as4 --private-key 0xb857bcf6f3ee005a79eea257a4ab467a3488b5006fa4a9dbba7d54a9a41aafa5 0xC2540063c743e14b53EC47f4270ADabbD534a484 "setSupportERC20Token(address,bool)" 0x9e352e880ff5065Fa7bae2229E43f1a4D0ff2289 true
cast send --rpc-url https://bnb-testnet.g.alchemy.com/v2/QySv9gLuQUaXy0BJnpNwW1d1N8ve0as4 --private-key 0xb857bcf6f3ee005a79eea257a4ab467a3488b5006fa4a9dbba7d54a9a41aafa5 0x9e352e880ff5065Fa7bae2229E43f1a4D0ff2289 "approve(address,uint256)" 0xC2540063c743e14b53EC47f4270ADabbD534a484 10000000000000
cast send --rpc-url https://bnb-testnet.g.alchemy.com/v2/QySv9gLuQUaXy0BJnpNwW1d1N8ve0as4 --private-key 0xb857bcf6f3ee005a79eea257a4ab467a3488b5006fa4a9dbba7d54a9a41aafa5 0xC2540063c743e14b53EC47f4270ADabbD534a484 "depositErc20ToBridge(address,uint256)" 0x9e352e880ff5065Fa7bae2229E43f1a4D0ff2289 10000000000
- 打钱进入 sepolia 的合约
cast send --rpc-url https://eth-sepolia.g.alchemy.com/v2/QySv9gLuQUaXy0BJnpNwW1d1N8ve0as4 --private-key 0xb857bcf6f3ee005a79eea257a4ab467a3488b5006fa4a9dbba7d54a9a41aafa5 0x3a30876F4e17d8007F6DD1883955Ca2FD7A74C78 "setValidChainId(uint256,bool)" 97 true
cast send --rpc-url https://eth-sepolia.g.alchemy.com/v2/QySv9gLuQUaXy0BJnpNwW1d1N8ve0as4 --private-key 0xb857bcf6f3ee005a79eea257a4ab467a3488b5006fa4a9dbba7d54a9a41aafa5 0x3a30876F4e17d8007F6DD1883955Ca2FD7A74C78 "setValidChainId(uint256,bool)" 11155111 true
构建跨桥的测试脚本
- ERC20 跨链的方法
function BridgeInitiateERC20(
uint256 sourceChainId,
uint256 destChainId,
address to,
address sourceTokenAddress,
address destTokenAddress,
uint256 value
)
- Cast 脚本
cast send --rpc-url https://bnb-testnet.g.alchemy.com/v2/QySv9gLuQUaXy0BJnpNwW1d1N8ve0as4 --private-key 0xb857bcf6f3ee005a79eea257a4ab467a3488b5006fa4a9dbba7d54a9a41aafa5 0xC2540063c743e14b53EC47f4270ADabbD534a484 "BridgeInitiateERC20(uint256,uint256,address,address,address,uint256)" 97 11155111 0x1800AE0cE56fe6aBb10789c3A124ae5c41b0eF75 0x9e352e880ff5065Fa7bae2229E43f1a4D0ff2289 0xA663CdBeA0fAB0815A2efA252d2Ab90DAb995856 100000000
- 在目标链上收币的地址
Successfully created new keypair.
Address: 0x1800AE0cE56fe6aBb10789c3A124ae5c41b0eF75
Private key: 0xe92b18a8829364839eb764290073bdc0ef1813ebf90ccff0a97c0fd2ff6f854d
通过 API 查询交易记录
http://127.0.0.1:8082/api/v1/bridge-records?address=0x1800AE0cE56fe6aBb10789c3A124ae5c41b0eF75&page=1&pageSize=10&order=asc&bridgeType=0
{
"Current": 1,
"Size": 10,
"Total": 2,
"Records": [
{
"guid": "1a4c4c82-2dda-4a23-ada8-f51427626490",
"source_chain_id": 97,
"dest_chain_id": 11155111,
"source_tx_hash": "0x02db0813b5c7366e62eb692cb289d8d972710dfc8a7136876317c100ddfdb5a1",
"dest_tx_hash": "0x956aafc554fbdcbb8a5c459ed41e2c8068d9884f42e3e922236d24c37c93f677",
八.跨链桥项目怎么保证跨链安全
-
密钥的管理:我们 relayer 的是一个中心化的网络,密钥的管理尽可能使用最安全的方式,
-
运维层面
-
资金层面
-
风控层面
八.总结
-
跨链桥是一个基本的项目,建议自己把代码从头开始写一篇
-
代码
-
要求:把合约和后端代码自己协议,不要用 AI 工具
附录:问题
1.项目实战代码中归集任务对防范以太坊假充值的余额校验有影响:例如用户刚充值 1000U 就被归集了,这时候充值业务中假充值的余额校验因为金额被归集了而不准确?
- 合约地址,上一个币,必然是要在 token 表里面配置,包含合约的地址代币精度这样的东西,合约地址配置,系统认可这个币了,这个币也是真实存在,合约的假充值就不存在;
【图示 20】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
- txHash Recepit 收据是成功的,才能去解析调用栈;
2.每一条链发送提现/归集任务都有 pending 卡住的情况,超过一定时间需要提高 gas 重发, 每条链的重发时间怎么算出来的?
-
监听 mempool, 每条的链 mempool 是有丢失机制,看交易是否被丢失
-
按照区块时间来评判,用户体验的问题
- 除了在代码层面,还有哪些机制来保证充值提现是安全的?怎么保证稳定性?
-
冷温热钱包分离
-
假充值每条链了解一下
-
运维和技术开发分离
-
钱包的链路风控,每一笔充值进去,除钱包本身自己校验,还有去风控进行二次验证,验证通过
-
节点被替换,怎么防止节点被替换(运维作恶)
-
节点不稳定怎么解决
-
实际过程做回到 RPC 单节点问题,单节点会挂,一般会使用节点负载
-
提现是安全的,提现不可能每笔交易都去人工审核
4.solana 主币假充值校验是利用 postbalance-prebalance 的差值与转账金额比较。这个校验的位置是需要区块确认等级为 finalized 后才做这一步校验吗?
- finalized 之后校验更好
面试题目及其答案讲解(The Web3 面试题库)
面试题交流S5S6
Github 面试题目:https://github.com/the-web3/chaineye-blockchain-interview
-
会将 Init 的事件置为已经跨桥过的事件,Finazlied 置为执行成功了
-
block_headers_11155111, block_headers_97
-
contract_events_11155111, contract_events_97
-
HSM 最安全,调用 HSM 签名的的信息不能泄露,这些做配置可以加密之后放到 SecretManager 里面
-
TEE: 和钱包私钥管理类似
-
SecretManager:加密之后放到 secrect manager
-
开发和运维分离
-
节点稳定性和安全性
-
资金监控:用户转入到和出去的资金是平衡的,做资金平衡监控,
-
资产负债表:资产一定大于负债,在途资金也要算进来
-
防止签名机劫持攻击,和中心化交易所钱包的 walletKey 方式类似
-
调用 finalized 函数将资金转给用户的时候,要通过风控验证源链上的交易是否真实存在
-
调用 finalized 函数之前要确保源链上交易回滚概率极小,这个可以通过确认位来解决
-
合约代码:https://github.com/the-web3-contracts/bridge-contracts
-
前端代码:https://github.com/the-web3-contracts/bridge-ui
-
后端代码 : https://github.com/the-web3-contracts/relayer-node
-
Ethereum: nonce: 出块时间为了 12 秒
-
Bitcoin UTXO: 出块时间为了 10 分钟
-
Solanan: 出块时间为了 1s 出几个块
-
每个区块都有自己的区块 Hash, 和正式主要区块 Hash 定期检测就可以。
-
RPC 节点在大一些公司,一般都是自建,自建之后做负载;在小一点的公司或者团队,用第三方的节点
-
自建节点
【图示 21】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
- 使用第三方节点:一般购买多家服务商的节点 alchemy, ankr, getblock, google 和 infura
【图示 22】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/Q26gdULAcoPQhnxFDsjlnHoNgIb
-
如何自动化提现:
-
提现金额 <= 充值 - 提现 + 系统已结算盈亏 - 手续费,自动化审核通过
本文详解基于Web3的跨链桥项目DappLink的完整实现,涵盖跨链基本原理、多链架构设计(Layer1/Layer2及非EVM链)、定制化ERC20代币开发(含交易税与涨跌税)、桥接合约代码结构、链下Relayer服务(事件扫描器、解析器、交易发送器、业务处理器),以及BNB与Sepolia测试网部署与安全机制(密钥管理、风控校验、Finalized确认、资金平衡监控)。强调手动编码实践与跨链安全性保障。
219

被折叠的 条评论
为什么被折叠?



