CrossFi is a blockchain platform built to enable seamless cross-chain asset transfers and decentralized finance (DeFi) applications. With a focus on interoperability, security, and scalability, CrossFi provides developers and users with a powerful ecosystem for deploying decentralized applications (dApps) that can operate across multiple blockchain networks.

The CrossFi API facilitates interaction with the CrossFi network through a collection of JSON-RPC methods. Given its developer-friendly design, those familiar with Ethereum’s JSON-RPC APIs will find working with CrossFi intuitive and straightforward.

Send Your First Request on Alchemy

Let’s use the viem package to create a CrossFi client connected to Alchemy and fetch the latest block number!

npm install --save viem

Create Client Connected to Alchemy

1
import { createPublicClient, http, defineChain } from "viem";
2
3
const crossfi = defineChain({
4
  id: 4158,
5
  name: "CrossFi",
6
  nativeCurrency: { name: "XFI", symbol: "XFI", decimals: 18 },
7
  rpcUrls: {
8
    default: { http: ["https://crossfi-mainnet.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY"] },
9
  },
10
});
11
12
const client = createPublicClient({
13
  chain: crossfi,
14
  transport: http("https://crossfi-mainnet.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY"),
15
});

Now that you’ve created a client connected to Alchemy, you can continue with some basics:

Get Latest Block Number

1
const blockNumber = await client.getBlockNumber();
2
console.log("Current block number:", blockNumber);

Get an Address Balance

1
const balance = await client.getBalance({ address: "0xab5801a7d398351b8be11c439e05c5b3259aec9b" });
2
console.log("Balance (XFI):", Number(balance) / 1e18);

Read Block Data

1
const block = await client.getBlock({
2
  blockNumber: blockNumber, // from previous example
3
});
4
console.log(block);

Fetch a Transaction by Hash

1
const tx = await client.getTransaction({ hash: "0xYOUR_TX_HASH" });
2
console.log(tx);

Fetch Transaction Receipt

1
const receipt = await client.getTransactionReceipt({
2
  hash: "0xYOUR_TX_HASH"
3
});
4
console.log(receipt);

CrossFi APIs

For the full list of CrossFi APIs, see the CrossFi API Endpoints.