MetaMask & Web3 & Wallet Connect

• Connect MetaMask Wallets → Allow users to authenticate and access their MetaMask Ethereum wallets directly from your app.

• Full Ethereum Blockchain Interactions → Fetch blockchain data, read contract states, send transactions, access transaction receipts, logs, allowances, and more.

• WalletConnect Support (Multiple Wallet Types) → Users can connect with various mobile and hardware wallets through WalletConnect—ideal for dApps requiring broader compatibility.

• Sign Messages & Transactions → Supports cryptographic signing for authentication, verification, and secure on-chain or off-chain interactions.

• Network Switching & Token Management → Users can switch blockchain networks (e.g., Mainnet, Testnets) and manage or add tokens to their wallets.

• Smart Contract Read/Write Support → Interact with ERC-20, ERC-721, and custom smart contracts using ABI definitions making it easy to build real dApps in Bubble.

• Go to the Plugin Tab
• Open your Bubble Editor.
• Navigate to the Plugins tab on the left panel.

• Add Plugins
• Once in the Plugins tab, click the Add Plugins button.

• Search for the Plugin
• Use the search bar to type MetaMask & Web3 & Wallet Connect.



• Locate the plugin in the search results.

• Install/Buy
• If the plugin is free, click Install to add it to your application.
• For a paid plugin, click Buy and follow the purchase instructions.

• Payment Information (For Paid Plugins)
• If the plugin is a paid one, fill in your payment details and make payment.

• Charges will be added to your Bubble billing account.

• Remember, if you unsubscribe from the plugin shortly after installation, charges will be prorated based on the days used.

• Plugin Installed
• Once installed, the plugin will appear under the Installed Plugins list in your Bubble Editor.

• Open the Design tab in your Bubble editor.
• Search for the Metamask element in the Elements panel.

• You’ll see one option:
• Metamask

• Drag and drop the element onto your page.

• Open the Design tab in your Bubble editor.
• Search for the Web3 element in the Elements panel.

• You’ll see one option:
• Web3

• Drag and drop the element onto your page.

• Open the Design tab in your Bubble editor.
• Search for the Wallet Connect 5.0.7 element in the Elements panel.

• You’ll see one option:
• Wallet Connect 5.0.7

• Drag and drop the element onto your page.

1. Get accounts - Returns a list of addresses for the accounts owned.

2. Login - Login the user.

3. Get Permission - Get the users permissions.

4. Get chain ID - Get the current chain ID.

5. Send Transaction - Creates new message call transaction or a contract creation.

Title	Description	Type
Sender address	The hex-encoded Ethereum address of the sender. Must match the currently connected wallet address.	Text
Recipient’s address	The hex-encoded Ethereum address of the recipient. Required for all transactions except contract creation.	Text
Value	The amount of the network’s native currency to send, encoded in hex.	Text (optional)
Data	Used for smart contract creation or calling contract methods (with parameters). For contract creation, leave “Recipient’s address” empty.	Text (optional)
Gas	Gas limit for the transaction, encoded in Wei (hex).	Text (optional)
Gas price	Gas price for the transaction, encoded in Wei (hex).	Text (optional)

6. Request permission - Request additional permissions from the user.

7. Get Balance - Returns Ether balance of a given or account or contract.

Title	Description	Type
Address	The Ethereum address of the account or smart contract whose balance you want to retrieve.	Text
Block Number	The specific block number at which the balance should be checked.	Text

8. Get Logs - Returns an array of all logs matching a given filter object.

Title	Description	Type
From Block	The block number to start scanning from. Accepts a hex-encoded block height or keywords: "latest" (most recent block), "pending" (pending transactions), or "earliest" (genesis block).	Text (optional)
To Block	The block number to stop scanning at. Accepts a hex-encoded block height or keywords: "latest", "pending", or "earliest".	Text (optional)
Address (optional)	A list of contract addresses to filter and monitor events from. Leave empty to listen for events from all sources.	Text (optional)

9. Add Custom Token - Adds the custom Token in Metamask.

