DevelopersNode OperatorsMiners
Developers
Introduction
Cross-Chain Token Transfer
Introduction
Interchain Tokens
IntroductionCreate TokenUpgrade TokenInterchain Token ExecutableRate Limit
Developer Guides
Programmatically Create a TokenProgrammatically Create a Canonical TokenLink Custom Tokens Into Interchain Tokens
GlossaryRoadmap
General Message Passing
IntroductionExamplesSend MessagesSend Messages with TokensMonitor Transaction StateQuantum Portal ExecutableVerify GMP Transaction
Debug
Error MessagesDebug a Smart ContractFork Mainnet for Local TestingTransaction Recovery
Developer Guides
Cross-Chain Swaps with CCTPHello World GMP Example
Express Service
Quantum Portal SDK
IntroductionToken Transfer via Deposit AddressGMP Transaction Status and RecoveryQuantum Portal Query API
Indexers
IntroductionSubQuery
Chain and Contract Reference
Mainnet Chain NamesMainnet Contract AddressesTestnet Chain NamesTestnet Contract Addresses
QP DevToolsExamples
Contract and SDK reference
InterchainTokenServiceInterchainTokenFactoryTokenManagerQPGateway QPGasServiceQPExecutableQPJS SDK
Resources
Contract addresses
MainnetTestnet
RPCs
Ferrum Network
QP Explorer
How to use QP explorer
Bug Bounty

Example cross-chain dApps using GMP

The QP-examples repo has an array of examples to show the ease of integrating Quantum Portal’s GMP protocol into any dApp to bring it cross-chain. The examples range in use cases and complexity but ultimately leverage the two fundamental building blocks for GMP:

  • callContract
  • callContractWithToken
ℹ️

NOTE: Due to recent Solidity language upgrades, the PUSH0 opcode is now generated in some of the example contracts upon compilation with the Shanghai version of the EVM. This opcode is currently only available on the Ethereum blockchain and its testnets. Any EVM blockchain that is not Ethereum may throw an error on deployment if the examples contracts being used are running Solidity version 0.8.20 or higher. To avoid any errors on non-Ethereum chains, either make sure your Solidity code is running version 0.8.19 or below, or if you choose to run 0.8.20, rollback your EVM version to London instead of Shanghai.

“Hello World!”

Say hello to your first dApp on Quantum Portal. The dApp sends a message — “Hello World” — from a source to a destination chain using the callContract function.

Source code | Deploy instructions

Airdrop

Send axlUSDC from a source chain to a list of recipients on a destination chain using the callContractWithToken function. Each recipient will receive an equal portion of the total tokens sent.

Source code | Deploy instructions

Watch Quantum Portal engineers demo an end-to-end walkthrough of our Airdrop example, which sends axlUSDC from a source chain to a list of recipients on a destination chain using the callContractWithToken function. The full-stack example includes running the examples locally, deploying to testnet, and reviewing analytics tools in testnet … all run with a simple bootstrapped front end.


Mint tokens and send cross-chain

Mints some amount of ERC-20 tokens at a source chain and sends it using the callContract function to a destination chain. Tokens are burned on the source-chain contract and minted on the destination-chain contract.

Source code | Deploy instructions

NFT linker

Send an NFT on a source chain to a recipient on a destination chain using the callContract function. If the source chain is where the NFT was originally created, the NFT gets locked in the contract and minted on the destination chain; in the reverse direction, the NFT is burned and transferred to its final recipient on the destination (/original home) chain.

Source code | Deploy instructions


Two-way example: send back

A two-way example using callContract in both directions where a message is sent from a source chain to a destination chain, and an “executed” acknowledgement is sent back to the source chain.

Source code | Deploy instructions

Composable USDC

For a more complex example of using native USDC cross-chain, check out our Composable USDC Example.

Edit this page