Skip to content

Commit 7a6d8e8

Browse files
0x-stan0x-stan
committed
update task 80
1 parent 4fd604e commit 7a6d8e8

File tree

2 files changed

+236
-5
lines changed

2 files changed

+236
-5
lines changed

‎basic/80-circle-cctp/README-cn.md

+209
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,209 @@
1+
# Circle CCTP
2+
3+
中文 / [English](./README.md)
4+
5+
## 概览
6+
7+
跨链转账协议（CCTP）是一个无需许可的链上工具，通过原生的 burn 和 mint 机制，在区块链网络之间安全地转移 USDC。提高使用跨区块链网络 USDC 时的资本效率。CCTP 使开发者能够构建多链应用，为用户提供跨区块链的安全、1:1 的 USDC 转账。
8+
9+
## 工作原理
10+
11+
在源链上燃烧 USDC：在源链上燃烧指定数量的 USDC。
12+
从 Circle 获取签名的证明：Circle 观察并证明源链上的 brun 事件。从 Circle 请求证明，Circle 提供授权在目的链上铸造指定数量的 USDC。
13+
在目标链上铸造 USDC：使用证明触发 USDC 的 mint，并发送到接收者的钱包地址。
14+
15+
跨链转账协议（CCTP）消息传递机制，在支持的区块链之间 burn 和 mint USDC，这一过程包括三个步骤：
16+
17+
1. 源域上的链上组件发出消息。
18+
2. Circle 的链下证明服务对消息进行签名。
19+
3. 目的域上的链上组件接收消息，并将消息体转发给指定的接收者。
20+
21+
## Get-Started
22+
23+
将 USDC 从 Ethereum 测试网 跨链到 Avalanche 测试网
24+
25+
- install
26+
27+
```sh
28+
pnpm install
29+
```
30+
31+
- run script
32+
33+
```sh
34+
pnpm start
35+
```
36+
37+
### Script Output
38+
39+
```sh
40+
Ethereum Sepolia testnet Wallet address: 0xe45d43FEb3F65B4587510A68722450b629154e6f
41+
Avalache Fuji testnet Wallet address: 0xe45d43FEb3F65B4587510A68722450b629154e6f
42+
sepolia test USDC balanceOf 9900000
43+
Amount that will be transferred 100000
44+
45+
STEP 1: Approve messenger contract to withdraw from our active eth address
46+
ApproveTx 0x3a6e906cfd6d6af92ae0520662dd40d126f6e8cb1e76c0b98904d2e3e5739a4f
47+
ApproveTxReceipt: {
48+
...
49+
}
50+
51+
STEP 2: Burn USDC
52+
BurnTx 0x95d6a57ce1c4cc35e50cf7561dcbe6bc1df0924912a13d5c293d23472cad6616
53+
BurnTxReceipt: {
54+
blockHash: '0x895655d141bc5d34c49d9bf47b3678bedfd43f6f1450a9547653a4196ca3b456',
55+
blockNumber: 5334096n,
56+
contractAddress: null,
57+
cumulativeGasUsed: 10852617n,
58+
effectiveGasPrice: 5774590432n,
59+
from: '0xe45d43feb3f65b4587510a68722450b629154e6f',
60+
gasUsed: 103504n,
61+
logs: [
62+
{
63+
address: '0x1c7d4b196cb0c7b01d743fbc6116a902379c7238',
64+
topics: [Array],
65+
data: '0x00000000000000000000000000000000000000000000000000000000000186a0',
66+
blockNumber: 5334096n,
67+
transactionHash: '0x95d6a57ce1c4cc35e50cf7561dcbe6bc1df0924912a13d5c293d23472cad6616',
68+
transactionIndex: 106,
69+
blockHash: '0x895655d141bc5d34c49d9bf47b3678bedfd43f6f1450a9547653a4196ca3b456',
70+
logIndex: 171,
71+
removed: false
72+
},
73+
{
74+
address: '0x1c7d4b196cb0c7b01d743fbc6116a902379c7238',
75+
topics: [Array],
76+
data: '0x00000000000000000000000000000000000000000000000000000000000186a0',
77+
blockNumber: 5334096n,
78+
transactionHash: '0x95d6a57ce1c4cc35e50cf7561dcbe6bc1df0924912a13d5c293d23472cad6616',
79+
transactionIndex: 106,
80+
blockHash: '0x895655d141bc5d34c49d9bf47b3678bedfd43f6f1450a9547653a4196ca3b456',
81+
logIndex: 172,
82+
removed: false
83+
},
84+
{
85+
address: '0x1c7d4b196cb0c7b01d743fbc6116a902379c7238',
86+
topics: [Array],
87+
data: '0x00000000000000000000000000000000000000000000000000000000000186a0',
88+
blockNumber: 5334096n,
89+
transactionHash: '0x95d6a57ce1c4cc35e50cf7561dcbe6bc1df0924912a13d5c293d23472cad6616',
90+
transactionIndex: 106,
91+
blockHash: '0x895655d141bc5d34c49d9bf47b3678bedfd43f6f1450a9547653a4196ca3b456',
92+
logIndex: 173,
93+
removed: false
94+
},
95+
{
96+
address: '0x7865fafc2db2093669d92c0f33aeef291086befd',
97+
topics: [Array],
98+
data: '0x000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000f8000000000000000000000001000000000003ec700000000000000000000000009f3b8679c73c2fef8b59b4f3444d4e156fb70aa5000000000000000000000000eb08f243e5d3fcff26a9e38ae5520a669f4019d00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c7238000000000000000000000000e45d43feb3f65b4587510a68722450b629154e6f00000000000000000000000000000000000000000000000000000000000186a0000000000000000000000000e45d43feb3f65b4587510a68722450b629154e6f0000000000000000',
99+
blockNumber: 5334096n,
100+
transactionHash: '0x95d6a57ce1c4cc35e50cf7561dcbe6bc1df0924912a13d5c293d23472cad6616',
101+
transactionIndex: 106,
102+
blockHash: '0x895655d141bc5d34c49d9bf47b3678bedfd43f6f1450a9547653a4196ca3b456',
103+
logIndex: 174,
104+
removed: false
105+
},
106+
{
107+
address: '0x9f3b8679c73c2fef8b59b4f3444d4e156fb70aa5',
108+
topics: [Array],
109+
data: '0x00000000000000000000000000000000000000000000000000000000000186a0000000000000000000000000e45d43feb3f65b4587510a68722450b629154e6f0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000eb08f243e5d3fcff26a9e38ae5520a669f4019d00000000000000000000000000000000000000000000000000000000000000000',
110+
blockNumber: 5334096n,
111+
transactionHash: '0x95d6a57ce1c4cc35e50cf7561dcbe6bc1df0924912a13d5c293d23472cad6616',
112+
transactionIndex: 106,
113+
blockHash: '0x895655d141bc5d34c49d9bf47b3678bedfd43f6f1450a9547653a4196ca3b456',
114+
logIndex: 175,
115+
removed: false
116+
}
117+
],
118+
logsBloom: '0x00000000000000000000000000000000000000000000001000000000000200002000000000000200000000000000000000002010000004000000000000000000100000000000000000000008000000000000000000000000000200020000000001000000022000400000000000000800080000000040000000100010100000000000000000101004000000000000000000000000000000000000000000200000000000000000000000000000000000040000008000000000000000000000000000000002000000000480000000000000000000000000000000000000020020000000000400000020000010000000000000080000000000000000000000000000',
119+
status: 'success',
120+
to: '0x9f3b8679c73c2fef8b59b4f3444d4e156fb70aa5',
121+
transactionHash: '0x95d6a57ce1c4cc35e50cf7561dcbe6bc1df0924912a13d5c293d23472cad6616',
122+
transactionIndex: 106,
123+
type: 'eip1559'
124+
}
125+
126+
STEP 3: Retrieve message bytes from logs
127+
128+
message
129+
0x000000000000000000000001000000000003ec700000000000000000000000009f3b8679c73c2fef8b59b4f3444d4e156fb70aa5000000000000000000000000eb08f243e5d3fcff26a9e38ae5520a669f4019d00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c7238000000000000000000000000e45d43feb3f65b4587510a68722450b629154e6f00000000000000000000000000000000000000000000000000000000000186a0000000000000000000000000e45d43feb3f65b4587510a68722450b629154e6f
130+
131+
messageHash 0x921854a0cc7746e05082591412747ffa0c497e6c4785504b29061c5d36b0e1b0
132+
133+
STEP 4: Fetch attestation signature
134+
Signature: 0x5c515abc1964dfe1e46a4a4daacb897a24d586e15d0ff93617e8f22793ed6192565957db1dc55b4011409f4b7dbb4e072a8365fa11071b393c41a6e2527a1b421c6d49f035e9665c55568afea143e3490fa8a1d5f6409fbc94956a9a95cfe258f6236e0805e96080d8347153d64d8823983e9cdfbdb08140d1933b3d8f874356551c
135+
136+
STEP 5: Using the message bytes and signature recieve the funds on destination chain and address
137+
ReceiveTx 0xa4960f3caad924ffd6982bde512dff930cc1276e4d2ea92b7ab2f1f81bf17bc4
138+
139+
ReceiveTxReceipt: {
140+
blockHash: '0xc7635b7727dd31d44f7b75edfb7298cfe661da5c8910fda8eaa1638a98b9fc68',
141+
blockNumber: 30168739n,
142+
contractAddress: null,
143+
cumulativeGasUsed: 325719n,
144+
effectiveGasPrice: 25000000000n,
145+
from: '0xe45d43feb3f65b4587510a68722450b629154e6f',
146+
gasUsed: 143755n,
147+
logs: [
148+
{
149+
address: '0x5425890298aed601595a70ab815c96711a31bc65',
150+
topics: [Array],
151+
data: '0x00000000000000000000000000000000000000000000000000000000000186a0',
152+
blockNumber: 30168739n,
153+
transactionHash: '0xa4960f3caad924ffd6982bde512dff930cc1276e4d2ea92b7ab2f1f81bf17bc4',
154+
transactionIndex: 1,
155+
blockHash: '0xc7635b7727dd31d44f7b75edfb7298cfe661da5c8910fda8eaa1638a98b9fc68',
156+
logIndex: 2,
157+
removed: false
158+
},
159+
{
160+
address: '0x5425890298aed601595a70ab815c96711a31bc65',
161+
topics: [Array],
162+
data: '0x00000000000000000000000000000000000000000000000000000000000186a0',
163+
blockNumber: 30168739n,
164+
transactionHash: '0xa4960f3caad924ffd6982bde512dff930cc1276e4d2ea92b7ab2f1f81bf17bc4',
165+
transactionIndex: 1,
166+
blockHash: '0xc7635b7727dd31d44f7b75edfb7298cfe661da5c8910fda8eaa1638a98b9fc68',
167+
logIndex: 3,
168+
removed: false
169+
},
170+
{
171+
address: '0xeb08f243e5d3fcff26a9e38ae5520a669f4019d0',
172+
topics: [Array],
173+
data: '0x00000000000000000000000000000000000000000000000000000000000186a0',
174+
blockNumber: 30168739n,
175+
transactionHash: '0xa4960f3caad924ffd6982bde512dff930cc1276e4d2ea92b7ab2f1f81bf17bc4',
176+
transactionIndex: 1,
177+
blockHash: '0xc7635b7727dd31d44f7b75edfb7298cfe661da5c8910fda8eaa1638a98b9fc68',
178+
logIndex: 4,
179+
removed: false
180+
},
181+
{
182+
address: '0xa9fb1b3009dcb79e2fe346c16a604b8fa8ae0a79',
183+
topics: [Array],
184+
data: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000009f3b8679c73c2fef8b59b4f3444d4e156fb70aa500000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000084000000000000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c7238000000000000000000000000e45d43feb3f65b4587510a68722450b629154e6f00000000000000000000000000000000000000000000000000000000000186a0000000000000000000000000e45d43feb3f65b4587510a68722450b629154e6f00000000000000000000000000000000000000000000000000000000',
185+
blockNumber: 30168739n,
186+
transactionHash: '0xa4960f3caad924ffd6982bde512dff930cc1276e4d2ea92b7ab2f1f81bf17bc4',
187+
transactionIndex: 1,
188+
blockHash: '0xc7635b7727dd31d44f7b75edfb7298cfe661da5c8910fda8eaa1638a98b9fc68',
189+
logIndex: 5,
190+
removed: false
191+
}
192+
],
193+
logsBloom: '0x0000000000000000008000000000000100004000000000000000010000200000200000000400000000000000000002000000a000000000000000000000000000000000000000000000000008000000000080000000000000000000200000000001020000020000000000000000012800000000000000000000400010000000000000000000000400000000001000000000000000000002000000000000010400000000000000000004100000000000040000000000000000000000000000000000000002000010000080000000000000000000000000000000000000020020000000000000000000000000000000004000000000000800000000000000000000',
194+
status: 'success',
195+
to: '0xa9fb1b3009dcb79e2fe346c16a604b8fa8ae0a79',
196+
transactionHash: '0xa4960f3caad924ffd6982bde512dff930cc1276e4d2ea92b7ab2f1f81bf17bc4',
197+
transactionIndex: 1,
198+
type: 'eip1559'
199+
}
200+
Check USDC on Avax testnet balanceOf 10000
201+
```
202+
203+
## 参考链接
204+
205+
- doc <https://developers.circle.com/stablecoins/docs/transfer-usdc-on-testnet-from-ethereum-to-avalanche>
206+
207+
- contract deployment <https://developers.circle.com/stablecoins/docs/evm-smart-contracts>
208+
209+
- USDC Testnet faucet <https://faucet.circle.com/?_gl=1*ouhs7l*_ga_GJDVPCQNRV*MTcwODUwNDQ1OC4zLjEuMTcwODUwNDQ5MS4yNy4wLjA>

