Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

BEP-299: Token Migration after BC Fusion #299

Merged
merged 4 commits into from
Feb 27, 2024
Merged

BEP-299: Token Migration after BC Fusion #299

merged 4 commits into from
Feb 27, 2024
+94 −0

Conversation

j75689
Copy link
Contributor

@j75689 j75689 commented Oct 18, 2023 •
edited
Loading 

  BEP: 299
  Title: Token Migration after BC Fusion
  Status: Draft
  Type: Standards
  Created: 2023-10-16

BEP-299: Token Migration after BC Fusion

1. Summary

After the Beacon Chain fusion, certain digital assets remain on the Beacon Chain. This proposal presents a secure and trustless solution for users to recover their assets on the BSC once the BC stops running.

2. Abstract

Before the discontinuation of operations on the Beacon Chain, it is highly recommended that users promptly transfer their assets to other networks through cross-chain transactions. Once BC ceases operations, the community team will capture a snapshot of users' assets on BC, which will be publicly released and acknowledged by the community. Subsequently, a Merkle tree will be generated based on the users' balances in the snapshot. The root of this tree will be stored in the system contract of BNB Smart Chain (BSC).

Any user can prove their ownership of the original tokens on BC by providing a Merkle proof and their BC account's signature. Once the ownership and token information are verified, the system contract on BSC will unlock the corresponding amount of tokens from the token hub and allocate them to the user's account on BSC. Users can initiate token claims through a web app or command line interface (CLI).

3. Status

Draft.

4. Motivation

The Beacon Chain was originally created as a platform for issuing data assets. Currently, there are 7.6 million accounts on BC, along with 557 tokens that comply with the BEP2 or BEP8 standards. The digital assets of these users will not vanish with BC Fusion. BNB Chain is responsible for safeguarding the assets of these users, irrespective of their value. Users do not have a specific ETA to access these assets. However, BC Fusion is expected to happen within a reasonable timeframe. We plan to implement a solution that enables the timely execution of BC Fusion and secure access to users' digital assets afterwards.

5. Specification

5.1 Asset Back to Wallet

Digital assets on the BNB Beacon Chain may not always be stored in a user's wallet in specific situations. For example, when users participate in staking, their BNB is actually transferred to the system account of the staking module until they redeem it. Modules that can cause similar asset transfers include:

  • Staking module.
  • Timelock module.
  • Atomic swap module.
  • Governance module.

The mentioned modules allow users to contribute funds to a shared pool, making it difficult to distinguish an individual user's share. Hence, we need a solution to ensure users can retrieve their funds into their wallets.

Before BC (Blockchain) comes to a halt, the following logic will be executed:

  1. Disable all transactions that would channel user funds into the liquidity pool.
  2. During the endblock phase, the following transactions are automatically triggered to return user funds to their wallets, like unstake, timer unlock, and atomic swap unlock.

Assets in a user's wallet can be in three states: Free, Frozen, and Locked. When calculating the asset balance, we consider the quantities in all three states. So, even if a token is Locked or Frozen when the Beacon Chain halts, it can still be recovered on the BSC chain.

5.2 Asset Recover

5.2.1 Asset Tree

Asset Tree

The user's asset is abstracted as a node, which includes the account address, symbol, and amount. We'll exclude assets from non-EOA accounts, including module system accounts and clearly dead addresses. All these nodes are sorted in lexicographical order based on their keys, and then used to construct a Merkle tree. This Merkle tree will be published in the form of a file on GitHub and Greenfield, allowing anyone to verify the accuracy of their assets based on this file. Community members can challenge the accuracy and integrity of this document, and if any errors are found, the core team will make corrections until there are no objections.

The Merkle tree enables anyone to verify token ownership on the blockchain using a Merkle proof. It ensures that an account possesses a specific number of tokens represented by the symbol "symbol."

Note that only tokens that have been linked to BEP20 tokens on BSC will create a Node. Therefore, assets that have not been mirrored to BSC prior to the BC halting can not be restored.

5.2.2 Asset Recovery App

Asset Recovery App

This system consists of two main components:

  1. Approval server. This is an off-chain API service operated by the BNB Chain Foundation. It enables users to retrieve assets by providing merkle proof and approval signature. Only with the approval signature can users recover assets from the BSC network.
  2. Asset Claim Contract. This contract is responsible for handling users' requests to claim assets. It verifies and records the requests to prevent duplicate claims.

