Class TestRpc

constructor

• new TestRpc(
      endpoint: string,
      hasher: LightWasm,
      compressionApiEndpoint: string,
      proverEndpoint: string,
      connectionConfig?: ConnectionConfig,
      testRpcConfig?: TestRpcConfig,
  ): TestRpc

  Establish a Compression-compatible JSON RPC mock-connection

  Parameters

  • endpoint: string

    endpoint to the solana cluster (use for localnet only)

  • hasher: LightWasm

    light wasm hasher instance

  • compressionApiEndpoint: string

    Endpoint to the compression server.

  • proverEndpoint: string

    Endpoint to the prover server. defaults to endpoint

  • OptionalconnectionConfig: ConnectionConfig

    Optional connection config

  • OptionaltestRpcConfig: TestRpcConfig

    Config for the mock rpc

  Returns TestRpc

compressionApiEndpoint

proverEndpoint

lightWasm

depth

log

allStateTreeInfos

lastStateTreeFetchTime

fetchPromise

CACHE_TTL

getCachedActiveStateTreeInfo

• getCachedActiveStateTreeInfo(): Promise<void>

  Returns Promise<void>

  Deprecated

  Use getStateTreeInfos instead

getCachedActiveStateTreeInfos

• getCachedActiveStateTreeInfos(): Promise<void>

  Returns Promise<void>

  Deprecated

  Use getStateTreeInfos instead

getStateTreeInfos

• getStateTreeInfos(): Promise<TreeInfo[]>

  Returns local test state trees.

  Returns Promise<TreeInfo[]>

doFetch

• doFetch(): Promise<TreeInfo[]>

  Returns Promise<TreeInfo[]>

getAddressTreeInfoV2

• getAddressTreeInfoV2(): Promise<TreeInfo>

  Get a V2 address tree info.

  Returns Promise<TreeInfo>

getCompressedAccount

• getCompressedAccount(
      address?: BN,
      hash?: BN,
  ): Promise<CompressedAccountWithMerkleContext | null>

  Fetch the compressed account for the specified account hash

  Parameters

  • Optionaladdress: BN
  • Optionalhash: BN

  Returns Promise<CompressedAccountWithMerkleContext | null>

getCompressedBalance

• getCompressedBalance(address?: BN, hash?: BN): Promise<BN>

  Fetch the compressed balance for the specified account hash

  Parameters

  • Optionaladdress: BN
  • Optionalhash: BN

  Returns Promise<BN>

getCompressedBalanceByOwner

• getCompressedBalanceByOwner(owner: PublicKey): Promise<BN>

  Fetch the total compressed balance for the specified owner public key

  Parameters

  • owner: PublicKey

  Returns Promise<BN>

getCompressedAccountProof

• getCompressedAccountProof(hash: BN): Promise<MerkleContextWithMerkleProof>

  Fetch the latest merkle proof for the specified account hash from the cluster

  Parameters

  • hash: BN

  Returns Promise<MerkleContextWithMerkleProof>

getMultipleCompressedAccounts

• getMultipleCompressedAccounts(
      hashes: BN[],
  ): Promise<CompressedAccountWithMerkleContext[]>

  Fetch all the account info for multiple compressed accounts specified by an array of account hashes

  Parameters

  • hashes: BN[]

  Returns Promise<CompressedAccountWithMerkleContext[]>

confirmTransactionIndexed

• confirmTransactionIndexed(_slot: number): Promise<boolean>

  Ensure that the Compression Indexer has already indexed the transaction

  Parameters

  • _slot: number

  Returns Promise<boolean>

getMultipleCompressedAccountProofs

• getMultipleCompressedAccountProofs(
      hashes: BN[],
  ): Promise<MerkleContextWithMerkleProof[]>

  Fetch the latest merkle proofs for multiple compressed accounts specified by an array account hashes

  Parameters

  • hashes: BN[]

  Returns Promise<MerkleContextWithMerkleProof[]>

getCompressedAccountsByOwner

