Portales by Metamath

What is Portales?

Portales is a Cross-Bridge solution for fast wrapping assets. Portales' long-term goal is to make off-chain event listeners (Oyentes) decentralized by incentivizing node maintainers with PORT tokens.

How does Portales work?

A user wants to bridge assets between two chains. By interacting with Portales Front-End DAPP, it is possible to send a request using a Crypto Wallet (i.e., Metamask) to the Portales Smart Contract requesting a cross-chain swap to initiate. Upon receiving the request from the user, a transaction is sent to the blockchain resulting in a SwapStarted event.

A listener instance called Oyente leverage Ethers.js ability to filter EVM events to monitor all SwapStarted events originating from a Portales Smart Contract and handle these as user requests for a cross-chain swap. Oyente is responsible for calling a fillSwapRequest() function on the target chain. There are four possible states for a transaction once Oyente catches a new SwapStarted event:

• Initiated: Oyente received a new SwapStarted event and just started processing it
• Error: Oyente was unable to process the request, or the target chain reverted the transaction
• Processed: Oyente has sent a transaction to the target chain, but confirmation is still pending
• Finalized: The swap transaction is confirmed on the target chain
  
  

Oyente is also responsible for populating a database with the following data:

• Oyente Event ID
• Sender Address
• Receiver Address
• Origin Chain ID
• Target Chain ID
• Tx Hash
• Tx Status
• Transfer Amount
  
  

Our authorial API will make this data available for the front-end so the end-user can follow the transaction status live on the web app.