Title	Description	Type
Address	The contract address of the token you want to add.	Text
Symbol	The token’s ticker symbol or shorthand (maximum of 5 characters).	Text
Image	A URL string pointing to the token’s logo image.	Text (optional)
Decimals	The number of decimal places the token uses (e.g., ETH = 18).	Number

10. Switch chain - Allows Ethereum applications (‘dapps’) to request that the wallet switches its active Ethereum chain.

Title	Description	Type
Chain ID	You must specify the blockchain network’s ID, either as a hexadecimal string or a decimal number (as used by the eth_chainId RPC method).	Text

11. Sign Type Data - Use this method to request the most human-readable signatures that are efficient to process on-chain. We recommend this for most use cases.

Title	Description	Type
Address	A hex-encoded Ethereum address. Must match the user’s currently active wallet address.	Text
Chain ID	The ID of the blockchain network, provided as a hexadecimal string or decimal number according to the eth_chainId RPC method.	Number
Name	The human-readable name of the application or domain requesting the signed data (used in EIP-712 typed data signing).	Text
Verifying Contract	The Ethereum contract address responsible for verifying the signed message (part of the EIP-712 domain).	Text
Version	The version number of the signing domain or application (e.g., "1"), required for EIP-712 typed structured data.	Text
Message Body	The actual JSON object containing the structured message data that the user is being asked to sign.	Text
Primary Type	The root type of the EIP-712 typed data structure (e.g., Mail, Order, Bid). Defines how the message body should be interpreted.	Text
Types	A JSON object describing all type definitions used in the EIP-712 typed structured message (fields, names, and data types).	Text

12. Personal Sign - Use this method for the easiest way to request human-readable signatures that don’t need to be efficiently processed on-chain.

Title	Description	Type
Address	A hex-encoded Ethereum address. Must match the user’s active wallet address.	Text
Data	Hex-encoded call data used when interacting with smart contracts. Typically includes the function selector and encoded parameters. Leave empty for simple balance or state queries.	Text (optional)

13. Add chain - Creates a confirmation asking the user to add the specified chain to MetaMask. The user may choose to switch to the chain once it has been added.