The key process for users to claim assets in the BSC network is as follows:

  1. Users use the private key of the asset owner on BC to sign {account address, symbol, amount, receiver}, and request approval through the approval server.
  2. The approval server will fetch the node from a trust merkle tree, and
    a. verify the account, symbol, amount are correct.
    b. the signature is signed by the token owner.
    c. the token is not claimed yet.
    After that, the approval will generate the merkle proof for this request and sign for the request using its approval key.
  3. The user will send a transaction to the Asset Claim contract with merkle proof, node info, BC signature, signature from the approver, receiver account.
  4. The Asset Claim contract will do following checks
    a. The asset of this node is never claimed.
    b. The approval signature comes from the approver.
    c. The BC signature comes from the owner of the token.
    d. The merkle proof is able to prove the node is a leaf node of the tree.
    After all checks are passed, the Asset Claim contract will invoke the token hub contract to unlock the corresponding token to the receiver.

5.2.3 Security Enhancement

Considering the highly flexible implementation approach of BEP20 tokens on theBSC, there may be unforeseen scenarios that the BEP overlooks. During the initial phase of the BEP, the Approval Server only allows for the tokens in a whitelist that can be claimed.

For tokens that are not in the whitelist, users can submit requests on the forum. After the core developers review the security of the token, it can be added to the whitelist.

6. License

The content is licensed under CC0.

@j75689 j75689 changed the title BEP-298: Token Migration after BC Fusion BEP-299: Token Migration after BC Fusion Oct 31, 2023
This was referenced Nov 10, 2023
Merged
Merged
@j75689 j75689 mentioned this pull request Nov 24, 2023
Merged
@forcodedancing forcodedancing mentioned this pull request Nov 29, 2023
Merged
@j75689 j75689 mentioned this pull request Nov 29, 2023
Merged
4 tasks
@unclezoro unclezoro mentioned this pull request Dec 7, 2023
Merged
musk-j
musk-j reviewed Dec 11, 2023
View reviewed changes
BEPs/BEP-299.md

Before the discontinuation of operations on the Beacon Chain, it is highly recommended that users promptly transfer their assets to other networks through cross-chain transactions. Once BC ceases operations, the community team will capture a snapshot of users' assets on BC, which will be publicly released and acknowledged by the community. Subsequently, a Merkle tree will be generated based on the users' balances in the snapshot. The root of this tree will be stored in the system contract of BNB Smart Chain (BSC).

Any user can prove their ownership of the original tokens on BC by providing a Merkle proof and their BC account's signature. Once the ownership and token information are verified, the system contract on BSC will unlock the corresponding amount of tokens from the token hub and allocate them to the user's account on BSC. Users can initiate token claims through a web app or command line interface (CLI).
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

a user-friendly web app or a command-line interface (CLI)
--> Do we have a repository for this tool/app. If we do, could you please share the link.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good job

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please help recover my all bnb toucan

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same here, my coin are still in bep2 in my trust wallet but I don't have enough bnb(bep2) as gas fee. This is really frustrating. Please help

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I want my wallet back

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

سلام اگر رمز عبور. خود را گم کرده اید دیگر کاری نمی‌شود انجام. داد. واقعا ناراحت کننده هست این موضوع

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Send me my money

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

اگر فکر میکنی رمز خود را. می‌دانی پول ار آن توست اگر که نه. من هم مثل شما قربانی شدم و از این بابت واقعا. متاسفم هستم

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Vreau sa recuperez bani

@Meksenmarley1
Copy link

Send

This was referenced Jan 15, 2024
Merged
Merged
Daniel618-art
Daniel618-art approved these changes Feb 15, 2024
View reviewed changes
Copy link

@Daniel618-art Daniel618-art left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good job

BEPs/BEP-299.md

Before the discontinuation of operations on the Beacon Chain, it is highly recommended that users promptly transfer their assets to other networks through cross-chain transactions. Once BC ceases operations, the community team will capture a snapshot of users' assets on BC, which will be publicly released and acknowledged by the community. Subsequently, a Merkle tree will be generated based on the users' balances in the snapshot. The root of this tree will be stored in the system contract of BNB Smart Chain (BSC).