‎basic/80-circle-cctp/README.md

+27-5
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,28 @@
11
# Circle CCTP
22

3-
Transfer USDC on testnet from Ethereum to Avalanche
3+
[中文](./README-cn.md) / English
44

5-
- doc <https://developers.circle.com/stablecoins/docs/transfer-usdc-on-testnet-from-ethereum-to-avalanche>
5+
## Overview
66

7-
- contract deployment <https://developers.circle.com/stablecoins/docs/evm-smart-contracts>
7+
Cross-Chain Transfer Protocol (CCTP) is a permissionless on-chain utility that facilitates USDC transfers securely between blockchains networks via native burning and minting. Circle created it to improve capital efficiency and minimize trust requirements when using USDC across blockchain networks. CCTP enables developers to build multi-chain applications that provide secure, 1:1 transfers of USDC across blockchains for their users.
88

9-
- USDC Testnet faucet <https://faucet.circle.com/?_gl=1*ouhs7l*_ga_GJDVPCQNRV*MTcwODUwNDQ1OC4zLjEuMTcwODUwNDQ5MS4yNy4wLjA>
9+
## How it works
10+
11+
USDC is burned on the source chain: Using an app, a user initiates a transfer of USDC from one blockchain to another, and specifies the recipient wallet address on the destination chain. The app facilitates a burn of the specified amount of USDC on the source chain.
12+
A signed attestation is fetched from Circle: Circle observes and attests to the burn event on the source chain. The app requests the attestation from Circle, which provides authorization to mint the specified amount of USDC on the destination chain.
13+
USDC is minted on the destination chain: The app uses the attestation to trigger the minting of USDC. The specified amount of USDC is minted on the destination chain and sent to the recipient wallet address.
1014