Title	Description	Type
Chain ID	The unique ID of the blockchain network. Must be provided as a hexadecimal string or a decimal number, following the eth_chainId RPC standard.	Text
ChainName	The human-readable name of the blockchain network (e.g., Ethereum Mainnet, Polygon, BNB Chain).	Text
RpcUrl	The RPC endpoint URL used to communicate with the blockchain. Only one RPC URL can be provided.	Text
BlockExplorerUrl (optional)	The URL of the chain’s block explorer (e.g., https://etherscan.io). Only one URL is allowed.	Text (optional)
	Native Currency
Name	The full name of the native currency of the chain (e.g., Ether, MATIC, BNB).	Text
Symbol	The currency symbol, typically 2–6 characters (e.g., ETH, MATIC, BNB).	Text
Decimals	The number of decimal places for the native token. This plugin currently supports only 18 decimals.	Number

14. Send Transaction with Contract Address - Sends a transaction to a specific smart contract address using the provided ABI and parameters. This action allows you to call contract functions (such as transferring tokens, approving allowances, or executing custom contract methods) directly from the connected wallet. It uses the user’s active wallet address to sign and broadcast the transaction on the selected blockchain network.

Title	Description	Type
From	A hex-encoded Ethereum address. Must match the user’s currently connected wallet address.	Text
To	A hex-encoded Ethereum address. Required for transactions that involve a recipient (all transactions except contract creation).	Text
Gas	The maximum amount of gas the sender is willing to use, expressed in Wei.	Text (optional)
Amount	The value of the chain’s native currency to send, encoded as hexadecimal.	Text (optional)
ABI Contract	The ABI (Application Binary Interface) of the smart contract you want to interact with. Defines available contract methods and parameter structures.	Text
Token Address	The smart contract address of the token you want to interact with (e.g., an ERC-20 or ERC-721 contract).	Text
GasPrice	The gas price the sender is willing to pay per unit of gas, expressed in Wei.	Text (optional)

15. Disconnect - Disconnects the currently connected wallet. This action revokes the session, preventing further transactions or interactions with the blockchain until the user reconnects their wallet. It ensures that the user’s wallet is no longer linked to the app for security and privacy purposes.

1. Number To Wei - Converts any ether value value into wei.

Title	Description	Type
Number	The numeric value of Ether to convert to Wei.	Text
Unit	The Ether unit to convert from (defaults to “ether”).	Text

2. Padding - Adds a padding on the left or right of a string, Useful for adding paddings to HEX strings.

Title	Description	Type
String	The text string to which padding will be added.	Text
Number	The total number of characters the padded string should have.	Number
Direction	The direction of the padding. Options: left or right.	Dropdown

3. Utf8 To HEX - Returns the HEX representation of a given UTF-8 string.

Title	Description	Type
UTF8 string	Any string in UTF8 format.	Text

4. Number To Hex - Returns the Hex representation of a given Number value.

Title	Description	Type
Number	The numeric value to be used or converted.	Text

5. Web3.ETH: Create Wallet - Generates one or more accounts in the wallet. If wallets already exist they will not be overridden.

6. Random Hex - To generate cryptographically strong pseudo-random HEX strings from a given byte size.

Title	Description	Type
Size	The byte size for the HEX string. For example, 32 bytes will result in a 32-byte HEX string (64 characters) prefixed with “0x”.	Number

7. Web3.ETH: Get Balance - Get ethereum balance for any address.

Title	Description	Type
Account address	The Ethereum address for which to retrieve the balance.	Text
Block Number	The block number at which to request the balance. Pre-defined values like “earliest”, “latest”, or “pending” can also be used.	Text

8. sha3 - Will calculate the sha3 of the input.

Title	Description	Type
Data to convert	The string that will be hashed.	Text

9. Web3.ETH: Get Encoded ABI Transaction - Encodes the created contract with ABI method for transaction.

Title	Description	Type
Token contract address	The Ethereum address of the token contract.	Text
Receiver Address	The Ethereum address that will receive the tokens.	Text
Value	The amount of tokens to send.	Text

10. Is Ethereum address? - Checks if a given string is a valid Ethereum address.

Title	Description	Type
Address	The Ethereum address or general address string.	Text

11. Convert to Hex - Convert any data to Hex.

Title	Description	Type
Data	Any data that you want to convert.	Text

12. Web3.ETH: Get Block Number - Returns the current block number.

13. Hex To Number - Returns the number representation of a given HEX value.

Title	Description	Type
HEX	The HEX value that you want to convert.	Text

14. Web3.ETH: Get Block info by ID - Get all info about block by ID.

Title	Description	Type
Block number	The block number, block hash, or a predefined string: “earliest”, “latest”, or “pending” (as used in default block parameters).	Text

15. Hex To Utf8 - Returns the UTF-8 string representation of a given HEX value.

Title	Description	Type
HEX	The HEX string that you want to convert.	Text

16. Web3.ETH: Get transaction - Returns a transaction matching the given transaction hash.

Title	Description	Type
Transaction Hash	The hash of the transaction you want to reference.	Text

17. Hex To ASCII - Returns the ASCII string representation of a given HEX value.

Title	Description	Type
HEX	The HEX value to convert into ASCII format.	Text

18. Web3.ETH: Get Chain ID - Returns the chain ID of the current connected node as described in the EIP-695.

19. Web3.ETH: Send Transaction - Sends a transaction to the network.

Title	Description	Type
From	The address of the sending account. Uses web3.eth.defaultAccount if not specified, or an address/index from web3.eth.accounts.wallet.	Text
To	The destination address of the message. Leave undefined for contract-creation transactions.	Text (optional)
Data	ABI byte string containing function call data, or initialization code for contract-creation transactions.	Text (optional)
Value	Value transferred in wei for the transaction, or endowment for contract creation.	Number (optional)
Gas	Amount of gas to use for the transaction.	Number (optional)
GasPrice	Gas price in wei for this transaction. Defaults to web3.eth.gasPrice.	Number (optional)
Max Fee Per Gas	Maximum total fee per gas the transaction is willing to pay.	Number (optional)
Type	Positive unsigned 8-bit number (0 to 0x7f) representing the transaction type.	Number (optional)

20. Web3.ETH: Create New Account - Creates a new account.

Title	Description	Type
Entropy	Optional: A random string to increase entropy. Must be at least 32 characters if provided. If not provided, a random string will be generated using randomhex.	Text

21. Web3.ETH: Check address - Check if the entered address is a smart contract.

Title	Description	Type
Address	A valid address to check	Text

22. Web3.ETH: Approve - Will send a transaction to the smart contract and execute its method.

Title	Description	Type
Token address	The address of the token contract	Text
Spender	The address authorized to transfer tokens on behalf of the owner	Text
Amount	The number of tokens to transfer	Text
From address	The address of the token owner	Text

23. Get Gas Price - Returns the current gas price oracle. The gas price is determined by the last few blocks median gas price.

24. Web3.ETH: Check Allowance - Checks how many tokens a spender is allowed to transfer on behalf of the owner for a specific token contract, typically using the ERC-20 allowance function.

Title	Description	Type
ABI	The Application Binary Interface of the smart contract, used to interact with its methods	Text
Token address	The Ethereum address of the token contract that defines its behavior (e.g., ERC-20 token)	Text
Owner Address	The Ethereum address of the token owner, used for sending and receiving ETH or tokens	Text
Spender Address	The Ethereum address authorized to spend the owner’s tokens, usually via the ERC-20 allowance function	Text

25. Web3.ETH: Smart Contract - Read - Reads data from a smart contract on the Ethereum blockchain without making any state changes. This is typically used to call view or pure functions of a contract to retrieve information such as balances, token metadata, or other on-chain data.

Title	Description	Type
Contract address	The Ethereum address of the smart contract you want to interact with.	Text
ABI	The contract’s ABI (Application Binary Interface), which defines the functions, events, and variables of the smart contract. This is required to interact with the contract.	Text
Action name	The name of the contract function you want to call.	Text

26. Web3.ETH: Smart Contract - Write - Allows you to send a transaction to a smart contract to execute a function that modifies the contract’s state on the blockchain.

Title	Description	Type
Contract address	Smart Contract Address	Text
ABI	The Contract ABI specifies the structure and types of functions, events, and variables in a smart contract. It serves as the interface for interacting with the contract and calling its functions from external applications or smart contracts.	Text
Action name	The name of the smart contract function you want to call for writing data.	Text
Parameter №1	The first parameter required by the smart contract function (if applicable).	Text (optional)
Parameter №2	The second parameter required by the smart contract function (if applicable).	Text (optional)

27. Web3.ETH: Get transaction Receipt - Returns the receipt of a previously submitted Ethereum transaction, including details such as status, gas used, block number, and logs, allowing you to verify and track the outcome of the transaction.

Title	Description	Type
Transaction Hash	The unique hash identifier of the Ethereum transaction for which the receipt will be retrieved.	Text

28. Disconnect - Disconnects the current wallet connection from the dApp, effectively logging the user out and preventing further interactions until reconnected.

1. Modal Account - Open modal with the data of the connected user.

Title	Description	Type
Open Modal	Opens the WalletConnect modal and displays the data of the currently connected user (wallet address, chain, session details).	Action

2. Modal AllWallets - Shows the list of all available wallets

Title	Description	Type
Modal AllWallets	Shows a modal containing the full list of all available wallets that users can connect with.	Action

3. Modal Networks - List of available networks - you can select and target a specific network before connecting

Title	Description	Type
Modal Networks	Displays a list of all available blockchain networks, allowing the user to choose and target a specific network before connecting.	Action

4. Modal Connect - Сreate a request to connect to the wallet via modal or directly

5. eth_sendTransaction - Creates new message call transaction or a contract creation, if the data field contains code.

Title	Description	Type
From	DATA, 20 bytes — The address the transaction is sent from.	Text
To	DATA, 20 bytes — (Optional for contract creation) The address the transaction is directed to.	Text (optional)
Data	DATA — The compiled contract code or the encoded method signature with parameters for invoking a contract function.	Text (optional)
Gas_price	QUANTITY — (Optional, default: 90000) The maximum amount of gas the sender is willing to pay for transaction execution. Unused gas is returned.	Text (optional)
Gas	QUANTITY — (Optional, default determined automatically) The amount of gas allocated for the transaction.	Text (optional)
Value	QUANTITY — (Optional) The amount of cryptocurrency (in wei) sent with the transaction.	Text (optional)
Nonce	(Optional) Integer representing the transaction nonce. Used to prevent replay attacks and overwrite pending transactions with the same nonce.	Text (optional)

6. Modal WhatIsANetwork - “What is a network” onboarding view

Title	Description	Type
WhatIsANetwork	Displays the “What is a network?” onboarding modal, helping users understand blockchain networks before connecting.	—

7. Modal WhatIsAWallet - “What is a wallet” onboarding view

Title	Description	Type
WhatIsAWallet	Displays the “What is a wallet?” onboarding modal, explaining what crypto wallets are and how they are used.	—

8. Close Modal - Closes the currently opened WalletConnect modal, dismissing any active onboarding, wallet list, or network selection view. This action simply closes the interface without performing any additional operations.

9. eth_Approve - Allows a token owner to grant permission to a specific spender address to transfer a specified amount of their ERC-20 tokens. This action sets the allowance for the spender, enabling them to interact with the owner’s tokens up to the approved limit.

Title	Description	Type
Token address	The Ethereum address of the ERC-20 token contract you want to approve spending for.	Text
Spender	The Ethereum address of the account authorized to spend the tokens on behalf of the owner.	Text
Amount	The amount of tokens to approve for the spender.	Text
From address	The Ethereum address of the token owner granting the approval.	Text
Gas	(Optional) The maximum amount of gas to use for this transaction.	Text (optional)
GasPrice	(Optional) The price per unit of gas to pay for this transaction, in Wei.	Text (optional)

10. eth_sendRawTransaction (doesn’t work everywhere) - Creates new message call transaction or a contract creation for signed transactions.

Title	Description	Type
DATA	The raw signed transaction data that can be submitted to the Ethereum network.	Text

11. Disconnect - Disconnect the connected account from Dapps

12. personal_sign - The sign method calculates an Ethereum specific signature with:sign(keccak256(“19Ethereum Signed Message:” + len(message) + message))).

