@msaki/eth-rpc 0.1.0 → 0.2.0

package/src/types/engine.d.ts

@@ -0,0 +1,127 @@
+declare global {
+	// engine types
+	export interface TransitionConfigurationV1 {
+		terminalTotalDifficulty: Uint256;
+		terminalBlockHash: Hash32;
+		terminalBlockNumber: Uint64;
+	}
+	export enum PAYLOAD_STATUS {
+		VALID = "VALID",
+		INVALID = "INVALID",
+		SYNCING = "SYNCING",
+		ACCEPTED = "ACCEPTED",
+		INVALID_BLOCK_HASH = "INVALID_BLOCK_HASH",
+	}
+	export interface PayloadStatusV1 {
+		status: PAYLOAD_STATUS;
+		latestValidHash?: Hash32;
+		validationError?: string;
+	}
+	export interface RestrictedPayloadStatusV1 {
+		status:
+		| PAYLOAD_STATUS.VALID
+		| PAYLOAD_STATUS.INVALID
+		| PAYLOAD_STATUS.SYNCING;
+		latestValidHash: Hash32;
+		validationError: string;
+	}
+	export interface PayloadStatusNoInvalidBlockHash {
+		status: Exclude<PAYLOAD_STATUS, PAYLOAD_STATUS.INVALID_BLOCK_HASH>;
+		latestValidHash: Hash32;
+		validationError: string;
+	}
+	export interface ExecutionPayloadV1 {
+		parentHash: Hash32;
+		feeRecipient: Address;
+		stateRoot: Hash32;
+		receiptsRoot: Hash32;
+		logsBloom: Bytes256;
+		prevRandao: Bytes32;
+		blockNumber: Uint64;
+		gasLimit: Uint64;
+		gasUsed: Uint64;
+		timestamp: Uint64;
+		extraData: Bytes32;
+		baseFeePerGas: Uint64;
+		blockHash: Hash32;
+		transactions: Bytes[];
+	}
+	export interface WithdrawalV1 {
+		index: Uint64;
+		validatorIndex: Uint64;
+		address: Address;
+		amount: Uint64;
+	}
+	export interface ExecutionPayloadV2 {
+		parentHash: Hash32;
+		feeRecipient: Address;
+		stateRoot: Hash32;
+		receiptsRoot: Hash32;
+		logsBloom: Bytes256;
+		prevRandao: Bytes32;
+		blockNumber: Uint64;
+		gasLimit: Uint64;
+		gasUsed: Uint64;
+		timestamp: Uint64;
+		extraData: Bytes32;
+		baseFeePerGas: Uint64;
+		blockHash: Hash32;
+		transactions: Bytes[];
+		withdrawals: WithdrawalV1[];
+	}
+	export interface ExecutionPayloadV3 {
+		parentHash: Hash32;
+		feeRecipient: Address;
+		stateRoot: Hash32;
+		receiptsRoot: Hash32;
+		logsBloom: Bytes256;
+		prevRandao: Bytes32;
+		blockNumber: Uint64;
+		gasLimit: Uint64;
+		gasUsed: Uint64;
+		timestamp: Uint64;
+		extraData: Bytes32;
+		baseFeePerGas: Uint64;
+		blockHash: Hash32;
+		transactions: Bytes[];
+		withdrawals: WithdrawalV1[];
+		blobGasUsed: Uint64;
+		excessBlobGas: Uint64;
+	}
+	export interface ExecutionPayloadV4 {
+		parentHash: Hash32;
+		feeRecipient: Address;
+		stateRoot: Hash32;
+		receiptsRoot: Hash32;
+		logsBloom: Bytes256;
+		prevRandao: Bytes32;
+		blockNumber: Uint64;
+		gasLimit: Uint64;
+		gasUsed: Uint64;
+		timestamp: Uint64;
+		extraData: Bytes32;
+		baseFeePerGas: Uint64;
+		blockHash: Hash32;
+		transactions: Bytes[];
+		withdrawals: WithdrawalV1[];
+		blobGasUsed: Uint64;
+		excessBlobGas: Uint64;
+		blockAccessList: Bytes;
+	}
+	export interface ExecutionPayloadBodyV1 {
+		transactions: Bytes[];
+		withdrawals?: WithdrawalV1[];
+	}
+	export interface BlobsBundleV1 {
+		commitments: Bytes48[];
+		proofs: Bytes48[];
+		blobs: Bytes[];
+	}
+	export interface BlobsBundleV2 {
+		commitments: Bytes48[];
+		proofs: Bytes48[];
+		blobs: Bytes[];
+	}
+}
+
+export { };

