@elsoul/erpc-sdk 0.4.0 → 0.5.0

package/README.md

@@ -1,8 +1,9 @@
 # `@elsoul/erpc-sdk`
 
 Official type-safe TypeScript client for [ERPC](https://erpc.global). Use one
-client and one API key for Solana, Ethereum, price data, indexed data, leader
-and validator data, analytics, subscriptions, and account information.
+client and one API key for Solana, Ethereum, Avalanche C-Chain, price data,
+indexed data, leader and validator data, analytics, subscriptions, and account
+information.
 
 ## Install
 
@@ -26,8 +27,9 @@ const erpc = createErpcClient({ apiKey })
 
 const slot = await erpc.solana.rpc.getSlot().send()
 const chainId = await erpc.ethereum.rpc.eth_chainId().send()
+const avalancheChainId = await erpc.avalanche.rpc.eth_chainId().send()
 
-console.log({ slot, chainId })
+console.log({ slot, chainId, avalancheChainId })
 erpc.close()
 ```
 
@@ -46,10 +48,18 @@ network request.
 | `erpc.solana.subscriptions` | Enhanced WebSocket subscriptions |
 | `erpc.ethereum.rpc` | Ethereum JSON-RPC |
 | `erpc.ethereum.subscriptions` | Ethereum WebSocket subscriptions |
+| `erpc.avalanche.rpc` | Avalanche C-Chain EVM-compatible JSON-RPC |
+| `erpc.avalanche.subscriptions` | Avalanche C-Chain WebSocket subscriptions |
 | `erpc.price` | Price metadata, updates, and streams |
 | `erpc.account` | ERPC token balance |
 | `erpc.usage` | Masked monthly API-key usage |
 
+`avalancheEndpoint` defaults to `https://ava-rpc.erpc.global` and can be
+overridden independently from the shared `endpoint` option. The SDK uses its
+`/ava` HTTP route and `/ava-ws` WebSocket route. The Avalanche namespace uses
+the Ethereum-compatible typed catalog; use `raw` for additional C-Chain
+methods.
+
 ## Examples
 
 ```ts
@@ -59,6 +69,10 @@ const block = await erpc.ethereum.rpc
   .eth_getBlockByNumber('latest', false)
   .send()
 
+const avalancheBlock = await erpc.avalanche.rpc
+  .eth_getBlockByNumber('latest', false)
+  .send()
+
 const prices = await erpc.price.getLatestPriceUpdates({
   ids: [feedId],
   parsed: true,

package/dist/index.cjs

@@ -316,6 +316,7 @@ var CloudCatalogClient = class {
 
 // src/config.ts
 var DEFAULT_ENDPOINT = "https://edge.erpc.global";
+var DEFAULT_AVALANCHE_ENDPOINT = "https://ava-rpc.erpc.global";
 var DEFAULT_ACCOUNT_ENDPOINT = "https://solana-rpc.erpc.global";
 var DEFAULT_USER_ENDPOINT = "https://user-api.erpc.global";
 var DEFAULT_TIMEOUT_MS = 3e4;
@@ -332,10 +333,14 @@ var resolveConfig = (config) => {
   const apiKey = config.apiKey.trim();
   if (!apiKey) throw new ErpcConfigError("apiKey must not be empty");
   let endpoint;
+  let avalancheEndpoint;
   let accountEndpoint;
   let userEndpoint;
   try {
     endpoint = new URL(config.endpoint ?? DEFAULT_ENDPOINT);
+    avalancheEndpoint = new URL(
+      config.avalancheEndpoint ?? DEFAULT_AVALANCHE_ENDPOINT
+    );
     accountEndpoint = new URL(
       config.accountEndpoint ?? DEFAULT_ACCOUNT_ENDPOINT
     );
@@ -346,6 +351,9 @@ var resolveConfig = (config) => {
   if (endpoint.protocol !== "https:" && endpoint.protocol !== "http:") {
     throw new ErpcConfigError("endpoint must use HTTP or HTTPS");
   }
+  if (avalancheEndpoint.protocol !== "https:" && avalancheEndpoint.protocol !== "http:") {
+    throw new ErpcConfigError("avalancheEndpoint must use HTTP or HTTPS");
+  }
   if (accountEndpoint.protocol !== "https:" && accountEndpoint.protocol !== "http:") {
     throw new ErpcConfigError("accountEndpoint must use HTTP or HTTPS");
   }
@@ -355,6 +363,9 @@ var resolveConfig = (config) => {
   endpoint.search = "";
   endpoint.hash = "";
   endpoint.pathname = endpoint.pathname.replace(/\/+$/, "") || "/";
+  avalancheEndpoint.search = "";
+  avalancheEndpoint.hash = "";
+  avalancheEndpoint.pathname = avalancheEndpoint.pathname.replace(/\/+$/, "") || "/";
   accountEndpoint.search = "";
   accountEndpoint.hash = "";
   accountEndpoint.pathname = accountEndpoint.pathname.replace(/\/+$/, "") || "/";
@@ -368,6 +379,7 @@ var resolveConfig = (config) => {
   return {
     accountEndpoint,
     apiKey,
+    avalancheEndpoint,
     endpoint,
     fetch: requireFetch(config.fetch),
     headers: config.headers ?? {},
@@ -1394,6 +1406,10 @@ var createErpcClient = (config) => {
     ...sharedTransport,
     endpoint: ethereumEndpoint
   });
+  const avalancheTransport = new HttpJsonRpcTransport({
+    ...sharedTransport,
+    endpoint: endpointWithPath(resolved.avalancheEndpoint, "/ava")
+  });
   const solanaWebSocket = new WebSocketJsonRpcTransport({
     endpoint: websocketUrl(resolved.endpoint, resolved.apiKey),
     timeoutMs: resolved.timeoutMs,
@@ -1404,6 +1420,15 @@ var createErpcClient = (config) => {
     timeoutMs: resolved.timeoutMs,
     ...resolved.webSocket === void 0 ? {} : { webSocket: resolved.webSocket }
   });
+  const avalancheWebSocket = new WebSocketJsonRpcTransport({
+    endpoint: websocketUrl(
+      resolved.avalancheEndpoint,
+      resolved.apiKey,
+      "/ava-ws"
+    ),
+    timeoutMs: resolved.timeoutMs,
+    ...resolved.webSocket === void 0 ? {} : { webSocket: resolved.webSocket }
+  });
   const priceTransport = new RestTransport({
     ...sharedTransport,
     endpoint: resolved.endpoint
@@ -1424,15 +1449,21 @@ var createErpcClient = (config) => {
     ...createEthereumClient(ethereumTransport),
     subscriptions: new EthereumSubscriptions(ethereumWebSocket)
   };
+  const avalanche = {
+    ...createEthereumClient(avalancheTransport),
+    subscriptions: new EthereumSubscriptions(avalancheWebSocket)
+  };
   return {
     solana,
     ethereum,
+    avalanche,
     price: new PriceClient(priceTransport),
     account: new AccountClient(accountTransport),
     usage: new UsageClient(userTransport),
     close: () => {
       solana.subscriptions.close();
       ethereum.subscriptions.close();
+      avalanche.subscriptions.close();
     }
   };
 };
@@ -1658,6 +1689,7 @@ exports.CloudCatalogClient = CloudCatalogClient;
 exports.CloudCreditClient = CloudCreditClient;
 exports.CloudResourcesClient = CloudResourcesClient;
 exports.DEFAULT_ACCOUNT_ENDPOINT = DEFAULT_ACCOUNT_ENDPOINT;
+exports.DEFAULT_AVALANCHE_ENDPOINT = DEFAULT_AVALANCHE_ENDPOINT;
 exports.DEFAULT_ENDPOINT = DEFAULT_ENDPOINT;
 exports.DEFAULT_TIMEOUT_MS = DEFAULT_TIMEOUT_MS;
 exports.DEFAULT_USER_ENDPOINT = DEFAULT_USER_ENDPOINT;