• getCompressedAccountsByOwner(
      owner: PublicKey,
      _config?: GetCompressedAccountsByOwnerConfig,
  ): Promise<WithCursor<CompressedAccountWithMerkleContext[]>>

  Fetch all the compressed accounts owned by the specified public key. Owner can be a program or user account

  Parameters

  • owner: PublicKey
  • Optional_config: GetCompressedAccountsByOwnerConfig

  Returns Promise<WithCursor<CompressedAccountWithMerkleContext[]>>

getLatestCompressionSignatures

• getLatestCompressionSignatures(
      _cursor?: string,
      _limit?: number,
  ): Promise<LatestNonVotingSignaturesPaginated>

  Fetch the latest compression signatures on the cluster. Results are paginated.

  Parameters

  • Optional_cursor: string
  • Optional_limit: number

  Returns Promise<LatestNonVotingSignaturesPaginated>

getLatestNonVotingSignatures

• getLatestNonVotingSignatures(
      _limit?: number,
  ): Promise<LatestNonVotingSignatures>

  Fetch the latest non-voting signatures on the cluster. Results are not paginated.

  Parameters

  • Optional_limit: number

  Returns Promise<LatestNonVotingSignatures>

getCompressedTokenAccountsByOwner

• getCompressedTokenAccountsByOwner(
      owner: PublicKey,
      options: GetCompressedTokenAccountsByOwnerOrDelegateOptions,
  ): Promise<WithCursor<ParsedTokenAccount[]>>

  Fetch all the compressed token accounts owned by the specified public key. Owner can be a program or user account

  Parameters

  • owner: PublicKey
  • options: GetCompressedTokenAccountsByOwnerOrDelegateOptions

  Returns Promise<WithCursor<ParsedTokenAccount[]>>

getCompressedTokenAccountsByDelegate

• getCompressedTokenAccountsByDelegate(
      delegate: PublicKey,
      options: GetCompressedTokenAccountsByOwnerOrDelegateOptions,
  ): Promise<WithCursor<ParsedTokenAccount[]>>

  Fetch all the compressed accounts delegated to the specified public key.

  Parameters

  • delegate: PublicKey
  • options: GetCompressedTokenAccountsByOwnerOrDelegateOptions

  Returns Promise<WithCursor<ParsedTokenAccount[]>>

getCompressedTokenAccountBalance

• getCompressedTokenAccountBalance(hash: BN): Promise<{ amount: BN }>

  Fetch the compressed token balance for the specified account hash

  Parameters

  • hash: BN

  Returns Promise<{ amount: BN }>

getCompressedTokenBalancesByOwner

• getCompressedTokenBalancesByOwner(
      publicKey: PublicKey,
      options: GetCompressedTokenAccountsByOwnerOrDelegateOptions,
  ): Promise<WithCursor<{ balance: BN; mint: PublicKey }[]>>

  Parameters

  • publicKey: PublicKey
  • options: GetCompressedTokenAccountsByOwnerOrDelegateOptions

  Returns Promise<WithCursor<{ balance: BN; mint: PublicKey }[]>>

  Deprecated

  use getCompressedTokenBalancesByOwnerV2. Fetch all the compressed token balances owned by the specified public key. Can filter by mint.

getCompressedTokenBalancesByOwnerV2

• getCompressedTokenBalancesByOwnerV2(
      publicKey: PublicKey,
      options: GetCompressedTokenAccountsByOwnerOrDelegateOptions,
  ): Promise<WithContext<WithCursor<TokenBalance[]>>>

  Fetch all the compressed token balances owned by the specified public key. Can filter by mint. Uses context.

  Parameters

  • publicKey: PublicKey
  • options: GetCompressedTokenAccountsByOwnerOrDelegateOptions

  Returns Promise<WithContext<WithCursor<TokenBalance[]>>>

getCompressionSignaturesForAccount

• getCompressionSignaturesForAccount(_hash: BN): Promise<SignatureWithMetadata[]>

  Returns confirmed signatures for transactions involving the specified account hash forward in time from genesis to the most recent confirmed block

  Parameters

  • _hash: BN

  Returns Promise<SignatureWithMetadata[]>

getTransactionWithCompressionInfo

• getTransactionWithCompressionInfo(
      _signature: string,
  ): Promise<CompressedTransaction>

  Fetch a confirmed or finalized transaction from the cluster. Return with CompressionInfo

  Parameters

  • _signature: string

  Returns Promise<CompressedTransaction>