11-
## Get Start
15+
Cross-Chain Transfer Protocol (CCTP) uses generalized message passing to facilitate the native burning and minting of USDC across supported blockchains, also known as domains. Message passing is a three-step process:
16+
17+
1. An on-chain component on source domain emits a message.
18+
2. Circle's off-chain attestation service signs the message.
19+
3. The on-chain component at the destination domain receives the message, and forwards the message body to the specified recipient.
20+
21+
![CCTP_Smart_Contract_Flow](https://files.readme.io/fcb147b-Smart_Contract_Flow.png)
22+
23+
## Get-Started
24+
25+
Transfer USDC on testnet from Ethereum to Avalanche
1226

1327
- install
1428

@@ -187,3 +201,11 @@ ReceiveTxReceipt: {
187201
}
188202
Check USDC on Avax testnet balanceOf 10000
189203
```
204+
205+
## Referrence
206+
207+
- doc <https://developers.circle.com/stablecoins/docs/transfer-usdc-on-testnet-from-ethereum-to-avalanche>
208+
209+
- contract deployment <https://developers.circle.com/stablecoins/docs/evm-smart-contracts>
210+
211+
- USDC Testnet faucet <https://faucet.circle.com/?_gl=1*ouhs7l*_ga_GJDVPCQNRV*MTcwODUwNDQ1OC4zLjEuMTcwODUwNDQ5MS4yNy4wLjA>

0 commit comments

Comments
 (0)