Class: RpcChannel

Defined in: src/channel/rpc_0_10_2.ts:54

Extended by

• RpcChannel

Constructors

Constructor

new RpcChannel(optionsOrProvider?): RpcChannel

Defined in: src/channel/rpc_0_10_2.ts:87

Parameters

optionsOrProvider?

RpcProviderOptions

Returns

RpcChannel

Properties

id

readonly id: string = 'RPC0.10.2'

Defined in: src/channel/rpc_0_10_2.ts:55

---

channelSpecVersion

readonly channelSpecVersion: "0.9.0" | "0.10.0" | "0.10.2" | "0.10.3" = SupportedRpcVersion.v0_10_2

Defined in: src/channel/rpc_0_10_2.ts:60

RPC specification version this Channel class implements

---

nodeUrl

nodeUrl: string

Defined in: src/channel/rpc_0_10_2.ts:62

---

headers

headers: object

Defined in: src/channel/rpc_0_10_2.ts:64

---

requestId

requestId: number

Defined in: src/channel/rpc_0_10_2.ts:66

---

blockIdentifier

readonly blockIdentifier: BlockIdentifier

Defined in: src/channel/rpc_0_10_2.ts:68

---

retries

readonly retries: number

Defined in: src/channel/rpc_0_10_2.ts:70

---

waitMode

readonly waitMode: boolean

Defined in: src/channel/rpc_0_10_2.ts:72

Methods

readSpecVersion()

readSpecVersion(): "0.9.0" | "0.10.0" | "0.10.2" | "0.10.3" | undefined

Defined in: src/channel/rpc_0_10_2.ts:133

Returns

"0.9.0" | "0.10.0" | "0.10.2" | "0.10.3" | undefined

---

setChainId()

setChainId(chainId): void

Defined in: src/channel/rpc_0_10_2.ts:141

Parameters

chainId

"0x534e5f4d41494e" | "0x534e5f5345504f4c4941"

Returns

void

---

fetch()

fetch(method, params?, id?): Promise<Response>

Defined in: src/channel/rpc_0_10_2.ts:145

Parameters

method

string

params?

object

id?

string | number

Returns

Promise<Response>

---

errorHandler()

protected errorHandler(method, params, rpcError?, otherError?): void

Defined in: src/channel/rpc_0_10_2.ts:159

Parameters

method

string

params

any

rpcError?

Error

otherError?

any

Returns

void

---

fetchEndpoint()

protected fetchEndpoint<T>(method, params?): Promise<Methods[T]["result"]>

Defined in: src/channel/rpc_0_10_2.ts:171

Type Parameters

T

T extends keyof ReadMethods | keyof WriteMethods | keyof TraceMethods

Parameters

method

T

params?

Methods[T]["params"]

Returns

Promise<Methods[T]["result"]>

---

getChainId()

getChainId(): Promise<"0x534e5f4d41494e" | "0x534e5f5345504f4c4941">

Defined in: src/channel/rpc_0_10_2.ts:199

Returns

Promise<"0x534e5f4d41494e" | "0x534e5f5345504f4c4941">

---

getSpecVersion()

getSpecVersion(): Promise<string>

Defined in: src/channel/rpc_0_10_2.ts:208

fetch rpc node specVersion

Returns

Promise<string>

Example

this.specVersion = "0.9.0"

---

setUpSpecVersion()

setUpSpecVersion(): Promise<"0.9.0" | "0.10.0" | "0.10.2" | "0.10.3">

Defined in: src/channel/rpc_0_10_2.ts:216

fetch if undefined else just return this.specVersion

Returns

Promise<"0.9.0" | "0.10.0" | "0.10.2" | "0.10.3">

Example

this.specVersion = "0.9.0"

---

getMessagesStatus()

getMessagesStatus(txHash): Promise<L1L2MessagesStatus>

Defined in: src/channel/rpc_0_10_2.ts:242

Given an l1 tx hash, returns the associated l1_handler tx hashes and statuses for all L1 -> L2 messages sent by the l1 transaction, ordered by the l1 tx sending order

Parameters

