Fuse

🚧
No Fuse support
Chainstack deprecated support for Fuse nodes. This page here is for legacy and in case you may find it useful.

MetaMask

On node access details, click Add to MetaMask.

Truffle

Configure Truffle Suite to deploy contracts to your Fuse nodes.

Install Truffle Suite, HD Wallet-enabled Web3 provider, and create a project.

Create a new environment in truffle-config.js, add your mnemonic phrase generated by a wallet and the Fuse endpoint instead of YOUR_NODE_ENDPOINT:

const HDWalletProvider = require("@truffle/hdwallet-provider");
const mnemonic = 'pattern enroll upgrade ...';
...
module.exports = {
 networks: {
    fuse: {
        provider: () => new HDWalletProvider(mnemonic, "YOUR_NODE_ENDPOINT"),
        network_id: "*"
    },
   }
  }
};

Hardhat

Configure Hardhat to deploy contracts and interact through your Fuse nodes.

Install Hardhat and create a project.
Create a new environment in hardhat.config.js:
```
require("@nomiclabs/hardhat-waffle");
...
module.exports = {
  solidity: "0.7.3",
  networks: {
    fuse: {
        url: "YOUR_NODE_ENDPOINT",
        accounts: ["YOUR_PRIVATE_KEY"]
    },
  }
};
```
where
- YOUR_NODE_ENDPOINT — your node HTTPS or WSS endpoint protected either with the key or password. See node access details.
- YOUR_PRIVATE_KEY — the private key of the account that you use to deploy the contract
Run npx hardhat run scripts/deploy.js --network fuse and Hardhat will deploy using your node.

Remix IDE

To make Remix IDE interact with the network through a Fuse node:

Get MetaMask and set it to interact through a Fuse node. See Interacting through MetaMask.
In Remix IDE, navigate to the Deploy tab. Select Injected Provider - MetaMask in Environment.

This will engage MetaMask and make Remix IDE interact with the network through a Fuse node.

web3.js

Build DApps using web3.js and Fuse nodes.

Install web3.js.
Connect over HTTP or WebSocket.

HTTP

Use the HttpProvider object to connect to your node HTTPS endpoint and get the latest block number:

const Web3 = require('web3');

const web3 = new Web3(new Web3.providers.HttpProvider('YOUR_NODE_ENDPOINT'));

web3.eth.getBlockNumber().then(console.log);

where YOUR_FUSE_ENDPOINT is your node HTTPS endpoint protected either with the key or password.

WebSocket

Use the WebsocketProvider object to connect to your node WSS endpoint and get the latest block number:

const Web3 = require('web3');

const web3 = new Web3(new Web3.providers.WebsocketProvider('YOUR_NODE_ENDPOINT'));

web3.eth.getBlockNumber().then(console.log);

where YOUR_FUSE_ENDPOINT is your node WSS endpoint protected either with the key or password.

web3.py

Build DApps using web3.py and Fuse nodes.

Install web3.py.
Connect over HTTP or WebSocket. See also EVM node connection: HTTP vs WebSocket.

HTTP

Use the HTTPProvider to connect to your node endpoint and get the latest block number.

from web3 import Web3

web3 = Web3(Web3.HTTPProvider('YOUR_NODE_ENDPOINT'))
print(web3.eth.blockNumber)

from web3 import Web3

web3 = Web3(Web3.HTTPProvider('https://%s:%s@%s'% ("USERNAME", "PASSWORD", "HOSTNAME")))
print(web3.eth.blockNumber)

where

YOUR_FUSE_ENDPOINT — your node HTTPS endpoint protected either with the key or password
HOSTNAME — your node HTTPS endpoint hostname
USERNAME — your node access username (for password-protected endpoints)
PASSWORD — your node access password (for password-protected endpoints)

WebSocket

Use the WebsocketProvider object to connect to your node WSS endpoint and get the latest block number.

from web3 import Web3

web3 = Web3(Web3.WebsocketProvider('YOUR_NODE_ENDPOINT'))
print(web3.eth.blockNumber)

from web3 import Web3

web3 = Web3(Web3.WebsocketProvider('wss://%s:%s@%s'% ("USERNAME", "PASSWORD", "HOSTNAME")))
print(web3.eth.blockNumber)

where

YOUR_FUSE_ENDPOINT — your node WSS endpoint protected either with the key or password
HOSTNAME — your node WSS endpoint hostname
USERNAME — your node access username (for password-protected endpoints)
PASSWORD — your node access password (for password-protected endpoints)

web3.php

Build DApps using web3.php and Fuse nodes.

Install web3.php.

Connect over HTTP:

<?php

require_once "vendor/autoload.php";

use Web3\Web3;
use Web3\Providers\HttpProvider;
use Web3\RequestManagers\HttpRequestManager;

$web3 = new Web3(new HttpProvider(new HttpRequestManager("YOUR_FUSE_ENDPOINT", 5)));
?>

where YOUR_FUSE_ENDPOINT is your node HTTPS endpoint protected either with the key or password

Use JSON-RPC methods to interact with the node.

Example to get the latest block number:

<?php

require_once "vendor/autoload.php";

use Web3\Web3;
use Web3\Providers\HttpProvider;
use Web3\RequestManagers\HttpRequestManager;

$web3 = new Web3(new HttpProvider(new HttpRequestManager("YOUR_NODE_ENDPOINT", 5)));

$eth = $web3->eth;

$eth->blockNumber(function ($err, $data) {
     print "$data \n";
});
?>