getCompressionSignaturesForAddress

• getCompressionSignaturesForAddress(
      _address: PublicKey,
      _options?: PaginatedOptions,
  ): Promise<WithCursor<SignatureWithMetadata[]>>

  Returns confirmed signatures for transactions involving the specified address forward in time from genesis to the most recent confirmed block

  Parameters

  • _address: PublicKey
  • Optional_options: PaginatedOptions

  Returns Promise<WithCursor<SignatureWithMetadata[]>>

getCompressionSignaturesForOwner

• getCompressionSignaturesForOwner(
      _owner: PublicKey,
      _options?: PaginatedOptions,
  ): Promise<WithCursor<SignatureWithMetadata[]>>

  Returns confirmed signatures for compression transactions involving the specified account owner forward in time from genesis to the most recent confirmed block

  Parameters

  • _owner: PublicKey
  • Optional_options: PaginatedOptions

  Returns Promise<WithCursor<SignatureWithMetadata[]>>

getCompressionSignaturesForTokenOwner

• getCompressionSignaturesForTokenOwner(
      _owner: PublicKey,
      _options?: PaginatedOptions,
  ): Promise<WithCursor<SignatureWithMetadata[]>>

  Returns confirmed signatures for compression transactions involving the specified token account owner forward in time from genesis to the most recent confirmed block

  Parameters

  • _owner: PublicKey
  • Optional_options: PaginatedOptions

  Returns Promise<WithCursor<SignatureWithMetadata[]>>

getIndexerHealth

• getIndexerHealth(): Promise<string>

  Fetch the current indexer health status

  Returns Promise<string>

getIndexerSlot

• getIndexerSlot(): Promise<number>

  Fetch the current slot that the node is processing

  Returns Promise<number>

getMultipleNewAddressProofs

• getMultipleNewAddressProofs(
      addresses: BN[],
  ): Promise<MerkleContextWithNewAddressProof[]>

  Fetch the latest address proofs for new unique addresses specified by an array of addresses.

  the proof states that said address have not yet been created in respective address tree.

  Parameters

  • addresses: BN[]

    Array of BN254 new addresses

  Returns Promise<MerkleContextWithNewAddressProof[]>

  Array of validity proofs for new addresses

getCompressedMintTokenHolders

• getCompressedMintTokenHolders(
      _mint: PublicKey,
      _options?: PaginatedOptions,
  ): Promise<WithContext<WithCursor<CompressedMintTokenHolders[]>>>

  Parameters

  • _mint: PublicKey
  • Optional_options: PaginatedOptions

  Returns Promise<WithContext<WithCursor<CompressedMintTokenHolders[]>>>

getValidityProofAndRpcContext

• getValidityProofAndRpcContext(
      hashes?: HashWithTree[],
      newAddresses?: AddressWithTree[],
  ): Promise<WithContext<ValidityProofWithContext>>

  Parameters

  • hashes: HashWithTree[] = []
  • newAddresses: AddressWithTree[] = []

  Returns Promise<WithContext<ValidityProofWithContext>>

  Deprecated

  This method is not available for TestRpc. Please use getValidityProof instead.

getValidityProof

• getValidityProof(
      hashes?: BN[],
      newAddresses?: BN[],
  ): Promise<ValidityProofWithContext>

  Fetch the latest validity proof for (1) compressed accounts specified by an array of account hashes. (2) new unique addresses specified by an array of addresses.

  Validity proofs prove the presence of compressed accounts in state trees and the non-existence of addresses in address trees, respectively. They enable verification without recomputing the merkle proof path, thus lowering verification and data costs.

  Parameters

  • hashes: BN[] = []

    Array of BN254 hashes.

  • newAddresses: BN[] = []

    Array of BN254 new addresses.

  Returns Promise<ValidityProofWithContext>

  validity proof with context

getValidityProofV0

• getValidityProofV0(
      hashes?: HashWithTree[],
      newAddresses?: AddressWithTree[],
  ): Promise<ValidityProofWithContext>

  Parameters

  • hashes: HashWithTree[] = []
  • newAddresses: AddressWithTree[] = []

  Returns Promise<ValidityProofWithContext>