package/src/types/execute.d.ts

@@ -0,0 +1,85 @@
+declare global {
+	// execute.yaml
+	export interface EthSimulatePayload {
+		blockStateCalls: BlockStateCall[];
+		traceTransfers?: boolean;
+		validation?: boolean;
+		returnFullTransactions?: boolean;
+	}
+	export interface BlockStateCall {
+		blockOverrides?: BlockOverrides;
+		stateOverrides?: StateOverrides;
+		calls?: GenericCallTransaction[];
+	}
+	export interface BlockOverrides {
+		number?: Uint64;
+		prevRandao?: Uint256;
+		time?: Uint64;
+		gasLimit?: Uint64;
+		feeRecipient?: Address;
+		baseFeePerGas?: Uint256;
+		withdrawals?: Withdrawal[];
+		blobBaseFee?: Uint64;
+	}
+	export type StateOverrides = Record<Address, AccountOverride>;
+	export interface GenericCallTransaction {
+		type?: "0x0" | "0x1" | "0x2" | "0x3";
+		to?: Address | null;
+		from?: Address;
+		value?: Uint;
+		nonce?: Uint;
+		gas?: Uint;
+		input?: Bytes;
+		gasPrice?: Uint;
+		maxPriorityFeePerGas?: Uint;
+		maxFeePerGas?: Uint;
+		maxFeePerBlobGas?: Uint;
+		accessList?: AccessListEntry[];
+		blobVersionedHashes?: Hash32[];
+		authorizationList?: AuthorizationList;
+	}
+	export type AccountOverride = AccountOverrideState | AccountOverrideStateDiff;
+	export interface AccountOverrideState {
+		state: AccountStorage;
+		nonce?: Uint64;
+		balance?: Uint256;
+		code?: Bytes;
+		movePrecompileToAddress?: Address;
+	}
+	export interface AccountOverrideStateDiff {
+		stateDiff: AccountStorage;
+		nonce?: Uint64;
+		balance?: Uint256;
+		code?: Bytes;
+		movePrecompileToAddress?: Address;
+	}
+	export type AccountStorage = Record<Bytes32, Hash32>;
+	export type EthSimulateResult = EthSimulateBlockResultSingleSuccess[];
+
+	export type EthSimulateBlockResultSingleSuccess = {
+		calls: CallResults;
+	} & Block;
+	export type CallResults = CallResultFailure | CallResultSuccess;
+	export interface CallResultFailure {
+		status: "0x0";
+		returnData: Bytes;
+		gasUsed: Uint64;
+		error: EXECUTION_REVERTED_ERROR | VM_EXECUTION_ERROR;
+	}
+	export type EXECUTION_REVERTED_ERROR = {
+		code: -32000;
+		message: "execution reverted.";
+	};
+	export type VM_EXECUTION_ERROR = {
+		code: -32015;
+		message: "vm execution error.";
+	};
+	export interface CallResultSuccess {
+		status: "0x1";
+		returnData: Bytes;
+		gasUsed: Uint64;
+		logs: Log[];
+	}
+}
+
+export { };

package/src/types/feeHistory.d.ts

@@ -0,0 +1,18 @@
+declare global {
+	// misc
+	export interface FeeHistoryResults {
+		oldestBlock: Uint;
+		baseFeePerGas: Uint[];
+		baseFeePerBlobGas?: Uint[];
+		gasUsedRatio: Ratio[];
+		blobGasUsedRatio?: Ratio[];
+		reward?: Uint[][];
+	}
+	export interface AccessListResult {
+		accessList?: AccessListEntry[];
+		error?: string;
+		gasUsed?: Uint;
+	}
+}
+
+export { };

package/src/types/filter.d.ts