Title	Description	Type
Message to sign	The message data (N bytes) that will be signed by the wallet.	Text
Address	The Ethereum address (20 bytes) used to sign the message.	Text

13. Send Transaction with Contract Address - Sends a transaction to a specified Ethereum contract address, optionally including token transfers, gas limits, and custom nonce values. This action allows interaction with smart contracts or sending native currency to a contract.

Title	Description	Type
From	A hex-encoded Ethereum address. Must match the user’s active address.	Text
To	A hex-encoded Ethereum address. Required for transactions with a recipient (all transactions except for contract creation).	Text
Gas	The gas limit provided by the sender in Wei.	Text (optional)
Amount	Hex-encoded value of the network’s native currency to send.	Text (optional)
Token Address	The address of the ERC-20 token contract being used in the transaction.	Text
Gas Price	The gas price (in Wei) that the sender is willing to pay per unit of gas.	Text
Nonce (Optional)	A unique number to allow overwriting pending transactions from the same sender; increments per transaction.	Text (optional)

14. eth_sign - The sign method calculates an Ethereum specific signature with: sign(keccak256(“19Ethereum Signed Message:” + len(message) + message))).

Title	Description	Type
Address	The Ethereum address that will sign the message (20-byte hex format).	Text
Message to sign	The message data to be signed, in bytes (N-byte length).	Text