Any user can prove their ownership of the original tokens on BC by providing a Merkle proof and their BC account's signature. Once the ownership and token information are verified, the system contract on BSC will unlock the corresponding amount of tokens from the token hub and allocate them to the user's account on BSC. Users can initiate token claims through a web app or command line interface (CLI).
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good job

@blxdyx blxdyx mentioned this pull request Feb 19, 2024
Merged
This was referenced Feb 27, 2024
Merged
Merged
@unclezoro unclezoro merged commit 7ba9265 into bnb-chain:master Feb 27, 2024
@Bukaram Bukaram mentioned this pull request Mar 26, 2024
Closed
@Alexforestaneev
Copy link

0xE3E8f928b5b8a628C6ef02c730CC5fFf547d1dd9

jircs
jircs reviewed Apr 21, 2024
View reviewed changes
Copy link

@jircs jircs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

Vekiepepito
Vekiepepito reviewed Apr 30, 2024
View reviewed changes
Copy link

@Vekiepepito Vekiepepito left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Exactement

@immense055
Copy link

89d5329

@Alexforestaneev
Copy link

Г

@minkewkim
Copy link

minkewkim commented Dec 24, 2024 via email

@farzi1347
Copy link

farzi1347 commented Dec 25, 2024 •
edited
Loading

Stop being mean! You're not Einstein here! You should be happy people are asking you to share your knowledge not be rude about it!
in my experience Mr santaklaws's share in community helping comments is at least 10 % of all.what about you? : a real expectant person. why you say rude or mean to him instead of thanking. it's better every body who can help @zevxis ,dose'nt hesitate any help but cares about clicking on links that he sends or preventing to show him sensitive personal wallet data. god bless you all.

@zevxis
Copy link

zevxis commented Dec 26, 2024

https://www.youtube.com/watch?v=b30GOw_tbpU

@ashil1359
Copy link

ashil1359 commented Dec 27, 2024 via email

@6flaggeddrains
Copy link

6flaggeddrains commented Dec 27, 2024 via email

@zevxis
Copy link

zevxis commented Dec 28, 2024

PROGRESS! i successfully imported my atomic wallet. (woohoo). but i now face the dreaded 'insufficient BNB balance for gas fee'. given that the asset i am trying to recover is BNB itself, does that mean i have to have a separate balance of BNB in the trust wallet itself?

@Santaklawz
Copy link

Santaklawz commented Dec 28, 2024 via email

@6flaggeddrains
Copy link

6flaggeddrains commented Dec 28, 2024 via email

@6flaggeddrains
Copy link

6flaggeddrains commented Dec 28, 2024 via email

@jureba16
Copy link

O único token que não vamos conseguir será o chz mesmo ?
é muito triste estou com um valor de 3k em brl brasileiro

@zevxis
Copy link

zevxis commented Dec 30, 2024 via email

@marinobucci
Copy link

I believe the transaction is stuck and now I am unable to do anything further.

MIGRATION TRANSACTION: https://explorer.bnbchain.org/tx/1DC22F5133B7BA6FB20E3F9F48680F041A79199C92AC86A0050ED38BB7150BC9

I have BNB Beacon in my TrustWallet on my phone.
IMG_8487
IMG_8486

But the Trust Wallet web browser extension does not show any BNB Beacon balance at all.
Screenshot 2024-12-30 at 9 30 02 PM

Therefore, when I attempt to use the https://www.bnbchain.org/en/token-recovery tool there is no BNB Beacon coin to recover shown, despite there actually being a balance in my wallet. I have tried disconnecting and reconnecting numerous times with no answer.

I transferred BNB from my Binance to my Trust Wallet BEP2 Address four times, the transaction already confirmed and it showed on my trust wallet but the asset did not show, it still shows zero balance. I already reinstalled the apps but still, the asset does not show, I've reconnected my wallets to the browser and nothing seems to work.

I saw on the community forum to submit a ticket to customer support at https://support.trustwallet.com/ regarding this, but only the chat bot is available and is unable to help.

I have been scammed already, losing all my assets in TrustWallet because I was not able to get ahold of a real support agent. The only thing that remains in my Wallet is the BNB Beacon that I am unable to convert or do anything with. I am just trying to actually connect with a single human individual from Trust Wallet.