@@ -0,0 +1,20 @@
+declare global {
+	// filter.yaml
+	export type FilterResults = Hash32[] | Log[];
+	export type FilterTopic = Bytes32 | Bytes32[];
+	export type FilterTopics = FilterTopic | null;
+	export type Filter = FilterByBlockRange | FilterByBlockHash;
+	export interface FilterByBlockRange {
+		fromBlock?: Uint;
+		toBlock?: Uint;
+		address?: null | Address | Addresses;
+		topics?: FilterTopics;
+	}
+	export interface FilterByBlockHash {
+		blockHash: Hash32;
+		address?: Address | Addresses | null;
+		topics?: FilterTopics;
+	}
+}
+
+export { };

package/src/types/forkchoice.d.ts

@@ -0,0 +1,40 @@
+declare global {
+	// forkchoice
+	export interface ForkchoiceStateV1 {
+		headBlockHash: Hash32;
+		safeBlockHash: Hash32;
+		finalizedBlockHash: Hash32;
+	}
+	export interface ForkchoiceUpdatedResponseV1 {
+		payloadStatus: RestrictedPayloadStatusV1;
+		payloadId?: Bytes8;
+	}
+	export interface PayloadAttributesV1 {
+		timestamp: Uint64;
+		prevRandao: Bytes32;
+		suggestedFeeRecipient: Address;
+	}
+	export interface PayloadAttributesV2 {
+		timestamp: Uint64;
+		prevRandao: Bytes32;
+		suggestedFeeRecipient: Address;
+		withdrawals: WithdrawalV1[];
+	}
+	export interface PayloadAttributesV3 {
+		timestamp: Uint64;
+		prevRandao: Bytes32;
+		suggestedFeeRecipient: Address;
+		withdrawals: WithdrawalV1[];
+		parentBeaconBlockRoot: Hash32;
+	}
+	export interface BlobAndProofV1 {
+		blob: Bytes;
+		proof: Bytes48;
+	}
+	export interface BlobAndProofV2 {
+		blob: Bytes;
+		proofs: Bytes48[];
+	}
+}
+
+export { };

package/src/types/receit.d.ts

@@ -0,0 +1,36 @@
+declare global {
+	// receipt.yaml
+	export interface Log {
+		transactionHash: Hash32;
+		removed?: boolean;
+		logIndex?: Uint;
+		transactionIndex?: Uint;
+		blockHash?: Hash32;
+		blockNumber?: Uint;
+		blockTimestamp?: Uint;
+		address?: Address;
+		data?: Bytes;
+		topics?: Bytes32[];
+	}
+	export interface ReceiptInfo {
+		type?: Byte;
+		transactionHash: Hash32;
+		transactionIndex: Uint;
+		blockHash: Byte;
+		blockNumber: Uint;
+		from: Address;
+		to?: Address | null;
+		cumulativeGasUsed: Uint;
+		gasUsed: Uint;
+		blobGasUsed?: Uint;
+		contractAddress?: Address | null;
+		logs: Log[];
+		logsBloom: Bytes256;
+		root?: Hash32;
+		status?: Uint;
+		effectiveGasPrice: Uint;
+		blobGasPrice?: Uint;
+	}
+}
+
+export { };

package/src/types/state.d.ts

@@ -0,0 +1,19 @@
+declare global {
+	// state.yaml
+	export interface AccountProof {
+		address: Address;
+		accountProof: Bytes;
+		balance: Uint256;
+		codeHash: Hash32;
+		nonce: Uint64;
+		storageHash: Hash32;
+		storageProof: StorageProof;
+	}
+	export interface StorageProof {
+		key: Bytes32;
+		value: Uint256;
+		proof: Bytes;
+	}
+}
+
+export { };

package/src/types/transaction.d.ts