15. eth_signTypedData - Calculates an Ethereum-specific signature in the form of keccak256(“19Ethereum Signed Message:” + len(message) + message))

Title	Description	Type
Address	The Ethereum address (20-byte hex) that will sign the message.	Text
Message to sign	The message to be signed, including type information, domain separator, and data, in bytes (N-byte length).	Text

16. Estimate Gas and getGasPrice - Calculates the estimated amount of gas required to execute a transaction and retrieves the current gas price from the network. This helps ensure that transactions are executed efficiently without overpaying for gas.

Title	Description	Type
From	The Ethereum address sending the transaction.	Text
To	The Ethereum address receiving the transaction.	Text
Amount	The amount of the network’s native currency to send, in Wei.	Text
Token address (Optional)	The token contract address if estimating gas for a token transfer; leave blank for native currency.	Text (optional)

17. Switch chain - Changes the connected wallet’s active blockchain network to a specified chain ID. This allows users to interact with different networks (e.g., Ethereum mainnet, testnets, or other EVM-compatible chains) without reconnecting their wallet.

Title	Description	Type
Chain ID	The blockchain network ID to switch to. Provide as an integer in hexadecimal or decimal format, following the eth_chainId Ethereum RPC standard.	Text

18. Check Allowance - This action allows you to verify the amount of tokens that a given spender is authorized to transfer on behalf of a token owner. It queries the smart contract to return the current allowance set for the spender.