Please advise, I am desperate.

https://explorer.bnbchain.org/tx/1DC22F5133B7BA6FB20E3F9F48680F041A79199C92AC86A0050ED38BB7150BC9

@farzi1347
Copy link

farzi1347 commented Dec 31, 2024 •
edited
Loading

I believe the transaction is stuck and now I am unable to do anything further.

MIGRATION TRANSACTION: https://explorer.bnbchain.org/tx/1DC22F5133B7BA6FB20E3F9F48680F041A79199C92AC86A0050ED38BB7150BC9

I have BNB Beacon in my TrustWallet on my phone. IMG_8487 IMG_8486

But the Trust Wallet web browser extension does not show any BNB Beacon balance at all. Screenshot 2024-12-30 at 9 30 02 PM

Therefore, when I attempt to use the https://www.bnbchain.org/en/token-recovery tool there is no BNB Beacon coin to recover shown, despite there actually being a balance in my wallet. I have tried disconnecting and reconnecting numerous times with no answer.

I transferred BNB from my Binance to my Trust Wallet BEP2 Address four times, the transaction already confirmed and it showed on my trust wallet but the asset did not show, it still shows zero balance. I already reinstalled the apps but still, the asset does not show, I've reconnected my wallets to the browser and nothing seems to work.

I saw on the community forum to submit a ticket to customer support at https://support.trustwallet.com/ regarding this, but only the chat bot is available and is unable to help.

I have been scammed already, losing all my assets in TrustWallet because I was not able to get ahold of a real support agent. The only thing that remains in my Wallet is the BNB Beacon that I am unable to convert or do anything with. I am just trying to actually connect with a single human individual from Trust Wallet.

Please advise, I am desperate.

https://explorer.bnbchain.org/tx/1DC22F5133B7BA6FB20E3F9F48680F041A79199C92AC86A0050ED38BB7150BC9

according to your extension wallet list youre BNB is migrated to Bsc. but the reason why you can't see it in main wallet,is not clear. at all for successfull migration from bnb beacon to bsc there should be a small amount of bnb in your bsc acount.at your main wallet your bsc ballance is hidden but it is shown in extention wallet.is it possible to swap your bsc ballance at extension wallet to another crypto? if so, follow it .

@ashil1359
Copy link

My aave is migrated but my yfi and wrx is not. FtM and CoTI still to respond to us and chinance with a solution On 27 Dec 2024 18:21, ashil1359 @.> wrote: HI . This automatic conversion has not yet occurred. what should i do can you help ? On Thu, Dec 19, 2024 at 12:09 PM Santaklawz @.> wrote:
According to what I read all staked bnb should automatically return to the original wallet On Thu, Dec 19, 2024 at 11:37 AM ashil1359 @.> wrote: > help me > I have two BNB bep2 that I have staked in Trustwallet and it cannot be > unstak for recovery unactivation of the network(bep2) and the recovery site > does not show the balance of wallet either. I don't know what to do. help > please > To convert BNB BEP2 to BNB BEP20, I have to unstak, which Trust Wallet > does not do. And www.bnbchain.org/en/token-recovery site doesn't know my > wallet. > > — > Reply to this email directly, view it on GitHub > <#299 (comment)>, or > unsubscribe > < https://github.com/notifications/unsubscribe-auth/AUZ5IQ6ATWUOKWXTDJ3Y57D2GKAUFAVCNFSM6AAAAAA6EXBJJOVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDKNJTGA4DAMZZHA> > . > You are receiving this because you were mentioned.Message ID: > @.> > — Reply to this email directly, view it on GitHub <#299 (comment)>, or unsubscribe https://github.com/notifications/unsubscribe-auth/BN2KKTOSQMMANDURRSTEGE32GKA5JAVCNFSM6AAAAAA6EXBJJOVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDKNJTGA4DIMZTGU . You are receiving this because you commented.Message ID: @.>
—Reply to this email directly, view it on GitHub, or unsubscribe.You are receiving this because you commented.Message ID: @.>
Hi
hep me
How long do I have to wait for the recovery of staked BNBs to be done automatically.
Because automatic recovery has not yet been done .
tnx

@pm22005
Copy link

pm22005 commented Jan 8, 2025

Is there a way to recover exactly BNB tokens?
Not some other tokens on BEP2 but exactly BNB (Beacon Chain).

