Using Web3 Libraries | Conduit Documentation

If you’re building an application, web3 libraries provide a higher-level interface for interacting with Conduit RPC endpoints. They handle request formatting, response parsing, and type safety so you don’t have to work with raw JSON-RPC directly.

Replace [YOUR_RPC_URL] and [YOUR_API_KEY] with your values from the Conduit App.

eth_blockNumber

Get the latest block number.

1 import { createPublicClient, http } from 'viem'
2 
3 const client = createPublicClient({
4   transport: http('https://[YOUR_RPC_URL]/[YOUR_API_KEY]'),
5 })
6 
7 const blockNumber = await client.getBlockNumber()
8 console.log(blockNumber)

eth_getBalance

Get the ETH balance of an address.

1 const balance = await client.getBalance({
2   address: '0xYOUR_ADDRESS',
3 })
4 console.log(balance)

eth_call

Call a contract function without sending a transaction.

1 const result = await client.call({
2   to: '0xCONTRACT_ADDRESS',
3   data: '0xCALLDATA',
4 })
5 console.log(result.data)

eth_getLogs

Fetch logs matching a filter. See Throughput for block range and event count limits.

1 const logs = await client.getLogs({
2   address: '0xCONTRACT_ADDRESS',
3   fromBlock: 0n,
4   toBlock: 'latest',
5 })
6 console.log(logs)

eth_sendRawTransaction

Sign and broadcast a transaction.

1 import { createWalletClient, http } from 'viem'
2 import { privateKeyToAccount } from 'viem/accounts'
3 
4 const account = privateKeyToAccount('0xYOUR_PRIVATE_KEY')
5 const walletClient = createWalletClient({
6   account,
7   transport: http('https://[YOUR_RPC_URL]/[YOUR_API_KEY]'),
8 })
9 
10 const hash = await walletClient.sendTransaction({
11   to: '0xRECIPIENT_ADDRESS',
12   value: 1000000000000000n,
13 })
14 console.log(hash)

eth_subscribe (WebSocket)

Subscribe to new block headers in real time. This requires a WebSocket connection. Please see WebSockets for connection management guidance.

1 import { createPublicClient, webSocket } from 'viem'
2 
3 const client = createPublicClient({
4   transport: webSocket('wss://[YOUR_RPC_URL]/[YOUR_API_KEY]'),
5 })
6 
7 const unwatch = client.watchBlocks({
8   onBlock: (block) => console.log(block),
9 })