txHash

BigNumberish

Returns

Promise<L1L2MessagesStatus>

---

getStorageProof()

getStorageProof(classHashes?, contractAddresses?, contractsStorageKeys?, blockIdentifier?): Promise<StorageProof>

Defined in: src/channel/rpc_0_10_2.ts:250

Parameters

classHashes?

BigNumberish[] = []

contractAddresses?

BigNumberish[] = []

contractsStorageKeys?

CONTRACT_STORAGE_KEYS[] = []

blockIdentifier?

BlockIdentifier = ...

Returns

Promise<StorageProof>

---

getCompiledCasm()

getCompiledCasm(classHash): Promise<CASM_COMPILED_CONTRACT_CLASS>

Defined in: src/channel/rpc_0_10_2.ts:269

Parameters

classHash

BigNumberish

Returns

Promise<CASM_COMPILED_CONTRACT_CLASS>

---

getNonceForAddress()

getNonceForAddress(contractAddress, blockIdentifier?): Promise<string>

Defined in: src/channel/rpc_0_10_2.ts:277

Parameters

contractAddress

BigNumberish

blockIdentifier?

BlockIdentifier = ...

Returns

Promise<string>

---

getStarknetVersion()

getStarknetVersion(blockIdentifier?): Promise<string>

Defined in: src/channel/rpc_0_10_2.ts:293

Helper method to get the starknet version from the block, default latest block

Parameters

blockIdentifier?

BlockIdentifier = ...

Returns

Promise<string>

Starknet version

---

getBlockLatestAccepted()

getBlockLatestAccepted(): Promise<BlockHashAndNumber>

Defined in: src/channel/rpc_0_10_2.ts:301

Get the most recent accepted block hash and number

Returns

Promise<BlockHashAndNumber>

---

getBlockNumber()

getBlockNumber(): Promise<number>

Defined in: src/channel/rpc_0_10_2.ts:310

Get the most recent accepted block number redundant use getBlockLatestAccepted();

Returns

Promise<number>

Number of the latest block

---

getBlockWithTxHashes()

getBlockWithTxHashes(blockIdentifier?): Promise<OnlyFirst<BLOCK_WITH_TX_HASHES, object & BLOCK_HEADER & BLOCK_BODY_WITH_TX_HASHES & PRE_CONFIRMED_BLOCK_HEADER> | OnlyFirst<PRE_CONFIRMED_BLOCK_WITH_TX_HASHES, object & BLOCK_HEADER & BLOCK_BODY_WITH_TX_HASHES & PRE_CONFIRMED_BLOCK_HEADER>>

Defined in: src/channel/rpc_0_10_2.ts:314

Parameters

blockIdentifier?

BlockIdentifier = ...

Returns

Promise<OnlyFirst<BLOCK_WITH_TX_HASHES, object & BLOCK_HEADER & BLOCK_BODY_WITH_TX_HASHES & PRE_CONFIRMED_BLOCK_HEADER> | OnlyFirst<PRE_CONFIRMED_BLOCK_WITH_TX_HASHES, object & BLOCK_HEADER & BLOCK_BODY_WITH_TX_HASHES & PRE_CONFIRMED_BLOCK_HEADER>>

---

getBlockWithTxs()

getBlockWithTxs(blockIdentifier?, options?): Promise<OnlyFirst<BLOCK_WITH_TXS, object & BLOCK_HEADER & BLOCK_BODY_WITH_TXS & PRE_CONFIRMED_BLOCK_HEADER> | OnlyFirst<PRE_CONFIRMED_BLOCK_WITH_TXS, object & BLOCK_HEADER & BLOCK_BODY_WITH_TXS & PRE_CONFIRMED_BLOCK_HEADER>>

Defined in: src/channel/rpc_0_10_2.ts:325

Get block information with full transactions

Parameters

blockIdentifier?

BlockIdentifier = ...

block identifier

options?

optional flags

• includeProofFacts - include proof facts in the response (RPC 0.10.1+)

includeProofFacts?

boolean

Returns