@Bnbbeacon
Copy link

Bnbbeacon commented Jan 8, 2025 via email

@Santaklawz
Copy link

Santaklawz commented Jan 8, 2025 via email

@Goddessnunu22
Copy link

alright...just seeking to confirm... status on BNB chain org: 'waiting for finalizing recovery ... 5 days remaining' status on bscscan org...from 'method/recovery' line: 'age': 42hours...'to' (seems to be a generic address)...'amount' (doesn't register yet) ...is there anything further i have to do to convert or just wait until it appears in my trust wallet/bscscan, fully converted?  On Saturday, December 28, 2024 at 11:02:08 AM EST, 6flaggeddrains @.> wrote: Just buy 20$of bnb on bep20On 28 Dec 2024 13:06, zevxis @.> wrote: PROGRESS! i successfully imported my atomic wallet. (woohoo). but i now face the dreaded 'insufficient BNB balance for gas fee'. given that the asset i am trying to recover is BNB itself, does that mean i have to have a separate balance of BNB in the trust wallet itself? —Reply to this email directly, view it on GitHub, or unsubscribe.You are receiving this because you commented.Message ID: @.> — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you were mentioned.Message ID: @.>

What do I do I really don't understand it. [email protected]

@Goddessnunu22
Copy link

I had mine done and my Trust wallet shows the funds transferred but it also still shows the funds in the beacon chain. The balance has both added in to the total amount invested. Has anyone else seen this?  Sent from Yahoo Mail for iPhone On Wednesday, January 8, 2025, 1:15 PM, pm22005 @.> wrote: Is there a way to recover exactly BNB tokens? Not some other tokens on BEP2 but exactly BNB (Beacon Chain). — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you commented.Message ID: @.>

Withdrawal

Goddessnunu22
Goddessnunu22 reviewed Jan 9, 2025
View reviewed changes
Copy link

@Goddessnunu22 Goddessnunu22 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

BEPs/BEP-299.md

@Goddessnunu22 Goddessnunu22 mentioned this pull request Jan 9, 2025
Closed
@6flaggeddrains
Copy link

6flaggeddrains commented Jan 9, 2025 via email

@6flaggeddrains
Copy link

6flaggeddrains commented Jan 9, 2025 via email

@alessandrorusso-code
Copy link

Anche chiliz non permette il recupero delle monete, anzi dice che è solo colpa nostra. Chiaramente hanno intenzione di prendere le nostre monete.
Abbiamo creato un gruppo per delle azioni per il recupero delle monete. Contatti a ilcentropianoro [at] libero.it

Potrei aggiungere che un amministratore nella chat di Sonic ha completamente travisato la situazione, il mese scorso ha affermato che FTM stava lavorando a una soluzione con la finanza e solo la scorsa settimana ha detto a un altro povero individuo che non era possibile e che avevamo perso tutto
…
On 9 Jan 2025, at 20:22, Goddessnunu22 @.***> wrote: @Goddessnunu22 commented on this pull request. BEPs/BEP-299.md — Reply to this email directly, view it on GitHub <#299 (review)>, or unsubscribe https://github.com/notifications/unsubscribe-auth/BNSBW4PXF3273OY4JYH5A7T2J3LA7AVCNFSM6AAAAAA6EXBJJOVHI2DSMVQWIX3LMV43YUDVNRWFEZLROVSXG5CSMV3GSZLXHMZDKNBQHA2TKNZTGI. You are receiving this because you commented.

@Goddessnunu22
Copy link

BEP: 299
Title: Token Migration after BC Fusion
Status: Draft
Type: Standards
Created: 2023-10-16

BEP-299: Token Migration after BC Fusion

1. Summary

After the Beacon Chain fusion, certain digital assets remain on the Beacon Chain. This proposal presents a secure and trustless solution for users to recover their assets on the BSC once the BC stops running.

2. Abstract

Before the discontinuation of operations on the Beacon Chain, it is highly recommended that users promptly transfer their assets to other networks through cross-chain transactions. Once BC ceases operations, the community team will capture a snapshot of users' assets on BC, which will be publicly released and acknowledged by the community. Subsequently, a Merkle tree will be generated based on the users' balances in the snapshot. The root of this tree will be stored in the system contract of BNB Smart Chain (BSC).

Any user can prove their ownership of the original tokens on BC by providing a Merkle proof and their BC account's signature. Once the ownership and token information are verified, the system contract on BSC will unlock the corresponding amount of tokens from the token hub and allocate them to the user's account on BSC. Users can initiate token claims through a web app or command line interface (CLI).

3. Status

Draft.

4. Motivation

The Beacon Chain was originally created as a platform for issuing data assets. Currently, there are 7.6 million accounts on BC, along with 557 tokens that comply with the BEP2 or BEP8 standards. The digital assets of these users will not vanish with BC Fusion. BNB Chain is responsible for safeguarding the assets of these users, irrespective of their value. Users do not have a specific ETA to access these assets. However, BC Fusion is expected to happen within a reasonable timeframe. We plan to implement a solution that enables the timely execution of BC Fusion and secure access to users' digital assets afterwards.

5. Specification

5.1 Asset Back to Wallet

Digital assets on the BNB Beacon Chain may not always be stored in a user's wallet in specific situations. For example, when users participate in staking, their BNB is actually transferred to the system account of the staking module until they redeem it. Modules that can cause similar asset transfers include:

  • Staking module.
  • Timelock module.
  • Atomic swap module.
  • Governance module.

The mentioned modules allow users to contribute funds to a shared pool, making it difficult to distinguish an individual user's share. Hence, we need a solution to ensure users can retrieve their funds into their wallets.

Before BC (Blockchain) comes to a halt, the following logic will be executed:

  1. Disable all transactions that would channel user funds into the liquidity pool.
  2. During the endblock phase, the following transactions are automatically triggered to return user funds to their wallets, like unstake, timer unlock, and atomic swap unlock.

Assets in a user's wallet can be in three states: Free, Frozen, and Locked. When calculating the asset balance, we consider the quantities in all three states. So, even if a token is Locked or Frozen when the Beacon Chain halts, it can still be recovered on the BSC chain.

5.2 Asset Recover

5.2.1 Asset Tree

Asset Tree The user's asset is abstracted as a node, which includes the _account address, symbol, and amount_. We'll exclude assets from non-EOA accounts, including module system accounts and clearly dead addresses. All these nodes are sorted in lexicographical order based on their keys, and then used to construct a Merkle tree. This Merkle tree will be published in the form of a file on GitHub and Greenfield, allowing anyone to verify the accuracy of their assets based on this file. Community members can challenge the accuracy and integrity of this document, and if any errors are found, the core team will make corrections until there are no objections.

The Merkle tree enables anyone to verify token ownership on the blockchain using a Merkle proof. It ensures that an account possesses a specific number of tokens represented by the symbol "symbol."

Note that only tokens that have been linked to BEP20 tokens on BSC will create a Node. Therefore, assets that have not been mirrored to BSC prior to the BC halting can not be restored.

5.2.2 Asset Recovery App

Asset Recovery App This system consists of two main components:
  1. Approval server. This is an off-chain API service operated by the BNB Chain Foundation. It enables users to retrieve assets by providing merkle proof and approval signature. Only with the approval signature can users recover assets from the BSC network.
  2. Asset Claim Contract. This contract is responsible for handling users' requests to claim assets. It verifies and records the requests to prevent duplicate claims.

The key process for users to claim assets in the BSC network is as follows:

  1. Users use the private key of the asset owner on BC to sign {account address, symbol, amount, receiver}, and request approval through the approval server.
  2. The approval server will fetch the node from a trust merkle tree, and
    a. verify the account, symbol, amount are correct.
    b. the signature is signed by the token owner.
    c. the token is not claimed yet.
    After that, the approval will generate the merkle proof for this request and sign for the request using its approval key.
  3. The user will send a transaction to the Asset Claim contract with merkle proof, node info, BC signature, signature from the approver, receiver account.
  4. The Asset Claim contract will do following checks
    a. The asset of this node is never claimed.
    b. The approval signature comes from the approver.
    c. The BC signature comes from the owner of the token.
    d. The merkle proof is able to prove the node is a leaf node of the tree.
    After all checks are passed, the Asset Claim contract will invoke the token hub contract to unlock the corresponding token to the receiver.

5.2.3 Security Enhancement

Considering the highly flexible implementation approach of BEP20 tokens on theBSC, there may be unforeseen scenarios that the BEP overlooks. During the initial phase of the BEP, the Approval Server only allows for the tokens in a whitelist that can be claimed.

For tokens that are not in the whitelist, users can submit requests on the forum. After the core developers review the security of the token, it can be added to the whitelist.

6. License

The content is licensed under CC0.

@nickmossnz
Copy link

Unbound token

Hi everyone,

I left some FTM on TrustWallet on the Beacon chain and, unfortunately, missed the migration announcement—similar to a few others I've seen here.

I've tried using the BNB recovery tool, but it gives me the message: "Unbound Token" and suggests I "contact the project owner."

TrustWallet support has directed me to reach out to FTM, but I haven’t been able to get a reply from their team.

Can anyone point me in the right direction or let me know who I should contact? Apologies if the answer is already explained above—I’m struggling to fully grasp the technical details.

Thank you in advance for any guidance!
Nick

@Santaklawz
Copy link

Santaklawz commented Jan 15, 2025 via email

@Pistruy
Copy link

Pistruy commented Jan 15, 2025

Hi everyone! In my trust wallet i can see my TWT now, but if i wanna send it to binance i need some BNB Beacon Chain for fee. I cant buy or swap it in wallet - its bloked. And when i tried to sent some my BNBs on my wallet BNB BC address - it also bloked and i cant do this. Somebody know how to buy some BNB BC for fee? Or, maybe, somebody have some for send it to me?) Google don't know how tackle the issue...

