Stellar là một trong những nền tảng blockchain thuộc loại sớm nhất (phát hành trước Ethereum) và ngay từ đầu chỉ tập trung trực tiếp vào payments chứ không mở rộng thêm các hướng về healthcare, estate… như các blockchain khác. Bên cạnh đó Stellar cũng đang được Samsung hợp tác, có thể chúng ta sẽ sớm thấy lumens được tích hợp luôn trên các mẫu điện thoại của samsung.
Mở đầu
Đầu tiên, bài viết này hướng đến những SDK mới của Stellar nên sẽ phù hợp với những blockchain Dev đã từng biết qua Stellar một xíu, còn những bạn mới bắt đầu tìm hiểu blockchain hoặc bắt đầu thì có thể đọc qua bài viết này để có cái nhìn sơ lược về Stellar : Stellar là gì? Stellar hoạt động như thế nào?
Tuy nhiên trong bài này nếu các bạn chạy theo step-by-step sẽ thấy không chuyển được lumens do có một lỗi là chưa đăng ký account trên mạng stellar (Mặc dù trong bài chúng ta sử dụng TESTNET). Đây chính là cách mạng Stellar hạn chế các địa chỉ rác trên mạng của họ. Để có thể trở thành địa chỉ có thể sử dụng được thì chúng ta phải faucet cho địa chỉ đó một chút lumens và cũng được coi như một cách đăng ký với mạng
Dưới đây sẽ là function faucet, các bạn sẽ được 1000 lumens để test:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | <span class="token keyword">const</span> <span class="token punctuation">{</span> TransactionBuilder<span class="token punctuation">,</span> Server<span class="token punctuation">,</span> Keypair<span class="token punctuation">,</span> <span class="token constant">BASE_FEE</span><span class="token punctuation">,</span> Networks<span class="token punctuation">,</span> Operation<span class="token punctuation">,</span> Asset <span class="token punctuation">}</span> <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'stellar-sdk'</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">const</span> server <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">Server</span><span class="token punctuation">(</span><span class="token string">'https://horizon-testnet.stellar.org'</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">const</span> baseFee <span class="token operator">=</span> <span class="token constant">BASE_FEE</span><span class="token punctuation">;</span> <span class="token keyword">const</span> networkPassphrase <span class="token operator">=</span> Networks<span class="token punctuation">.</span><span class="token constant">TESTNET</span><span class="token punctuation">;</span> <span class="token keyword">const</span> <span class="token function-variable function">faucet</span> <span class="token operator">=</span> <span class="token keyword">async</span> <span class="token parameter">_publicKey</span> <span class="token operator">=></span> <span class="token punctuation">{</span> <span class="token keyword">try</span> <span class="token punctuation">{</span> <span class="token keyword">await</span> server<span class="token punctuation">.</span><span class="token function">friendbot</span><span class="token punctuation">(</span>_publicKey<span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">call</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token keyword">catch</span> <span class="token punctuation">(</span>e<span class="token punctuation">)</span> <span class="token punctuation">{</span> console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span>e<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token punctuation">}</span><span class="token punctuation">;</span> |
Trong bài này mình sẽ sử dụng bản “stellar-sdk”: “5.0.3”
Thực hành
Trong bài này mình sẽ hướng dẫn các bạn dùng 2 Protocol được đưa đến trong Protocol 13 mà mình thấy khá hữu dụng :
- Fee Bumps : Đây là protocol rất hữu ích cho phép người dùng có thể trả phí Transaction cho các tài khoản khác mà không cần can thiệp vào địa chỉ được trả phí.
- Claimable Balances : Protocol này về cơ bản sẽ chia một payment thông thường thành 2 phần bao gồm Khởi tạo balance và Claim balance. Khởi tạo balance có thể chỉ định trực tiếp người có thể claim balance đó.
Xem balance của tài khoản
Đầu tiên để dễ dàng check các protocol thì chúng ta sẽ cần một hàm để kiểm tra balance, trong vũ trụ stellar chúng ta sẽ thấy payment sẽ transfer 2 loại giá trị (Asset) được gọi là native (lumen) và phần còn lại (Các loại Asset do người dùng tự định nghĩa – với các dev ETH sẽ thấy chúng na ná như ERC20). Trong bài viết này chúng ta sẽ làm việc với Asset native của Stellar :
1 2 3 4 5 6 | <span class="token keyword">const</span> <span class="token function-variable function">getNativeBalance</span> <span class="token operator">=</span> <span class="token keyword">async</span> <span class="token parameter">_publicKey</span> <span class="token operator">=></span> <span class="token punctuation">{</span> <span class="token keyword">let</span> account <span class="token operator">=</span> <span class="token keyword">await</span> server<span class="token punctuation">.</span><span class="token function">loadAccount</span><span class="token punctuation">(</span>_publicKey<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">let</span> res <span class="token operator">=</span> account<span class="token punctuation">.</span>balances<span class="token punctuation">.</span><span class="token function">find</span><span class="token punctuation">(</span><span class="token parameter">e</span> <span class="token operator">=></span> e<span class="token punctuation">.</span>asset_type <span class="token operator">===</span> <span class="token string">'native'</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">return</span> res<span class="token punctuation">.</span>balance<span class="token punctuation">;</span> <span class="token punctuation">}</span><span class="token punctuation">;</span> |
Fee Bumps
Bài viết này mình sẽ hướng dẫn các bạn sử dụng SDK của Stellar để sử dụng Protocol này còn nếu bạn muốn tìm hiểu rõ hơn về nguyên lý có thể tham khảo qua bài viết : https://medium.com/stellar-community/fee-bump-transactions-explained-9a6a365c0fb6
Mình sẽ viêt code để chia 1 Trx truyền thống thành 2 phần : Khởi tạo Trx và Trả phí Trx:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 | <span class="token keyword">const</span> <span class="token function-variable function">createFeeBumpTx</span> <span class="token operator">=</span> <span class="token keyword">async</span> <span class="token punctuation">(</span><span class="token parameter">_privateKey<span class="token punctuation">,</span> _to<span class="token punctuation">,</span> _amount</span><span class="token punctuation">)</span> <span class="token operator">=></span> <span class="token punctuation">{</span> <span class="token keyword">const</span> keypair <span class="token operator">=</span> Keypair<span class="token punctuation">.</span><span class="token function">fromSecret</span><span class="token punctuation">(</span>_privateKey<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">var</span> innerTx<span class="token punctuation">;</span> <span class="token keyword">const</span> res <span class="token operator">=</span> <span class="token keyword">await</span> server<span class="token punctuation">.</span><span class="token function">loadAccount</span><span class="token punctuation">(</span>keypair<span class="token punctuation">.</span><span class="token function">publicKey</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">then</span><span class="token punctuation">(</span><span class="token parameter">account</span> <span class="token operator">=></span> <span class="token punctuation">{</span> innerTx <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TransactionBuilder</span><span class="token punctuation">(</span>account<span class="token punctuation">,</span> <span class="token punctuation">{</span> fee<span class="token operator">:</span> baseFee<span class="token punctuation">,</span> networkPassphrase<span class="token punctuation">,</span> v1<span class="token operator">:</span> <span class="token boolean">true</span> <span class="token punctuation">}</span><span class="token punctuation">)</span> <span class="token comment">// .addOperation(</span> <span class="token comment">// Operation.bumpSequence({</span> <span class="token comment">// bumpTo: '0'</span> <span class="token comment">// })</span> <span class="token comment">// )</span> <span class="token comment">// .setTimeout(0)</span> <span class="token punctuation">.</span><span class="token function">addOperation</span><span class="token punctuation">(</span> Operation<span class="token punctuation">.</span><span class="token function">payment</span><span class="token punctuation">(</span><span class="token punctuation">{</span> destination<span class="token operator">:</span> _to<span class="token punctuation">,</span> <span class="token comment">// Because Stellar allows transaction in many currencies, you must</span> <span class="token comment">// specify the asset type. The special "native" asset represents Lumens.</span> asset<span class="token operator">:</span> Asset<span class="token punctuation">.</span><span class="token function">native</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">,</span> amount<span class="token operator">:</span> _amount<span class="token punctuation">.</span><span class="token function">toString</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">}</span><span class="token punctuation">)</span> <span class="token punctuation">)</span> <span class="token comment">// Wait a maximum of three minutes for the transaction</span> <span class="token punctuation">.</span><span class="token function">setTimeout</span><span class="token punctuation">(</span><span class="token number">180</span><span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">build</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> innerTx<span class="token punctuation">.</span><span class="token function">sign</span><span class="token punctuation">(</span>keypair<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">return</span> innerTx<span class="token punctuation">;</span> <span class="token punctuation">}</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">return</span> res<span class="token punctuation">;</span> <span class="token punctuation">}</span><span class="token punctuation">;</span> <span class="token keyword">const</span> <span class="token function-variable function">submitFeeBumpTrx</span> <span class="token operator">=</span> <span class="token keyword">async</span> <span class="token punctuation">(</span><span class="token parameter">_privateKey<span class="token punctuation">,</span> _trxObj</span><span class="token punctuation">)</span> <span class="token operator">=></span> <span class="token punctuation">{</span> console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span>_trxObj<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">const</span> feeSource <span class="token operator">=</span> Keypair<span class="token punctuation">.</span><span class="token function">fromSecret</span><span class="token punctuation">(</span>_privateKey<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">const</span> feeBumpTxn <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TransactionBuilder<span class="token punctuation">.</span>buildFeeBumpTransaction</span><span class="token punctuation">(</span> feeSource<span class="token punctuation">,</span> baseFee<span class="token punctuation">,</span> _trxObj<span class="token punctuation">,</span> networkPassphrase <span class="token punctuation">)</span><span class="token punctuation">;</span> feeBumpTxn<span class="token punctuation">.</span><span class="token function">sign</span><span class="token punctuation">(</span>feeSource<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">return</span> server<span class="token punctuation">.</span><span class="token function">submitTransaction</span><span class="token punctuation">(</span>feeBumpTxn<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span><span class="token punctuation">;</span> |
Đầu tiên với function createFeeBumpTx sẽ nhận 3 tham số đầu vào bao gồm:
- _privateKey : Privatekey dùng để kí Trx được khởi tạo
- _to: Publickey của account sẽ nhận lượng _amount lumen
- _amount : Lượng lumen được chuyển trong giao dịch
Kết quả trả về sẽ là object của 1 Trx được khởi tạo từ SDK TransactionBuilder, các thông tin về địa chỉ gửi và nhận đã được điền đầy đủ. Sau khi hoàn chỉnh chúng ta sẽ sử dụng đến hàm submitFeeBumpTrx để submit Trx vừa khởi tạo lên mạng.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | <span class="token keyword">const</span> <span class="token function-variable function">submitFeeBumpTrx</span> <span class="token operator">=</span> <span class="token keyword">async</span> <span class="token punctuation">(</span><span class="token parameter">_privateKey<span class="token punctuation">,</span> _trxObj</span><span class="token punctuation">)</span> <span class="token operator">=></span> <span class="token punctuation">{</span> console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span>_trxObj<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">const</span> feeSource <span class="token operator">=</span> Keypair<span class="token punctuation">.</span><span class="token function">fromSecret</span><span class="token punctuation">(</span>_privateKey<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">const</span> feeBumpTxn <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TransactionBuilder<span class="token punctuation">.</span>buildFeeBumpTransaction</span><span class="token punctuation">(</span> feeSource<span class="token punctuation">,</span> baseFee<span class="token punctuation">,</span> _trxObj<span class="token punctuation">,</span> networkPassphrase <span class="token punctuation">)</span><span class="token punctuation">;</span> feeBumpTxn<span class="token punctuation">.</span><span class="token function">sign</span><span class="token punctuation">(</span>feeSource<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">return</span> server<span class="token punctuation">.</span><span class="token function">submitTransaction</span><span class="token punctuation">(</span>feeBumpTxn<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span><span class="token punctuation">;</span> |
Trong hàm này sẽ nhận 2 đối số đầu vào là :
- _privatekey: Dùng để kí Trx
- _trxObj: Đây chính là object được khởi tạo thông qua SDK TransactionBuilder phía trên được gửi qua để trả phí
Cuối cùng chạy kết hợp 2 hàm lại để hoàn chỉnh 1 luồng Fee Bump:
1 2 3 4 5 6 7 8 9 10 | <span class="token function">createFeeBumpTx</span><span class="token punctuation">(</span> <span class="token string">'SAIO6VONEI2GY2LD32LECMHTKJYANHTOPBXDSPQ7BEXBMQ3PTI2NJMKN'</span><span class="token punctuation">,</span> <span class="token string">'GATNAV6NZ77OUJ3K26ZBR2POHNVCVEV3VUPV5ATBLBNITWQDQ5BZWQJR'</span><span class="token punctuation">,</span> <span class="token number">100</span> <span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">then</span><span class="token punctuation">(</span><span class="token parameter">e</span> <span class="token operator">=></span> <span class="token punctuation">{</span> <span class="token function">submitFeeBumpTrx</span><span class="token punctuation">(</span><span class="token string">'SDEOACSWLLCHBOACI3K6EDAB33XM3JQ4NVG6NVGGTJISCTLVP2WRKVHX'</span><span class="token punctuation">,</span> e<span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">then</span><span class="token punctuation">(</span><span class="token parameter">res</span> <span class="token operator">=></span> console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span>res<span class="token punctuation">)</span> <span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
Các bạn mở terminal và chạy để xem kết quả nhé
Claimable Balances
Như định nghĩa thì Protocol này cũng sẽ chia một Trx thông thường thành 2 phần gồm Khởi tạo balance và Claim
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 | <span class="token keyword">async</span> <span class="token keyword">function</span> <span class="token function">createClaimable</span><span class="token punctuation">(</span><span class="token parameter">_privatekey<span class="token punctuation">,</span> _publicKey<span class="token punctuation">,</span> _amount</span><span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token keyword">const</span> kp <span class="token operator">=</span> Keypair<span class="token punctuation">.</span><span class="token function">fromSecret</span><span class="token punctuation">(</span>_privatekey<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">const</span> kp_public <span class="token operator">=</span> kp<span class="token punctuation">.</span><span class="token function">publicKey</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">await</span> server <span class="token punctuation">.</span><span class="token function">loadAccount</span><span class="token punctuation">(</span>kp_public<span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">then</span><span class="token punctuation">(</span><span class="token parameter">account</span> <span class="token operator">=></span> <span class="token punctuation">{</span> <span class="token keyword">const</span> transaction <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TransactionBuilder</span><span class="token punctuation">(</span>account<span class="token punctuation">,</span> <span class="token punctuation">{</span> fee<span class="token operator">:</span> <span class="token constant">BASE_FEE</span><span class="token punctuation">,</span> networkPassphrase<span class="token operator">:</span> Networks<span class="token punctuation">.</span><span class="token constant">TESTNET</span> <span class="token punctuation">}</span><span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">addOperation</span><span class="token punctuation">(</span> Operation<span class="token punctuation">.</span><span class="token function">createClaimableBalance</span><span class="token punctuation">(</span><span class="token punctuation">{</span> asset<span class="token operator">:</span> Asset<span class="token punctuation">.</span><span class="token function">native</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">,</span> amount<span class="token operator">:</span> _amount<span class="token punctuation">.</span><span class="token function">toString</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">,</span> claimants<span class="token operator">:</span> <span class="token punctuation">[</span><span class="token keyword">new</span> <span class="token class-name">Claimant</span><span class="token punctuation">(</span>_publicKey<span class="token punctuation">)</span><span class="token punctuation">]</span> <span class="token punctuation">}</span><span class="token punctuation">)</span> <span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">setTimeout</span><span class="token punctuation">(</span><span class="token number">0</span><span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">build</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> transaction<span class="token punctuation">.</span><span class="token function">sign</span><span class="token punctuation">(</span>kp<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token comment">// return transaction.toXDR()</span> <span class="token keyword">return</span> server<span class="token punctuation">.</span><span class="token function">submitTransaction</span><span class="token punctuation">(</span>transaction<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span><span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">catch</span><span class="token punctuation">(</span><span class="token parameter">e</span> <span class="token operator">=></span> console<span class="token punctuation">.</span><span class="token function">error</span><span class="token punctuation">(</span>e<span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token keyword">async</span> <span class="token keyword">function</span> <span class="token function">claim</span><span class="token punctuation">(</span><span class="token parameter">_privatekey</span><span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token keyword">const</span> kp <span class="token operator">=</span> Keypair<span class="token punctuation">.</span><span class="token function">fromSecret</span><span class="token punctuation">(</span>_privatekey<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">const</span> kp_public <span class="token operator">=</span> kp<span class="token punctuation">.</span><span class="token function">publicKey</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">try</span> <span class="token punctuation">{</span> <span class="token keyword">await</span> server<span class="token punctuation">.</span><span class="token function">loadAccount</span><span class="token punctuation">(</span>kp_public<span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">then</span><span class="token punctuation">(</span><span class="token keyword">async</span> <span class="token parameter">account</span> <span class="token operator">=></span> <span class="token punctuation">{</span> <span class="token comment">// await account.claimableBalances() :(</span> <span class="token keyword">const</span> <span class="token punctuation">{</span> records <span class="token punctuation">}</span> <span class="token operator">=</span> <span class="token keyword">await</span> server<span class="token punctuation">.</span><span class="token function">claimableBalances</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">claimant</span><span class="token punctuation">(</span>account<span class="token punctuation">.</span>id<span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">call</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token keyword">if</span> <span class="token punctuation">(</span><span class="token operator">!</span>records<span class="token punctuation">.</span>length<span class="token punctuation">)</span> <span class="token keyword">return</span><span class="token punctuation">;</span> records<span class="token punctuation">.</span><span class="token function">map</span><span class="token punctuation">(</span><span class="token parameter">record</span> <span class="token operator">=></span> <span class="token punctuation">{</span> <span class="token keyword">let</span> transaction <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TransactionBuilder</span><span class="token punctuation">(</span>account<span class="token punctuation">,</span> <span class="token punctuation">{</span> fee<span class="token operator">:</span> <span class="token constant">BASE_FEE</span><span class="token punctuation">,</span> networkPassphrase<span class="token operator">:</span> Networks<span class="token punctuation">.</span><span class="token constant">TESTNET</span> <span class="token punctuation">}</span><span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">addOperation</span><span class="token punctuation">(</span> Operation<span class="token punctuation">.</span><span class="token function">claimClaimableBalance</span><span class="token punctuation">(</span><span class="token punctuation">{</span> balanceId<span class="token operator">:</span> record<span class="token punctuation">.</span>id <span class="token punctuation">}</span><span class="token punctuation">)</span> <span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">setTimeout</span><span class="token punctuation">(</span><span class="token number">0</span><span class="token punctuation">)</span> <span class="token punctuation">.</span><span class="token function">build</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> transaction<span class="token punctuation">.</span><span class="token function">sign</span><span class="token punctuation">(</span>kp<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token comment">// return transaction.toXDR()</span> <span class="token keyword">return</span> server<span class="token punctuation">.</span><span class="token function">submitTransaction</span><span class="token punctuation">(</span>transaction<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token keyword">catch</span> <span class="token punctuation">(</span>e<span class="token punctuation">)</span> <span class="token punctuation">{</span> console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span>e<span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token punctuation">}</span> |
Đầu tiên hàm createClaimable sẽ nhận các đối số đầu vào :
- _privatekey: Dùng để kí Trx
- _publickey: Publickey của địa chỉ sẽ có thể claim balance được khởi tạo
- __amount: Lượng lumen được khởi tạo có thể cho claim
Với hàm này sẽ sử dụng SDK Operation khởi tạo balance với đối số claimants là publickey của địa chỉ có thể claim Balance này.
Trong hàm claim chỉ chưa privatekey của người nhận để có thể tạo Trx Claim. Trong hàm này sẽ có các phần chính là :
- const { records } = await server.claimableBalances().claimant(account.id).call() : Hàm này dùng để query các khoán balance mà tài khoản này được gán (có thể claim về được)
- claimClaimableBalance: phần này dùng để claim balance theo balanceId mà đã được query từ phía trên, trong ví dụ này mình sẽ query một loạt toàn bộ các khoản có thể claim được.
Cuối cùng là sẽ phải submitTransaction lên mạng Stellar
Và các bạn có thể chạy thử :
1 2 3 4 5 6 7 8 | <span class="token function">createClaimable</span><span class="token punctuation">(</span> <span class="token string">'SAIO6VONEI2GY2LD32LECMHTKJYANHTOPBXDSPQ7BEXBMQ3PTI2NJMKN'</span><span class="token punctuation">,</span> <span class="token string">'GATNAV6NZ77OUJ3K26ZBR2POHNVCVEV3VUPV5ATBLBNITWQDQ5BZWQJR'</span><span class="token punctuation">,</span> <span class="token number">10</span> <span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">then</span><span class="token punctuation">(</span><span class="token parameter">e</span> <span class="token operator">=></span> <span class="token punctuation">{</span> <span class="token function">claim</span><span class="token punctuation">(</span><span class="token string">'SDEOACSWLLCHBOACI3K6EDAB33XM3JQ4NVG6NVGGTJISCTLVP2WRKVHX'</span><span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">then</span><span class="token punctuation">(</span><span class="token parameter">e</span> <span class="token operator">=></span> console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span>e<span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token punctuation">}</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
Lại cùng tự mở terminal lên chạy và cảm nhận nhé !
Phần code mình đã chuẩn bị ở đây các bạn có thể tham khảo qua nhé:
https://github.com/tranchien2002/lumens