Title	Description	Type
Token address	The Ethereum address of the token’s smart contract (e.g., an ERC-20 token).	Text
Owner Address	The Ethereum address of the token owner whose allowance you want to check.	Text
Spender Address	The Ethereum address authorized to spend the owner’s tokens.	Text

json
{
  "baseFeePerGas": "number",
  "difficulty": "text",
  "extraData": "text",
  "gasLimit": "number",
  "gasUsed": "number",
  "hash": "text",
  "logsBloom": "text",
  "miner": "text",
  "mixHash": "text",
  "nonce": "text",
  "number": "number",
  "parentHash": "text",
  "receiptsRoot": "text",
  "sha3Uncles": "text",
  "size": "number",
  "stateRoot": "text",
  "timestamp": "number",
  "totalDifficulty": "text",
  "transactions": "text",
  "transactionsRoot": "text",
  "uncles": "text"
}

json
{
  "blockHash": "text",
  "blockNumber": "number",
  "from": "text",
  "gas": "number",
  "gasPrice": "text",
  "hash": "text",
  "input": "text",
  "nonce": "number",
  "r": "text",
  "s": "text",
  "to": "text",
  "transactionIndex": "number",
  "type": "number",
  "v": "text",
  "value": "text"
}

json
{
  "status": "yes/no",
  "transactionHash": "text",
  "transactionIndex": "number",
  "blockHash": "text",
  "blockNumber": "number",
  "contractAddress": "text",
  "cumulativeGasUsed": "text",
  "gasUsed": "text",
  "effectiveGasPrice": "text",
  "logs": {
    "address": "text",
    "blockHash": "text",
    "blockNumber": "text",
    "data": "text",
    "logIndex": "text",
    "removed": "yes/no",
    "topics": "text",
    "transactionHash": "text",
    "transactionIndex": "text"
  }
}

• Bubble Plugin Page Update (Forum).

• Bubble Plugin Page Update (Logo).

• Marketing update (minor change).

• Fixed "Amount" field in "Send Transaction with Contract" action - WalletConnect.

• Fixed “Eth Sign type data” and “Send Transaction with Contract Address” actions - WalletConnect.

• Fixed "Socials" field - WalletConnect.

• Minor update (Marketing update).

• Minor update (Marketing update).

• Added "Provider URL" field in Web3 element and fixed bugs in some actions.

• Removed "Wallet connect" element, added "Wallet connect 5.0.7" element.

• Changes to plugin terms and conditions.

• Minor update.

• Minor update (Marketing update).

• Updated demo/service links.

• Minor update.

• updated description.

• Minor improvements.

• Minor update.

• Added "Auto connect Metamask?" field.

• Added "Decimals" field in "Add Custom Token" action.

• Added "Show QR Modal" checkbox in "Connect 2.0" action - WalletConnect.

• updated description.

• updated description.

• Minor fixes.

• Fixed the transaction status updates.

• Fixed Wallet Connect.

• Updated description.

• Minor improvements.

• minor updates.

• Minor updates.

• Minor improvements.

• updated description.

• minor updates.

• Obfuscation.

• Bug fixes.

• updated description.

• updated the icon.

• updated description.

• Minor update.

• updated description.

• Updated the description .

• updated the description.

• deleted the icons.

• updated the description.

• Updated service link.

• Added "Chain ID" state.

• Updated icon.

• Added forum thread in common part.

• Updated description.

• Initial Release.