Shielded Public Client

Read-only client with TEE key access and precompile support

Read-only client for interacting with a Seismic node. Extends viem's PublicClient with TEE public key retrieval, precompile access, block explorer URL helpers, SRC20 event watching, and deposit contract queries. Does not require a private key.

Import

import { createShieldedPublicClient } from "seismic-viem";

Constructor

const publicClient = createShieldedPublicClient({
  chain: seismicTestnet,
  transport: http(),
});

Parameters

Parameter	Type	Required	Description
chain	Chain	Yes	Chain configuration (e.g., seismicTestnet)
transport	Transport	Yes	viem transport (e.g., http())

Return Type

ShieldedPublicClient

A viem PublicClient extended with ShieldedPublicActions, DepositContractPublicActions, and SRC20PublicActions.

Usage

import { createShieldedPublicClient } from "seismic-viem";
import { seismicTestnet } from "seismic-viem";
import { http } from "viem";

const publicClient = createShieldedPublicClient({
  chain: seismicTestnet,
  transport: http(),
});

// Standard viem public actions work as usual
const blockNumber = await publicClient.getBlockNumber();
const balance = await publicClient.getBalance({
  address: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
});

Actions

Shielded Public Actions

Action	Return Type	Description
getTeePublicKey()	Promise<Hex>	Fetch the TEE's secp256k1 public key via seismic_getTeePublicKey RPC
getStorageAt()	--	Throws error (not supported on Seismic)
publicRequest()	Promise<any>	Raw RPC request to the node
explorerUrl(opts)	string | null	Generate a block explorer URL
addressExplorerUrl(address)	string | null	Explorer URL for an address
blockExplorerUrl(block)	string | null	Explorer URL for a block
txExplorerUrl(hash)	string | null	Explorer URL for a transaction
tokenExplorerUrl(address)	string | null	Explorer URL for a token

Precompile Actions

Action	Return Type	Description
rng(params)	Promise<bigint>	Generate random numbers via the RNG precompile
ecdh(params)	Promise<Hex>	ECDH key exchange via precompile
aesGcmEncryption(params)	Promise<Hex>	AES-GCM encrypt via precompile
aesGcmDecryption(params)	Promise<string>	AES-GCM decrypt via precompile
hdfk(ikm)	Promise<Hex>	HKDF key derivation via precompile
secp256k1Signature(params)	Promise<Signature>	secp256k1 signing via precompile

SRC20 Actions

Action	Return Type	Description
watchSRC20EventsWithKey()	Promise<() => void>	Watch for SRC20 events with a decryption key

See SRC20 Event Watching for the full flow, log types, and example usage.

Deposit Contract Actions

Action	Return Type	Description
getDepositRoot()	Promise<Hex>	Query the deposit merkle root
getDepositCount()	Promise<Hex>	Query the deposit count

See Deposit Contract for parameters and validator registration via deposit().

Standard viem Public Actions

All standard viem PublicActions are available directly on the client:

• getBlockNumber(), getBlock(), getTransaction()

• getBalance(), getCode(), call()

• estimateGas(), waitForTransactionReceipt()

• All other viem public client methods

getStorageAt Disabled

Seismic does not support eth_getStorageAt. Calling publicClient.getStorageAt() will throw an error. This is by design -- storage slots on Seismic may contain shielded data and cannot be read directly via RPC.

Examples

Fetching the TEE Public Key

import { createShieldedPublicClient } from "seismic-viem";
import { seismicTestnet } from "seismic-viem";
import { http } from "viem";

const publicClient = createShieldedPublicClient({
  chain: seismicTestnet,
  transport: http(),
});

const teePublicKey = await publicClient.getTeePublicKey();
console.log("TEE public key:", teePublicKey);

Using Precompiles

import { createShieldedPublicClient } from "seismic-viem";
import { seismicTestnet } from "seismic-viem";
import { http } from "viem";

const publicClient = createShieldedPublicClient({
  chain: seismicTestnet,
  transport: http(),
});

// Generate a random number
const randomValue = await publicClient.rng({ numBytes: 1 });
console.log("Random value:", randomValue);

// ECDH key exchange
const sharedSecret = await publicClient.ecdh({
  sk: "0x...",
  pk: "0x...",
});

// AES-GCM encryption
const ciphertext = await publicClient.aesGcmEncryption({
  aesKey: "0x...",
  plaintext: "0x...",
  nonce: "0x...",
});

// HKDF key derivation
const derivedKey = await publicClient.hdfk("0x...");

Explorer URL Helpers

Each helper accepts an optional tab argument to deep-link into a specific view. The helpers return string | null -- null when the chain has no configured block explorer.

const publicClient = createShieldedPublicClient({
  chain: seismicTestnet,
  transport: http(),
});

const txUrl = publicClient.txExplorerUrl({ txHash: "0xabc123..." });
const txLogs = publicClient.txExplorerUrl({
  txHash: "0xabc123...",
  tab: "logs",
});
const addrUrl = publicClient.addressExplorerUrl({
  address: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
});
const blockUrl = publicClient.blockExplorerUrl({ blockNumber: 12345 });
const tokenUrl = publicClient.tokenExplorerUrl({
  address: "0xYourTokenAddress",
  tab: "holders",
});

Tab values by item type

Helper	Tab type	Values
txExplorerUrl	TxExplorerTab	'index', 'token_transfers', 'internal', 'logs', 'state', 'raw_trace'
addressExplorerUrl	AddressExplorerTab	'txs', 'token_transfers', 'tokens', 'internal_txns', 'coin_balance_history', 'logs', 'contract'
tokenExplorerUrl	TokenExplorerTab	'token_transfers', 'holders', 'contract'
blockExplorerUrl	BlockExplorerTab	'index', 'txs'

Standalone functions

The same helpers are exported as standalone functions that take an explicit chain and can be used without a client:

import {
  addressExplorerUrl,
  blockExplorerUrl,
  getExplorerUrl,
  tokenExplorerUrl,
  txExplorerUrl,
} from "seismic-viem";

const url = txExplorerUrl({
  chain: seismicTestnet,
  txHash: "0xabc...",
  tab: "logs",
});

// Low-level form used by all helpers internally:
const raw = getExplorerUrl(seismicTestnet, {
  item: "address",
  id: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
  tab: "logs",
});

See Also

• Shielded Wallet Client -- Full-featured client with encryption and shielded writes

• Deposit Contract -- Validator staking read/write actions

• SRC20 Event Watching -- Watch and decrypt SRC20 token events

• Chains -- Chain configurations for Seismic networks

• Precompiles -- Precompile details and parameters

• Encryption -- Encryption utilities and getEncryption()