@elsoul/erpc-sdk 0.5.0 → 0.6.0

package/README.md

@@ -1,7 +1,7 @@
 # `@elsoul/erpc-sdk`
 
 Official type-safe TypeScript client for [ERPC](https://erpc.global). Use one
-client and one API key for Solana, Ethereum, Avalanche C-Chain, price data,
+client and one API key for Solana, Ethereum, Avalanche C/P/X chains, price data,
 indexed data, leader and validator data, analytics, subscriptions, and account
 information.
 
@@ -50,15 +50,22 @@ network request.
 | `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.avalanche.avax` | C-Chain AVAX atomic transaction API |
+| `erpc.avalanche.xChain` | X-Chain API |
+| `erpc.avalanche.pChain` | P-Chain API |
+| `erpc.avalanche.proposerVm` | P-Chain proposer VM API |
+| `erpc.avalanche.info` | Network upgrade information |
+| `erpc.avalanche.index` | C/P/X block and X transaction indexes |
 | `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.
+`/ava` HTTP route and `/ava-ws` WebSocket route. Native C/P/X methods use named
+parameters; Index calls are routed to the required explicit chain/container
+path. Native and Index batches are rejected locally. Use `raw` with an exact
+wire method name for forward compatibility.
 
 ## Examples
 
@@ -73,6 +80,12 @@ const avalancheBlock = await erpc.avalanche.rpc
   .eth_getBlockByNumber('latest', false)
   .send()
 
+const pChainHeight = await erpc.avalanche.pChain.getHeight().send()
+const xChainHeight = await erpc.avalanche.xChain.getHeight().send()
+const indexedTransaction = await erpc.avalanche.index.xChainTransactions
+  .getContainerByID({ id: transactionId })
+  .send()
+
 const prices = await erpc.price.getLatestPriceUpdates({
   ids: [feedId],
   parsed: true,

package/dist/index.cjs

@@ -541,10 +541,14 @@ var methodParams = (mode, args) => {
   return args[0];
 };
 var createRpcNamespace = (config) => {
+  const wireMethod = (method) => config.methodPrefix === void 0 ? method : `${config.methodPrefix}.${method}`;
   const base = {
     endpoint: config.transport.endpoint,
     batch: (calls) => {
-      const wireCalls = calls;
+      const wireCalls = calls.map((call) => ({
+        ...call,
+        method: wireMethod(call.method)
+      }));
       config.validateBatch?.(wireCalls);
       return new PendingRpcBatchRequest(
         (options) => config.transport.batch(
@@ -558,7 +562,7 @@ var createRpcNamespace = (config) => {
     ),
     request: (method, ...params) => new PendingRpcRequest(
       (options) => config.transport.request(
-        method,
+        wireMethod(method),
         params[0],
         options
       )
@@ -572,7 +576,7 @@ var createRpcNamespace = (config) => {
       if (property === "then") return void 0;
       return (...args) => new PendingRpcRequest(
         (options) => config.transport.request(
-          property,
+          wireMethod(property),
           methodParams(config.parameterMode, args),
           options
         )
@@ -648,6 +652,110 @@ var createEthereumClient = (transport) => ({
   })
 });
 
+// src/rpc/avalanche.ts
+var AVALANCHE_AVAX_METHODS = [
+  "avax.getAtomicTx",
+  "avax.getAtomicTxStatus",
+  "avax.getUTXOs",
+  "avax.issueTx"
+];
+var AVALANCHE_X_CHAIN_METHODS = [
+  "avm.buildGenesis",
+  "avm.getAllBalances",
+  "avm.getAssetDescription",
+  "avm.getBalance",
+  "avm.getBlockByHeight",
+  "avm.getHeight",
+  "avm.getTx",
+  "avm.getTxFee",
+  "avm.getTxStatus",
+  "avm.getUTXOs",
+  "avm.issueTx"
+];
+var AVALANCHE_P_CHAIN_METHODS = [
+  "platform.getAllValidatorsAt",
+  "platform.getBalance",
+  "platform.getBlockchainStatus",
+  "platform.getBlockchains",
+  "platform.getCurrentSupply",
+  "platform.getCurrentValidators",
+  "platform.getFeeConfig",
+  "platform.getFeeState",
+  "platform.getHeight",
+  "platform.getMinStake",
+  "platform.getRewardUTXOs",
+  "platform.getStake",
+  "platform.getStakingAssetID",
+  "platform.getSubnets",
+  "platform.getTimestamp",
+  "platform.getTotalStake",
+  "platform.getTx",
+  "platform.getTxStatus",
+  "platform.getUTXOs",
+  "platform.getValidatorFeeConfig",
+  "platform.getValidatorFeeState",
+  "platform.getValidatorsAt",
+  "platform.issueTx",
+  "platform.sampleValidators",
+  "platform.validatedBy",
+  "platform.validates"
+];
+var AVALANCHE_PROPOSER_VM_METHODS = [
+  "proposervm.getCurrentEpoch",
+  "proposervm.getProposedHeight"
+];
+var AVALANCHE_INFO_METHODS = ["info.upgrades"];
+var AVALANCHE_INDEX_METHODS = [
+  "index.getContainerByID",
+  "index.getContainerByIndex",
+  "index.getContainerRange",
+  "index.getIndex",
+  "index.getLastAccepted",
+  "index.isAccepted"
+];
+var rejectNativeBatch = (calls) => {
+  if (calls.length > 0) {
+    throw new ErpcBatchPolicyError(
+      "Avalanche native RPC methods do not support batching"
+    );
+  }
+};
+var nativeNamespace = (transport, methodPrefix) => createRpcNamespace({
+  methodPrefix,
+  parameterMode: "named",
+  transport,
+  validateBatch: rejectNativeBatch
+});
+var createAvalancheClient = (transport, indexTransports) => ({
+  ...createEthereumClient(transport),
+  avax: nativeNamespace(transport, "avax"),
+  xChain: nativeNamespace(transport, "avm"),
+  pChain: nativeNamespace(transport, "platform"),
+  proposerVm: nativeNamespace(
+    transport,
+    "proposervm"
+  ),
+  info: nativeNamespace(transport, "info"),
+  index: {
+    cChainBlocks: nativeNamespace(
+      indexTransports.cChainBlocks,
+      "index"
+    ),
+    pChainBlocks: nativeNamespace(
+      indexTransports.pChainBlocks,
+      "index"
+    ),
+    xChainBlocks: nativeNamespace(
+      indexTransports.xChainBlocks,
+      "index"
+    ),
+    xChainTransactions: nativeNamespace(
+      indexTransports.xChainTransactions,
+      "index"
+    )
+  }
+});
+
 // src/rpc/solana.ts
 var SOLANA_RPC_METHODS = [
   "getAccountInfo",
@@ -1410,6 +1518,10 @@ var createErpcClient = (config) => {
     ...sharedTransport,
     endpoint: endpointWithPath(resolved.avalancheEndpoint, "/ava")
   });
+  const avalancheIndexTransport = (path) => new HttpJsonRpcTransport({
+    ...sharedTransport,
+    endpoint: endpointWithPath(resolved.avalancheEndpoint, path)
+  });
   const solanaWebSocket = new WebSocketJsonRpcTransport({
     endpoint: websocketUrl(resolved.endpoint, resolved.apiKey),
     timeoutMs: resolved.timeoutMs,
@@ -1450,7 +1562,12 @@ var createErpcClient = (config) => {
     subscriptions: new EthereumSubscriptions(ethereumWebSocket)
   };
   const avalanche = {
-    ...createEthereumClient(avalancheTransport),
+    ...createAvalancheClient(avalancheTransport, {
+      cChainBlocks: avalancheIndexTransport("/ava/ext/index/C/block"),
+      pChainBlocks: avalancheIndexTransport("/ava/ext/index/P/block"),
+      xChainBlocks: avalancheIndexTransport("/ava/ext/index/X/block"),
+      xChainTransactions: avalancheIndexTransport("/ava/ext/index/X/tx")
+    }),
     subscriptions: new EthereumSubscriptions(avalancheWebSocket)
   };
   return {
@@ -1684,6 +1801,12 @@ var createErpcCloudClient = (config) => {
   };
 };
 
+exports.AVALANCHE_AVAX_METHODS = AVALANCHE_AVAX_METHODS;
+exports.AVALANCHE_INDEX_METHODS = AVALANCHE_INDEX_METHODS;
+exports.AVALANCHE_INFO_METHODS = AVALANCHE_INFO_METHODS;
+exports.AVALANCHE_PROPOSER_VM_METHODS = AVALANCHE_PROPOSER_VM_METHODS;
+exports.AVALANCHE_P_CHAIN_METHODS = AVALANCHE_P_CHAIN_METHODS;
+exports.AVALANCHE_X_CHAIN_METHODS = AVALANCHE_X_CHAIN_METHODS;
 exports.AccountClient = AccountClient;
 exports.CloudCatalogClient = CloudCatalogClient;
 exports.CloudCreditClient = CloudCreditClient;