@@ -0,0 +1,149 @@
+declare global {
+	// transaction.yaml
+	export interface AccessListEntry {
+		address: Address;
+		storageKeys: Hash32[];
+	}
+	export type TransactionUnsigned =
+		| TransactionLegacyUnsigned
+		| Transaction2930Unsigned
+		| Transaction1559Unsigned
+		| Transaction4844Unsigned
+		| Transaction7702Unsigned;
+
+	export interface TransactionLegacyUnsigned {
+		type: "0x0";
+		nonce: Uint;
+		to?: Address | null;
+		gas: Uint;
+		value: Uint;
+		input: Bytes;
+		gasPrice: Uint;
+		chainId?: Uint;
+	}
+	export interface Transaction2930Unsigned {
+		type: "0x1";
+		nonce: Uint;
+		to?: Address | null;
+		gas: Uint;
+		value: Uint;
+		input: Bytes;
+		gasPrice: Uint;
+		chainId: Uint;
+		accessList: AccessListEntry[];
+	}
+	export interface Transaction1559Unsigned {
+		type: "0x2";
+		nonce: Uint;
+		to?: Address | null;
+		gas: Uint;
+		value: Uint;
+		input: Bytes;
+		gasPrice: Uint;
+		maxFeePerGas: Uint;
+		maxPriorityFeePerGas: Uint;
+		accessList: AccessListEntry[];
+		chainId: Uint;
+	}
+	export interface Transaction4844Unsigned {
+		type: "0x3";
+		nonce: Uint;
+		to: Address;
+		gas: Uint;
+		value: Uint;
+		input: Bytes;
+		gasPrice?: Uint;
+		maxFeePerGas: Uint;
+		maxPriorityFeePerGas: Uint;
+		maxFeePerBlobGas: Uint;
+		accessList: AccessListEntry[];
+		blobVersionedHashes: Hash32[];
+		chainId: Uint;
+	}
+	export interface Transaction7702Unsigned {
+		type: "0x4";
+		nonce: Uint;
+		to: Address;
+		gas: Uint;
+		value: Uint;
+		input: Bytes;
+		maxPriorityFeePerGas: Uint;
+		maxFeePerGas: Uint;
+		gasPrice?: Uint;
+		accessList: AccessListEntry[];
+		chainId: Uint;
+		authorizationList: AuthorizationList;
+	}
+	export interface AuthorizationListEntry {
+		chainId: Uint;
+		nonce: Uint;
+		address: Address;
+		yParity: Byte;
+		r: Uint256;
+		s: Uint256;
+	}
+	export type AuthorizationList = AuthorizationListEntry[];
+
+	export type TransactionLegacySigned = {
+		v: Byte;
+		r: Uint;
+		s: Uint;
+	} & TransactionLegacyUnsigned;
+	export type Transaction2930Signed = {
+		yParity: Bytes;
+		r: Uint;
+		s: Uint;
+		v?: Byte;
+	} & Transaction2930Unsigned;
+	export type Transaction1559Signed = {
+		yParity: Bytes;
+		r: Uint;
+		s: Uint;
+		v?: Byte;
+	} & Transaction1559Unsigned;
+	export type Transaction4844Signed = {
+		yParity: Byte;
+		r: Uint;
+		s: Uint;
+		v?: Byte;
+	} & Transaction4844Unsigned;
+	export type Transaction7702Signed = {
+		yParity: Byte;
+		r: Uint;
+		s: Uint;
+		v?: Byte;
+	} & Transaction7702Unsigned;
+	export type TransactionSigned =
+		| TransactionLegacySigned
+		| Transaction2930Signed
+		| Transaction1559Signed
+		| Transaction4844Signed
+		| Transaction7702Signed;
+	export type TransactionInfo = {
+		blockHash: Hash32;
+		blockNumber: Uint;
+		from: Address;
+		hash: Hash32;
+		transactionIndex: Uint;
+	} & TransactionSigned;
+	export interface GenericTransaction {
+		type?: "0x0" | "0x1" | "0x2" | "0x3";
+		to?: Address | null;
+		from?: Address;
+		value?: Uint;
+		nonce?: Uint;
+		gas?: Uint;
+		input?: Bytes;
+		gasPrice?: Uint;
+		maxPriorityFeePerGas?: Uint;
+		maxFeePerGas?: Uint;
+		maxFeePerBlobGas?: Uint;
+		accessList?: AccessListEntry[];
+		blobVersionedHashes?: Hash32[];
+		blobs?: Bytes[];
+		chainId?: Uint;
+		authorizationList?: AuthorizationList;
+	}
+}
+
+export { };

package/src/types/withdraw.d.ts

@@ -0,0 +1,11 @@
+declare global {
+	// withdrawal.yaml
+	export interface Withdrawal {
+		index: Uint64;
+		validatorIndex: Uint64;
+		address: Address;
+		amount: Uint256;
+	}
+}
+
+export { };