Promise<OnlyFirst<BLOCK_WITH_TXS, object & BLOCK_HEADER & BLOCK_BODY_WITH_TXS & PRE_CONFIRMED_BLOCK_HEADER> | OnlyFirst<PRE_CONFIRMED_BLOCK_WITH_TXS, object & BLOCK_HEADER & BLOCK_BODY_WITH_TXS & PRE_CONFIRMED_BLOCK_HEADER>>

---

getBlockWithReceipts()

getBlockWithReceipts(blockIdentifier?, options?): Promise<OnlyFirst<BLOCK_WITH_RECEIPTS, object & BLOCK_HEADER & BLOCK_BODY_WITH_RECEIPTS & PRE_CONFIRMED_BLOCK_HEADER> | OnlyFirst<PRE_CONFIRMED_BLOCK_WITH_RECEIPTS, object & BLOCK_HEADER & BLOCK_BODY_WITH_RECEIPTS & PRE_CONFIRMED_BLOCK_HEADER>>

Defined in: src/channel/rpc_0_10_2.ts:345

Get block information with transaction receipts

Parameters

blockIdentifier?

BlockIdentifier = ...

block identifier

options?

optional flags

• includeProofFacts - include proof facts in the response (RPC 0.10.1+)

includeProofFacts?

boolean

Returns

Promise<OnlyFirst<BLOCK_WITH_RECEIPTS, object & BLOCK_HEADER & BLOCK_BODY_WITH_RECEIPTS & PRE_CONFIRMED_BLOCK_HEADER> | OnlyFirst<PRE_CONFIRMED_BLOCK_WITH_RECEIPTS, object & BLOCK_HEADER & BLOCK_BODY_WITH_RECEIPTS & PRE_CONFIRMED_BLOCK_HEADER>>

---

getBlockStateUpdate()

getBlockStateUpdate(blockIdentifier?, contractAddresses?): Promise<OnlyFirst<STATE_UPDATE, STATE_UPDATE & PRE_CONFIRMED_STATE_UPDATE> | OnlyFirst<PRE_CONFIRMED_STATE_UPDATE, STATE_UPDATE & PRE_CONFIRMED_STATE_UPDATE>>

Defined in: src/channel/rpc_0_10_2.ts:359

Parameters

blockIdentifier?

BlockIdentifier = ...

contractAddresses?

BigNumberish[]

Returns

Promise<OnlyFirst<STATE_UPDATE, STATE_UPDATE & PRE_CONFIRMED_STATE_UPDATE> | OnlyFirst<PRE_CONFIRMED_STATE_UPDATE, STATE_UPDATE & PRE_CONFIRMED_STATE_UPDATE>>

---

getBlockTransactionsTraces()

getBlockTransactionsTraces(blockIdentifier?, options?): Promise<BlockTransactionsTraces>

Defined in: src/channel/rpc_0_10_2.ts:378

Get transaction traces for all transactions in a block

Parameters

blockIdentifier?

BlockIdentifier = ...

block identifier

options?

optional flags

• returnInitialReads - include initial storage reads in traces (RPC 0.10.1+)

returnInitialReads?

boolean

Returns

Promise<BlockTransactionsTraces>

---

getBlockTransactionCount()

getBlockTransactionCount(blockIdentifier?): Promise<number>

Defined in: src/channel/rpc_0_10_2.ts:392

Parameters

blockIdentifier?

BlockIdentifier = ...

Returns

Promise<number>

---

getTransactionByHash()

getTransactionByHash(txHash, options?): Promise<TXN_WITH_HASH>

Defined in: src/channel/rpc_0_10_2.ts:403

Get transaction by hash

Parameters

txHash

BigNumberish

transaction hash

options?

optional flags

• includeProofFacts - include proof facts in the response (RPC 0.10.1+)

includeProofFacts?

boolean

Returns

Promise<TXN_WITH_HASH>

---

getTransactionByBlockIdAndIndex()

getTransactionByBlockIdAndIndex(blockIdentifier, index, options?): Promise<TXN_WITH_HASH>

Defined in: src/channel/rpc_0_10_2.ts:421

Get transaction by block identifier and index