web3j

Build DApps using web3j and Fuse nodes.

Use the HttpService object to connect to your node endpoint.

Example to get the latest block number:

package getLatestBlock;

import java.io.IOException;
import java.util.logging.Level;
import java.util.logging.Logger;

import org.web3j.protocol.Web3j;
import org.web3j.protocol.core.DefaultBlockParameterName;
import org.web3j.protocol.core.methods.response.EthBlock;
import org.web3j.protocol.exceptions.ClientConnectionException;
import org.web3j.protocol.http.HttpService;

import okhttp3.Authenticator;
import okhttp3.Credentials;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import okhttp3.Route;

public final class App {

  private static final String USERNAME = "USERNAME";
  private static final String PASSWORD = "PASSWORD";
  private static final String ENDPOINT = "ENDPOINT";

  public static void main(String[] args) {
    try {

      OkHttpClient.Builder clientBuilder = new OkHttpClient.Builder();
      clientBuilder.authenticator(new Authenticator() {
          @Override public Request authenticate(Route route, Response response) throws IOException {
              String credential = Credentials.basic(USERNAME, PASSWORD);
              return response.request().newBuilder().header("Authorization", credential).build();
          }
      });

      HttpService service = new HttpService(RPC_ENDPOINT, clientBuilder.build(), false);
      Web3j web3 = Web3j.build(service);


      EthBlock.Block latestBlock = web3.ethGetBlockByNumber(DefaultBlockParameterName.LATEST, false).send().getBlock();


      System.out.println("Latest Block: #" + latestBlock.getNumber());

    } catch (IOException | ClientConnectionException ex) {

      Logger.getLogger(App.class.getName()).log(Level.SEVERE, null, ex);
    }
  }

}

where

ENDPOINT — your node HTTPS endpoint
USERNAME — your node access username
PASSWORD — your node access password

ethers.js

Build DApps using ethers.js and Fuse nodes.

Install ethers.js.
Connect over HTTP or WebSocket. See also EVM node connection: HTTP vs WebSocket.

HTTP

Use the JsonRpcProvider object to connect to your node endpoint and get the latest block number:

const { ethers } = require("ethers");

var urlInfo = {
    url: 'YOUR_FUSE_ENDPOINT'
};
var provider = new ethers.providers.JsonRpcProvider(urlInfo, NETWORK_ID);

provider.getBlockNumber().then(console.log);

const { ethers } = require("ethers");

var urlInfo = {
    url: 'YOUR_CHAINSTACK_ENDPOINT',
    user: 'USERNAME',
    password: 'PASSWORD'
};
var provider = new ethers.providers.JsonRpcProvider(urlInfo, NETWORK_ID);

provider.getBlockNumber().then(console.log);

where

YOUR_FUSE_ENDPOINT — your node HTTPS endpoint protected either with the key or password
USERNAME — your node access username (for password-protected endpoints)
PASSWORD — your node access password (for password-protected endpoints)
NETWORK_ID — Fuse network ID:
- Mainnet: 122
- Testnet: 123

WebSocket

Use the WebSocketProvider object to connect to your node WSS endpoint and get the latest block number:

const { ethers } = require("ethers");

const provider = new ethers.providers.WebSocketProvider('YOUR_NODE_ENDPOINT', NETWORK_ID);

provider.getBlockNumber().then(console.log);

where

YOUR_NODE_ENDPOINT — your node WSS endpoint endpoint protected either with the key or password
NETWORK_ID — Fuse network ID:
- Mainnet: 122
- Testnet: 123

Brownie

Install Brownie.
Use the brownie networks add command with the node endpoint:
```
brownie networks add Fuse ID name="NETWORK_NAME" host= YOUR_NODE_ENDPOINT chainid=NETWORK_ID
```
where
- ID — any name that you will use as the network tag to run a deployment. For example, fuse-mainnet.
- NETWORK_NAME — any name that you want to identify the network by in the list of networks. For example, Mainnet (Fuse).
- YOUR_NODE_ENDPOINT — your node HTTPS or WSS endpoint protected either with the key or password
- NETWORK_ID — Fuse network ID:
  - Mainnet: 122
  - Testnet: 123

Example to run the deployment script:

brownie run deploy.py --network fuse-mainnet

Foundry

Install Foundry.
Use --rpc-url to run the operation through your Fuse node.

Forge

Use forge to develop, test, and deploy your smart contracts.

To deploy a contract:

forge create CONTRACT_NAME --contracts CONTRACT_PATH --private-key YOUR_PRIVATE_KEY --rpc-url YOUR_NODE_ENDPOINT

where

CONTRACT_NAME — name of the contract in the Solidity source code
CONTRACT_PATH — path to your smart contract
YOUR_PRIVATE_KEY — the private key to your funded account that you will use to deploy the contract
YOUR_FUSE_ENDPOINT — your node HTTPS endpoint protected either with the key or password

Cast

Use cast to interact with the network and the deployed contracts.

To get the latest block number:

cast block-number --rpc-url YOUR_NODE_ENDPOINT

where YOUR_FUSE_ENDPOINT is your node HTTPS endpoint protected either with the key or password

🚧No Fuse support

MetaMask

Truffle

Hardhat

Remix IDE

web3.js

HTTP

WebSocket

web3.py

HTTP

WebSocket

web3.php

web3j

ethers.js

HTTP

WebSocket

Brownie

Foundry

Forge

Cast

🚧
No Fuse support