@Yasersarhadikarbasak
Copy link

[email protected]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@Kazanostra Kazanostra Kazanostra left review comments

@Saaitlafarga Saaitlafarga Saaitlafarga left review comments

@Pictureitgold Pictureitgold Pictureitgold left review comments

@bk13699 bk13699 bk13699 left review comments

@yipkoonho yipkoonho yipkoonho left review comments

@Sahira11 Sahira11 Sahira11 left review comments

@jircs jircs jircs left review comments

@BHAIsandeep BHAIsandeep BHAIsandeep left review comments

@Ahmadihamid07 Ahmadihamid07 Ahmadihamid07 left review comments

@Dushman-hab Dushman-hab Dushman-hab left review comments

@Hadi90Ahmed Hadi90Ahmed Hadi90Ahmed left review comments

@Meksenmarley1 Meksenmarley1 Meksenmarley1 left review comments

@Nichebiche Nichebiche Nichebiche left review comments

@10208612 10208612 10208612 approved these changes

@Brindle79 Brindle79 Brindle79 left review comments

@mfxrhxn mfxrhxn mfxrhxn left review comments

@TheManager73 TheManager73 TheManager73 left review comments

@Nmhth17 Nmhth17 Nmhth17 left review comments

@musk-j musk-j musk-j left review comments