Parameters

blockIdentifier

BlockIdentifier

block identifier

index

number

transaction index in the block

options?

optional flags

• includeProofFacts - include proof facts in the response (RPC 0.10.1+)

includeProofFacts?

boolean

Returns

Promise<TXN_WITH_HASH>

---

getTransactionReceipt()

getTransactionReceipt(txHash): Promise<TXN_RECEIPT_WITH_BLOCK_INFO>

Defined in: src/channel/rpc_0_10_2.ts:437

Parameters

txHash

BigNumberish

Returns

Promise<TXN_RECEIPT_WITH_BLOCK_INFO>

---

getTransactionTrace()

getTransactionTrace(txHash): Promise<TRANSACTION_TRACE>

Defined in: src/channel/rpc_0_10_2.ts:442

Parameters

txHash

BigNumberish

Returns

Promise<TRANSACTION_TRACE>

---

getTransactionStatus()

getTransactionStatus(transactionHash): Promise<TXN_STATUS_RESULT>

Defined in: src/channel/rpc_0_10_2.ts:450

Get the status of a transaction

Parameters

transactionHash

BigNumberish

Returns

Promise<TXN_STATUS_RESULT>

---

simulateTransaction()

simulateTransaction(invocations, simulateTransactionOptions?): Promise<SimulateTransactionResponse>

Defined in: src/channel/rpc_0_10_2.ts:463

Parameters

invocations

AccountInvocations

AccountInvocations

simulateTransactionOptions?

getSimulateTransactionOptions = {}

blockIdentifier and flags to skip validation and fee charge

• blockIdentifier
  
• skipValidate (default true)
  
• skipFeeCharge (default true)
  
• returnInitialReads (default false) - include initial storage reads in trace (RPC 0.10.1+)
  

Returns

Promise<SimulateTransactionResponse>

---

waitForTransaction()

waitForTransaction(txHash, options?): Promise<TXN_RECEIPT>

Defined in: src/channel/rpc_0_10_2.ts:490

Parameters

txHash

BigNumberish

options?

waitForTransactionOptions

Returns

Promise<TXN_RECEIPT>

---

getStorageAt()

getStorageAt(contractAddress, key, blockIdentifier?, responseFlags?): Promise<string | STORAGE_RESULT>

Defined in: src/channel/rpc_0_10_2.ts:584

Parameters

contractAddress

BigNumberish

key

BigNumberish

blockIdentifier?

BlockIdentifier = ...

responseFlags?

"INCLUDE_LAST_UPDATE_BLOCK"[]

Returns

Promise<string | STORAGE_RESULT>

---

getClassHashAt()

getClassHashAt(contractAddress, blockIdentifier?): Promise<string>

Defined in: src/channel/rpc_0_10_2.ts:601

Parameters

contractAddress

BigNumberish

blockIdentifier?

BlockIdentifier = ...

Returns

Promise<string>

---

getClass()

getClass(classHash, blockIdentifier?): Promise<OnlyFirst<CONTRACT_CLASS, CONTRACT_CLASS & DEPRECATED_CONTRACT_CLASS> | OnlyFirst<DEPRECATED_CONTRACT_CLASS, CONTRACT_CLASS & DEPRECATED_CONTRACT_CLASS>>

Defined in: src/channel/rpc_0_10_2.ts:613

Parameters

classHash

BigNumberish

blockIdentifier?

BlockIdentifier = ...

Returns

Promise<OnlyFirst<CONTRACT_CLASS, CONTRACT_CLASS & DEPRECATED_CONTRACT_CLASS> | OnlyFirst<DEPRECATED_CONTRACT_CLASS, CONTRACT_CLASS & DEPRECATED_CONTRACT_CLASS>>

---

getClassAt()

getClassAt(contractAddress, blockIdentifier?): Promise<OnlyFirst<CONTRACT_CLASS, CONTRACT_CLASS & DEPRECATED_CONTRACT_CLASS> | OnlyFirst<DEPRECATED_CONTRACT_CLASS, CONTRACT_CLASS & DEPRECATED_CONTRACT_CLASS>>

