API Reference

API Reference

Core Functions

assembleAndSubmitStandardJson

assembleAndSubmitStandardJson(
  serverUrl: string,
  chainId: string,
  address: string,
  files: File[],
  language: unknown,
  version?: string,
  identifier?: string,
  settings?: CompilerSettings,
  txHash?: string
): Promise<{verificationId: string}>

Submits contract verification from source files. Assembles Standard JSON from files and POSTs to /v2/verify/{chainId}/{address}.

submitStdJsonFile

submitStdJsonFile(
  serverUrl: string,
  chainId: string,
  address: string,
  stdJsonFile: File,
  compilerVersion: string,
  contractIdentifier: string,
  creationTransactionHash?: string
): Promise<{verificationId: string}>

Submit verification from Standard JSON or Hardhat build-info file. Accepts Hardhat build-info (hh-sol-build-info-1) or raw Standard JSON Input.

getVerificationJobStatus

getVerificationJobStatus(
  serverUrl: string,
  verificationId: string
): Promise<VerificationJobStatus>

Poll verification job status. GET /v2/verify/{verificationId} - poll until isJobCompleted=true. Returns 404 if job expired.

Utility Functions

fetchVerifiedContract

fetchVerifiedContract(
  serverUrl: string,
  chainId: string,
  address: string
): Promise<VerifiedContractMinimal | null>

Get verified contract data for specific chain. Returns null if not found.

fetchVerifiedAllChains

fetchVerifiedAllChains(
  serverUrl: string,
  address: string
): Promise<VerifiedContractMinimal[]>

Fetch verified contract data across all chains with error handling.

buildStandardJsonInput

buildStandardJsonInput(
  files: File[],
  settings: CompilerSettings
): Promise<StandardJsonInput>

Build Solidity Standard JSON Input from source files. Assembles files into Solidity compiler-compatible JSON with optimizer settings.

Response Types

VerificationJobStatus

Returned by getVerificationJobStatus - includes match status and error details.

VerificationResponse

Contains verificationId string for tracking job progress.

Chain

Blockchain network configuration with RPC endpoints and metadata.