@DangVanSo DangVanSo DangVanSo left review comments

@Goddessnunu22 Goddessnunu22 Goddessnunu22 left review comments

@Lacry13 Lacry13 Lacry13 left review comments

@Herword Herword Herword left review comments

@Vekiepepito Vekiepepito Vekiepepito left review comments

@Rhahgan21 Rhahgan21 Rhahgan21 left review comments

@Comandante318 Comandante318 Comandante318 left review comments

@thequantumdomain thequantumdomain thequantumdomain left review comments

@farisei77 farisei77 farisei77 approved these changes

@Bigz007 Bigz007 Bigz007 approved these changes

@hazemdraosha111 hazemdraosha111 hazemdraosha111 approved these changes

@endz80513 endz80513 endz80513 approved these changes

@Charlycharly2014 Charlycharly2014 Charlycharly2014 approved these changes

@Daniel618-art Daniel618-art Daniel618-art approved these changes

@immense055 immense055 immense055 approved these changes

@ABDALLA10FATHY ABDALLA10FATHY ABDALLA10FATHY approved these changes

@Carlo0704 Carlo0704 Carlo0704 approved these changes

@Kya123iu Kya123iu Kya123iu approved these changes

@TohaAbir TohaAbir TohaAbir approved these changes

@unclezoro unclezoro unclezoro approved these changes

@NeMeC777 NeMeC777 NeMeC777 approved these changes

@octavio12345300 octavio12345300 octavio12345300 approved these changes

Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.