mod account;
mod avalanche;
mod cloud;
mod config;
pub mod dex_catalog;
mod error;
mod ethereum;
mod generated;
mod price;
mod rest;
mod rpc;
mod solana;
mod subscriptions;
mod swap;
pub mod token_catalog;
pub mod token_rankings;
mod usage;
pub use account::{AccountClient, ErpcPlan, TokenBalance};
pub use avalanche::{
AVALANCHE_AVAX_METHODS, AVALANCHE_INDEX_METHODS, AVALANCHE_INFO_METHODS,
AVALANCHE_P_CHAIN_METHODS, AVALANCHE_PROPOSER_VM_METHODS, AVALANCHE_X_CHAIN_METHODS,
AvalancheAvaxClient, AvalancheClient, AvalancheIndexClient, AvalancheIndexRpcClient,
AvalancheInfoClient, AvalanchePChainClient, AvalancheProposerVmClient, AvalancheXChainClient,
};
pub use cloud::{
CloudCatalogClient, CloudCredit, CloudCreditAlertLevel, CloudCreditClient, CloudOffering,
CloudOfferingBilling, CloudOfferingCompute, CloudOfferingComputeTenancy, CloudOfferingSolana,
CloudOfferingSolanaTransport, CloudResource, CloudResourceBillingStatus, CloudResourceKind,
CloudResourceMode, CloudResourceStatus, CloudResourceStatusBilling, CloudResourcesClient,
ErpcCloudClient, ErpcCloudClientConfig,
};
pub use config::{
DEFAULT_ACCOUNT_ENDPOINT, DEFAULT_AVALANCHE_ENDPOINT, DEFAULT_ENDPOINT, DEFAULT_TIMEOUT,
DEFAULT_USER_ENDPOINT, ErpcClientConfig,
};
pub use dex_catalog::{
DEX_ALIASES, DEX_CATALOG_AS_OF_DATE, DEX_CATALOG_CONTENT_DIGEST, DEX_CATALOG_VERSION,
DEX_CHAIN_IDS, DEX_DEPLOYMENTS, DexAlias, DexChainId, DexDeployment,
ListPoolDefinitionsOptions, NATIVE_WRAP_DEFINITIONS, NativeWrapDefinition, POOL_DEFINITIONS,
PoolAdapter, PoolDefinition, dexes, find_pool_definition_by_address,
find_pool_definitions_by_pair, get_dex_deployment, get_native_wrap_definition,
get_pool_definition, list_pool_definitions, pools,
};
pub use error::{ErpcError, ErpcErrorCode, JsonRpcErrorObject, Result};
pub use ethereum::{
ETHEREUM_RPC_METHODS, ETHEREUM_SUBSCRIPTION_METHODS, EthereumClient, EthereumRpcClient,
EthereumSubscriptions,
};
pub use price::{
BinaryUpdate, ParsedPriceMetadata, ParsedPriceUpdate, ParsedPublisherStakeCaps, PriceAssetType,
PriceClient, PriceEncoding, PriceFeedMetadata, PricePoint, PriceStream, PriceStreamEvent,
PriceStreamOptions, PriceUpdateOptions, PriceUpdateResponse, PublisherStakeCap,
PublisherStakeCapsResponse,
};
pub use rpc::{
HttpJsonRpcTransport, HttpTransportConfig, JsonRpcId, PendingRpcBatchRequest,
PendingRpcRequest, RequestOptions, RpcBatchCall, RpcNamespace,
};
pub use solana::{
AddressTransaction, AddressTransactionPage, AddressTransactionsOptions, AddressTransfer,
AddressTransferDirection, AddressTransferFilters, AddressTransferPage, AddressTransferType,
AddressTransfersOptions, AnalyticsTimeBound, AssetBatchRequest, AssetListRequest, AssetRequest,
EpochSummary, IndexedAsset, IndexedAssetList, IndexedAssetProof, LeaderSlot, LeaderSlotsResult,
NumericFilter, PingMeasurement, PriorityFeeEstimate, ProgramStatsBucket, ProgramStatsOptions,
SOLANA_ANALYTICS_METHODS, SOLANA_DAS_METHODS, SOLANA_ENHANCED_SUBSCRIPTION_METHODS,
SOLANA_HISTORY_METHODS, SOLANA_LEADER_METHODS, SOLANA_RPC_METHODS, SlotStatsOptions,
SlotStatsRow, SolanaAnalyticsClient, SolanaClient, SolanaCommitment, SolanaContext,
SolanaContextResult, SolanaDasClient, SolanaEncoding, SolanaHistoryClient, SolanaLeaderClient,
SolanaRpcClient, SolanaSubscriptions, TopProgramRow, TopProgramsOptions, TpsBucket,
TpsTimeseriesOptions, ValidatorInformation, ValidatorsInformationOptions,
ValidatorsInformationResult,
};
pub use subscriptions::{RpcNotification, RpcSubscription, SubscriptionId};
pub use swap::{
EvmBlockSnapshot, ExactInputQuoteRequest, ExactInputQuoteResult, QuoteFee, SwapClient,
SwapFreshness, SwapQuoteError, SwapQuoteErrorCode, SwapQuoteRequest, SwapResult,
};
pub use token_catalog::{
TOKEN_ALIASES, TOKEN_ASSETS, TOKEN_CATALOG_AS_OF_DATE, TOKEN_CATALOG_CONTENT_DIGEST,
TOKEN_CATALOG_VERSION, TOKEN_CHAIN_IDS, TOKEN_DEPLOYMENTS, TokenAlias, TokenAsset,
TokenChainId, TokenDeployment, TokenRepresentationKind, TokenStandard, TokenStatus,
find_token_deployment_by_address, find_token_deployments_by_symbol,
get_native_token_deployment, get_token_asset, get_token_deployment, list_token_deployments,
token_chain_ids, tokens,
};
pub use token_rankings::{
TOKEN_RANKINGS, TOKEN_RANKINGS_AS_OF, TOKEN_RANKINGS_CONTENT_DIGEST, TOKEN_RANKINGS_COVERAGE,
TOKEN_RANKINGS_METADATA, TOKEN_RANKINGS_METRIC, TOKEN_RANKINGS_SCHEMA_VERSION,
TOKEN_RANKINGS_SOURCE_IDS, TOKEN_RANKINGS_STATUS, TokenRanking, TokenRankingCoverage,
TokenRankingMetadata, list_token_rankings,
};
pub use tokio_util::sync::CancellationToken;
pub use usage::{
MonthlyApiKeyChainUsage, MonthlyApiKeyMethodUsage, MonthlyApiKeyUsage, MonthlyApiKeyUsageEntry,
MonthlyApiKeyUsageParams, UsageClient,
};
use std::sync::Arc;
use config::{ResolvedErpcClientConfig, endpoint_with_path, websocket_url};
use rest::RestTransport;
use subscriptions::WebSocketJsonRpcTransport;
fn rpc_transport(
resolved: &ResolvedErpcClientConfig,
endpoint: url::Url,
client: &reqwest::Client,
) -> Arc<HttpJsonRpcTransport> {
Arc::new(HttpJsonRpcTransport::new(HttpTransportConfig {
api_key: resolved.api_key.clone(),
endpoint,
headers: resolved.headers.clone(),
max_batch_size: 256,
timeout: resolved.timeout,
client: client.clone(),
}))
}
fn avalanche_index_transports(
resolved: &ResolvedErpcClientConfig,
client: &reqwest::Client,
) -> avalanche::AvalancheIndexTransports {
let index_transport = |path| {
rpc_transport(
resolved,
endpoint_with_path(&resolved.avalanche_endpoint, path),
client,
)
};
avalanche::AvalancheIndexTransports {
c_chain_blocks: index_transport("/ava/ext/index/C/block"),
p_chain_blocks: index_transport("/ava/ext/index/P/block"),
x_chain_blocks: index_transport("/ava/ext/index/X/block"),
x_chain_transactions: index_transport("/ava/ext/index/X/tx"),
}
}
#[derive(Clone)]
pub struct ErpcClient {
pub account: AccountClient,
pub avalanche: AvalancheClient,
pub ethereum: EthereumClient,
pub price: PriceClient,
pub solana: SolanaClient,
pub swap: SwapClient,
pub usage: UsageClient,
}
impl ErpcClient {
pub fn new(config: ErpcClientConfig) -> Result<Self> {
let resolved = ResolvedErpcClientConfig::try_from(config)?;
let http = ResolvedErpcClientConfig::http_client()?;
let solana_transport = rpc_transport(&resolved, resolved.endpoint.clone(), &http);
let ethereum_transport = rpc_transport(
&resolved,
endpoint_with_path(&resolved.endpoint, "/eth"),
&http,
);
let avalanche_transport = rpc_transport(
&resolved,
endpoint_with_path(&resolved.avalanche_endpoint, "/ava"),
&http,
);
let avalanche_index = avalanche_index_transports(&resolved, &http);
let solana_ws = Arc::new(WebSocketJsonRpcTransport::new(
websocket_url(&resolved.endpoint, &resolved.api_key, "")?,
resolved.timeout,
));
let ethereum_ws = Arc::new(WebSocketJsonRpcTransport::new(
websocket_url(&resolved.endpoint, &resolved.api_key, "/eth")?,
resolved.timeout,
));
let avalanche_ws = Arc::new(WebSocketJsonRpcTransport::new(
websocket_url(&resolved.avalanche_endpoint, &resolved.api_key, "/ava-ws")?,
resolved.timeout,
));
let shared_rest = RestTransport::new(
resolved.api_key.clone(),
resolved.endpoint,
resolved.headers.clone(),
resolved.timeout,
http.clone(),
);
let account_rest = RestTransport::new(
resolved.api_key.clone(),
resolved.account_endpoint,
resolved.headers.clone(),
resolved.timeout,
http.clone(),
);
let user_rest = RestTransport::new(
resolved.api_key,
resolved.user_endpoint,
resolved.headers,
resolved.timeout,
http,
);
let swap = SwapClient::new(
Arc::clone(ðereum_transport),
Arc::clone(&avalanche_transport),
);
Ok(Self {
account: AccountClient::new(account_rest),
avalanche: AvalancheClient::new(avalanche_transport, avalanche_ws, avalanche_index),
ethereum: EthereumClient::new(ethereum_transport, ethereum_ws),
price: PriceClient::new(shared_rest),
solana: SolanaClient::new(solana_transport, solana_ws),
swap,
usage: UsageClient::new(user_rest),
})
}
#[cfg(test)]
pub(crate) fn new_with_swap_clock(
config: ErpcClientConfig,
clock: fn() -> u64,
) -> Result<Self> {
let mut client = Self::new(config)?;
client.swap = client.swap.with_clock(clock);
Ok(client)
}
pub async fn close(&self) {
self.solana.subscriptions.close().await;
self.ethereum.subscriptions.close().await;
self.avalanche.subscriptions.close().await;
}
}