createPublicClient

Factory that builds a read-only client extended with every query action.

Setup

import { createPublicClient, createTransport, testnet } from "@left-curve/sdk"
 
const client = createPublicClient({
  chain: testnet,
  transport: createTransport(),
})

createPublicClient returns a PublicClient = Client<undefined, PublicActions>. The signer slot is undefined, so the type system forbids calling any signing action.

Configuration

chain — Chain. Chain config (id, name, URL, native coin). Use local, devnet, testnet, or mainnet from @left-curve/sdk.

transport — Transport. GraphQL transport instance from createTransport(url?, config?).

name — string, optional, default: "Public Client". Free-form label for debugging.

Methods

App

Account Factory

DEX

Perps

Oracle

Indexer

End-to-end example

import { createPublicClient, createTransport, testnet } from "@left-curve/sdk"
import type { Address } from "@left-curve/sdk"
 
const client = createPublicClient({
  chain: testnet,
  transport: createTransport(),
})
 
const status = await client.queryStatus()
 
const address: Address = "0x1234567890abcdef1234567890abcdef12345678"
const balances = await client.getBalances({ address })
 
const pairs = await client.getPairs({ limit: 10 })
 
const unsubscribe = client.blockSubscription({
  next: ({ block }) => console.log("block", block.blockHeight),
})
 
// later
unsubscribe()

Notes

• The client is a plain object, not a class. Method calls are just property reads followed by function calls.
• For tree-shakable usage, import each action and pass the client positionally: getBalance(client, {...}).

See also

• createSignerClient — when you also need to broadcast
• createBaseClient — for custom action extension
• Concepts: Clients