Defined in: src/channel/rpc_0_10_2.ts:625

Parameters

contractAddress

BigNumberish

blockIdentifier?

BlockIdentifier = ...

Returns

Promise<OnlyFirst<CONTRACT_CLASS, CONTRACT_CLASS & DEPRECATED_CONTRACT_CLASS> | OnlyFirst<DEPRECATED_CONTRACT_CLASS, CONTRACT_CLASS & DEPRECATED_CONTRACT_CLASS>>

---

getEstimateFee()

getEstimateFee(invocations, options?): Promise<FEE_ESTIMATE[]>

Defined in: src/channel/rpc_0_10_2.ts:637

Parameters

invocations

AccountInvocations

options?

getEstimateFeeBulkOptions = {}

Returns

Promise<FEE_ESTIMATE[]>

---

invoke()

invoke(functionInvocation, details): Promise<InvokedTransaction>

Defined in: src/channel/rpc_0_10_2.ts:659

Parameters

functionInvocation

Invocation

details

InvocationsDetailsWithNonce

Returns

Promise<InvokedTransaction>

---

invokeSignedTx()

invokeSignedTx(transaction): Promise<InvokedTransaction>

Defined in: src/channel/rpc_0_10_2.ts:676

Parameters

transaction

INVOKE_TXN_V3

Returns

Promise<InvokedTransaction>

---

declare()

declare(declareTransaction, details): Promise<TXN_RECEIPT | DeclaredTransaction>

Defined in: src/channel/rpc_0_10_2.ts:683

Parameters

declareTransaction

DeclareContractTransaction

details

InvocationsDetailsWithNonce

Returns

Promise<TXN_RECEIPT | DeclaredTransaction>

---

deployAccount()

deployAccount(deployAccountTransaction, details): Promise<TXN_RECEIPT | DeployedAccountTransaction>

Defined in: src/channel/rpc_0_10_2.ts:703

Parameters

deployAccountTransaction

DeployAccountContractTransaction

details

InvocationsDetailsWithNonce

Returns

Promise<TXN_RECEIPT | DeployedAccountTransaction>

---

callContract()

callContract(call, blockIdentifier?): Promise<string[]>

Defined in: src/channel/rpc_0_10_2.ts:723

Parameters

call

Call

blockIdentifier?

BlockIdentifier = ...

Returns

Promise<string[]>

---

estimateMessageFee()

estimateMessageFee(message, blockIdentifier?): Promise<MESSAGE_FEE_ESTIMATE>

Defined in: src/channel/rpc_0_10_2.ts:739

NEW: Estimate the fee for a message from L1

Parameters

message

MSG_FROM_L1

Message From L1

blockIdentifier?

BlockIdentifier = ...

Returns

Promise<MESSAGE_FEE_ESTIMATE>

---

getSyncingStats()

getSyncingStats(): Promise<Syncing>

Defined in: src/channel/rpc_0_10_2.ts:762

Returns an object about the sync status, or false if the node is not synching

Returns

Promise<Syncing>

Object with the stats data

---

getEvents()

getEvents(eventFilter): Promise<EVENTS_CHUNK>

Defined in: src/channel/rpc_0_10_2.ts:770

Returns all events matching the given filter

Parameters

eventFilter

EventFilter

Returns

Promise<EVENTS_CHUNK>

events and the pagination of the events

---

buildTransaction()

buildTransaction<T>(invocation, versionType?): Promise<T extends object ? BROADCASTED_INVOKE_TXN : T extends object ? BROADCASTED_DECLARE_TXN_V3 : T extends object ? DEPLOY_ACCOUNT_TXN_V3 : never>

Defined in: src/channel/rpc_0_10_2.ts:775

Type Parameters

T

T extends AccountInvocationItem

Parameters

invocation

T

versionType?

"fee" | "transaction"

Returns

Promise<T extends object ? BROADCASTED_INVOKE_TXN : T extends object ? BROADCASTED_DECLARE_TXN_V3 : T extends object ? DEPLOY_ACCOUNT_TXN_V3 : never>